Changelog do Claude Code 2.1.329: max_tokens em gateway, /tasks, /code-review e correções

Claude Code 2.1.329 (19 de novembro de 2026) remove retentativas automáticas de max_tokens atrás de gateways, inclui tarefas agendadas e forks em /tasks, altera /code-review para comparar toda a branch por padrão, adiciona avisos sobre origem de hooks e corrige resets de ~/.claude.json além de bugs no macOS, VS Code e créditos de uso. Cobre atualização, rotas de gateway e mudanças de 2.1.328 do mesmo dia.

Conteúdo
Changelog do Claude Code 2.1.329: max_tokens em gateway, /tasks, /code-review e correções

O Claude Code 2.1.329 saiu em 19 de novembro de 2026 removendo as retentativas automáticas de max_tokens atrás de gateways, ampliando /tasks, alterando /code-review e agendamentos salvos, e corrigindo resets de ~/.claude.json além de desconexões no macOS e no VS Code. Essas mudanças afetam desenvolvedores no terminal, no VS Code e no Claude Desktop, bem como equipes que usam gateways de LLM ou créditos de uso Pro e Max. Execute claude --version e claude update para atualizar e defina CLAUDE_CODE_MAX_OUTPUT_TOKENS se o seu gateway impuser um limite menor de saída.

Escolha uma rota de acesso para o Claude Code 2.1.329

Atualizar para a 2.1.329 mexe com limites de tokens de saída em gateways, avisos de allow_cidrs em gateways auto-hospedados e exibição mensal de créditos nos planos Pro ou Max. Compare as rotas viáveis antes de alterar configurações locais ou da equipe.

RotaRequisitos de conta e regiãoUnidade de cobrançaQuando escolher
Assinatura Claude Pro / MaxConta paga no claude.ai (Pro, Max, Ultra, Team ou Enterprise; plano gratuito do claude.ai excluído) em uma região suportada pela AnthropicUso incluído na assinatura mais créditos de uso opcionaisVocê precisa de Remote Control, entrada por voz ou uso combinado na web e na CLI
API direta da Anthropic ConsoleConta da Claude Console (platform.claude.com, via chave de API ou login na Console) em uma região suportada pela AnthropicPagamento conforme o uso por token de APIVocê quer cobrança direta da API da Anthropic sem intermediários
Gateway da organização ou auto-hospedadoProxy gerenciado pela organização (como Claude apps gateway com login via IdP corporativo) mais credenciais de API ou nuvem upstreamCobrança por token na sua conta upstream da Anthropic Console, Bedrock, Agent Platform ou FoundrySua equipe exige orçamentos centralizados, controle de acesso a modelos, logs de auditoria e configurações gerenciadas
Gateway de API sob demanda BetterTokenConta BetterToken e chave de API do console; não exige conta claude.ai para acesso via APIPagamento conforme o uso por token (o saldo pago comprado não zera todo mês)Você busca acesso à API do Claude compatível com Anthropic ou escolha multimodelo sem hospedar um gateway

Conecte o Claude Code 2.1.329 ao BetterToken

O BetterToken é uma plataforma independente de API multimodelo, não um produto oficial da Anthropic. Sua Base URL compatível com Anthropic para o Claude Code é https://bettertoken.ai. Deixe /v1 de fora de ANTHROPIC_BASE_URL, pois o Claude Code acrescenta /v1/messages automaticamente.

Em 2026-11-20, o BetterToken lista claude-sonnet-5-5, claude-opus-5-5, claude-haiku-5-5 e claude-fable-5-2 em seu endpoint compatível com Anthropic (cada um com janela de contexto de 1M de tokens e saída máxima de 128K, síncrona no Sonnet 5.5, Opus 5.5 e Haiku 5.5), além de claude-haiku-4-5-20251001 (contexto de 200K e saída síncrona máxima de 64K). Confira os preços atuais para ver tarifas vigentes de entrada, saída e cache antes de rodar sessões intensas.

No Bash, leia sua chave de API sem exibi-la no terminal e exporte as variáveis para uma sessão de teste:

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"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"

Execute um prompt único para confirmar a conexão:

claude -p "Reply with only: OK"

Uma resposta simples OK sem erros 401, de conexão ou de modelo confirma a autenticação. Em seguida, inicie o claude e rode /status. Confirme se Anthropic base URL exibe https://bettertoken.ai e se a linha de autenticação mostra ANTHROPIC_AUTH_TOKEN em vez de login no claude.ai. Se a inicialização avisar sobre fontes de credenciais em conflito, execute /logout para limpar a sessão salva do claude.ai e remova ANTHROPIC_API_KEY caso o seu shell a defina.

Para manter esses valores entre sessões, adicione-os ao bloco "env" em ~/.claude/settings.json (%USERPROFILE%\.claude\settings.json no Windows) e reinicie o Claude Code por completo. Siga o guia de configuração do Claude Code no BetterToken ou a página de configuração da API do Claude Code para ver exemplos completos. Adicione CLAUDE_CODE_MAX_OUTPUT_TOKENS apenas se escolher um modelo cujo limite de saída seja menor que o tamanho da requisição do Claude Code. Se você definir a opção CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, ela desativa as atualizações automáticas; nesse caso, execute claude update manualmente. Remote Control e entrada por voz exigem login no claude.ai e continuam indisponíveis com chave de API e Base URL personalizada.

Criar uma conta no BetterToken

Se sua organização já mantém proxy próprio ou Claude apps gateway, mantenha suas configurações gerenciadas ou siga o guia da Anthropic para conectar o Claude Code a um gateway de LLM e definir ANTHROPIC_BASE_URL com ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY ou apiKeyHelper.

Erros de max_tokens em gateways e avisos allow_cidrs na inicialização

O Claude Code 2.1.329 remove um comportamento de retentativa introduzido na versão 2.1.326. Na 2.1.326, quando max_tokens excedia o limite do modelo, o Claude Code repetia a requisição automaticamente usando o máximo informado pelo erro da API. Segundo o changelog oficial do Claude Code, a versão 2.1.329 retira essa retentativa.

Essa mudança afeta equipes que roteiam requisições por um gateway para um modelo que aceita menos tokens de saída do que o Claude Code solicita. Conforme a referência de variáveis de ambiente do Claude Code, IDs de modelos personalizados não reconhecidos usam por padrão 32000 tokens de saída com teto de 128000. Quando o gateway atende esse ID com um modelo de limite menor, as chamadas agora falham com erro de max_tokens em vez de tentar de novo silenciosamente.

Defina CLAUDE_CODE_MAX_OUTPUT_TOKENS com o limite confirmado de saída do seu modelo no shell ou em ~/.claude/settings.json:

export CLAUDE_CODE_MAX_OUTPUT_TOKENS="16384"

Substitua 16384 pelo limite real de saída do modelo, reinicie o Claude Code e envie um prompt curto para verificar se o erro de max_tokens desaparece. Se o gateway estiver recusando requisições pelo tamanho da entrada e não da saída, consulte nosso guia sobre como corrigir erros de janela de contexto de 1M em gateways do Claude Code.

Quem administra o Claude apps gateway auto-hospedado da Anthropic também passa a ver um aviso repetido ao iniciar. Quando access_control.allow_cidrs está vazio, a versão 2.1.329 registra um aviso em destaque a cada inicialização: never expose the gateway to the public internet (esse alerta de boot não aparece quando o gateway escuta em endereço loopback sem trusted_proxies nem public_url). Conforme o guia de configuração do Claude apps gateway, deixar vazias as duas listas de access_control (allow_cidrs e deny_cidrs) faz o gateway atender qualquer endereço de cliente, deixando apenas a sua rede responsável por bloquear acessos. Isso importa porque o gateway pode enviar configurações gerenciadas que executam comandos nas máquinas dos desenvolvedores. Preencha access_control.allow_cidrs com suas faixas privadas e mantenha o gateway e tudo à frente dele inacessível pela internet pública. Se um balanceador de carga, port-forward ou túnel repassar o tráfego, liste-o em listen.trusted_proxies somente quando esse frontend acrescentar o endereço de cada conexão recebida para que nenhum desenvolvedor tenha escrito a última entrada de X-Forwarded-For. Nunca inclua um endereço ou faixa usada pelos desenvolvedores; omitir um intermediário qualificado faz o gateway enxergar o endereço do intermediário em vez do cliente. Reinicie o gateway e confirme que o aviso sumiu.

Comportamento de /tasks, tarefas agendadas salvas e /code-review

A versão 2.1.329 muda a forma como o trabalho ativo da sessão aparece em /tasks e como /code-review calcula os diffs. Verifique os dois pontos antes de retomar tarefas recorrentes ou revisões de branch.

Como gerenciar tarefas agendadas, execuções /loop e forks em /tasks

/tasks agora exibe as tarefas agendadas desta sessão, as execuções programadas de /loop, a meta e os forks desta conversa. Pressione x para encerrar qualquer item selecionado após confirmação. O cabeçalho de /tasks e o contador em segundo plano no rodapé agora reúnem shells, monitores, chamadas MCP, agentes, fluxos de trabalho e tarefas agendadas em um único número.

Agendamentos salvos anteriormente exigem ação manual depois da atualização. Em novas sessões autenticadas, a maioria das tarefas agendadas por versões anteriores precisa ser agendada novamente. Rodar claude --resume na sessão original delas continua executando essas tarefas antigas. Escolher Exit and stop tasks agora interrompe as tarefas agendadas desta sessão para que não reiniciem ao retomar, exceto se você sair enquanto o Claude estiver respondendo. Para escolher entre agendamentos Cloud, Desktop e /loop, veja como agendar tarefas no Claude Code.

Diffs contra a branch padrão e checagens de pull requests em /code-review

Executar /code-review sem alvo agora revisa a branch inteira em relação à branch padrão na maioria dos modelos. Essa atualização também corrige um bug em que /code-review perdia o diff em branches com vários commits.

As revisões de pull requests ficaram mais rigorosas. Antes, /code-review <pr number> podia revisar silenciosamente sua branch local ativa em vez do pull request. Na 2.1.329, o comando lê o pull request com gh pr diff ou informa quando não consegue. Quando gh pr diff falha ou é recusado, /code-review <pr number> --fix e /code-review chamado com a URL de um pull request agora param sem revisar.

Esta atualização também corrige duas falhas de revisão na maioria dos modelos. /code-review não trava mais em um pedido de permissão para procurar um ~/.claude/CLAUDE.md inexistente, e na maioria dos modelos o cartão de achados não exibe mais high para uma revisão executada em nível médio.

Avisos de confiança de hooks, diagnóstico MCP e /status

O Claude Code 2.1.329 aprimora os diagnósticos em hooks de pasta, servidores HTTP MCP remotos, marketplaces gerenciados e Code Mode:

  • Hooks de pasta e gerenciados: o diálogo de confiança agora informa onde os hooks da pasta estão declarados. No Claude Desktop e em outros hosts não interativos, hooks que falham nas configurações gerenciadas geram um aviso dentro da conversa. No VS Code, recusar o aviso de confiança adiciona uma linha acima da caixa de mensagem com Review trust, permitindo reabrir o diálogo sem recarregar a janela. Para inspecionar hooks inesperados de projeto ou servidores MCP remotos, use nosso guia para auditar hooks e conexões MCP no Claude Code.
  • Diagnóstico de HTTP MCP remotos: a página de um servidor em /mcp ganha a linha Server message, mostrando o erro JSON-RPC quando um servidor HTTP MCP remoto recusa a conexão. A versão 2.1.329 também reconecta automaticamente a maioria dos servidores HTTP MCP deixados em uma versão mais antiga do protocolo para evitar que tarefas MCP em segundo plano travem. Corrige ainda o problema em que claude mcp login e /mcp informavam que um serviço não aceita login do Claude Code quando o registro do cliente foi desativado (HTTP 410 Gone), além de impedir que uma renovação de token ativa faça login novamente no servidor depois que você limpar a autenticação.
  • Status de atualização automática de marketplaces: /status inclui a linha Marketplace auto-update, listando marketplaces gerenciados sem atualização automática e o motivo.
  • Telemetria e hooks no Code Mode: agora você pode ativar o Code Mode com eventos e métricas do OpenTelemetry ligados; cada chamada de ferramenta envia seus eventos, enquanto o rastreamento continua mantendo o Code Mode desativado. O Code Mode também passa a iniciar com telemetria, tráfego não essencial ou feature flags desligados, embora um administrador possa mantê-lo bloqueado em configurações gerenciadas. Um hook PreToolUse com falha não bloqueia mais a chamada de ferramenta de um script do Code Mode, a menos que você defina "onFailure": "block" em um hook de comando, HTTP ou ferramenta MCP. O Code Mode agora recusa leituras de faixas de linhas acima de 256 MiB e interrompe loops descontrolados antes que esgotem a memória.

Correções para resets de ~/.claude.json, desconexões e créditos de uso

Entre as 91 correções listadas no changelog da 2.1.329, quatro melhorias de confiabilidade resolvem interrupções frequentes de sessão.

Primeiro, ~/.claude.json não volta mais aos padrões quando uma pausa de rede ou bloqueio de arquivo o torna ilegível e o limpa durante o salvamento. Atualizar protege gravações futuras, mas você ainda precisa restaurar ou reaplicar suas configurações se uma versão anterior já tiver apagado o arquivo.

Segundo, a atualização corrige os ciclos de desconexão no macOS e no VS Code. No macOS, a renovação do login agora testa a gravação no Keychain usando um item Claude Code-write-check. Quando o Claude Code consegue ler o Keychain mas não gravar nele, apenas essa sessão para ao expirar explicando o motivo, enquanto as demais continuam conectadas. No VS Code, um atraso de 10 a 30 segundos na renovação do token não desconecta mais todas as janelas e terminais de uma só vez. Notas iniciais da comunidade no X, como a postagem de @alexmichael (2026-11-19 22:17 UTC), destacaram essas correções de desconexão e ~/.claude.json junto com /tasks e /code-review, em conformidade com o changelog oficial.

Terceiro, as verificações de créditos de uso nos planos Pro e Max ficaram mais confiáveis. /usage-credits não pede mais que usuários Pro e Max façam login novamente depois de abrir o navegador. O link também não desaparece mais após 8 segundos quando o navegador falha ao abrir e uma tarefa pausa aguardando créditos. Além disso, /usage não diz mais que os créditos de uso estão desativados quando acabaram ou atingiram o limite mensal, e /model agora avisa usuários Pro e Max quando esse limite bloqueia um modelo movido a créditos. Quando os limites da assinatura pausarem uma tarefa ativa, use nosso fluxo de recuperação para limites de uso no Claude Code para salvar um checkpoint no Git antes de trocar de rota.

Quarto, a versão resolve dois bugs de editor. Aceitar um diff pela IDE não remove mais a quebra de linha final do arquivo nem descarta a marca de ordem de bytes (BOM) no VS Code. /terminal-setup também para de corromper configurações ou atalhos do VS Code perto de comentários em bloco e para de reportar sucesso perdendo o atalho Shift+Enter quando keybindings.json tem uma string não fechada.

Também lançado em 19 de novembro: mudanças principais do Claude Code 2.1.328

A Anthropic publicou a v2.1.328 mais cedo em 19 de novembro de 2026 (01:14:04Z), cerca de 21 horas antes da v2.1.329 (22:14:41Z). Equipes que atualizam direto da 2.1.327 para a 2.1.329 também recebem estas melhorias da 2.1.328:

  • Timeouts em gateways e cabeçalhos beta: CLAUDE_STREAM_IDLE_TIMEOUT_MS agora estende o limite de conexão de 5 minutos em gateways, Base URLs personalizadas e provedores em nuvem. O modo automático não falha mais a cada turno fora do Claude Desktop quando CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS está definido atrás de um gateway que rejeita betas, nem no Bedrock, Agent Platform, Foundry ou Claude apps gateway. Ferramentas MCP cujos esquemas de entrada começam com anyOf, oneOf ou allOf não desaparecem mais em provedores de terceiros ou com telemetria ou feature flags desligadas.
  • Relatórios de /code-review mais objetivos: na maioria dos modelos, /code-review agora relata apenas bugs e violações de CLAUDE.md; execute /simplify para sugestões de reutilização e limpeza. Na maioria dos modelos, ele marca cada achado como Important, Pre-existing ou Nit, encerra cada resumo com uma sugestão de correção e imprime "Code review found no issues." quando não há problemas.
  • Proteção de tarefas agendadas e hooks MCP: salvar uma tarefa agendada não apaga mais outras tarefas do projeto quando o arquivo de tarefas está ilegível em provedores de terceiros ou com telemetria ou feature flags desativadas. Além disso, hooks mcp_tool agora suportam "onFailure": "block" da mesma forma que hooks de comando e HTTP.

Quer otimizar seu fluxo de trabalho com LLMs?

Conecte modelos por uma única API, gerencie chaves e controle os gastos com IA.

Começar grátis