Pular para o conteúdo
Breaking change

Claude Code 2.1.323

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

Publicada em
Posição no histórico
2 de 71
Nesta página

Resumo

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. O recurso é opcional e pode ser desativado para a organização inteira. A publicação também cria uma faixa de versão para plugins, corrige a separação de perfis de autenticação entre sessões em segundo plano e altera comportamentos que afetam permissões de Bash, sandbox e plugins já instalados.

A edição é ampla e concentra correções na autenticação e nas permissões das ferramentas, além de mudanças no cliente MCP e no OpenTelemetry. Sessões remotas e a integração com o VS Code também recebem ajustes. Três mudanças exigem revisão antes da atualização: o cliente MCP v1 foi removido, a configuração subagentStatusLine deixou de existir e comandos de worktree falham em modo somente leitura dentro do sandbox.

Novidades

  • Claude Code 2.1.323 — Code Mode: o modo experimental permite que o modelo escreva JavaScript para chamar ferramentas. A ativação é opcional e feita pela documentação do recurso, com possibilidade de desativação para a organização inteira.
  • Claude Code 2.1.323 — Faixa de versão de plugins: o campo engines["claude-code"] em plugin.json define a faixa aceita. Plugins fora dela não são instalados, atualizados nem carregados. A instalação escolhe a versão mais nova compatível.
  • Claude Code 2.1.323 — Validação de plugins: claude plugin validate confere a tipagem do módulo TypeScript de hooks e lista os substantivos $ que um hook engine.create adiciona, retira ou substitui. As ocorrências aparecem como aviso. A opção --strict reprova a validação.
  • Claude Code 2.1.323 — Modo Auto no Desktop: a configuração gerenciada CLAUDE_CODE_AUTO_MODE_MODEL define o modelo usado pelo modo Auto em sessões do Claude Desktop com provedores de terceiros.
  • Claude Code 2.1.323 — Créditos de uso: quando o modelo solicita créditos desativados ou esgotados, aparece um menu com parar, trocar para créditos de uso ou atualizar o plano.
  • Claude Code 2.1.323 — Hooks longos: claude -p e sessões do SDK emitem um sinal de progresso a cada 30 segundos enquanto um hook demora, evitando que o host encerre o turno como travado.
  • Claude Code 2.1.323 — Artefatos: o upload de ativos do Artifact aceita arquivos .docx.
  • Claude Code 2.1.323 — Diagnóstico de plugins: a instalação emite aviso quando o servidor de linguagem do plugin não inicia, com o nome do servidor e o que conferir. O resultado JSON de claude plugin install inclui unsetOptionCount, com a quantidade de opções de userConfig ainda não definidas.
  • Claude Code 2.1.323 — Variáveis de sessão: CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES desativa os resumos de progresso de subagentes e as requisições que os gravam. CLAUDE_CODE_RESUME_HINT_COMMAND permite que o programa que inicia o Claude Code indique o próprio comando de retomada na mensagem de saída.

Melhorias

  • Claude Code 2.1.323 — Janela de contexto: um identificador de modelo não reconhecido assume 1 milhão de tokens, antes 200 mil. Use /autocompact para compactar mais cedo ou CLAUDE_CODE_DISABLE_1M_CONTEXT=1 para manter a janela anterior. Modelos de outros fornecedores com janela menor precisam dessa variável antes de encher a conversa.
  • Claude Code 2.1.323 — Credenciais internas: o ripgrep próprio e a maior parte dos comandos internos de Git rodam sem os tokens de login e as chaves de API da sessão. Um credential helper ou hook acionado por esses comandos deixa de encontrá-los.
  • Claude Code 2.1.323 — Permissões de Bash: a checagem fica mais estável em máquinas lentas e solicita aprovação para comandos que poderiam executar de forma diferente daquela verificada.
  • Claude Code 2.1.323 — Mensagens entre sessões: o limite de mensagens que uma sessão envia a outra na mesma máquina sobe de cerca de 20 para 100 mil, incluindo o envio a partir de uma aba de código do Claude Desktop.
  • Claude Code 2.1.323 — MCP: /mcp informa quantas ferramentas de um servidor ficaram de fora porque a API recusaria o schema de entrada, com o motivo. Um identificador de conector com erro de digitação indica a ferramenta correta quando o servidor foi registrado pelo aplicativo host.
  • Claude Code 2.1.323 — Subagentes: o transcript de um subagente concluído é liberado mais cedo da memória enquanto os seguintes executam.
  • Claude Code 2.1.323 — WebFetch: páginas com muitos níveis de aninhamento usam menos memória e respondem em menos tempo.
  • Claude Code 2.1.323 — OpenTelemetry: um exportador otlp com endpoint e sem OTEL_EXPORTER_OTLP_PROTOCOL usa http/protobuf. O envio ao coletor padrão em localhost:4318 respeita o proxy configurado. O tempo limite sobe para 25 segundos, também o máximo aceito por OTEL_EXPORTER_OTLP_TIMEOUT.
  • Claude Code 2.1.323 — Instalação e login: o script de instalação deixa de baixar a versão mais recente duas vezes. Erros de entrada em /login e claude setup-token informam o que aconteceu e o que conferir quando a requisição é recusada, inacessível ou expira.

Correções

  • Claude Code 2.1.323 — Perfis de autenticação: uma sessão em segundo plano não assume outro login quando o perfil Anthropic nomeado está ausente, alterado ou sobreposto. O caso encerra com aviso. O mesmo vale para sessões com chave de API, token de autenticação ou identidade de workload vindos do shell.
  • Claude Code 2.1.323 — Login e credenciais: chamadas de ferramenta MCP que terminam no erro do servidor de login, como TOKEN_EXPIRED, solicitam nova autenticação. claude auth logout também remove logins de servidores MCP e segredos de plugins. O comando /logout numa sessão em segundo plano encerra a sessão como no terminal.
  • Claude Code 2.1.323 — macOS e Desktop: o aviso “Not logged in” deixa de voltar logo depois de um /login bem-sucedido ou de uma renovação de token quando o keychain demora a responder. No Claude Desktop, um gateway que responde 403 a token expirado provoca solicitação de token novo e nova tentativa.
  • Claude Code 2.1.323 — Modo Auto indisponível: --permission-mode auto ou defaultMode: auto nas configurações inicia em Manual, que solicita aprovação, quando o modo Auto não está disponível.
  • Claude Code 2.1.323 — Permissões de Bash e sandbox: a checagem de rm considera a pasta correta e não omite o aviso de remoção perigosa. Permissões de autorização com curinga, como Bash(ls*), voltam a solicitar confirmação nos casos descritos. Uma permissão que nomeia variável, como Bash(NODE_ENV*), também pergunta. O sandbox não é desligado no meio da sessão.
  • Claude Code 2.1.323 — Permissões de leitura e escrita: uma permissão Read de recusa impede gravação por Write e Edit no mesmo caminho. Arquivos de plano não são mais gravados fora do projeto quando plansDirectory está definido. A gravação é recusada quando não é possível comprovar que fica dentro do projeto.
  • Claude Code 2.1.323 — Sessões e worktrees: ExitWorktree, o diálogo de saída e /resume preservam a pasta correta quando a pasta anterior à entrada no worktree foi removida. Transcripts de subagentes e resultados grandes de ferramentas permanecem no transcript da sessão.
  • Claude Code 2.1.323 — Memória e arquivos: editar um arquivo muito grande deixa de provocar pico de memória no prompt seguinte. Edit e Bash não estouram memória em arquivos de /proc, dispositivos e pipes nomeados.
  • Claude Code 2.1.323 — Interface: acentos e marcas combinantes deixam de aparecer à esquerda do texto, de duplicar caracteres na tela ou de desaparecer ao quebrar linha. A última tecla de um atalho composto respeita o campo do diálogo. A linha de status com várias linhas não é empurrada para fora da tela por um prompt longo.
  • Claude Code 2.1.323 — MCP e plugins: chamadas anteriores de MCP reaparecem na conversa retomada quando o servidor conecta tarde. Um marketplace com uma entrada malformada em renames deixa de ignorar as outras. Plugins com lista de versões em enabledPlugins explicam por que ficaram desativados.
  • Claude Code 2.1.323 — WebFetch e política: células vazias de tabela não deslocam os valores seguintes. A política da organização e CLAUDE_CODE_DISABLE_WEB_FETCH são conferidas a cada chamada.
  • Claude Code 2.1.323 — Sessões remotas: o Remote Control mantém a identidade da máquina por até 30 dias ao reiniciar na mesma pasta. Sessões de nuvem e Remote Control tentam reconectar sozinhas depois de falhas e exibem o motivo quando o computador está desconectado.
  • Claude Code 2.1.323 — Windows: comandos de leitura com curinga solicitam permissão. Quando existe um .cmd ou .bat ao lado do .exe na mesma pasta do PATH, a execução usa o .exe.
  • Claude Code 2.1.323 — Execução e transcrição: /compact não resume mais uma mensagem que o Claude ainda não respondeu. Gravar uma configuração numa sessão em execução não desfaz mais uma edição manual em settings.json. Um arquivo apagado durante a sessão permanece apagado.

Breaking changes

  • Claude Code 2.1.323 — Cliente MCP v1: o cliente MCP v1 foi removido. MCP_SDK_GENERATION=v1 executa o cliente v2 em modo de compatibilidade, com handshake anterior e verificações de login OAuth mais flexíveis.
  • Claude Code 2.1.323 — Configuração de subagentes: a configuração subagentStatusLine deixou de existir. As linhas de subagente usam a aparência padrão. Arquivos de configuração que ainda mantêm a chave continuam carregando, mas o ajuste não tem efeito.
  • Claude Code 2.1.323 — Worktrees no sandbox: git worktree add, move e remove falham em modo somente leitura no sandbox de macOS e Linux. O mesmo ocorre com commits num worktree no qual a sessão não foi iniciada ou autorizada. Execute esses comandos fora do sandbox.

Ponto de Atenção

Antes de atualizar, revise os plugins instalados, porque uma faixa engines incompatível impede a instalação e o carregamento, o que faz a atualização escolher a versão mais nova que atende à faixa declarada. Em organizações que usam o cliente MCP v1, confira os servidores e a variável MCP_SDK_GENERATION antes de trocar a versão.

Teste sugerido: numa sessão de homologação, confirme que o Code Mode continua desativado, instale um plugin com faixa de versão e outro fora dela e execute um comando de Bash que grave em .git para verificar a confirmação. Em seguida, confira /status para o protocolo do OpenTelemetry, retome uma sessão em segundo plano e observe se ela preserva o perfil de login. Numa máquina com worktrees, execute git worktree remove dentro e fora do sandbox.

Notas da versão

O release oficial do Claude Code 2.1.323 foi publicado em 12/11/2026 às 22h12 UTC, como versão estável. As notas descrevem o Code Mode como experimental e sujeito a ativação explícita. O release mantém a configuração agent de plugins com aviso na inicialização, em claude plugin list e em claude plugin validate, sem removê-la nesta versão.

Versões anteriores

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

      O Claude Code 2.1.319 muda o tratamento de ações que o modo automático não consegue verificar no servidor.

      Stable
    • Claude Code 2.1.318

      O Claude Code 2.1.318 corrige a preservação de configuração e autenticação em diretórios pessoais compartilhados pela rede.

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

Versões posteriores

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