Cómo dominar Claude Code: la guía completa en español
Claude Code es el agente de programación de Anthropic que vive en tu terminal: le das un objetivo en lenguaje natural y él lee tu código, propone un plan, edita archivos, corre comandos y verifica el resultado. Esta guía recorre todo lo que necesitas para pasar de "lo instalé y no sé qué hacer" a usarlo como una herramienta de trabajo diaria, en español y sin rodeos.
No es un repaso de marketing. Es el mapa del recorrido real: qué instalar, qué dominar primero, y en qué orden conviene aprender cada capacidad para que en menos de 30 minutos ya estés produciendo algo útil.
Qué encontrarás aquí
- Qué es Claude Code (y qué no es)
- Instalación y primer arranque
- El recorrido para dominarlo, en cuatro niveles
- Claude Code frente a otras herramientas
- ¿Necesitas otro curso, o un protocolo?
1. ¿Qué es Claude Code (y qué no es)?
Claude Code es una interfaz de línea de comandos (CLI): se ejecuta en tu terminal, no en una ventana de chat de navegador y no como una extensión visual dentro del editor (aunque también se integra con VS Code y JetBrains). Le hablas en lenguaje natural y opera sobre tu proyecto real: tus archivos, tu repositorio de Git, tus comandos.
La diferencia con un asistente de autocompletado es de fondo. Un autocompletado sugiere la siguiente línea mientras escribes. Claude Code recibe un objetivo ("agrega autenticación con tokens y escribe los tests"), lo descompone, ejecuta los pasos y te muestra el trabajo para que lo apruebes. Es un agente, no un buscador de fragmentos.
Lo que no es: no es una varita que adivina lo que quieres. Su rendimiento depende casi por completo de cómo le das contexto y cómo acotas la tarea. Esa es, justamente, la habilidad que esta guía te ayuda a construir.
2. ¿Cómo se instala Claude Code?
Claude Code se instala vía npm y se invoca con un solo comando (los pasos exactos y los requisitos están en la documentación oficial de Claude Code). Una vez instalado, dentro del directorio de tu proyecto:
claude # inicia una sesión en el directorio actual
claude --version # confirma la versión instalada
Desde dentro de la sesión, dos comandos que vas a usar el primer día:
/status: estado del sistema, modelo activo y tu cuenta./config: abre la configuración interactiva.
El primer arranque importa más de lo que parece. El inicio de sesión es el momento de máxima precisión del modelo: el contexto está limpio y la atención no está diluida. Aprovéchalo para darle el objetivo claro de entrada, en lugar de ir soltando instrucciones a cuentagotas.
3. El recorrido para dominarlo, en cuatro niveles
Dominar Claude Code no es memorizar comandos. Es subir cuatro escalones, cada uno apoyado en el anterior.
Nivel 1 · Operar la sesión
Lo básico que evita el 80% de la frustración inicial: controlar el contexto y los permisos.
El contexto es la memoria de trabajo del modelo dentro de una sesión. Se llena, y cuando se llena de ruido, la calidad cae. Tres comandos lo gobiernan:
/context: visualiza cuánto contexto llevas usado./clear: vacía el contexto entre tareas no relacionadas./compact: resume la conversación y conserva lo clave cuando la tarea sigue pero el contexto se llena.
La regla práctica: /clear entre tareas distintas, /compact cuando una misma tarea se alarga. Y una señal de alarma: si corriges el mismo error dos veces sin avanzar, el contexto ya está contaminado. Mejor /clear y reescribir el prompt.
Para los permisos, el atajo Shift+Tab cicla entre tres modos: normal (pide confirmación), auto-accept (ejecuta sin preguntar) y plan (solo analiza, no toca nada). Saber moverte entre ellos es la diferencia entre sentir que peleas con la herramienta y sentir que la conduces.
Nivel 2 · Memoria y planificación
Aquí das el salto de "operario" a "constructor".
El archivo CLAUDE.md es la memoria persistente de tu proyecto: Claude Code lo lee al iniciar cada sesión. Ahí pones las reglas que no quieres repetir cada vez (convenciones de código, comandos de build, qué no tocar). Se genera con /init y la regla de oro es mantenerlo por debajo de 200 líneas, con lo crítico en las primeras 20. Un CLAUDE.md inflado consigue lo contrario de lo que busca: el modelo ignora la mitad.
El modo planificación (entras con Shift+Tab dos veces, o con /plan) hace que el modelo analice y proponga sin ejecutar nada. Es obligatorio en refactors grandes: te deja revisar el plan antes de que toque una sola línea, y consume aproximadamente la mitad del contexto que ir improvisando.
Nivel 3 · Construir capacidades
Aquí está la profundidad que separa a quien "usa" Claude Code de quien lo exprime. Son tres piezas, y cada una tiene su propia guía:
- Subagentes: sesiones secundarias con su propia ventana de contexto que ejecutan una tarea pesada (explorar, planificar, depurar) y devuelven solo el resultado. Tu sesión principal se mantiene limpia. Es la capacidad que más cambia tu forma de trabajar. La cubrimos en detalle en la guía de subagentes en Claude Code.
- Skills, hooks y MCP: las tres capas para extender Claude Code. Las skills le enseñan procedimientos repetibles; los hooks disparan acciones automáticas en eventos del ciclo de vida; el MCP (Model Context Protocol) lo conecta a herramientas externas (tu navegador, tu base de datos, tu gestor de tareas). Lo desarrollamos en la guía de skills, hooks y MCP.
- Context engineering: el criterio que hace que todo lo anterior funcione. Lo vemos en el Nivel 4.
Nivel 4 · El criterio: ingeniería de contexto
Las capacidades sin criterio son ruido. La ingeniería de contexto es la disciplina de darle al modelo la información correcta, en el momento correcto, sin saturarlo. No es un truco; es el factor que más determina la calidad de tus resultados.
Algunas de sus reglas, que verás repetirse en todo workflow serio:
- Signal to Noise: maximiza la información útil, minimiza el ruido.
- Progressive Disclosure: revela el contexto just-in-time, no todo de entrada.
- Goal In, Strategy Out: da el objetivo y deja que el modelo proponga la estrategia.
- Boxing the Agent In: restringe el espacio de acción del agente para ganar precisión.
Estas reglas se aplican en cada uno de los niveles anteriores. Por eso la ingeniería de contexto no es un tema más: es el hilo que los cose. La tratamos a fondo en la guía de ingeniería de contexto en español.
4. ¿Claude Code o Cursor? Frente a otras herramientas
La pregunta más común antes de comprometerse: ¿Claude Code o Cursor? No es la misma categoría. Cursor es un editor (un fork de VS Code) con IA integrada en la interfaz visual; Claude Code es un agente de terminal que opera sobre el proyecto entero. Uno optimiza el acto de escribir código línea a línea; el otro optimiza delegar tareas completas.
La elección no es de gusto, es de flujo de trabajo. Lo comparamos a fondo, con casos concretos, en la guía de Claude Code vs Cursor.
5. ¿Necesitas otro curso, o un protocolo?
Conviene aquí una honestidad que el resto del mercado evita.
Hay cursos de Claude Code para todos los gustos: en video, de 11 horas, de "cero a experto". Y hay documentación oficial gratuita. Con tanta oferta, la pregunta real no es "¿dónde aprendo los comandos?". Los comandos los tienes en cualquier lado, incluida la cheat sheet al final de esta guía.
La pregunta real es: cuando estás trabajando, bajo presión, ¿qué consultas? Nadie pausa un video de 11 horas para recordar la sintaxis de un hook. Haces grep a una referencia. Claude Code es una herramienta de CLI que se usa mientras trabajas, y eso cambia lo que necesitas: no un curso que ves una vez, sino un protocolo que tienes al lado.
Esa es la diferencia entre acumular tutoriales y tener un sistema de ejecución. Lo desarrollamos en el artículo sobre por qué un protocolo le gana a otro curso. Si te interesa la distinción, ese es el siguiente paso.
Preguntas frecuentes
¿Qué es Claude Code?
Claude Code es el agente de programación de Anthropic que vive en la terminal. Recibe un objetivo en lenguaje natural, lee el código del proyecto, propone un plan, edita archivos y ejecuta comandos. No es un autocompletado: opera sobre la tarea completa, no sobre la línea que se está escribiendo.
¿Cómo se instala Claude Code?
Claude Code se instala vía npm y se ejecuta con el comando claude dentro del directorio del proyecto. Dos comandos útiles desde el primer día: /status para ver el modelo activo y la cuenta, y /config para abrir la configuración interactiva. Los requisitos exactos están en la documentación oficial de Anthropic.
¿Cuánto tiempo lleva aprender Claude Code desde cero?
En menos de 30 minutos se puede producir algo útil. El aprendizaje real tiene cuatro niveles: operar la sesión (contexto y permisos), memoria y planificación con CLAUDE.md, capacidades avanzadas como subagentes y MCP, y la ingeniería de contexto. El primer nivel se domina en una tarde.
¿Qué es el archivo CLAUDE.md en Claude Code?
CLAUDE.md es la memoria persistente del proyecto: Claude Code lo lee al iniciar cada sesión. Sirve para guardar convenciones de código, comandos de build y reglas que no se quieren repetir en cada prompt. Se genera con /init. Regla clave: no superar 200 líneas, con lo crítico en las primeras 20.
¿En qué se diferencia Claude Code de un editor con IA como Cursor?
No son la misma categoría. Cursor es un editor (fork de VS Code) con IA en la interfaz visual; Claude Code es un agente de terminal. Cursor optimiza escribir código línea a línea; Claude Code optimiza delegar tareas completas sobre el proyecto. Uno no reemplaza al otro: muchos equipos usan ambos.
Tu siguiente paso
Si quieres empezar a trabajar ya, lo más rápido es tener los comandos que más se consultan bajo presión en una sola hoja.
Descarga gratis la Cheat Sheet de Claude Code (PDF imprimible, en español): los comandos, atajos y reglas de oro que vas a usar cada día, en una página.
Es el resumen condensado de Ship with Claude Code, la guía de Takren: 14 módulos, 190 capítulos, plantillas reutilizables y actualizaciones gratuitas. Empieza por la hoja, decide después.