Si tu equipo trabaja con más de un agente de programación, ya tienes un archivo menos que mantener. Claude Code lee AGENTS.md, el archivo de instrucciones que usan Codex de OpenAI y muchas otras herramientas, siempre que el proyecto no tenga un CLAUDE.md, según Anthropic.
El cambio llegó con la versión 2.1.277 el 18 de septiembre. Dicho en corto: un repositorio preparado para Codex ya funciona en Claude Code sin que nadie tenga que reescribir las normas de la casa.
Qué ha cambiado Anthropic
Claude Code siempre ha buscado un archivo CLAUDE.md para aprender cómo funciona un proyecto: cómo se compila, cómo se lanzan las pruebas y qué estilo seguir. Si ese archivo no está, ahora tira de AGENTS.md.
La comprobación va carpeta a carpeta. Como explicó Thariq, de Anthropic, al anunciar el cambio en X: si en una carpeta no hay CLAUDE.md, Claude busca AGENTS.md y lo usa. Eso importa en los repositorios que reparten instrucciones entre varios directorios.
Si hay los dos archivos, manda CLAUDE.md. Y el cambio se puede desactivar en el apartado de instrucciones del proyecto, dentro de la configuración de Claude Code, algo útil para los equipos que quieren instrucciones distintas para cada herramienta.
Qué es exactamente AGENTS.md
Es un archivo de texto en Markdown con un nombre fijo. Nació del trabajo del equipo de Codex de OpenAI, Jules de Google, Cursor, Amp y Factory, y hoy lo custodia la Agentic AI Foundation, dentro de la Linux Foundation, según el propio proyecto.
Dentro va lo que necesitaría alguien nuevo en el equipo el primer día: comandos para compilar y probar, guía de estilo, instrucciones de pruebas y consideraciones de seguridad. No exige ninguna estructura más allá de ser Markdown normal, y en parte por eso lo ha adoptado tanta gente.
Lo usan ya más de 60.000 proyectos de código abierto y lo leen Codex, Cursor, Gemini CLI, el agente de programación de GitHub Copilot, Devin, Windsurf o Junie de JetBrains, entre otros. En esa lista faltaba un nombre evidente, y era Claude Code.
Por qué ahora es más fácil cambiar
Hasta ahora, quien probaba las dos herramientas mantenía dos copias de las mismas instrucciones, o un archivo que apuntaba al otro, y tenerlas al día era una tarea más. Con un solo archivo hay una sola fuente de verdad, abra el desarrollador el agente que abra esa mañana.
Para un equipo que hoy trabaja con Codex, el paso es corto: abre el repositorio en Claude Code y leerá el AGENTS.md que ya existe. Si más adelante quieres instrucciones que solo vea Claude, añade un CLAUDE.md al lado; Claude usará ese y Codex seguirá leyendo el suyo.
También abarata compararlas bien: basta con abrir el mismo repositorio en las dos. Nuestra guía de Claude Code frente a Codex explica en qué fijarse, y si Cursor también está en la mesa, tienes la de Cursor contra Claude Code.
Qué significa para las empresas españolas
Ojo con un detalle: el cambio todavía no funciona si usas Claude a través de Amazon Bedrock, Google Vertex o Microsoft Foundry. Y esas plataformas son justo la vía que eligen muchas empresas para tener los datos en regiones europeas y cumplir con el RGPD.
Si tu equipo entra por ahí, de momento mantén el CLAUDE.md. Para el resto, es buen momento para ordenar esos archivos, porque marcan las reglas que sigue un agente dentro de tu código. Decidirlas con cabeza es parte de cualquier consultoría de IA sobre agentes de programación.
Un cambio pequeño que apunta lejos
Los agentes de programación van hacia normas comunes, y eso es buena noticia para quien compra. Cuanto menos cueste llevar un proyecto de una herramienta a otra, más tendrá que competir cada fabricante por calidad y menos por tenerte atado.
