# Cómo usar Claude Code: guía para principiantes

URL: https://agentvera.dev/es/blog/how-to-use-claude-code/ · Publicado: 2026-10-22

Cómo usar Claude Code paso a paso: instalación, login, primera tarea, CLAUDE.md, modos de permisos, comandos slash, plan mode y cómo no pasarte de los límites de uso.

**En resumen:**

- Claude Code requiere un plan Claude Pro, Max, Team o Enterprise, una cuenta de Claude Console, o Amazon Bedrock, Google Cloud o Microsoft Foundry; el plan gratuito de Claude.ai no lo incluye.
- Tras instalarlo, ejecuta claude en la carpeta de un proyecto, inicia sesión una vez en el navegador y lanza /init para crear un CLAUDE.md que mantengas por debajo de unas 200 líneas.
- Shift+Tab alterna los modos de permisos; usa plan mode para cambios que toquen más de uno o dos archivos, /rewind para deshacer un mal camino, y /clear y /compact para respetar los límites.

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ó:

```bash
claude --version
```

## Paso 2: inicia sesión

Ve a la carpeta de un proyecto y arráncalo:

```bash
cd your-project
claude
```

La 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:

```bash
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:

```
/init
```

Claude 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 API
```

En 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 `/clear` cuando 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 `/clear` entre tareas sin relación.
- Usa `/compact` en sesiones largas, opcionalmente indicando qué conservar: `/compact keep the API decisions`.
- Usa `/context` para 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](/es/blog/claude-code-usage-limits/ "Límites de uso de Claude Code") y [cómo reducir el consumo de tokens de Claude Code](/es/blog/claude-code-token-usage/ "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](/es/features/workspace/ "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](/es/features/git-and-github/ "Git y GitHub"), 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](/es/features/checkpoints-and-replay/ "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](/es/blog/run-multiple-claude-code-agents/ "Ejecutar varios agentes de Claude Code") y [descarga AgentVera gratis](/es/download/ "Descargar AgentVera").

Ten a mano la [hoja de referencia de comandos de Claude Code](/es/blog/claude-code-commands-cheat-sheet/ "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](/es/blog/claude-code-vs-code/ "Extensión de VS Code de Claude 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.

## Preguntas frecuentes

**¿Necesito un plan de pago para usar Claude Code?** Sí. Claude Code necesita un plan Claude Pro, Max, Team o Enterprise, o una cuenta de Claude Console con créditos de API. También funciona con Amazon Bedrock, Google Cloud o Microsoft Foundry. El plan gratuito de Claude.ai no lo incluye.

**¿Funciona Claude Code en Windows?** Sí. Instálalo desde PowerShell con el instalador nativo o con WinGet. También funciona dentro de WSL. Comandos como /init, plan mode y los permisos funcionan igual en todas las plataformas.

**¿Para qué sirve CLAUDE.md?** CLAUDE.md es un archivo Markdown con instrucciones del proyecto que Claude Code lee al inicio de cada sesión: comandos de compilación y tests, estilo de código, cosas que evitar. Lanza /init para generar una primera versión, mantenla corta y edítala sobre la marcha.

**¿Cómo evito que Claude Code cambie archivos sin preguntar?** Pulsa Shift+Tab hasta estar en modo Manual (o en plan mode, que no edita nada hasta que apruebes un plan). También puedes añadir reglas ask y deny con /permissions, por ejemplo para preguntar siempre antes de git push.

**¿Qué hago cuando Claude Code alcanza su límite de uso?** Mira /usage para saber cuándo se reinicia la ventana. Usa /clear entre tareas sin relación y /compact en sesiones largas para que cada mensaje lleve menos contexto. Si tienes más de una cuenta de Claude, puedes cambiar con /login.

---

**Sobre AgentVera.** AgentVera es una app de escritorio para macOS, Windows y Linux, desarrollada por Solviera Teknoloji. Ejecuta 18 agentes de programación con IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) en paralelo, por proyecto, en terminales reales con las instalaciones y sesiones de CLI del propio usuario. El plan gratuito tiene agentes ilimitados. Descargar: https://agentvera.dev/es/download/ · Precios: https://agentvera.dev/es/pricing/