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

Comienza desde cero, instala Claude Code —que entiende el lenguaje natural, escribe código y trabaja 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. Una vez que ejecutes tu primera herramienta web, ya habrás empezado oficialmente.
Cuando encuentres errores: Toma una captura de pantalla y pásala a Claude Code o Doubao. Describe "en qué paso estoy y qué error veo". Esto es 10 veces más eficiente que buscar por tu cuenta en Google.

Capítulo 1: Dominar Conceptos Básicos

Si no entiendes las transmisiones en vivo 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 Clave

text

1Modelo = Cerebro (Solo piensa, sin 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: ChatGPT web, la app de Doubao, el cuadro de diálogo de DeepSeek. Tú preguntas, él responde, pero tú tienes que hacer el trabajo.
Agente: Le dices "ayúdame a crear un sitio web" y él crea carpetas, escribe código, lo ejecuta y lo depura en tu computadora, y al final 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 el navegador, pero en Claude Code puede escribir código por sí mismo.

1.2 Token, Contexto, Harness

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 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 está 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 700-800 mil palabras).
Contaminación del Contexto: Hablar de diferentes temas en una misma ventana confunde a la IA. Una ventana para una tarea; abre una nueva ventana para un tema nuevo.
Harness / 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 Harness es el más maduro.

1.3 ¿Qué es una Skill?

Una Skill es un Manual de SOP para Claude.

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

Escríbela una vez, úsala 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 nacionales + cc-switch para cambiar con un solo clic. Detalles en el Capítulo 3.

1.5 Herramientas Auxiliares para Conocer Antes de Instalar

1.6 MCP — El "Estándar de Enchufe" para Agentes

MCP significa Model Context Protocol (Protocolo de Contexto de Modelo).

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

Analogía:

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

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

1.7 Multimodal — 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 LLMs no crean video directamente; usan herramientas especializadas (Wan, Seaweed Dance, Jimeng).

Fortalezas de los modelos:

Consejo práctico para principiantes: No solo escribas; 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 entre las diferentes herramientas.

Herramientas Agente (Te ayudan a trabajar)
``text
Herramientas Agente
├── Línea de Comandos (Basada en terminal, la más potente)
│ ├── 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, nacional, tiene modos Code y MTC
│ ├── WorkBuddy —— De Tencent, nacional, para trabajo de oficina no técnico
│ └── Kiro —— De AWS, IDE basado en especificaciones (fork de VS Code)
│
├── Autónomas (Funcionan en segundo plano)
│ ├── OpenClaw —— Anteriormente Clawdbot, código abierto, control remoto vía WeChat/TG
│ └── Hermes —— De Nous Research, código abierto, memoria persistente
│
└── Orquestación de Flujos de Trabajo (Automatización modular)
└── COZE —— De ByteDance, flujos de trabajo de arrastrar y soltar
``

Herramientas Chatbot (Te hablan)
``text
Chatbot
├── Internacionales
│ ├── ChatGPT (modelo GPT)
│ ├── Claude.ai (modelo Claude)
│ ├── Gemini (modelo de Google)
│ └── Grok (xAI/Elon Musk, para tareas relacionadas con X)
│
└── Nacionales
├── Doubao (ByteDance)
├── DeepSeek (Alta relación costo-rendimiento)
├── Qwen (Alibaba)
├── Kimi (Moonshot AI)
├── WeChat Yuanbao (Tencent, fuerte integración con datos del ecosistema WeChat)
└── GLM / Zhipu Qingyan (Zhipu AI)
``

Lenguaje común en los comentarios:

1.9 Resumen en una Frase de la Relación

text

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 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 PC" -> 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: Descarga 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 "Agregar a PATH" y "Abrir con Code".

2.5 Instalar Claude Code

Mac: npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. Usa sudo si hay problemas de permisos.
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 Nacionales

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

3.1 Elegir un Modelo

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

3.2 Instalar cc-switch

Descárgalo desde GitHub o Gitee Mirror.

3.3 Obtener API Key (Ejemplo: MiniMax)

Regístrate en Plataforma MiniMax.
Compra un Plan de Codificación.
Copia la Clave del Plan de Codificación (no la API Key normal).

3.4 Configurar en cc-switch

Abre cc-switch, haz clic en el ícono de Claude.
Haz clic en +, selecciona el proveedor (ej. MiniMax), pega la Clave y haz clic en Agregar.
Pasa el mouse sobre el modelo y haz clic en "Habilitar".

3.5 Verificar

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

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 Normal vs. Pensamiento Profundo (ultrathink)

4.5 Modo YOLO (Sin supervisión)

Omite los permisos 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 chino para los comentarios").

Capítulo 5: Construyendo 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 implement this feature.

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 Habilidades de Flujo de Trabajo

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

6.2 Usando 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 (Instrucciones para el chef).
MCP: Utilidades (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 la 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 camino, luego habla de habilidades de conducción. Empieza con los Capítulos 2 a 5. La IA es un multiplicador de productividad de 10x a 100x. Empieza hoy.