CONFIRMADO: Claude Code 2.1.277 amplia instruções de projeto e endurece agentes

A Anthropic publicou o Claude Code 2.1.277 em 18 de setembro, no horário de Brasília, numa atualização que parece de manutenção, mas mexe em pontos centrais da operação. A versão passa a ler AGENTS.md quando o projeto não tem CLAUDE.md, adiciona controles para gateways atrás de proxy e corrige falhas que podiam travar sessões headless, plugins, retomadas e fluxos com agentes. Não há modelo novo aqui. O ganho é tornar o ambiente menos frágil quando a ferramenta vira infraestrutura.

Uma convenção de instruções mais aberta

O suporte a AGENTS.md reduz a dependência de uma convenção exclusiva do Claude Code. Em projetos sem CLAUDE.md, o arquivo passa a funcionar como fonte de instruções, com a configuração disponível em Project instructions dentro de /config. A ressalva importa: a própria release informa que esse comportamento ainda não está disponível em Bedrock, Vertex e Foundry. Para uma equipe pequena, isso facilita compartilhar regras de revisão, padrões de código e limites de ferramentas entre agentes, mas cada ambiente ainda precisa de teste próprio.

Gateway deixa de ser detalhe escondido

Dois recursos são particularmente úteis para operações que centralizam tráfego. A variável CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY informa que o proxy encaminhador é a fronteira de saída, fazendo cada requisição entregar o hostname ao proxy em vez de resolver o endereço localmente. A release também adiciona um mapa opcional de headers estáticos nos upstreams do gateway. Isso ajuda a integrar autenticação, roteamento e observabilidade sem colocar lógica específica dentro de cada projeto.

Correções que afetam a confiabilidade real

A lista de correções é extensa e mais importante que qualquer item chamativo. Sessões claude -p e do Agent SDK que podiam terminar sem resultado depois de um erro interno agora reportam a falha e saem com código 1. Também foram corrigidos problemas de retomada com blocos de texto vazios, logouts inesperados quando havia outra instalação antiga na máquina, travamentos por configuração malformada e buscas Grep ou Glob que escondiam falta de memória, processos ou descritores de arquivo.

Segurança e compatibilidade entram no pacote

Prompts com caracteres Unicode invisíveis passam por limpeza e revisão antes do envio. Resultados de subagentes chegam identificados como saída de subagente, reduzindo o risco de texto externo ser confundido com instrução da sessão principal. O TaskOutput foi removido, e a orientação passa a ser ler o arquivo de saída com Read. É uma mudança de compatibilidade que merece atenção em automações próprias.

O impacto para uma PME

Para uma pequena ou média empresa, vale atualizar em staging se o time usa Agent SDK, execução headless, gateways, plugins ou subagentes. O teste mínimo deve abrir um projeto com AGENTS.md, executar uma tarefa sem interação, retomar uma sessão e validar o caminho de proxy. Também é preciso procurar referências ao TaskOutput nos scripts. Ambientes simples, sem esses recursos, não ganham uma função que mude o produto de patamar.

Manutenção que vale mais que hype

Minha leitura é positiva, mas sem festa de marketing. Esta é uma release de confiabilidade: reduz falhas silenciosas, melhora a legibilidade das fronteiras entre agentes e infraestrutura e prepara o Claude Code para operações mais distribuídas. O contraponto é o tamanho da mudança. Atualização automática sem staging continua sendo uma má ideia. O registro da versão no npm confirma que o pacote 2.1.277 foi publicado no mesmo ciclo, enquanto o changelog oficial sustenta a classificação CONFIRMADO.

Fontes em PT

Release oficial da Anthropic no GitHub: https://github.com/anthropics/claude-code/releases/tag/v2.1.277 | Registro oficial da release: https://api.github.com/repos/anthropics/claude-code/releases/tags/v2.1.277 | Registro independente do pacote npm: https://registry.npmjs.org/@anthropic-ai%2fclaude-code