Claude Code ahora lee AGENTS.md cuando no hay CLAUDE.md

El archivo donde le explico a un agente cómo funciona mi proyecto dejó de ser propiedad de una sola herramienta.

El 18 de septiembre de 2026, la versión 2.1.277 de Claude Code sumó esto: en un proyecto sin CLAUDE.md, ahora lee AGENTS.md en su lugar.

El changelog lo describe así:

“Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under ‘Project instructions’ in /config”

En criollo: si tu proyecto no tiene un CLAUDE.md, Claude Code va a buscar y leer un AGENTS.md como fuente de instrucciones del proyecto. Se puede cambiar cuál usa desde “Project instructions” en /config. Todavía no está disponible en Bedrock, Vertex ni Foundry.

Un formato que no le pertenece a nadie

Claude Code no inventó AGENTS.md. El formato tiene un sitio propio, agents.md, que lo describe como “a simple, open format for guiding coding agents” y dice que ya lo usan más de 60.000 proyectos open source.

La lógica del formato es simple: un README.md está escrito para personas — instalación, descripción, cómo contribuir. AGENTS.md está escrito para el agente — comandos de build, cómo correr los tests, convenciones de código. Información que un humano no necesita leer cada vez, pero que un agente sí.

Según ese mismo sitio, ya lo soportan, entre otras, estas herramientas:

  • Codex, de OpenAI
  • Jules y Gemini CLI, de Google
  • Cursor
  • GitHub Copilot (coding agent)
  • Amp
  • Windsurf, de Cognition
  • Aider, Zed, Warp, VS Code

Es una lista larga y de proveedores que compiten entre sí. Ninguno la impone: todos la leen.

Lo que cambia si el archivo deja de ser tuyo-de-una-herramienta

Hasta ahora, el archivo de contexto de un proyecto tenía nombre distinto según qué herramienta usaras. Escribirlo bien era, sin quererlo, apostar a seguir usando esa herramienta — porque migrar significaba reescribirlo, o mantener dos versiones en paralelo.

Si varias herramientas leen el mismo archivo, esa apuesta cambia de forma. No importa tanto cuál elijas hoy: importa que lo que le explicás a una, lo entiende la próxima.

Por qué lo uso yo

A mí sí me sirve, y lo uso bastante. La mayoría de mis proyectos tiene subagentes con roles distintos, no uno solo genérico: unos ejecutan tareas, otros supervisan, otros ordenan.

Ese reparto de roles es justamente lo que un archivo de contexto tiene que dejar por escrito.

Lo que no sé todavía

No sé con qué otra herramienta, además de Claude Code, comparto hoy ese mismo AGENTS.md, ni si lo hago. Tampoco es el punto central: el cambio real es que la pregunta ahora tiene sentido. Antes, ni se planteaba.

Elegir qué agente uso ya no significa reescribir cómo le explico mi proyecto — significa elegir con cuál lo leo primero.

¿Ya tienen un AGENTS.md en sus proyectos, o cada herramienta que usan todavía se queda con el suyo?


Fuentes:

Comentarios