Primeros pasos

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.

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 con más autonomía

Para trabajar más rápido, empieza por encargos acotados y permisos explícitos. El flujo normal no consiste en saltarse todas las confirmaciones, sino en revisar qué acciones acepta la sesión con /permissions.

/permissions

Omisión total de permisos

--dangerously-skip-permissions no es el modo automático normal. Equivale a--permission-mode bypassPermissions: omite los prompts de permisos y solo debería usarse en entornos desechables, aislados y sin secretos accesibles.

# Evítalo como flujo habitual
claude --permission-mode bypassPermissions

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.