Arrancar un Nuevo Proyecto con /init

/init es un comando de barra de Claude Code que escanea un repositorio nuevo (o existente) y redacta un CLAUDE.md inicial para ti, de modo que no tengas que escribir la memoria del proyecto desde cero.

Resumen

Cada nuevo proyecto eventualmente necesita un CLAUDE.md que describa sus convenciones, estructura y reglas.

Escribirlo desde cero significa re-derivar cosas que Claude Code ya puede ver por sí mismo, como el lenguaje, la disposición de las carpetas y la configuración de las pruebas.

/init cierra esa brecha haciendo que Claude Code examine el proyecto primero y produzca un borrador, que luego tú lees y corriges.

Es el camino más rápido desde "sin memoria de proyecto" hasta "un CLAUDE.md funcional", aunque el resultado aún necesita una revisión humana.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

cd mi-proyecto
claude
# una vez dentro de la sesión de Claude Code:
/init

Cuándo usar esto:

• Al iniciar un proyecto completamente nuevo y quieres tener la memoria del proyecto lista desde el primer día.
• Al heredar un repositorio existente que aún no tiene un CLAUDE.md.
• Las convenciones del proyecto han cambiado lo suficiente como para que valga la pena regenerar y revisar el CLAUDE.md existente.
• Quieres una primera pasada rápida para documentar la estructura antes de refinarla manualmente.

Ejemplo de Trabajo

Aquí tienes una sesión completa desde un CLAUDE.md vacío hasta uno revisado, en un pequeño proyecto de API Node.js.

# 1. Inicia Claude Code dentro de la raíz del proyecto
cd order-service
claude
 
# 2. Ejecuta /init dentro de la sesión
/init
 
# Claude Code escanea package.json, la estructura de carpetas, el contenido
# existente de README, la configuración de pruebas y cualquier archivo de configuración,
# luego escribe un CLAUDE.md de primera pasada en la raíz del proyecto.
 
# 3. Revisa lo que produjo
cat CLAUDE.md

Un borrador inicial típico de /init se ve algo así:

# Proyecto: order-service
 
## Descripción general
Una API REST de Node.js para gestionar pedidos de clientes.
 
## Pila Tecnológica
- Node.js, Express
- PostgreSQL a través de `pg`
- Jest para pruebas
 
## Estructura
- `src/routes/` - Manejadores de rutas de Express
- `src/services/` - lógica de negocio
- `src/db/` - acceso a la base de datos
- `__tests__/` - archivos de prueba de Jest
 
## Comandos
- `npm test` - ejecuta la suite de pruebas
- `npm run dev` - inicia el servidor de desarrollo

# 4. Edita el borrador para añadir cualquier cosa que /init no pudo inferir,
#    como reglas específicas del equipo y restricciones estrictas.

## Reglas Estrictas
- Nunca consultes la base de datos directamente desde un manejador de rutas; pasa por `src/services/`.
- Siempre añade una prueba en `__tests__/` para cualquier ruta nueva.
- No hagas commit directamente en `main`.

# 5. Haz commit del archivo finalizado
git add CLAUDE.md
git commit -m "Añadir CLAUDE.md vía /init"

Lo que esto demuestra:

• /init produce un borrador estructural inicial (pila, carpetas, comandos) a partir de lo que puede observar en el repositorio.
• Las reglas específicas del equipo y las restricciones estrictas rara vez son inferibles solo del código; sigues añadiéndolas manualmente.
• El archivo generado está destinado a ser revisado y confirmado como cualquier otro archivo del proyecto, no aceptado ciegamente.
• Ejecutar /init es lo suficientemente rápido como para repetirlo cada vez que la forma del proyecto haya cambiado significativamente.

Profundización

Cómo Funciona

• /init lee los archivos del proyecto (manifiestos de paquetes, estructura de carpetas, documentación existente, configuración) para inferir la pila tecnológica y la disposición.
• Escribe el resultado en CLAUDE.md en la raíz del proyecto, en markdown plano.
• Si ya existe un CLAUDE.md, ejecutar /init de nuevo lo actualiza basándose en el estado actual del proyecto en lugar de crear un archivo duplicado.
• El comando no ejecuta pruebas, no instala nada ni modifica código; solo produce documentación.
• Lo que escribe se carga exactamente igual que un CLAUDE.md escrito a mano al inicio de cada sesión futura.

Lo que /init Captura Confiablemente vs. Lo que No

Volver a Ejecutar /init en un Proyecto Existente

# CLAUDE.md ya existe y está un poco desactualizado
/init
 
# Claude Code vuelve a escanear el proyecto y actualiza CLAUDE.md
# para reflejar la estructura actual, en lugar de empezar de nuevo

Trampas Comunes

• Aceptar el borrador sin leerlo. /init infiere lo que puede ver, pero no puede conocer las convenciones del equipo no escritas. Solución: lee siempre el archivo generado de principio a fin antes de confirmarlo.
• Perder reglas escritas a mano en una re-ejecución. Volver a ejecutar /init actualiza el archivo basándose en el estado actual del proyecto, lo que puede mezclarse con ediciones manuales previas si no prestas atención. Solución: compara el archivo después de volver a ejecutar /init y confirma que tus reglas estrictas siguen ahí.
• Tratar el borrador como exhaustivo. /init documenta lo que existe, no lo que nunca debería suceder. Solución: añade una sección explícita de "Reglas Estrictas" manualmente para cualquier cosa no negociable.
• Ejecutar /init en el directorio incorrecto. Si se ejecuta fuera de la raíz real del proyecto, el escaneo produce una imagen inexacta o vacía del proyecto. Solución: confirma que estás en la raíz del proyecto (pwd, busca el archivo manifiesto del proyecto) antes de ejecutarlo.
• Dejar que el borrador se desactualice. Un CLAUDE.md generado una vez al inicio del proyecto puede desviarse a medida que la base de código evoluciona. Solución: vuelve a ejecutar /init periódicamente, o actualiza el archivo manualmente cuando la estructura cambie significativamente.

Alternativas

Preguntas Frecuentes

Relacionado

• Qué Hace Realmente CLAUDE.md - el concepto que /init está arrancando.
• Conceptos Básicos de Gestión de Contexto - dónde encaja /init entre las herramientas principales de la sección.
• Escribir un Archivo CLAUDE.md Que Realmente Se Siga - refinando el borrador que produce /init.
• Archivos CLAUDE.md Anidados y Cómo Funciona la Herencia de Ámbito - añadiendo reglas con ámbito más allá de lo que genera /init en la raíz.

Versiones de la Pila: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.