¿Cuántos tokens gastan CLAUDE.md y AGENTS.md y qué longitud deben tener?
No hay una cifra fija: el archivo cuesta lo que cuesta su longitud, y viaja en cada mensaje de la sesión. Anthropic propone mantener cada CLAUDE.md por debajo de 200 líneas. Codex deja de añadir archivos AGENTS.md cuando suman 32 KiB. Quédate con las reglas que necesitas siempre y saca el resto.
Codex
AGENTS.md se lee una vez al arrancar y se queda en la sesión desde entonces. El límite conjunto es de 32 KiB por defecto, y OpenAI dice que lo mantengas pequeño.
Al arrancar, Codex lee ~/.codex/AGENTS.md y después baja desde la raíz del proyecto hasta tu directorio actual, tomando como mucho un archivo por nivel y uniéndolos en un solo bloque del prompt. Cuando el bloque llega a 32 KiB (el ajuste project_doc_max_bytes), Codex deja de añadir archivos, así que lo que venga después no se lee nunca. En un proyecto grande, anida los archivos: deja unas pocas reglas de todo el proyecto en la raíz y pon las reglas de cada módulo en un AGENTS.md dentro de ese módulo, donde solo se cargan cuando arrancas Codex desde ahí.
Qué dice la documentación oficial
Reduce the size of your AGENTS.md. If you work on a larger project, you can control how much context you inject through AGENTS.md files by nesting them within your repository.Codex builds an instruction chain when it starts (once per run; in the TUI this usually means once per launched session).Codex skips empty files and stops adding files once the combined size reaches the limit defined by project_doc_max_bytes (32 KiB by default).Codex concatenates files from the root down, joining them with blank lines. Files closer to your current directory override earlier guidance because they appear later in the combined prompt.Claude
CLAUDE.md se carga entero al principio de cada sesión. Anthropic propone menos de 200 líneas por archivo; /context muestra cuánto ocupa el tuyo.
Al arrancar, Claude Code lee ~/.claude/CLAUDE.md, el CLAUDE.md del proyecto (o .claude/CLAUDE.md), CLAUDE.local.md y los mismos archivos de los directorios superiores. Los archivos de subdirectorios solo se cargan cuando Claude lee un archivo de ahí. Claude Code envía la conversación completa con cada petición, así que este contenido vuelve a contar en cada mensaje. Anthropic lo dice sin rodeos: los archivos más largos consumen más contexto y reducen el grado en que Claude los sigue.
Qué dice la documentación oficial
CLAUDE.md files are loaded into the context window at the start of every session, consuming tokens alongside your conversation.Size: target under 200 lines per CLAUDE.md file. Longer files consume more context and reduce adherence.Claude Code sends your full conversation with every requestAdónde llevar lo que saques de CLAUDE.md
Claude Code tiene dos formas de cargar instrucciones solo cuando hacen falta. Todo lo demás, incluidas las importaciones con @, se carga al arrancar.
Instrucciones largas de un solo flujo de trabajo, como publicar versiones, revisar código o migrar bases de datos: pásalas a una skill. Una skill solo se carga cuando se usa.
Reglas que solo valen para ciertos archivos: ponlas en .claude/rules/ y empieza el archivo con un bloque paths:. Se cargan cuando Claude lee un archivo que coincide.
Notas pensadas para personas: enciérralas en un comentario HTML. Claude Code elimina los comentarios de bloque antes de que el archivo entre en el contexto.
Qué dice la documentación oficial
If it contains detailed instructions for specific workflows (like PR reviews or database migrations), those tokens are present even when you're doing unrelated work. Skills load on-demand only when invoked, so moving specialized instructions into skills keeps your base context smaller. Aim to keep CLAUDE.md under 200 lines by including only essentials.Splitting into @path imports helps organization but doesn't reduce context, since imported files load at launch.Block-level HTML comments (<!-- maintainer notes -->) in CLAUDE.md files are stripped before the content is injected into Claude's context. Use them to leave notes for human maintainers without spending context tokens on them.Errores frecuentes
- Cuanto más detalle tenga CLAUDE.md, mejor lo sigue Claude
No. Anthropic dice lo contrario: los archivos más largos consumen más contexto y se siguen peor, y cuanto más concretas y concisas son las instrucciones, con más constancia las sigue Claude. La longitud de más es un coste fijo que pagas en cada mensaje.
- Dividir CLAUDE.md en importaciones con @ ahorra tokens
No ahorra. Los archivos importados también se cargan al arrancar; las importaciones solo te ayudan a organizarte. Lo que sí ahorra tokens es cargar bajo demanda: las reglas con un bloque paths: y las skills.
- Claude ignora todo lo que pasa de la línea 200 de CLAUDE.md
No. 200 líneas es un objetivo, no un corte: Claude Code carga el archivo entero salvo que pase de 4 MiB, y cada línea de más cuesta tokens. La regla de las primeras 200 líneas o 25 KB es de MEMORY.md, el archivo de memoria automática. La herramienta que sí corta es Codex, que deja de añadir archivos AGENTS.md cuando suman 32 KiB.
Consejos
- Claude Code: escribe /context para ver cuánto ocupan los Memory files y qué archivos se han cargado.
- Claude Code: escribe /memory para abrir esos archivos y recortarlos. Los cambios se aplican desde la sesión siguiente; después de /compact, Claude Code vuelve a leer del disco el CLAUDE.md de la raíz del proyecto.
- Repasa el archivo línea a línea. Si una regla no hace falta siempre, bórrala o sácala. Conserva los comandos de compilación, las convenciones, la estructura del proyecto y las reglas de «haz siempre esto».
- Codex: deja las reglas de todo el proyecto en el AGENTS.md de la raíz y pon las reglas de cada módulo en un AGENTS.md dentro de ese módulo.
- Codex: ejecuta codex --ask-for-approval never "Summarize the current instructions." para confirmar que lo que se ha leído es lo que querías.
- Si usas las dos herramientas: mantén un solo AGENTS.md. Las versiones recientes de Claude Code lo leen directamente cuando el proyecto no tiene CLAUDE.md; si además tienes un CLAUDE.md, ponle una sola línea, @AGENTS.md. El contenido importado sigue costando tokens, así que mantén AGENTS.md corto.
Anuncios de reinicio de Codex · Anuncios de reinicio de Claude