Pular para o conteúdo
Breaking change

Claude Code 2.1.305

Confira as mudanças desta versão e os avisos antes de atualizar.

Publicada em
Posição no histórico
11 de 75
Nesta página

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.allowNestedUserNamespaces permite 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_MS configura 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: /usage identifica a configuração que causa cada aviso e oferece f para 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 setMcpServers preserva sua configuração diante de outro servidor com o mesmo nome nas configurações locais. A retomada de Workflow recupera do diário os agentes pipeline() e parallel() já concluídos.
  • Claude Code 2.1.305 — Modelos e compactação: /effort e /autocompact reconhecem 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_CONFIG e 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: allowedMcpServers deixa de filtrar servidores stdio de managed-mcp.json que utilizam ${VAR} somente em env. Um servidor anteriormente excluído pela lista pode carregar após a atualização. Use deniedMcpServers para manter sua exclusão.
  • Claude Code 2.1.305 — Permissões dos plugins: plugins montados por caminho pelo Claude Desktop perdem allowed-tools quando a organização aplica allowManagedPermissionRulesOnly. 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 /artifacts utiliza 1 ou Enter para manter e 2 para excluir. Esc cancela. As respostas y e n deixam 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.

Versões anteriores

    • Claude Code 2.1.304

      O Claude Code 2.1.304 amplia a configuração do modo automático e corrige falhas que afetavam a preservação de conversas e worktrees.

      Breaking change
    • Claude Code 2.1.303

      O Claude Code 2.1.303 recebeu correções de bugs e melhorias de confiabilidade.

      Stable
    • Claude Code 2.1.302

      O Claude Code 2.1.302 corrige rotinas agendadas que podiam repetir o trabalho após uma falha e ajusta os modos de permissão das sessões sem configuração explícita.

      Stable
    • Claude Code 2.1.301

      O Claude Code 2.1.301 corrige a remoção de worktrees ao sair e distingue uma busca sem resultados de uma falha no programa de busca.

      Breaking change
    • Claude Code 2.1.300

      O Claude Code 2.1.300 corrige a retomada de conversas compactadas e a continuidade das conexões MCP.

      Breaking change
    • Claude Code 2.1.299

      O Claude Code 2.1.299 corrige falhas na aplicação das permissões da sandbox e no isolamento das chaves utilizadas com gateways de terceiros.

      Breaking change

Versões posteriores

    • Claude Code 2.1.312

      O Claude Code 2.1.312 corrige a leitura das políticas da organização após o login no VS Code e a gravação de arquivos de instruções extensos.

      Stable
    • Claude Code 2.1.311

      O Claude Code 2.1.311 corrige interrupções e perda de continuidade em sessões longas.

      Stable
    • Claude Code 2.1.310

      O Claude Code 2.1.310 amplia o uso de monitores nos provedores de nuvem e corrige falhas de compactação que podiam repetir o erro de prompt extenso.

      Stable
    • Claude Code 2.1.309

      O Claude Code 2.1.309 corrige permissões de escrita e execução em sessões isoladas.

      Breaking change
    • Claude Code 2.1.307

      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.

      Breaking change
    • Claude Code 2.1.306

      O Claude Code 2.1.306 corrige a autenticação do comando claude -p nas sessões em nuvem e a apresentação de erros em sessões com muitas ferramentas MCP (Model Context Protocol).

      Stable
Ver todas as 75 versões do Claude Code
Histórico de versões