Los principios de la página base aplican a cualquier IA. Esta guía los aterriza a la herramienta con la que trabajo todos los días: instalación, comandos, y cómo se ve la dirección de verdad en una terminal.
✓ Comandos verificados contra code.claude.com/docs el 14 de julio de 2026⚠ Claude Code cambia entre versiones: comandos que se renombran, formatos que evolucionan. La fuente de verdad siempre es la documentación oficial — esta guía es el mapa, no el territorio. Guía independiente, no afiliada a Anthropic.
Cuatro pasos desplegables. Si ya usas Claude Code, salta al glosario o a los comandos.
Claude Code es una herramienta de terminal. La instalación oficial y sus requisitos están en la documentación de inicio rápido — instala desde ahí, no desde tutoriales de terceros que pueden estar desactualizados. Necesitas una cuenta de Claude (los planes con Claude Code incluido) o una clave de API.
Una vez instalado, párate en la carpeta de tu proyecto y ejecuta:
Qué esperar la primera vez: Claude Code te va a pedir autenticarte y luego te va a preguntar si confías en la carpeta. Después vas a notar que pide permiso antes de casi todo — leer archivos, ejecutar comandos, editar. Eso no es un defecto: es el modelo de permisos funcionando. La tentación de aprobar todo a ciegas es el primer error del día 0.
El archivo CLAUDE.md en la raíz del proyecto es lo que Claude Code lee al arrancar cada sesión: tus reglas, tu stack, tus convenciones. Es la diferencia entre reexplicar el proyecto cada día y que la sesión arranque sabiendo dónde está parada. Genera el primero con:
Y luego edítalo (con /memory o a mano) para que tenga tus reglas de trabajo. Este es el mío como punto de partida:
Regla de oro del CLAUDE.md: corto y accionable. Un CLAUDE.md de 300 líneas se ignora igual que uno vacío — cada línea debe ser una regla que de verdad quieres que se cumpla en cada sesión.
No empieces pidiendo "constrúyeme la app". Empieza con una tarea pequeña y el flujo que vas a usar siempre: plan → aprobar → ejecutar → verificar. Activa el modo plan con /plan (o el atajo Shift+Tab hasta llegar a plan mode) y pide algo como:
Qué esperar: Claude va a leer tu proyecto, presentar el plan, y esperar. Tu trabajo de director empieza ahí: leer el plan de verdad (no aprobar por inercia), recortar alcance, y solo entonces dejar que ejecute. Al final, pídele que corra lo que hizo y demuéstratelo — nunca aceptes "listo" sin evidencia.
"Está tocando archivos que no le pedí" → interrumpe (Esc), y ajusta: el alcance va en el plan y en el CLAUDE.md. "Me pide permisos todo el tiempo" → configura reglas con /permissions en vez de aprobar a ciegas; aprueba en bloque solo lo de solo-lectura. "Hizo algo mal y no sé volver atrás" → /rewind regresa código y conversación a un punto de control. "La sesión se puso lenta y confundida" → mira /context, compacta con /compact, o cierra el tema y arranca con /clear. Todos estos existen porque a todos nos pasó.
Todo lo que el modelo "tiene enfrente" en la conversación: tus mensajes, los archivos leídos, sus respuestas. Es finito — cuando se llena, la calidad baja. Por eso existen /context, /compact y /clear.
Las unidades en que el modelo lee y escribe (fragmentos de palabras). Son la moneda: todo lo que entra y sale cuesta tokens. Contexto basura = plata quemada.
Cuando el modelo rellena un hueco con algo plausible pero falso — una función que no existe, una cifra inventada — con total confianza. Se combate con verificación, no con fe.
Un modelo que no solo responde: recibe un objetivo, lo parte en tareas, usa herramientas (leer archivos, ejecutar comandos) y actúa. Claude Code es un agente en tu terminal.
Model Context Protocol: el estándar para conectar el agente con herramientas externas — bases de datos, GitHub, tu navegador. Se gestiona con /mcp. Más conexiones = más poder = más cuidado con permisos.
Un agente secundario que el principal lanza para una tarea acotada (revisar seguridad, correr tests) con su propio contexto limpio. La base de la arquitectura de dos niveles.
Instrucciones reutilizables en un archivo (.claude/skills/<nombre>/SKILL.md) que se invocan como comando (/nombre) o que Claude activa solo cuando aplican. Tus manuales de método, ejecutables.
Un comando tuyo que se dispara automáticamente en momentos fijos de la sesión (antes/después de usar una herramienta, por ejemplo). Reglas que no dependen de que el modelo se acuerde.
Punto de control del estado del código y la conversación al que puedes volver con /rewind. Tu botón de deshacer cuando un experimento salió mal.
Escribe / en tu sesión para ver la lista completa y viva — hay muchos más. Estos son los del día a día.
Prueba de que el aviso importa: en los últimos meses /cost pasó a ser /usage, /fork pasó a ser alias de /branch, y los comandos personalizados de .claude/commands/ se unificaron con las skills. Ante la duda: /help y los docs.
| Comando | Qué hace | Categoría |
|---|---|---|
| /init | Genera el CLAUDE.md inicial del proyecto. El primer comando de todo repo nuevo. | proyecto |
| /memory | Edita la memoria del proyecto (CLAUDE.md) sin salir de la sesión. | proyecto |
| /permissions | Define qué puede hacer Claude sin preguntarte y qué requiere tu aprobación. Tus rieles de confianza. | proyecto |
| /mcp | Conecta y gestiona servidores MCP — las herramientas externas del agente. | proyecto |
| /context | Muestra qué está llenando la ventana de contexto. El diagnóstico antes de compactar. | contexto |
| /compact | Resume la conversación para liberar espacio conservando lo importante. | contexto |
| /clear | Borra el historial y arranca limpio manteniendo la memoria del proyecto. El mayor ahorrador de tokens: tema nuevo, /clear. | contexto |
| /btw <pregunta> | Pregunta lateral rápida que NO se suma al historial de la conversación. | contexto |
| /plan | Entra en modo plan: Claude propone qué va a tocar y por qué ANTES de cambiar nada. El comando del director. | plan |
| /code-review | Skill incluida: revisa el diff actual buscando bugs, con nivel de esfuerzo configurable. | plan |
| /rewind | Regresa código y conversación a un checkpoint. Tu deshacer cuando el experimento salió mal. | plan |
| /model | Cambia de modelo. Caro para pensar y verificar, económico para lo mecánico. | modelo |
| /effort | Ajusta cuánto razonamiento aplica el modelo. Más esfuerzo = mejor y más caro. | modelo |
| /usage | Muestra el consumo de tokens y uso de la sesión. Lo que no se mide no se dirige. (Antes se llamaba /cost.) | modelo |
| /resume | Retoma una conversación anterior. | sesiones |
| /branch | Bifurca la conversación en este punto para explorar sin dañar la original. (Alias: /fork.) | sesiones |
| /tasks | Lista lo que corre en segundo plano en la sesión actual. | sesiones |
| /background | Suelta la sesión a segundo plano y libera tu terminal. | sesiones |
| /batch | Parte un cambio grande en unidades independientes y las corre en paralelo, cada una en su worktree. | sesiones |
| /doctor | Diagnostica problemas de la instalación. | proyecto |
| /help | Lista todos los comandos disponibles en TU versión. Ante la duda, este manda. | proyecto |
Todo prompt que repites se convierte en una skill: un archivo markdown que se invoca con /nombre y que Claude también puede activar solo cuando aplica. Así se pasa de escribir buenos prompts a construir método reutilizable — el salto al nivel 4.
Y los hooks son el paso siguiente: comandos tuyos que se disparan solos en momentos fijos (por ejemplo, correr los tests después de cada edición). Las skills dependen de que alguien las invoque; los hooks no dependen de la memoria de nadie.
Un agente sin mapa redescubre tu arquitectura cada sesión, archivo por archivo — lento, caro y propenso a romper cosas que no sabía que se conectaban. La solución no requiere instalar nada: es un prompt.
El resultado: cada sesión nueva lee el mapa en segundos en vez de explorar a ciegas, y tú ganas el documento de arquitectura que nunca escribiste. Regenéralo cuando el proyecto cambie de forma. Para proyectos de 500+ archivos, existen herramientas del ecosistema que preindexan el grafo completo (símbolos, llamadas, dependencias) y lo sirven por MCP — valen la pena a esa escala, no antes; búscalas como "code graph MCP".
El principio: quien piensa no es quien teclea, y quien teclea no se revisa a sí mismo. Así se ve en una sesión real de Claude Code.
Con /plan activo, defines la función con el flujo de la página base: plan con pasos verificables, alcance explícito, decisiones A/B. Aquí usas el mejor modelo (/model) y esfuerzo alto (/effort) — pensar es donde vale pagar.
Apruebas el plan y Claude implementa paso a paso. Los rieles no son promesas: son /permissions configurado (qué puede hacer sin preguntar), el CLAUDE.md con las reglas, y el alcance del plan. Para pasos mecánicos ya definidos, bajas a un modelo más económico.
Un hook corre los tests automáticamente después de cada edición de código. Si fallan, se sabe en el momento — no en el demo. La verificación que no depende de que nadie se acuerde es la única que funciona a largo plazo.
Al terminar, un subagente revisor (o la skill /code-review) audita el diff en contexto limpio — sin heredar las suposiciones de la sesión que escribió el código. Es la "sesión fría" del principio 7, automatizada.
Con /usage ves qué costó la sesión en tokens. Tres números por semana bastan: cuántas veces retrabajaste lo mismo, cuánto costó cada tipo de tarea, y dónde se fue tu tiempo — dirigiendo o corrigiendo. Lo que se repite mal, se arregla en el CLAUDE.md o en una skill, no en el chat.
Complemento del diagnóstico general de la página base — este mide tu uso de Claude Code.