Pular para o conteúdo
Breaking change

Claude Code 2.1.328

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

StayCloudVPS Agêntica

30% off na sua VPS Agêntica nos 2 primeiros meses

A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

Aproveitar a Black Friday

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA
Publicada em
Posição no histórico
3 de 69
Nesta página

Resumo

O Claude Code 2.1.328 é a publicação mais extensa do dia e muda o padrão de permissão em provedor de nuvem. O modo automático chega ao Claude Opus 4.6 e ao Sonnet 4.6 no Amazon Bedrock, no Agent Platform do Google Cloud, no Microsoft Foundry e no gateway de aplicativos Claude, e uma sessão interativa sem modo de permissão escolhido começa agora nele. Em paralelo, o hook mcp_tool ganha "onFailure": "block" com o mesmo efeito dos hooks de comando e de HTTP.

A segunda frente está no Code Mode e no ciclo de sessão. O modo perde a pausa de 0,75 segundo depois da maioria dos scripts, mostra o comando e a saída durante a execução, informa quais chamadas ainda rodavam quando um script falhou e inicia agora servidor de desenvolvimento como tarefa visível em /tasks. A retomada de sessão grande fica mais rápida, o consumo de memória com muitas imagens cai e o cache de prompt rende mais em sessão nova com servidor MCP.

A terceira frente é o executor auto-hospedado. Entram --repository-folder, --hook-label e --metadata key=value, além de duas métricas do orquestrador, e o conjunto de correções trata de token vencido em host com relógio atrasado, clone mantido após erro de disco, sessão arquivada durante a preparação de outro repositório e .claude.json danificado.

Novidades

  • Claude Code 2.1.328 — Modo automático em provedores de nuvem: o modo fica disponível para Claude Opus 4.6 e Sonnet 4.6 no Amazon Bedrock, no Agent Platform do Google Cloud, no Microsoft Foundry e no gateway de aplicativos Claude. Sessão interativa que não escolhe modo de permissão começa no modo automático.
  • Claude Code 2.1.328 — onFailure no hook mcp_tool: "onFailure": "block" faz a chamada de ferramenta barrada quando o hook falha, com o mesmo comportamento já disponível em hook de comando e de HTTP.
  • Claude Code 2.1.328 — Aviso de mensagem retida: aparece um aviso quando uma mensagem vinda de sessão que ignora confirmação de permissão pode ser retida e descartada por sessão na nuvem.
  • Claude Code 2.1.328 — Exportador de OpenTelemetry sem endpoint: /status e claude doctor avisam quando o exportador não tem endpoint e a telemetria tende a se perder.
  • Claude Code 2.1.328 — CLAUDE_CODE_DISABLE_DEFERRED_TOOL_RESUME: a variável permite ao host impedir que claude -p --resume e --continue executem uma chamada de ferramenta que um hook deixou para depois.
  • Claude Code 2.1.328 — allowManagedModsOnly: aplicativo que embute o Claude Code pode ligar a opção do plugin de política, e a configuração gerenciada pelo administrador continua com precedência.
  • Claude Code 2.1.328 — maxEffortLevel inválido: o gateway de aplicativos Claude avisa na partida quando o nível da política não é um nível de esforço válido.
  • Claude Code 2.1.328 — --repository-folder no executor: a opção nomeia a pasta que a sessão usa para um repositório com --capacity 1, no lugar do caminho dentro da pasta base, que não pode ser link simbólico.
  • Claude Code 2.1.328 — --hook-label no orquestrador: claude self-hosted-runner orchestrator entrega rótulos escolhidos de sessão ao hook spawn-runner.
  • Claude Code 2.1.328 — --metadata key=value: claude --environment aceita rótulo de sessão para o hook spawn-runner.
  • Claude Code 2.1.328 — Métricas do orquestrador: /metrics ganha claude_code_self_hosted_orchestrator_session_queue_wait_by_reason_seconds, que separa a espera de sessão reaberta, e claude_code_self_hosted_orchestrator_sessions_given_up_total, que registra por causa a desistência de iniciar um executor para a sessão.
  • Claude Code 2.1.328 — Aviso de modo de permissão ignorado: a partida no executor avisa quando o settings.json do host define um modo de permissão padrão que as sessões ignoram.

Melhorias

  • Claude Code 2.1.328 — Plugins de configuração gerenciada: sessões de claude -p e do SDK buscam em segundo plano, para a próxima sessão, os plugins com repositório Git próprio.
  • Claude Code 2.1.328 — Plugins de marketplace Git: o carregamento numa máquina nova fica mais cedo em claude -p, no SDK e no Claude Desktop, com a ressalva de que uma execução curta pode terminar até 30 segundos depois.
  • Claude Code 2.1.328 — Retomada de sessão grande: o tempo de retomada cai, e o consumo de memória diminui em sessão com muitas imagens.
  • Claude Code 2.1.328 — Sessão longa de SDK e desktop: o consumo de memória e o tempo de resposta melhoram em sessão que executa comandos ou ferramentas lentas.
  • Claude Code 2.1.328 — Velocidade do Code Mode: a pausa de 0,75 segundo depois da maioria dos scripts sai no modo automático e no modo de permissão ignorada.
  • Claude Code 2.1.328 — Cache de prompt no Code Mode: sessão nova com servidor MCP aproveita melhor o cache, e o Claude é informado quando um servidor ainda conecta e quando a lista de servidores muda.
  • Claude Code 2.1.328 — Tokens no Code Mode: as descrições de ferramenta ficam mais curtas, o que reduz o consumo em cada script.
  • Claude Code 2.1.328 — Visibilidade do Code Mode: o modo mostra o comando em execução e a saída enquanto o script roda.
  • Claude Code 2.1.328 — Edição sem efeito no Code Mode: uma edição que não muda nada deixa de interromper o script, e o Claude recebe onde a edição falhou ou chegou mais perto.
  • Claude Code 2.1.328 — Script que falha: o Claude é informado agora de quais chamadas de ferramenta ainda rodavam no momento da falha.
  • Claude Code 2.1.328 — Servidor de desenvolvimento no Code Mode: no modo automático e no de permissão ignorada, o servidor inicia como tarefa em segundo plano visível em /tasks.
  • Claude Code 2.1.328 — Shell no Windows: o Claude é informado de que os comandos do script rodam no Git Bash e de que aliases do PowerShell valem no lugar de funções de mesmo nome.
  • Claude Code 2.1.328 — Teammates em processo: iniciar vários de uma vez falha menos com “Lock file is already being held”.

Correções

  • Claude Code 2.1.328 — Comando no zsh com palavra iniciada por =: comandos como echo ==== e [ a == b ] deixam de parar com “not found”, e =cmd não expande mais para o caminho de um comando.
  • Claude Code 2.1.328 — Compactação automática: a compactação deixa de reutilizar o prompt de sistema anterior da sessão e reconstrói o prompt como o /compact faz.
  • Claude Code 2.1.328 — Renderização de Markdown: a exibição deixa de congelar com entrada longa ou malformada, e congelamentos raros de tela são corrigidos.
  • Claude Code 2.1.328 — Esc no prompt de permissão: a tecla deixa de se perder quando você digita logo depois da pergunta. Em terminal que envia Alt como Esc e uma tecla, uma tecla Alt ou Option não usada recusa a ação.
  • Claude Code 2.1.328 — Colagem interrompida por conexão lenta: a colagem ou a resposta do terminal que chega em duas partes não é mais digitada no prompt.
  • Claude Code 2.1.328 — Tarefa agendada: gravar uma tarefa deixa de apagar as outras tarefas guardadas do projeto quando o arquivo de tarefas não pode ser lido em provedor de terceiros ou com telemetria e flags desligadas, e uma tarefa com erro de digitação no arquivo não é mais excluída na gravação seguinte.
  • Claude Code 2.1.328 — Sessão na nuvem retomada: a sessão deixa de perder o resumo de compactação ou as mensagens recentes quando uma mensagem foi gravada tarde.
  • Claude Code 2.1.328 — Medição de tokens: o spinner e o subagente deixam de somar duas vezes uma resposta repetida, de perder resposta não transmitida e de ficar parado enquanto o Claude pensa.
  • Claude Code 2.1.328 — Créditos esgotados: o erro no meio da resposta deixa de nomear limite de requisições.
  • Claude Code 2.1.328 — Modo automático atrás de gateway: o modo deixa de falhar em todo turno fora do Claude Desktop com CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS definido em gateway que recusa betas, em Bedrock, Agent Platform, Foundry e gateway de aplicativos Claude.
  • Claude Code 2.1.328 — Tempo limite de transmissão: CLAUDE_STREAM_IDLE_TIMEOUT_MS amplia agora o limite de cinco minutos em gateway, URL base própria e provedor de nuvem.
  • Claude Code 2.1.328 — “Prompt is too long” no Claude Desktop: sessões em provedor de terceiros deixam de terminar de vez depois de resultado de ferramenta grande, porque os maiores ficam de fora.
  • Claude Code 2.1.328 — Esquema de ferramenta MCP iniciado por anyOf, oneOf ou allOf: a ferramenta deixa de desaparecer em provedor de terceiros ou com telemetria e flags desligadas.
  • Claude Code 2.1.328 — Esquema inválido de ferramenta MCP: a ferramenta inválida deixa de derrubar a requisição, fica de fora e o Claude é informado do motivo.
  • Claude Code 2.1.328 — Esforço do subagente: o esforço não é mais desligado no modelo do subagente quando Bedrock, Agent Platform ou Foundry recusam o ajuste do resumo de progresso, regressão da 2.1.327.
  • Claude Code 2.1.328 — Pergunta aberta por dez minutos no Code Mode: uma permissão fora do modo automático, uma aprovação de plano ou uma pergunta aberta por dez minutos deixa de interromper o script.
  • Claude Code 2.1.328 — Servidor MCP conectado durante script: um script deixa de falhar ao chamar servidor que conectou enquanto o script anterior rodava.
  • Claude Code 2.1.328 — Code Mode em segundo plano: o script volta a rodar em segundo plano no modo automático e no de permissão ignorada em sessão escolhida no seletor --resume.
  • Claude Code 2.1.328 — Retomada com vários scripts: o Code Mode deixa de perder skill carregada, informação de hook ou nota digitada junto da aprovação quando a sessão é retomada.
  • Claude Code 2.1.328 — Variável de topo sem definição: o Code Mode deixa de usar undefined em silêncio para variável de topo que um script anterior falhou em definir.
  • Claude Code 2.1.328 — Script válido recusado: o Code Mode aceita script que começa com bloco { e script que usa await e return de topo ao mesmo tempo.
  • Claude Code 2.1.328 — Arquivo mencionado com @: um arquivo pequeno deixa de ficar sem anexo no Code Mode depois de um script ler ou gravar nele.
  • Claude Code 2.1.328 — Ferramenta de escrita em subagente somente leitura: o Code Mode deixa de oferecer write() e edit() a subagente que não pode chamá-las.
  • Claude Code 2.1.328 — Turno iniciado sozinho: o Claude deixa de começar um turno sozinho no Code Mode quando Esc é seguido de comando como /model.
  • Claude Code 2.1.328 — Remote Control: a mensagem de desconexão deixa de se repetir, e a sessão que não pode reconectar deixa de sugerir nova tentativa.
  • Claude Code 2.1.328 — Pergunta de permissão em sessão remota: a pergunta que esperava deixa de se perder e de ter a resposta ignorada quando a sessão remota reinicia com o serviço lento.
  • Claude Code 2.1.328 — Rewind seguido de /clear: a sessão na nuvem deixa de retomar uma conversa já limpa.
  • Claude Code 2.1.328 — Diferença de arquivos: /diff, o painel Changes do Remote Control e a diferença ao lado da edição incluem agora trabalho commitado depois de um comando mover o repositório.
  • Claude Code 2.1.328 — Cmd+letra: a combinação não é mais digitada no prompt em terminal que reporta Cmd.
  • Claude Code 2.1.328 — Mouse no GNOME Terminal: Ctrl+click deixa de abrir o link duas vezes, os botões laterais param de agir como clique e o primeiro giro da roda no sentido oposto após uma pausa não é mais ignorado em tela cheia.
  • Claude Code 2.1.328 — Teclado em terminais específicos: Shift+Enter funciona no Konsole fora de tmux e ssh, e atalhos Alt funcionam em layout não latino em terminal que fala o protocolo de teclado kitty.
  • Claude Code 2.1.328 — Área de transferência no Linux: colar em outro aplicativo deixa de congelar enquanto o Claude Code está suspenso com Ctrl+Z, com xclip ou wl-copy instalado, e Ctrl+V volta a trazer a imagem atual em vez de uma antiga ou de travar.
  • Claude Code 2.1.328 — Texto copiado em tela cheia: a cópia deixa de incluir a barra de citação, de perder espaços na quebra de linha quando a seleção rola para cima e de omitir palavras sob o aviso “Jump to bottom”.
  • Claude Code 2.1.328 — Busca e seleção com teclas juntas: Ctrl+R em tela cheia e o editor de cor do /theme deixam de escolher a linha errada, e teclas deixam de se perder na busca de /config e /plugin.
  • Claude Code 2.1.328 — Cores no GNU screen: a exibição deixa de mostrar cor errada ou ausente.
  • Claude Code 2.1.328 — /plugin: a tela deixa de sugerir a desinstalação do plugin errado, de perder a posição ao voltar, de fechar a página aberta quando uma gravação lenta termina e de desligar vários plugins com Enter segurado. A aba Installed volta a aceitar digitação e setas depois de busca sem resultado.
  • Claude Code 2.1.328 — /usage: o total de plugin deixa de parar em 2.000 tokens em modelo de janela de 1 milhão de tokens, e a estimativa deixa de ficar baixa quando nenhum modelo foi escolhido.
  • Claude Code 2.1.328 — /exit e Ctrl+D: os dois descrevem agora o trabalho em execução da mesma forma, e /exit deixa de avisar sobre fluxo que já parou.
  • Claude Code 2.1.328 — OTEL_RESOURCE_ATTRIBUTES com entrada malformada: só a entrada inválida fica de fora, e os outros rótulos deixam de desaparecer de métrica, evento e span.
  • Claude Code 2.1.328 — Hook de agente durante compactação: o hook deixa de passar do tempo limite quando a compactação acontece depois de uma requisição recusada por tamanho.
  • Claude Code 2.1.328 — FORCE_COLOR negativo: a CLI deixa de quebrar na partida.
  • Claude Code 2.1.328 — Máscara de segredo com memória quase esgotada: a aplicação deixa de quebrar nessa condição.
  • Claude Code 2.1.328 — .git/HEAD no sandbox do Bash: o arquivo não é mais renomeado a cada comando quando o nome da branch não é UTF-8 válido.
  • Claude Code 2.1.328 — Executor auto-hospedado e proxy: uma resposta HTTP 200 com corpo como {} deixa de parar todas as sessões em execução, e a consulta é repetida.
  • Claude Code 2.1.328 — Executor com erro temporário de disco: a remoção de objetos e refs do clone mantido, e de commits que existiam só ali, deixa de acontecer. A partida falha agora nesse caso.
  • Claude Code 2.1.328 — Token vencido em host com relógio atrasado: o executor deixa de parar quando o relógio da máquina está lento ou foi ajustado para trás.
  • Claude Code 2.1.328 — claude dentro de script no executor: a sessão com Git gerenciado pela Anthropic deixa de perder o acesso ao GitHub depois que um script ou hook executa claude outra vez.
  • Claude Code 2.1.328 — http.proactiveAuth no host: o executor com Git gerenciado volta a buscar e enviar em máquina cuja configuração do Git define a opção.
  • Claude Code 2.1.328 — Executor que sai sem avisar: o executor se registra agora como encerrado com motivo, e o executor sob demanda informa a partida que falhou.
  • Claude Code 2.1.328 — Arquivar ou reenfileirar sessão: o comando vale agora com --capacity acima de 1 enquanto outra sessão prepara o mesmo repositório.
  • Claude Code 2.1.328 — .claude.json danificado: a sessão deixa de falhar em toda partida com --trust-workspace false, começa com os padrões e volta a ligar os servidores MCP naquele host.
  • Claude Code 2.1.328 — Hook de pós-sessão com disco travado: o hook não é mais pulado, e o fim da sessão pode levar 25 segundos a mais por padrão quando o disco está morto.
  • Claude Code 2.1.328 — Retomada em outro diretório de configuração: a sessão deixa de perder a lista de tarefas.
  • Claude Code 2.1.328 — --correlation-id no hook: o valor de claude --environment chega ao hook spawn-runner.
  • Claude Code 2.1.328 — Aviso de rotação de chave: o assistente do executor informa que revogar uma chave encerra as sessões que rodam sob ela.
  • Claude Code 2.1.328 — Aviso de plugin: o aviso de um plugin deixa de mostrar o texto de outro.
  • Claude Code 2.1.328 — Mod gravado no começo do turno: o mod deixa de recarregar no meio do turno e espera agora o fim.
  • Claude Code 2.1.328 — Artifact privado: o Claude deixa de afirmar que o artifact é privado depois de ler um em pasta compartilhada ou de publicar em outra organização, e de limitar o acesso a nomes específicos quando a pasta permite mais gente.

Breaking changes

  • Claude Code 2.1.328 — Modo automático como padrão em provedor de nuvem: sessão interativa sem modo de permissão escolhido começa agora no modo automático quando a conexão usa Claude Opus 4.6 ou Sonnet 4.6 no Amazon Bedrock, no Agent Platform do Google Cloud, no Microsoft Foundry ou no gateway de aplicativos Claude. Uma automação que dependia da pergunta de permissão a cada ação precisa definir o modo explicitamente e revisar as diretivas de permissão e a política da organização antes de atualizar.

Ponto de Atenção

A publicação muda o padrão de permissão em provedor de nuvem e acrescenta um hook que pode barrar uma chamada de ferramenta por falha, dois pontos que alteram o comportamento de uma sessão sem ninguém acompanhando. O aviso de exportador de OpenTelemetry sem endpoint também importa para uma rotina de observação, porque indica perda de métrica, evento e span.

Teste sugerido: numa conexão com Bedrock ou Foundry, abra uma sessão interativa sem escolher modo e confira o modo em uso no /status. Acione um comando coberto por diretiva de permissão e observe se houve pergunta. Configure um hook mcp_tool com "onFailure": "block", force a falha e confira a recusa. Defina CLAUDE_CODE_DISABLE_DEFERRED_TOOL_RESUME=1 e retome uma sessão com claude -p --resume. Rode um script de Code Mode no modo automático e confirme a partida de servidor de desenvolvimento em /tasks.

Notas da versão

O release oficial do Claude Code 2.1.328 foi publicado em 19/11/2026 às 1h14 UTC como versão estável. As notas vêm da lista de mudanças do repositório, que separa as mudanças de Code Mode e de Remote Control das do executor auto-hospedado, do terminal e da integração com MCP.

Versões anteriores

    • Claude Code 2.1.327

      O Claude Code 2.1.327 é uma publicação longa, com mudanças de comportamento em permissão, sandbox e modo automático.

      Breaking change
    • Claude Code 2.1.326

      O Claude Code 2.1.326 é uma publicação grande, com mudanças de comportamento em permissões, sandbox e modo automático, além de correções espalhadas por sessões em segundo plano, MCP, login e interface de terminal.

      Breaking change
    • Claude Code 2.1.325

      O Claude Code 2.1.325 muda o comportamento padrão do Bash dentro do sandbox: os comandos seguem o fluxo normal de permissão e exigem aprovação, a menos que sandbox.autoAllowBashIfSandboxed esteja em true.

      Stable
    • Claude Code 2.1.323

      O Claude Code 2.1.323 introduz o Code Mode, um modo experimental no qual o modelo escreve JavaScript para chamar as ferramentas, em vez de emitir cada chamada na conversa.

      Breaking change
    • Claude Code 2.1.322

      O Claude Code 2.1.322 disponibiliza o modo rápido no Vertex nas regiões global, us e eu.

      Stable
    • Claude Code 2.1.321

      O Claude Code 2.1.321 acrescenta o Claude Fable 5.2 e corrige falhas nas permissões de comandos, no OAuth dos servidores MCP e na edição de arquivos remotos.

      Breaking change

Versões posteriores

    • Claude Code 2.1.330

      O Claude Code 2.1.330 é a publicação grande do fim do dia 20/11 e altera três frentes: organização, gráfico embutido e execução remota.

      Stable
    • Claude Code 2.1.329

      O Claude Code 2.1.329 fecha o dia com uma publicação de correção ampla e três mudanças de comportamento que exigem leitura antes da atualização.

      Breaking change
Ver todas as 69 versões do Claude Code
Histórico de versões