Claude Code 2.1.323 : corriger les erreurs de contexte 1M

Claude Code 2.1.323 a fait passer de 200K à 1M tokens la fenêtre de contexte présumée pour les identifiants de modèles inconnus. Sur une passerelle dont la limite réelle est inférieure, les longues sessions peuvent échouer à chaque tour. Découvrez le correctif de la version 2.1.325, les conditions d'utilisation de CLAUDE_CODE_MAX_CONTEXT_TOKENS, le réglage de /autocompact, un exemple BetterToken avec DeepSeek ou Kimi et la procédure de récupération d'une session bloquée.

Sommaire
Claude Code 2.1.323 : corriger les erreurs de contexte 1M

Claude Code 2.1.323 a modifié la fenêtre de contexte présumée pour les identifiants de modèles inconnus : elle est passée de 200K à 1M tokens. Si votre modèle tiers ou votre passerelle API accepte moins de tokens, Claude Code risque de compacter l’historique trop tard et de rencontrer une erreur à chaque requête. Mettez Claude Code à jour vers la version 2.1.325 ou une version ultérieure, puis définissez la fenêtre réelle du modèle ou un seuil de compactage plus précoce.

Ne limitez pas systématiquement toutes vos sessions DeepSeek, GLM ou Kimi à 200K. Certains modèles disposent réellement d’une fenêtre de 1M tokens. Les restreindre inutilement oblige Claude Code à résumer plus tôt des informations utiles sur votre code et votre projet.

Ce guide explique les changements intervenus entre les versions 2.1.323 et 2.1.325, les différentes configurations possibles et les moyens de récupérer une session qui échoue déjà.

Qu’ont changé Claude Code 2.1.323, 2.1.324 et 2.1.325 ?

La version 2.1.323 a introduit la nouvelle valeur par défaut. Les deux versions suivantes ont corrigé des comportements associés aux identifiants personnalisés et aux erreurs de contexte des passerelles.

Le journal officiel des modifications de Claude Code détaille ces changements :

VersionChangement lié au contexteAction recommandée
2.1.323Les identifiants inconnus se voient désormais attribuer une fenêtre présumée de 1M au lieu de 200K tokens.Vérifiez la limite réelle du modèle avant une longue session.
2.1.323Sur des modèles tiers à fenêtre plus petite, chaque tour peut échouer une fois le contexte rempli, jusqu’à l’exécution de /clear.Configurez la fenêtre avant de la saturer.
2.1.324CLAUDE_CODE_MAX_CONTEXT_TOKENS s’applique aussi aux identifiants inconnus commençant par claude-.Mettez le client à jour si votre passerelle utilise un tel alias.
2.1.325Correction d’un problème qui provoquait, sur de nombreuses passerelles tierces et installations Foundry, des erreurs de longueur de contexte à chaque tour au lieu d’un compactage.Essayez la mise à jour avant des solutions plus contraignantes.

Au 2026-11-15, npm indiquait 2.1.325 sous le tag latest et 2.1.311 sous stable pour le paquet @anthropic-ai/claude-code.

La version stable 2.1.311 n’intègre pas le changement de comportement de 2.1.323. Elle ne bénéficie pas non plus des correctifs apportés ensuite.

Commencez par vérifier la version installée :

claude --version

Pour une installation native de Claude Code, utilisez la commande de mise à jour documentée :

claude update
claude --version

Si vous avez volontairement choisi le canal stable, vérifiez la version de votre exécutable avant de modifier les paramètres. Le comportement du paquet latest ne s’applique pas nécessairement à votre installation.

Anthropic précise que le correctif 2.1.325 résout le problème sur de nombreuses passerelles. Rien ne garantit qu’il fonctionne avec toutes les passerelles ni qu’il détecte une limite imposée par un serveur intermédiaire.

Pourquoi un identifiant de modèle inconnu peut-il bloquer une longue session ?

Claude Code s’appuie sur son catalogue de modèles reconnus et sur sa configuration locale pour décider à quel moment compacter une conversation.

Le compactage résume les messages précédents afin que la requête suivante tienne dans la fenêtre de contexte. Avec une passerelle, le nom exposé au client peut être différent de celui du modèle réel. Claude Code ne sait alors pas toujours quelle fenêtre utiliser.

Imaginons qu’une passerelle propose my-coding-model, avec une limite effective de 200,000 tokens.

Avant 2.1.323, Claude Code supposait une fenêtre de 200K pour cet identifiant inconnu. Depuis 2.1.323, il suppose 1M, sauf si une autre configuration modifie cette valeur.

La capacité du modèle et celle de la passerelle n’ont pas augmenté. Seule l’estimation effectuée par Claude Code a changé.

Lorsque l’historique dépasse la limite acceptée par la passerelle, l’API peut rejeter la requête. La conversation trop longue reste toutefois présente dans la session. Le tour suivant risque donc d’échouer pour la même raison.

Anthropic décrit explicitement ce scénario dans le journal de la version 2.1.323. La version 2.1.325 améliore la récupération sur de nombreuses passerelles. Si votre route API possède une fenêtre inférieure, vous devez néanmoins déclarer cette limite.

Quels identifiants de modèles sont concernés ?

Le risque apparaît lorsque la fenêtre présumée par Claude Code dépasse le contexte que la route API peut réellement traiter.

Examinez notamment les cas suivants :

  • Un identifiant de modèle non-Claude, comme deepseek-v4.1-flash-1017 ou kimi-k3.1-pro, si Claude Code ne le reconnaît pas.
  • Un alias de passerelle, tel que my-coding-model, même si le serveur utilise en réalité un modèle Claude.
  • Un identifiant inconnu commençant par claude-, par exemple claude-sonnet-latest. La version 2.1.324 a changé les règles applicables à cette catégorie.
  • Un identifiant comportant le suffixe [1m], pour lequel les règles de remplacement sont particulières.

Un identifiant inconnu ne suffit pas à prouver une erreur de fenêtre de contexte.

Si le modèle et la route API acceptent réellement 1M tokens, la nouvelle valeur par défaut peut convenir. Le problème survient lorsqu’une limite inférieure est appliquée par le modèle, la passerelle ou le déploiement.

Il faut également distinguer un alias inconnu d’un identifiant que Claude Code associe à un modèle Claude reconnu. Le client peut reconnaître un nom Anthropic inclus dans l’identifiant d’un autre fournisseur. Cela change la façon dont les variables de configuration s’appliquent.

Consultez la documentation d’Anthropic sur la fenêtre des modèles personnalisés avant de déduire le comportement d’un modèle à partir de son nom.

Quelle correction choisir pour la fenêtre de contexte ?

Utilisez CLAUDE_CODE_MAX_CONTEXT_TOKENS si vous connaissez la limite réelle et si l’identifiant accepte ce remplacement. Pour revenir rapidement à 200K, choisissez CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Si vous souhaitez conserver une marge avant la limite, avancez le déclenchement du compactage automatique.

CorrectionCas d’utilisationLimite ou compromis
CLAUDE_CODE_DISABLE_1M_CONTEXT=1La fenêtre réelle atteint au moins 200K et vous voulez retrouver l’ancienne restriction.Réduit aussi à 200K certains modèles capables de traiter 1M. Insuffisant pour une fenêtre inférieure à 200K.
CLAUDE_CODE_MAX_CONTEXT_TOKENSVous connaissez la fenêtre réelle d’un modèle inconnu ou d’un alias de passerelle.Son application dépend de la reconnaissance de l’ID, de la version et de [1m].
/autocompact, --autocompact ou CLAUDE_CODE_AUTO_COMPACT_WINDOWVous voulez compacter avant d’atteindre la fenêtre présumée.La plage configurable commence à 100K. Le seuil doit rester adapté à la limite réelle.

Ces paramètres n’ont pas la même fonction. Le premier impose une restriction de 200K. Le deuxième modifie la capacité présumée du modèle. Le troisième fixe le moment où la conversation est compactée.

Correction 1 : rétablir la restriction de 200K

Si votre modèle ou votre passerelle accepte au moins 200K tokens, lancez Claude Code depuis Bash avec :

export CLAUDE_CODE_DISABLE_1M_CONTEXT=1
claude

C’est la solution provisoire proposée par Anthropic dans le journal des modifications de 2.1.323.

Pour conserver le réglage entre les sessions, ajoutez la variable sous env dans ~/.claude/settings.json :

{
  "env": {
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
  }
}

Lorsque cette variable est active, Claude Code retire également les variantes [1m] de son sélecteur de modèles.

Sur les modèles qui possèdent normalement une fenêtre native de 1M, le compactage automatique maintient les sessions à la limite de 200K. Si le compactage est désactivé, la session s’arrête à la frontière applicable avec une erreur de contexte.

Une exception importante concerne les identifiants inconnus. Un autre paramètre peut empêcher la restriction de 200K de fonctionner.

Si vous voyez cet avertissement :

CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it.

Vérifiez si vous avez augmenté CLAUDE_CODE_MAX_CONTEXT_TOKENS au-delà de 200K ou désactivé l’application préventive de la fenêtre pour les modèles inconnus.

La référence officielle des erreurs recommande de définir CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 si vous devez garantir le compactage à cette limite.

N’utilisez pas cette correction seule lorsque votre passerelle accepte moins de 200K tokens.

Correction 2 : déclarer la fenêtre réelle avec CLAUDE_CODE_MAX_CONTEXT_TOKENS

Cette solution est plus précise lorsque vous connaissez la limite de votre route API.

Supposons que l’administrateur confirme une fenêtre effective de 200,000 tokens pour un modèle personnalisé. Définissez la variable dans le shell Bash qui démarre Claude Code :

export CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000
claude

La valeur 200,000 est un exemple hypothétique. Elle ne représente ni une recommandation générale ni une limite vérifiée pour DeepSeek, GLM ou Kimi.

Pour un identifiant inconnu qui ne commence pas par claude- et ne contient pas [1m], la variable s’applique directement. Claude Code conserve le compactage préventif en utilisant la fenêtre déclarée.

La documentation officielle sur les identifiants compatibles avec cette variable décrit deux exceptions :

  • Si un identifiant inconnu contient [1m], définissez aussi CLAUDE_CODE_DISABLE_1M_CONTEXT=1 pour corriger une fenêtre plus petite tout en conservant le compactage préventif.
  • Si l’identifiant correspond à un modèle Claude reconnu, le remplacement n’agit qu’avec DISABLE_COMPACT. Cette variable désactive entièrement le compactage. Ce n’est donc pas la solution à privilégier pour des sessions longues ordinaires.

Depuis 2.1.324, les identifiants inconnus commençant par claude- acceptent directement ce remplacement. Les versions antérieures peuvent se comporter autrement.

Si votre passerelle utilise un alias pour un véritable modèle Claude, les paramètres modelOverrides ou modelPicker.behavesAs peuvent établir la correspondance avec le modèle reconnu.

N’attribuez pas une identité Claude à un modèle non-Claude simplement pour supprimer un avertissement.

La bonne valeur est la limite effective de la route API sélectionnée. Si la passerelle impose un plafond inférieur à celui annoncé pour le modèle, utilisez le plafond de la passerelle.

Correction 3 : compacter plus tôt avec /autocompact

Un seuil plus précoce laisse à Claude Code le temps de résumer la conversation avant le rejet d’une requête par la passerelle.

Pour une route dont la limite réelle de 200K a été confirmée, voici un exemple prudent :

/autocompact 150k

Exécutez la commande dans Claude Code. En règle générale, elle enregistre le seuil pour le modèle courant dans modelSettings et l’applique à la session active.

Lisez la réponse de /autocompact pour vérifier quel seuil est réellement actif. Un niveau de configuration plus prioritaire, par exemple les paramètres gérés par un administrateur, peut conserver une autre valeur. Cela reste possible même si votre seuil a été enregistré. La commande vous signale cette situation.

Si des paramètres administrés empêchent votre choix de s’appliquer, demandez à l’administrateur de vérifier la politique. Selon la documentation d’Anthropic sur le compactage automatique, l’option de lancement --autocompact n’est pas supplantée par ces paramètres administrés.

Pour un seul démarrage :

claude --autocompact 150k

Pour un script, un conteneur ou un environnement automatisé :

export CLAUDE_CODE_AUTO_COMPACT_WINDOW=150000
claude

La commande /autocompact et l’option --autocompact acceptent de 100K à 1M tokens. La variable CLAUDE_CODE_AUTO_COMPACT_WINDOW accepte les valeurs de 100000 à 1000000.

Si Claude Code accepte la valeur de la variable d’environnement, celle-ci prévaut sur la commande, l’option de lancement et les préférences enregistrées. Dans ce cas, /autocompact indique qu’un remplacement est actif et n’enregistre pas une nouvelle valeur.

Vous pouvez aussi définir autoCompactWindow dans ~/.claude/settings.json pour tous les modèles. Au sein d’un même niveau de configuration, une valeur propre au modèle enregistrée avec /autocompact est prioritaire sur la valeur générale.

150k est uniquement un exemple laissant une marge pour une route acceptant 200K. Il ne faut pas supposer que ce seuil convient à un modèle dont la fenêtre est plus petite.

La valeur configurable minimale est 100K. Si votre modèle accepte moins, examinez les règles de remplacement de l’identifiant et le comportement effectif du client. Ne partez pas du principe que /autocompact 50k est autorisé.

Exemple BetterToken : connecter Claude Code à DeepSeek ou Kimi

BetterToken fournit une API compatible avec Anthropic à l’adresse https://bettertoken.ai pour les modèles pris en charge. Avec Claude Code, ANTHROPIC_BASE_URL ne doit pas contenir /v1.

Il faut distinguer les intégrations décrites par BetterToken du support officiel d’Anthropic. Dans sa documentation sur les passerelles LLM, Anthropic précise qu’elle ne prend pas en charge l’acheminement de Claude Code vers des modèles non-Claude par quelque passerelle que ce soit.

BetterToken documente sa propre intégration tierce. Cela ne signifie pas qu’Anthropic prend officiellement en charge l’utilisation de DeepSeek ou de Kimi dans Claude Code. Vérifiez la compatibilité des modèles, les appels d’outils et les limites de la route utilisée.

D’après les données de BetterToken consultées le 2026-11-15 :

BetterToken Model IDContexte annoncé du modèleRoute Anthropic Messages
deepseek-v4.1-flash-10171M tokensRépertoriée
kimi-k3.1-pro1M tokensRépertoriée
glm-5.31M tokensNon répertoriée pour ce modèle ; la fiche indique un accès compatible OpenAI
qwen3.8-max1,000,000 tokensNon répertoriée pour ce modèle ; la fiche indique un accès compatible OpenAI

Ces fenêtres annoncées ne sont pas nécessairement inférieures à la nouvelle valeur de 1M utilisée par Claude Code. La limite réellement appliquée peut néanmoins varier selon le fournisseur ou la route API.

La présence d’un modèle dans le catalogue BetterToken ne prouve pas non plus qu’il soit accessible avec tous les protocoles. Consultez le catalogue actuel des modèles avant de choisir une route pour Claude Code.

L’exemple Bash suivant utilise l’identifiant DeepSeek disposant d’une route Anthropic documentée. Il suit le guide d’intégration de BetterToken pour Claude Code.

Installez d’abord Claude Code et créez votre propre API Key dans la console BetterToken. Exécutez ensuite les commandes dans un shell Bash dédié :

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

Lorsque la première commande attend une saisie, collez la clé créée dans votre console, puis validez. Sa valeur ne s’affiche pas et n’apparaît pas directement dans la ligne de commande.

ANTHROPIC_AUTH_TOKEN fournit le jeton d’authentification. Les trois variables ANTHROPIC_DEFAULT_*_MODEL dirigent les rôles intégrés Haiku, Sonnet et Opus vers le modèle BetterToken sélectionné. Vous pourrez ensuite affecter différents modèles compatibles à ces rôles.

Pour utiliser Kimi, définissez ANTHROPIC_MODEL sur kimi-k3.1-pro avant d’exporter les trois variables de rôle.

Si vous avez déjà exécuté la configuration DeepSeek, relancez les quatre commandes suivantes dans le même shell Bash. Démarrez ensuite un nouveau processus 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"

Changer uniquement ANTHROPIC_MODEL ne modifie pas les trois variables précédemment exportées. Elles continueraient à désigner DeepSeek. La documentation BetterToken de Kimi K3.1 Pro confirme l’identifiant du modèle et son chemin d’intégration avec Claude Code.

Pour un identifiant inconnu sans [1m], vous pouvez déclarer explicitement une fenêtre vérifiée. Si la route accepte réellement 1,000,000 tokens :

export CLAUDE_CODE_MAX_CONTEXT_TOKENS=1000000

Définissez cette valeur avant le lancement de Claude Code. Si votre passerelle applique une limite inférieure, remplacez 1000000 par sa valeur confirmée. Vous pouvez aussi choisir un seuil de compactage plus précoce.

N’appliquez pas automatiquement cet exemple à 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

La première variable indique la fenêtre effective. La seconde laisse une marge avant le compactage. Pour une autre limite, vérifiez les deux valeurs séparément.

Comment vérifier le modèle et la route de la passerelle ?

Après avoir démarré Claude Code, exécutez :

/status

Vérifiez que Anthropic base URL affiche https://bettertoken.ai et que l’authentification utilise ANTHROPIC_AUTH_TOKEN.

Contrôlez ensuite le modèle actif. Si nécessaire, choisissez l’identifiant voulu avec /model. Si vous avez modifié les variables de rôle, redémarrez Claude Code afin que le nouveau processus récupère leurs valeurs.

La requête claude -p "Reply with only: OK" utilisée plus haut vérifie la connexion de base et l’accès au modèle. Une réponse normale confirme uniquement le succès d’une requête courte. Elle ne démontre pas que les longs contextes fonctionnent.

Pour un test plus représentatif d’une tâche de programmation, demandez à Claude Code de lire un petit fichier du dépôt et d’expliquer une fonction précise, sans la modifier. Vérifiez que la réponse mentionne le bon fichier.

Si la connexion ou l’authentification échoue, résolvez d’abord ce problème. Le guide de diagnostic des erreurs 403 de Claude Code traite ces échecs séparément.

Pour approfondir la configuration de DeepSeek et le choix du modèle, consultez le guide d’intégration de Claude Code avec DeepSeek. Pour les particularités de Kimi, utilisez le guide de programmation avec Kimi K3.1 Pro.

Que faire si toutes les requêtes échouent déjà ?

Commencez par vérifier que le rejet concerne bien la longueur du contexte. Le journal de 2.1.323 décrit des échecs répétés, mais ne fournit pas de message d’erreur universel.

Les passerelles peuvent renvoyer des messages différents. La référence d’Anthropic sur le dépannage des passerelles cite notamment :

ContextWindowExceededError

et :

prompt token count of N exceeds the limit of M

Ce sont des exemples de messages provenant des passerelles. Ils ne constituent pas des messages garantis pour le problème introduit dans 2.1.323.

Essayez les opérations qui préservent le plus possible votre travail, dans cet ordre :

  1. Si vous pouvez encore consulter la session, sauvegardez l’état de la tâche en dehors de la conversation. Notez les fichiers modifiés, les résultats des tests et l’étape suivante.
  2. Mettez Claude Code à jour vers 2.1.325 ou une version ultérieure, puis confirmez la version installée.
  3. Vérifiez la limite réelle de la passerelle. Définissez CLAUDE_CODE_MAX_CONTEXT_TOKENS ou un seuil de compactage adapté avant de relancer le client.
  4. Si la session accepte encore les commandes, essayez /compact manuellement.
  5. Si vous ne pouvez plus compacter ou poursuivre la conversation, utilisez /clear. Reprenez ensuite à partir de l’état sauvegardé.

Une passerelle peut reformuler l’erreur de contexte trop long avec des termes que Claude Code ne reconnaît pas. Dans ce cas, le compactage et la nouvelle tentative automatiques peuvent ne pas se déclencher.

La version 2.1.325 corrige de nombreux échecs de ce type, mais le journal des modifications ne fournit pas une liste exhaustive des passerelles compatibles.

Pour une procédure plus complète, notamment si le compactage manuel échoue, consultez le guide de récupération de Claude Code et DeepSeek après une erreur de longueur d’entrée.

N’utilisez pas CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 comme solution générale. D’après Anthropic, cette variable désactive le compactage préventif des identifiants inconnus. Le client attend alors une erreur API qu’il peut reconnaître. Si la passerelle en modifie le format, la récupération peut devenir moins fiable.

Pourquoi certains guides indiquent-ils encore 200K pour les modèles inconnus ?

La documentation a évolué pendant cette série de versions.

Le texte de configuration consulté le 2026-11-13 indiquait encore une fenêtre présumée de 200K pour les identifiants inconnus. En revanche, la page de configuration des modèles, vérifiée le 2026-11-15, affichait déjà context assumed to be 1m tokens dans l’avertissement.

N’utilisez pas les anciens avertissements mentionnant 200K pour déterminer le comportement actuel. Vérifiez la version installée, l’avertissement réellement affiché et les paramètres effectifs.

Lorsqu’un modèle est reconnu ou qu’une fenêtre correcte est déclarée, l’avertissement peut disparaître. Cela signifie que Claude Code a accepté sa configuration. Cela ne prouve pas que la passerelle puisse traiter une requête atteignant cette taille.

Configuration recommandée selon le scénario

Pour un identifiant inconnu dont la passerelle accepte moins de 1M, utilisez Claude Code 2.1.325 ou une version ultérieure et déclarez la fenêtre effective vérifiée. Ajoutez un seuil de compactage plus précoce si vous devez conserver de la place pour la sortie du modèle.

Pour une passerelle dont la limite de 200K est confirmée, CLAUDE_CODE_DISABLE_1M_CONTEXT=1 fournit une solution rapide. Définir précisément la fenêtre et le seuil de compactage donne davantage de contrôle.

Si le modèle et la route API prennent réellement en charge 1M, conservez cette capacité. Réduisez-la uniquement si vous préférez des sessions plus courtes ou si la passerelle impose un plafond inférieur.

Pour les identifiants inconnus contenant [1m] et les modèles Claude reconnus, suivez les règles particulières d’Anthropic. Ne supposez pas qu’une seule variable modifie toutes les fenêtres.

Adaptez les paramètres de Claude Code à la limite réellement acceptée par votre route API, plutôt qu’à la valeur estimée par défaut.

Prêt à optimiser votre workflow LLM ?

Connectez vos modèles via une API unique, gérez les clés et maîtrisez vos dépenses d’IA.

Commencer gratuitement