Resumo
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. A publicação também corrige uma falha de segurança na decodificação de respostas comprimidas com zstd e reúne um conjunto amplo de correções em autenticação, permissões, MCP e integração com o VS Code.
A edição mexe em pontos que automações sentem, como permissões de Bash, carregamento de plugins e skills aninhadas. O restante das mudanças atinge a retomada de sessões, o tratamento de tarefas MCP e a mensagem de erros de login. O VS Code recebe sugestões de prompt, login do Console sem chave de API e correções no seletor de modelo.
Novidades
- Claude Code 2.1.325 — Dica de notebook: depois de ler ou editar um notebook Jupyter, o VS Code e terminais integrados equivalentes mostram uma dica para reexecutar a célula, exibida uma vez.
- Claude Code 2.1.325 — Requisição barrada pela política: a mensagem de erro ganha uma linha com a continuação possível, que é rodar
/rewinde alterar a mensagem ou rodar/clear. - Claude Code 2.1.325 — Arquivos protegidos no sandbox: quando um
git checkout,git stashou autostash pull dentro do sandbox não consegue atualizar arquivos protegidos, como os de.claude, Claude recebe uma nota sobre a condição. - Claude Code 2.1.325 — Sugestões de prompt no VS Code: a extensão mostra as sugestões onde o terminal já mostra, e
Tabaceita a próxima sugestão.promptSuggestionEnabled: falsedesativa o recurso. - Claude Code 2.1.325 — Login do Console no VS Code: a extensão cria um login que não gera chave de API.
- Claude Code 2.1.325 — Login de MCP no VS Code: janelas em SSH, WSL e container ganham um campo para colar a URL de redirecionamento ao entrar num servidor MCP.
Melhorias
- Claude Code 2.1.325 — Subagentes no limite de tokens: um subagente interrompido no limite de saída recebe nova solicitação da resposta inteira, mais breve, em vez de devolver apenas o final.
- Claude Code 2.1.325 — Início com login sem chave: um token ainda válido é lido sem esperar o lock de credenciais.
- Claude Code 2.1.325 — Identidade em scripts: a verificação do e-mail de login também recusa o seu e-mail como identidade do cliente em scripts executados por comando, gravações de arquivo, buscas web e chamadas MCP.
- Claude Code 2.1.325 — Aviso de plugins: as confirmações de marketplace, as recomendações e o aviso de instalação dizem que plugins executam código no computador, com acesso a arquivos e shell.
- Claude Code 2.1.325 — Erro de login no Desktop:
claude --desktopnomeia a chave de API, o provedor ou a configuração que impede o login da conta Claude. - Claude Code 2.1.325 — Tarefas MCP: Claude sabe quando uma tarefa espera resposta e pode indicar
/taskscomo caminho. - Claude Code 2.1.325 — Remote Control:
claude remote-controlsai com status 4 quando para sozinho e com 69 quando não consegue registrar, para que um gerenciador de serviço possa reiniciá-lo. Execuções de sessão única continuam saindo com 0. - Claude Code 2.1.325 — Janela de contexto por variável:
CLAUDE_CODE_MAX_CONTEXT_TOKENSdefine também a janela de modelos não reconhecidos que começam comclaude-, como oclaude-sonnet-latestde um gateway. - Claude Code 2.1.325 — Privacidade no login:
/loginpergunta permissão antes de alterar as configurações de privacidade. - Claude Code 2.1.325 — Custo de mods:
/cost,$.session.usage(),--max-budget-usde as métricas de custo e tokens incluem as chamadas$.model.completee$.model.classifyde um mod. - Claude Code 2.1.325 — Programas internos do sandbox: a ponte de rede e os demais programas que o Claude Code inicia rodam sem os tokens de login e as chaves de API no ambiente.
- Claude Code 2.1.325 — Credenciais da chave mTLS: ripgrep, comandos locais de Git e os helpers do sandbox rodam sem a senha da chave de cliente mTLS no ambiente.
- Claude Code 2.1.325 — Reconexão do Remote Control:
/resumee/teleportdesconectam antes quando a sessão conectada tem link de compartilhamento ou quando isso não pode ser verificado. - Claude Code 2.1.325 — Sessões hospedadas: Claude Code na web, tarefas agendadas na nuvem e sessões de Cowork iniciam mesmo com
sandbox.failIfUnavailable, porque o container hospedado não tem sandbox de comando. - Claude Code 2.1.325 — Primeira execução sem cache:
claude -psem cache da informação de login espera esse preenchimento antes da primeira requisição, o que pode atrasar alguns segundos a estreia num ambiente limpo. - Claude Code 2.1.325 — Pasta temporária: as instruções orientam Claude a manter fora da pasta de rascunho temporário os arquivos que você vai querer guardar.
- Claude Code 2.1.325 — Marketplace por commit: o
refdo marketplace aceita o identificador completo de qualquer commit de branch ou tag. Clientes anteriores a esta versão não clonam esse pino, e um marketplace fixado assim para de carregar neles. - Claude Code 2.1.325 — Proxy de marketplace: downloads de marketplace e de plugin usam túnel CONNECT quando
ALL_PROXYé o único proxy definido. Um proxy que recusa CONNECT falha nesses downloads. - Claude Code 2.1.325 — Configuração local em container:
-pe execuções do SDK em worktree ou submódulo montado em container aplicam diretivas de allow de.claude/settings.local.jsonsomente depois que a pasta é confiável. - Claude Code 2.1.325 — Runner auto-hospedado: uma sessão cuja pasta ou caminho de repositório é link simbólico é recusada, exceto o checkout de um hook
checkout.
Correções
- Claude Code 2.1.325 — Segurança na decodificação: a falha na leitura de respostas comprimidas com zstd é corrigida.
- Claude Code 2.1.325 — Git em worktrees especiais:
/security-reviewe os comandos git inline das skills deixam de falhar em worktrees de repositórios bare, em checkouts com--separate-git-dire em checkouts dorepodo Android. - Claude Code 2.1.325 — Subagentes: um subagente com modelo próprio permanece no modelo definido quando a configuração é
opusplanouhaiku, e a leitura de arquivos e os resultados MCP usam o modelo do subagente, não o da sessão principal. - Claude Code 2.1.325 — Gateways e Foundry: sessões em gateways de terceiros e no Foundry continuam o turno com compactação em vez de parar com erro de comprimento de janela.
- Claude Code 2.1.325 — Sessão retomada: turnos recentes deixam de sumir de uma sessão retomada depois de uma saída sem encerramento limpo.
- Claude Code 2.1.325 — Pasta de trabalho removida: um comando de shell na pasta de lançamento apagada falha com mensagem e pode ser reenviado, em vez de rodar no diretório errado.
- Claude Code 2.1.325 — Plano em
plansDirectory: quando a pasta configurada não aceita a edição aprovada, o plano é gravado na pasta padrão e um aviso informa onde e por quê. - Claude Code 2.1.325 — Modelo salvo: uma configuração
sonnet[1m]não é mais reescrita, numa instalação nova, para um identificador que a API recusa. - Claude Code 2.1.325 — Interface do terminal: a visão de foco mantém a resposta de uma tarefa agendada, o prompt de um subagente em segundo plano aparece, opções longas não são sobrescritas ao quebrar linha, avisos de inicialização fora da tela não são marcados como vistos e o cabeçalho de boas-vindas não mostra caracteres de controle.
- Claude Code 2.1.325 — Comandos manuais: o erro vermelho de um comando que só você pode executar ganha uma linha discreta dizendo que ele roda apenas quando digitado no prompt.
- Claude Code 2.1.325 — Estatísticas e relatórios:
/statsdeixa de somar um dia a mais em dias ativos, e/insightsnão anuncia relatório pronto quando nenhuma sessão se qualifica. - Claude Code 2.1.325 — Voz e IDE:
/voiceinforma o que mantém o modo como está, e o diálogo de boas-vindas do IDE mostra Cmd+Esc apenas onde o atalho corresponde. - Claude Code 2.1.325 —
claude purgeeplugin eval:claude purgedeixa de travar sem terminal disponível, eclaude plugin eval --output-dir ''termina com erro em vez de gravar o relatório na pasta atual. - Claude Code 2.1.325 — Saída de texto:
claude -pnum terminal deixa de emitir sequências de controle que não sejam de estilo de texto. Pipes e arquivos continuam iguais. - Claude Code 2.1.325 — Arquivos de lock: arquivos
.oauth_refresh.lock.owner.tmp.*deixam de se acumular na pasta de configuração, eclaude auth statusnão deixa mais um lock que atrasa a sessão seguinte. - Claude Code 2.1.325 — Login:
/logincom Esc logo depois da etapa do navegador não substitui o login existente, a tela de sucesso não aparece quando o login falha ou é cancelado, e/faste/modeldeixam de atribuir à organização restrições que o Claude Code não conseguiu verificar. - Claude Code 2.1.325 — Sessões em segundo plano: uma sessão iniciada no login do claude.ai deixa de usar e cobrar a chave de API ou o token do shell, e mudanças de login em segundo plano são recusadas com uma mensagem sobre o que funciona.
- Claude Code 2.1.325 — Bedrock e credenciais: o cálculo de tokens no Amazon Bedrock não envia a conversa quando
allowedProvidersnão permite, e helperscredential_processda AWS e credenciais padrão do Google Cloud funcionam sem a variávelHOME. - Claude Code 2.1.325 — Permissões: o modo de permissão anterior é mantido depois da aprovação do plano de um subagente, um valor inválido em
applyFlagSettings()não descarta os ajustes anteriores, e diretivas relativas de recusa continuam valendo nas pastas adicionadas depois de umcd. - Claude Code 2.1.325 — Permissões de Bash: comandos compostos que escapavam da checagem exigem permissão, e uma diretiva de allow não executa mais um programa diferente do nomeado.
- Claude Code 2.1.325 — Permissões de plugin: diretivas
mcp__plugin_*_respeitam a caixa usada no nome do servidor e da ferramenta, e diretivas de recusa valem também para aprovações que chegam depois de um reinício em runner auto-hospedado e emclaude remote-control. - Claude Code 2.1.325 — Configuração local commitada: um
.claude/settings.local.jsoncommitado não é tratado como configuração pessoal quando a sessão começa em certas subpastas do repositório. - Claude Code 2.1.325 — Artifacts: leituras do próprio artifact não exigem permissão prévia, diretivas de recusa e de confirmação da ferramenta Artifact valem em sessões na nuvem, e o modo Auto deixa de julgar apenas a primeira alteração de uma página visível fora da organização.
- Claude Code 2.1.325 — Code Mode: scripts respeitam o worktree aberto com
EnterWorktree, não gravam caminhos com~dentro do projeto e não mantêm no/mcpum servidor cuja autenticação expirou. Palavras digitadas junto com um Yes chegam ao Claude. - Claude Code 2.1.325 — Sessão retomada no Code Mode: Claude deixa de começar a trabalhar sozinho quando você retoma uma sessão encerrada durante um script, e espera o próximo prompt.
- Claude Code 2.1.325 — OpenTelemetry: o evento
user_prompté emitido também para mensagem enviada durante chamadas de ferramenta, comdelivery.mode: "mid_turn"e oprompt.iddo turno em execução. - Claude Code 2.1.325 — MCP:
/mcpdeixa de listar servidor removido por recarga de plugin, um servidor cuja renovação de token foi recusada por um instante sai do estado de autenticação pendente, solicitações de elicitation não são canceladas em modo headless e chamadas do SDK não respondem mais “Not connected” depois de uma reconexão. - Claude Code 2.1.325 — Tarefas MCP: uma tarefa travada depois do Esc volta ao estado de espera e Enter em
/tasksmostra a pergunta de novo. Tarefas em segundo plano continuam atualizando depois de uma reconexão e não abrem pergunta sobre um rascunho em digitação. - Claude Code 2.1.325 — Desktop e SDK: servidores MCP locais da pasta deixam de aparecer como adicionados pelo host ou de sumir depois de mover a pasta e de um início preaquecido, e servidores WebSocket locais conectam.
- Claude Code 2.1.325 — Worktrees e sparse:
worktree.sparsePaths, clones esparsos de plugin e de marketplace preservam os arquivos da raiz do repositório em versões antigas do git, como a 2.34, e o sandbox protege os ajustes e hooks de um worktree e a pasta git compartilhada. - Claude Code 2.1.325 — Runners e sessões remotas: um runner auto-hospedado com vários repositórios usa um repositório adicionado no meio da sessão, e o Desktop de terceiros sai do estado “Stopping” quando a renovação de token termina.
- Claude Code 2.1.325 — Windows: um início de sessão deixa de travar por cerca de um segundo quando uma entrada do PATH fica numa pasta sem permissão, e
/resumeencontra sessões cuja pasta foi gravada com outra caixa na letra da unidade ou com barras diferentes. - Claude Code 2.1.325 — Linux: comandos de Bash no sandbox deixam de falhar com
bwrap: Can't create filequando a pasta de trabalho fica abaixo de uma pastaallowReaddentro dedenyRead, como numa home com link simbólico. - Claude Code 2.1.325 — VS Code: o seletor de modelo acompanha a troca feita em outra sessão ou pelo Remote Control, o seletor de esforço respeita o limite da organização, a tela de login não oferece provedores recusados por
allowedProviderse o prompt de MCP explica o motivo da checagem de segurança. - Claude Code 2.1.325 — Claude Code na web: descrições de ferramentas MCP carregadas por busca de ferramentas não são mais truncadas em 4.096 caracteres e usam o limite de 16.384 das outras sessões.
- Claude Code 2.1.325 — Claude Tag: links de artifact colados no Slack geram cartão simples quando o login do autor expirou num workspace que a organização não administra.
Breaking changes
- Claude Code 2.1.325 — Bash no sandbox: comandos dentro do sandbox seguem o fluxo normal de permissão por padrão. Automações que dependiam de execução sem confirmação precisam definir
sandbox.autoAllowBashIfSandboxed: true, inclusive na fonte de configuração gerenciada de maior precedência quando ela liga o sandbox. - Claude Code 2.1.325 — Git somente leitura: comandos de leitura em repositório que não é o do projeto ou um repositório confiável exigem confirmação. Para executá-los sem prompt, nomeie o repositório com
--add-dir, não com a configuraçãoadditionalDirectories. - Claude Code 2.1.325 — Plugins gerenciados:
pluginDigestsfica obsoleto e é ignorado. Plugins de marketplace remoto declarados, habilitados e listados emprependPluginsouappendPluginspelas configurações gerenciadas valem como plugins da organização. - Claude Code 2.1.325 — Skills aninhadas: pastas
.claude/skillsdentro de plugins carregados por--plugin-dirnão carregam mais a partir de uma sessão iniciada acima da pasta do plugin. Inicie o Claude Code na pasta do plugin.
Ponto de Atenção
A revisão de permissões vale para qualquer fluxo não assistido: tarefas agendadas, /loop, runners auto-hospedados e automações que executam Bash no sandbox. Tarefas agendadas e /loop também perguntam antes de rodar uma skill que declara allowed-tools ou hooks, e a entrada Skill(name) em permissions.allow libera a execução sem acompanhamento.
Teste sugerido: numa sessão de homologação com sandbox ativo, execute um comando de Bash e confirme a solicitação de permissão. Repita com sandbox.autoAllowBashIfSandboxed: true e confira a execução sem prompt. Depois rode uma tarefa agendada que usa uma skill com allowed-tools e verifique a confirmação antes de rodar a skill.
Notas da versão
O release oficial do Claude Code 2.1.325 foi publicado em 13/11/2026 pelo calendário UTC como versão estável.