14.1 — Inicialización del proyecto
Todo empieza con una carpeta vacía y tres decisiones fundamentales: la estructura del repositorio, el contenido del CLAUDE.md y los permisos en settings.json. Estos tres elementos determinan la calidad de todo lo que Claude Code producirá después.
Lanza /init en una carpeta nueva. Claude analiza el repo (vacío por ahora) y genera un CLAUDE.md de base. Este esqueleto es un punto de partida, no un entregable. Enriquécelo de inmediato con tu stack técnico (Node.js + TypeScript + Express + Prisma para el backend, React + Vite para el frontend), tus comandos de build y de test, tus convenciones de código (TypeScript strict, validación Zod, nada de any) y la arquitectura objetivo (routes, services, prisma).
Después, crea .claude/settings.json para definir la zona de confianza. Autoriza los comandos habituales (npm, npx, node, git) y bloquea los comandos destructivos (rm -rf /, sudo). Desde la versión actual de Claude Code, también puedes ubicar el archivo en .claude/CLAUDE.md, las dos ubicaciones son reconocidas.
mkdir todo-fullstack && cd todo-fullstack && git init
claude
# dentro de Claude Code:
/init
El CLAUDE.md se lee en cada nueva conversación. Cada instrucción que pones en él es una inversión: evita repetir las mismas consignas, reduce los errores y orienta a Claude hacia las buenas decisiones arquitectónicas. Cinco minutos de inicialización valen horas de correcciones.
Puntos clave
• El CLAUDE.md es la palanca más potente del proyecto, guía cada interacción futura.
• /init da una base, pero el verdadero trabajo es el enriquecimiento manual con tus convenciones.
• Los settings definen lo que Claude puede hacer sin pedir permiso: es tu perímetro de seguridad.