Comprendre CLAUDE_CODE_MAX_OUTPUT_TOKENS : limites de sortie et dossiers de plugins dans Claude Code 2.1.265

Ce que contrôle claude_code_max_output_tokens

La référence des variables d’environnement décrit CLAUDE_CODE_MAX_OUTPUT_TOKENS comme définissant « le nombre maximal de tokens de sortie pour la plupart des requêtes ». Cette formulation est importante : elle décrit un budget de sortie par requête, avec des valeurs par défaut et des plafonds qui varient selon le modèle.

Cette variable est donc pertinente lorsque l’on examine une limite de sortie de Claude Code. Elle ne doit pas être considérée comme une limite universelle pour tous les types de données que Claude Code traite. La version 2.1.265 introduit également une limite de stockage sur disque pour les résultats d’outils enregistrés, mais cette limite mesure les données d’outils stockées en gigaoctets, et non la sortie générée en tokens.

Une réserve historique s’applique à la documentation de configuration. La référence des variables d’environnement est mise à jour en continu, et sa révision exacte du 10 septembre n’a pas pu être retrouvée. Sa description explique le rôle de la variable, mais la page ne permet pas d’établir toutes les valeurs par défaut qui s’appliquaient à Claude Code 2.1.265.

Pour un article daté, les éléments chiffrés les plus solides proviennent des notes de version associées à des tags de version. Ces notes établissent des changements antérieurs précis sans qu’il soit nécessaire de déduire un tableau complet des valeurs par défaut à partir de la documentation actuelle.

Trois limites à distinguer

Lorsque vous diagnostiquez une limite, commencez par déterminer laquelle s’applique. Un paramètre de budget de tokens et un plafond de stockage sur disque nécessitent des interprétations différentes, même s’ils apparaissent tous deux au cours de la même session de développement.

Valeurs par défaut et limites maximales de sortie vérifiées

Le notes de version de la v2.1.77, datées du 17 mars 2026, documentent deux changements pertinents : la valeur par défaut de Claude Opus 4.6 est passée à 64k tokens de sortie, et la limite supérieure pour Opus 4.6 et Sonnet 4.6 est passée à 128k tokens. Ces changements figurent également dans le journal des modifications associé au tag v2.1.265.

Ces éléments excluent de présenter « 32,000 par défaut, 64,000 au maximum » comme une règle universelle de Claude Code. Ils ne justifient pas non plus de compléter les valeurs par défaut manquantes pour les autres modèles.

Il faut bien distinguer un changement documenté d’une référence de configuration complète. La version de mars établit les changements ci-dessus ; les sources datées disponibles ne permettent pas d’établir un tableau complet des valeurs par défaut, modèle par modèle, pour la v2.1.265.

Les spécifications des modèles plus récents n’établissent pas les valeurs par défaut du CLI

Le notes de version des modèles documentent une sortie maximale de 128k et une fenêtre de contexte de 1 million de tokens pour Claude Sonnet 5, Claude Opus 5 et Claude Fable 5.1. Leurs identifiants API exacts sont claude-sonnet-5, claude-opus-5, ainsi que claude-fable-5-1, respectivement.

Ces annonces étaient disponibles avant la date limite de publication : Sonnet 5 le 30 juin, Opus 5 le 24 juillet et Fable 5.1 le 1 septembre 2026. Toutefois, les spécifications de ces modèles ne constituent pas une preuve du budget par défaut des requêtes de Claude Code.

Pour les développeurs qui choisissent un modèle, le guide des modèles Claude Code propose une lecture complémentaire. Distinguez le maximum publié du modèle du budget de sortie par défaut utilisé par le CLI.

Définir la variable et comprendre la compaction

La documentation actuelle indique qu’il est possible de définir la variable avant de lancer claude, ou de la placer sous la env clé dans settings.json. Comme la révision exacte de la documentation disponible au 10 septembre n’a pas pu être retrouvée, les exemples ci-dessous sont des schémas de configuration documentés, sous réserve de cette précision historique.

Configuration dans le shell

L’exemple de shell fourni définit le budget de sortie à 64,000 tokens :

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000

Le schéma documenté consiste à définir la variable avant de lancer Claude Code. Le nombre de cet exemple est une valeur de configuration choisie ; il ne signifie pas que 64,000 est la valeur par défaut ou le maximum pour chaque modèle.

Lorsque vous consignez la configuration d’un projet ou d’une session de dépannage, indiquez le modèle sélectionné ainsi que le budget demandé. Sans le modèle, une valeur seule ne permet pas de déterminer si elle correspond à une valeur par défaut documentée ou respecte une limite supérieure documentée.

Configuration dans settings.json

L’exemple JSON équivalent fourni place la variable sous env:

{"env":{"CLAUDE_CODE_MAX_OUTPUT_TOKENS":"64000"}}

La valeur est une chaîne de caractères dans cet exemple. Comme pour le paramètre défini dans le shell, cet extrait exprime un budget demandé sans prouver une valeur par défaut propre à un modèle.

Pour des informations connexes sur l’utilisation en ligne de commande, consultez le référence de la CLI de Claude Code. Les éléments historiques présentés ici confirment le rôle de la variable et les exemples de configuration fournis, tout en laissant indéterminées les valeurs par défaut complètes de la v2.1.265.

Qu’est-ce qui est vérifié concernant la compaction ?

Le journal des modifications associé au tag v2.1.265 consigne un correctif antérieur, dans la v2.1.69, concernant CLAUDE_CODE_MAX_OUTPUT_TOKENS qui était ignoré lors de la compaction de la conversation. Il s’agit d’un lien vérifié entre ce paramètre et le comportement de compaction.

La référence actuelle des variables d’environnement explique également qu’augmenter ce paramètre réduit le contexte effectivement disponible avant la compaction automatique. La date de publication de cette explication est incertaine ; elle ne peut donc pas être présentée comme une description vérifiée au 10 septembre.

Ce paramètre ne doit donc pas être décrit comme agrandissant la fenêtre de contexte publiée du modèle. Les éléments datés établissent un contrôle du budget de sortie et un correctif lié à la compaction ; ils n’établissent pas de seuil précis de compaction pour chaque modèle dans la v2.1.265.

Comment Claude Code 2.1.265 charge les dossiers de plugins

Claude Code v2.1.265 a été publié le 8 septembre 2026, avec le commit de publication 8e02f6d. Son changement concernant le chargement des dossiers permet à --plugin-dir de pointer vers un dossier contenant plusieurs plugins.

La commande fournie est la suivante :

claude --plugin-dir ./plugins

La version décrit directement la règle de découverte : « chaque sous-dossier contenant un manifeste est chargé ». Elle précise également que les ajouts et les suppressions sont détectés pendant l’exécution de Claude Code.

Le dossier parent constitue ainsi une unité utile pour gérer plusieurs plugins ensemble. Le comportement documenté concerne les sous-dossiers contenant des manifestes ; les notes de version ne précisent pas si la découverte est récursive. Ne supposez pas qu’une arborescence de répertoires imbriqués à une profondeur quelconque sera parcourue.

Structure du manifeste et réserve historique

La référence actuelle des plugins situe le manifeste à .claude-plugin/plugin.json et les répertoires de composants tels que skills/, commands/, ainsi que hooks/ à la racine du plugin. Aucun instantané daté de cette référence pour la v2.1.265 n’a pu être retrouvé.

Pour l’article du 10 septembre, distinguez ces indications actuelles sur la structure de la garantie explicite de la version : les sous-dossiers contenant des manifestes sont chargés. La version établit la découverte de dossiers contenant plusieurs plugins sans établir tous les détails de la documentation sur la structure disponible à l’époque.

Correctifs de plugins inclus dans la version

La version 2.1.265 corrige également trois problèmes de plugins :

• Un chemin de plugin contenant des barres obliques inverses pouvait contourner les restrictions de confinement des liens symboliques sur macOS et Linux.
• Les répertoires dont le nom commence par deux points étaient rejetés à tort.
• Les dossiers de composants par défaut illisibles étaient ignorés sans avertissement ; ils apparaissent désormais dans /plugin avec un code d’erreur.

Ces correctifs concernent les chemins des plugins et le chargement des composants. Si un dossier de plugin ne se charge pas, ils fournissent un contexte pertinent sur la version, mais le paramètre de tokens de sortie n’explique pas ces problèmes de gestion des répertoires.

Le plafond de 1 Go pour les résultats d’outils enregistrés est une limite distincte

La version 2.1.265 ajoute un plafond de 1 Go pour les résultats d’outils enregistrés sur disque. L’aperçu de la conversation signale la troncature.

Cette limite concerne les données d’outils stockées. CLAUDE_CODE_MAX_OUTPUT_TOKENS concerne le nombre maximal de tokens de sortie pour la plupart des requêtes. La version ne décrit pas la variable d’environnement comme un moyen de contrôler le plafond de stockage sur disque ; augmenter sa valeur ne doit donc pas être présenté comme un remède à la troncature des résultats d’outils enregistrés.

Les notes de version ne précisent pas non plus si le plafond de 1 Go s’applique par résultat, par session ou à un autre regroupement. Conservez cette incertitude lorsque vous documentez le comportement : « plafond de 1 Go pour les résultats d’outils enregistrés sur disque » est la description vérifiée.

Pour le dépannage, il est utile de distinguer les éléments présentés au développeur. Un aperçu de conversation signalant une troncature concerne le nouveau comportement des résultats enregistrés. Une question sur le budget de sortie générée d’un modèle relève du modèle sélectionné et du paramètre de tokens. Un code d’erreur de plugin dans /plugin relève du chargement des plugins.

Il s’agit de contrôles et de diagnostics distincts, introduits ou abordés dans le contexte de la même version. Les traiter séparément évite d’utiliser une modification de la configuration des tokens pour expliquer des comportements sans rapport concernant le stockage ou les dossiers.

La mise à jour corrective de la passerelle disponible au 10 septembre

La version 2.1.266 a également été publiée le 8 septembre ; elle entre donc dans la période couverte par cet article. Le notes de version de la v2.1.266 corriger une régression de l’authentification auprès de la passerelle dans la version v2.1.265, impliquant CLAUDE_CODE_USE_GATEWAY.

L’erreur concernée est « Non connecté à la passerelle Cloud ». Les notes de version précisent qu’aucune modification de la configuration n’est nécessaire.

Pour un développeur qui rencontre précisément cette régression dans la version v2.1.265, la mise à jour corrective est directement pertinente. Augmenter le budget de tokens de sortie ou réorganiser les dossiers de plugins n’est pas la correction documentée.

Les mêmes flux de travail peuvent passer par une passerelle API telle qu’AI Prime Tech ; consultez utiliser Claude Code avec une clé API pour des conseils de configuration connexes. AI Prime Tech exerce ses activités de manière indépendante et n’est affilié ni à Anthropic ni à OpenAI.

Points clés

• CLAUDE_CODE_MAX_OUTPUT_TOKENS définit le nombre maximal de tokens de sortie pour la plupart des requêtes ; les valeurs par défaut et les plafonds varient selon le modèle.
• La version v2.1.77 a porté la valeur par défaut d’Opus 4.6 à 64k et la limite supérieure d’Opus 4.6/Sonnet 4.6 à 128k. Le tableau complet des valeurs par défaut de la version v2.1.265 reste à vérifier.
• Le nombre maximal de tokens de sortie du modèle, sa capacité de contexte et le stockage des résultats d’outils enregistrés correspondent à des limites distinctes.
• Dans la version v2.1.265, --plugin-dir peut charger plusieurs plugins depuis des sous-dossiers contenant des manifestes et détecter les ajouts et les suppressions pendant l’exécution.
• La version v2.1.265 introduit le plafond de 1 Go pour les résultats d’outils enregistrés ; la version v2.1.266 corrige la régression de l’authentification auprès de la passerelle sans nécessiter de modification de la configuration.

FAQ

Que contrôle CLAUDE_CODE_MAX_OUTPUT_TOKENS ?

CLAUDE_CODE_MAX_OUTPUT_TOKENS définit le nombre maximal de tokens de sortie pour la plupart des requêtes. Ses valeurs par défaut et ses plafonds varient selon le modèle, et ce paramètre est distinct du plafond de 1 Go imposé par la version v2.1.265 aux résultats d’outils enregistrés sur disque.

Quelles sont les limites de sortie par défaut et maximales ?

La version v2.1.77 a porté la valeur par défaut de Claude Opus 4.6 à 64k tokens de sortie et la limite supérieure d’Opus 4.6/Sonnet 4.6 à 128k. Les sources datées consultées ne permettent pas d’établir la valeur par défaut de Sonnet 4.6 ni un tableau complet des valeurs par défaut par modèle pour la version v2.1.265.

Augmenter ce paramètre agrandit-il la fenêtre de contexte ?

L’objectif documenté est de définir un budget de tokens de sortie, et non d’agrandir la fenêtre de contexte publiée du modèle. La version v2.1.69 a corrigé le fait que la variable était ignorée lors de la compaction, mais la date de publication de l’explication de son effet sur la compaction automatique dans la documentation en ligne est incertaine.

Comment --plugin-dir découvre-t-il plusieurs plugins ?

Dans Claude Code 2.1.265, --plugin-dir peut pointer vers un dossier parent, et chaque sous-dossier contenant un manifeste est chargé. Les ajouts et les suppressions sont détectés pendant l’exécution de Claude Code ; les notes de version ne précisent pas si la découverte est récursive.