Claude Code v2.1.277

Resumo

O Claude Code v2.1.277 adiciona suporte a AGENTS.md, amplia a configuração de gateways e corrige falhas em sessões, plugins, ferramentas, sandbox e interfaces. A publicação também remove o TaskOutput, que estava obsoleto.

Novidades

• Claude Code v2.1.277 — Instruções de projeto: quando um projeto não possui CLAUDE.md, o Claude Code lê AGENTS.md. A opção ainda não está disponível em Bedrock, Vertex ou Foundry.
• Claude Code v2.1.277 — Gateways: CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 entrega o hostname ao proxy sem resolução local, e a configuração opcional headers: envia cabeçalhos estáticos aos upstreams.
• Claude Code v2.1.277 — VS Code: a visualização de agentes mostra shells e tarefas em execução, respostas ganham ação de cópia, e sessões arquivadas podem ser restauradas em conjunto.

Melhorias

• Claude Code v2.1.277 — Execução headless: a primeira interação de sessões SDK e claude -p deixa de aguardar a busca de CLAUDE.md por diretório.
• Claude Code v2.1.277 — Prompts: caracteres Unicode invisíveis de formatação são removidos, e o texto limpo aparece para revisão antes do envio.
• Claude Code v2.1.277 — Plugins: a tela de plugins identifica o plugin responsável por cada servidor MCP e orienta a atualização quando o marketplace oferece versão mais recente.

Correções

• Claude Code v2.1.277 — Sessões e retomada: execuções headless retornam erro e código 1 após falhas internas, históricos com conteúdo malformado deixam de interromper a retomada, e mensagens digitadas durante o processamento voltam a chegar ao modelo.
• Claude Code v2.1.277 — Plugins e skills: reinstalações preservam a cópia em uso, políticas de marketplace ignoram somente a entrada malformada, e nomes como constructor ou toString deixam de derrubar as telas de plugins e skills.
• Claude Code v2.1.277 — Ferramentas de arquivo: Grep e Glob informam falta de processos, memória ou descritores; Write identifica diretórios existentes; e Edit preserva sequências escapadas durante alterações com caracteres fora de ASCII.
• Claude Code v2.1.277 — Sandbox: uma exceção em sandbox.excludedCommands só alcança um comando Bash composto quando todas as partes correspondem ao padrão configurado.

Ponto de Atenção

• Claude Code v2.1.277 — TaskOutput removido: integrações que ainda chamam a ferramenta obsoleta precisam ler o arquivo de saída da tarefa em segundo plano. taskOutputMaxChars e TASK_MAX_OUTPUT_LENGTH deixam de produzir efeito.
• Claude Code v2.1.277 — Teste sugerido: abra um projeto que tenha apenas AGENTS.md, confirme o carregamento das instruções e execute uma sessão claude -p que produza erro controlado. Em instalações com gateway, valide o proxy e os cabeçalhos estáticos num ambiente de teste.

Notas da versão

• Claude Code v2.1.277 — Publicação oficial: release estável de 18/09/2026. Consulte as notas no GitHub.