Claude Code v2.1.277 adiciona suporte a AGENTS.md e corrige bugs de travamento

O Claude Code v2.1.277 chegou com um pequeno conjunto de novos recursos e uma longa lista de correções de bugs em sessões, ferramentas e tratamento de gateway. Veja o que realmente mudou.

Suporte a AGENTS.md

Em um projeto sem CLAUDE.md, o Claude Code agora lê AGENTS.md em vez disso. Você pode alternar isso em "Instruções do projeto" no /config. Ainda não disponível no Bedrock, Vertex ou Foundry.

Mudanças no gateway e proxy

• CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 para gateways de apps Claude cuja única saída é um proxy forward: toda requisição de saída entrega ao proxy o hostname em vez de resolvê-lo localmente.
• Mapa opcional headers: nos upstreams do gateway de apps Claude para enviar cabeçalhos estáticos a um proxy que você executa na frente de um provedor.
• Uma linha agora indica que a atualização de uma tarefa em segundo plano está aguardando quando ela termina enquanto um painel como /tasks está aberto.

Correções de sessão e CLI

• As sessões de claude -p e do Agent SDK que podiam travar sem resultado após um erro interno agora reportam o erro e saem com código 1.
• Conversas que falhavam a cada requisição com "blocos de conteúdo de texto devem ser não vazios" quando um turno anterior do assistente continha um bloco de texto vazio ao lado de outro conteúdo, inclusive após --resume.
• Logout inesperado quando uma versão mais antiga do Claude Code (por exemplo, o CLI embutido em uma extensão de IDE) roda na mesma máquina que a atual.
• Inicialização interativa travando ou dando erro para usuários de ANTHROPIC_API_KEY quando ~/.claude.json contém um valor malformado de customApiKeyResponses.
• Verificações de atualização dando erro a cada 30 minutos, e claude update travando quando uma versão mínima/máxima está definida, se um proxy retorna uma versão inválida. Um minimumVersion malformado agora é ignorado.
• claude update em instalações gerenciadas por winget ou apk reportando "atualizado" quando a consulta de versão falhou.
• claude plugin install às vezes falhando e quebrando a cópia instalada ao reinstalar uma versão de plugin em uso; uma cópia inalterada agora é deixada como está.

Correções de ferramentas (Grep, Glob, Write, Edit)

• Grep e Glob agora retornam erro quando a busca não pôde iniciar por falta de processos, memória ou descritores de arquivo, em vez de reportar nenhuma correspondência.
• Write não encerra mais silenciosamente o turno como permissão recusada quando o caminho de destino é um diretório existente.
• Edit não trata mais uma barra invertida escapada seguida de uXXXX como um escape \uXXXX, o que podia reescrever uma sequência de barra invertida escapada ao editar caracteres não ASCII.
• Edit reporta "String não encontrada no arquivo" em vez de "Expressão regular inválida: expressão regular muito grande" para edições não ASCII muito grandes que não correspondem.
• Turnos não terminam mais cedo com "O caminho contém bytes nulos" quando o caminho de arquivo de uma chamada de ferramenta contém \u0000 escrito como sequência de escape.

Correções de estabilidade

• Sessões em segundo plano (claude --bg) não saem mais quando o servidor LSP de um plugin sai ou fecha a entrada padrão.
• Crashes causados por claudeAiMcpEverConnected malformado, theme ou uma mensagem de assistente como string simples no histórico salvo.
• Crash ("erro de interface irrecuperável") quando o prompt continha códigos de cor do terminal.
• Sessões em máquinas lentas saindo quando o primeiro indicador de carregamento aparecia.
• Congelamento raro da tela após um erro interno de renderização.
• Turnos no Windows parando com "Sem memória" logo após uma resposta, deixando chamadas de ferramenta sem executar.
• Sessões continuadas após /clear (reiniciar, --continue, --resume) perdendo parte da primeira mensagem quando um hook SessionStart imprimia saída, causando uma perda total do cache de prompt.

Se você executa o Claude Code atrás de um proxy ou usa plugins com servidores LSP, vale a pena atualizar para esta versão.