Claude Code v2.1.277 añade soporte para AGENTS.md y corrige errores de bloqueo

Claude Code v2.1.277 llegó con un pequeño conjunto de nuevas funciones y una larga lista de correcciones de errores en sesiones, herramientas y manejo de gateway. Esto es lo que realmente cambió.

Soporte de AGENTS.md

En un proyecto sin CLAUDE.md, Claude Code ahora lee AGENTS.md en su lugar. Puedes cambiarlo en «Instrucciones del proyecto» dentro de /config. Aún no está disponible en Bedrock, Vertex ni Foundry.

Cambios en gateway y proxy

• CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 para gateways de aplicaciones Claude cuyo único egreso es un proxy de reenvío: cada solicitud saliente le entrega el nombre de host al proxy en lugar de resolverlo localmente.
• Mapa opcional headers: en los upstreams del gateway de aplicaciones Claude para enviar encabezados estáticos a un proxy que ejecutes delante de un proveedor.
• Ahora aparece una línea que indica que la actualización de una tarea en segundo plano está esperando cuando finaliza mientras un panel como /tasks está abierto.

Correcciones de sesión y CLI

• Las sesiones de claude -p y del SDK de Agente que podían colgarse sin resultado tras un error interno ahora informan el error y salen con código 1.
• Conversaciones que fallaban en cada solicitud con «text content blocks must be non-empty» cuando un turno anterior del asistente contenía un bloque de texto vacío junto a otro contenido, incluso después de --resume.
• Cierre de sesión inesperado cuando una compilación anterior de Claude Code (p. ej., la CLI incluida en una extensión de IDE) se ejecuta en la misma máquina que la actual.
• Inicio interactivo colgado o con error para usuarios de ANTHROPIC_API_KEY cuando ~/.claude.json contiene un valor customApiKeyResponses malformado.
• Comprobaciones de actualización con error cada 30 minutos, y claude update colgado cuando se establece una versión mínima/máxima, si un proxy devuelve 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 la búsqueda de versión fallaba.
• claude plugin install a veces fallaba y rompía la copia instalada al reinstalar una versión de plugin en uso; ahora se deja intacta una copia sin cambios.

Correcciones de herramientas (Grep, Glob, Write, Edit)

• Grep y Glob ahora devuelven un error cuando la búsqueda no pudo iniciarse por falta de procesos, memoria o descriptores de archivo, en lugar de informar que no hay coincidencias.
• Write ya no finaliza silenciosamente el turno como permiso denegado cuando la ruta de destino es un directorio existente.
• Edit ya no trata una barra invertida escapada seguida de uXXXX como una secuencia de escape \uXXXX, lo que podía reescribir una secuencia de barra invertida escapada al editar caracteres no ASCII.
• Edit informa «String not found in file» en lugar de «Invalid regular expression: regular expression too large» para ediciones no ASCII muy grandes que no coinciden.
• Los turnos ya no terminan antes de tiempo con «Path contains null bytes» cuando la ruta de archivo de una llamada de herramienta contiene \u0000 escrita como secuencia de escape.

Correcciones de estabilidad

• Las sesiones en segundo plano (claude --bg) ya no salen cuando el servidor LSP de un plugin sale o cierra stdin.
• Fallos por claudeAiMcpEverConnected o theme malformados, o por un mensaje del asistente como cadena simple en el historial guardado.
• Fallo («unrecoverable interface error») cuando el prompt contenía códigos de color de terminal.
• Sesiones en máquinas lentas que salían cuando aparecía el primer indicador de carga.
• Congelación rara de pantalla tras un error de renderizado interno.
• Turnos de Windows que se detenían con «Out of memory» justo después de una respuesta, dejando llamadas de herramienta sin ejecutar.
• Sesiones continuadas después de /clear (reinicio, --continue, --resume) que perdían parte del primer mensaje cuando un hook SessionStart imprimía salida, causando un fallo total de la caché de prompt.

Si ejecutas Claude Code detrás de un proxy o usas plugins con servidores LSP, vale la pena actualizar a esta versión.