Un proyecto de Claude Code bien configurado proporciona a Claude el contexto necesario para comprender tus objetivos, archivos y la estructura del proyecto. Sin este contexto, Claude podría generar resultados que no coincidan completamente con tu intención original.

Comienza ejecutando el comando /init en la terminal del proyecto. Claude revisará la base de código, identificará cómo funciona el proyecto y creará o actualizará el archivo CLAUDE.md. Este archivo contiene instrucciones importantes y contexto que Claude lee al trabajar en el proyecto.

También puedes crear carpetas a nivel de proyecto para:

• Agents, para asistentes de IA especializados;
• Skills, para instrucciones y flujos de trabajo reutilizables;
• Rules, para requisitos específicos del proyecto.

Mantener estos recursos dentro del proyecto hace que la configuración sea portátil. Cuando el repositorio se comparte a través de GitHub o se abre en otro dispositivo, las mismas instrucciones y flujos de trabajo permanecen disponibles.

El archivo .claude/settings.local.json almacena permisos locales, como qué herramientas puede usar Claude sin preguntar. Debido a que incluye .local en el nombre del archivo, normalmente se mantiene en tu dispositivo y no se comparte con el repositorio. Se puede usar un archivo compartido settings.json cuando los mismos permisos deben aplicarse a todos los que trabajan en el proyecto.

El archivo .mcp.json puede contener configuraciones del servidor MCP a nivel de proyecto. Esto es útil cuando un equipo necesita acceso a las mismas integraciones, aunque Claude a menudo puede configurar estas conexiones automáticamente.