Claude Code 2.1.296

Resumo

O Claude Code 2.1.296 corrige a aplicação de permissões em sessões sem interface interativa e recupera o login por gateway afetado pela 2.1.295. A publicação também amplia as configurações dos subagentes e ajusta a edição de arquivos que utilizam uma codificação diferente de UTF-8.

A recusa de uma ferramenta por um hook gerenciado recebe uma correção de encerramento do turno. Você precisa conferir esse resultado separadamente da inicialização de servidores MCP desativados, pois são verificações diferentes de autorização.

Novidades

• Claude Code 2.1.296 — Subagentes: autoCompactWindow configura uma janela menor para a compactação no frontmatter e nas definições de --agents. CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL define um modelo para os agentes de workflow, preservando as escolhas dos demais subagentes.
• Claude Code 2.1.296 — Gateway do Desktop: a chave code em managed.policies[] aplica as configurações do terminal à aba Code do Claude Desktop. Ao lado de desktop, ela ativa o modo de gateway do aplicativo.
• Claude Code 2.1.296 — Leitura de arquivos: a ferramenta Read aceita allow_large para ler um arquivo de texto acima do limite habitual numa chamada, quando a janela de contexto comporta seu conteúdo.
• Claude Code 2.1.296 — Novas tentativas: CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS permite aumentar a espera máxima entre tentativas após uma resposta 529 de sobrecarga.

Melhorias

• Claude Code 2.1.296 — Diagnóstico de hooks: --debug registra o comando, o plugin, o resultado e a duração dos hooks concluídos. Arquivos de agentes também recebem avisos sobre campos de frontmatter desconhecidos e possíveis erros de digitação.
• Claude Code 2.1.296 — Descrições MCP: o limite padrão das descrições de ferramentas enviadas inicialmente e das instruções dos servidores aumenta de 2.048 para 4.096 caracteres.
• Claude Code 2.1.296 — Interface e histórico: a alternância de visualização por ctrl+o reutiliza blocos de código com realce de sintaxe já calculado, reduzindo o processamento repetido em conversas extensas. A limpeza local evita regravar um histórico grande quando a redução seria inferior a 10%.
• Claude Code 2.1.296 — Custos exibidos: /cost, a linha de status, --max-budget-usd e os valores do SDK utilizam US$ 0,10 por milhão de tokens para leituras do cache do Sonnet 5.5, substituindo US$ 0,20 no cálculo dessas superfícies.

Correções

• Claude Code 2.1.296 — Recusa pelos hooks: hooks gerenciados PreToolUse com continue: false e hooks gerenciados do tipo prompt encerram o turno ao recusar a chamada nos casos corrigidos. Hooks PostToolUse aplicam updatedMCPToolOutput nas sessões anteriormente afetadas.
• Claude Code 2.1.296 — Servidores desativados: sessões sem interface interativa respeitam a desativação por pasta dos servidores em .mcp.json e dos servidores de plugins após trocar de diretório ou recarregar extensões.
• Claude Code 2.1.296 — Autenticação por gateway: o login gravado é reconhecido quando a configuração gerenciada usa forceLoginMethod: "gateway" sem forceLoginGatewayUrl, corrigindo a regressão da 2.1.295. A lista allowedProviders também aceita o acesso dos computadores com o gateway informado na configuração pessoal.
• Claude Code 2.1.296 — Segredos e arquivos: a ocultação de segredos em transcrições compartilhadas e logs inclui valores que seguem uma chave vazia, inclusive em JSON dentro de uma string de shell. Edit e NotebookEdit recusam arquivos com conteúdo inválido como UTF-8, evitando a substituição dos caracteres fora do conjunto ASCII nas codificações afetadas.
• Claude Code 2.1.296 — Permissões de comandos: comandos que atribuem e utilizam BASH_ARGV0 recebem a solicitação de aprovação corrigida. No Git Bash do Windows, a tentativa de remover uma pasta de perfil em /c/Users/ exige confirmação mesmo no modo de dispensa de permissões.
• Claude Code 2.1.296 — Continuidade das sessões: a publicação corrige prompts executados duas vezes durante a passagem para segundo plano e turnos concluídos executados novamente após reiniciar. Interromper hooks de envio conserva a verificação do prompt nos casos corrigidos.
• Claude Code 2.1.296 — Plugins e runners: servidores com capacidade acima de uma sessão corrigem falhas de comandos Git simultâneos no mesmo repositório. A sincronização de skills entre sessões deixa de repetir instalações indefinidamente. Arquivos de workflow com finais de linha CRLF são aceitos.
• Claude Code 2.1.296 — Windows e VS Code: a instalação de plugins do GitHub repete a clonagem por HTTPS quando falta uma chave SSH. Os servidores MCP por stdio recebem o fechamento da entrada antes do encerramento forçado após 300 ms. Links para arquivos com caminhos completos do Windows abrem o arquivo correspondente no editor.

Breaking changes

• Claude Code 2.1.296 — Edição fora de UTF-8: Edit e NotebookEdit recusam arquivos com bytes inválidos em UTF-8, incluindo arquivos afetados em Windows-1252, Shift-JIS e GBK. Fluxos que utilizavam essas ferramentas nesses arquivos precisam converter a codificação com conferência do conteúdo ou utilizar um editor compatível com a codificação original.
• Claude Code 2.1.296 — Passagem para segundo plano: um turno ou comando ! iniciado durante essa transição é interrompido. Automações que aguardavam sua conclusão fora da tela precisam conferir a interrupção e iniciar novamente o trabalho no destino pretendido.

Ponto de Atenção

O Claude in Chrome no VS Code solicita autorização para ações do navegador também nas sessões conectadas por @browser. Autorizar um site para a sessão evita novas perguntas para esse site. A configuração dos subagentes e a permissão do navegador exigem conferências próprias.

Teste sugerido: numa sessão de teste, configure um hook gerenciado para recusar uma ferramenta inofensiva e observe o encerramento do turno. Recarregue os plugins com um servidor MCP desativado para a pasta e confira que ele permanece inativo. Numa cópia descartável de um arquivo Windows-1252, confira a recusa de edição e a preservação dos bytes originais.

Notas da versão

O release oficial do Claude Code 2.1.296 é estável e foi publicado em 09/10/2026 às 19h28 UTC. As alterações de custo descritas nas notas pertencem aos cálculos apresentados pelas interfaces citadas.