Resumo
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. A manutenção também abrange a renovação do login e a compactação de conversas ao trocar de modelo. As integrações com mods precisam conferir dois contratos alterados: o tratamento de erros dos hooks e o retorno da escrita de variáveis de ambiente.
Novidades
- Claude Code 2.1.301 — Espera por limite de uso:
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MSlimita a espera do modo de novas tentativas sem acompanhamento quando a renovação da cota está distante. - Claude Code 2.1.301 — OpenTelemetry: os eventos
tool_decisionincluemclassifier_verdictepermission_mode. ComOTEL_LOG_TOOL_DETAILS=1,classifier_categoryidentifica a classificação interna que motivou a recusa. - Claude Code 2.1.301 — Entrada de texto: o modo Vim aceita
%para saltar ao delimitador correspondente. O campoInputde mods receberowspara texto com várias linhas. O VS Code renderiza expressões LaTeX nas respostas.
Melhorias
- Claude Code 2.1.301 — Mudança de modelo: conversas maiores que a janela do modelo selecionado podem ser resumidas pelo modelo anterior antes da troca. A versão também corrige o consumo de créditos para esse resumo sem consulta prévia.
- Claude Code 2.1.301 — Renderização: o progresso de subagentes recebe atualização incremental. O painel do VS Code evita reprocessar todo o texto de raciocínio a cada atualização.
Correções
- Claude Code 2.1.301 — Worktrees: a saída não remove sem perguntar um worktree criado por
WorktreeCreatequando ele pode conter commits ainda não enviados. - Claude Code 2.1.301 — Busca e leitura: Grep e Glob informam a falha do programa de busca em vez de anunciar ausência de resultados. A ferramenta Read deixa de interpretar como texto arquivos binários como
.parquete.epub. - Claude Code 2.1.301 — Autenticação: comandos curtos não interrompem a renovação do token ao terminar. A falha de renovação causada por disco cheio informa essa condição.
- Claude Code 2.1.301 — Conversas e permissões: gateways que retornam outro nome de modelo não provocam compactações repetidas. Uma chamada interrompida por mensagem durante a conferência de permissão não aparece como recusa sua. O prompt de um hook identifica o plugin ou a skill que solicitou a confirmação.
- Claude Code 2.1.301 — Skills e workflows: as skills voltam a aparecer depois de
/rewind. Os agentes de workflow recebem correção para não ignorar a etapa e ainda registrar sucesso. A expansão de argumentos limita o preenchimento aos primeiros 64 nomes, com até 64 caracteres cada. - Claude Code 2.1.301 — Artefatos e runner: arquivos sujeitos a hooks de Edit ou Write são editados antes da republicação. Sessões iniciadas pelo Slack no runner autogerenciado voltam a localizar o repositório sob as configurações gerenciadas de MCP.
Breaking changes
- Claude Code 2.1.301 — Contratos de mods: o
.catchde um hook executa somente quando há exceção ou timeout. Eventos gerados pelas chamadas do próprio hook ignoram o hook sem acionar esse tratamento. O retorno de$.env.seté{}na escrita concluída ou{ deny }na recusa. Adapte os consumidores que dependem do retorno anterior ou da execução de.catchnesses eventos.
Ponto de Atenção
Confira os mods que tratam variáveis de ambiente e os hooks que iniciam outras chamadas. A mudança do contrato exige examinar a resposta devolvida, além da ausência de exceção. O limite de expansão dos argumentos também merece conferência nas skills extensas.
Teste sugerido: num mod de homologação, execute $.env.set num caso permitido e num caso recusado e confira o objeto retornado. Retome uma conversa, utilize /rewind e verifique a disponibilidade das skills. Teste separadamente uma busca sem correspondências e uma busca cujo executável falhe.
Notas da versão
O release oficial do Claude Code 2.1.301 foi publicado em 15/10/2026 às 19h22 UTC como versão estável.