Claude Code 2.1.277 lee AGENTS.md como alternativa

Claude Code ya lee AGENTS.md, un archivo de instrucciones que comparten varios agentes de programación rivales, cuando un proyecto no tiene su propio CLAUDE.md. El cambio llegó el 18 de septiembre de 2026 en la versión 2.1.277. Un solo archivo puede informar ahora a más de una herramienta, lo que quita una tarea de mantenimiento pequeña pero real a cualquier repositorio que use dos.

El registro de cambios de Anthropic enuncia la regla en una línea: "in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under 'Project instructions'". La publicación en GitHub correspondiente salió ese mismo día a las 18:06 UTC.

Qué es AGENTS.md

AGENTS.md es un archivo Markdown sencillo que se guarda en un repositorio. Explica a un agente de programación cómo funciona el proyecto, igual que una guía de contribución se lo explica a una nueva compañera.

El sitio de AGENTS.md llama al formato "a README for agents: a dedicated, predictable place to provide the context and instructions to help AI coding agents work on your project". Describe el contenido como "build steps, tests, and conventions that might clutter a README or aren't relevant to human contributors".

El formato no es propio de Anthropic. Surgió de un trabajo en el que participaron OpenAI Codex, Amp, Jules de Google, Cursor y Factory. Ahora lo tutela la Agentic AI Foundation, dentro de la Linux Foundation. El proyecto afirma que más de 60.000 repositorios de código abierto en GitHub llevan el archivo.

Cómo se comporta la alternativa

El orden de búsqueda es toda la función, y es corto.

Elemento	Detalle
Versión	2.1.277
Publicada	18 de septiembre de 2026, 18:06 UTC
Regla	AGENTS.md solo se lee si el proyecto no tiene CLAUDE.md
Interruptor	"Project instructions" en /config
Todavía no disponible en	Bedrock, Vertex, Foundry

Nada cambia para un repositorio que ya tiene un CLAUDE.md. Ese archivo sigue ganando, y el nuevo comportamiento nunca fusiona los dos. Un proyecto usa uno o el otro.

La alternativa también se puede desactivar. El registro de Anthropic señala un interruptor bajo "Project instructions" en el menú /config.

Un límite merece atención antes de que alguien construya sobre esto. El registro dice que la compatibilidad con AGENTS.md no ha llegado a Bedrock, Vertex ni Foundry. Los equipos cuyos desarrolladores usan Claude Code a través de un proveedor de nube verán un comportamiento distinto al de sus compañeros que lo ejecutan directamente. Un informe de error posterior mostró que el respaldo también queda desactivado cuando la telemetría está apagada.

El resto de la versión

La versión 2.1.277 no trajo solo esta función. Las notas de Anthropic enumeran más de 50 correcciones repartidas entre el dibujado del terminal, las operaciones con archivos y los servidores MCP, las piezas de conexión que permiten a un agente alcanzar herramientas externas.

Dos correcciones destacan para quien las ha sufrido. Los avisos de permiso para órdenes de borrado peligrosas ahora nombran la orden señalada y proponen una protección ${VAR:?}. Así una variable sin definir falla, en lugar de borrar la ruta equivocada. Los servidores configurados como HTTP que aún usaban el transporte antiguo de HTTP y Server-Sent Events ya no fallan con respuestas 422 y otras 4xx.

Una segunda versión llegó el 19 de septiembre. La 2.1.278 cambió el modo automático para que use por defecto un clasificador en el servidor, para usuarios de la API de Claude y de Enterprise.

Qué significa esto para los desarrolladores

Compruebe primero qué archivo tiene realmente su repositorio. Si hay un CLAUDE.md, esta versión no cambia nada para usted, y un AGENTS.md colocado al lado seguirá sin leerse.

Para un proyecto que admite colaboradores con varios agentes, el paso práctico es claro. Conserve un AGENTS.md y borre el CLAUDE.md que solo lo duplica. Ahora es una configuración admitida y no un apaño. Mantenga un CLAUDE.md solo donde las instrucciones cambien de verdad según la herramienta.

Vigile la división dentro del equipo. Como los despliegues en la nube aún no tienen esto, un colaborador en Bedrock puede obtener un comportamiento distinto al de quien usa la herramienta de línea de órdenes, sin ningún error que explique la diferencia. Si sus instrucciones para el agente cuentan en el proceso de revisión, deje escrito en el repositorio qué archivo manda.

Hay un asunto más amplio sobre la rapidez con que cambia este comportamiento bajo sus pies. Claude Code empezó a escribir un enlace de sesión en los mensajes de commit salvo que se rechace, un valor por defecto que llegó a los repositorios antes de que muchos equipos lo notaran. La configuración guardada en el repositorio y revisada como código es la defensa ante ambas sorpresas.

Fije la versión si su flujo de trabajo depende del comportamiento anterior. Aquí las publicaciones llegan a diario, y un valor por defecto que cambia entre dos de ellas se asume mejor cuando todo el equipo comparte la misma compilación.

Continuación: Claude Code solo lee AGENTS.md con la telemetría activada.