![Imagen de portada de [Claude Code #1] Empezar con /init y la generación automática de CLAUDE.md](/assets/images/posts/29f64ad2-15d8-41ec-84be-686abdce13e9/claude-code-init-1.jpg)
Al añadir una herramienta de programación con IA a un proyecto nuevo, acabas repitiendo las mismas explicaciones: cuál es el comando de compilación, cómo se ejecutan las pruebas y qué reglas debe seguir el código.
Claude Code guarda estas explicaciones en un archivo llamado CLAUDE.md y lo lee automáticamente en cada sesión. El problema es que escribirlo desde cero puede resultar sorprendentemente abrumador.
/init es el comando que ayuda a superar ese primer obstáculo. Analiza el código base y crea un borrador de CLAUDE.md por ti.
Este es el primer artículo de una serie que analiza los comandos de Claude Code uno por uno. Empezaremos por el comando que normalmente se ejecuta primero.
Qué hace /init
Escribe /init en el campo de entrada de la sesión y Claude empezará a explorar el proyecto.
Documentación oficial sobre la memoria describe el proceso así: analiza el código base, encuentra los comandos de compilación, los métodos de prueba y las convenciones del proyecto, y genera CLAUDE.md con esa información.
El resultado tiene aproximadamente este aspecto.
# CLAUDE.md
## Compilación y pruebas
- Servidor de desarrollo: pnpm dev
- Pruebas: pnpm test (Obligatorias antes de confirmar)
## Estructura
- API Los controladores van en src/api/handlers/
- Los tipos compartidos se agrupan en src/lib/types.tsLa información que puede leerse en package.json o Makefile forma la estructura básica. Un borrador que una persona tardaría 30 minutos en escribir puede estar listo en unos minutos.
Si te preguntas qué es CLAUDE.md y por qué hace falta, te conviene leer primero Artículo sobre las reglas y la memoria de Claude Code.
Si ya existe CLAUDE.md
Volver a ejecutar /init no sobrescribe el archivo existente.
Según la documentación oficial, si el archivo ya existe, propone mejoras en lugar de sobrescribirlo. Por eso es seguro ejecutarlo incluso cuando el proyecto ya está avanzado.
Conviene ejecutarlo periódicamente al revisar un CLAUDE.md antiguo. Puede proponer mejoras que incorporen los procedimientos de compilación y pruebas modificados desde entonces.
Al migrar desde otras herramientas de IA
/init también lee los archivos de reglas de otros agentes de programación.
Los objetivos son .cursor/rules/ y .cursorrules de Cursor, y .github/copilot-instructions.md de GitHub Copilot. Selecciona el contenido relevante y lo integra en el nuevo CLAUDE.md.
Si el repositorio ya usa AGENTS.md, hay otro método. Añade la línea @AGENTS.md a CLAUDE.md para cargar el archivo completo.
@AGENTS.md
## Claude Code Instrucciones específicas
- src/billing/ Usa primero el modo de planificación al modificar lo siguienteAmbas herramientas leerán las mismas reglas, así que no hace falta copiar el contenido.
Si el repositorio usaba Codex CLI o Gemini CLI, existe un comando independiente, /import. Migra de una vez todo, desde los archivos de instrucciones hasta los servidores MCP, comandos y skills (v2.1.213 o posterior).
Activar el /init interactivo
Con una sola variable de entorno puedes cambiar /init a un modo interactivo más exhaustivo.
CLAUDE_CODE_NEW_INIT=1 claudeEn este modo, /init pregunta primero qué quieres crear. Puedes elegir entre crear solo CLAUDE.md o configurar también skills y hooks (scripts que se ejecutan automáticamente en momentos concretos).
Después explora el código base con subagentes y pregunta lo necesario para completar la información que falta. Como muestra una propuesta antes de escribir los archivos, puedes revisarla y aplicarla después.
Este modo también amplía el conjunto de archivos de reglas que lee. Incluye como referencia configuraciones de otras herramientas, como AGENTS.md, .windsurf/rules/ y .clinerules.
Compruébalo después de crearlo
Cuando termine la generación, prueba a ejecutar /context.
Si CLAUDE.md aparece en Memory files, se ha cargado correctamente. Si no aparece, Claude no está leyendo el archivo.
Para abrir y editar el archivo, usa el comando /memory. Lo abre directamente en un editor dentro de la sesión.
Un borrador es solo un borrador: criterios para ajustarlo
Hay una razón para no dejar intacto el archivo creado por /init: le falta conocimiento que el análisis automático no puede encontrar.
La documentación oficial también recomienda añadir, después de crear el archivo, «instrucciones que Claude no pueda descubrir por sí mismo». Por ejemplo, el contexto de por qué se eligió una estructura y qué errores conviene evitar.
Al ajustarlo, basta con recordar dos criterios.
Primero, intenta mantener cada archivo en 200 líneas o menos. Cuanto más largo sea, más contexto consume y menor será el cumplimiento de las instrucciones.
Segundo, escribe frases verificables. «Mantén limpio el código» se respeta mucho peor que «usa una indentación de 2 espacios».
Puedes eliminar información evidente al mirar el código, como las listas de directorios. La comprobación /doctor también puede encontrar este contenido superfluo y sugerir su eliminación (v2.1.206 o posterior).
Si quieres saber más sobre por qué debe mantenerse breve, Por qué CLAUDE.md debe ser breve lo explica en detalle.
Resumen
/init es la primera puerta de entrada al empezar a usar Claude Code en un proyecto nuevo.
Analiza el código base para crear un borrador de CLAUDE.md y propone mejoras si ya existe un archivo. También migra las reglas de Cursor y Copilot, por lo que resulta útil al cambiar de herramienta.
Pero el borrador solo es el punto de partida. Añadir el contexto del equipo que el análisis automático no puede encontrar y ajustarlo a 200 líneas o menos sigue siendo tarea humana.
En el próximo artículo previsto, Claude Code, parte 2, trataremos el /plan modo de planificación, en el que se acuerda el diseño antes de modificar el código.
Fuentes y criterios de verificación
- Documentación oficial de Claude Code — How Claude remembers your project (Anthropic, comprobado el 2026-08-12)