Para usar Claude Code, instálalo con un solo comando, ejecuta claude dentro de la carpeta de un proyecto, inicia sesión con tu cuenta de Claude en el navegador y describe en lenguaje natural lo que quieres. Claude lee el código que necesita, propone ediciones y comandos, y pregunta antes de hacer algo que no hayas permitido.
Ese es todo el ciclo. El resto de esta guía cubre lo que hace que funcione bien: un archivo CLAUDE.md, los modos de permisos, un puñado de comandos slash, plan mode y algunos hábitos que te mantienen dentro de tus límites de uso.
Qué es Claude Code
Claude Code es el agente de programación de Anthropic. Se ejecuta en tu terminal (y también en VS Code, JetBrains, una app de escritorio y la web), trabaja con los archivos de la carpeta desde la que lo inicias y puede ejecutar comandos de shell como tus tests, linters y git. A diferencia de una ventana de chat, no necesita que le pegues código: él mismo va a leer lo que necesita.
Paso 1: instala Claude Code
El instalador nativo es la forma recomendada. Se actualiza solo en segundo plano.
| Plataforma | Comando |
|---|---|
| macOS, Linux, WSL | curl -fsSL https://claude.ai/install.sh | bash |
| Windows PowerShell | irm https://claude.ai/install.ps1 | iex |
| macOS (Homebrew) | brew install --cask claude-code |
| Windows (WinGet) | winget install Anthropic.ClaudeCode |
Las instalaciones con Homebrew y WinGet no se actualizan solas, así que actualízalas de vez en cuando con tu gestor de paquetes. Comprueba que funcionó:
claude --versionPaso 2: inicia sesión
Ve a la carpeta de un proyecto y arráncalo:
cd your-project
claudeLa primera vez, Claude Code abre tu navegador para iniciar sesión. Puedes usar:
- una suscripción Claude Pro, Max, Team o Enterprise, que es la opción habitual;
- una cuenta de Claude Console, facturada por token con créditos prepagados;
- un proveedor de nube: Amazon Bedrock, Google Cloud o Microsoft Foundry.
Tu sesión se guarda, así que solo lo haces una vez. Si tienes más de una cuenta, /login te permite cambiar entre ellas.
Paso 3: tu primera tarea
Empieza con algo pequeño y real, no con «constrúyeme una app». Buenas primeras tareas:
- «Explica cómo funciona la autenticación en este proyecto.»
- «Ejecuta los tests y dime por qué falla el que falla.»
- «Añade validación de entrada al formulario de registro, con un test.»
Escríbela y pulsa Enter. Claude lee archivos y luego propone cambios o comandos. Según tu modo de permisos, o pregunta primero o sigue adelante, y te muestra cada edición como un diff. Léelos. Quien entrega el código sigues siendo tú.
También puedes empezar directamente con una tarea:
claude "find where we parse dates and list the formats we accept"Otras formas útiles de empezar:
| Comando | Qué hace |
|---|---|
claude | Inicia una sesión interactiva |
claude "task" | Inicia una sesión con un primer mensaje |
claude -p "task" | Se ejecuta una vez, imprime la respuesta y termina (útil para scripts) |
claude -c | Continúa la conversación más reciente de esta carpeta |
claude -r | Elige una conversación anterior para retomarla |
Paso 4: escribe un CLAUDE.md
Cada sesión empieza con una ventana de contexto nueva. CLAUDE.md es la forma en que Claude recuerda tu proyecto: un archivo Markdown que lee al inicio de cada sesión.
Ejecuta esto en una sesión:
/initClaude recorre el código y escribe un primer CLAUDE.md con tus comandos de compilación, de test y las convenciones que encontró. Si ya existe un CLAUDE.md, sugiere mejoras en su lugar. Después edítalo tú. Cosas útiles para incluir:
- cómo compilar, ejecutar y probar (
pnpm test, no «ejecuta los tests») - convenciones que no son obvias a partir del código
- cosas que evitar («nunca edites los archivos generados de
src/gen/») - dónde viven las partes importantes
Mantenlo corto; Anthropic sugiere no pasar de unas 200 líneas por archivo. Los archivos largos consumen contexto y se siguen con menos fiabilidad. Puedes dividir el contenido con importaciones @path/to/file.
Un CLAUDE.md puede vivir en varios sitios:
| Archivo | Alcance |
|---|---|
./CLAUDE.md o ./.claude/CLAUDE.md | El proyecto, compartido con tu equipo mediante git |
~/.claude/CLAUDE.md | Tú, en todos los proyectos |
./CLAUDE.local.md | Tú, solo en este proyecto (déjalo fuera de git) |
Si tu repositorio ya tiene un AGENTS.md para otros agentes, las versiones recientes de Claude Code lo leen cuando no hay CLAUDE.md, y puedes importarlo desde un CLAUDE.md con @AGENTS.md.
Paso 5: entiende los permisos
Claude Code pregunta antes de hacer algo arriesgado. Con qué frecuencia pregunta depende del modo de permisos. Pulsa Shift+Tab para recorrerlos; el actual aparece en la parte inferior de la pantalla.
| Modo | Qué se ejecuta sin preguntar | Bueno para |
|---|---|---|
Manual (default) | Leer archivos | Aprender, código sensible |
| Accept edits | Lecturas, ediciones de archivos, comandos simples del sistema de archivos | Trabajo que de todos modos revisarás en el diff |
| Plan mode | Solo lecturas; sin editar tu código fuente | Explorar y diseñar antes de programar |
| Auto mode | La mayoría de las acciones, revisadas por un clasificador de seguridad | Tareas más largas con menos avisos |
Las versiones recientes arrancan en auto mode por defecto; las más antiguas arrancan en Manual. En auto mode un segundo modelo revisa cada acción y bloquea lo que parece arriesgado o fuera de la tarea, pero no es una garantía, así que vigila lo que hace.
Para un control más fino, /permissions te deja añadir reglas allow, ask y deny, como «permitir siempre npm test» o «preguntar siempre antes de git push». En macOS, Linux y WSL2, /sandbox ejecuta los comandos de Bash dentro de un sandbox.
También existe --dangerously-skip-permissions, que nunca pregunta. La propia documentación de Anthropic dice que se use solo dentro de un contenedor o una máquina virtual. No lo uses en tu máquina principal mientras aprendes.
Paso 6: los comandos slash que conviene conocer
Escribe / en una sesión para ver todos los comandos. Estos son los que más usarás:
| Comando | Qué hace |
|---|---|
/help | Muestra la ayuda y los comandos |
/init | Crea o mejora CLAUDE.md |
/clear | Empieza una conversación nueva (la anterior sigue en /resume) |
/compact | Resume la conversación hasta ahora para liberar contexto |
/context | Muestra qué está llenando tu ventana de contexto |
/model | Cambia de modelo; las flechas ajustan el esfuerzo |
/plan | Entra en plan mode, opcionalmente con una tarea |
/permissions | Gestiona las reglas allow, ask y deny |
/rewind | Vuelve a un punto anterior de la conversación y del código |
/resume | Reabre una conversación anterior |
/mcp | Gestiona servidores MCP (herramientas adicionales) |
/usage | Muestra los límites de uso de tu plan |
/review | Revisa tus cambios actuales |
/memory | Edita tus archivos CLAUDE.md |
/rewind es el que los principiantes se pierden. Si Claude toma un mal camino, vuelve a antes de que empezara en lugar de discutir para que rectifique.
Paso 7: usa plan mode para lo más grande
Para cambios que toquen más de uno o dos archivos, pide primero un plan. Pulsa Shift+Tab hasta ver plan mode, o escribe:
/plan add rate limiting to the public APIEn plan mode Claude lee el código, hace preguntas aclaratorias y escribe un plan, pero no edita tu código fuente. Lees el plan, rebates lo que no te guste y lo apruebas cuando está bien. Entonces pasa a editar y avanza por el plan.
Cuesta unos minutos y ahorra mucho deshacer. También puedes iniciar una sesión en plan mode con claude --permission-mode plan.
Buenos hábitos al pedir
Claude Code sigue bien las instrucciones claras. La mayoría de los malos resultados vienen de las vagas.
- Di cómo comprobar el trabajo. «Añade el endpoint y haz que pase
pnpm test api» es mejor que «añade el endpoint». - Señala archivos. Menciona el archivo o la función por su nombre, o escribe
@para referenciar un archivo. - Una tarea por conversación. Usa
/clearcuando pases a algo sin relación. - Da ejemplos. «Sigue el patrón de
users.service.ts» vale más que un párrafo de descripción. - Pídele que explique primero cuando no conozcas el código: «¿Cómo funciona X? No cambies nada todavía.»
- Interrumpe pronto. Pulsa Esc para pararlo si va por mal camino y corrígelo.
- Pon en CLAUDE.md las correcciones repetidas. Si lo has dicho dos veces, anótalo.
Límites y cómo mantenerte dentro
Los planes de suscripción tienen límites de uso: una ventana móvil de 5 horas y un límite semanal, y los planes superiores dan más. Las conversaciones largas consumen más, porque cada mensaje arrastra todo el contexto.
- Comprueba dónde estás con
/usage. - Usa
/clearentre tareas sin relación. - Usa
/compacten sesiones largas, opcionalmente indicando qué conservar:/compact keep the API decisions. - Usa
/contextpara ver qué ocupa espacio, como archivos grandes o muchas herramientas MCP. - Elige un modelo más ligero para el trabajo simple con
/model.
Más sobre esto en límites de uso de Claude Code y cómo reducir el consumo de tokens de Claude Code.
Cuando una terminal no basta
Cuando te sientas cómodo, querrás un segundo Claude trabajando mientras el primero ejecuta los tests. Dos agentes en la misma carpeta se pisarán los archivos, así que cada uno necesita su propio git worktree. Ahí es donde una sola terminal se vuelve incómoda.
AgentVera es una app de escritorio para macOS, Windows y Linux que ejecuta Claude Code (y otros agentes CLI) en terminales reales, una al lado de otra. Usa el login de Claude Code que ya tienes.
- Workspace: una cuadrícula de agentes por proyecto, de 1×1 a 5×4. Cada agente tiene su propio nombre, modelo, esfuerzo y “Role and instructions”, y vuelve a su conversación tras reiniciar.
- Worktrees: en el panel Git, crea un worktree e inicia un agente en él con un clic, para que los agentes en paralelo nunca compartan archivos.
- Permisos por agente: en el diálogo “New agent”, elige Ask, Auto o Full access. Auto usa el auto mode propio de Claude Code.
- Checkpoints y replay: se conservan los últimos 60 turnos por agente y puedes reproducir una sesión.
- Contexto de un vistazo: cada panel muestra el tamaño de su contexto en vivo, y el auto-compact se activa antes de que se llene la ventana.
Todo lo anterior está en el plan gratuito. La aprobación automática, que deja pasar lecturas y tests seguros y sigue preguntando antes de cosas como git push o rm, está en Pro y Team.
Cuando llegues ahí, lee cómo ejecutar varios agentes de Claude Code y descarga AgentVera gratis.
Ten a mano la hoja de referencia de comandos de Claude Code mientras aprendes, y si trabajas en VS Code, mira la configuración de la extensión de VS Code.
Conclusión
Instala, ejecuta claude, inicia sesión y empieza con una tarea pequeña y real. Lanza /init y mantén corto tu CLAUDE.md. Usa Shift+Tab para elegir cuánto puede hacer Claude, plan mode para lo más grande, /rewind cuando algo sale mal, y /clear y /compact para mantenerte dentro de tus límites. Eso cubre la mayor parte de lo que necesitas en las primeras semanas.