Claude Code 2.1: soporte AGENTS.md y ajustes al gateway
Esta versión suma soporte para AGENTS.md, opciones nuevas para el gateway de Claude apps y corrige una lista larga de cuelgues, crashes y fallas de caché de prompt.
AGENTS.md como alternativa a CLAUDE.md
Si tu proyecto no tiene un CLAUDE.md, Claude Code ahora lee AGENTS.md en su lugar. Podés cambiar esto desde 'Project instructions' en /config. Todavía no está disponible en Bedrock, Vertex ni Foundry.
Más control sobre el gateway de Claude apps
Si tu gateway solo sale a internet mediante un forward proxy, la variable CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 hace que cada request outbound le pase el hostname al proxy en vez de resolverlo localmente. También podés definir un mapa headers: en los upstreams del gateway para mandar headers estáticos a un proxy que corras vos delante de un provider.
Menos cuelgues y crashes
Corrigieron varios casos donde claude -p o sesiones del Agent SDK quedaban colgadas sin resultado tras un error interno; ahora reportan el error y salen con código 1. También arreglaron crashes puntuales: al abrir /mcp o /plugin manage con un valor malformado en ~/.claude.json, al lanzar Claude Code con un theme corrupto, y al resumir una sesión cuyo historial guardó un mensaje del asistente como string plano. Si trabajás con sesiones largas o resumes seguidos, esto reduce fricción operativa.
Caché de prompt: varios misses corregidos
Se arreglaron escenarios que rompían el prompt cache: sesiones continuadas después de /clear que perdían parte del primer mensaje si un hook de SessionStart imprimía output, y adjuntos previos que se re-renderizaban después de un resume, perdiendo el extended thinking. También corrigieron que subagentes y teammates resumidos re-renderizaran las definiciones de tools MCP ya cargadas, lo cual rompía la caché para ese agente.
Separación de output de subagentes
Los resultados de un subagente ahora llegan al agente principal bajo un header que los marca explícitamente como output de subagente, con el resultado indentado. Esto evita que texto dentro de la respuesta de un subagente se cuele como si fueran instrucciones propias de la sesión.
Cambios en VS Code
La extensión suma un botón de Sign out en el menú del panel, un botón Copy response en las respuestas, y muestra shells en background y tareas corriendo en el mapa de agentes con opción de Stop. También corrigieron que /fast no guardara el modo rápido como default, y que el modo Auto faltara en el selector cuando el modelo guardado tenía un alias con distinto casing.
What you get
AGENTS.md ya funciona como reemplazo de CLAUDE.md, salvo en Bedrock, Vertex y Foundry.
El gateway de Claude apps ahora soporta egress exclusivo por proxy y headers estáticos por upstream.
Se corrigieron múltiples fuentes de prompt-cache miss, útil si notás costos o latencia inesperada en sesiones resumidas.
El output de subagentes ahora se distingue explícitamente del texto de la sesión principal, cerrando un vector de inyección de instrucciones.
Want a class on this?
If enough people ask for it, it goes on the schedule. No email, no name needed.