Inicio/Primeros pasos

🚀 Primeros pasos

Aprende a iniciar Claude Code, entender su interfaz y completar tus primeras tareas de programación con IA.

Iniciar una sesión

Abre tu terminal, navega al directorio de tu proyecto y ejecuta:

claude

Verás un prompt interactivo como este:

╔══════════════════════════════════╗
║  Claude Code  ·  claude-sonnet  ║
╚══════════════════════════════════╝
> _

Claude Code está listo para recibir instrucciones en lenguaje natural. Puedes escribirle como si fuera un compañero de trabajo.

Tu primera tarea

Prueba algo sencillo para empezar. Escribe:

> ¿Qué archivos hay en este directorio?

Claude Code ejecutará ls o find y te mostrará el resultado. Observarás que antes de ejecutar cualquier herramienta te pide confirmación o te muestra lo que va a hacer.

Entender el flujo de trabajo

Claude Code opera en ciclos de:

  1. Pensar — analiza tu petición y planifica los pasos.
  2. Actuar — usa herramientas (leer archivos, ejecutar comandos, editar código).
  3. Mostrar — te presenta los resultados y cambios realizados.
  4. Esperar — vuelve a esperar tu siguiente instrucción.
Consejo: Sé específico en tus instrucciones. En lugar de "arregla el código", di "el test en auth.test.ts falla con un error 401, revísalo y corrígelo".

Modos de operación

Modo normal (por defecto)

Claude Code te pide confirmación antes de editar archivos o ejecutar comandos importantes. Ideal para empezar y mantener control.

Modo auto

Claude completa tareas de forma autónoma sin pedir confirmación en cada paso. Útil cuando confías en la tarea y quieres velocidad:

claude --dangerously-skip-permissions
Usa el modo auto con precaución. Claude puede modificar archivos, instalar paquetes o ejecutar comandos sin pausa. Úsalo en entornos controlados o con proyectos que tengan git para revertir cambios.

Modo plan

Escribe /plan antes de tu petición para que Claude te muestre el plan antes de ejecutar nada. Ideal para tareas complejas:

> /plan refactoriza el módulo de autenticación para usar JWT

Ejemplos de primeras tareas

Entender un proyecto existente

> Explícame la estructura de este proyecto y qué hace cada carpeta
> ¿Qué hace la función processPayment en src/payments.ts?

Crear un archivo nuevo

> Crea un componente React llamado Button con variantes primary y secondary en TypeScript

Arreglar un error

> Tengo este error en la consola: [pegar el error] — ayúdame a resolverlo

Ejecutar tests

> Ejecuta los tests y si hay fallos, corrígelos

Salir de Claude Code

Puedes salir con Ctrl+C, Ctrl+D, o escribiendo:

> /exit

Iniciar con un prompt directo

Si sabes exactamente qué quieres, puedes pasarlo directamente al comando sin entrar al modo interactivo:

claude "explica el archivo package.json"
claude "añade tipos TypeScript al archivo utils.js"

Modo "print" (salida directa)

Para usar Claude Code en scripts o pipelines:

claude -p "resume los cambios en este diff" < cambios.diff

La bandera -p hace que Claude responda una vez y salga, ideal para automatizaciones.