Claude Code lee AGENTS.md cuando no hay CLAUDE.md, y corrige más de 30 errores

Claude Code ha lanzado una nueva versión, y las notas se centran en correcciones más que en funciones. El titular es simple: la aplicación ahora lee AGENTS.md si no hay un archivo CLAUDE.md en un proyecto. Es una pequeña comodidad para los equipos que quieren estandarizar la configuración de su agente en múltiples herramientas.

El resto de las notas de la versión se lee como una lista de cosas que estaban rotas. Las sesiones se colgaban, los bloqueos afectaban valores específicos en los archivos de configuración y varios comandos no lograban completar tareas básicas.

Qué se rompió primero

Las notas de la actualización comienzan con una nueva función y rápidamente pasan a los problemas. Este es un resumen rápido de las principales correcciones:

• Las sesiones se colgaban y no devolvían resultado tras un error interno; ahora informan el error y salen con código 1
• Las conversaciones fallaban con «text content blocks must be non-empty» cuando un turno anterior del asistente incluía un bloque de texto vacío
• Los usuarios cerraban sesión inesperadamente cuando una compilación anterior de Claude Code se ejecutaba junto con la actual en la misma máquina
• Un valor malformado de customApiKeyResponses en ~/.claude.json hacía que el inicio interactivo se colgara o mostrara un error para los usuarios de ANTHROPIC_API_KEY
• Las comprobaciones de actualización daban error cada 30 minutos, y claude update se colgaba cuando un proxy devolvía una versión inválida; ahora se ignora un minimumVersion malformado
• claude update en instalaciones gestionadas por winget o apk informaba «up to date» cuando fallaba la búsqueda de la versión
• claude plugin install dañaba la copia instalada al reinstalar una versión de plugin en uso por otro programa; ahora se deja intacta una copia sin cambios

El patrón es consistente: un comando falla, aparece un mensaje de error y la siguiente versión ignora la entrada incorrecta en lugar de bloquearse. Es un enfoque sensato, aunque deja algunas dudas sobre cómo se suponía que los usuarios debían saber qué estaba mal antes.

Las correcciones que vale la pena notar

No todas las correcciones hicieron que las notas fueran fáciles de leer. Algunos de los cambios más pequeños son genuinamente útiles una vez que se entiende qué abordan.

• La bandera CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 indica a las aplicaciones de Claude que las puertas de enlace entreguen las solicitudes salientes a un proxy de reenvío en lugar de resolver los nombres de host por sí mismas
• Un mapa opcional headers: permite a los usuarios enviar encabezados estáticos a un proxy que se ejecuta frente a un proveedor
• Las tareas en segundo plano ahora indican que un panel como /tasks está esperando una actualización cuando finaliza
• Grep y Glob dejaron de reportar que no hay coincidencias cuando el sistema se quedó sin procesos, memoria o descriptores de archivos; ahora devuelven un error en su lugar
• La herramienta Write ya no termina un turno como un permiso rechazado cuando el destino es un directorio existente; en su lugar reporta un error claro
• Las barras invertidas escapadas seguidas de texto uXXXX se trataban como escapes \uXXXX en la herramienta Edit; ese comportamiento está corregido
• Un fallo («Type error») al abrir /mcp o /plugin manage con un valor claudeAiMcpEverConnected malformado en ~/.claude.json ya no ocurre

Estas son pequeñas victorias, pero son el tipo de pulido que hace que una aplicación se sienta lista para el uso diario.

El argumento a favor del alivio

Hay un argumento sólido de que estas notas de la versión son una señal de madurez. Un producto que documenta cada fallo, le asigna un código y publica una corrección es uno que sabe lo que hace. Las notas se leen como una empresa que hace seguimiento de su propio progreso.

La versión también incluye correcciones para el control remoto, el sandboxing y las políticas del marketplace. Esos son temas de nivel empresarial, y abordarlos en un solo parche demuestra atención a una base de usuarios más amplia que solo el público de desarrolladores principales.

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

Esa línea es el titular, y es la única función que realmente agrega un comportamiento nuevo en lugar de reparar daños antiguos. Es una adición pequeña pero sensata para equipos que quieren un único formato de configuración en múltiples herramientas.

Las correcciones restantes son principalmente sobre estabilidad y manejo de errores. No agregan nuevos comandos ni funciones, pero eliminan fricción del uso cotidiano.

Lo que permanece incierto

Las notas de la versión no dicen a qué plataformas aplican estas correcciones. La nota sobre el soporte de AGENTS.md excluye específicamente a Bedrock, Vertex y Foundry, lo que sugiere que esas plataformas no están cubiertas por esta versión. Es una brecha razonable, pero deja a los usuarios de esas plataformas preguntándose si sus problemas están siendo rastreados siquiera.

Los problemas de verificación de actualizaciones e instalación de plugins también plantean una pregunta sobre cómo Claude Code gestiona las dependencias entre gestores de paquetes. Las notas describen comportamientos específicos en winget y apk, lo que implica que otros sistemas pueden necesitar un tratamiento por separado. No se indica si eso es un caso aislado o un problema recurrente.

La conclusión

Esta versión es un alivio. Las notas de corrección documentan a un equipo que ha pasado tiempo persiguiendo problemas, y el hecho de que tantos problemas se documentaran después sugiere un producto que está mejorando en comprender sus propios límites.

El soporte de AGENTS.md es un buen detalle, pero es la parte silenciosa de la versión. La verdadera historia es la enorme cantidad de cosas que estaban rotas y ahora están corregidas. Para cualquiera que haya sufrido un cierre inesperado o un comando colgado en las últimas semanas, vale la pena instalar esta actualización.

Vale la pena leer las notas de la versión completas, incluso si no eres desarrollador. Pintan el panorama de un producto que sigue mejorando.

Material de origen: “Claude Code now reads AGENTS.md if there is no Claude.md”, claude.com.