Claude Code 2.1.307

Resumo

O Claude Code 2.1.307 corrige chamadas MCP duplicadas após uma queda de conexão e preserva configurações de sessões em nuvem após reiniciar. A versão também acrescenta um evento de telemetria para acompanhar intervenções nas chamadas de ferramentas. Nos runners próprios, o hook de checkout recebe um limite padrão de trinta minutos, que exige ajuste nas preparações mais demoradas.

Novidades

• Claude Code 2.1.307 — Claude API: /claude-api api-version auxilia a atualização do código para a versão 2026-10-21 da API.
• Claude Code 2.1.307 — Telemetria: o evento OpenTelemetry claude_code.safety_event registra intervenções nas chamadas de ferramentas. As intervenções podem vir das permissões ou do modo automático, assim como das verificações de segurança, dos hooks e da sandbox.
• Claude Code 2.1.307 — Code Review: @claude review stop, com as alternativas off e pause, encerra a assinatura de @claude review always numa pull request sem iniciar outra revisão.
• Claude Code 2.1.307 — Ditado no VS Code: o botão do microfone informa quando a gravação termina por quinze segundos sem fala reconhecida ou pelo limite de dois minutos. O aviso confirma a preservação do texto já reconhecido.

Melhorias

• Claude Code 2.1.307 — Recuperação de chamadas: quando não consegue interpretar uma chamada de ferramenta, o Claude Code tenta novamente até duas vezes antes de encerrar o turno com erro.
• Claude Code 2.1.307 — Subagentes: cada fork iniciado junto de outros recebe a identificação de seu próprio lançamento. Isso reduz a possibilidade de um subagente iniciar o trabalho destinado a outro.
• Claude Code 2.1.307 — Conexão: o Remote Control reduz a espera para conectar sessões com imagens coladas ou leituras extensas de PDF no histórico. Nas sessões em nuvem, a primeira resposta também recebe ajustes quando um servidor MCP do Desktop não conecta.
• Claude Code 2.1.307 — Pesquisa na web: uma resposta 403 com justificativa exibe esse motivo nas sessões em nuvem e nos runners próprios. O aviso sobre o fim do orçamento de WebSearch também orienta o agente a não consultar buscadores pelo navegador ou pelo uso do computador.

Correções

• Claude Code 2.1.307 — Repetição de chamadas MCP: após o encerramento da conexão HTTP durante uma chamada, somente ferramentas de leitura ou idempotentes recebem nova tentativa. A correção evita repetir indiscriminadamente ações de escrita do servidor MCP.
• Claude Code 2.1.307 — Conexões MCP: no macOS, claude -p informa quando o chaveiro de login está travado e conecta na execução seguinte após sua liberação, sem novo login. No macOS e no Linux, a suspensão do computador durante a conexão não mantém o servidor indevidamente em estado de falha.
• Claude Code 2.1.307 — Catálogo de ferramentas: o início do turno recebe as ferramentas atualizadas do servidor MCP do SDK mesmo com uma tarefa em segundo plano. A aba Code do Desktop também corrige os formulários das ferramentas de escrita de um servidor GitHub MCP configurado diretamente.
• Claude Code 2.1.307 — Modelos: a combinação de CLAUDE_CODE_DISABLE_1M_CONTEXT com aliases como opus[1m] não provoca o erro de modelo inexistente. A troca de modelo por setModel() no Agent SDK aguarda até quinze segundos pela confirmação da API, em vez de cinco.
• Claude Code 2.1.307 — Sessões: /autocompact preserva a janela configurada após reiniciar uma sessão em nuvem. Conversas apagadas por /clear não reaparecem ao reiniciar sessões em nuvem ou em runners próprios. Leituras extensas de imagens e PDFs também recebem correções de compactação.
• Claude Code 2.1.307 — Gateways: o cabeçalho beta prompt-caching-scope não é enviado aos gateways configurados por ANTHROPIC_BASE_URL nem ao Foundry, onde não tem efeito. As sessões do gateway de aplicativos respeitam CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS e corrigem a telemetria com OTEL_EXPORTER_OTLP_HEADERS.
• Claude Code 2.1.307 — Permissões: a lista Recently denied de /permissions identifica o comando de shell recusado. O classificador local do modo automático considera a aprovação nessa lista quando verifica uma nova tentativa do comando.
• Claude Code 2.1.307 — Runner próprio: sessões com --use-anthropic-git-proxy evitam incluir num commit o .claude/settings.local.json deixado por uma sessão anterior. Encerrar ou recolocar a sessão na fila durante o hook de checkout também encerra seus processos e libera a vaga do runner.
• Claude Code 2.1.307 — VS Code: um prompt expandido ocupa no máximo 40% do painel e permite rolagem. O ditado funciona atrás de um proxy com inspeção TLS quando NODE_EXTRA_CA_CERTS está apenas nas configurações do usuário e também respeita CLAUDE_CODE_CERT_STORE.

Breaking changes

• Claude Code 2.1.307 — Tempo do checkout: hooks de checkout dos runners próprios terminam após trinta minutos por padrão, com falha na preparação da sessão. Instalações cujo hook precise de mais tempo devem elevar --checkout-hook-timeout-min ou usar 0 para desativar esse limite.
• Claude Code 2.1.307 — Leitor de tela: axScreenReader e CLAUDE_AX_SCREEN_READER num bloco env só se aplicam quando definidos nas configurações do usuário, nas gerenciadas ou por --settings. Configurações de outro escopo precisam migrar para um desses locais. As notas situam essa restrição desde a 2.1.305.

Ponto de Atenção

Confira a duração do hook de checkout ao atualizar um runner próprio. O encerramento por tempo pode interromper uma preparação que anteriormente terminava sem esse limite. A filtragem dos certificados do Git gerenciado pela Anthropic também acompanha a CLI, com uma linha [runner:warn] indicando quantos certificados ficaram de fora. A extensão do VS Code e o ditado adotam a mesma filtragem.

Teste sugerido: execute o checkout de uma sessão de homologação e compare sua duração com o limite configurado. Num servidor MCP de teste, interrompa a conexão durante uma chamada de escrita e confira se ela foi executada apenas uma vez. Reinicie uma sessão após usar /clear e verifique se a conversa apagada permanece ausente.

Notas da versão

O release oficial do Claude Code 2.1.307 foi publicado em 21/10/2026 às 22h17 UTC como versão estável. As notas também registram ajustes na pesquisa de repositórios e nos avisos de espera por runners, além de correções na leitura de artefatos e nos registros de uso de tokens dos subagentes.