Claude Code v2.1.277: soporte para AGENTS.md

Claude Code, la herramienta de línea de comandos de Anthropic para desarrollo asistido por IA, llega a la versión 2.1.277 con un cambio significativo en cómo gestiona las instrucciones de proyecto. A partir de ahora, en proyectos sin archivo CLAUDE.md presente, Claude Code lee automáticamente AGENTS.md en su lugar, permitiendo modificar estas instrucciones desde la interfaz bajo "Project instructions" en /config.

Esta funcionalidad aún no está disponible en las plataformas Bedrock, Vertex o Foundry, pero marca el primer paso hacia una mayor integración con el ecosistema de agentes de Anthropic.

Qué hay detrás

La introducción de AGENTS.md responde a la creciente importancia de los agentes en la estrategia de Claude. Mientras CLAUDE.md ha sido durante meses el mecanismo estándar para definir comportamientos y restricciones en proyectos locales, AGENTS.md es el formato que Anthropic utiliza en su plataforma de agentes en la nube. Esta convergencia sugiere que la compañía busca unificar la experiencia entre desarrollo local (Claude Code CLI) y remoto.

La actualización también incluye mejoras infraestructurales significativas: soporte para proxies de salida (CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY), headers estáticos en gateways, y manejo mejorado de errores en sesiones headless. Destaca especialmente la corrección de un problema crítico que afectaba a sesiones del SDK que se colgaban sin retornar errores; ahora reportan la causa y salen con código 1.

Entre los 50+ bugs corregidos figuran fallos graves: conversaciones que fallaban con "text content blocks must be non-empty", usuarios desconectados inesperadamente cuando múltiples versiones de Claude Code ejecutaban en la misma máquina, y crashes en /mcp y /plugin manage por valores malformados en ~/.claude.json. También se solucionó un comportamiento donde las herramientas Write y Edit no reportaban errores claramente cuando los archivos no existían o contenían caracteres escapados problemáticos.

Por qué te importa si trabajas con SAP

Para profesionales SAP que integran Claude Code en sus flujos de desarrollo—ya sea para optimizar ABAP, generar configuraciones S/4HANA o acelerar consultoría con Joule—este cambio es relevante en dos aspectos. Primero, si estás experimentando con agentes basados en Claude para automatizar tareas de datos o BTP, AGENTS.md es ahora el formato preferido para exportar esas configuraciones hacia entornos de producción. Segundo, la batería de correcciones en sesiones del SDK y manejo de errores hace que Claude Code sea más confiable en pipelines CI/CD donde SAP y herramientas externas convergen.

La mejora en prompt caching tras reinicios (--resume, --continue) es especialmente útil en consultas repetitivas sobre repositorios grandes con lógica SAP compleja, donde evitar caché misses reduce latencia.