CLAUDE.md es el archivo que determina cómo Claude entiende tu proyecto. Uno bien escrito significa menos correcciones, mejor código y agentes que realmente saben en qué están trabajando.
Esta guía recorre cada sección de un archivo CLAUDE.md, desde las declaraciones de stack técnico hasta las instrucciones específicas por agente. Sigue los pasos y construye el tuyo poco a poco.
CLAUDE.md es un archivo markdown que colocas en la raíz de tu proyecto. Cuando Claude Code inicia una sesión, lee este archivo primero. Todo lo que contiene pasa a formar parte del contexto de Claude: tu stack técnico, tu estructura de archivos, las convenciones de tu equipo y cualquier instrucción que quieras que siga cada agente.
Piensa en él como un documento de briefing. Sin él, Claude tiene que adivinar cómo está organizado tu proyecto. Con un buen CLAUDE.md, Claude ya sabe donde están las cosas, qué patrones seguir y qué evitar. La diferencia en la calidad de los resultados es notable.
“Invertir 10 minutos en CLAUDE.md ahorra horas de corregir código generado por IA que no coincide con los patrones de tu proyecto.”
Observado en cientos de proyectos Claude Code
La estructura y especificidad de tu CLAUDE.md impactan directamente en lo bien que Claude trabaja en tu codebase.
Un CLAUDE.md bien estructurado cubre estas seis áreas. Cada una le da a Claude información concreta sobre la que puede actuar de inmediato.
Lista tus frameworks, bibliotecas y sus versiones de forma explícita. Incluye tu gestor de paquetes, la versión de Node y cualquier requisito de ejecución. Claude usa esto para generar código compatible sin adivinar.
Describe tus directorios clave y qué contiene cada uno. Componentes, stores, servicios, rutas API, tipos. Un diagrama de árbol corto con una línea de descripción por carpeta funciona bien.
Documenta tus patrones de nombrado (camelCase para archivos, PascalCase para componentes), tu enfoque de manejo de errores, el orden de imports y cualquier regla específica del proyecto. Esto mantiene la salida de Claude consistente con tu código existente.
Incluye tus comandos de dev, build, test y lint. Cuando Claude necesite verificar que algo funciona o sugerir un script, usará exactamente los comandos que tu proyecto espera.
Si usas varios agentes (QA, frontend, backend, DevOps), agrega una sección describiendo en qué debe enfocarse cada rol. Esto es especialmente útil con la configuración multi-agente de AgentsRoom.
Dile a Claude lo que NO debe hacer. No modificar archivos de configuración, no tocar el sistema de autenticación, no refactorizar la capa de base de datos. Los límites explícitos evitan que los agentes hagan cambios no deseados.
No necesitas escribirlo todo de una vez. Empieza con lo básico y amplía a medida que descubres lo que Claude necesita saber.
Abre tu package.json y lista cada framework, biblioteca y herramienta que usa tu proyecto. Anota las versiones. Revisa tus requisitos de ejecución (versión de Node, versión de Python, base de datos). Esto se convierte en tu sección de stack técnico.
package.json + versiones runtime + base de datos
Ejecuta un tree rápido de tu directorio src. Identifica las carpetas de primer nivel y escribe una descripción de una línea para cada una. Enfócate en donde viven los componentes, stores, servicios, tipos y rutas API.
Árbol src/ con anotaciones de propósito
Mira tu código existente y anota los patrones: cómo nombras archivos, cómo manejas errores, cómo estructuras los imports, si usas exports por defecto o con nombre. Escríbelos como reglas cortas.
Nombrado, imports, manejo de errores, exports
Si trabajas con agentes especializados, agrega áreas de enfoque para cada rol. El agente frontend debe conocer tu biblioteca de componentes. El agente DevOps debe conocer tu pipeline de despliegue. El agente QA debe conocer tu framework de testing.
Áreas de enfoque + zonas a evitar por rol
AgentsRoom está construido alrededor de CLAUDE.md como concepto central, no como algo secundario.
Edita tu CLAUDE.md directamente dentro de AgentsRoom con resaltado de sintaxis y guardado en tiempo real. Sin cambiar a tu editor de texto o IDE.
Mira cómo cada agente interpreta tu CLAUDE.md en tiempo real. Observa la salida del terminal para verificar que los agentes siguen tus convenciones y respetan tus zonas a evitar.
Cada proyecto en AgentsRoom tiene su propio CLAUDE.md. Cambia entre proyectos y cada agente carga automáticamente el archivo de contexto correcto para esa codebase.
Los 14 roles de agentes de AgentsRoom se combinan directamente con las secciones de CLAUDE.md. Define áreas de enfoque y zonas a evitar por rol, y cada agente recoge exactamente las instrucciones destinadas a él.
CLAUDE.md is prepended to every Claude turn. A bloated CLAUDE.md silently inflates Claude Code token usage on every message. AgentsRoom puts a per-session token meter on each agent so you can see exactly how much your CLAUDE.md is costing you, with a live cache hit rate to confirm it stays cached.
See the Claude Code token usage trackerAGENTS.md es el archivo de instrucciones portable que tus agentes de código leen antes de tocar tu código. Qué poner en él, en qué se diferencia de CLAUDE.md, y cómo mantener un único contexto entre Codex, Antigravity y Claude.
El código ya no es el cuello de botella, la comunicación sí lo es. Aprende a hablar con tus agentes de IA Claude, Codex, Antigravity y Grok Build para entregar más rápido, con más precisión y gastando menos tokens.
Su plan de Claude no está denominado en tokens, así que ninguna pantalla muestra un saldo de tokens. Esto es lo que mide realmente, las dos pantallas que sí lo muestran, por qué se consume mientras usted no escribe nada, y qué le hace a su semana el cambio de la ventana semanal de septiembre de 2026.
Descarga AgentsRoom y usa el editor CLAUDE.md integrado para dar a tus agentes el contexto que necesitan. Mejores instrucciones, mejor código.
App complementaria: supervisa tus agentes en movimiento
Usa Claude, Codex, Antigravity CLI u otro proveedor de IA.
Envía bugs y peticiones directamente a tu backlog público.