--- title: "Usa AGENTS.md en Claude Code y Codex" description: "Codex lee AGENTS.md por defecto. Claude Code 2.1.277 o posterior lo lee cuando tu proyecto no tiene CLAUDE.md. Para mantener los dos, pon @AGENTS.md en tu CLAUDE.md." canonical: "https://logbrew.co/es/guides/agents-md" last_updated: "2026-11-10" --- # Usa AGENTS.md en Claude Code y Codex Codex lee `AGENTS.md` por defecto. Claude Code 2.1.277 o posterior lo lee cuando tu proyecto no tiene `CLAUDE.md`. Para mantener los dos, pon `@AGENTS.md` en tu `CLAUDE.md`. Probado el 10 de noviembre de 2026 con Claude Code 2.1.319 y Codex CLI 0.167.0 Por [Furkan Erday](https://github.com/furkanerday). Furkan Erday es el fundador de LogBrew. Desarrolla LogBrew con Claude Code y Codex todos los días. Canonical: https://logbrew.co/es/guides/agents-md ## Cuándo carga cada agente `AGENTS.md` | Tu proyecto tiene | Claude Code | Codex | | --- | --- | --- | | Solo `AGENTS.md` | Cargado | Cargado | | `AGENTS.md` y `CLAUDE.md` | Omitido | Cargado | | Un `CLAUDE.md` que importa `@AGENTS.md` | Cargado | Cargado | | Un `CLAUDE.md` como enlace simbólico a `AGENTS.md` | Cargado | Cargado | | `AGENTS.md` y `CLAUDE.local.md` | Omitido | Cargado | Leímos las instrucciones que cada agente envió con su primera solicitud. ## Configura 1 archivo para los dos agentes ### Escribe AGENTS.md en la raíz del proyecto Pon tus comandos de build, tus comandos de test y tus reglas de código en 1 archivo. Los dos agentes lo leen desde la raíz de tu repositorio Git hasta tu carpeta actual. ### Actualiza Claude Code Claude Code lee `AGENTS.md` por sí mismo desde la versión 2.1.277. Las versiones anteriores necesitan la importación del paso siguiente. ```bash claude update ``` ### Importa AGENTS.md desde tu CLAUDE.md Si hay un `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md` en tu carpeta o más arriba, Claude Code deja de leer `AGENTS.md`. Añade esta línea a tu `CLAUDE.md` para cargar los dos. ```bash @AGENTS.md ``` ### O enlaza CLAUDE.md a AGENTS.md Si tu `CLAUDE.md` solo tendría la importación, conviértelo en un enlace simbólico. ```bash ln -s AGENTS.md CLAUDE.md ``` ### O carga los dos con una opción de configuración Para mantener un `CLAUDE.local.md` y cargar igualmente `AGENTS.md`, añade esto a `~/.claude/settings.json`. En una sesión, la opción de instrucciones del proyecto en `/config` define el mismo valor. ```bash { "pluginConfigs": { "cc-plugin-agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` ### Comprueba qué cargó Codex Ejecuta esto desde la carpeta en la que trabajas. La documentación de Codex da este comando para que Codex repita las instrucciones que cargó. ```bash codex --ask-for-approval never "Summarize the current instructions." ``` ## Lo que vimos al probarlo Apuntamos los dos agentes a un servidor de prueba local y leímos las instrucciones que cada uno envió con su primera solicitud. Así se ve exactamente qué archivos carga cada agente. Claude Code cargó `AGENTS.md` cuando el proyecto no tenía `CLAUDE.md`, y su log de depuración decía `no CLAUDE.md found; AGENTS.md loaded`. Con un `CLAUDE.md` al lado, Claude Code dejó fuera `AGENTS.md`. Con la importación `@AGENTS.md` o con el enlace simbólico, el texto de `AGENTS.md` apareció exactamente una vez. La opción `pluginConfigs` de arriba cargó los dos archivos, también con un `CLAUDE.local.md` en el proyecto. Codex cargó primero `~/.codex/AGENTS.md`, luego el `AGENTS.md` de la raíz y luego el archivo de la carpeta actual. Un `AGENTS.override.md` sustituyó al `AGENTS.md` de su carpeta. Codex ignoró un `CLAUDE.md` hasta que lo añadimos a `project_doc_fallback_filenames`. Cuando existían los dos archivos, Codex cargó solo `AGENTS.md`, incluso con el respaldo definido. ## AGENTS.md vs CLAUDE.md Codex lee `AGENTS.override.md` o `AGENTS.md` en cada carpeta, además del `~/.codex/AGENTS.md` global, hasta 32 KiB en total por defecto. Solo lee `CLAUDE.md` si lo incluyes en `project_doc_fallback_filenames`. Claude Code lee primero `CLAUDE.md`. Solo lee `AGENTS.md` y `.claude/AGENTS.md` cuando no se aplica ningún `CLAUDE.md` de proyecto. Tu `~/.claude/CLAUDE.md` personal no cuenta, así que se carga junto a `AGENTS.md`. ## Qué dicen los reportes de GitHub #6235, con 409 comentarios, pedía que Claude Code admitiera AGENTS.md. El 17 de agosto de 2026, un ingeniero de Anthropic lo cerró con la importación y el enlace simbólico de arriba. Ahora Claude Code lee el archivo por sí mismo. #31005 pide además soporte para `.agents/skills/` y sigue abierto. ## Preguntas frecuentes ### ¿Claude Code lee AGENTS.md? Sí, desde la versión 2.1.277, cuando no hay ningún `CLAUDE.md`, `.claude/CLAUDE.md` ni `CLAUDE.local.md` en tu carpeta o más arriba. Lo confirmamos en la 2.1.319. ### ¿Uso AGENTS.md o CLAUDE.md? Usa `AGENTS.md` si alguien de tu equipo usa Codex u otro agente. Mantén un `CLAUDE.md` solo para reglas exclusivas de Claude Code e importa `@AGENTS.md` desde él. ### ¿Puedo hacer un enlace simbólico de CLAUDE.md a AGENTS.md? Sí. En nuestra prueba, Claude Code cargó el archivo enlazado una vez, igual que con la importación. ### ¿Codex lee CLAUDE.md? No por defecto. Añade `project_doc_fallback_filenames = ["CLAUDE.md"]` a `~/.codex/config.toml`. ## Dale a tu agente tus errores de producción Conecta el servidor MCP de LogBrew y Claude Code o Codex leerá los errores, logs y trazas de los proyectos que apruebes. Empieza con el generoso plan gratuito, sin tarjeta. [Conectar tu agente](https://logbrew.co/es/agents) ## Fuentes - [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md) - [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md) - [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235) - [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005) ## Más guías para agentes de programación con IA - [Añade un servidor MCP a Claude Code y Codex](https://logbrew.co/es/guides/mcp-server-claude-code-codex) - [Soluciona el error 529 overloaded y el error 429 de rate limit en Claude](https://logbrew.co/es/guides/claude-overloaded-rate-limit-error) - [Cómo solucionar errores en Claude Code, Codex y JavaScript del navegador](https://logbrew.co/es/guides)