Pular para o conteúdo
Breaking change

Claude Code 2.1.309

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

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

Resumo

O Claude Code 2.1.309 corrige permissões de escrita e execução em sessões isoladas. A atualização também muda o uso de sed -i e exige confiança no workspace para executar claude ultrareview. Você precisa revisar os scripts que chamam esse comando sem interação e a forma de recuperar arquivos alterados pelo shell.

Novidades

  • Claude Code 2.1.309 — Diagnóstico de certificados: a extensão do VS Code registra uma orientação quando a verificação de certificados falha nas requisições da extensão ou no ditado, inclusive com proxies que inspecionam TLS.

Melhorias

  • Claude Code 2.1.309 — Disco cheio: comandos Bash interrompidos por falta de espaço identificam o diretório que precisa ser liberado. A inicialização também explica a falta de espaço no volume temporário.
  • Claude Code 2.1.309 — Git no Windows: comandos internos do Git recebem ajustes de desempenho. As mensagens de erro desses comandos aparecem em inglês nas plataformas atendidas, mesmo com outro idioma configurado no Git.
  • Claude Code 2.1.309 — Runners próprios: uma sessão transferida para outro runner informa ao agente qual chamada de ferramenta foi interrompida e registra o resultado como desconhecido. O tempo limite de inicialização também respeita um primeiro prompt ainda executado por um subagente.
  • Claude Code 2.1.309 — Edição no VS Code: a espera por novos problemas após Edit e Write cai para 0,75 segundo na maioria dos casos, conforme as notas oficiais.
  • Claude Code 2.1.309 — Rastreamento: a skill /claude-api oferece rastreamento de requisições junto do rastreamento do SDK (Software Development Kit) ao configurar OpenTelemetry. Suas instruções também consultam a documentação atual ao verificar suporte a recursos.

Correções

  • Claude Code 2.1.309 — Inicialização do shell: a correção evita a execução dos arquivos de inicialização do shell fora do sandbox a cada comando Bash isolado no macOS e no Linux.
  • Claude Code 2.1.309 — Escrita por links simbólicos: os padrões denyWrite do macOS alcançam o caminho real de diretórios acessados por symlink. A proteção de escrita do armazenamento de perfis também se aplica ao diretório de configuração acessado dessa forma.
  • Claude Code 2.1.309 — Configuração MCP: os comandos isolados e as edições aceitas automaticamente respeitam a proteção do arquivo indicado por --mcp-config. Um servidor MCP (Model Context Protocol) desativado não é reconectado por uma solicitação posterior de permissão nas sessões print e SDK.
  • Claude Code 2.1.309 — Permissões Bash: a verificação corrige casos com variáveis associadas a redirecionamentos que podem falhar. Também reconhece mudanças de diretório anteriores ao Git em comandos compostos e aplica restrições Edit(path) a redirecionamentos em comandos com subshell.
  • Claude Code 2.1.309 — Isolamento de worktrees: a verificação recusa comandos com prefixos de locale ou certas expressões aritméticas do zsh que poderiam ser aceitos indevidamente. A criação de worktrees e os checkouts feitos pelo Claude Code ignoram as referências git replace.
  • Claude Code 2.1.309 — Processos em segundo plano: as restrições de escrita do sandbox Linux permanecem aplicadas quando um comando continua executando após o fim da sessão.
  • Claude Code 2.1.309 — Hooks PowerShell: a saída com código 2 recusa a ação prevista pelo hook. Os eventos PreToolUse e PermissionRequest configurados com PowerShell também corrigem a aceitação indevida quando o Git for Windows está ausente.
  • Claude Code 2.1.309 — Agentes em painéis divididos: os agentes auxiliares herdam as restrições de ferramentas e a opção --tools informadas na linha de comando do agente principal.
  • Claude Code 2.1.309 — Compactação: arquivos CLAUDE.md aninhados acima do limite carregam somente o início, evitando compactações repetidas após a leitura de arquivos sob essas instruções.
  • Claude Code 2.1.309 — Histórico de sessão: as prévias longas de resultados preservam caracteres de emoji, evitando transcrições que o jq não conseguia interpretar. A lista de /rewind reconhece alterações em arquivos com checkpoints feitas por subagentes ou comandos shell.
  • Claude Code 2.1.309 — Skills e plugins: uma skill em --add-dir com nome já utilizado fica acessível como <folder>:<name>. Falhas de leitura do disco não removem plugins e skills sincronizados do claude.ai.
  • Claude Code 2.1.309 — Mensagens e interface: o atalho Ctrl+Enter corrige o envio imediato durante a resposta ou durante hooks. O histórico expandido mostra mensagens ainda aguardando envio e a atualização da conexão com o Claude Desktop preserva mensagens da sessão.
  • Claude Code 2.1.309 — Sessões na nuvem: o editor de ambiente preserva a ordem das variáveis e os valores que contêm os dois tipos de aspas. O painel de alterações esclarece quando mostra somente commits enviados ou edições do Claude.
  • Claude Code 2.1.309 — Integração com Slack: a publicação de um rascunho aprovado para um canal recusa a ausência desse destino, evitando o envio por mensagem direta. Respostas a cartões de aprovação reiniciam sessões paradas.
  • Claude Code 2.1.309 — Revisões de código: uma última tentativa registra o resultado concluído quando tentativas anteriores de criar a verificação falharam. A interrupção por @claude review stop também cancela uma revisão que estava na fila.

Breaking changes

  • Claude Code 2.1.309 — Confiança no workspace: claude ultrareview exige confiança no diretório. O comando solicita confirmação no terminal e recusa a execução sem interação quando ela está ausente. Scripts que utilizam o comando precisam declarar a confiança com --trust-workspace, sem valor, colocando o número da revisão ou a branch base antes da flag. A publicação também documenta a variável CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1.
  • Claude Code 2.1.309 — Recuperação de edições: sed -i recebe a confirmação padrão do Bash e executa o comando literal. A prévia simulada de edição foi removida e /rewind não restaura essas alterações. Rotinas que utilizavam essa recuperação precisam preservar uma cópia do arquivo ou recorrer ao Git.

Ponto de Atenção

A criação e a reutilização de worktrees deixam de buscar objetos do Git sob demanda. Em clones parciais com sandbox Bash configurado, os objetos necessários são obtidos previamente. Os comandos excluídos do sandbox também exigem confirmação para escrever nos caminhos da lista de escrita quando o isolamento está habilitado, mas não consegue iniciar.

Teste sugerido: execute uma revisão de teste com claude ultrareview no mesmo modo utilizado pelo seu script e confira a exigência de confiança. Num diretório descartável, compare uma edição com sed -i e o comportamento de /rewind. Confira as permissões dos agentes auxiliares e a preservação do arquivo indicado por --mcp-config.

Notas da versão

O release oficial do Claude Code 2.1.309 foi publicado em 22/10/2026 às 22h18 UTC como versão estável. As mudanças de confiança no workspace e de recuperação de edições exigem revisão das automações que utilizam esses comportamentos.

Versões anteriores

    • 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
    • Claude Code 2.1.305

      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.

      Breaking change
    • 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

Versões posteriores

    • Claude Code 2.1.317

      O Claude Code 2.1.317 corrige a preservação de conversas em runners e muda o comportamento de sessões claude -p abertas dentro de outra sessão.

      Breaking change
    • Claude Code 2.1.316

      O Claude Code 2.1.316 corrige a aplicação de permissões em sessões restritas e ajusta o encerramento dos comandos de shell quando o processo encerra automaticamente.

      Stable
    • Claude Code 2.1.314

      O Claude Code 2.1.314 acrescenta uma configuração para recusar escrita fora dos diretórios de trabalho em qualquer modo de permissão.

      Stable
    • 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
Ver todas as 75 versões do Claude Code
Histórico de versões