✨︎ Resumen (TL;DR):
- Anthropic añadió en Claude Code 2.1.277 soporte para AGENTS.md como respaldo cuando no existe CLAUDE.md.
- OpenAI presentó el formato en agosto de 2025 y, para diciembre, más de 60,000 proyectos de código abierto ya lo usaban.
- La compatibilidad responde a una petición muy respaldada, pero las carpetas de skills siguen separadas entre herramientas.
Anthropic agregó soporte para AGENTS.md en Claude Code con la versión 2.1.277. Desde el viernes, la herramienta busca ese archivo cuando la carpeta no tiene un CLAUDE.md, y lo usa como respaldo por defecto. Así, quienes alternan entre Claude Code, Codex, Cursor o GitHub Copilot pueden compartir una base de instrucciones sin mantener dos archivos casi idénticos, aunque las carpetas de skills siguen separadas.
AGENTS.md es un archivo de instrucciones que un agente de programación lee al inicio de cada sesión para conocer los comandos de compilación, las reglas de pruebas, las convenciones de estilo y las herramientas que debe usar. CLAUDE.md cumple esa función dentro de Claude Code, pero hasta ahora era el único formato que la herramienta reconocía.
Con el cambio, Claude Code busca AGENTS.md en la misma carpeta cuando no encuentra un CLAUDE.md propio. En ese escenario lo trata como respaldo. El usuario puede ajustar el comportamiento con /config, que ofrece tres modos:
- Leer solo
CLAUDE.md. - Usar
AGENTS.mdcomo respaldo, opción activada por defecto. - Cargar los dos archivos.
CLAUDE.md conserva la prioridad y puede incluir instrucciones específicas de Claude que el archivo neutral no captura. Por eso, quien trabaja principalmente con Claude Code puede seguir prefiriendo el formato propio.
Anthropic incorporó este soporte como un “mod”, dentro del nuevo sistema con el que busca hacer Claude Code más personalizable.
Un formato neutral frente a CLAUDE.md
OpenAI presentó AGENTS.md en agosto de 2025 como un estándar neutral y después lo cedió a la Agentic AI Foundation, bajo la Linux Foundation. Para diciembre, más de 60,000 proyectos de código abierto ya lo usaban, según la propia OpenAI.
El formato también tenía soporte en Codex de OpenAI, Cursor, Gemini CLI, GitHub Copilot, Jules y VS Code. Claude Code, en cambio, solo leía CLAUDE.md, una diferencia que complicaba el trabajo de quienes repartían su código entre varias herramientas.
Una petición abierta desde agosto de 2025
La compatibilidad con AGENTS.md era la función más solicitada en el repositorio de Claude Code. La solicitud permanece abierta desde agosto de 2025 y había reunido miles de reacciones, aunque Anthropic había cerrado como “sin planes” las peticiones de soporte nativo, incluida una centrada en la lectura recursiva del archivo.
El reclamo ganó fuerza a finales de agosto. Tobi Lütke, director ejecutivo de Shopify, escribió en X que evaluaba prohibir Claude Code en la empresa hasta que leyera AGENTS.md y la carpeta .agents/skills.
Lütke calificó el trabajo de mantener dos archivos en paralelo como un “impuesto de complejidad” que no debería existir. En un monorepo con miles de desarrolladores, explicó, basta con que a una carpeta le falte uno de los dos archivos para que parte del equipo termine trabajando sin las instrucciones correctas.
Thariq Shihipar, ingeniero de Claude Code, le respondió que el equipo ya trabajaba en hacer la herramienta más personalizable, con soporte para AGENTS.md incluido. El anuncio llegó unas tres semanas más tarde.
El archivo se comparte, las skills no
Del lado de OpenAI, Thibault Sottiaux, responsable de producto central de OpenAI, celebró la decisión y dio la bienvenida al estándar. Shihipar respondió con un emoji de apretón de manos.
La recepción entre desarrolladores fue menos uniforme. En el foro r/ClaudeAI de Reddit, varios participantes describieron el cambio como un arreglo menor y tardío, más que como una novedad de peso. También recordaron que CLAUDE.md sigue siendo el archivo predeterminado.
El pedido original todavía tiene un pendiente: las carpetas de habilidades siguen separadas, .claude/skills por un lado y .agents/skills por otro. Los equipos todavía deben decidir qué instrucciones son comunes para todas las herramientas y cuáles pertenecen solo a Claude.
Para quien reparte su trabajo entre Claude Code, Codex, Cursor o Copilot, AGENTS.md ya puede servir como base común y reducir la fricción de configurar cada herramienta por separado. El avance queda acotado: CLAUDE.md mantiene la prioridad y las carpetas de skills continúan divididas. Claude Code acepta el archivo neutral, pero todavía no comparte todo el conjunto de instrucciones con las otras herramientas.
