Inicio › Claude Code › Tutorial
Descripción generalInstalaciónreferencia de la CLIPrecios y límitesAgent SDKHabilidades y pluginsGitHubWeb, escritorio e IDEModelosErrores¿Código abierto?TutorialPara estudiantesAutomatización de QAComparación con CursorComparación con Codex y OpenCodeSubagentesHooksMCPEcosistemaVS CodeOpenRouterLímites de solicitudesGuía en chino
Ú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

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 Ver planes ilimitados

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 completaCómo instalar Claude CodeDocumentación de la CLI de Claude Code: comandos y opcionesPrecios y límites de Claude Code, explicadosEl SDK de Claude Code, ahora Claude Agent SDKHabilidades y plugins de Claude CodeClaude Code en GitHub: la App, la Action y @claude¿Claude Code tiene una interfaz web? Explicación de las versiones web, de escritorio y para IDEQué modelo utiliza Claude Code y cómo cambiarloErrores de Claude Code y cómo solucionarlos¿Claude Code es de código abierto?Claude para estudiantes: Claude Code, la API y qué ofrece realmente el ámbito educativoCómo usar Claude Code para automatizar QAClaude Code frente a Cursor: cuál usar, cuándo y cómo ejecutar ambosClaude Code vs Codex vs OpenCode: comparativa de los agentes de terminalSubagentes de Claude Code: cómo funcionan, cómo definirlos y equipos de agentesHooks de Claude Code: control determinista sobre lo que hace el agenteMCP en Claude Code: conexión de servidores, ámbitos, MCP remoto y ejemplos realesEl ecosistema de Claude Code: enrutadores, frameworks, plugins y las listas que los recopilanClaude Code en VS Code: la extensión, el uso desde la terminal y los erroresCómo usar OpenRouter en Claude Code (y cuándo no hacerlo)Error de límite de solicitudes de Claude: qué significa «Error de API: se ha alcanzado el límite de solicitudes» y cómo solucionarloCómo usar Claude Code: desde la instalación hasta el uso diario