Claude Code: Guía completa para principiantes (usando modelos nacionales)

Empieza desde cero, instala Claude Code —que entiende lenguaje natural, escribe código y funciona automáticamente— en tu computadora y úsalo para crear tu primer producto funcional.

Primeros pasos

• Principiantes absolutos: Sigue los capítulos 1 a 5 en orden. Cuando ejecutes tu primera herramienta web, ya habrás empezado oficialmente.
• Si encuentras errores: Haz una captura de pantalla y pásasela a Claude Code o Doubao. Describe "en qué paso estoy y qué error veo". Esto es 10 veces más eficiente que buscar en Google por tu cuenta.

Capítulo 1: Dominar los conceptos básicos

Si no entiendes los livestreams o los manuales, normalmente no es porque no seas inteligente, sino porque los términos no están conectados. Este capítulo desglosa las palabras que aparecerán repetidamente.

1.1 Tres conceptos fundamentales

1Modelo = Cerebro (Solo piensa, no tiene manos ni pies)
2Chatbot = Cerebro + Boca (Puede hablar pero no hacer)
3Agente = Cerebro + Manos/Pies + Caja de herramientas (Puede hablar y hacer)

• Modelo: GPT, Claude, Gemini, DeepSeek, Doubao, Qwen, Kimi, GLM, MiniMax... estos son modelos, el "cerebro".
• Chatbot: Web de ChatGPT, App Doubao, cuadro de diálogo de DeepSeek. Tú preguntas, él responde, pero tienes que hacer el trabajo tú mismo.
• Agente: Tú dices "ayúdame a construir un sitio web", y él crea carpetas, escribe código, lo ejecuta y lo depura en tu computadora, y finalmente te dice "está listo". Claude Code es un Agente.

El mismo modelo en diferentes herramientas tiene capacidades muy distintas. El mismo modelo Claude es solo un chat en un navegador, pero en Claude Code puede escribir código por sí mismo.

1.2 Token, Contexto, Arnés

• Token: La unidad más pequeña que la IA usa para entender texto. 1 carácter chino equivale aproximadamente a 1-2 Tokens; 1 palabra en inglés equivale aproximadamente a 1 Token. Los Tokens son tu "factura de electricidad". No ahorres Tokens durante la fase de aprendizaje.
• Contexto: Todo lo que hay en esta ronda de conversación. La IA no tiene memoria a largo plazo; solo puede referirse a lo que tiene en su "escritorio".
• Ventana de Contexto: El tamaño del "escritorio" de cada modelo. En 2026, los modelos principales han alcanzado 1 millón de Tokens (aproximadamente 700k-800k palabras).
• Contaminación del Contexto: Hablar de diferentes cosas en una misma ventana confunde a la IA. Una ventana por tarea; abre una ventana nueva para un tema nuevo.
• Arnés / Ingeniería de Contexto: No es un software, sino un conjunto de métodos para dominar la IA: cómo organizar la información, gestionar el contexto, guiar a la IA y verificar los resultados. Claude Code es excelente porque su Arnés es el más maduro.

1.3 ¿Qué es una Skill?

Una Skill es un Manual de Procedimientos (SOP) para Claude.

Las hamburguesas Big Mac de McDonald's saben igual en todo el mundo no porque cada tienda tenga un chef maestro, sino porque cada tienda tiene un SOP. Una Skill es este SOP para Claude: define "qué hacer primero, qué hacer después, qué herramientas usar y qué cuenta como éxito".

• Escríbela una vez, llámala repetidamente.
• Escribir tu propio SOP es como "enseñarle" tu experiencia laboral a Claude; se convierte en tu "empleado virtual".

1.4 Tres métodos de pago

La solución más realista: usa APIs de modelos domésticos + cc-switch para cambiar con un clic. Detallado en el Capítulo 3.

1.5 Herramientas auxiliares que debes conocer antes de la instalación

1.6 MCP — El "estándar de enchufe" para Agentes

MCP significa Model Context Protocol.

Piénsalo como un estándar de enchufe: permite a los Agentes conectarse a varias herramientas externas y fuentes de datos (Feishu, bases de datos, navegadores, Xiaohongshu, WeChat, etc.).

Analogía:

• Un puerto USB te permite conectar periféricos a tu computadora; conecta un altavoz y la computadora gana la capacidad de "reproducir música".
• MCP te permite conectar herramientas a Claude Code; conecta Tavily y gana la capacidad de "buscar tendencias en tiempo real"; conecta xiaohongshu-mcp y puede "publicar en Xiaohongshu".

Por defecto, Claude Code solo procesa la información que le das y no buscará activamente en internet. Necesitas MCP para buscar, leer bases de datos o llamar a APIs externas.

1.7 Multimodalidad — La IA hace más que "leer texto"

Modalidad es el tipo de información. El texto es una modalidad; las imágenes, el sonido y el video son otras.

• Unimodal: Solo puede procesar texto.
• Multimodal: Puede procesar texto, imágenes, audio, video, archivos y pantallas simultáneamente.

Soporte de modelos principales en 2026:

Entrada ≠ Salida

Que la IA pueda "ver" una modalidad no significa que pueda "generarla".

• Imágenes: Casi todos los modelos principales pueden ver imágenes; solo algunos pueden dibujarlas (GPT Image, Gemini, Doubao Seedance, Jimeng, Nano Banana, etc.).
• Video: Gemini, Doubao y Kimi pueden ver video; pero los LLM no hacen video directamente; usan herramientas especializadas (Wan, Seaweed Dance, Jimeng).

Fortalezas de los modelos:

Consejo práctico para principiantes: No te limites a escribir texto; aprende a lanzar capturas de pantalla, grabaciones y videos directamente a la IA para aumentar la eficiencia.

1.8 Panorama de herramientas de IA (Quién es quién)

Un mapa para aclarar la confusión sobre las diferentes herramientas.

Herramientas de Agente (Te ayudan a trabajar)
``text
Herramientas de Agente
├── Línea de comandos (Basadas en terminal, las más potentes)
│ ├── Claude Code —— De Anthropic, actualmente la más fuerte, la estrella de esta guía
│ └── Codex CLI —— De OpenAI, código abierto
│
├── GUI (Interfaz visual, fácil de usar)
│ ├── Codex Desktop/Web —— De OpenAI
│ ├── Claude Cowork —— De Anthropic, para usuarios no técnicos
│ ├── Trae Solo —— De ByteDance, doméstica, modos Code y MTC
│ ├── WorkBuddy —— De Tencent, doméstica, para trabajo de oficina no dev
│ └── Kiro —— De AWS, IDE basado en especificaciones (fork de VS Code)
│
├── Autónomas (Se ejecutan en segundo plano)
│ ├── OpenClaw —— Antes Clawdbot, código abierto, control remoto vía WeChat/TG
│ └── Hermes —— De Nous Research, código abierto, memoria persistente
│
└── Orquestación de flujos (Automatización con bloques)
└── COZE —— De ByteDance, flujos de trabajo drag-and-drop
``

Herramientas de Chatbot (Hablan contigo)
``text
Chatbot
├── Extranjeros
│ ├── ChatGPT (modelo GPT)
│ ├── Claude.ai (modelo Claude)
│ ├── Gemini (modelo Google)
│ └── Grok (xAI/Elon Musk, para tareas relacionadas con X)
│
└── Domésticos
├── Doubao (ByteDance)
├── DeepSeek (Alta relación calidad-precio)
├── Qwen (Alibaba)
├── Kimi (Moonshot AI)
├── WeChat Yuanbao (Tencent, fuertes datos del ecosistema WeChat)
└── GLM / Zhipu Qingyan (Zhipu AI)
``

"Jerga" común en los comentarios:

1.9 Resumen en una frase de la relación

1Tú (Humano)
2  ↕ Lenguaje natural
3Claude Code (Agente) —— Se conecta a herramientas externas vía MCP
4  ↕ Llama
5Modelo (Claude / GLM / MiniMax / Kimi…)
6  ↕ Consume
7Token (Factura de electricidad)

Capítulo 2: Configuración del entorno

Instala 4 cosas en orden: Git → Node.js → VS Code → Claude Code.

2.1 Confirmar el tipo de chip

• Mac: Icono de Apple -> Acerca de esta Mac. M1/M2/M3/M4 es ARM; Intel es x86_64.
• Windows: Haz clic derecho en "Este equipo" -> Propiedades. Intel/AMD es x86_64.

2.2 Instalar Git

• Mac: Abre Terminal, pega: /bin/zsh -c "$(curl -fsSL https://gitee.com/happyaicoder/HomebrewCN/raw/master/Homebrew.sh)". Verifica con git --version.
• Windows: Descárgalo desde https://git-scm.com/https://git-scm.com/). Usa la configuración predeterminada.

2.3 Instalar Node.js (18+, se recomienda 20 o 22)

• Mac: Pega: /bin/bash -c "$(curl -fsSL https://gitee.com/iamzhihuix/nvm-install-cn/raw/main/install.sh)". Verifica con node -v.
• Windows: Descarga la versión LTS desde https://nodejs.org/https://nodejs.org/). Si npm -v falla en PowerShell, ejecuta: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.

2.4 Instalar VS Code

Descárgalo desde https://code.visualstudio.com/https://code.visualstudio.com/). En Windows, marca las opciones "Add to PATH" y "Open with Code".

2.5 Instalar Claude Code

• Mac: npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. Usa sudo si te deniega el permiso.
• Windows: Ejecuta PowerShell como Administrador, luego: npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com.

2.6 Solución de errores comunes

Capítulo 3: Configurar Claude Code con modelos domésticos

Claude Code es el caparazón; necesita un modelo (cerebro). Los modelos oficiales de Claude requieren tarjetas de crédito internacionales y corres el riesgo de que te bloqueen. La solución más realista para usuarios domésticos es usar cc-switch con modelos domésticos.

3.1 Elegir un modelo

Recomendación para principiantes: Plan de Coding de MiniMax (29 RMB/mes).

3.2 Instalar cc-switch

Descárgalo desde GitHub o Gitee Mirror.

3.3 Obtener una API Key (Ejemplo: MiniMax)

1. Regístrate en Plataforma MiniMax.
2. Compra un Plan de Coding.
3. Copia la Clave del Plan de Coding (no la API Key normal).

3.4 Configurar en cc-switch

1. Abre cc-switch, haz clic en el icono de Claude.
2. Haz clic en +, selecciona el proveedor (ej. MiniMax), pega la Key y haz clic en Añadir.
3. Pasa el ratón sobre el modelo y haz clic en "Activar".

3.5 Verificar

En la terminal, escribe claude. Pregunta: "¿Qué modelo eres?" Si responde MiniMax/GLM, ya está configurado.

Capítulo 4: Operaciones básicas de Claude Code

4.1 Dos formas de iniciar

• Terminal: Abre una carpeta en VS Code, abre la terminal, escribe claude.
• Plugin: Instala la extensión "Claude Code" de Anthropic en VS Code.

4.2 Atajos esenciales

4.3 Tres modos de trabajo

El modo Plan es crucial: Claude piensa los pasos antes de actuar. Úsalo para funciones complejas.

4.4 Pensamiento normal vs. Pensamiento profundo (ultrathink)

4.5 Modo YOLO (Manos libres)

Omite las solicitudes de permiso para cada cambio de archivo. Usa: claude --dangerously-skip-permissions.

4.6 CLAUDE.md para preferencias

Escribe tus preferencias en un archivo CLAUDE.md en la raíz de tu proyecto (ej. "Usa español para los comentarios").

Capítulo 5: Construir una "Herramienta de lectura temprana"

5.1 Crear directorio y PRD

Crea prd.md en VS Code con los requisitos para una aplicación HTML/JS que genere animales emoji cuando el volumen del micrófono supere un umbral.

5.2 Implementación

En la terminal, ejecuta claude --dangerously-skip-permissions y escribe: @prd.md implementa esta función.

5.3 Resultado

Abre index.html en un navegador, permite el acceso al micrófono y habla para ver aparecer los animales.

Capítulo 6: Dominar las habilidades del flujo de trabajo

Las Skills son SOP reutilizables. Una Skill incluye un SKILL.md (configuración), scripts y plantillas.

6.2 Usar npx skills

Instala skills con un solo comando: npx skills add jimliu/baoyu-skills. Selecciona la skill y el destino (Claude Code).

6.3 Repositorios de Skills

6.5 Crear una Skill personalizada: Auto-ilustración

Usa la API de Nano Banana 2 de APImart para crear una skill que genere 3 ilustraciones estilo dibujo a mano para cualquier artículo que escribas.

6.6 Skill vs MCP vs Hooks vs Plugin

• Skill: Receta (Pasos para el chef).
• MCP: Servicios (Agua/Electricidad/Gas para la cocina).

Capítulo 7: Hardware y Red

• Mac es mejor para IA debido a la memoria unificada, pero Windows funciona bien.
• Usa el modo TUN en tu proxy (ej. clash.verge) si encuentras errores de red con MCP o generación de imágenes.

Apéndice A: Hoja de referencia de comandos

claude, /skills list, /clear, /compact, /doctor, /model.

Apéndice B: Errores comunes

Apéndice C: Terminología

Palabras finales

Primero ponte en el camino, luego habla de técnicas de conducción. Empieza con los Capítulos 2-5. La IA es un multiplicador de productividad de 10x a 100x. Empieza hoy.