Claude Code 2.1.302 inicia execuções headless em fornecedores de terceiros no modo de permissão predefinido

A nossa leitura: nunca deixe o modo de permissão de um trabalho sem supervisão ao critério de uma predefinição. O Claude Code 2.1.302 muda essa predefinição para execuções headless e do Agent SDK em fornecedores de terceiros. Defina o modo explicitamente em cada script agora e a próxima mudança de predefinição não lhe toca. O Claude Code mantém-se Condicional no nosso diretório: é uma mudança de configuração para absorver, não uma razão para repensar a ferramenta.

O que aconteceu

A Anthropic lançou o Claude Code 2.1.302 a 16 de outubro de 2026. Duas alterações da versão mudam o comportamento das execuções por script.

A predefinição de permissões

Do changelog: «Alterado: as sessões claude -p e do Agent SDK sem modo de permissão passam a iniciar no modo default em fornecedores de terceiros, com a telemetria desligada ou numa instalação nova; --permission-mode auto mantém o modo automático».

Subagentes fork em todo o lado

«Alterado: os subagentes fork (subagent_type: "fork") passam a estar ativos por predefinição no claude -p, no Agent SDK, na aplicação de desktop e no VS Code, como já estavam no terminal; CLAUDE_CODE_FORK_SUBAGENT=0 desativa-os, e o claude mcp serve nunca os oferece».

A mesma versão faz com que a aplicação de desktop e o VS Code corram sempre os subagentes da conversa principal em segundo plano, como o terminal faz. As chamadas Agent do próprio subagente no claude -p, no Agent SDK, na aplicação de desktop e no VS Code correm agora em primeiro plano por predefinição.

Também na 2.1.302

• Hooks de prompt e de agente: «no máximo 12 de um evento correm ao mesmo tempo; os restantes esperam pela sua vez».
• CLAUDE_CODE_AUTO_MODE_MODEL escolhe o modelo para o classificador do modo automático do lado do cliente. Não muda o modelo do modo automático do lado do servidor.
• Uma linha Idle compaction em /config desliga ou religa a compactação por inatividade.
• /design-sync e /design-login avisam agora que o Claude Design autónomo (claude.ai/design) «encerra até 14 de dezembro de 2026».

Porque importa

A mudança de permissões atinge uma população específica: trabalhos num fornecedor de terceiros que nunca definem um modo e correm com a telemetria desligada ou a partir de uma instalação nova. A documentação de modos de permissão da Anthropic explica porquê: antes da 2.1.302, as execuções que não obtinham os feature flags (num fornecedor de terceiros, ou com DISABLE_TELEMETRY) podiam arrancar em modo automático. Agora arrancam em modo Manual, que aparece como default nas opções do SDK e nas definições. Uma execução headless nesse modo não pergunta: as chamadas que precisam de aprovação são recusadas, a menos que uma regra de permissão, um hook, um callback canUseTool ou --permission-prompt-tool as aprove. Um pipeline sem supervisão que contava com o antigo comportamento automático pode falhar sem qualquer alteração ao seu próprio código.

Os subagentes fork a passarem a estar ativos por predefinição no claude -p e no Agent SDK significam que uma execução headless pode agora gerar forks que antes não gerava por predefinição. Se o seu trabalho orçamenta tokens ou tempo com margem apertada, é uma mudança de comportamento que vale a pena verificar.

O que muda para si

• Headless ou SDK num fornecedor de terceiros: passe --permission-mode em cada trabalho (--permission-mode auto mantém o modo automático), ou aprove chamadas específicas com regras de permissão como --allowedTools "Bash(npm test)" (o SDK tem uma opção equivalente de ferramentas permitidas).
• Não quer forks fora do terminal: defina CLAUDE_CODE_FORK_SUBAGENT=0.
• Utilização intensiva de hooks: conte que os hooks de prompt e de agente além de 12 por evento fiquem em fila.
• Utilizadores do Claude Design autónomo: exporte o que lá guarda antes de 14 de dezembro de 2026.

FAQ

Isto afeta execuções contra a API da própria Anthropic?

O changelog da 2.1.302 limita a mudança a fornecedores de terceiros, com a telemetria desligada ou numa instalação nova. A documentação de modos de permissão da Anthropic diz que as execuções claude -p e do Agent SDK sem modo definido arrancam em default na 2.1.302 ou posterior, por isso defina o modo explicitamente onde quer que corra.

Como manter o modo automático em trabalhos headless?

Passe --permission-mode auto explicitamente; o changelog afirma que mantém o modo automático.

Posso desativar os subagentes fork?

Sim. CLAUDE_CODE_FORK_SUBAGENT=0 desativa-os, e o claude mcp serve nunca os oferece.