A Anthropic lançou o Code Mode, um recurso experimental do Claude Code que muda a forma como o agente de programação usa suas ferramentas. Em vez de pedir uma chamada de cada vez — Bash, Read ou Edit — e ler o resultado antes de decidir o próximo passo, o Claude escreve um trecho de JavaScript que faz várias chamadas de uma vez, e o Claude Code executa esse código dentro da sessão. O recurso chegou na versão 2.1.323, em 12 de novembro de 2026, desligado por padrão.
Como o Code Mode funciona
Na prática, o usuário continua descrevendo a tarefa em linguagem natural. O Claude então escreve o código: um único script pode rodar comandos em paralelo, usar o resultado de uma chamada na seguinte e devolver só a parte da saída que o Claude precisa ler. Um exemplo da documentação é pedir para aumentar um limite de tentativas: o código localiza o arquivo, faz a edição e roda os testes, devolvendo o caminho do arquivo e a saída dos testes.
Na conversa, o usuário vê as chamadas de ferramentas — como o diff de uma edição — e não o código. Para ler o código escrito pelo Claude, basta pressionar Ctrl+O e abrir o visualizador de transcrição, onde cada trecho aparece como uma linha de código recolhida.
Quando usar
A Anthropic recomenda o Code Mode para tarefas com muitas chamadas relacionadas: uma mudança que se repete em vários arquivos, uma busca cujos resultados precisam ser filtrados antes de o Claude lê-los, ou vários comandos independentes que podem rodar ao mesmo tempo. A ideia é atacar um custo conhecido do agente: cada chamada de ferramenta exige uma resposta do modelo entre uma e outra, e agrupar as chamadas reduz essas idas e vindas.
Como ativar
Para ligar, basta iniciar o Claude Code com a variável de ambiente CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1. Também é possível definir o valor nas configurações do usuário (~/.claude/settings.json); com 0 em um dos dois lugares, o modo fica desligado. Organizações podem bloquear o recurso para todos os usuários por meio das configurações gerenciadas.
Requisitos e limites
O Code Mode exige o Claude Code 2.1.323 ou posterior, na build nativa, em uma sessão interativa de terminal, com uma assinatura do Claude ou conta no Console — e um dos modelos Opus 5.5, Sonnet 5.5, Haiku 5.5 ou Fable 5.2. Ele não funciona por gateways como Amazon Bedrock, Google Cloud, Microsoft Foundry ou Claude Platform on AWS, nem com -p, o Agent SDK, o painel do VS Code, o aplicativo de desktop ou sessões na nuvem. No Windows, é preciso ter o Git for Windows instalado.
Também há recursos indisponíveis enquanto o modo está ligado: Remote Control, Claude in Chrome e uso de computador. A sessão não pode ser movida para o aplicativo de desktop nem virar uma sessão em segundo plano, e o /fork não consegue iniciar uma cópia em segundo plano. Uma sessão do Code Mode só pode ser retomada no terminal, com o modo ligado.
Permissões e código de longa duração
Cada chamada feita pelo código do Claude continua passando pelas regras de permissão (deny e ask) e pelos hooks PreToolUse do usuário — não é preciso mudar regras para ferramentas como o Bash. No modo automático, um classificador revisa o código antes de ele rodar, e não cada chamada individual; por isso a documentação recomenda manter regras ou hooks para as chamadas que precisam de controle. Quem quiser auditar o código pode escrever um hook PreToolUse para a ferramenta REPL, que executa o JavaScript, e ler o código em tool_input.code.
Enquanto o código roda uma build ou um teste longo, o Claude espera ou deixa o código seguir em segundo plano: no aguardo, o código para após dez minutos; em segundo plano, pode rodar por até duas horas, desde que a sessão tenha começado no modo automático ou com bypassPermissions.
A versão 2.1.325, de 13 de novembro, já corrigiu os primeiros bugs do recurso, incluindo scripts que ignoravam um worktree e um caso em que o Claude começava a trabalhar sozinho depois que uma sessão era retomada. O recurso chega uma semana depois do Claude Code 2.1.319, que moveu as tarefas MCP para o segundo plano, como mostramos nesta matéria do Geekiki. A Anthropic deixa claro que o Code Mode é experimental e pode mudar ou ser removido em qualquer versão — a documentação oficial é a referência para o comportamento atual.
Como contexto, o Code Mode leva para o Claude Code uma ideia que a Anthropic já havia apresentado para a API em novembro de 2025, a chamada de ferramentas programática: em vez de o modelo pedir cada ferramenta separadamente, ele escreve código que orquestra as chamadas. A documentação do Code Mode não promete um número de economia — vale testar com as próprias tarefas antes de adotar o modo no dia a dia.
Crédito da imagem: logotipo do Claude, da Anthropic, via biblioteca de ícones LobeHub (lobe-icons).
Fontes
- Anthropic — Run tool calls from code with Code Mode (documentação oficial do Claude Code)
- Anthropic — Changelog oficial do Claude Code no GitHub
- i10X — Claude Code Code Mode: How It Works and What It Saves
- Agentic Feed — Claude Code Code Mode lets Claude call tools from JavaScript
- Geekiki — Claude Code 2.1.319 move tarefas MCP para segundo plano e endurece permissões
Nota de transparência: esta matéria foi produzida com auxílio de inteligência artificial, a partir de publicações públicas e fontes da internet, e revisada editorialmente. Consulte as fontes originais para confirmar as informações.
Por Muse