Source: https://aiprimetech.io/es/claude-code/tutorial/

[Inicio](/es/) › [Claude Code](/es/claude-code/) › Tutorial

[Descripción general](/es/claude-code/)[Instalación](/es/claude-code/install/)[referencia de la CLI](/es/claude-code/cli/)[Precios y límites](/es/claude-code/pricing/)[Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins](/es/claude-code/skills/)[GitHub](/es/claude-code/github/)[Web, escritorio e IDE](/es/claude-code/web-and-desktop/)[Modelos](/es/claude-code/models/)[Errores](/es/claude-code/errors/)[¿Código abierto?](/es/claude-code/open-source/)[Tutorial](/es/claude-code/tutorial/)[Para estudiantes](/es/claude-code/for-students/)[Automatización de QA](/es/claude-code/qa-automation/)[Comparación con Cursor](/es/claude-code/vs-cursor/)[Comparación con Codex y OpenCode](/es/claude-code/vs-codex/)[Subagentes](/es/claude-code/subagents/)[Hooks](/es/claude-code/hooks/)[MCP](/es/claude-code/mcp/)[Ecosistema](/es/claude-code/ecosystem/)[VS Code](/es/claude-code/vscode/)[OpenRouter](/es/claude-code/openrouter/)[Límites de solicitudes](/es/claude-code/rate-limits/)[Guía en chino](/claude-code/zh/)

Última actualización: 11 de octubre de 2026

# Tutorial de Claude Code: tu primera sesión real

Esta es la sesión que debes realizar una vez, de forma deliberada, para que todas las siguientes sean rápidas. Treinta minutos, un repositorio real y adquirirás los hábitos que distinguen a quienes disfrutan de Claude Code de quienes lo encuentran caro e impredecible.

## TLDR
- Empezar con /init — un buen CLAUDE.md es el archivo que más impacto tiene en el repositorio.
- Planifica antes de editar: pide un plan, apruébalo y después deja que lo ejecute.
- Restringe los permisos, compacta con frecuencia y usa el modelo más económico que pueda hacer el trabajo.

## 1. Abre el proyecto y escribe el archivo de memoria 

```
cd your-project
claude
/init
```

/init inspecciona el repositorio y prepara un borrador de CLAUDE.md: cómo compilar, cómo ejecutar las pruebas, convenciones y qué no tocar. Edítalo. Todas las sesiones futuras lo leen primero, por eso se amortiza en un día: el agente deja de redescubrir tu proyecto cada vez. 

## 2. Modo de planificación: pide un plan, no un cambio 

Claude Code incorpora un modo de planificación: pulsa Shift+Tab para alternar el modo de permisos hasta que indique plan, o inicia con claude --permission-mode plan, y el agente podrá leer y pensar, pero no editar ni ejecutar nada hasta que vuelvas a cambiar de modo. Es la forma más segura de explorar una base de código desconocida y la más económica de iniciar un cambio grande. 

```
> Plan how to add rate limiting to the /api/upload route. Don't edit anything yet.
```

Lee el plan. Corrígelo con lenguaje sencillo. Después: go ahead. Planificar y después ejecutar produce mejores cambios y sesiones más económicas que dejar que el agente explore mediante ediciones. 

## 3. Deja que ejecute las pruebas 

Indícale cómo se ejecutan las pruebas (o deja que lo indique CLAUDE.md) y pídele que las ejecute después del cambio. El ciclo —editar, probar, leer el fallo, corregir— es donde mejor se desenvuelve el agente. Presta atención a las solicitudes de permiso: cada una es una oportunidad para delimitar lo que puede hacer. 

## 4. Permisos 

```
/permissions
```

Permite la lectura y la edición libremente, autoriza comandos seguros específicos (Bash(npm test), Bash(git diff *)) y mantén cualquier acción destructiva sujeta a confirmación. En los scripts, configura el mismo conjunto con --allowedTools. 

## 5. Compacta cuando cambie el tema 

```
/compact focus on the rate limiter; drop the earlier exploration
```

El contexto tiene un coste. Cada turno vuelve a enviar todo lo acumulado. Compacta cada vez que cambies de rumbo y /clear entre tareas no relacionadas: este único hábito reduce a la mitad las facturas de la mayoría de los usuarios. 

## 6. Elige el modelo para cada paso 

Mantente en el nivel Sonnet de forma predeterminada. Para esa decisión realmente difícil, /model a Opus, toma la decisión y vuelve al modelo anterior. La guía de modelos explica los niveles y cómo fijarlos. 

## 7. Crea un commit y revísalo 

```
> Commit this as a single change with a message that explains the rate limit values.
```

Pídele que cree un commit y después lee tú mismo el diff. El agente es un ingeniero júnior rápido e incansable, con una memoria excelente de tu CLAUDE.md: revisa su trabajo igual que revisarías el de uno. 

## Por dónde seguir 
- Habilidades: enséñale los procedimientos de tu equipo una sola vez.
- Subagentes (/agents): reparte tareas grandes entre agentes especializados.
- Servidores MCP (/mcp): dale acceso a tu base de datos, navegador y sistema de seguimiento de incidencias.
- La acción de GitHub: el mismo ciclo en cada solicitud de incorporación de cambios.
- Precios: y cómo dejar de vigilar el consumo con un plan de tarifa plana.

## Pruébalo gratis primero

Las cuentas nuevas reciben $5 de crédito gratuito para la API con el código CLAUDECODE — suficiente para una tarde de Claude Code con Sonnet — y después créditos por 7.69231× su valor nominal.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[Crea una cuenta con el código CLAUDECODE](/register?promo=CLAUDECODE)

## Preguntas frecuentes

¿Qué es CLAUDE.md?

El archivo de memoria del proyecto que Claude Code lee al inicio de cada sesión: comandos de compilación y pruebas, convenciones y límites. /init prepara el borrador; tú lo mantienes actualizado.¿Qué es el modo de planificación en Claude Code?

Pedir un plan sin ediciones, aprobarlo y después ejecutarlo. Produce mejores cambios y sesiones más cortas y económicas que la edición exploratoria.¿Cómo hago para que Claude Code deje de pedir permiso cada vez?

Usa /permissions para aprobar de antemano herramientas y comandos seguros, o --allowedTools en los scripts. Mantén los comandos destructivos sujetos a confirmación.

## Ejecuta Claude Code con la pasarela

Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código CLAUDECODE.[Obtener una clave de API](/register?promo=CLAUDECODE) [Ver planes ilimitados](/es/plans/)

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.

## Más guías de Claude Code

[Claude Code: la guía completa](/es/claude-code/)[Cómo instalar Claude Code](/es/claude-code/install/)[Documentación de la CLI de Claude Code: comandos y opciones](/es/claude-code/cli/)[Precios y límites de Claude Code, explicados](/es/claude-code/pricing/)[El SDK de Claude Code, ahora Claude Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins de Claude Code](/es/claude-code/skills/)[Claude Code en GitHub: la App, la Action y @claude](/es/claude-code/github/)[¿Claude Code tiene una interfaz web? Explicación de las versiones web, de escritorio y para IDE](/es/claude-code/web-and-desktop/)[Qué modelo utiliza Claude Code y cómo cambiarlo](/es/claude-code/models/)[Errores de Claude Code y cómo solucionarlos](/es/claude-code/errors/)[¿Claude Code es de código abierto?](/es/claude-code/open-source/)[Claude para estudiantes: Claude Code, la API y qué ofrece realmente el ámbito educativo](/es/claude-code/for-students/)[Cómo usar Claude Code para automatizar QA](/es/claude-code/qa-automation/)[Claude Code frente a Cursor: cuál usar, cuándo y cómo ejecutar ambos](/es/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparativa de los agentes de terminal](/es/claude-code/vs-codex/)[Subagentes de Claude Code: cómo funcionan, cómo definirlos y equipos de agentes](/es/claude-code/subagents/)[Hooks de Claude Code: control determinista sobre lo que hace el agente](/es/claude-code/hooks/)[MCP en Claude Code: conexión de servidores, ámbitos, MCP remoto y ejemplos reales](/es/claude-code/mcp/)[El ecosistema de Claude Code: enrutadores, frameworks, plugins y las listas que los recopilan](/es/claude-code/ecosystem/)[Claude Code en VS Code: la extensión, el uso desde la terminal y los errores](/es/claude-code/vscode/)[Cómo usar OpenRouter en Claude Code (y cuándo no hacerlo)](/es/claude-code/openrouter/)[Error de límite de solicitudes de Claude: qué significa «Error de API: se ha alcanzado el límite de solicitudes» y cómo solucionarlo](/es/claude-code/rate-limits/)[Cómo usar Claude Code: desde la instalación hasta el uso diario](/claude-code/zh/)