Claude Code 2.1.330: login pelo Enterprise Admin Console que aplica o gateway da organização, /loop de 30 dias e retry de max_tokens
O Claude Code 2.1.330 adiciona login na organização pelo Enterprise Admin Console, que aplica as configurações corporativas e direciona requisições ao provedor cloud ou gateway da organização; amplia o /loop e as tarefas recorrentes para 30 dias enquanto a sessão permanecer ativa e restaura o retry automático de max_tokens atrás de gateways. Veja como verificar seu endpoint ativo, conectar via BetterToken ou pelas rotas da Anthropic, controlar os gráficos do easel e separar as mudanças reais da 2.1.330 de rumores de terceiros.
Conteúdo

O Claude Code 2.1.330 foi lançado em 20 de novembro de 2026 e muda o comportamento de gateways corporativos, agendamentos prolongados de /loop e retries de max_tokens. Esta atualização afeta equipes que adotam o login pelo Enterprise Admin Console, desenvolvedores que roteiam o Claude Code por um gateway personalizado com ANTHROPIC_BASE_URL e quem executa tarefas agendadas de vários dias. Depois de rodar claude update e confirmar a versão 2.1.330 com claude --version, inicie claude e execute /status para verificar qual endpoint e qual fonte de credenciais estão ativos antes de começar novas tarefas.
Escolha como conectar o Claude Code 2.1.330
Defina um único caminho de conexão antes de editar arquivos locais para evitar conflito entre credenciais. Para uma comparação mais ampla entre assinatura e cobrança por API, leia nosso guia sobre assinatura do Claude Code vs. cobrança por API.
| Rota | Requisitos | Unidade de cobrança | Escopo documentado de cliente e recursos | Quando escolher |
|---|---|---|---|---|
| Gateway de API pré-pago/sob demanda (BetterToken) | Conta BetterToken e API Key; não exige envio de conta claude.ai | Pay-as-you-go conforme a unidade de cobrança atual do modelo; o saldo pago adquirido não zera mensalmente | Claude Code CLI (~/.claude/settings.json) e extensão do VS Code (claudeCode.environmentVariables) via Anthropic Messages (https://bettertoken.ai); Remote Control, entrada de voz e easel não estão disponíveis | Você quer acesso pay-as-you-go ao Claude e a outros modelos sem manter seu próprio gateway nem contratar um plano Enterprise |
| Login pelo Enterprise Admin Console | Participação em organização Enterprise, opção ativada por um Owner, claude 2.1.330+ (além da extensão do VS Code atualizada, se usada) e acesso à nuvem ou ao gateway da organização | Depende do provedor (cobrança feita pelo provedor cloud ou pela conta de gateway da organização) | Aplica as configurações Desktop 3P e o provedor de Connection da organização no terminal e no VS Code; Remote Control, sessões na nuvem, modo de voz e conectores do claude.ai não estão disponíveis | Sua organização já gerencia conexões do Claude Desktop no Enterprise Admin Console e quer parar de distribuir managed-settings.json |
| Gateway LLM auto-hospedado ou provedor cloud | Proxy operado pela equipe ou conta na AWS, Google Cloud ou Azure, além das credenciais do gateway ou da nuvem | Depende do provedor (conforme a cobrança do seu provedor cloud ou do gateway upstream) | Claude Code via ANTHROPIC_BASE_URL ou variáveis de provedor (CLAUDE_CODE_USE_BEDROCK=1, CLAUDE_CODE_USE_VERTEX=1); o escopo de recursos depende do gateway ou do provedor | Requisitos de conformidade exigem registro interno de tráfego, limites próprios de gasto ou faturamento em nuvem |
| Assinatura direta do claude.ai ou Claude Console | Conta claude.ai Pro, Max, Ultra, Team ou Enterprise, ou conta convidada no Claude Console | Plano de assinatura ou cobrança do Claude Console | Planos de assinatura oferecem recursos vinculados à conta claude.ai, como easel (macOS e Linux fora do WSL), Remote Control e entrada de voz | Você quer recursos hospedados pela Anthropic sem camada personalizada de gateway |
Conecte o Claude Code 2.1.330 pela BetterToken
A BetterToken oferece um endpoint Messages compatível com a Anthropic (https://bettertoken.ai) para o Claude Code e lista os modelos Claude atuais (claude-sonnet-5-5, claude-opus-5-5, claude-haiku-5-5 e claude-fable-5-2) em 2026-11-21. Consulte os preços atuais para tarifas vigentes e regras de cache. O acesso via API é separado de uma assinatura do claude.ai, portanto Remote Control, entrada de voz e easel continuam indisponíveis.
Crie uma API Key no seu workspace da BetterToken. Remova credenciais concorrentes antes de testar para impedir que o Claude Code herde outro login: se você já fez login no claude.ai antes, execute /logout dentro do Claude Code, limpe ANTHROPIC_API_KEY e abra uma sessão interativa no Bash sem exibir o segredo na tela:
unset ANTHROPIC_API_KEY
read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export ANTHROPIC_AUTH_TOKEN="$BETTERTOKEN_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
claude
Não adicione /v1 ao final de ANTHROPIC_BASE_URL; o Claude Code acrescenta /v1/messages automaticamente. Dentro dessa sessão, execute /status e confirme duas linhas: Anthropic base URL deve exibir https://bettertoken.ai, e a linha de autenticação deve mostrar ANTHROPIC_AUTH_TOKEN em vez de um login de conta claude.ai. Se o Claude Code avisar na inicialização sobre duas fontes de credenciais, execute /logout para manter apenas sua API Key da BetterToken. Depois de sair da sessão interativa, execute claude -p "Reply with only: OK" no mesmo shell; uma resposta simples OK sem erro 401, de conexão ou de modelo confirma que a conexão verificada conclui requisições.
Para salvar essa configuração de forma permanente, siga o guia de configuração da BetterToken para Claude Code ou veja a visão geral da API do Claude Code. No macOS ou Linux, execute o script automático (curl -fsSL "https://www.bettertoken.ai/install-claudecode-provider.sh" | bash), que requer Node.js e solicita sua API Key caso ela não seja passada como argumento; em seguida, inspecione ~/.claude/settings.json (ou %USERPROFILE%\.claude\settings.json no Windows, onde há um script PowerShell documentado) e reinicie o Claude Code por completo. Na configuração manual da CLI, adicione um objeto env a esse arquivo com "ANTHROPIC_BASE_URL": "https://bettertoken.ai", "ANTHROPIC_AUTH_TOKEN" com sua API Key, "API_TIMEOUT_MS": "3000000", "ANTHROPIC_MODEL" com um Model ID verificado copiado dos preços atuais (como claude-sonnet-5-5) e os três aliases de função (ANTHROPIC_DEFAULT_HAIKU_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL e ANTHROPIC_DEFAULT_OPUS_MODEL). Segundo o guia, você pode apontar os três aliases para o mesmo Model ID ou escolher um Model ID verificado diferente para cada função (por exemplo, claude-haiku-5-5, claude-sonnet-5-5 e claude-opus-5-5). Você também pode definir a opção "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1", que desativa atualizações automáticas, relatórios de erro e algumas verificações de disponibilidade e recursos de conta, embora a autenticação não exija isso. Na extensão do VS Code, adicione claudeCode.environmentVariables ao settings.json do VS Code como um array de objetos {"name": "...", "value": "..."} com esses mesmos nomes e valores de variável (os exemplos JSON completos estão no guia linkado acima), reinicie o Claude Code e execute /status novamente.
Se preferir as rotas oficiais da Anthropic, siga Gerenciar o Claude Code no terminal pelo Enterprise Admin Console para login organizacional, ou configure uma assinatura claude.ai, login do Claude Console ou provedor cloud no guia de autenticação do Claude Code.
Verifique o login do Enterprise Admin Console e a prioridade de gateway
Na versão 2.1.330, claude auth login permite fazer login em uma organização gerenciada no Enterprise Admin Console da Anthropic. Enquanto esse login permanecer ativo (cerca de um mês), o Claude Code aplica as configurações do console da organização e direciona as requisições de modelo para o provedor cloud ou gateway salvo na página Connection, em Organization settings > Desktop 3P.
Um Owner ou Primary Owner precisa salvar a página Connection em Organization settings > Desktop 3P e ativar Allow sign-in from Claude Code in terminals and IDEs (desativado por padrão). Ative a opção para toda a organização em Organization settings > Products > Claude Code ou para um grupo piloto (quando sua organização tiver uma organização pai) em Organization settings > People > Permission policies, na seção Claude Code da política do grupo. Clique em Save changes depois de ativar o seletor em qualquer um dos locais. Atualize a CLI claude para 2.1.330 ou superior; se também usar a extensão do VS Code, atualize a extensão. O login informa ao Claude Code para onde rotear as requisições, mas não faz a autenticação upstream: desenvolvedores continuam precisando de credenciais de nuvem para AWS, Google Cloud ou Azure, e gateways com login próprio exigem um segundo /login dentro do Claude Code (até lá, o Claude Code recusa cada prompt e indica o que fazer).
Confira quais configurações prevalecem na sua máquina
O Claude Code resolve configurações em uma ordem estrita de três níveis de prioridade, do menor para o maior:
- Arquivos de configuração próprios do desenvolvedor.
- Configurações do Enterprise Admin Console baixadas após
claude auth login. - Configurações gerenciadas locais do Claude Code na máquina (
managed-settings.json, perfil MDM no macOS ou política de registro no Windows; perfis de configuração do Claude Desktop e políticas de registro emHKCUnão contam).
Se restar na máquina uma única configuração gerenciada do Claude Code, o computador ignora o console por completo e exibe: The organization's settings won't apply on this computer, because the computer's own managed settings take priority.
Os administradores têm duas opções documentadas:
- Remover as configurações gerenciadas locais: transfira as regras suportadas para o console e remova
managed-settings.json, quaisquer arquivos drop-in, o perfil MDM ou a política de registro do Claude Code, mantendo intacto qualquer perfil de configuração do Claude Desktop. - Manter as configurações gerenciadas locais junto com o console: mantenha esses arquivos apenas se precisar de opções que o console não configura, adicionando o ID da organização em
forceLoginOrgUUID. Assim, a máquina também segue o console e recusa outras organizações; enquanto o usuário estiver autenticado, a conexão do console substitui a da máquina, as restrições dos dois lados se somam e algumas configurações gerenciadas locais deixam de valer. Como o Claude Code recusa iniciar sessões comANTHROPIC_API_KEY,ANTHROPIC_AUTH_TOKENouapiKeyHelperem uma máquina comforceLoginOrgUUIDdefinido, deixeforceLoginOrgUUIDdesativado em máquinas que também precisem de chave para outro gateway, como a BetterToken.
O console sozinho não obriga desenvolvedores a fazer login. Para exigir login organizacional em máquinas somente CLI após habilitar o recurso no console, adicione três chaves às configurações gerenciadas locais: forceLoginOrgUUID (faz a máquina seguir o console e recusar outras organizações, mas sozinho não exige login), "enforceAnthropicSignIn": true (escreva true sem aspas; inicia sessões em nuvem ou gateway apenas quando autenticado na organização) e "requiredMinimumVersion": "2.1.330" (bloqueia versões antigas que ignoram enforceAnthropicSignIn). Não defina enforceAnthropicSignIn nem requiredMinimumVersion em máquinas que também executam o Claude Desktop com o seu provedor: enforceAnthropicSignIn impede a abertura de sessões do Claude Desktop (Code, Cowork, Chat e tarefas agendadas) mesmo com login ativo, e requiredMinimumVersion impede a abertura dessas sessões enquanto a cópia integrada do Claude Code estiver abaixo da versão mínima.
Valide o provedor ativo e corrija links curtos com erro
Depois de rodar claude auth login e selecionar sua organização no navegador, valide a configuração em duas etapas:
- Confirme se o terminal exibe
Signed in to the organization. Se mostrarLogin successful., você escolheu outra conta e precisa executarclaude auth loginnovamente. - Feche as sessões abertas do Claude Code, abra
claudee execute/status:Setting sourcesincluiEnterprise managed settings (remote).- Para um provedor cloud,
API providerexibe o nome do provedor seguido de(chosen by your organization). - Para um gateway,
Anthropic base URLmostra o endereço do gateway e nenhuma linha informa que a conexãoisn't used. Managed settings (remote)aparece somente quando o Claude Code tem algo a reportar: explica a causa de qualquer falha e lista as chaves do JSON do console que foram ignoradas.
A versão 2.1.330 também encurta a URL de login do claude.ai exibida por /login, claude auth login e claude setup-token. Se o link curto apresentar erro ou um script ler parâmetros da URL, defina CLAUDE_CODE_FULL_SIGN_IN_LINK=1 no shell ou nas configurações de usuário (exige 2.1.330 ou superior). Se um gateway bloquear o tráfego com erros HTTP 403 ou TLS após a troca de endpoint, consulte nosso guia para diagnosticar erros 403 e TLS no Claude Code.
O que muda no /loop e nas tarefas agendadas de 30 dias
Na 2.1.330, tarefas agendadas recorrentes e jobs de /loop podem rodar por até 30 dias em vez de 7 dias enquanto a sessão continuar em execução, e o Claude Code passa a informar quando elas terminam. Duas condições estritas se aplicam:
- A sessão precisa continuar rodando: segundo a referência de tarefas agendadas, tarefas de
/loopeCronCreatetêm escopo de sessão e só disparam enquanto o Claude Code está em execução e ocioso. Se o horário previsto passar enquanto o Claude processa uma requisição longa, a tarefa dispara uma única vez quando ele fica ocioso, sem reproduzir cada intervalo perdido. Fechar um terminal comum interrompe os disparos. Para manter tarefas/loopativas após fechar o terminal, mova antes a sessão para segundo plano com/background(ou/bg); o serviço supervisor do Claude Code mantém sessões em segundo plano ativas sem terminal enquanto houver uma tarefa agendada pendente ou uma próxima execução pendente do/loop. Retomar depois comclaude --resumeouclaude --continuerestaura apenas as tarefasCronCreatecujo prazo ainda não expirou, mas não restaura um/loopque define por conta própria quando voltar a executar. - Tarefas criadas antes da
2.1.330continuam encerrando em 7 dias: atualizar o Claude Code não estende agendamentos já existentes.
Para migrar uma tarefa recorrente existente para o limite de 30 dias após a atualização:
- Peça ao Claude em linguagem natural para listar suas tarefas (como
what scheduled tasks do I have?) ou useCronList, que mostra o ID de 8 caracteres, o agendamento, o próximo horário de execução e o prompt de cada tarefa. - Cancele qualquer tarefa anterior à
2.1.330em linguagem natural (comocancel the deploy check job) ou passando o ID dela paraCronDelete. - Recrie o agendamento com
/loopou com um comando em linguagem natural e confirme a nova data de término exibida pela2.1.330.
Duas correções relacionadas chegam na 2.1.330. Primeiro, o aviso de tarefa agendada pulada que não cita nenhuma organização agora orienta iniciar o Claude Code com --resume, porque /resume dentro de uma sessão em execução não dispara a tarefa. Segundo, no VS Code, conversas bifurcadas não executam mais em duplicidade os agendamentos /loop da conversa original.
Retry restaurado de max_tokens e comportamento atrás de gateways
Se você enfrentou falhas de max_tokens atrás de um gateway LLM na 2.1.329, atualizar para a 2.1.330 restaura a recuperação no cliente. O changelog oficial do Claude Code registra três mudanças seguidas:
- A
2.1.326adicionou o retry automático usando o máximo informado pela API da Anthropic quandomax_tokensexcedia o limite do modelo. - A
2.1.329removeu esse retry e orientou usuários de gateways cujo modelo aceita menos tokens de saída a configurarCLAUDE_CODE_MAX_OUTPUT_TOKENSmanualmente (veja nosso changelog da Claude Code 2.1.329 sobre correções de gateway). - A
2.1.330reverte a remoção da2.1.329e restaura o retry automático quandomax_tokensexcede o limite de um modelo ou de um gateway.
Isso impacta mais diretamente aliases personalizados de modelo e modelos com teto menor de saída. Pela referência de variáveis de ambiente do Claude Code, qualquer ID de modelo não reconhecido usa o padrão de 32000 tokens de saída com teto de 128000. Segundo o guia de compatibilidade de gateways, a maior parte da lógica de retry faz correspondência com o texto do erro upstream; portanto, gateways devem repassar o corpo das respostas de erro upstream sem modificações. Alterar o formato da resposta pode impedir a retentativa se ocultar a mensagem que o Claude Code espera reconhecer, mesmo quando o gateway preserva o código de status HTTP.
Uma resposta normal por si só não comprova que o retry automático ocorreu, pois a primeira requisição já pode ter ficado abaixo do limite do gateway. Para confirmar que o Claude Code tentou novamente com o limite de max_tokens informado, verifique logs do gateway que exibam os campos da requisição: procure uma requisição inicial acima do limite retornando erro de max_tokens, seguida imediatamente por uma nova tentativa com o valor menor de max_tokens retornado nesse erro. No painel do workspace da BetterToken, os campos documentados mostram saldo, horário da requisição, modelo, status, consumo de tokens de entrada/saída/cache e cobranças. Esses campos podem exibir uma falha seguida de um sucesso como indício, mas não provam que ambas as chamadas pertencem ao mesmo turno nem confirmam o valor de max_tokens reenviado; use logs de gateway com campos de requisição para confirmação. Se o gateway continuar retornando erros de max_tokens na 2.1.330, defina CLAUDE_CODE_MAX_OUTPUT_TOKENS como alternativa com o limite de tokens de saída aceito pelo modelo ativo e pela rota do gateway, escolhendo o menor valor quando ambos forem conhecidos. Uma resposta bem-sucedida com esse teto prova que a requisição limitada funciona, não que o retry automático foi acionado. Se as premissas de janela de contexto também entrarem em conflito atrás do seu gateway, consulte nosso guia para corregir limites de modelos não reconhecidos em gateways.
Outras três mudanças da 2.1.330 afetam configurações com gateway:
/effortdoWebFetchatrás de gateways: corrigiu o comportamento em que resumos de página doWebFetchignoravam/effortquando um gateway recusava o modelo pequeno e rápido.- System prompt mais curto para IDs
sonnet/haikunão reconhecidos: nomes não reconhecidos que contêm"sonnet"ou"haiku"agora usam o system prompt mais curto, assim como outros nomes não reconhecidos; definaCLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0para enviar o prompt completo a todos os modelos. - Menor consumo de tokens no gateway de apps do Claude: resumos de progresso de subagentes em sessões de terminal conectadas a um gateway de apps do Claude agora são gerados a partir de notas curtas em vez de toda a conversa.
Controle os gráficos do easel e silencie avisos MCP corporativos
A 2.1.330 adiciona o easel (cc-plugin-easel em /plugin), um mod integrado que oferece ao Claude uma ferramenta para gerar gráficos e desenha gráficos automaticamente abaixo de resultados MCP em formato de série temporal compatível, como o resultado de uma consulta de intervalo do Prometheus. Segundo o changelog do Claude Code e a visão geral de mods, o easel exige:
- Login: uma assinatura claude.ai (Pro, Max e, onde disponível, Team e Enterprise). Ele não é carregado em sessões com chave de API ou gateways de terceiros.
- Plataforma: macOS ou Linux fora do WSL.
Controle o easel em dois níveis:
- Desativar apenas os gráficos automáticos: execute
/confige desligue Auto charts. O Claude continua gerando gráficos quando você pedir. - Desativar o mod por completo: abra
/plugin, acesse a aba Installed, localize a seção Built-in e desativecc-plugin-easel. Configurações e flags que bloqueiam mods instalados pelo usuário (disableAllHooks,--baree--safe-mode) não desativam mods integrados.
Se a sua organização filtra o acesso MCP com allowedMcpServers ou deniedMcpServers (veja Controlar acesso a servidores MCP) e exclui a ferramenta integrada de gráficos, a 2.1.330 corrige um ruído recorrente na inicialização: o Claude Code não imprime mais MCP server blocked by enterprise policy: easel a cada início. A ferramenta integrada de gráficos continua bloqueada pela política corporativa.
Rumor de confirm-before-risky-actions vs. mudanças reais da 2.1.330
Resumos de terceiros no X, como o de @ClaudeCodeLog em 20 de novembro de 2026, listaram uma nova política “confirm-before-risky-actions policy” como destaque da 2.1.330. Outros desenvolvedores, incluindo @alexmichael, observaram no mesmo dia que essa política já existia desde a 2.1.321.
O changelog oficial da 2.1.330 (CHANGELOG.md e code.claude.com/docs/en/changelog) não contém nenhuma entrada confirm-before-risky-actions. A mudança de aprovação realmente entregue na 2.1.330 é mais específica: mais comandos rm direcionados à raiz, à pasta pessoal, a um diretório de nível superior ou ao diretório de trabalho agora pedem aprovação, e quando ninguém pode responder, o Claude Code os recusa.
Outras correções de estabilidade da 2.1.330 que valem a verificação
Várias correções de confiabilidade na 2.1.330 eliminam travamentos frequentes no dia a dia:
- Travamentos de sessão: corrigiu congelamentos de vários minutos logo após compactar uma conversa muito longa, travamentos ou resultados vazios do
WebFetchem algumas páginas e uma espera de três minutos no primeiro prompt após uma suspensão de dois minutos ou mais no Linux e no WSL. - Sessões paralelas e segurança das configurações: corrigiu a perda de configurações de usuário quando vários processos do Claude Code salvavam simultaneamente, impediu que
ExitWorktreee o diálogo de saída de worktree apagassem um worktree ativo em outra sessão em execução, e corrigiu falhas"JSON schema is invalid"junto com o crescimento de vários megabytes nos arquivos de sessão quando muitas ferramentas MCP expõem esquemas recusados pela API. - Busca, revisão e runners: a busca de
/configagora exibe primeiro a maioria das configurações cujo nome começa com o que você digita (effortencontra Model edarkoulightencontra Theme);/ultrareviewinterrompe e indica ambas as pastas se o shell mudou para outro repositório, além de mostrar quanto resta do seu limite mensal de gastos nos planos Team e Enterprise quando esse saldo for menor que o custo típico de uma revisão; runners auto-hospedados passam a aceitar--start-direSELF_HOSTED_RUNNER_START_DIR. - Extensão do VS Code: adiciona
/fork,/workflowseclaudeCode.escapeStopsClaude, e corrige a inserção de uma quebra de linha final em blocos de código copiados que executava comandos ao colar.