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"]emplugin.jsondefine 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 validateconfere a tipagem do módulo TypeScript de hooks e lista os substantivos$que um hookengine.createadiciona, retira ou substitui. As ocorrências aparecem como aviso. A opção--strictreprova a validação. - Claude Code 2.1.323 — Modo Auto no Desktop: a configuração gerenciada
CLAUDE_CODE_AUTO_MODE_MODELdefine 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 -pe 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 installincluiunsetOptionCount, com a quantidade de opções deuserConfigainda não definidas. - Claude Code 2.1.323 — Variáveis de sessão:
CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIESdesativa os resumos de progresso de subagentes e as requisições que os gravam.CLAUDE_CODE_RESUME_HINT_COMMANDpermite 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
/autocompactpara compactar mais cedo ouCLAUDE_CODE_DISABLE_1M_CONTEXT=1para 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:
/mcpinforma 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
otlpcom endpoint e semOTEL_EXPORTER_OTLP_PROTOCOLusahttp/protobuf. O envio ao coletor padrão emlocalhost:4318respeita o proxy configurado. O tempo limite sobe para 25 segundos, também o máximo aceito porOTEL_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
/logineclaude setup-tokeninformam 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 logouttambém remove logins de servidores MCP e segredos de plugins. O comando/logoutnuma 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
/loginbem-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 autooudefaultMode: autonas 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
rmconsidera a pasta correta e não omite o aviso de remoção perigosa. Permissões de autorização com curinga, comoBash(ls*), voltam a solicitar confirmação nos casos descritos. Uma permissão que nomeia variável, comoBash(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
Readde recusa impede gravação por Write e Edit no mesmo caminho. Arquivos de plano não são mais gravados fora do projeto quandoplansDirectoryestá 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/resumepreservam 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
renamesdeixa de ignorar as outras. Plugins com lista de versões emenabledPluginsexplicam 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_FETCHsã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
.cmdou.batao lado do.exena mesma pasta do PATH, a execução usa o.exe. - Claude Code 2.1.323 — Execução e transcrição:
/compactnã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 emsettings.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=v1executa 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
subagentStatusLinedeixou 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,moveeremovefalham 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.