Tutorial de Claude Code: tu primera sesión paso a paso
Este tutorial te lleva por una primera sesión real de Claude Code: del primer prompt al primer cambio aprobado, usando el modo plan y controlando el contexto. Asume que ya lo tienes instalado. En unos 20 minutos vas a haber delegado tu primera tarea y entendido el ciclo de trabajo.
El ciclo que vas a repetir siempre: das un objetivo, el agente explora y propone un plan, lo revisas, lo apruebas, y verificas el resultado. Todo lo demás son variaciones de esto.
Paso 1: Abre la sesión en tu proyecto
En la terminal, navega a la carpeta del proyecto y arranca:
claude
La sesión empieza limpia. Ese es el momento de máxima precisión del modelo, así que conviene darle el objetivo claro de entrada.
Paso 2: Explora antes de cambiar
Empieza con algo que no modifique nada, para tomar confianza:
Explícame cómo está organizado este proyecto y qué hace el archivo principal.
Claude Code lee el código y te responde. Fíjate en cómo explora: probablemente lance una búsqueda y lea varios archivos. Ese trabajo vive en su contexto, no en el tuyo.
Paso 3: Planifica el primer cambio
Para tu primera modificación, usa el modo plan. Entra con Shift+Tab dos veces (o /plan) y pide algo acotado:
Agrega un mensaje de log al inicio de la función principal que indique
que la app arrancó, con la fecha y hora.
En modo plan, el agente propone qué va a hacer sin tocar nada. Léelo. Si le falta contexto o apunta mal, corrígelo en la conversación antes de ejecutar.
Paso 4: Aprueba y verifica
Cuando el plan sea correcto, sal del modo plan y deja que ejecute. Claude Code edita el archivo y te muestra el cambio. Revísalo y apruébalo. Si el proyecto tiene tests, pídele que los corra para verificar.
Paso 5: Limpia antes de la siguiente tarea
Si vas a hacer algo no relacionado, vacía el contexto para empezar limpio:
/clear
Y si la misma tarea se alarga y el contexto se llena, usa /compact en lugar de /clear para conservar lo importante.
Qué acabas de aprender
Diste un objetivo, revisaste un plan, aprobaste un cambio y gestionaste el contexto. Ese es el 80% del trabajo diario con Claude Code. Lo que sigue (memoria con CLAUDE.md, subagentes, skills) se construye sobre este ciclo, y está ordenado en la guía para dominar Claude Code.
Preguntas frecuentes
¿Cómo empiezo a usar Claude Code por primera vez?
Abre la terminal en tu proyecto, ejecuta claude y empieza con una tarea que no modifique nada (por ejemplo, pedirle que explique un archivo). Para el primer cambio, usa el modo plan (Shift+Tab dos veces) para revisar qué va a hacer antes de que lo haga.
¿Qué le pido a Claude Code en mi primera sesión?
Algo acotado y claro: explicar cómo está organizado el proyecto, o un cambio pequeño como agregar un log. Tareas pequeñas al principio te dejan ver el ciclo (objetivo, plan, ejecución, verificación) sin riesgo.
¿Cómo reviso lo que hace Claude Code antes de que cambie mi código?
Con el modo plan: entras con Shift+Tab dos veces o con /plan, y el agente propone su plan sin tocar nada. Lo revisas, lo ajustas si hace falta, y solo entonces apruebas la ejecución.
¿Cuánto tarda aprender lo básico de Claude Code?
En una primera sesión de unos 20 a 30 minutos ya delegas una tarea completa y entiendes el ciclo de trabajo. El resto se aprende sobre esa base, sin necesidad de dominarlo todo de golpe.
Recursos relacionados
- Cómo instalar Claude Code y Claude Code para principiantes.
- Modo plan y comandos de contexto.
- Guía completa para dominar Claude Code.
Tu siguiente paso
Ten los comandos de tu primera sesión a mano con la Cheat Sheet de Claude Code: una hoja imprimible, en español.
Descargar la Cheat Sheet gratis
Es el resumen de Ship with Claude Code, la guía de Takren (14 módulos, 190 capítulos, actualizaciones gratuitas).