Claude Code 2.1.323: corrija erros de contexto 1M em gateways
O Claude Code 2.1.323 passou a presumir uma janela de 1M tokens, em vez de 200K, para IDs de modelo desconhecidos. Em gateways com limites menores, sessões longas podem falhar a cada interação. Veja a correção da versão 2.1.325, configure o limite real com CLAUDE_CODE_MAX_CONTEXT_TOKENS e ajuste a compactação automática. Inclui regras para [1m], configuração do BetterToken com DeepSeek ou Kimi e recuperação de sessões travadas.
Conteúdo

O Claude Code 2.1.323 mudou de 200K para 1M tokens a janela de contexto presumida para IDs de modelo desconhecidos. Se seu modelo externo ou gateway aceitar menos tokens, a compactação pode começar tarde demais e as requisições podem falhar repetidamente. Atualize o Claude Code para a versão 2.1.325 ou posterior. Depois, configure a janela real do modelo ou um limite de compactação mais baixo.
Não limite automaticamente todas as sessões com DeepSeek, GLM ou Kimi a 200K. Alguns modelos atuais oferecem contexto de 1M tokens. Reduzir essa janela sem necessidade faz o Claude Code resumir mais cedo informações úteis sobre o projeto.
Este guia mostra o que mudou nas versões 2.1.323 a 2.1.325, como escolher a correção e como recuperar uma sessão que já apresenta falhas.
O que mudou no Claude Code 2.1.323, 2.1.324 e 2.1.325?
A versão 2.1.323 introduziu a nova janela presumida. As versões seguintes corrigiram comportamentos relacionados aos IDs personalizados e aos erros de contexto em gateways.
O changelog oficial do Claude Code registra estas mudanças:
| Versão | Mudança relacionada ao contexto | O que fazer |
|---|---|---|
| 2.1.323 | IDs não reconhecidos passaram a ter uma janela presumida de 1M, em vez de 200K tokens. | Confira o limite real antes de iniciar uma sessão longa. |
| 2.1.323 | Modelos de outros fornecedores com janelas menores podem falhar em todas as interações após o contexto lotar, até o uso de /clear. | Configure a janela antes de atingir o limite. |
| 2.1.324 | CLAUDE_CODE_MAX_CONTEXT_TOKENS passou a funcionar também com IDs desconhecidos iniciados por claude-. | Atualize se seu gateway usa um desses aliases. |
| 2.1.325 | Corrigidas falhas repetidas por excesso de contexto, em vez de compactação, em muitos gateways externos e implantações Foundry. | Atualize antes de aplicar soluções mais invasivas. |
Em 2026-11-15, o npm mostrava 2.1.325 como latest e 2.1.311 como stable para @anthropic-ai/claude-code.
A versão stable 2.1.311 não inclui a mudança de comportamento introduzida na 2.1.323. Ela também não contém as correções lançadas depois.
Confira a versão instalada no seu computador:
claude --version
Se você instalou o Claude Code com o instalador nativo, use o comando de atualização documentado:
claude update
claude --version
Se você segue o canal stable de propósito, confira sua versão antes de alterar a configuração. Não presuma que seu executável apresenta o mesmo comportamento do pacote latest.
O changelog da versão 2.1.325 fala em correção para muitos gateways. Ele não promete recuperação em todos eles nem identificação automática de limites impostos pelo gateway.
Por que um ID de modelo desconhecido pode travar uma sessão longa?
O Claude Code usa seu catálogo de modelos reconhecidos e a configuração local para decidir quando compactar uma conversa.
A compactação resume mensagens anteriores para que a próxima requisição caiba na janela de contexto. Um gateway pode expor um ID personalizado que o Claude Code não associa ao modelo real.
Imagine um gateway que disponibiliza my-coding-model com limite efetivo de 200,000 tokens.
Antes da versão 2.1.323, o Claude Code presumia 200K para esse ID desconhecido. A partir da 2.1.323, passou a presumir 1M, a menos que outra configuração altere esse valor.
A capacidade do modelo e do gateway não mudou. Apenas a estimativa usada pelo Claude Code ficou maior.
Se a conversa ultrapassar a janela aceita pelo gateway, a API poderá rejeitar a requisição. A conversa longa continua armazenada na sessão. Por isso, a interação seguinte pode falhar pelo mesmo motivo.
A Anthropic documentou esse cenário no changelog da versão 2.1.323. A correção da 2.1.325 melhora a recuperação em muitos gateways. Mesmo assim, vale configurar o limite efetivo quando ele for menor.
Quais IDs de modelo podem ser afetados?
O risco existe quando a janela presumida pelo Claude Code é maior do que o contexto realmente aceito pela rota da API.
Verifique estas situações:
- Um modelo que não é Claude, como
deepseek-v4.1-flash-1017oukimi-k3.1-pro, caso o Claude Code não reconheça o ID. - Um alias do gateway, como
my-coding-model, mesmo quando a rota usa um modelo Claude. - Um ID desconhecido iniciado por
claude-, comoclaude-sonnet-latest. A versão 2.1.324 mudou a aplicação da configuração nesse caso. - Um ID com o sufixo
[1m], que segue regras específicas para substituir a janela presumida.
Um ID desconhecido, sozinho, não comprova que há uma incompatibilidade de contexto.
Se o modelo e a rota realmente aceitarem 1M tokens, o novo padrão poderá funcionar normalmente. O problema surge quando o modelo, o gateway ou a implantação impõe uma janela menor.
Também há diferença entre um alias desconhecido e um ID que o Claude Code resolve como um modelo Claude conhecido. Em alguns casos, o cliente reconhece o modelo Anthropic dentro de um nome fornecido por outro provedor. Isso muda as regras de configuração.
Consulte a documentação oficial sobre janelas de contexto para modelos personalizados antes de depender de um padrão específico de ID.
Qual correção escolher para a janela de contexto?
Use CLAUDE_CODE_MAX_CONTEXT_TOKENS quando souber o limite efetivo e o ID aceitar essa configuração. Use CLAUDE_CODE_DISABLE_1M_CONTEXT=1 para voltar rapidamente a 200K. Ajuste a compactação automática quando precisar deixar uma margem de segurança.
| Correção | Quando usar | Limitação |
|---|---|---|
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 | A janela real é de pelo menos 200K e você quer recuperar a restrição anterior. | Reduz para 200K alguns modelos que realmente suportam 1M. Não basta para janelas menores que 200K. |
CLAUDE_CODE_MAX_CONTEXT_TOKENS | Você conhece o tamanho real da janela de um modelo desconhecido ou alias. | A aplicação depende do reconhecimento do ID, da versão e do sufixo [1m]. |
/autocompact, --autocompact ou CLAUDE_CODE_AUTO_COMPACT_WINDOW | Você quer compactar antes de atingir a janela presumida. | O mínimo configurável documentado é 100K. Escolha um valor compatível com a rota real. |
Essas opções não são equivalentes. A primeira estabelece uma restrição de 200K. A segunda muda a capacidade presumida do modelo. A terceira define quando a conversa será compactada.
Correção 1: voltar à restrição de 200K
Se o modelo ou gateway aceitar pelo menos 200K tokens, inicie o Claude Code no Bash com:
export CLAUDE_CODE_DISABLE_1M_CONTEXT=1
claude
Essa é a solução temporária indicada pela Anthropic no changelog da versão 2.1.323.
Para manter a configuração entre sessões, adicione a variável em env no arquivo ~/.claude/settings.json:
{
"env": {
"CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
}
}
Com essa configuração ativa, o Claude Code também remove as variantes [1m] do seletor de modelos.
Nos modelos que normalmente têm janela nativa de 1M, a compactação automática mantém a sessão dentro de 200K. Se a compactação estiver desativada, a sessão para ao atingir o limite de contexto aplicável.
Há uma exceção importante para IDs desconhecidos. Outra configuração pode impedir que a restrição de 200K seja aplicada.
Se aparecer o aviso:
CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it.
Verifique se você aumentou CLAUDE_CODE_MAX_CONTEXT_TOKENS acima de 200K ou desativou a aplicação preventiva da janela para modelos desconhecidos.
A referência de erros da Anthropic recomenda configurar CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 quando você precisa garantir a compactação nesse limite.
Não use essa correção isoladamente se seu gateway aceitar menos de 200K tokens.
Correção 2: definir a janela real com CLAUDE_CODE_MAX_CONTEXT_TOKENS
Essa é a opção mais precisa quando o limite do gateway é conhecido.
Imagine que o administrador confirmou uma janela efetiva de 200,000 tokens para uma rota de modelo personalizado. Configure a variável no Bash que iniciará o Claude Code:
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
claude
O número 200,000 é uma hipótese usada apenas para ilustrar a configuração. Não é um valor recomendado para todos os modelos nem um limite confirmado para DeepSeek ou Kimi.
Para um ID desconhecido que não começa com claude- e não contém [1m], a variável se aplica diretamente. O Claude Code mantém a compactação preventiva usando a janela declarada.
A documentação oficial sobre os IDs aceitos por essa variável explica duas exceções:
- Se um ID desconhecido contém
[1m], configure tambémCLAUDE_CODE_DISABLE_1M_CONTEXT=1para corrigir uma janela menor e manter a compactação preventiva. - Se o ID é resolvido como um modelo Claude conhecido, a substituição só funciona quando
DISABLE_COMPACTtambém está definido. Isso desativa toda a compactação, então não é a opção recomendada para sessões longas comuns.
Os IDs desconhecidos iniciados por claude- passaram a aceitar a substituição direta na versão 2.1.324. Versões anteriores podem tratá-los de outro modo.
Se seu gateway usa um alias para um modelo Claude real, você pode configurar a correspondência com modelOverrides ou modelPicker.behavesAs.
Não atribua a identidade de um modelo Claude a um modelo de outro fornecedor apenas para eliminar um aviso.
O valor correto é o limite efetivo da rota de API selecionada. Se o gateway impuser uma restrição menor, não use a capacidade máxima anunciada pelo modelo.
Correção 3: compactar mais cedo com /autocompact
Um limite de compactação mais baixo deixa espaço para resumir a conversa antes de o gateway rejeitar a requisição.
Para uma rota com janela real confirmada de 200K, este é um exemplo conservador:
/autocompact 150k
Execute o comando dentro do Claude Code. Normalmente, ele salva o valor para o modelo atual em modelSettings e o aplica imediatamente à sessão.
Leia a resposta de /autocompact para confirmar qual limite está realmente ativo. Um escopo de configuração com maior prioridade, como configurações gerenciadas, pode manter outro valor mesmo depois que o seu for salvo. O comando informa quando isso acontece.
Se as configurações gerenciadas impedirem a aplicação, peça ao administrador que revise a política. Segundo a documentação da Anthropic sobre compactação automática, o argumento --autocompact de uma inicialização não é substituído por configurações gerenciadas.
Para uma única inicialização:
claude --autocompact 150k
Para scripts, contêineres ou outros ambientes automatizados:
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000
claude
O comando /autocompact e o argumento --autocompact aceitam valores entre 100K–1M tokens. A variável CLAUDE_CODE_AUTO_COMPACT_WINDOW aceita valores de 100000 a 1000000.
Se o Claude Code aceitar o valor da variável, ela terá prioridade sobre o comando, o argumento e as configurações salvas. Nesse caso, /autocompact informa a substituição e não salva um novo valor.
Você também pode definir autoCompactWindow em ~/.claude/settings.json para todos os modelos. Dentro do mesmo escopo, o valor salvo com /autocompact para um modelo prevalece sobre a configuração geral.
O valor 150k é apenas um exemplo de margem para uma rota que aceita 200K. Ele não serve necessariamente para um modelo com janela menor.
O mínimo configurável é 100K. Para modelos com janelas inferiores, confira as regras de substituição do ID e o comportamento efetivo do cliente. Não presuma que /autocompact 50k seja aceito.
Exemplo com BetterToken: configurar Claude Code com DeepSeek ou Kimi
O BetterToken oferece uma API compatível com Anthropic em https://bettertoken.ai para modelos suportados. O ANTHROPIC_BASE_URL do Claude Code não deve incluir /v1.
É importante separar a documentação de integração do BetterToken do suporte oficial da Anthropic. Na documentação sobre gateways LLM, a Anthropic afirma que não oferece suporte ao roteamento do Claude Code para modelos que não sejam Claude por meio de qualquer gateway.
O BetterToken documenta sua própria integração de terceiros. Isso não torna o uso de DeepSeek ou Kimi uma configuração oficialmente suportada pela Anthropic. Verifique a compatibilidade do modelo, as chamadas de ferramentas e os limites da rota escolhida.
Segundo os registros e a documentação do BetterToken consultados em 2026-11-15:
| BetterToken Model ID | Contexto anunciado do modelo | Rota Anthropic Messages |
|---|---|---|
deepseek-v4.1-flash-1017 | 1M tokens | Listada |
kimi-k3.1-pro | 1M tokens | Listada |
glm-5.3 | 1M tokens | Não listada para esse modelo; o registro mostra acesso compatível com OpenAI |
qwen3.8-max | 1,000,000 tokens | Não listada para esse modelo; o registro mostra acesso compatível com OpenAI |
Essas janelas anunciadas não são necessariamente menores que o novo padrão de 1M do Claude Code. O limite efetivo, porém, pode variar conforme a rota do provedor.
A presença de um modelo no catálogo do BetterToken também não garante suporte a todos os protocolos. Consulte o catálogo atual de modelos antes de escolher uma rota para o Claude Code.
O exemplo Bash abaixo usa o ID de DeepSeek com rota compatível com Anthropic documentada. Ele segue o guia de integração do BetterToken com Claude Code.
Primeiro, instale o Claude Code e crie sua própria API Key do BetterToken. Depois, execute estes comandos em um shell Bash separado:
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="deepseek-v4.1-flash-1017"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
unset CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT
claude -p "Reply with only: OK"
claude
Quando o primeiro comando aguardar a entrada, cole a chave criada no console do BetterToken. O valor não aparece na tela nem fica gravado diretamente no comando.
A variável ANTHROPIC_AUTH_TOKEN fornece a autenticação. As três variáveis ANTHROPIC_DEFAULT_*_MODEL direcionam os papéis internos Haiku, Sonnet e Opus para o modelo selecionado do BetterToken. Depois, você pode atribuir outros modelos compatíveis a cada papel.
Para usar Kimi, altere ANTHROPIC_MODEL para kimi-k3.1-pro antes de exportar as três variáveis de papel.
Se você já executou a configuração com DeepSeek, repita as quatro exportações no mesmo shell Bash. Em seguida, inicie um novo processo do Claude Code:
export ANTHROPIC_MODEL="kimi-k3.1-pro"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_SONNET_MODEL="$ANTHROPIC_MODEL"
export ANTHROPIC_DEFAULT_OPUS_MODEL="$ANTHROPIC_MODEL"
Alterar apenas ANTHROPIC_MODEL não modifica as três variáveis exportadas anteriormente. Elas continuarão apontando para DeepSeek. A documentação do BetterToken sobre Kimi K3.1 Pro confirma o ID e a integração documentada com Claude Code.
Para um ID desconhecido sem [1m], você pode declarar a janela verificada. Se a rota realmente aceitar 1,000,000 tokens:
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=1000000
Defina essa variável antes de iniciar o Claude Code. Se o gateway tiver uma restrição menor, substitua 1000000 pelo limite confirmado. Se necessário, configure também um limite de compactação antecipado.
Não aplique automaticamente o exemplo a seguir ao DeepSeek ou Kimi:
# Example only: the gateway's verified limit is 200000 tokens.
export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000
A primeira variável declara a janela efetiva. A segunda reserva uma margem para a compactação. Para outro limite, confirme os dois valores separadamente.
Como verificar o modelo e a rota do gateway?
Depois de iniciar o Claude Code, execute:
/status
Confira se Anthropic base URL mostra https://bettertoken.ai e se a autenticação usa ANTHROPIC_AUTH_TOKEN.
Veja também o modelo ativo. Se necessário, use /model para escolher o ID correto. Se você alterou as variáveis de papel, reinicie o Claude Code para que o novo processo receba os valores.
A requisição claude -p "Reply with only: OK" verifica a conectividade básica e o acesso ao modelo. Uma resposta normal confirma que uma requisição curta funcionou. Ela não comprova o comportamento com contextos longos.
Para testar uma tarefa de programação, peça ao Claude Code que leia um arquivo pequeno do repositório e explique uma função específica sem alterá-lo. Confira se a resposta identifica o arquivo certo.
Se houver erro de conexão ou autenticação, resolva esse problema primeiro. O guia de diagnóstico de erros 403 no Claude Code aborda essas falhas separadamente.
Para conferir a configuração e a seleção de modelos DeepSeek, consulte o guia de integração entre Claude Code e DeepSeek. Para particularidades do Kimi, use o guia de programação com Kimi K3.1 Pro.
O que fazer quando todas as requisições já falham?
Primeiro, confirme se a falha é uma rejeição por excesso de contexto. O changelog da versão 2.1.323 descreve erros repetidos, mas não publica uma mensagem universal para o problema.
Os gateways podem retornar mensagens diferentes. A referência da Anthropic para diagnóstico de gateways apresenta exemplos como:
ContextWindowExceededError
e:
prompt token count of N exceeds the limit of M
São exemplos de mensagens do gateway. Elas não são mensagens obrigatórias de erro da versão 2.1.323.
Tente recuperar a sessão sem apagar a conversa de imediato:
- Se ainda conseguir acessar o trabalho, salve o estado da tarefa fora da conversa. Registre os arquivos alterados, os testes executados e a próxima ação.
- Atualize o Claude Code para 2.1.325 ou posterior e confirme a versão instalada.
- Verifique a janela real. Configure
CLAUDE_CODE_MAX_CONTEXT_TOKENSou um limite de compactação adequado antes de reiniciar. - Se a sessão ainda aceitar comandos, tente executar
/compactmanualmente. - Se não conseguir compactar nem continuar, use
/clear. Retome o trabalho a partir do estado salvo.
Um gateway pode reescrever o erro de excesso de contexto em um formato que o Claude Code não reconhece. Nesse caso, a recuperação automática pode não ser acionada.
A versão 2.1.325 corrige muitos desses erros repetidos, mas o changelog não apresenta uma lista completa de gateways compatíveis.
Para um procedimento mais detalhado, incluindo falhas na compactação manual, consulte o guia de recuperação do Claude Code e DeepSeek após erros de tamanho de entrada.
Não configure CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 como solução geral. Segundo a Anthropic, essa variável desativa a compactação preventiva para IDs desconhecidos e espera um erro reconhecível da API. Se o gateway alterar a mensagem, a recuperação pode ficar menos confiável.
Por que algumas instruções ainda dizem que modelos desconhecidos usam 200K?
A documentação mudou durante esse período de lançamentos.
O texto de configuração consultado em 2026-11-13 ainda mencionava uma janela presumida de 200K. Já a página atual de configuração de modelos, verificada em 2026-11-15, mostrava context assumed to be 1m tokens no aviso sobre IDs desconhecidos.
Não use a mensagem antiga de 200K como prova do comportamento atual. Confira sua versão instalada, o aviso exibido na sessão e as configurações efetivas.
Quando o Claude Code reconhece o ID ou aceita a janela informada, o aviso pode desaparecer. Isso confirma a configuração do cliente, mas não prova que o gateway processe requisições com todo aquele contexto.
Qual configuração usar em cada cenário?
Para um ID desconhecido cuja rota aceita menos de 1M, use Claude Code 2.1.325 ou posterior e declare a janela efetiva confirmada. Adicione compactação antecipada se precisar deixar espaço para a saída do modelo.
Para um gateway com limite confirmado de 200K, CLAUDE_CODE_DISABLE_1M_CONTEXT=1 é uma solução rápida. Uma janela explícita e um limite de compactação antecipado oferecem mais controle.
Se o modelo e a rota realmente aceitarem 1M, mantenha essa capacidade. Reduza a janela apenas se preferir sessões mais curtas ou se o gateway impuser um limite inferior.
Para IDs desconhecidos com [1m] e IDs reconhecidos como modelos Claude, siga as regras específicas da Anthropic. Não presuma que uma única variável altere a janela em todos os casos.
Configure o Claude Code de acordo com o limite aceito pela rota de API que você realmente utiliza, e não apenas pela estimativa padrão do cliente.