Resumo
O Claude Code 2.1.305 corrige uma regressão da 2.1.304 que fazia as requisições falharem quando o provedor recusava a busca de ferramentas. A retomada de workflows também preserva agentes já concluídos. As configurações gerenciadas exigem revisão porque a atualização altera quais servidores MCP são carregados e quais permissões os plugins montados pelo Desktop conservam.
Novidades
- Claude Code 2.1.305 — Sandbox no Linux:
sandbox.allowNestedUserNamespacespermite criar namespaces de usuário para executar aplicações como Chromium e Podman sem root. As notas alertam que essa opção permite contornar as proteções de arquivos da sandbox. - Claude Code 2.1.305 — Novas tentativas:
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MSconfigura a conferência de limites de uso removidos antes do horário previsto para renovação no modo automático de novas tentativas.
Melhorias
- Claude Code 2.1.305 — Diagnóstico:
/usageidentifica a configuração que causa cada aviso e oferecefpara aplicar os ajustes. As mesmas orientações aparecem no VS Code e em/doctor. - Claude Code 2.1.305 — Consentimento: o diálogo de autorização do MCP (Model Context Protocol) reduz a possibilidade de interpretar como aceite um Enter destinado ao campo de mensagem.
- Claude Code 2.1.305 — VS Code: a inicialização informa a execução dos hooks SessionStart ou Setup, com anúncio para leitores de tela. Uma falha de inicialização sem hook em andamento direciona a consulta aos logs.
Correções
- Claude Code 2.1.305 — Provedores e gateways: a requisição é repetida sem ToolSearch quando o endpoint recusa a busca ou a configuração não permite essa ferramenta. A correção inclui Vertex e Bedrock.
- Claude Code 2.1.305 — Worktrees: novos worktrees de repositórios bare utilizam a branch padrão nos casos afetados. A limpeza também corrige a permanência de worktrees sem alterações criados pelos subagentes.
- Claude Code 2.1.305 — Sessões e ferramentas: um servidor MCP recebido da sessão na nuvem ou de
setMcpServerspreserva sua configuração diante de outro servidor com o mesmo nome nas configurações locais. A retomada de Workflow recupera do diário os agentespipeline()eparallel()já concluídos. - Claude Code 2.1.305 — Modelos e compactação:
/efforte/autocompactreconhecem diferenças de caixa ou de sufixo[1m]no nome do modelo. A sessão informa ao agente quando a compactação precisou omitir as mensagens mais antigas. - Claude Code 2.1.305 — Execução local: a falha de Bash por disco cheio informa que nenhum comando executou. Os runners próprios corrigem a leitura de credenciais via
GIT_CONFIGe falhas relacionadas à saída mantida aberta por processos em segundo plano. - Claude Code 2.1.305 — Rotinas e revisão: as rotinas do Claude Tag preservam a publicação em threads após reinícios de conversa. O Code Review considera o commit mais recente quando há vários envios durante a revisão.
Breaking changes
- Claude Code 2.1.305 — Servidores gerenciados:
allowedMcpServersdeixa de filtrar servidores stdio demanaged-mcp.jsonque utilizam${VAR}somente emenv. Um servidor anteriormente excluído pela lista pode carregar após a atualização. UsedeniedMcpServerspara manter sua exclusão. - Claude Code 2.1.305 — Permissões dos plugins: plugins montados por caminho pelo Claude Desktop perdem
allowed-toolsquando a organização aplicaallowManagedPermissionRulesOnly. Revise as permissões gerenciadas das ferramentas utilizadas por essas extensões. - Claude Code 2.1.305 — Exclusão de artefatos: a confirmação de
/artifactsutiliza1ou Enter para manter e2para excluir. Esc cancela. As respostasyendeixam de funcionar.
Ponto de Atenção
Ative namespaces aninhados somente após avaliar as proteções de arquivos que essa configuração permite contornar. A lista de servidores gerenciados merece uma conferência própria, pois um servidor anteriormente ausente pode carregar com a atualização.
Teste sugerido: numa instalação de homologação, confira os servidores MCP carregados e a exclusão por deniedMcpServers. Retome um Workflow com uma etapa concluída e verifique se ela é recuperada do diário. Num gateway que recusa ToolSearch, confira a nova tentativa sem a ferramenta.
Notas da versão
O release oficial do Claude Code 2.1.305 foi publicado em 20/10/2026 às 20h46 UTC como versão estável.