Claude Code v2.1.307: Controle de versão do /claude-api, telemetria de eventos de segurança e correções de confiabilidade do MCP

O Claude Code v2.1.307 traz duas adições voltadas ao desenvolvedor — fixação da versão da API para código da Claude API e telemetria de segurança por chamada de ferramenta — junto com uma longa lista de correções em MCP, runner e estado de sessão.

Novo: fixação da versão da API e telemetria de eventos de segurança

• /claude-api api-version move o código da Claude API para a versão 2026-10-21. Útil quando você precisa que as chamadas geradas à API apontem para uma versão datada específica, em vez da versão padrão do modelo.
• Um novo evento OpenTelemetry, claude_code.safety_event, é disparado para cada chamada de ferramenta que uma regra de permissão, o modo automático, uma verificação de segurança, um hook ou o sandbox interrompeu, solicitou ou enviou de volta. Isso fornece um registro estruturado de cada intervenção nos seus loops de agente, em vez de inferi-las a partir das transcrições.

Correções notáveis

• Aliases de contexto de 1M: as requisições não falham mais com model-not-found quando CLAUDE_CODE_DISABLE_1M_CONTEXT está definido e o modelo é um alias com o sufixo [1m], por exemplo opus[1m].
• Cache de prompt: o cabeçalho beta prompt-caching-scope não é mais enviado por trás de gateways ANTHROPIC_BASE_URL personalizados ou no Foundry, onde não tinha efeito.
• Autenticação MCP no macOS: claude -p não relata mais "needs authentication" quando o keychain de login está bloqueado — ele informa o motivo, e a próxima execução após o desbloqueio conecta sem novo login.
• Sono/timeout do MCP: servidores que estavam no meio da conexão quando uma máquina macOS ou Linux dormiu não são mais reportados como tendo timed out e travados como falhos em execuções headless.
• Chamadas duplas do MCP HTTP: as chamadas de ferramenta não são mais enviadas duas vezes quando a conexão fecha no meio da chamada; apenas ferramentas somente leitura ou idempotentes são repetidas.
• Ferramentas MCP do SDK: um turno não começa mais sem as ferramentas mais recentes de um servidor MCP do SDK quando uma tarefa em segundo plano estava em execução.
• Autocompact: redução dos erros "Autocompact is thrashing" em turnos que leem muitas páginas de PDF, imagens ou grandes resultados de ferramentas; o /autocompact em sessões na nuvem também mantém sua janela entre reinicializações.
• Persistência do /clear: uma conversa limpa com /clear não reaparece mais após a reinicialização de uma sessão de runner na nuvem ou auto-hospedado.
• setModel() do Agent SDK: as trocas de modelo não são mais recusadas quando a API leva mais de 5 segundos para confirmar — o Claude Code agora espera até 15 segundos.
• Interface de permissões: /permissions > Recently denied agora mostra o comando de shell negado, e aprovar uma linha nomeia o comando em vez de sua descrição; o classificador local do modo automático agora respeita essa aprovação em um comando repetido.
• Ferramentas de escrita do GitHub MCP: corrigido um formulário que fechava sem criar nada na aba Code do aplicativo desktop quando o servidor é configurado diretamente.

Outras melhorias

• Chamadas de ferramenta não analisáveis são repetidas até duas vezes antes que o turno termine com erro.
• Subagentes fork iniciados juntos recebem cada um a informação de qual lançamento é o seu, reduzindo o trabalho iniciado de forma cruzada.
• O login pelo navegador mostra a página de sucesso assim que o login é concluído, sem esperar pelo perfil da conta.
• Erros 403 de pesquisa na web em sessões de runner na nuvem e auto-hospedadas agora exibem o motivo do servidor em vez de um genérico "Authentication error".
• O tempo de conexão do Remote Control melhorou para sessões com grandes imagens coladas ou leituras de PDF.
• O aviso de orçamento esgotado do WebSearch agora também instrui o Claude a não consultar mecanismos de busca via navegador ou uso do computador.

Usuários de runner auto-hospedado recebem duas correções específicas: sessões com --use-anthropic-git-proxy não cometem mais um .claude/settings.local.json deixado no clone por uma sessão anterior, e arquivar ou reenfileirar uma sessão durante seu hook de checkout não deixa mais processos de hook em execução e o slot do runner ocupado.