Blogue

Modo automático no Claude Code: verificações gratuitas e aviso de sessão não elegível

Markdown

A partir da versão 2.1.278, o Claude Code não cobra pelas verificações de segurança do modo automático no servidor. O que significa «esta sessão não é elegível» e como verificar o estado.

Ler o artigo completo

Se o aviso «Estamos a alterar o modo automático para deixar de cobrar os pedidos do classificador no Claude Code. No entanto, esta sessão não é elegível» aparecer no terminal do Claude Code (na versão russa: «Estamos a alterar o modo automático para que os pedidos do classificador no Claude Code deixem de ser cobrados. No entanto, esta sessão não é elegível»), não se trata de um erro. A partir da versão 2.1.278, por predefinição, o Claude Code pede ao servidor que efetue as verificações de segurança do modo automático e não cobra por elas. Mas isto só funciona quando as verificações do lado do servidor chegam à sessão. Quando o Claude Code passa a usar os seus próprios pedidos do classificador, avisa-o, e as verificações voltam a ser cobradas como antes.

Documentação da Ailoot: API, chaves e configuração da ligação.

O que mudou no modo automático

No modo automático, um classificador verifica as ações antes de estas serem executadas: por exemplo, comandos da shell e pedidos de rede. Os pedidos do classificador do próprio Claude Code são cobrados como utilização normal de tokens, tal como acontecia antes da versão 2.1.278.

A partir da versão 2.1.278, por predefinição, o Claude Code pede ao servidor que efetue as verificações no âmbito dos pedidos que a sessão já está a enviar ao modelo. As verificações efetuadas pelo servidor não são cobradas. A mesma versão adicionou uma linha Auto mode server ao comando /status: mostra se o classificador desta sessão está a ser executado no servidor.

Quem é afetado:

  • Planos Enterprise e contas Claude API — as verificações do lado do servidor são pedidas por predefinição.
  • Claude Platform na AWS, Amazon Bedrock, Agent Platform da Google Cloud, Microsoft Foundry — também por predefinição, mas a disponibilidade das verificações do lado do servidor depende de a funcionalidade estar ativada na plataforma e região específicas.
  • Pro, Max, Team — segundo a documentação da Anthropic, o aviso nunca aparece nestes planos.

Existe uma restrição separada, sem relação com a faturação: no Bedrock, na Agent Platform da Google Cloud, no Foundry e nas sessões da gateway das aplicações Claude com sessão iniciada, o modo automático só funciona com Claude Sonnet 5, Opus 4.7 e modelos mais recentes, e com a família Fable.

O modo de permissões é uma das definições que determina o comportamento do agente no seu projeto: o que faz por iniciativa própria e o que requer confirmação. Se cria projetos regularmente no Claude Code, verifique se as definições de permissões correspondem às tarefas do projeto.

Porque é que as verificações do lado do servidor não chegam à sessão

Segundo a documentação, a causa mais comum é uma gateway de LLM ou um proxy entre o Claude Code e a API. O problema ocorre se esse intermediário remover ou reescrever cabeçalhos dos pedidos, descartar campos que não reconhece ou alterar respostas: por exemplo, reescrever IDs ou remover chaves de eventos de transmissão em fluxo. Nesse caso, o servidor não recebe o pedido de verificação ou o Claude Code não recebe o resultado, e a sessão passa a usar o classificador do próprio Claude Code, cujos pedidos continuam a ser cobrados como antes. Se o Claude Code conseguir identificar a gateway, o aviso indica o respetivo nome.

A segunda causa é a indisponibilidade das verificações do lado do servidor para a plataforma, região ou credenciais da sessão. Se não houver uma gateway ou um proxy na cadeia, mas o aviso aparecer repetidamente, a documentação aponta esta como a causa provável.

O modo automático continua a funcionar. O aviso só aparece quando as verificações do lado do servidor deixam de chegar à sessão durante o resto da sua duração, o que pode acontecer logo na primeira ação sujeita a verificação. Uma ação individual que o servidor não consiga verificar não desencadeia o aviso: o Claude Code verifica-a por si e volta a contactar o servidor no pedido seguinte.

O que premir quando vir o aviso

O aviso pausa a ação até responder:

  • Enter — continuar. A ação pausada e o resto da sessão passam a usar o classificador do próprio Claude Code, e os respetivos pedidos continuam a ser cobrados como utilização de tokens. Depois de premir Enter, o aviso não volta a aparecer nesta sessão. Se indicar uma gateway, ao confirmar o aviso este fica oculto nesta máquina durante 24 horas. Se não indicar nenhuma gateway, o aviso volta a aparecer quando a sessão seguinte passar novamente a usar o seu próprio classificador.
  • Esc ou Ctrl+C — cancelar. A ação pausada não é executada, o turno atual termina e a sessão permanece no modo automático. A sua resposta não é memorizada, pelo que o aviso volta a aparecer antes da ação seguinte que precise de ser verificada.

Se quiser sair do modo automático, mude o modo de permissões com Shift+Tab depois de responder.

Quando não for possível aguardar uma resposta, o Claude Code apresenta o mesmo texto e continua no modo automático. A exceção é quando um aviso sobre uma gateway já foi confirmado nesta máquina nas últimas 24 horas: o texto não é apresentado. No modo não interativo com a opção -p, o texto é escrito no fluxo de erro (stderr); no resultado stream-json, surge como um aviso do sistema que as aplicações que utilizam o Agent SDK podem ler a partir do fluxo de mensagens. Na extensão do VS Code, a mensagem aparece numa caixa de diálogo e não requer confirmação.

Como verificar o estado

Pode verificar onde o classificador está a ser executado neste momento sem esperar pelo aviso. Execute /status numa sessão que esteja a usar o modo automático e procure a linha Auto mode server:

  • Enabled — o servidor continua a verificar as ações da sessão;
  • Disabled — a sessão já passou a usar o classificador do próprio Claude Code.

O que fazer se a causa for a gateway

A documentação descreve duas opções de configuração.

  1. Peça ao administrador da empresa ou ao fornecedor da gateway que encaminhe os pedidos e as respostas sem os alterar. Os cabeçalhos e os campos do corpo dos pedidos, incluindo os que a gateway não reconhece (como o campo safeguards), têm de ser encaminhados tal como estão. As respostas e os eventos de transmissão em fluxo têm de ser devolvidos sem remover chaves como safeguard_results nem reescrever IDs de chamadas a ferramentas. Consulte o guia de compatibilidade de gateways para obter mais informações. Depois disso, as novas sessões voltarão a usar as verificações do lado do servidor.
  2. Desative os pedidos de verificações do lado do servidor se já souber que a gateway não os suporta. Defina a variável antes de iniciar a sessão, na shell ou através da chave env nas definições do Claude Code:
export CLAUDE_CODE_AUTO_MODE_SERVER=0

O Claude Code passa então a usar sempre o seu próprio classificador, os respetivos pedidos voltam a ser cobrados como antes e o aviso não aparece. Esta variável não é lida quando a ligação é feita diretamente à API da Anthropic. Se CLAUDE_CODE_AUTO_MODE_SERVER não estiver definida, mas CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 estiver, as verificações do lado do servidor também ficam desativadas. A documentação descreve CLAUDE_CODE_AUTO_MODE_SERVER como uma definição temporária que poderá ser removida numa versão futura, por isso convém voltar a verificá-la após as atualizações.

Se não for responsável pela gateway e não a puder configurar, pode contactar o fornecedor da gateway ou escolher a segunda opção.

Se não houver uma gateway, mas o aviso aparecer

Se não houver nenhuma gateway ou proxy na cadeia, mas o aviso voltar a aparecer, a causa provável, segundo a documentação, é que as verificações do lado do servidor ainda não estão disponíveis para a sua plataforma, região ou credenciais. Pode confirmar com o suporte ou com o administrador da empresa, ou comunicar o problema com o comando /feedback.

E agora?

Não precisa de configurar nada antecipadamente: quando o aviso aparece, o modo automático continua a funcionar e os pedidos do classificador continuam a ser cobrados como antes. Se o aviso aparecer, responda (Enter ou Esc) e verifique /status. Se necessário, pode configurar a gateway, desativar os pedidos de verificações do lado do servidor ou contactar o suporte.

Leia sobre outras causas da utilização de tokens em «Para onde vão os tokens no Claude Code» e «Como evitar gastar rapidamente os limites do Claude Code». E saiba aqui como reduzir o código desnecessário nas respostas do modelo e, assim, poupar tokens.

Fontes

Se precisar de acesso a modelos de IA através da Ailoot, espreite a Ailoot.

Mais detalhes

Perguntas frequentes

Premir Esc desativa o modo automático?

Não. Esc ou Ctrl+C cancela a ação em pausa e termina o turno atual; a sessão continua no modo automático. Mude o modo de permissões com Shift+Tab depois de responder se quiser sair dele.

Como distingo verificações do servidor de pedidos pagos ao classificador?

Execute /status numa sessão automática e consulte Auto mode server. Enabled significa verificações do servidor ativas; Disabled significa passagem para pedidos do classificador do próprio Claude Code, cobrados em tokens.

Todos os artigos