Resumo

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. A manutenção também abrange a leitura de imagens, os servidores MCP e a gravação das preferências antes de encerrar os comandos.

Você precisa conferir separadamente as sessões iniciadas por claude -p ou pelo Agent SDK. Em determinadas instalações, elas iniciam no modo default quando nenhum modo foi informado. Os subagentes do tipo fork ficam habilitados por padrão em mais interfaces, com diferenças entre a execução dos agentes da conversa principal e as chamadas feitas por outro subagente.

Novidades

Claude Code 2.1.302 — Classificador local: CLAUDE_CODE_AUTO_MODE_MODEL seleciona o modelo utilizado pelo classificador do modo Auto no cliente. A variável não modifica o classificador executado no servidor.
Claude Code 2.1.302 — Compactação por inatividade: /config oferece uma opção para desativar ou reativar esse comportamento. O aviso posterior à compactação também explica como desativá-lo.
Claude Code 2.1.302 — Rotinas na nuvem: a página da rotina informa por que a última execução não começou, incluindo o limite de sessões simultâneas da organização.

Melhorias

Claude Code 2.1.302 — Carregamento de plugins: a inicialização reduz as consultas ao sistema de arquivos para carregar comandos e agentes, especialmente no Windows.
Claude Code 2.1.302 — Conversas extensas: o modo Auto com classificador no servidor compacta uma conversa que excede o tamanho aceito pela verificação, permitindo continuar a avaliação das ferramentas.
Claude Code 2.1.302 — Subagentes: o tipo fork fica habilitado por padrão no modo -p, no Agent SDK, no desktop e no VS Code. CLAUDE_CODE_FORK_SUBAGENT=0 desativa esse recurso, que não é oferecido por claude mcp serve.
Claude Code 2.1.302 — Execução dos agentes: desktop e VS Code executam os subagentes da conversa principal em segundo plano. As chamadas Agent feitas por um subagente utilizam o primeiro plano por padrão nas interfaces indicadas nas notas.
Claude Code 2.1.302 — Hooks: até 12 hooks de prompt ou de agente associados ao mesmo evento executam simultaneamente. Os demais aguardam.

Correções

Claude Code 2.1.302 — Rotinas repetidas: uma rotina agendada que falhou parcialmente não reinicia desde o começo uma hora ou mais depois. Essa repetição podia publicar o mesmo relatório duas vezes.
Claude Code 2.1.302 — Estado na nuvem: sessões interrompidas inesperadamente e rotinas arquivadas antes de começar recebem estado de falha. A retomada conserva o custo e o consumo registrados, e a restauração aceita mensagens anteriores à mais recente.
Claude Code 2.1.302 — Leitura de imagens: a ferramenta Read recusa fontes acima de 128 MB. A correção também abrange pipes e dispositivos nomeados como imagens, cuja leitura integral podia ocupar a memória.
Claude Code 2.1.302 — Protocolo MCP: servidores que negociam a versão 2026-07-28 continuam disponíveis quando omitem resultType, ttlMs ou cacheScope.
Claude Code 2.1.302 — Configuração gravada: os subcomandos aguardam a escrita pendente antes de terminar. O tratamento de plugins e de checkouts reutilizados também corrige falhas ligadas ao formato reftable do Git.
Claude Code 2.1.302 — Modelos e compactação: a interrupção durante a compactação não produz o erro de prompt longo descrito nas notas. A troca para Vertex ou Bedrock não envia o campo diagnostics recusado, e gateways com prefixos no nome do modelo conservam o destino correto de /autocompact e /effort.
Claude Code 2.1.302 — Windows: projetos em exFAT ou FAT32 recebem correção nas permissões de escrita. O PowerShell encontra comandos na pasta bin/ dos plugins e aceita buscas sem resultados encaminhadas a cmdlets de formatação.
Claude Code 2.1.302 — Telemetria: os eventos tool_decision recuperam classifier_category nas recusas do classificador e preservam os atributos da ferramenta quando o limite de atributos é baixo.
Claude Code 2.1.302 — Integrações: a autenticação MCP pelo VS Code aceita URLs com parâmetros. O Claude Tag recebe correções para anexos de imagem, acesso por função, seleção de workspace e conectores que compartilham o mesmo host.

Ponto de Atenção

Sessões claude -p e Agent SDK sem modo de permissão definido iniciam em default quando utilizam fornecedores externos, telemetria desativada ou uma instalação nova. Use --permission-mode auto quando esse for o comportamento pretendido. As notas não apresentam uma remoção dessa opção.

A restauração de mensagens nas sessões de nuvem exige Claude Code 2.1.246 ou posterior nos runners próprios. Os comandos de integração com Claude Design também avisam que a oferta independente encerra até 14 de dezembro de 2026.

Teste sugerido: em homologação, compare a inicialização sem modo informado com --permission-mode auto. Confira a gravação de uma preferência após um subcomando de plugin e a lista de ferramentas de um servidor MCP compatível. Examine o histórico de uma rotina interrompida para verificar o estado registrado e a ausência de uma execução repetida.

Notas da versão

O release oficial do Claude Code 2.1.302 foi publicado em 16/10/2026 às 20h53 UTC como versão estável.

Claude Code 2.1.302