Referencia de comandos · Claude Code
/init
Inicializa el proyecto con una guía CLAUDE.md.
/init analiza el repositorio actual y crea un CLAUDE.md inicial con comandos de compilación, instrucciones de prueba y convenciones del proyecto que Claude descubre en el código. Si ya existe un CLAUDE.md, el comando no lo sobrescribe, sino que propone mejoras concretas.
Además, /init lee automáticamente las reglas de Cursor existentes (.cursor/rules/ o .cursorrules) y las reglas de Copilot (.github/copilot-instructions.md) e incorpora las partes relevantes al CLAUDE.md generado.
Con la variable de entorno CLAUDE_CODE_NEW_INIT=1 se ejecuta en su lugar un flujo interactivo de varias fases: Claude pregunta qué artefactos configurar (CLAUDE.md, skills, hooks), explora el repositorio mediante un subagente, hace preguntas de aclaración y muestra una propuesta para aprobar antes de escribir nada. En este modo, /init también lee AGENTS.md, .devin/rules/, .windsurf/rules/ o .windsurfrules y .clinerules, y puede crear un CLAUDE.local.md privado que no se sube al repositorio. Desde la versión 2.1.108, Claude puede además invocar /init por sí mismo cuando lo considere necesario, a través de la herramienta de skills.
✅ ¿CUÁNDO USARLO?
Preparar un repositorio nuevo para Claude Code
Ejecutar /init en un proyecto recién clonado para que Claude genere un CLAUDE.md inicial con el contexto del proyecto.
Configuración completa incluyendo skills, hooks y memoria
Iniciar /init con la variable de entorno CLAUDE_CODE_NEW_INIT=1 para configurar de forma interactiva también skills, hooks y archivos de memoria personales.
⛔ ¿CUÁNDO MEJOR NO?
Hacer solo un añadido puntual a un CLAUDE.md ya bien mantenido
Según la documentación, /init no sobrescribe un CLAUDE.md existente, solo propone mejoras — para un cambio único y bien delimitado, ejecutar el análisis completo es un rodeo innecesario.
Mejor: Editar CLAUDE.md directamente con /memory.
Añadir solo preferencias privadas que no se versionan
Las preferencias personales van en un CLAUDE.local.md excluido de git; sin CLAUDE_CODE_NEW_INIT=1, /init no lo configura automáticamente.
Mejor: Crear CLAUDE.local.md manualmente y añadirlo a .gitignore.
FUENTES
- documentación de Claude Code (oficial) ↗ code.claude.com