Variables d'environnement
Référence pour les variables d'environnement qui contrôlent le comportement de Claude Code.
Les variables d'environnement peuvent contrôler le comportement de Claude Code, comme la sélection du modèle, l'authentification, le routage des requêtes et les bascules de fonctionnalités. Beaucoup des mêmes comportements peuvent également être configurés via un fichier de paramètres, un drapeau CLI ou une commande en session comme /model.
Cette page couvre comment :
- Définir les variables d'environnement dans votre shell ou dans un fichier de paramètres
- Vérifier quelle valeur s'applique quand un comportement peut être défini de plusieurs façons
- Consulter les variables que Claude Code lit
- Voir quelles fonctionnalités cessent de fonctionner quand une variable désactive la récupération des drapeaux de fonctionnalités
Définir les variables d'environnement
Une variable que vous définissez dans votre shell dure pendant cette session de terminal, tandis qu'une variable dans un fichier de paramètres s'applique chaque fois que claude s'exécute.
Dans votre shell
Définissez la variable avant de lancer claude :
export API_TIMEOUT_MS="1200000"
claude
Pour la définir pour chaque session, ajoutez la ligne export à ~/.bashrc, ~/.zshrc, ou le fichier de profil de votre shell.
$env:API_TIMEOUT_MS = "1200000"
claude
Pour la définir pour chaque session, exécutez [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") et ouvrez un nouveau terminal.
set API_TIMEOUT_MS=1200000
claude
Pour la définir pour chaque session, exécutez setx API_TIMEOUT_MS "1200000" et ouvrez un nouveau terminal.
La ligne d'assignation n'affiche rien en cas de succès, donc confirmez que la variable est définie en l'affichant dans le même shell avant d'exécuter claude :
echo $API_TIMEOUT_MS
echo $env:API_TIMEOUT_MS
echo %API_TIMEOUT_MS%
Dans les fichiers de paramètres
Ajoutez les variables sous la clé env dans un fichier settings.json, en créant le fichier s'il n'existe pas. Claude Code les lit directement depuis le fichier, donc elles prennent effet peu importe comment claude a été lancé. Une session en cours applique les valeurs nouvelles et modifiées à son environnement lorsque vous enregistrez le fichier, mais une fonctionnalité qui lit ses variables une seule fois au démarrage, comme la surveillance OpenTelemetry, conserve ses valeurs de démarrage jusqu'à ce que vous relancez. Supprimer une variable du fichier ne la désactive pas dans une session en cours ; la suppression prend effet la prochaine fois que vous lancez claude.
{
"env": {
"API_TIMEOUT_MS": "1200000",
"BASH_DEFAULT_TIMEOUT_MS": "300000"
}
}
Le fichier que vous choisissez contrôle à qui les variables s'appliquent :
| Fichier | S'applique à |
|---|---|
~/.claude/settings.json |
Vous, dans chaque projet |
.claude/settings.json |
Tous ceux qui travaillent dans le projet, archivé dans le contrôle de source |
.claude/settings.local.json |
Vous, dans ce projet uniquement, ignoré par git lorsque Claude Code enregistre un paramètre ; ajoutez-le à votre gitignore si vous le créez manuellement |
| Paramètres gérés | Tous les membres de votre organisation, déployés par un administrateur |
Consultez Fichiers de paramètres pour savoir où se trouve chaque fichier et Précédence des paramètres pour savoir comment ils se combinent lorsque plusieurs définissent la même variable.
Précédence
Certains comportements ont à la fois une variable d'environnement et une clé de paramètres dédiée, et celle que Claude Code lit en premier diffère selon la clé. Pour ANTHROPIC_MODEL et CLAUDE_CODE_AUTO_CONNECT_IDE, Claude Code lit d'abord la variable et utilise le paramètre model ou autoConnectIde uniquement lorsque la variable n'est pas définie. Pour la paire que vous définissez, vérifiez la ligne de la variable ci-dessous et l'entrée de la clé sur la référence des paramètres.
Lorsque la même variable est définie à la fois dans votre shell et dans un bloc env du fichier de paramètres, la valeur du fichier de paramètres s'applique. Claude Code écrit chaque entrée env dans l'environnement du processus, en remplaçant la valeur héritée du shell. Le paramètre env indique quand il les applique. Quelques variables sont traitées de manière spéciale ; le paramètre env énumère les exceptions.
Dans un fichier de paramètres, vous pouvez définir une variable mais vous ne pouvez pas en supprimer une. Pour remplacer une variable que vous ne pouvez pas désactiver, comme une CLAUDE_CODE_USE_VERTEX obsolète exportée par un profil de shell que vous ne contrôlez pas, définissez-la sur une chaîne vide dans le bloc env : "CLAUDE_CODE_USE_VERTEX": "". Claude Code traite la valeur vide comme non définie pour la sélection du fournisseur. Les sous-processus héritent toujours de la valeur vide.
Entre les fichiers de paramètres, les valeurs env suivent la précédence des paramètres, de sorte qu'une entrée de paramètres gérée remplace la même variable dans les paramètres utilisateur ou projet.
La façon dont une variable d'environnement interagit avec les drapeaux CLI et les commandes en session varie selon la fonctionnalité : --model et /model remplacent ANTHROPIC_MODEL, tandis que CLAUDE_CODE_EFFORT_LEVEL remplace --effort et /effort. Lorsqu'une variable interagit avec une autre source de configuration, sa ligne dans la liste Variables indique la précédence ou établit un lien vers la page qui la documente.
Claude Code lit les variables d'environnement du shell au démarrage, de sorte que les modifications apportées à celles-ci prennent effet la prochaine fois que vous lancez claude. Les variables définies sous la clé env dans les fichiers de paramètres sont réappliquées à une session en cours lorsque le fichier change, à l'exception du démarrage uniquement décrite dans Dans les fichiers de paramètres.
Variables
Les variables numériques telles que les délais d'expiration, les budgets de jetons et les nombres de tentatives acceptent la notation scientifique et les orthographes avec séparateurs de chiffres en plus des chiffres simples, sauf si la ligne d'une variable indique qu'elle n'accepte que des chiffres simples. Par exemple, Claude Code lit 2e3 comme 2000 et 64_000 comme 64000. Avant la v2.1.211, ces orthographes pouvaient définir silencieusement une valeur beaucoup plus petite, comme 1e6 définissant un délai d'expiration à 1.
Pour les variables qui activent ou désactivent un comportement, définissez 1 ou true pour l'activer et 0 ou false pour le désactiver, dans n'importe quelle casse.
Certaines variables ne lisent que si vous les avez définies, donc toute valeur non vide, y compris 0, active le comportement, et vous désactivez le comportement en supprimant la variable ou en la définissant sur une valeur vide. Ces variables fonctionnent de cette façon :
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICDISABLE_TELEMETRYDISABLE_ERROR_REPORTINGCLAUDE_CODE_TMUX_TRUECOLORFALLBACK_FOR_ALL_PRIMARY_MODELSIS_DEMO
Une autre variable a sa propre règle : FORCE_HYPERLINK lit un nombre, donc seul 0 la désactive. La ligne de chaque variable énonce également sa propre règle.
| Variable | Objectif |
|---|---|
ANTHROPIC_API_KEY |
Clé API envoyée en tant qu'en-tête X-Api-Key. Lorsqu'elle est définie, cette clé est utilisée à la place de votre abonnement Claude Pro, Max, Team ou Enterprise, même si vous êtes connecté. En mode non interactif (-p), la clé est toujours utilisée lorsqu'elle est présente. En mode interactif, vous êtes invité à approuver la clé une fois avant qu'elle ne remplace votre abonnement. Pour utiliser votre abonnement à la place, exécutez unset ANTHROPIC_API_KEY |
ANTHROPIC_AUTH_TOKEN |
Valeur personnalisée pour l'en-tête Authorization (la valeur que vous définissez ici sera préfixée par Bearer ) |
ANTHROPIC_AWS_API_KEY |
Clé API d'espace de travail pour Claude Platform on AWS, générée dans la console AWS. Envoyée en tant que x-api-key et a la priorité sur AWS SigV4 |
ANTHROPIC_AWS_BASE_URL |
Remplacez l'URL du point de terminaison Claude Platform on AWS. Utilisez pour les régions personnalisées ou lors du routage via une passerelle LLM. Par défaut https://aws-external-anthropic.{region}.api.aws. Claude Code résout la région avec la même priorité que sur Amazon Bedrock |
ANTHROPIC_AWS_WORKSPACE_ID |
Requis pour Claude Platform on AWS. Envoyé à chaque requête en tant qu'en-tête anthropic-workspace-id |
ANTHROPIC_BASE_URL |
Remplacez le point de terminaison API pour router les requêtes via un proxy ou une passerelle. Lorsqu'elle est définie sur un hôte non-tiers, la recherche d'outils MCP est désactivée par défaut. Définissez ENABLE_TOOL_SEARCH=true si votre proxy transfère les blocs tool_reference. À partir de la v2.1.196, Remote Control est désactivé lorsque cela pointe vers un hôte autre que api.anthropic.com, correspondant à son comportement sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry |
ANTHROPIC_BEDROCK_BASE_URL |
Remplacez l'URL du point de terminaison Amazon Bedrock. Utilisez pour les points de terminaison Amazon Bedrock personnalisés ou lors du routage via une passerelle LLM. Voir Amazon Bedrock |
ANTHROPIC_BEDROCK_MANTLE_BASE_URL |
Remplacez l'URL du point de terminaison Amazon Bedrock Mantle. Voir Point de terminaison Mantle |
ANTHROPIC_BEDROCK_REGION_PREFIX |
Préfixe du profil d'inférence inter-régions (us, eu, apac, jp, au ou global) que Claude Code essaie d'abord au lieu de celui dérivé de la région AWS. Ignoré dans les régions AWS GovCloud. Nécessite Claude Code v2.1.224 ou ultérieur. Voir Amazon Bedrock |
ANTHROPIC_BEDROCK_SERVICE_TIER |
Niveau de service Amazon Bedrock (default, flex ou priority). Envoyé en tant qu'en-tête X-Amzn-Bedrock-Service-Tier. Voir Amazon Bedrock |
ANTHROPIC_BETAS |
Liste séparée par des virgules de valeurs d'en-tête anthropic-beta supplémentaires à inclure dans les requêtes API. Claude Code envoie déjà les en-têtes bêta dont il a besoin ; utilisez ceci pour vous inscrire à une bêta API Anthropic avant que Claude Code n'ajoute le support natif. Contrairement au drapeau --betas, qui nécessite l'authentification par clé API, cette variable fonctionne avec toutes les méthodes d'authentification, y compris l'abonnement Claude.ai |
ANTHROPIC_CUSTOM_HEADERS |
En-têtes personnalisés à ajouter aux requêtes (format Name: Value, séparés par des sauts de ligne pour plusieurs en-têtes). Si un nom ou une valeur contient un caractère qu'un en-tête HTTP ne peut pas transporter, comme un guillemet courbe ou un espace de largeur zéro, la requête échoue avec une erreur qui identifie la paire par position. Nécessite Claude Code v2.1.227 ou ultérieur. Valeur d'en-tête de requête invalide énumère l'ensemble exact des caractères et où la vérification s'exécute. Une valeur qui définit un en-tête d'authentification, d'organisation, de locataire, de routage ou de comportement API, comme Authorization ou Host, compte comme un paramètre nécessitant une approbation lorsque les paramètres gérés par le serveur le livrent. À partir des paramètres de projet ou locaux, une telle valeur suit les règles pour quand les valeurs env s'appliquent |
ANTHROPIC_CUSTOM_MODEL_OPTION |
ID de modèle à ajouter en tant qu'entrée personnalisée dans le sélecteur /model. Utilisez ceci pour rendre un modèle non standard ou spécifique à une passerelle sélectionnable sans remplacer les alias intégrés. Voir Configuration du modèle |
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION |
Description d'affichage pour l'entrée de modèle personnalisée dans le sélecteur /model. Par défaut Custom model (<model-id>) lorsqu'il n'est pas défini |
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME |
Nom d'affichage pour l'entrée de modèle personnalisée dans le sélecteur /model. Lorsqu'il n'est pas défini, l'entrée affiche le nom du modèle si Claude Code reconnaît l'ID, et l'ID du modèle sinon |
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES |
Liste séparée par des virgules des capacités que le modèle personnalisé supporte, par exemple effort,thinking. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_FABLE_MODEL |
ID de modèle auquel l'alias fable se résout, et l'ID que Claude Code reconnaît comme un modèle Fable pour le basculement automatique du modèle sur les fournisseurs tiers. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION |
Description d'affichage pour le modèle Fable épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche une description par défaut qui commence par Custom Fable model. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME |
Nom d'affichage pour le modèle Fable épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES |
Liste séparée par des virgules des capacités que le modèle Fable épinglé supporte, par exemple effort,thinking. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
ID de modèle auquel l'alias haiku se résout, également utilisé pour la fonctionnalité d'arrière-plan. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION |
Description d'affichage pour le modèle Haiku épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche une description par défaut qui commence par Custom Haiku model. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME |
Nom d'affichage pour le modèle Haiku épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES |
Liste séparée par des virgules des capacités que le modèle Haiku épinglé supporte, par exemple effort,thinking. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_MODEL |
Modèle sur lequel les nouvelles sessions commencent par défaut. Nécessite Claude Code v2.1.236 ou ultérieur. Voir Définir un modèle par défaut pour les nouvelles sessions |
ANTHROPIC_DEFAULT_OPUS_MODEL |
ID de modèle auquel l'alias opus se résout, et que opusplan utilise tandis que Plan Mode est actif. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION |
Description d'affichage pour le modèle Opus épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche une description par défaut qui commence par Custom Opus model. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME |
Nom d'affichage pour le modèle Opus épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES |
Liste séparée par des virgules des capacités que le modèle Opus épinglé supporte, par exemple effort,thinking. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_SONNET_MODEL |
ID de modèle auquel l'alias sonnet se résout, et que opusplan utilise lorsque Plan Mode n'est pas actif. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION |
Description d'affichage pour le modèle Sonnet épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche une description par défaut qui commence par Custom Sonnet model. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME |
Nom d'affichage pour le modèle Sonnet épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir Configuration du modèle |
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES |
Liste séparée par des virgules des capacités que le modèle Sonnet épinglé supporte, par exemple effort,thinking. Voir Configuration du modèle |
ANTHROPIC_FEDERATION_RULE_ID |
ID de règle de fédération pour Workload Identity Federation. Lorsque vous le définissez avec ANTHROPIC_ORGANIZATION_ID, Claude Code sélectionne les identifiants de fédération, qui ont la priorité sur votre identifiant /login. Voir priorité d'authentification |
ANTHROPIC_FOUNDRY_API_KEY |
Clé API pour l'authentification Microsoft Foundry (voir Microsoft Foundry) |
ANTHROPIC_FOUNDRY_AUTH_TOKEN |
Jeton porteur pour l'authentification Microsoft Foundry, comme un jeton d'accès Microsoft Entra. Claude Code l'envoie en tant qu'en-tête Authorization: Bearer. A la priorité sur ANTHROPIC_FOUNDRY_API_KEY et sur la chaîne d'identifiants par défaut Azure. Voir Microsoft Foundry. Nécessite Claude Code v2.1.203 ou ultérieur |
ANTHROPIC_FOUNDRY_BASE_URL |
URL de base complète pour la ressource Microsoft Foundry (par exemple, https://my-resource.services.ai.azure.com/anthropic). Alternative à ANTHROPIC_FOUNDRY_RESOURCE (voir Microsoft Foundry) |
ANTHROPIC_FOUNDRY_RESOURCE |
Nom de ressource Microsoft Foundry (par exemple, my-resource). Requis si ANTHROPIC_FOUNDRY_BASE_URL n'est pas défini (voir Microsoft Foundry) |
ANTHROPIC_MODEL |
Nom du paramètre de modèle à utiliser (voir Configuration du modèle) |
ANTHROPIC_ORGANIZATION_ID |
ID d'organisation pour Workload Identity Federation. Définissez-le avec ANTHROPIC_FEDERATION_RULE_ID. Voir priorité d'authentification |
ANTHROPIC_PROFILE |
Nom du profil Anthropic avec lequel s'authentifier, comme celui créé par ant auth login ou par connexion à un compte Console sans clé API. Voir priorité d'authentification |
ANTHROPIC_SMALL_FAST_MODEL |
[DÉPRÉCIÉ] Nom du modèle de classe Haiku pour les tâches d'arrière-plan |
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION |
Remplacez la région AWS pour le modèle de classe Haiku lors de l'utilisation d'Amazon Bedrock ou Amazon Bedrock Mantle. Sur Amazon Bedrock, cela ne prend effet que lorsque ANTHROPIC_DEFAULT_HAIKU_MODEL ou le ANTHROPIC_SMALL_FAST_MODEL déprécié est également défini, car Amazon Bedrock exécute autrement les tâches d'arrière-plan sur le modèle Sonnet par défaut ou le modèle principal dans la région de la session |
ANTHROPIC_VERTEX_BASE_URL |
Remplacez l'URL du point de terminaison Google Cloud's Agent Platform. Utilisez pour les points de terminaison Google Cloud's Agent Platform personnalisés ou lors du routage via une passerelle LLM. Voir Google Cloud's Agent Platform |
ANTHROPIC_VERTEX_PROJECT_ID |
ID de projet GCP pour les requêtes Google Cloud's Agent Platform. Remplacé par GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT ou le projet dans votre fichier d'identifiants GOOGLE_APPLICATION_CREDENTIALS. Voir Google Cloud's Agent Platform |
ANTHROPIC_WORKSPACE_ID |
ID d'espace de travail pour workload identity federation. Définissez ceci lorsque votre règle de fédération est limitée à plus d'un espace de travail afin que l'échange de jetons sache quel espace de travail cibler |
API_FORCE_IDLE_TIMEOUT |
Remplacez le délai d'expiration d'inactivité du corps de 5 minutes qui interrompt une réponse de modèle en continu lorsqu'aucun octet n'arrive. Définissez à 0 pour désactiver le délai d'expiration, par exemple lorsqu'une passerelle lente ou un modèle local fait une pause plus longue que 5 minutes entre les chunks, ou 1 pour le maintenir activé pour chaque fournisseur. Lorsqu'il n'est pas défini, le délai d'expiration est actif sur les fournisseurs autres que l'API Anthropic directe et Claude Platform on AWS. Les chiens de garde de flux s'exécutent indépendamment et interrompent une longue pause silencieuse même lorsque vous définissez 0 ici |
API_TIMEOUT_MS |
Délai d'expiration pour les requêtes API en millisecondes (par défaut : 600000, ou 10 minutes ; maximum : 2147483647). Augmentez ceci lorsque les requêtes expirent sur les réseaux lents ou lors du routage via un proxy. Les valeurs au-dessus du maximum débordent la minuterie sous-jacente et causent l'échec immédiat des requêtes |
AWS_BEARER_TOKEN_BEDROCK |
Clé API Amazon Bedrock pour l'authentification (voir Clés API Amazon Bedrock) |
BASH_DEFAULT_TIMEOUT_MS |
Délai d'expiration par défaut pour les commandes bash longues (par défaut : 120000, ou 2 minutes) |
BASH_MAX_OUTPUT_LENGTH |
Nombre maximum de caractères de sortie bash que Claude Code relit dans le résultat d'une commande (par défaut : 30000 ; maximum : 150000). Si vous définissez le paramètre bashOutputMaxChars, Claude Code ignore cette variable. Voir Limites de sortie |
BASH_MAX_TIMEOUT_MS |
Délai d'expiration maximum que le modèle peut définir pour les commandes bash longues (par défaut : 600000, ou 10 minutes). Le plafond effectif est le plus grand de ceci et BASH_DEFAULT_TIMEOUT_MS |
BETA_TRACING_ENDPOINT |
Point de terminaison OTLP pour le traçage bêta détaillé : avec ENABLE_BETA_TRACING_DETAILED=1, les journaux et les traces vont là au lieu des exportateurs configurés. Définissez-le dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignoré dans les paramètres de projet et locaux |
CCR_FORCE_BUNDLE |
Définissez à 1 pour forcer claude --cloud à regrouper et télécharger votre référentiel local même lorsque l'accès GitHub est disponible |
CLAUDECODE |
Définissez à 1 dans les sous-processus que Claude Code génère (outils Bash et PowerShell, sessions tmux, commandes hook, commandes status line, sous-processus serveur MCP stdio). Les extensions IDE définissent également ceci dans leurs terminaux intégrés. Utilisez pour détecter quand un script s'exécute à l'intérieur d'un sous-processus généré par Claude Code. Pour vérifier si le processus actuel a été généré directement par un appel d'outil ou un hook, plutôt qu'à l'intérieur d'un serveur MCP stdio que Claude Code a démarré, utilisez CLAUDE_CODE_CHILD_SESSION à la place |
CLAUDE_AFK_COUNTDOWN_MS |
Combien de millisecondes avant le compte à rebours du auto-continue apparaît sur un dialogue AskUserQuestion sans réponse. Par défaut 20000 (20 secondes), limité au délai d'expiration du auto-continue. N'a aucun effet sauf si le auto-continue est activé ; voir le paramètre askUserQuestionTimeout et CLAUDE_AFK_TIMEOUT_MS. Nécessite Claude Code v2.1.198 ou ultérieur |
CLAUDE_AFK_TIMEOUT_MS |
Combien de millisecondes de temps d'inactivité avant qu'un dialogue AskUserQuestion sans réponse se poursuive automatiquement sans vous. Le auto-continue est désactivé par défaut ; activez-le avec le paramètre askUserQuestionTimeout. Cette variable est une substitution pour les démos et les tests automatisés : lorsqu'elle est définie, elle a la priorité sur ce paramètre et active le auto-continue même lorsque le paramètre n'est pas défini ou est never. Définir 0 ne désactive pas le délai d'expiration ; cela ferme le dialogue immédiatement. Dans v2.1.198 et v2.1.199, le auto-continue était activé par défaut avec un délai d'expiration de 60000 (60 secondes). Nécessite Claude Code v2.1.198 ou ultérieur |
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS |
Définissez à 1 pour désactiver tous les types de sous-agent intégrés tels que Explore et Plan. S'applique uniquement en mode non interactif (le drapeau -p). Utile pour les utilisateurs du SDK qui veulent une ardoise vierge. Cela supprime également general-purpose, le sous-agent que Claude Code exécute lorsqu'un appel d'outil Agent omet subagent_type. Un tel appel échoue alors avec subagent_type is required |
CLAUDE_AGENT_SDK_MCP_NO_PREFIX |
Définissez à 1 pour ignorer le préfixe mcp__<server>__ sur les noms d'outils des serveurs MCP créés par le SDK. Les outils utilisent leurs noms d'origine. Utilisation du SDK uniquement |
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS |
Délai d'expiration de blocage en millisecondes pour les sous-agents. Par défaut 600000 (10 minutes) ; si vous augmentez CLAUDE_STREAM_IDLE_TIMEOUT_MS tandis que le chien de garde de flux est activé, la valeur par défaut augmente avec lui, comme le décrit Gérer les réponses API lentes ou bloquées. La minuterie se réinitialise à chaque événement de progression en continu ; si aucune progression n'arrive dans la fenêtre, Claude Code interrompt le sous-agent et signale le blocage au parent |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE |
Définissez le pourcentage (1-100) de la fenêtre de compaction automatique auquel la compaction automatique se déclenche. Utilisez des valeurs plus basses comme 50 pour compacter plus tôt ; la variable ne peut pas augmenter le seuil, donc les valeurs au-dessus du pourcentage par défaut sont ignorées. Elle s'applique uniquement aux sessions qui compactent avant la limite de contexte du modèle. S'applique aux conversations principales et aux sous-agents |
CLAUDE_AUTO_BACKGROUND_TASKS |
Définissez à 1 pour forcer l'activation de la mise en arrière-plan automatique des tâches d'agent longues. Lorsqu'elle est activée, les sous-agents sont déplacés en arrière-plan après environ deux minutes d'exécution. Active également la mise en arrière-plan automatique des appels d'outils MCP longs en mode non interactif sur Claude Code v2.1.212 ou ultérieur |
CLAUDE_AX_PREPARK_MS |
En mode lecteur d'écran, combien de millisecondes Claude Code attend, avec le curseur au début de la ligne, avant d'écrire une ligne nouvelle ou modifiée. Par défaut 50. Définissez 0 pour écrire immédiatement. Claude Code limite l'attente à 5000. Nécessite Claude Code v2.1.233 ou ultérieur |
CLAUDE_AX_SCREEN_READER |
Définissez à 1 pour afficher une sortie conviviale pour les lecteurs d'écran : texte plat sans bordures décoratives ni animations. Définissez à 0 pour forcer le mode lecteur d'écran désactivé même lorsque axScreenReader est true. Le drapeau --ax-screen-reader a la priorité. Nécessite Claude Code v2.1.181 ou ultérieur |
CLAUDE_AX_STARTUP_QUIET_MS |
En mode lecteur d'écran, combien de millisecondes Claude Code maintient le premier rendu d'interface après la ligne de confirmation de démarrage, afin que votre lecteur d'écran puisse prononcer la ligne en entier avant que la nouvelle sortie ne l'interrompe. Par défaut 3000. Définissez 0 pour afficher immédiatement. Claude Code limite la tenue à 600000 (10 minutes). Votre première frappe termine la tenue plus tôt. Nécessite Claude Code v2.1.217 ou ultérieur |
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR |
Retournez au répertoire de travail d'origine après chaque commande Bash ou PowerShell dans la session principale |
CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS |
Délai d'expiration en millisecondes pour le chien de garde d'inactivité de flux au niveau des octets ; lorsqu'il est défini, il a la priorité sur CLAUDE_STREAM_IDLE_TIMEOUT_MS pour ce chien de garde et laisse le chien de garde au niveau des événements inchangé. Claude Code limite cette variable entre 10 secondes et 30 minutes. Nécessite Claude Code v2.1.210 ou ultérieur |
CLAUDE_CLIENT_PRESENCE_FILE |
Chemin d'accès à un fichier qu'un outil externe, comme un écouteur de verrouillage d'écran, crée lorsque vous déverrouillez votre écran et supprime lorsque vous le verrouillez. Tant que le fichier existe, Claude Code ignore les notifications push mobiles Remote Control, afin que vous cessiez de recevoir des notifications lorsque vous utilisez activement l'ordinateur. Lorsque le fichier est absent ou illisible, les notifications sont envoyées normalement. Claude Code vérifie le fichier une fois par événement déclencheur de notification plutôt que de l'interroger. Nécessite Claude Code v2.1.181 ou ultérieur |
CLAUDE_CODE_ACCESSIBILITY |
Définissez à 1 pour garder le curseur du terminal natif visible et désactiver l'indicateur de curseur en texte inversé. Permet aux loupes d'écran comme macOS Zoom de suivre la position du curseur |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD |
Définissez à 1 pour charger les fichiers mémoire à partir des répertoires spécifiés avec --add-dir. Charge CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md et CLAUDE.local.md. Par défaut, les répertoires supplémentaires ne chargent pas les fichiers mémoire |
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT |
Définissez à 1 pour repeindre l'écran entier à chaque image en rendu plein écran au lieu d'envoyer des mises à jour incrémentielles. Utilisez ceci si le mode plein écran affiche des fragments de texte obsolètes ou mal placés. Claude Code active ceci automatiquement pour les sessions d'arrière-plan et la vue agent sur Windows |
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT |
Définissez à 1 pour envoyer le paramètre effort avec chaque requête, même lorsque Claude Code ne reconnaît pas l'ID du modèle comme capable d'effort. Utilisez ceci lors du routage via une passerelle LLM ou un fournisseur tiers qui sert les modèles sous des identifiants personnalisés. Les modèles qui rejettent le paramètre d'effort à l'API, y compris les modèles Claude 3, Sonnet 4.0 et 4.5, Opus 4.0 et 4.1, et Haiku 4.5, sont toujours exclus afin que les requêtes ne échouent pas |
CLAUDE_CODE_API_KEY_HELPER_TTL_MS |
Intervalle en millisecondes auquel les identifiants doivent être actualisés (lors de l'utilisation de apiKeyHelper) |
CLAUDE_CODE_ARTIFACT_AUTO_OPEN |
Définissez à 0 pour empêcher Claude Code d'ouvrir le navigateur automatiquement lorsqu'un nouvel artifact est publié. La republication d'un artifact existant n'ouvre pas le navigateur quel que soit ce paramètre |
CLAUDE_CODE_ARTIFACT_COMMENTS |
Définissez à 0 pour arrêter la lecture et la réponse de Claude aux commentaires sur un artifact. N'a aucun effet lorsque CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC a désactivé les artifacts. Nécessite Claude Code v2.1.221 ou ultérieur |
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT |
Définissez à 0 pour arrêter Claude de répondre de lui-même aux commentaires envoyés. Nécessite Claude Code v2.1.228 ou ultérieur |
CLAUDE_CODE_ATTRIBUTION_HEADER |
Définissez à 0 pour omettre le bloc d'attribution, qui porte la version du client et une empreinte digitale du prompt, du début du prompt système. La mise en cache sur une connexion directe à l'API Anthropic n'est pas affectée de toute façon. Dans certaines configurations de connexion directe, Claude Code garde le bloc sur les requêtes du classificateur mode auto même lorsque vous définissez 0. Dans Bloc d'attribution du prompt système, vérifiez quelles connexions et identifiants cela couvre. Avant v2.1.181, le bloc incluait un jeton par requête sur les URL de base personnalisées et les connexions Microsoft Foundry, donc sur ces versions, définissez-le à 0 lorsque votre passerelle LLM met en cache sur le corps de la requête ou transfère les requêtes à un fournisseur tiers, ou lorsque vous vous connectez directement à Microsoft Foundry |
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS |
Lorsque CLAUDE_AUTO_BACKGROUND_TASKS est activé, secondes entre les rappels à Claude de vérifier les sous-agents d'arrière-plan qui sont toujours en cours d'exécution. Accepte un entier simple de 1 à 86400 uniquement ; toute autre valeur ou orthographe se lit comme non défini. Lorsqu'il n'est pas défini, il n'y a pas de rappels de vérification. Nécessite Claude Code v2.1.248 ou ultérieur |
CLAUDE_CODE_AUTO_COMPACT_WINDOW |
Définissez la fenêtre de compaction automatique en jetons, de 100000 à 1000000. Accepte un entier simple comme 500000 uniquement : une valeur comme 500k se lit comme 500 et se limite au minimum de 100K. La fenêtre effective est également limitée à la fenêtre de contexte du modèle. A la priorité sur la commande /autocompact, le drapeau --autocompact et le paramètre autoCompactWindow. Le used_percentage de la status line mesure toujours par rapport à la fenêtre de contexte complète du modèle, donc une fois cette variable définie, ce pourcentage n'indique plus quand la compaction s'exécutera |
CLAUDE_CODE_AUTO_CONNECT_IDE |
Remplacez la connexion IDE automatique. Par défaut, Claude Code se connecte automatiquement lorsqu'il est lancé dans le terminal intégré d'un IDE supporté. Définissez à false pour empêcher cela. Définissez à true pour forcer une tentative de connexion lorsque la détection automatique échoue, par exemple lorsque tmux obscurcit le terminal parent. A la priorité sur le paramètre de configuration globale autoConnectIde |
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS |
Temps en millisecondes que Claude Code attend pour que la chaîne de fournisseur d'identifiants par défaut AWS produise des identifiants avant que la requête échoue avec AWS default-chain credential resolve timed out (par défaut : 60000). Augmentez-le lorsqu'une étape de votre chaîne a légitimement besoin de plus de temps, comme une connexion SSO basée sur un navigateur avec MFA via un wrapper comme aws-vault. S'applique partout où Claude Code signe avec la chaîne par défaut : Amazon Bedrock, Claude Platform on AWS et le point de terminaison Mantle. Nécessite Claude Code v2.1.207 ou ultérieur |
CLAUDE_CODE_BRIDGE_SESSION_ID |
Défini automatiquement dans les sous-processus de l'outil Bash et de la commande hook tandis que la session a une connexion Remote Control active, et supprimé lorsque la connexion se termine. La valeur est l'ID de la session sous la forme session_, le même identifiant qui apparaît dans l'URL claude.ai/code de la session, afin qu'un script puisse se lier à la session qui l'a exécuté. Nécessite Claude Code v2.1.199 ou ultérieur. Dans les sessions cloud, lisez CLAUDE_CODE_REMOTE_SESSION_ID à la place |
CLAUDE_CODE_BS_AS_CTRL_BACKSPACE |
Définissez à 0 pour faire lire à Claude Code l'octet 0x08, également écrit ^H, comme Backspace simple, ou 1 pour le lire comme Ctrl+Backspace. Chaque valeur remplace la valeur par défaut de la plateforme. Par défaut, Claude Code le lit comme Ctrl+Backspace sur Windows, sauf lorsque TERM_PROGRAM est mintty ou TERM est cygwin, et comme Backspace simple sur macOS et Linux. Définissez 0 dans un terminal Windows où Backspace supprime un mot entier |
CLAUDE_CODE_CERT_STORE |
Liste séparée par des virgules de sources de certificats CA pour les connexions TLS. bundled est l'ensemble Mozilla CA livré avec Claude Code. system est le magasin de confiance du système d'exploitation, lu uniquement sur les runtimes avec tls.getCACertificates : le binaire natif, ou Node 22.15 ou ultérieur pour les installations npm. Voir Magasin de certificats CA. La valeur par défaut est bundled,system |
CLAUDE_CODE_CHILD_SESSION |
Défini à 1 dans les sous-processus que Claude Code génère via les outils Bash, PowerShell et Monitor, les commandes hook et les commandes status line. Non défini pour les sous-processus serveur MCP stdio, qui sont longue durée et survivent à la session qui les a générés. Contrairement à CLAUDECODE, ceci n'est défini que par Claude Code lui-même lorsqu'il lance un sous-processus et non par les extensions IDE, donc il distingue de manière fiable une session imbriquée d'une claude de niveau supérieur lancée dans un terminal intégré IDE. Une claude TUI interactive imbriquée démarrée de cette façon est automatiquement exclue de --resume, --continue, l'historique de la flèche vers le haut et la liste claude agents. Les sessions claude -p non interactives persistent toujours. Définissez CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 pour remplacer cette exclusion. Nécessite Claude Code v2.1.172 ou ultérieur |
CLAUDE_CODE_CLIENT_CERT |
Chemin d'accès au fichier de certificat client pour l'authentification mTLS |
CLAUDE_CODE_CLIENT_KEY |
Chemin d'accès au fichier de clé privée client pour l'authentification mTLS |
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE |
Phrase de passe pour CLAUDE_CODE_CLIENT_KEY chiffré (optionnel) |
CLAUDE_CODE_CONNECT_TIMEOUT_MS |
Supprimé dans v2.1.186 et maintenant un no-op. Auparavant, définissait un délai d'expiration séparé pour la phase de connexion, TLS et d'en-tête de réponse d'une requête API en continu. Utilisez API_TIMEOUT_MS pour le délai d'expiration par requête. Pour la phase d'en-tête de réponse d'une requête en continu, voir CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS |
CLAUDE_CODE_DEBUG_LOGS_DIR |
Remplacez le chemin d'accès au fichier journal de débogage. Malgré le nom, c'est un chemin d'accès au fichier, pas un répertoire. Nécessite que le mode débogage soit activé séparément via --debug, /debug ou la variable d'environnement DEBUG : définir cette variable seule n'active pas la journalisation. Le drapeau --debug-file fait les deux à la fois. Par défaut ~/.claude/debug/<session-id>.txt |
CLAUDE_CODE_DEBUG_LOG_LEVEL |
Niveau de journal minimum écrit dans le fichier journal de débogage. Valeurs : verbose, debug (par défaut), info, warn, error. Définissez à verbose pour inclure les diagnostics à haut volume comme la sortie complète de la commande status line, ou augmentez à error pour réduire le bruit |
CLAUDE_CODE_DISABLE_1M_CONTEXT |
Définissez à 1 pour désactiver le support de la fenêtre de contexte 1M. Lorsqu'elle est définie, les variantes de modèle 1M ne sont pas disponibles dans le sélecteur de modèle, et Claude Code maintient les sessions sur les modèles avec une fenêtre 1M native, comme Sonnet 5 et les modèles Fable, à une fenêtre 200K ; voir Contexte étendu pour savoir comment la tenue est appliquée. Utile pour les environnements d'entreprise avec des exigences de conformité. Pour son rôle dans la correction de la fenêtre pour un ID de modèle [1m] non reconnu, voir Corriger la fenêtre pour un ID de modèle de passerelle ou personnalisé |
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING |
Définissez à 1 pour désactiver le raisonnement adaptatif sur Opus 4.6 et Sonnet 4.6 et revenir au budget de réflexion fixe contrôlé par MAX_THINKING_TOKENS. N'a aucun effet sur les modèles Fable, Sonnet 5 ou Opus 4.7 et ultérieur, qui utilisent toujours le raisonnement adaptatif |
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION |
Définissez à 1 pour empêcher Claude Code de fusionner les blocs env des paramètres gérés par clé sur les sources d'administration, afin que seul le bloc env de la source la plus prioritaire s'applique, comme avant v2.1.223. Définissez-le dans l'environnement qui lance Claude Code, car Claude Code ignore une copie livrée via un bloc env de paramètres. Nécessite Claude Code v2.1.223 ou ultérieur |
CLAUDE_CODE_DISABLE_ADVISOR_TOOL |
Définissez à 1 pour désactiver l'outil conseiller. La commande /advisor devient indisponible, tout advisorModel configuré est ignoré, et le drapeau --advisor est accepté mais n'a aucun effet, afin que les scripts existants qui le transmettent continuent à fonctionner sans erreurs |
CLAUDE_CODE_DISABLE_AGENT_VIEW |
Définissez à 1 pour désactiver les agents d'arrière-plan et la vue agent : claude agents, --bg, /background et le superviseur à la demande. Équivalent au paramètre disableAgentView |
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN |
Définissez à 1 pour désactiver le rendu plein écran et utiliser le rendu d'écran principal classique. La conversation reste dans le scrollback natif de votre terminal afin que Cmd+f et le mode copie tmux fonctionnent comme d'habitude. A la priorité sur CLAUDE_CODE_NO_FLICKER et le paramètre tui. Vous pouvez également basculer avec /tui default. Ne s'applique pas aux sessions d'arrière-plan ouvertes à partir de la vue agent, qui utilisent toujours le rendu plein écran |
CLAUDE_CODE_DISABLE_ARTIFACT |
Définissez à 1 pour désactiver l'outil Artifact, qui publie la sortie de session en tant que page web privée sur claude.ai. Une fois que vous le définissez, aucun fichier de paramètres n'active l'outil. Pour désactiver l'outil à partir d'un fichier de paramètres à la place, définissez enableArtifact à false ; la clé disableArtifact dépréciée le désactive également |
CLAUDE_CODE_DISABLE_ATTACHMENTS |
Définissez à 1 pour désactiver le traitement des pièces jointes. Les mentions de fichiers avec la syntaxe @ sont envoyées en tant que texte simple au lieu d'être développées en contenu de fichier |
CLAUDE_CODE_DISABLE_AUTO_MEMORY |
Définissez à 1 pour désactiver la mémoire automatique. Définissez à 0 pour forcer la mémoire automatique activée même lorsque le mode --bare ou autoMemoryEnabled: false la désactiverait autrement. Lorsqu'elle est désactivée, Claude ne crée ni ne charge les fichiers de mémoire automatique |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS |
Définissez à 1 pour désactiver toute la fonctionnalité de tâche d'arrière-plan, y compris le paramètre run_in_background sur les outils Bash et sous-agent, la mise en arrière-plan automatique et le raccourci Ctrl+B |
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT |
Définissez à 1 pour empêcher Claude Code de traiter une réponse en continu Amazon Bedrock avec un en-tête Content-Type manquant ou vide comme le flux d'événements binaires d'Amazon Bedrock. Par défaut, Claude Code suppose qu'une passerelle a supprimé l'en-tête d'une réponse par ailleurs inmodifiée, afin que le décodage du corps et la diffusion en continu continuent de fonctionner. Définissez ceci uniquement pour une passerelle qui réemet également le flux en tant qu'événements envoyés par le serveur ; Claude Code lit alors le corps sans en-tête en tant qu'événements envoyés par le serveur à la place. Nécessite Claude Code v2.1.239 ou ultérieur |
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD |
Définissez à 1 pour ignorer la vérification qu'une réponse en continu Amazon Bedrock porte le type de contenu application/vnd.amazon.eventstream. Sans cette variable, lorsqu'une réponse porte un type de contenu différent, Claude Code échoue la requête avec une erreur nommant ce type, ce qui signifie qu'une passerelle ou un proxy transforme la réponse. Configurez la passerelle pour transférer l'en-tête Content-Type et le corps sans modification plutôt que de définir cette variable. Nécessite Claude Code v2.1.208 ou ultérieur |
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF |
Définissez à 1 pour arrêter les commandes shell d'arrière-plan en cours d'exécution d'une session d'arrière-plan, les workflows dynamiques, et, à partir de v2.1.198, les sous-agents d'arrière-plan lorsque le superviseur arrête, redémarre ou met à jour le processus de cette session, au lieu de les remettre au processus suivant de la session. Affecte uniquement cette remise : la mise en arrière-plan d'une session avec ← ou /background porte toujours le travail en vol, et CLAUDE_DISABLE_ADOPT désactive les deux. Nécessite Claude Code v2.1.196 ou ultérieur |
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP |
Définissez à 1 pour empêcher Claude Code de terminer les commandes shell d'arrière-plan lorsque le système d'exploitation signale une pression mémoire. Par défaut, sur macOS et Linux, Claude Code termine une commande shell démarrée dans la session principale sur un signal de pression mémoire une fois que la session a été inactive pendant 30 minutes et qu'aucun tour ou sous-agent n'est en cours d'exécution. Windows n'a pas de signal de pression mémoire, donc cette variable n'a aucun effet là. Nécessite Claude Code v2.1.193 ou ultérieur |
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS |
Définissez à 1 pour désactiver les compétences et workflows inclus avec Claude Code : les compétences groupées et les workflows sont supprimés entièrement, tandis que les commandes intégrées comme /init restent tapables mais sont masquées au modèle. /doctor reste tapable comme les commandes intégrées ; masquez-le avec DISABLE_DOCTOR_COMMAND à la place. Les compétences des plugins, .claude/skills/ et .claude/commands/ ne sont pas affectées. Équivalent au paramètre disableBundledSkills |
CLAUDE_CODE_DISABLE_CFC_PROMPT |
Définissez à 1 pour garder les outils du navigateur Claude in Chrome disponibles tout en omettant la section Chrome du prompt système et la compétence groupée /claude-in-chrome. Pour les hôtes qui intègrent Claude Code et fournissent leurs propres conseils de navigateur. Nécessite Claude Code v2.1.257 ou ultérieur |
CLAUDE_CODE_DISABLE_CLAUDE_MDS |
Définissez à 1 pour empêcher le chargement de tous les fichiers mémoire CLAUDE.md dans le contexte, y compris les fichiers mémoire utilisateur, projet et automatique |
CLAUDE_CODE_DISABLE_CRON |
Définissez à 1 pour désactiver les tâches planifiées. La compétence /loop et les outils cron deviennent indisponibles et toutes les tâches déjà planifiées cessent de se déclencher, y compris les tâches qui s'exécutent déjà en milieu de session |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS |
Définissez à 1 pour supprimer les en-têtes de requête anthropic-beta spécifiques à Anthropic et les champs de schéma d'outil bêta (tels que defer_loading et eager_input_streaming) des requêtes API. Utilisez ceci lorsqu'une passerelle proxy rejette les requêtes avec des erreurs comme « Unexpected value(s) for the anthropic-beta header » ou « Extra inputs are not permitted ». Les champs standard (name, description, input_schema, cache_control) sont préservés. La recherche d'outils MCP est désactivée et tous les outils MCP se chargent en amont, même lorsque vous définissez ENABLE_TOOL_SEARCH. Sur Claude Code v2.1.227 ou ultérieur, les paramètres gérés peuvent garder la recherche d'outils activée. Désactiver les capacités de pré-version couvre où le remplacement s'applique |
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS |
Définissez à 1 pour désactiver les sous-agents Explore et Plan intégrés. Claude explore avec ses outils de recherche ou le sous-agent à usage général à la place, et le mode plan lit les fichiers directement plutôt que de lancer les agents Explore et Plan. Les sous-agents personnalisés nommés Explore ou Plan ne sont pas affectés. Pour supprimer tous les types de sous-agent intégrés dans le SDK Agent ou le mode non interactif, utilisez CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS à la place. Nécessite Claude Code v2.1.198 ou ultérieur |
CLAUDE_CODE_DISABLE_FAST_MODE |
Définissez à 1 pour désactiver le mode rapide |
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY |
Définissez à 1 pour désactiver les sondages de qualité de session « Comment Claude se débrouille-t-il ? ». Les sondages sont également désactivés lorsque DISABLE_TELEMETRY, DO_NOT_TRACK ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC est défini, sauf si CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL se réinscrit. Pour définir un taux d'échantillonnage au lieu de désactiver complètement, utilisez le paramètre feedbackSurveyRate. Voir Sondages de qualité de session |
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING |
Définissez à 1 pour désactiver le checkpointing de fichier. La commande /rewind ne pourra pas restaurer les modifications de code. Remplace le paramètre fileCheckpointingEnabled |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS |
Définissez à 1 pour supprimer les instructions de workflow de commit et PR intégrées et l'instantané d'état git du prompt système de Claude. Utile lors de l'utilisation de vos propres compétences de workflow git. A la priorité sur le paramètre includeGitInstructions lorsqu'il est défini |
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP |
Définissez à 1 pour empêcher le remappage automatique d'Opus 4.0 et 4.1 à la version Opus actuelle sur l'API Anthropic. Utilisez lorsque vous souhaitez intentionnellement épingler un modèle plus ancien. Le remappage ne s'exécute pas sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry |
CLAUDE_CODE_DISABLE_MOUSE |
Définissez à 1 pour désactiver le suivi de la souris en rendu plein écran. Le défilement au clavier avec PgUp et PgDn fonctionne toujours. Utilisez ceci pour garder le comportement de copie à la sélection natif de votre terminal |
CLAUDE_CODE_DISABLE_MOUSE_CLICKS |
Définissez à 1 pour désactiver la gestion des clics, des glissements et des survols en rendu plein écran tout en gardant le défilement à la molette de la souris. Utilisez ceci lorsque vous souhaitez que le défilement à la molette fonctionne à l'intérieur de Claude Code mais que vous ne souhaitez pas que les clics positionnent le curseur, développent la sortie d'outil ou ouvrent des liens. CLAUDE_CODE_DISABLE_MOUSE a la priorité lorsque les deux sont définis. Nécessite Claude Code v2.1.195 ou ultérieur |
CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION |
Définissez à 1 pour empêcher Claude Code de relire le certificat client mTLS et la clé lorsqu'une requête API échoue avec une erreur au niveau de la connexion, comme une réinitialisation de connexion ou une erreur de poignée de main TLS. Avec le rechargement désactivé, Claude Code charge les fichiers pivotés uniquement lorsqu'il applique ensuite les paramètres ou au prochain démarrage. Nécessite Claude Code v2.1.232 ou ultérieur |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC |
Définissez à n'importe quelle valeur non vide, comme 1, pour désactiver le trafic réseau non essentiel : mises à jour automatiques, télémétrie, rapports d'erreurs, la commande /feedback, retours d'information rédigés par Claude, notes de version, les vérifications du badge d'état PR et MR et les vérifications de disponibilité telles que la vérification du mode rapide. Il arrête également les exécutions d'arrière-plan des sources de commande du plugin, qui sont des commandes locales plutôt que du trafic réseau, car elles peuvent déclencher des installations de dépendances. Définir à 0 ou false désactive toujours ce trafic, contrairement à la plupart des variables activées/désactivées ; supprimez la variable pour l'autoriser à nouveau. Désactive également la récupération des drapeaux de fonctionnalité, ce qui rend Remote Control et les autres fonctionnalités qui nécessitent la récupération des drapeaux de fonctionnalité indisponibles. L'installation automatique de la place de marché officielle des plugins n'est pas couverte ; désactivez-la avec CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL. N'affecte pas la découverte de modèles de passerelle, qui a son propre opt-in |
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK |
Définissez à 1 pour désactiver le secours non-continu lorsqu'une requête en continu échoue en milieu de flux. Les erreurs de diffusion en continu se propagent à la couche de nouvelle tentative à la place. Utile lorsqu'une passerelle ou une proxy cause le secours pour produire une exécution d'outil dupliquée |
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK |
Définissez à 1 pour envoyer la notification de bureau de l'outil PushNotification même lorsque vous tapez dans ou êtes concentré sur le terminal. Par défaut, l'outil ignore à la fois la notification de bureau et le push mobile lorsqu'il détecte une activité clavier récente ou une concentration du terminal. Cette variable désactive uniquement cette vérification locale, afin que le serveur puisse toujours supprimer le push mobile lorsqu'il détecte que vous êtes actif. Nécessite Claude Code v2.1.193 ou ultérieur |
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL |
Définissez à 1 pour désactiver l'enregistrement automatique de la place de marché officielle des plugins. Claude Code lit la variable lorsqu'il est sur le point d'enregistrer la place de marché, généralement lors du premier lancement interactif d'une machine. Si la variable est définie à ce moment, Claude Code ignore l'enregistrement de manière permanente. Supprimer la variable plus tard n'annule pas l'omission. Exécutez claude plugin marketplace add anthropics/claude-plugins-official pour enregistrer la place de marché à tout moment |
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS |
Définissez à 1 pour empêcher Claude Code d'exécuter vos hooks de notification pour les demandes de permission sans réponse dans les sessions où Claude Code les envoie au rappel canUseTool du SDK Agent, ce qui est la façon dont Claude Desktop et l'extension VS Code hébergent Claude Code. N'a aucun effet dans les sessions de terminal. Nécessite Claude Code v2.1.233 ou ultérieur |
CLAUDE_CODE_DISABLE_POLICY_SKILLS |
Définissez à 1 pour ignorer le chargement des compétences à partir du répertoire des compétences gérées à l'échelle du système. Utile pour les sessions de conteneur ou CI qui ne doivent pas charger les compétences provisionnées par l'opérateur |
CLAUDE_CODE_DISABLE_TERMINAL_TITLE |
Définissez à 1 pour désactiver les mises à jour automatiques du titre du terminal en fonction du contexte de la conversation. Dans les sessions SDK Agent et claude -p, cela ignore également la requête de modèle petit/rapide d'arrière-plan qui génère le titre de la session |
CLAUDE_CODE_DISABLE_THINKING |
Définissez à 1 pour omettre complètement le paramètre thinking des requêtes API. C'est une option de compatibilité pour les passerelles et les proxies qui rejettent le paramètre. Le comportement de la variable est inchangé par rapport aux versions antérieures ; sur les modèles qui pensent par défaut, l'omission du paramètre signifie que le modèle peut toujours penser. Pour désactiver explicitement la réflexion étendue sur l'API Anthropic, utilisez MAX_THINKING_TOKENS=0 à la place, qui est également inefficace sur les modèles Fable car ils ne peuvent pas avoir la réflexion désactivée. Sur les fournisseurs tiers, 0 omet également le paramètre, afin que les deux variables se comportent de la même manière là |
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT |
Définissez à 1 pour ignorer la compaction automatique proactive lorsque Claude Code ne reconnaît pas l'ID du modèle, comme un alias de passerelle LLM. Sans cette variable, Claude Code compacte à la fenêtre de contexte qu'il suppose pour l'ID. CLAUDE_CODE_MAX_CONTEXT_TOKENS peut corriger la fenêtre supposée à la place ; voir Corriger la fenêtre pour un ID de modèle de passerelle ou personnalisé pour savoir quand chaque variable s'applique. Nécessite Claude Code v2.1.223 ou ultérieur |
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL |
Définissez à 1 pour désactiver le défilement virtuel en rendu plein écran et afficher chaque message dans la transcription. Utilisez ceci si le défilement en mode plein écran affiche des régions vierges où les messages devraient apparaître |
CLAUDE_CODE_DISABLE_WORKFLOWS |
Définissez à 1 pour désactiver les workflows. Équivalent au paramètre disableWorkflows |
CLAUDE_CODE_EFFORT_LEVEL |
Définissez le niveau d'effort pour les modèles supportés. Valeurs : low, medium, high, xhigh, max ou auto pour utiliser la valeur par défaut du modèle. Les niveaux disponibles dépendent du modèle. A la priorité sur --effort, /effort et les paramètres modelSettings et effortLevel. Voir Ajuster le niveau d'effort |
CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT |
Définissez à 1 pour activer l'ajout de texte supplémentaire à la fin du prompt système de chaque sous-agent autre qu'un sous-agent forké. Les drapeaux --append-subagent-system-prompt et --append-subagent-system-prompt-file fournissent le texte ajouté et définissent cette variable automatiquement, afin que vous n'ayez pas besoin de la définir vous-même. Nécessite Claude Code v2.1.205 ou ultérieur |
CLAUDE_CODE_ENABLE_AUTO_MODE |
Accepté pour la compatibilité avec les versions antérieures et n'a aucun effet. Le mode auto est disponible par défaut sur chaque fournisseur, y compris Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions de passerelle Claude apps signées. Dans v2.1.158 à v2.1.206, définir ceci à 1 était nécessaire pour rendre le mode auto disponible sur ces fournisseurs |
CLAUDE_CODE_ENABLE_AWAY_SUMMARY |
Remplacez la disponibilité du récapitulatif de session. Définissez à 0 pour forcer les récapitulatifs désactivés quel que soit le basculement /config. Définissez à 1 pour forcer les récapitulatifs activés lorsque awaySummaryEnabled est false. A la priorité sur le paramètre et le basculement /config |
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH |
Définissez à 1 pour actualiser l'état du plugin aux limites de tour en mode non interactif après la fin d'une installation d'arrière-plan. Désactivé par défaut car l'actualisation change le prompt système en milieu de session, ce qui invalide la mise en cache du prompt pour ce tour |
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL |
Définissez à 1 pour router le sondage de qualité de session « Comment Claude se débrouille-t-il ? » vers votre propre collecteur OpenTelemetry lorsque le trafic non essentiel lié à Anthropic est bloqué. Les évaluations du sondage sont émises uniquement en tant qu'événements OTEL vers votre collecteur configuré. Aucune donnée de sondage n'est envoyée à Anthropic dans ce mode. S'applique lorsque CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY ou DO_NOT_TRACK est défini, et n'a aucun effet sinon. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY et la politique de retours d'information sur les produits de l'organisation ont la priorité |
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING |
Contrôle si les entrées d'appel d'outil se diffusent en continu à partir de l'API au fur et à mesure que Claude les génère. Avec ceci désactivé, une grande entrée d'outil comme une longue écriture de fichier n'arrive que après que Claude ait fini de la générer, ce qui peut sembler qu'il se bloque. Activé par défaut sur l'API Anthropic. Sur Amazon Bedrock et Google Cloud's Agent Platform, activé par modèle où le conteneur déployé le supporte. Définissez à 0 pour refuser. Définissez à 1 pour forcer l'activation lors du routage via un proxy via ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL ou ANTHROPIC_BEDROCK_BASE_URL. Désactivé par défaut sur Microsoft Foundry et les connexions de passerelle |
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY |
Définissez à 1 pour remplir le sélecteur /model à partir du point de terminaison /v1/models de votre passerelle lorsque ANTHROPIC_BASE_URL pointe vers une passerelle compatible Anthropic comme LiteLLM, Kong ou un proxy interne. Désactivé par défaut car les passerelles soutenues par une clé API partagée afficheraient autrement à chaque utilisateur chaque modèle auquel la clé peut accéder. Les modèles découverts sont toujours filtrés par une liste d'autorisation availableModels que la session reçoit ; livrez la liste via MDM ou un fichier de paramètres gérés, car la livraison gérée par le serveur n'est pas disponible sur les configurations de passerelle |
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE |
Supprimé dans v2.1.142, lorsque la valeur par défaut du mode rapide a changé d'Opus 4.6 à Opus 4.7 |
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION |
Définissez à false pour désactiver les suggestions de prompt, les prédictions grisées qui apparaissent dans votre entrée de prompt. A la priorité sur le paramètre promptSuggestionEnabled, qui est ce que le basculement Suggestions de prompt dans /config écrit. Claude Code met également en pause les suggestions tandis que votre compte est proche ou à sa limite d'utilisation. Définissez à true pour les garder activées jusqu'à ce que vous atteigniez la limite. Nécessite Claude Code v2.1.238 ou ultérieur. Voir Suggestions de prompt |
CLAUDE_CODE_ENABLE_TASKS |
Sélectionne les outils de suivi des tâches que Claude Code fournit dans les sessions qui les ont. Par défaut, Claude Code fournit les outils Task TaskCreate, TaskUpdate, TaskGet et TaskList. Définissez à 0 pour obtenir l'outil TodoWrite hérité à la place. Voir Liste des tâches |
CLAUDE_CODE_ENABLE_TELEMETRY |
Définissez à 1 pour activer la collecte de données OpenTelemetry pour les métriques et la journalisation. Requis avant de configurer les exportateurs OTel. Voir Surveillance |
CLAUDE_CODE_ENABLE_TODO_TOOLS |
Définissez à 1 pour obtenir les outils de suivi des tâches sur les modèles énumérés sous Disponibilité des outils Task, où Claude Code les laisse autrement de côté. CLAUDE_CODE_ENABLE_TASKS sélectionne toujours les outils Task ou TodoWrite. Nécessite Claude Code v2.1.233 ou ultérieur |
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY |
Temps en millisecondes à attendre après que la boucle de requête devienne inactive avant de quitter automatiquement. Utile pour les workflows automatisés et les scripts utilisant le mode SDK |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS |
Définissez à 1 pour activer les équipes d'agents. Les équipes d'agents sont expérimentales et désactivées par défaut |
CLAUDE_CODE_EXTRA_BODY |
Objet JSON à fusionner au niveau supérieur de chaque corps de requête API. Utile pour transmettre les paramètres spécifiques au fournisseur que Claude Code n'expose pas directement. Une valeur exportée dans votre shell s'applique également aux sessions d'arrière-plan que vous distribuez avec claude agents ou --bg. Avant v2.1.206, les sessions d'arrière-plan ignoraient une valeur exportée par le shell et utilisaient la copie que le processus superviseur d'arrière-plan héritait |
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS |
Remplacez la limite de jetons par défaut pour les lectures de fichier. Utile lorsque vous devez lire des fichiers plus volumineux en entier |
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE |
Définissez à 1 pour forcer la persistance de la transcription, l'historique des prompts et l'enregistrement claude agents même lorsque ce claude a été lancé de l'intérieur d'une autre session Claude Code. Utilisez lorsqu'une valeur CLAUDE_CODE_CHILD_SESSION héritée, par exemple à partir d'une session screen ou d'un lanceur d'arrière-plan d'abord démarré par l'outil Bash de Claude Code, cause une session de niveau supérieur authentique à être mal classée comme imbriquée. À partir de v2.1.178, Claude Code détecte automatiquement le cas tmux et ignore le marqueur hérité, afin que tmux n'ait plus besoin de cette variable. Également honoré sur v2.1.169 et antérieur ; n'a aucun effet sur v2.1.170 et v2.1.171, où la détection de session imbriquée qu'il remplace a été supprimée |
CLAUDE_CODE_FORCE_STRIKETHROUGH |
Définissez à 1 pour forcer le rendu du barré pour ~~text~~ dans les réponses de Claude lorsque votre terminal le supporte mais n'est pas détecté automatiquement, comme sur SSH sans TERM_PROGRAM transféré. Sans ceci, les terminaux non détectés affichent les marqueurs littéraux ~~ au lieu de rendre le texte comme barré. Nécessite Claude Code v2.1.186 ou ultérieur |
CLAUDE_CODE_FORCE_SYNC_OUTPUT |
Définissez à 1 pour forcer l'activation du mode privé DEC 2026 sortie synchronisée lorsque votre terminal le supporte mais n'est pas détecté automatiquement. Utile pour les émulateurs comme eat d'Emacs qui implémentent BSU/ESU mais ne répondent pas à la sonde de capacité. N'a aucun effet sous tmux. Contrairement à CLAUDE_CODE_NO_FLICKER, qui bascule vers le rendu plein écran, ceci ne change pas le rendu |
CLAUDE_CODE_FORK_SUBAGENT |
Contrôle le mode fork, qui permet à Claude de générer des sous-agents forkés lui-même et est activé par défaut uniquement dans les sessions interactives. Définissez à 1 pour l'activer dans claude -p et le SDK Agent également, ou 0 pour le désactiver dans tous les types de session. Vous pouvez exécuter /subtask que le mode fork soit activé ou non. La valeur par défaut interactive nécessite Claude Code v2.1.232 ou ultérieur ; sur les versions antérieures, définissez la variable à 1 pour activer le mode fork |
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT |
Définissez à 1 pour émettre les blocs de texte et de réflexion du sous-agent dans la sortie claude -p --output-format stream-json, le même comportement que le drapeau --forward-subagent-text. Utilisez la variable lorsqu'un harnais invoque claude et ne peut pas transmettre le drapeau lui-même. Contrairement au drapeau, qui quitte avec une erreur en dehors du mode non interactif avec la sortie stream-json, la variable est ignorée là afin que les invocations imbriquées continuent de fonctionner lorsqu'elle est définie au niveau du processus. Nécessite Claude Code v2.1.211 ou ultérieur |
CLAUDE_CODE_GIT_BASH_PATH |
Windows uniquement : chemin d'accès à l'exécutable Git Bash (bash.exe). Utilisez lorsque Git Bash est installé mais pas dans votre PATH. Si le chemin n'existe pas ou que le fichier n'est pas nommé bash.exe, sh.exe, bash ou sh, Claude Code ignore la variable et détecte automatiquement Git Bash comme s'il était non défini, en enregistrant un avertissement visible avec --debug. Avant v2.1.219, Claude Code quittait au démarrage lorsque le chemin n'existait pas et utilisait n'importe quel fichier existant comme shell sans vérifier qu'il s'agissait de bash ou sh. Voir Configuration Windows |
CLAUDE_CODE_GLOB_HIDDEN |
Définissez à false pour exclure les fichiers pointillés des résultats lorsque Claude invoque l'outil Glob. Inclus par défaut. N'affecte pas l'autocomplétion de fichier @, ls, Grep ou Read |
CLAUDE_CODE_GLOB_NO_IGNORE |
Définissez à false pour faire respecter à l'outil Glob les modèles .gitignore. Par défaut, Glob retourne tous les fichiers correspondants, y compris les fichiers gitignorés. N'affecte pas l'autocomplétion de fichier @, qui a son propre paramètre respectGitignore |
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS |
Délai d'expiration en secondes pour la découverte de fichiers de l'outil Glob. Par défaut 20 secondes sur la plupart des plates-formes et 60 secondes sur WSL |
CLAUDE_CODE_GOAL_CHECKIN_MINUTES |
Combien de minutes le travail d'arrière-plan peut garder un objectif actif en attente avant que Claude Code demande à Claude de le vérifier. Par défaut 30. Définissez 0 pour désactiver les vérifications. Donnez des minutes entières en chiffres simples, au maximum 10080, ce qui est une semaine. Claude Code traite toute autre valeur comme non définie et utilise la valeur par défaut. Nécessite Claude Code v2.1.234 ou ultérieur |
CLAUDE_CODE_HIDE_CWD |
Définissez à 1 pour masquer le répertoire de travail dans le logo de démarrage. Utile pour les partages d'écran ou les enregistrements où le chemin expose votre nom d'utilisateur du système d'exploitation |
CLAUDE_CODE_IDE_HOST_OVERRIDE |
Remplacez l'adresse d'hôte utilisée pour se connecter à l'extension IDE. Par défaut, Claude Code détecte automatiquement l'adresse correcte, y compris le routage WSL vers Windows |
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL |
Définissez à 1 pour ignorer l'installation automatique des extensions IDE. Équivalent à définir autoInstallIdeExtension à false |
CLAUDE_CODE_IDE_SKIP_VALID_CHECK |
Définissez à 1 pour ignorer la validation des entrées du fichier de verrouillage IDE lors de la connexion. Utilisez lorsque la connexion automatique ne trouve pas votre IDE malgré son exécution |
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS |
Combien de sous-agents peuvent s'exécuter dans une session avant que l'outil Agent refuse d'en générer un autre (par défaut : 20). Accepte un nombre entier positif en chiffres simples ; tout le reste est ignoré, afin que la variable puisse ajuster le plafond mais ne peut pas le désactiver. Nécessite Claude Code v2.1.217 ou ultérieur |
CLAUDE_CODE_MAX_CONTEXT_TOKENS |
Remplacez la taille de la fenêtre de contexte que Claude Code suppose pour le modèle actif. À partir de v2.1.193, la façon dont elle s'applique dépend de la façon dont Claude Code résout l'ID du modèle ; voir Corriger la fenêtre pour un ID de modèle de passerelle ou personnalisé. Utilisez ceci lors du routage vers un modèle via ANTHROPIC_BASE_URL dont la fenêtre de contexte ne correspond pas à la taille intégrée pour son nom |
CLAUDE_CODE_MAX_OUTPUT_TOKENS |
Définissez le nombre maximum de jetons de sortie pour la plupart des requêtes. Les valeurs par défaut et les plafonds varient selon le modèle ; voir max output tokens. Claude Code utilise par défaut 32000 pour les ID de modèle qu'il ne reconnaît pas, comme les noms spécifiques à la passerelle, et abaisse les valeurs au-dessus du plafond d'un modèle au plafond. Augmenter cette valeur réduit la fenêtre de contexte effective disponible avant le déclenchement de la compaction automatique |
CLAUDE_CODE_MAX_RETRIES |
Remplacez le nombre de fois pour réessayer les requêtes API échouées (par défaut : 10). Limité à 15 à partir de v2.1.186 ; à partir de v2.1.199, CLAUDE_CODE_RETRY_WATCHDOG augmente la valeur par défaut et supprime le plafond. Pour les sessions sans surveillance qui doivent attendre les pannes plus longues, définissez CLAUDE_CODE_RETRY_WATCHDOG à la place |
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION |
Supprimé dans v2.1.224 et maintenant un no-op. Auparavant, limitait le nombre total de sous-agents que Claude pouvait générer avec l'outil Agent dans une session (par défaut : 200) ; générer au-delà du plafond échouait avec Subagent spawn limit reached. La limite de sous-agent concurrent et la limite de profondeur s'appliquent toujours |
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH |
Nombre de couches de sous-agent autorisées sous la conversation principale (par défaut : 3). À la valeur par défaut, les sous-agents peuvent générer leurs propres sous-agents, et un sous-agent à la troisième couche ne peut pas générer plus loin ; définissez 1 pour désactiver l'imbrication. Dans v2.1.217 à v2.1.218, la valeur par défaut était 1, afin qu'un sous-agent ne puisse pas générer le sien à moins que vous augmentiez la limite ; v2.1.219 a augmenté la valeur par défaut à 3. Accepte un nombre entier positif en chiffres simples ; tout le reste est ignoré, afin que la limite puisse être ajustée mais pas supprimée. Nécessite Claude Code v2.1.217 ou ultérieur |
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY |
Nombre maximum d'outils en lecture seule et de sous-agents qui peuvent s'exécuter en parallèle (par défaut : 10). Les valeurs plus élevées augmentent le parallélisme mais consomment plus de ressources |
CLAUDE_CODE_MAX_TURNS |
Limitez le nombre de tours d'agent lorsqu'aucune limite explicite n'est transmise. Équivalent à transmettre --max-turns, qui a la priorité lorsque les deux sont définis. Une valeur qui n'est pas un entier positif est rejetée au démarrage avec une erreur plutôt que traitée comme aucun plafond |
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION |
Plafond sur le nombre total d'appels WebSearch qu'une session peut faire (par défaut : 200). Lorsque Claude atteint le plafond, les appels WebSearch supplémentaires retournent un avis lui disant de continuer avec les informations qu'il a déjà rassemblées. Accepte un nombre entier positif sans limite supérieure. Tout le reste est ignoré et la valeur par défaut s'applique, afin que le plafond puisse être augmenté mais pas désactivé. Nécessite Claude Code v2.1.212 ou ultérieur |
CLAUDE_CODE_MCP_ALLOWLIST_ENV |
Définissez à 1 pour générer les serveurs MCP stdio avec uniquement un environnement de base sûr plus le env configuré du serveur, au lieu d'hériter de votre environnement shell |
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS |
Temps écoulé en millisecondes avant qu'un appel d'outil MCP toujours en cours d'exécution se déplace vers une tâche d'arrière-plan (par défaut : 120000, ou 2 minutes). Définissez à 0 pour désactiver la mise en arrière-plan automatique. Nécessite Claude Code v2.1.212 ou ultérieur |
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT |
Délai d'expiration d'inactivité en millisecondes pour les appels d'outils MCP. Lorsqu'un serveur MCP stdio, HTTP, SSE, WebSocket ou connecteur claude.ai n'envoie aucune réponse et aucune notification de progression pendant ce temps, l'appel d'outil interrompt avec une erreur au lieu d'attendre le MCP_TOOL_TIMEOUT global. Remplace les valeurs par défaut par transport de 300000 (5 minutes) pour les serveurs réseau et 1800000 (30 minutes) pour les serveurs stdio. Définissez à 0 pour désactiver la vérification d'inactivité. Les valeurs inférieures à 1000 sont augmentées à une seconde, et la valeur est limitée au MCP_TOOL_TIMEOUT effectif. Un timeout par serveur dans .mcp.json d'au moins 1000 augmente la fenêtre d'inactivité de ce serveur à au moins la valeur timeout. Ne s'applique pas aux serveurs IDE ou aux serveurs en processus du SDK. Nécessite Claude Code v2.1.187 ou ultérieur. Avant v2.1.203, les serveurs stdio étaient exempts du délai d'expiration d'inactivité |
CLAUDE_CODE_MESSAGING_SOCKET |
Défini par Claude Code, pas par vous : dans les sessions qui lient une socket de boîte de réception, Claude Code exporte le chemin de cette socket aux hooks et aux commandes Bash lorsqu'il lie la socket. Dans une session qui démarre avec la messagerie activée, Claude Code lie la socket avant tout hook. Les autres sessions sur la machine livrent les messages à ce chemin. Chaque session exporte sa propre socket plutôt qu'une héritée d'un parent, et les messages arrivant sur elle passent par les contrôles entrants de la session. Les blocs env des paramètres ne peuvent pas le définir. Nécessite Claude Code v2.1.224 ou ultérieur |
CLAUDE_CODE_MESSAGING_TOKEN |
Défini par Claude Code, pas par vous : dans les sessions qui lient une socket de boîte de réception, Claude Code exporte ce jeton par session aux hooks et aux commandes Bash aux côtés de CLAUDE_CODE_MESSAGING_SOCKET. Un script affichant sur la socket peut envoyer {"type":"auth","token":"<token>"} comme sa première ligne pour prouver qu'il appartient à la session. Sur Windows natif, Claude Code nécessite cette ligne et ferme toute connexion qui ne s'ouvre pas avec une valeur valide. Les règles propres-enfant disent quand Claude Code consulte le jeton. Chaque session exporte son propre jeton, jamais un hérité d'une session parent. Les blocs env des paramètres ne peuvent pas le définir. Nécessite Claude Code v2.1.228 ou ultérieur |
CLAUDE_CODE_NATIVE_CURSOR |
Définissez à 1 pour afficher le curseur propre du terminal à la position du curseur d'entrée au lieu d'un bloc dessiné. Le curseur respecte les paramètres de clignotement, de forme et de focus du terminal |
CLAUDE_CODE_NEW_INIT |
Définissez à 1 pour faire exécuter /init un flux de configuration interactif. Le flux demande quels fichiers générer, y compris CLAUDE.md, les compétences et les hooks, avant d'explorer la base de code et de les écrire. Sans cette variable, /init génère un CLAUDE.md automatiquement sans demander |
CLAUDE_CODE_NO_FLICKER |
Définissez à 1 pour activer le rendu plein écran, un aperçu de recherche qui réduit le scintillement et garde la mémoire plate dans les longues conversations. Remplace le paramètre tui ; vous pouvez également basculer avec /tui fullscreen |
CLAUDE_CODE_OAUTH_REFRESH_TOKEN |
Jeton d'actualisation OAuth pour l'authentification Claude.ai. Lorsqu'il est défini, claude auth login échange ce jeton directement au lieu d'ouvrir un navigateur. Nécessite CLAUDE_CODE_OAUTH_SCOPES. Utile pour provisionner l'authentification dans les environnements automatisés |
CLAUDE_CODE_OAUTH_SCOPES |
Portées OAuth séparées par des espaces avec lesquelles le jeton d'actualisation a été émis, comme "user:profile user:inference user:sessions:claude_code". Requis lorsque CLAUDE_CODE_OAUTH_REFRESH_TOKEN est défini |
CLAUDE_CODE_OAUTH_TOKEN |
Jeton d'accès OAuth pour l'authentification claude.ai. Alternative à /login pour le SDK et les environnements automatisés. A la priorité sur les identifiants stockés dans le trousseau. Générez-en un avec claude setup-token. À moins que vous n'exécutiez /login, Claude Code utilise le jeton que vous définissez pour la session entière. Pour remplacer un jeton expiré, générez-en un nouveau et redémarrez |
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE |
Supprimé dans v2.1.160 et maintenant un no-op. Auparavant, épinglait le mode rapide à Claude Opus 4.6 au lieu de la valeur par défaut actuelle. Opus 4.6 ne supporte plus le mode rapide |
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH |
Longueur maximale des attributs OpenTelemetry porteurs de contenu (réponses du modèle, contenu d'outil, prompts système, corps API bruts), marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, c.-à-d. 60 Ko). Augmentez-le uniquement si votre backend de télémétrie accepte les valeurs d'attribut supérieures à 64 Ko, ou abaissez-le pour réduire le volume de télémétrie. Nécessite Claude Code v2.1.214 ou ultérieur. Voir Surveillance |
CLAUDE_CODE_OTEL_DIAG_STDERR |
Définissez à 1 pour écrire les erreurs de diagnostic de l'exportateur OpenTelemetry sur stderr. Par défaut, ces erreurs n'apparaissent que avec --debug, afin qu'un exportateur mal configuré comme une collision de port Prometheus échoue silencieusement autrement. Nécessite Claude Code v2.1.179 ou ultérieur. Voir Surveillance |
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS |
Délai d'expiration en millisecondes pour vider les spans OpenTelemetry en attente (par défaut : 5000). Voir Surveillance |
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS |
Intervalle pour actualiser les en-têtes OpenTelemetry dynamiques en millisecondes (par défaut : 1740000 / 29 minutes). Voir En-têtes dynamiques |
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS |
Délai d'expiration en millisecondes pour que l'exportateur OpenTelemetry se termine à l'arrêt (par défaut : 2000). Augmentez si les métriques sont supprimées à la sortie. Voir Surveillance |
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE |
Définissez à 1 pour permettre à Claude Code d'exécuter la commande de mise à niveau de votre gestionnaire de paquets en arrière-plan lorsqu'une nouvelle version est disponible. S'applique aux installations Homebrew et WinGet. Les autres gestionnaires de paquets continuent à afficher la commande de mise à niveau sans l'exécuter. Voir Mises à jour automatiques |
CLAUDE_CODE_PERFORCE_MODE |
Définissez à 1 pour activer la protection en écriture consciente de Perforce. Lorsqu'elle est définie, Edit, Write et NotebookEdit échouent avec un indice p4 edit <file> si le fichier cible manque le bit d'écriture du propriétaire, que Perforce efface sur les fichiers synchronisés jusqu'à ce que p4 edit les ouvre. Cela empêche Claude Code de contourner le suivi des modifications de Perforce |
CLAUDE_CODE_PLUGIN_CACHE_DIR |
Remplacez le répertoire racine des plugins. Malgré le nom, cela définit le répertoire parent, pas le cache lui-même : les places de marché et le cache des plugins vivent dans des sous-répertoires sous ce chemin. Par défaut ~/.claude/plugins |
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS |
Délai d'expiration en millisecondes pour les opérations git lors de l'installation ou de la mise à jour des plugins (par défaut : 120000). Augmentez cette valeur pour les grands référentiels ou les connexions réseau lentes. Voir Les opérations Git expirent |
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE |
Définissez à 1 pour ignorer la tentative de re-clonage et continuer à utiliser le cache de place de marché existant lorsqu'un git pull échoue. Utile dans les environnements hors ligne ou isolés où le re-clonage échouerait de la même manière. Voir Les mises à jour de place de marché échouent dans les environnements hors ligne |
CLAUDE_CODE_PLUGIN_PREFER_HTTPS |
Définissez à 1 pour cloner les sources de raccourci GitHub owner/repo sur HTTPS au lieu de SSH. S'applique à l'installation et à la mise à jour des plugins, et à /plugin marketplace add et update. Utile dans les exécuteurs CI, les conteneurs ou tout environnement sans clé SSH configurée pour github.com |
CLAUDE_CODE_PLUGIN_SEED_DIR |
Chemin d'accès à un ou plusieurs répertoires de semences de plugins en lecture seule, séparés par : sur Unix ou ; sur Windows. Utilisez ceci pour regrouper un répertoire de plugins pré-rempli dans une image de conteneur. Claude Code enregistre les places de marché à partir de ces répertoires au démarrage et utilise les plugins pré-cachés sans re-clonage. Voir Pré-remplir les plugins pour les conteneurs |
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY |
Définissez à 1 pour empêcher Claude Code de transmettre -ExecutionPolicy Bypass lors du lancement de PowerShell pour les appels d'outils, les hooks et les commandes de status line, et respecter la politique d'exécution effective de la machine à la place. Par défaut, Claude Code contourne la politique d'exécution à la portée du processus afin que les scripts .ps1 et les importations de modules fonctionnent sur les installations Windows par défaut-Restricted. Le contournement à la portée du processus ne remplace jamais la MachinePolicy ou UserPolicy de Group Policy quel que soit ce paramètre |
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS |
Plafond en millisecondes sur l'attente inactive pour les sous-agents et workflows d'arrière-plan après le tour final en mode non interactif avec le drapeau -p. L'attente inactive recommence chaque fois que Claude prend un tour pour gérer un résultat d'arrière-plan. Par défaut : 600000, ou 10 minutes. Lorsque l'attente inactive atteint le plafond, Claude Code cesse d'attendre les tâches d'arrière-plan restantes et quitte. Définissez à 0 pour attendre indéfiniment. Ce plafond est séparé de la période de grâce de cinq secondes qui s'applique aux shells d'arrière-plan simples. Nécessite Claude Code v2.1.182 ou ultérieur |
CLAUDE_CODE_PROCESS_WRAPPER |
Lancez les processus que Claude Code démarre à partir de son propre binaire, comme le service d'arrière-plan qui héberge les sessions de vue agent, via un lanceur d'entreprise donné en tant que préfixe argv comme /opt/corp/launcher. Définissez-le dans le bloc env des paramètres utilisateur ou gérés, pas en tant qu'export shell, afin que le service d'arrière-plan détaché l'hérite ; les paramètres de projet et locaux ne peuvent pas le définir. Équivalent au paramètre processWrapper, qui nécessite Claude Code v2.1.210 ou ultérieur ; cette variable a la priorité lorsque les deux sont définis. L'extension VS Code configure son propre lanceur séparément via son paramètre claudeProcessWrapper. Ignoré sur Windows. Voir Exécuter Claude Code derrière un lanceur d'entreprise pour le format de valeur, ce que le lanceur couvre et le contrat que le lanceur doit satisfaire. Nécessite Claude Code v2.1.208 ou ultérieur |
CLAUDE_CODE_PROJECT_DIR_NAME |
Défini avec CLAUDE_CONFIG_DIR pour choisir le nom du répertoire projects/ sous lequel Claude Code stocke les transcriptions et la mémoire automatique de cette session, à la place d'un dérivé du chemin du répertoire de travail. Par exemple, démarrer Claude Code avec CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude les stocke sous /srv/tenant-a/projects/work/. Claude Code ignore cette variable lorsque CLAUDE_CONFIG_DIR n'est pas défini, et la lit uniquement à partir de l'environnement à partir duquel vous démarrez claude, jamais à partir d'un bloc env du fichier de paramètres. Voir Nommer le répertoire du projet vous-même. Nécessite Claude Code v2.1.234 ou ultérieur |
CLAUDE_CODE_PROMPT_CACHE_TTL |
Définissez 5m ou 1h, les seules valeurs que Claude Code accepte, pour choisir la TTL du cache du prompt pour la conversation principale : vos tours interactifs, -p et SDK, plus les aides qui s'exécutent en ligne avec eux. A la priorité sur le paramètre promptCacheTtl et sur ENABLE_PROMPT_CACHING_1H, et FORCE_PROMPT_CACHING_5M le remplace. Les écritures du cache d'une heure sont facturées à un taux plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur |
CLAUDE_CODE_PROPAGATE_TRACEPARENT |
Définissez à 1 pour propager le contexte de trace W3C lorsque ANTHROPIC_BASE_URL pointe vers un proxy personnalisé. La propagation couvre l'en-tête traceparent sur les requêtes de modèle et MCP HTTP et la variable d'environnement TRACEPARENT pour les sous-processus Bash, PowerShell et hook. Par défaut, la propagation est activée uniquement lorsqu'elle est connectée directement à l'API Anthropic. Ajouté dans v2.1.152. Voir Traces (bêta) |
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST |
Défini par les plates-formes hôtes qui intègrent Claude Code et gèrent le routage du fournisseur de modèles en son nom. Lorsqu'elle est définie, Claude Code ignore les variables de sélection du fournisseur, de point de terminaison et d'authentification telles que CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL et ANTHROPIC_API_KEY dans les fichiers de paramètres, afin que les paramètres utilisateur ne puissent pas remplacer le routage de l'hôte. Claude Code ignore également les clés de sélection de modèle telles que model, fallbackModel et modelOverrides dans les paramètres gérés, quelle que soit la source gérée qui les livre, afin que la configuration du modèle de l'hôte ait la priorité sur un épinglage de modèle obsolète. Claude Code ignore également les variables de sélection de modèle telles que ANTHROPIC_MODEL et la famille ANTHROPIC_DEFAULT_*_MODEL dans un bloc env géré ; une liste d'autorisation availableModels dans les paramètres gérés s'applique toujours sauf si l'hôte fournit la sienne. Claude Code ignore également l'opt-out de télémétrie automatique qu'il applique autrement sur les fournisseurs tiers tels que Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform et Microsoft Foundry, afin que la télémétrie suive l'opt-out standard DISABLE_TELEMETRY. Voir Comportements par défaut par fournisseur API |
CLAUDE_CODE_PROXY_RESOLVES_HOSTS |
Définissez à 1 pour permettre au proxy d'effectuer la résolution DNS au lieu de l'appelant. Opt-in pour les environnements où le proxy doit gérer la résolution du nom d'hôte |
CLAUDE_CODE_REMOTE |
Défini automatiquement à true lorsque Claude Code s'exécute en tant que session cloud. Lisez ceci à partir d'un hook ou d'un script de configuration pour détecter si vous êtes dans une session cloud |
CLAUDE_CODE_REMOTE_SESSION_ID |
Défini automatiquement dans les sessions cloud à l'ID de la session actuelle. Lisez ceci pour construire un lien vers la transcription de la session. Voir Lier la sortie à la session |
CLAUDE_CODE_RESTRICTED |
Définissez à 1 pour démarrer la session en mode restreint, identique à transmettre --restricted. Claude Code ignore cette variable dans le bloc env d'un fichier de paramètres. Nécessite Claude Code v2.1.248 ou ultérieur |
CLAUDE_CODE_RESUME_INTERRUPTED_TURN |
Définissez à 1 pour reprendre automatiquement si la session précédente s'est terminée en milieu de tour. Utilisé en mode SDK afin que le modèle continue sans que le SDK ait besoin de renvoyer le prompt. Pour désactiver ceci, supprimez la variable ou définissez-la à 0. Avant v2.1.221, Claude Code ignorait 0 et les autres valeurs falsy, afin que définir 0 déclenchait toujours la reprise en mode non interactif et supprimer la variable était le seul moyen de la désactiver |
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS |
Âge maximum en millisecondes du dernier message de transcription pour qu'une session qui s'est terminée en milieu de tour continue automatiquement à la reprise. Lorsque le dernier message est plus ancien que cette limite, Claude Code ignore à la fois la reprise automatique CLAUDE_CODE_RESUME_INTERRUPTED_TURN et le message de continuation injecté CLAUDE_CODE_RESUME_PROMPT, et la session démarre inactive afin que vous continuiez explicitement. Non défini ou 0 signifie aucune limite ; une valeur négative ou non numérique applique une limite d'une heure. Les scripts de génération pour les agents longue durée peuvent définir ceci afin qu'un redémarrage contre une ancienne transcription ne réexécute pas un prompt obsolète. Claude Code définit lui-même une limite d'une heure lorsqu'il redémarre une session de vue agent qui a hérité sa conversation d'une session interactive. Nécessite Claude Code v2.1.211 ou ultérieur |
CLAUDE_CODE_RESUME_PROMPT |
Remplacez le message de continuation injecté lors de la reprise d'une session qui s'est terminée en milieu de tour. Par défaut Continue from where you left off.. Les scripts de génération pour les agents longue durée peuvent définir ceci sur un message de démarrage plus directif. Une chaîne vide utilise la valeur par défaut |
CLAUDE_CODE_RETRY_WATCHDOG |
Définissez à 1 pour les sessions sans surveillance telles que les harnais d'évaluation, les travaux CI ou les travailleurs distants. Réessaye les erreurs de capacité 429 et 529 indéfiniment au lieu d'échouer après CLAUDE_CODE_MAX_RETRIES tentatives. Claude Code échoue immédiatement sur un 429 qui signale une limite de dépenses ou des crédits d'utilisation épuisés, même un de la limite de dépenses de passerelle qui se réinitialise selon un calendrier. Avant v2.1.239, le chien de garde réessayait ces indéfiniment. Le chien de garde recule jusqu'à 5 minutes entre les tentatives, ou jusqu'à ce que la limite se réinitialise lorsque la réponse porte un temps de réinitialisation du taux limite, afin qu'une session qui atteint une limite d'utilisation attende la fenêtre restante. Sur v2.1.199 ou ultérieur, il augmente également le nombre de tentatives par défaut pour les autres erreurs transitoires, telles que les erreurs serveur, les délais d'expiration et les connexions supprimées, à 300, environ trois heures de recul, et supprime le plafond de 15 sur CLAUDE_CODE_MAX_RETRIES si vous définissez cette variable explicitement. Nécessite Claude Code v2.1.186 ou ultérieur |
CLAUDE_CODE_SAFE_MODE |
Définissez à 1 pour démarrer en mode sûr : CLAUDE.md, les compétences, les plugins, les hooks, les serveurs MCP, les commandes et agents personnalisés, les styles de sortie, les workflows, les thèmes personnalisés, les liaisons de clés personnalisées, les commandes de status line et de suggestion de fichier, les serveurs LSP et la mémoire automatique ne se chargent pas, pour dépanner une configuration cassée. La politique des paramètres gérés s'applique toujours, y compris les hooks configurés par la politique, la status line et les commandes de suggestion de fichier ; les plugins gérés, les compétences gérées, le CLAUDE.md géré et les serveurs MCP configurés par la politique ne le font pas. Équivalent à transmettre --safe-mode. Les processus enfants directement générés héritent de la variable |
CLAUDE_CODE_SCRIPT_CAPS |
Objet JSON limitant le nombre de fois que des scripts spécifiques peuvent être invoqués par session lorsque CLAUDE_CODE_SUBPROCESS_ENV_SCRUB est défini. Les clés sont des sous-chaînes mises en correspondance avec le texte de la commande ; les valeurs sont des limites d'appel entières. Par exemple, {"deploy.sh": 2} permet à deploy.sh d'être appelé au maximum deux fois. La correspondance est basée sur des sous-chaînes afin que les astuces d'expansion shell comme ./scripts/deploy.sh $(evil) comptent toujours contre le plafond. Le fan-out d'exécution via xargs ou find -exec n'est pas détecté ; c'est un contrôle de défense en profondeur |
CLAUDE_CODE_SCROLL_SPEED |
Définissez le multiplicateur de vitesse de défilement de la molette de la souris en rendu plein écran. Accepte n'importe quelle valeur positive jusqu'à 20, y compris les valeurs fractionnaires inférieures à 1 comme 0.5 pour ralentir le défilement accéléré du trackpad et de la molette dans les terminaux qui amplifient déjà les événements de molette. Définissez à 3 pour correspondre à vim si votre terminal envoie un événement de molette par cran sans amplification. Ignoré dans le terminal IDE JetBrains, où Claude Code utilise sa propre gestion du défilement |
CLAUDE_CODE_SEND_FEEDBACK |
Définissez à 0 pour désactiver les retours d'information rédigés par Claude pour une session. Définissez à 1 pour l'activer où votre compte a déjà accès ; la variable ne peut pas accorder l'accès elle-même, et les autres commutateurs qui désactivent les retours d'information, tels que DISABLE_FEEDBACK_COMMAND et la valeur off du paramètre feedbackDrafts, s'appliquent toujours |
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS |
Remplacez le budget de temps en millisecondes pour les hooks SessionEnd. S'applique à la sortie de session, /clear et au changement de sessions via /resume interactif. Par défaut, le budget est de 1,5 secondes, augmenté automatiquement au plus haut timeout par hook configuré dans les fichiers de paramètres, jusqu'à 60 secondes. Les délais d'expiration sur les hooks fournis par les plugins ne augmentent pas le budget |
CLAUDE_CODE_SESSION_ID |
Défini automatiquement à l'ID de session actuelle dans les sous-processus de l'outil Bash et PowerShell, les sous-processus de la commande hook et les sous-processus du serveur MCP stdio. Pour Bash, PowerShell et les hooks, cela correspond au champ session_id dans l'entrée JSON du hook et est mis à jour sur /clear. Un sous-processus du serveur MCP conserve l'ID avec lequel il a été généré. Sur --resume <session-id>, il reçoit l'ID repris. Sur --continue ou --resume sans ID explicite, il peut recevoir l'ID de démarrage initial à la place. Utilisez pour corréler les scripts et les outils externes avec la session Claude Code qui les a lancés |
CLAUDE_CODE_SHELL |
Définissez le shell que Claude Code utilise pour exécuter les commandes de l'outil Bash. Accepte un chemin vers un binaire bash ou zsh, par exemple /opt/homebrew/bin/bash. Les autres shells comme fish ne sont pas supportés. Si la valeur n'est pas un chemin bash ou zsh fonctionnant, Claude Code l'ignore et revient à la détection automatique. La détection automatique utilise votre $SHELL lorsqu'il pointe vers bash ou zsh, sinon elle choisit le premier zsh fonctionnant puis bash trouvé sur votre PATH et les emplacements d'installation standard |
CLAUDE_CODE_SHELL_PREFIX |
Préfixe de commande qui enveloppe les commandes shell que Claude Code génère : appels d'outil Bash, commandes hook, commandes status line et commandes de démarrage du serveur MCP stdio. Les hooks PowerShell et les hooks de forme exec s'exécutent sans le préfixe. Utile pour la journalisation ou l'audit. Définir un chemin d'exécutable nu comme /path/to/logger.sh exécute chaque commande comme /path/to/logger.sh '<command>'. Le wrapper reçoit la ligne de commande en tant qu'argument shell-quoted unique dans $1, afin que le wrapper doit réévaluer $1 avec un shell, par exemple exec bash -c "$1". Traiter $1 comme un chemin d'exécutable nu casse les serveurs MCP stdio qui transmettent des arguments comme npx -y <package>. Pour les appels d'outil Bash, $1 contient l'invocation shell complète que Claude Code assemble, y compris la configuration de l'environnement, pas seulement la commande que Claude a exécutée |
CLAUDE_CODE_SIMPLE |
Définissez à 1 pour exécuter avec un prompt système minimal et uniquement les outils Bash, lecture de fichier et édition de fichier. Les outils MCP de --mcp-config sont toujours disponibles. Désactive la découverte automatique des hooks, compétences, commandes personnalisées, sous-agents, plugins, serveurs MCP, mémoire automatique et CLAUDE.md. Les compétences dans un répertoire que vous transmettez avec --add-dir se chargent toujours. Les jetons OAuth et les identifiants du trousseau ne sont pas lus, afin que l'authentification Anthropic doit provenir de ANTHROPIC_API_KEY ou d'un apiKeyHelper dans --settings. Équivalent à transmettre --bare |
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT |
Définissez à 1 pour utiliser un prompt système plus court et des descriptions d'outils abrégées sur n'importe quel modèle. Définissez à 0, false, no ou off pour refuser même sur les modèles où l'expérience ou la configuration du serveur l'activerait autrement. L'ensemble complet d'outils, les hooks, les serveurs MCP et la découverte CLAUDE.md restent activés |
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH |
Ignorez l'authentification côté client pour Claude Platform on AWS, pour les passerelles qui signent les requêtes elles-mêmes |
CLAUDE_CODE_SKIP_AWS_CRED_CACHE |
Définissez à 1 pour désactiver le cache en processus des identifiants résolus à partir de la chaîne de fournisseur d'identifiants par défaut AWS, afin que Claude Code résout la chaîne à chaque requête API. Avec le cache désactivé, un profil soutenu par SSO demande des identifiants à IAM Identity Center à chaque requête. Voir mise en cache des identifiants et délai d'expiration de la résolution. Nécessite Claude Code v2.1.207 ou ultérieur |
CLAUDE_CODE_SKIP_BEDROCK_AUTH |
Ignorez l'authentification AWS pour Amazon Bedrock (par exemple, lors de l'utilisation d'une passerelle LLM) |
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS |
Définissez à 1 pour traiter une vérification de disponibilité du mode rapide échouée comme disponible, pour les réseaux qui bloquent la requête directe de la vérification vers api.anthropic.com. Claude Code honore toujours une réponse « désactivé par votre organisation » |
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK |
Définissez à 1 pour ignorer la vérification de disponibilité du mode rapide côté client, pour les proxies qui interceptent la requête de la vérification plutôt que de la refuser. L'API rejette toujours les requêtes du mode rapide lorsque votre organisation a le mode rapide désactivé |
CLAUDE_CODE_SKIP_FOUNDRY_AUTH |
Ignorez l'authentification Azure pour Microsoft Foundry, pour un proxy ou une passerelle qui injecte son propre en-tête Authorization. Claude Code envoie les requêtes sans identifiant Azure et préserve l'en-tête Authorization que vous fournissez, par exemple via ANTHROPIC_CUSTOM_HEADERS. Ignoré lorsque ANTHROPIC_FOUNDRY_API_KEY ou ANTHROPIC_FOUNDRY_AUTH_TOKEN est défini. Avant v2.1.203, cette variable laissait le client Microsoft Foundry incapable d'envoyer des requêtes sauf si une clé API était également définie |
CLAUDE_CODE_SKIP_MANTLE_AUTH |
Ignorez l'authentification AWS pour Amazon Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM) |
CLAUDE_CODE_SKIP_PROMPT_HISTORY |
Définissez à 1 pour ignorer l'écriture de l'historique des prompts et des transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n'apparaissent pas dans --resume, --continue ou l'historique de la flèche vers le haut. Utile pour les sessions de script éphémères |
CLAUDE_CODE_SKIP_VERTEX_AUTH |
Ignorez l'authentification Google pour Google Cloud's Agent Platform (par exemple, lors de l'utilisation d'une passerelle LLM) |
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP |
Nombre maximum de fois consécutives qu'un hook Stop ou SubagentStop peut bloquer la fin du tour avant que Claude Code le remplace et termine le tour de toute façon (par défaut : 8). Définissez à 0 pour désactiver le plafond. Augmentez ceci si votre hook a légitimement besoin de plus d'itérations pour se résoudre |
CLAUDE_CODE_SUBAGENT_MODEL |
Le modèle par défaut pour les sous-agents, les coéquipiers de l'équipe d'agents et les agents de workflow qui ne sont pas assignés à un modèle d'une autre manière. Accepte un alias comme haiku ou un nom de modèle complet. Deux sources ont la priorité sur lui : un modèle que Claude transmet lorsqu'il génère l'agent, et un champ model dans la définition de l'agent, y compris inherit. Pour changer cela, définissez CLAUDE_CODE_SUBAGENT_MODEL_FORCE. Voir Choisir un modèle pour l'ordre complet. Le définir à inherit est identique à le laisser non défini. Avant v2.1.251, cette variable remplaçait à la fois le modèle par invocation et le champ model de la définition |
CLAUDE_CODE_SUBAGENT_MODEL_FORCE |
Définissez à 1 pour forcer un modèle sur les sous-agents, les coéquipiers et les agents de workflow. Exécuter chaque sous-agent sur un modèle dit quel modèle c'est. Nécessite Claude Code v2.1.257 ou ultérieur |
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL |
Définissez 5m ou 1h, les seules valeurs que Claude Code accepte, pour choisir la TTL du cache du prompt pour les requêtes en dehors de la conversation principale, telles que les sous-agents, les workflows et le travail d'arrière-plan. A la priorité sur le paramètre subagentPromptCacheTtl et sur ENABLE_PROMPT_CACHING_1H, et FORCE_PROMPT_CACHING_5M le remplace. Les écritures du cache d'une heure sont facturées à un taux plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur |
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB |
Définissez à 1 pour supprimer les identifiants des environnements de sous-processus (outil Bash, hooks, serveurs MCP stdio) : identifiants Anthropic et fournisseur cloud, toute autre variable que Claude Code reconnaît comme un identifiant, et identifiants intégrés dans les URL du registre de paquets. Le processus Claude parent garde ces identifiants pour les appels API, mais les processus enfants ne peuvent pas les lire, réduisant l'exposition aux attaques par injection de prompt qui tentent d'exfiltrer les secrets via l'expansion shell. Sur Linux, cela exécute également les sous-processus Bash dans un espace de noms PID isolé afin qu'ils ne puissent pas lire les environnements de processus hôte via /proc ; en conséquence, ps, pgrep et kill ne peuvent pas voir ou signaler les processus hôte. claude-code-action définit ceci automatiquement lorsque allowed_non_write_users est configuré |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL |
Définissez à 1 en mode non interactif (le drapeau -p) pour attendre la fin de l'installation du plugin avant la première requête. Sans ceci, les plugins s'installent en arrière-plan et peuvent ne pas être disponibles au premier tour. Combinez avec CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS pour limiter l'attente |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS |
Délai d'expiration en millisecondes pour l'installation synchrone du plugin. Lorsqu'il est dépassé, Claude Code procède sans plugins et enregistre une erreur. Pas de valeur par défaut : sans cette variable, l'installation synchrone attend jusqu'à la fin |
CLAUDE_CODE_SYNC_SKILLS |
Définissez à 1 pour télécharger vos compétences claude.ai activées dans ~/.claude/skills/synced/ et resynchroniser toutes les 10 minutes. Avant d'exécuter la première requête, Claude Code attend jusqu'à CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS pour la liste de vos compétences. Les téléchargements eux-mêmes se terminent en arrière-plan, et Claude attend le téléchargement d'une compétence lorsqu'il l'invoque. Le nom du dossier synced est réservé pour ce téléchargement. Avant v2.1.227, les compétences se téléchargeaient directement dans ~/.claude/skills/. S'applique uniquement en mode non interactif avec le drapeau -p. Nécessite l'authentification claude.ai. Les sessions Claude Code on the web reçoivent vos compétences claude.ai activées automatiquement ; vous n'avez pas besoin de définir ceci là. Claude Code applique des règles supplémentaires aux compétences téléchargées, comme ne pas exécuter leurs commandes ! sur votre machine |
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS |
Délai d'expiration en millisecondes pour une resynchronisation des compétences en milieu de session lorsque CLAUDE_CODE_SYNC_SKILLS est défini (par défaut : 30000). Limite le téléchargement déclenché lorsque l'hôte demande un rechargement des compétences pendant la session. Lorsqu'il est dépassé, la resynchronisation s'arrête et les téléchargements restants continuent en arrière-plan |
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS |
Délai d'expiration en millisecondes pour que la première requête attende la liste initiale des compétences lorsque CLAUDE_CODE_SYNC_SKILLS est défini (par défaut : 5000). Lorsqu'il est dépassé, la première requête s'exécute avec les compétences qui sont arrivées. Les téléchargements se terminent en arrière-plan de toute façon, et Claude attend le téléchargement d'une compétence lorsqu'il l'invoque |
CLAUDE_CODE_SYNTAX_HIGHLIGHT |
Définissez à false pour désactiver la coloration syntaxique dans la sortie diff. Utile lorsque les couleurs interfèrent avec votre configuration de terminal. Pour désactiver également la coloration dans les blocs de code et les aperçus de fichier, utilisez le paramètre syntaxHighlightingDisabled |
CLAUDE_CODE_TASK_LIST_ID |
Partagez une liste de tâches entre les sessions. Définissez le même ID dans plusieurs instances Claude Code pour coordonner une liste de tâches partagée, dans les sessions qui ont les outils Task. Voir Liste des tâches |
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS |
Remplacez, en millisecondes, le temps qu'une session non interactif attend à la sortie pour que son équipe d'agents se démantèle. Accepte 1000 à 60000 ; une valeur hors plage est ignorée et la valeur par défaut de 10000 s'applique. Nécessite Claude Code v2.1.206 ou ultérieur |
CLAUDE_CODE_TMPDIR |
Remplacez le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute /claude-{uid}/ sur Unix ou /claude/ sur Windows à ce chemin. Par défaut : /tmp sur macOS, os.tmpdir() sur Linux et Windows. Sur macOS et Linux, les sous-processus Bash sandboxés reçoivent un $TMPDIR de secours court sous la valeur par défaut du système lorsque votre substitution est un chemin long, car certains outils échouent lorsque les chemins temporaires deviennent trop longs. Les commandes Bash non sandboxées héritent du $TMPDIR de votre shell inchangé. Les fichiers temporaires propres de Claude Code utilisent toujours votre substitution. Définissez-le dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignoré dans les paramètres de projet et locaux |
CLAUDE_CODE_TMUX_TRUECOLOR |
Définissez à n'importe quelle valeur non vide, comme 1, pour permettre la sortie truecolor 24 bits à l'intérieur de tmux. Définir à 0 ou false permet toujours truecolor, contrairement à la plupart des variables activées/désactivées ; supprimez la variable pour restaurer le serrage de 256 couleurs. Par défaut, Claude Code serre à 256 couleurs lorsque $TMUX est défini car tmux ne transmet pas les séquences d'échappement truecolor sauf s'il est configuré pour le faire. Définissez ceci après avoir ajouté set -ga terminal-overrides ',*:Tc' à votre ~/.tmux.conf. Voir Configuration du terminal pour les autres paramètres tmux |
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE |
Sur Linux et WSL, définissez à une liste séparée par des virgules des types de processus que Claude Code exclut du plafond de mémoire d'outil, comme mcp ou lsp. Définissez none pour limiter tous les types, ou all-new pour limiter uniquement les commandes des outils Bash, PowerShell et Monitor. Claude Code maintient les commandes des outils Bash, PowerShell et Monitor sous le plafond quel que soit ce que vous énumérez. Nécessite Claude Code v2.1.246 ou ultérieur |
CLAUDE_CODE_TOOL_MEMORY_LIMIT |
Sur Linux et WSL, définissez à une taille comme 4G pour limiter la mémoire que les commandes des outils Bash et PowerShell peuvent utiliser, et les commandes de l'outil Monitor sur v2.1.246 ou ultérieur. Écrivez la taille en chiffres simples, seuls pour un nombre d'octets ou avec un suffixe K, M, G ou T. Définissez 0 ou off pour désactiver le plafond. Une fois que le premier processus que Claude Code démarre a activé ou désactivé le plafond, une valeur modifiée prend effet la prochaine fois que vous lancez claude. Nécessite Claude Code v2.1.233 ou ultérieur |
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS |
Délai pour les dialogues que Claude Code transfère à un client distant, comme un Remote Control ou un hôte SDK, et pour le dialogue d'approbation pour un message inter-session retenu, avant que Claude Code les annule ; les invites de permission et les questions AskUserQuestion utilisent leurs propres flux et ne sont pas régis par ceci. Limite également l'invite de consentement d'utilisation des crédits Fable en milieu de session dans une session qui peut s'exécuter sans surveillance. Contrôler les messages entrants et les sessions non interactives couvrent les règles d'expiration complètes des messages retenus, y compris les cas où le délai ne s'applique pas. Remplace le paramètre dialogExpiry ; 0 ou une valeur négative désactive le délai |
CLAUDE_CODE_USE_ANTHROPIC_AWS |
Utilisez Claude Platform on AWS |
CLAUDE_CODE_USE_BEDROCK |
Utilisez Amazon Bedrock |
CLAUDE_CODE_USE_FOUNDRY |
Utilisez Microsoft Foundry |
CLAUDE_CODE_USE_MANTLE |
Utilisez le point de terminaison Amazon Bedrock Mantle |
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH |
Définissez à 1 pour découvrir les commandes personnalisées, les sous-agents et les styles de sortie en utilisant les API de fichier Node.js au lieu de ripgrep. Définissez ceci si le binaire ripgrep groupé est indisponible ou bloqué dans votre environnement. N'affecte pas les outils Grep ou de recherche de fichier |
CLAUDE_CODE_USE_POWERSHELL_TOOL |
Contrôle l'outil PowerShell. Sur Windows sans Git Bash, l'outil est activé automatiquement ; définissez à 0 pour le désactiver. Sur Windows avec Git Bash installé, l'outil est activé par défaut pour les comptes claude.ai et Console ; définissez à 1 pour l'activer dans les sessions Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, ou 0 pour le désactiver. Sur Linux, macOS et WSL, définissez à 1 pour l'activer, ce qui nécessite pwsh sur votre PATH. Lorsqu'il est activé sur Windows, Claude peut exécuter les commandes PowerShell en mode natif au lieu de les router via Git Bash. Voir Outil PowerShell |
CLAUDE_CODE_USE_VERTEX |
Utilisez Google Cloud's Agent Platform |
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS |
Définissez au nombre de millisecondes que WebFetch garde chaque réponse d'URL récupérée en cache. La valeur par défaut est 900000, ce qui est 15 minutes. Accepte uniquement les chiffres simples ; 0, une décimale ou toute autre orthographe garde la valeur par défaut. Claude Code lit la valeur une fois par lancement, afin qu'une modification dans un bloc env des paramètres s'applique lorsque vous lancez ensuite claude. Nécessite Claude Code v2.1.233 ou ultérieur |
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS |
Limite supérieure en millisecondes sur le temps qu'un agent de workflow attend la première réponse d'un frère de même préfixe avant d'envoyer sa propre première requête. Lorsqu'un fan-out démarre plusieurs agents qui partagent un préfixe de cache du prompt, Claude Code maintient tous sauf le premier agent pendant jusqu'à ce temps afin que le reste lise le préfixe en cache au lieu de chacun le traiter sans cache. Par défaut 5000. Définissez à 0 pour désactiver l'attente. Lorsque DISABLE_PROMPT_CACHING est défini, les agents n'attendent jamais. Nécessite Claude Code v2.1.229 ou ultérieur |
CLAUDE_CONFIG_DIR |
Remplacez le répertoire de configuration (par défaut : ~/.claude). Tous les paramètres, l'historique des sessions et les plugins sont stockés sous ce chemin. Pour les identifiants, voir où Claude Code stocke les identifiants. Utile pour exécuter plusieurs comptes côte à côte : par exemple, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'. Définissez-le dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignoré dans les paramètres de projet et locaux |
CLAUDE_DISABLE_ADOPT |
Définissez à 1 pour arrêter le travail d'arrière-plan en vol au lieu de le porter lorsque vous mettez une session en arrière-plan en appuyant sur ← ou avec /background. Claude Code vous demande de confirmer avant de mettre en arrière-plan, puis arrête les tâches qui seraient autrement portées. Nécessite Claude Code v2.1.195 ou ultérieur |
CLAUDE_EFFORT |
Défini automatiquement dans les sous-processus de l'outil Bash et les commandes hook au niveau d'effort en vigueur lorsque le sous-processus démarre : low, medium, high, xhigh ou max. Ultracode n'est pas un niveau distinct et signale comme xhigh. Correspond au champ effort.level transmis aux hooks. Défini uniquement lorsque le modèle actuel supporte le paramètre d'effort |
CLAUDE_ENABLE_BYTE_WATCHDOG |
Définissez à 1 pour forcer l'activation du chien de garde d'inactivité de flux au niveau des octets, ou définissez à 0 pour le forcer à désactiver. 0 désactive également le délai de premier octet sur les connexions où ce délai s'exécute. Lorsqu'il n'est pas défini, le chien de garde est activé par défaut pour les connexions API Anthropic directes et Claude Platform on AWS, et pour les réponses en continu sur les connexions de passerelle atteintes via ANTHROPIC_BASE_URL ou ANTHROPIC_AWS_BASE_URL ; avant v2.1.222, il ne s'exécutait pas sur ces connexions de passerelle, afin que le chien de garde au niveau des événements puisse signaler un blocage là même tandis que les pings de maintien de la connexion arrivaient. Pour les délais d'expiration et la façon dont les minuteries interagissent, voir Chiens de garde d'inactivité de flux en continu |
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK |
Définissez à 1 pour activer le chien de garde d'inactivité de flux au niveau des octets sur les réponses Amazon Bedrock vnd.amazon.eventstream, ce qui active également le délai de premier octet sur les requêtes en continu Bedrock. Désactivé par défaut. Configurez le délai d'expiration avec CLAUDE_STREAM_IDLE_TIMEOUT_MS |
CLAUDE_ENABLE_STREAM_WATCHDOG |
Définissez à 0 pour forcer la désactivation du chien de garde d'inactivité au niveau des événements, ou définissez à 1 pour le forcer à activer. Lorsqu'il n'est pas défini, le chien de garde est activé par défaut pour tous les fournisseurs. Avant v2.1.196, la valeur par défaut non définie était contrôlée par le serveur sur l'API Anthropic directe et désactivée sur les autres fournisseurs. Configurez le délai d'expiration avec CLAUDE_STREAM_IDLE_TIMEOUT_MS ; pour les autres minuteries de blocage qui s'exécutent aux côtés de celle-ci, voir Chiens de garde d'inactivité de flux en continu |
CLAUDE_ENV_FILE |
Chemin d'accès à un script shell dont le contenu Claude Code exécute avant chaque commande Bash dans le même processus shell, afin que les exports dans le fichier soient visibles à la commande. Utilisez pour persister l'activation virtualenv ou conda entre les commandes. Également rempli dynamiquement par les hooks SessionStart, Setup, CwdChanged et FileChanged |
CLAUDE_PID |
Claude Code définit ceci à son propre ID de processus dans les sous-processus qu'il génère : commandes d'outil Bash et PowerShell et commandes hook. Sur Linux, l'intégration shell de l'outil Bash l'utilise pour refuser un modèle pkill qui correspondrait au processus Claude Code lui-même ; voir la référence d'erreur. Lisez-le à partir de vos propres scripts pour identifier ou signaler délibérément le processus Claude Code parent. Nécessite Claude Code v2.1.214 ou ultérieur |
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX |
Préfixe pour les noms de session Remote Control générés automatiquement lorsqu'aucun nom explicite n'est fourni. Par défaut le nom d'hôte de votre machine, produisant des noms comme myhost-graceful-unicorn. Le drapeau CLI --remote-control-session-name-prefix définit la même valeur pour une seule invocation |
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS |
Délai pour le premier octet de réponse d'une requête en continu, sur les connexions où le délai de premier octet s'exécute. Pour la façon dont Claude Code le serre, le temps supplémentaire qu'il ajoute pour les corps de requête volumineux et la façon dont il choisit le délai lorsque vous le laissez non défini, voir Pas de réponse de l'API. Nécessite Claude Code v2.1.242 ou ultérieur |
CLAUDE_STREAM_IDLE_TIMEOUT_MS |
Délai d'expiration en millisecondes avant que les chiens de garde d'inactivité de flux au niveau des événements et des octets ferment une connexion bloquée. Lorsque vous définissez cette variable explicitement, le minimum est 300000 (5 minutes) ; les valeurs inférieures sont silencieusement serrées pour absorber les pauses de réflexion étendue et la mise en mémoire tampon du proxy, et le chien de garde au niveau des octets limite la valeur à 30 minutes. CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS a la priorité sur cette variable pour le chien de garde au niveau des octets. Pour les valeurs par défaut non définies par chien de garde, voir Chiens de garde d'inactivité de flux en continu |
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS |
Durée de vie maximale en millisecondes pour une commande shell d'arrière-plan qu'un sous-agent a démarrée. Par défaut 3600000 (60 minutes). Lorsque vous définissez 0, Claude Code applique la valeur par défaut au lieu de supprimer le plafond. Lorsque le sous-agent s'exécute en avant-plan, Claude Code termine également la commande lorsque ce sous-agent donne sa réponse finale, quel que soit ce plafond. Voir les règles de durée de vie de la commande d'arrière-plan. Claude Code ne limite pas les commandes d'arrière-plan de la session principale de cette façon. Pour la limite de pression mémoire qui les couvre, voir Comment fonctionne la mise en arrière-plan |
DEBUG |
Définissez à 1 pour activer le mode débogage, équivalent à lancer avec --debug. Les journaux de débogage sont écrits dans ~/.claude/debug/<session-id>.txt, ou dans le chemin défini par CLAUDE_CODE_DEBUG_LOGS_DIR. Seules les valeurs truthy 1, true, yes et on activent le mode débogage, afin que les modèles d'espace de noms comme DEBUG=express:* définis pour d'autres outils ne le déclenchent pas |
DISABLE_AUTOUPDATER |
Définissez à 1 pour désactiver les mises à jour automatiques d'arrière-plan. Le claude update manuel fonctionne toujours. Utilisez DISABLE_UPDATES pour bloquer les deux |
DISABLE_AUTO_COMPACT |
Définissez à 1 pour désactiver la compaction automatique lorsque vous approchez de la limite de contexte. La commande /compact manuelle reste disponible. Utilisez lorsque vous souhaitez un contrôle explicite sur le moment où la compaction se produit. Remplace le paramètre autoCompactEnabled |
DISABLE_COMPACT |
Définissez à 1 pour désactiver toute la compaction : à la fois la compaction automatique et la commande /compact manuelle |
DISABLE_COST_WARNINGS |
Définissez à 1 pour désactiver les messages d'avertissement de coût |
DISABLE_DOCTOR_COMMAND |
Définissez à 1 pour masquer la compétence de vérification /doctor et son alias /checkup. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter les diagnostics de configuration à partir d'une session. N'affecte pas la commande du terminal claude doctor. Avant v2.1.205, cette variable masquait l'écran de diagnostics /doctor |
DISABLE_ERROR_REPORTING |
Définissez à n'importe quelle valeur non vide, comme 1, pour refuser les rapports d'erreurs. Définir à 0 ou false refuse toujours, contrairement à la plupart des variables activées/désactivées ; supprimez la variable pour réactiver les rapports d'erreurs |
DISABLE_EXTRA_USAGE_COMMAND |
Définissez à 1 pour masquer la commande /usage-credits qui permet aux utilisateurs d'acheter une utilisation supplémentaire au-delà des limites de taux |
DISABLE_FEEDBACK_COMMAND |
Définissez à 1 pour désactiver la commande /feedback et les retours d'information rédigés par Claude. Désactive également /bug et /share, qui signalent via le même chemin ; avant v2.1.212, c'étaient des alias de /feedback, afin que la commande soit désactivée sous chaque nom. Le nom plus ancien DISABLE_BUG_COMMAND est également accepté |
DISABLE_GROWTHBOOK |
Définissez à 1 ou true pour désactiver la récupération des drapeaux de fonctionnalité GrowthBook et utiliser les valeurs par défaut du code pour chaque drapeau. Cela rend Remote Control et les autres fonctionnalités qui nécessitent la récupération des drapeaux de fonctionnalité indisponibles. Définir à 0 ou false laisse la récupération activée. La journalisation des événements de télémétrie reste activée sauf si DISABLE_TELEMETRY est également défini |
DISABLE_INSTALLATION_CHECKS |
Définissez à 1 pour désactiver les avertissements d'installation. Utilisez uniquement lorsque vous gérez manuellement l'emplacement d'installation, car cela peut masquer les problèmes avec les installations standard |
DISABLE_INSTALL_GITHUB_APP_COMMAND |
Définissez à 1 pour masquer la commande /install-github-app. Déjà masquée lors de l'utilisation de fournisseurs tiers (Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry) |
DISABLE_INTERLEAVED_THINKING |
Définissez à 1 pour empêcher l'envoi de l'en-tête bêta de réflexion entrelacée. Utile lorsque votre passerelle LLM ou fournisseur ne supporte pas la réflexion entrelacée |
DISABLE_LOGIN_COMMAND |
Définissez à 1 pour masquer la commande /login. Utile lorsque l'authentification est gérée en externe via des clés API ou apiKeyHelper |
DISABLE_LOGOUT_COMMAND |
Définissez à 1 pour masquer la commande /logout |
DISABLE_PROMPT_CACHING |
Définissez à 1 pour désactiver la mise en cache du prompt pour tous les modèles (a la priorité sur les paramètres par modèle) |
DISABLE_PROMPT_CACHING_FABLE |
Définissez à 1 pour désactiver la mise en cache du prompt pour les modèles Fable |
DISABLE_PROMPT_CACHING_HAIKU |
Définissez à 1 pour désactiver la mise en cache du prompt pour les modèles Haiku |
DISABLE_PROMPT_CACHING_OPUS |
Définissez à 1 pour désactiver la mise en cache du prompt pour les modèles Opus |
DISABLE_PROMPT_CACHING_SONNET |
Définissez à 1 pour désactiver la mise en cache du prompt pour les modèles Sonnet |
DISABLE_TELEMETRY |
Définissez à n'importe quelle valeur non vide, comme 1, pour refuser la télémétrie. Définir à 0 ou false refuse toujours, contrairement à la plupart des variables activées/désactivées ; supprimez la variable pour réactiver la télémétrie. Les événements de télémétrie n'incluent pas les données utilisateur comme le code, les chemins de fichier ou les commandes bash. Désactive également la récupération des drapeaux de fonctionnalité avec le même effet que DISABLE_GROWTHBOOK, ce qui rend Remote Control et les autres fonctionnalités qui nécessitent la récupération des drapeaux de fonctionnalité indisponibles. Voir Désactiver la télémétrie pour votre organisation |
DISABLE_UPDATES |
Définissez à 1 pour bloquer toutes les mises à jour, y compris le claude update manuel et claude install. Plus strict que DISABLE_AUTOUPDATER. Utilisez lorsque vous distribuez Claude Code via vos propres canaux et que les utilisateurs ne doivent pas se mettre à jour eux-mêmes |
DISABLE_UPGRADE_COMMAND |
Définissez à 1 pour masquer la commande /upgrade |
DO_NOT_TRACK |
Définissez à 1 pour refuser la télémétrie, avec le même effet que DISABLE_TELEMETRY, y compris rendre Remote Control et les autres fonctionnalités qui nécessitent la récupération des drapeaux de fonctionnalité indisponibles. Claude Code lit cette variable en tant que booléen standard, afin que 0 laisse la télémétrie activée, et l'honore en tant que convention inter-outils reconnue par de nombreux CLI de développeur |
ENABLE_BETA_TRACING_DETAILED |
Définissez à 1, avec BETA_TRACING_ENDPOINT, pour activer le traçage bêta détaillé, qui ajoute des attributs porteurs de contenu et la span claude_code.hook. Les sessions CLI interactives nécessitent également que votre organisation soit sur la liste blanche pour la bêta. Les deux variables sont ignorées dans les paramètres de projet et locaux |
ENABLE_CLAUDEAI_MCP_SERVERS |
Définissez à false pour empêcher Claude Code de récupérer les serveurs MCP claude.ai. Activé par défaut pour les utilisateurs connectés. Pour désactiver par projet ou par organisation, définissez disableClaudeAiConnectors dans les paramètres à la place |
ENABLE_PROMPT_CACHING_1H |
Définissez à 1 pour demander une TTL du cache du prompt d'une heure au lieu des 5 minutes par défaut. Destiné aux utilisateurs de clé API, Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et Claude Platform on AWS. Les utilisateurs d'abonnement dans l'utilisation incluse reçoivent automatiquement la TTL d'une heure sur la conversation principale. Les utilisateurs d'abonnement tirant sur les crédits d'utilisation peuvent le définir pour garder la TTL d'une heure. Les écritures du cache d'une heure sont facturées à un taux plus élevé. Pour choisir la TTL par bucket de requête à la place, utilisez CLAUDE_CODE_PROMPT_CACHE_TTL et CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, qui ont la priorité sur cette variable |
ENABLE_PROMPT_CACHING_1H_BEDROCK |
Déprécié. Utilisez ENABLE_PROMPT_CACHING_1H à la place |
ENABLE_TOOL_SEARCH |
Contrôle la recherche d'outils MCP. Non défini, Claude Code reporte tous les outils MCP par défaut. Il les charge toujours en amont sur les modèles Google Cloud's Agent Platform antérieurs à la génération Claude 4.5, sur un déploiement Microsoft Foundry hébergé sur Azure et lorsque ANTHROPIC_BASE_URL pointe vers un hôte non-tiers. true reporte toujours et envoie l'en-tête bêta, sauf sur ces mêmes modèles Agent Platform et déploiements Microsoft Foundry ; les requêtes échouent sur les proxies qui ne supportent pas tool_reference. auto charge en amont lorsque les définitions d'outils s'ajustent dans 10 % du contexte. auto:N définit un seuil personnalisé, comme auto:5 pour 5 %. false charge tous les outils en amont. Une valeur que vous définissez vous-même est ignorée lorsque CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS est défini. Avant v2.1.221, Claude Code désactivait la recherche d'outils pour tous les modèles sur Google Cloud's Agent Platform sauf si vous définissiez cette variable à true |
FALLBACK_FOR_ALL_PRIMARY_MODELS |
Définissez à n'importe quelle valeur non vide, comme 1, pour faire arrêter chaque modèle de réessayer avec une erreur de surcharge répétée lorsqu'aucun modèle de secours n'est configuré. Définir à 0 ou false active toujours ceci, contrairement à la plupart des variables activées/désactivées ; supprimez la variable pour restaurer le comportement de nouvelle tentative par défaut. Sans ceci, les modèles que Claude Code reconnaît comme des modèles Opus, Fable ou Mythos arrêtent de réessayer de cette façon lorsque vous vous authentifiez avec une clé API ou un fournisseur tiers plutôt qu'un abonnement Claude. À partir de v2.1.160, une chaîne de modèle de secours configurée se déclenche sur les erreurs de surcharge répétée pour n'importe quel modèle principal, afin que cette variable n'affecte pas le changement vers un modèle de secours |
FORCE_AUTOUPDATE_PLUGINS |
Définissez à 1 pour forcer les mises à jour automatiques des plugins même lorsque le mise à jour automatique principale est désactivée via DISABLE_AUTOUPDATER |
FORCE_HYPERLINK |
Définissez à 1 pour activer les hyperliens OSC 8 cliquables lorsque votre terminal les supporte mais n'est pas détecté automatiquement, ou 0 pour les désactiver. Lorsqu'il n'est pas défini, Claude Code active les hyperliens uniquement lorsqu'il détecte le support du terminal. Claude Code analyse cette valeur en tant que nombre, pas un booléen, afin qu'une valeur comme false, no ou off active les hyperliens plutôt que de les désactiver. Claude Code affiche le badge PR ou merge request du pied de page en tant qu'hyperlien même lorsqu'il ne peut pas détecter le support du terminal, comme sur SSH. Définissez 0 pour afficher le badge en tant que texte simple |
FORCE_PROMPT_CACHING_5M |
Définissez à 1 pour forcer la TTL du cache du prompt de 5 minutes même lorsque la TTL d'une heure s'appliquerait autrement. Remplace CLAUDE_CODE_PROMPT_CACHE_TTL, CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, ENABLE_PROMPT_CACHING_1H et les paramètres promptCacheTtl et subagentPromptCacheTtl |
HTTP_PROXY |
Spécifiez le serveur proxy HTTP pour les connexions réseau |
HTTPS_PROXY |
Spécifiez le serveur proxy HTTPS pour les connexions réseau |
IS_DEMO |
Définissez à n'importe quelle valeur non vide, comme 1, pour activer le mode démo : masque votre e-mail et le nom de votre organisation à partir de l'en-tête et de la sortie /status, et ignore l'intégration. Définir à 0 ou false active toujours le mode démo, contrairement à la plupart des variables activées/désactivées ; supprimez la variable pour le désactiver. Utile lors de la diffusion en continu ou de l'enregistrement d'une session |
MAX_MCP_OUTPUT_TOKENS |
Nombre maximum de jetons autorisés dans les réponses des outils MCP. Claude Code affiche un avertissement lorsque la sortie dépasse 10 000 jetons. Les outils qui déclarent anthropic/maxResultSizeChars utilisent cette limite de caractères pour le contenu textuel à la place, mais le contenu d'image de ces outils est toujours soumis à cette variable (par défaut : 25000) |
MAX_STRUCTURED_OUTPUT_RETRIES |
Nombre de fois que Claude Code réessaye lorsque la réponse du modèle échoue la validation par rapport au --json-schema en mode non interactif avec le drapeau -p. Le même nombre de tentatives s'applique lorsque la sortie structurée d'un sous-agent de workflow échoue la validation. Par défaut 5 |
MAX_THINKING_TOKENS |
Budget de jetons fixe pour la réflexion étendue. Claude Code le limite à un jeton en dessous des jetons de sortie maximale de la requête et jamais en dessous de 1 024 ; voir CLAUDE_CODE_MAX_OUTPUT_TOKENS pour la façon dont cette limite est définie. Lorsqu'il n'est pas défini et que la réflexion est activée, les modèles avec raisonnement adaptatif choisissent leur propre profondeur de réflexion, et les autres modèles utilisent le plafond. Définissez à 0 pour désactiver la réflexion sur l'API Anthropic, sauf sur les modèles Fable, qui ne peuvent pas avoir la réflexion désactivée ; sur les fournisseurs tiers, 0 omet le paramètre thinking à la place. Avec la réflexion désactivée sur l'API Anthropic, Claude Code envoie l'effort high au lieu d'un niveau plus élevé aux modèles qu'il sait n'acceptent pas cette combinaison, comme Opus 5. Les valeurs non nulles sont ignorées sur les modèles de raisonnement adaptatif sauf si CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING est défini |
MCP_CLIENT_SECRET |
Secret client OAuth pour les serveurs MCP qui nécessitent des identifiants pré-configurés. Évite l'invite interactive lors de l'ajout d'un serveur avec --client-secret |
MCP_CONNECTION_NONBLOCKING |
Contrôle si le démarrage attend que les serveurs MCP se connectent avant la première requête. Le démarrage MCP est non-bloquant par défaut : les serveurs se connectent en arrière-plan et leurs outils deviennent disponibles au fur et à mesure qu'ils se terminent. Définissez à 0 pour faire attendre Claude Code que les serveurs se connectent avant la première requête. Les serveurs configurés avec alwaysLoad: true font toujours attendre le démarrage quel que soit ceci, sauf lorsqu'ils sont servis à partir du cache de découverte, car leurs outils doivent être présents lorsque le premier prompt est construit. En mode non interactif (-p), Claude Code attend également les serveurs toujours en attente avant le premier tour quel que soit cette variable, avec un délai plus long lorsque vous transmettez --mcp-config explicitement ; voir l'entrée de ce drapeau pour l'exception du serveur en cache |
MCP_CONNECT_TIMEOUT_MS |
Combien de temps le démarrage MCP bloquant attend, en millisecondes, pour le lot de connexion avant de prendre un instantané de la liste d'outils (par défaut : 5000). S'applique lorsque MCP_CONNECTION_NONBLOCKING=0 ou pour les serveurs marqués alwaysLoad: true. Les serveurs toujours en attente au délai continuent de se connecter en arrière-plan. Distinct de MCP_TIMEOUT, qui limite la tentative de connexion d'un serveur individuel |
MCP_DISCOVERY_CACHE |
Active ou désactive le cache de découverte MCP. Avec le cache activé, un serveur HTTP ou SSE distant que vous avez utilisé auparavant peut afficher le statut cached, et Claude Code le connecte au premier appel d'outil au lieu du démarrage. Le cache est désactivé par défaut sauf si un déploiement progressif l'a activé pour votre compte. Définissez à 1 pour l'activer, ou 0 pour le garder désactivé même lorsque le déploiement l'a activé. Avant v2.1.238, le cache était activé par défaut. Le statut cached nécessite Claude Code v2.1.221 ou ultérieur |
MCP_DISCOVERY_CACHE_MAX_STALE_S |
Âge maximum, en secondes, d'une entrée du cache de découverte (par défaut : 14400, ou 4 heures). À un démarrage où l'entrée est plus ancienne que cela, Claude Code la rejette et connecte le serveur au démarrage, comme il le fait avec le cache désactivé. Claude Code limite la valeur à 7 jours. Avant v2.1.238, la valeur par défaut était 86400, ou 24 heures, et Claude Code ne limitait pas la valeur |
MCP_DISCOVERY_CACHE_STRIKES |
À un démarrage où une entrée du cache de découverte est plus ancienne que MCP_DISCOVERY_CACHE_TTL_S, Claude Code l'actualise en arrière-plan. Cette variable définit combien d'actualisations consécutives peuvent échouer avant que Claude Code rejette l'entrée et connecte le serveur au prochain démarrage à la place (par défaut : 1). Augmentez-la si votre connexion réseau s'interrompt occasionnellement, afin qu'une actualisation échouée ne rejette pas l'entrée. Nécessite Claude Code v2.1.238 ou ultérieur |
MCP_DISCOVERY_CACHE_TTL_S |
Secondes pendant lesquelles Claude Code utilise une entrée du cache de découverte sans l'actualiser (par défaut : 900). À un démarrage où l'entrée est plus ancienne que cela, Claude Code l'utilise toujours mais l'actualise en arrière-plan. Une fois que l'entrée est plus ancienne que MCP_DISCOVERY_CACHE_MAX_STALE_S, Claude Code la rejette à la place. Claude Code limite la valeur à MCP_DISCOVERY_CACHE_MAX_STALE_S, qui est 4 heures par défaut. Avant v2.1.238, Claude Code ne limitait pas la valeur |
MCP_OAUTH_CALLBACK_PORT |
Port fixe pour le rappel de redirection OAuth, comme alternative à --callback-port lors de l'ajout d'un serveur MCP avec des identifiants pré-configurés |
MCP_PROTOCOL_NEGOTIATION |
Sur le runtime client MCP v2 uniquement, si Claude Code sonde les serveurs pour la révision du protocole MCP 2026-07-28. Définissez auto pour sonder les serveurs HTTP, connecteur claude.ai et stdio ; un serveur qui ne répond pas à la sonde se connecte sur le protocole antérieur à la place, comme les serveurs SSE et WebSocket le font toujours. Définissez legacy pour ignorer la sonde pour chaque serveur. Sans la variable, Claude Code sonde les serveurs HTTP et connecteur claude.ai sur Claude Code v2.1.232 ou ultérieur, avec les exceptions que la section Runtimes client MCP énumère. Toute autre valeur est ignorée avec un avertissement dans le journal de débogage. Nécessite Claude Code v2.1.221 ou ultérieur |
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE |
Nombre maximum de serveurs MCP distants (HTTP/SSE) à connecter en parallèle pendant le démarrage (par défaut : 20) |
MCP_SDK_GENERATION |
Épinglez quel runtime client MCP ce processus se connecte aux serveurs MCP avec : v1, construit sur MCP TypeScript SDK 1.x, ou v2, construit sur MCP TypeScript SDK 2.0. Sans la variable, Claude Code utilise v2 sur Claude Code v2.1.232 ou ultérieur, sauf où cette section dit qu'il utilise v1. Sur Claude Code v2.1.221 ou ultérieur, le runtime v2 vérifie l'émetteur qu'un serveur OAuth MCP retourne dans sa réponse d'autorisation et échoue la connexion avec une erreur qui commence par Issuer mismatch in authorization response lorsqu'il ne correspond pas. Le runtime v1 n'exécute pas cette vérification. Si vous définissez une valeur non reconnue, Claude Code l'ignore et écrit un avertissement dans le journal de débogage. Claude Code lit la valeur une fois par processus. Nécessite Claude Code v2.1.218 ou ultérieur |
MCP_SERVER_CONNECTION_BATCH_SIZE |
Nombre maximum de serveurs MCP locaux (stdio) à connecter en parallèle pendant le démarrage (par défaut : 3) |
MCP_TIMEOUT |
Délai d'expiration en millisecondes pour le démarrage du serveur MCP (par défaut : 30000, ou 30 secondes) |
MCP_TOOL_TIMEOUT |
Délai d'expiration en millisecondes pour l'exécution de l'outil MCP (par défaut : 100000000, environ 28 heures). Pour un serveur HTTP, SSE ou connecteur claude.ai, chaque requête expire également après 60 secondes par défaut ; définissez cette variable, ou le timeout par serveur, au-dessus de 60000 pour augmenter cette limite par requête. Une valeur inférieure raccourcit toujours le délai d'expiration global d'exécution d'outil mais laisse la limite par requête à 60 secondes. Les serveurs stdio et WebSocket n'ont pas de minuteur par requête. Un champ timeout par serveur dans .mcp.json remplace ceci pour ce serveur. Un timeout par serveur d'au moins 1000 définit également la fenêtre d'inactivité minimale pour les appels d'outils de ce serveur, afin que CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT ne les interrompe jamais plus tôt ; ce plancher nécessite Claude Code v2.1.203 ou ultérieur. Pour la variable env, les valeurs inférieures à 1000 sont limitées à une seconde ; pour le champ par serveur, les valeurs inférieures à 1000 sont ignorées |
NO_PROXY |
Liste des domaines et adresses IP auxquels les requêtes seront émises directement, en contournant le proxy |
OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT |
Limite standard du SDK OpenTelemetry sur la longueur de la valeur d'attribut. Claude Code limite les attributs de télémétrie porteurs de contenu au plus petit de ceci et CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH, afin que le marqueur de troncature reste dans la limite du SDK. Claude Code lit les variantes OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT et OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT de la même manière, et la plus petite valeur définie s'applique à tous les signaux. Nécessite Claude Code v2.1.214 ou ultérieur. Voir Surveillance |
OTEL_LOG_ASSISTANT_RESPONSES |
Définissez à 1 pour inclure le texte de réponse du modèle sur les événements de journal OpenTelemetry assistant_response. Lorsqu'il n'est pas défini, la valeur de OTEL_LOG_USER_PROMPTS est utilisée à la place. Définissez à 0 pour garder les réponses rédactées même lorsque OTEL_LOG_USER_PROMPTS est défini. Nécessite Claude Code v2.1.193 ou ultérieur. Voir Surveillance |
OTEL_LOG_RAW_API_BODIES |
Émettez les corps JSON de requête et de réponse de l'API Anthropic Messages en tant qu'événements de journal api_request_body / api_response_body. Définissez à 1 pour les corps en ligne tronqués à la limite de contenu, ou file:<dir> pour écrire les corps non tronqués sur le disque et émettre un chemin body_ref à la place. CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH configure la limite de contenu, 60 Ko par défaut. Désactivé par défaut ; les corps incluent l'historique de conversation entier. Définissez-le dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignoré dans les paramètres de projet et locaux. Voir Surveillance |
OTEL_LOG_TOOL_CONTENT |
Définissez à 1 pour inclure le contenu d'entrée et de sortie d'outil dans les événements de span OpenTelemetry. Désactivé par défaut pour protéger les données sensibles. Voir Surveillance |
OTEL_LOG_TOOL_DETAILS |
Définissez à 1 pour inclure les arguments d'entrée d'outil, les noms de serveur MCP, les noms de workflow rédigés par l'utilisateur, les chaînes d'erreur brutes sur les défaillances d'outil, la category de refus sur les événements api_refusal et d'autres détails d'outil dans les traces et journaux OpenTelemetry. Désactivé par défaut pour protéger les informations personnelles identifiables. Voir Surveillance |
OTEL_LOG_USER_PROMPTS |
Définissez à 1 pour inclure le texte du prompt utilisateur dans les traces et journaux OpenTelemetry. Désactivé par défaut (les prompts sont rédactés). Voir Surveillance |
OTEL_METRICS_INCLUDE_ACCOUNT_UUID |
Définissez à false pour exclure l'UUID du compte des attributs de métriques (par défaut : inclus). Voir Surveillance |
OTEL_METRICS_INCLUDE_ENTRYPOINT |
Définissez à true pour inclure le point d'entrée de la session dans les attributs de métriques (par défaut : exclu). Ajouté dans v2.1.152. Voir Surveillance |
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES |
À partir de v2.1.161, Claude Code attache les clés OTEL_RESOURCE_ATTRIBUTES aux étiquettes de point de données de métrique. Définissez à false pour les exclure (par défaut : inclus). Voir Surveillance |
OTEL_METRICS_INCLUDE_SESSION_ID |
Définissez à false pour exclure l'ID de session des attributs de métriques (par défaut : inclus). Voir Surveillance |
OTEL_METRICS_INCLUDE_VERSION |
Définissez à true pour inclure la version de Claude Code dans les attributs de métriques (par défaut : exclu). Voir Surveillance |
SLASH_COMMAND_TOOL_CHAR_BUDGET |
Remplacez le budget de caractères pour les métadonnées de compétence affichées à l'outil Skill. Le budget s'adapte dynamiquement à 1 % de la fenêtre de contexte, avec un secours de 8 000 caractères. Nom hérité conservé pour la compatibilité rétroactive |
TASK_MAX_OUTPUT_LENGTH |
Nombre maximum de caractères de sortie d'une tâche d'arrière-plan que l'outil TaskOutput garde (par défaut : 32000 ; maximum : 160000). Si vous définissez le paramètre taskOutputMaxChars, Claude Code ignore cette variable |
USE_BUILTIN_RIPGREP |
Définissez à 0 pour utiliser le rg installé sur le système au lieu du rg inclus avec Claude Code |
VERTEX_REGION_CLAUDE_3_5_HAIKU |
Remplacez la région pour Claude 3.5 Haiku lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_3_5_SONNET |
Remplacez la région pour Claude 3.5 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_3_7_SONNET |
Remplacez la région pour Claude 3.7 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_0_OPUS |
Remplacez la région pour Claude 4.0 Opus lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_0_SONNET |
Remplacez la région pour Claude 4.0 Sonnet lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_1_OPUS |
Remplacez la région pour Claude 4.1 Opus lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_5_OPUS |
Remplacez la région pour Claude Opus 4.5 lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_5_SONNET |
Remplacez la région pour Claude Sonnet 4.5 lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_6_OPUS |
Remplacez la région pour Claude Opus 4.6 lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_6_SONNET |
Remplacez la région pour Claude Sonnet 4.6 lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_7_OPUS |
Remplacez la région pour Claude Opus 4.7 lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_4_8_OPUS |
Remplacez la région pour Claude Opus 4.8 lors de l'utilisation de Google Cloud's Agent Platform |
VERTEX_REGION_CLAUDE_5_OPUS |
Remplacez la région pour Claude Opus 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajouté dans v2.1.219 |
VERTEX_REGION_CLAUDE_5_SONNET |
Remplacez la région pour Claude Sonnet 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajouté dans v2.1.197 |
VERTEX_REGION_CLAUDE_FABLE_5 |
Remplacez la région pour Claude Fable 5 lors de l'utilisation de Google Cloud's Agent Platform. Ajouté dans v2.1.170 |
VERTEX_REGION_CLAUDE_FABLE_5_1 |
Remplacez la région pour Claude Fable 5.1 lors de l'utilisation de Google Cloud's Agent Platform. Ajouté dans v2.1.255 |
VERTEX_REGION_CLAUDE_HAIKU_4_5 |
Remplacez la région pour Claude Haiku 4.5 lors de l'utilisation de Google Cloud's Agent Platform |
Les variables d'exportateur OpenTelemetry standard (OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES et les variantes spécifiques au signal) sont également supportées. Voir Surveillance pour les détails de configuration.
Fonctionnalités nécessitant la récupération de feature flags
Claude Code active certaines fonctionnalités via des feature flags qu'il récupère auprès d'Anthropic. Claude Code ignore cette récupération dans ces sessions :
- Une session où vous définissez
DISABLE_GROWTHBOOK,DISABLE_TELEMETRY,DO_NOT_TRACK, ouCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC; la ligne de chaque variable dans le tableau des variables indique quelles valeurs désactivent la récupération - Une session sur un fournisseur tiers, tel qu'Amazon Bedrock, Claude Platform sur AWS, Agent Platform de Google Cloud, ou Microsoft Foundry, sauf si une plateforme hôte qui intègre Claude Code définit
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST - Une session de passerelle d'applications Claude
Avec la récupération désactivée, vous ne pouvez pas :
- Démarrer les sessions en mode auto par défaut sur les plans Pro, Max et Team
- Faire en sorte que l'extension VS Code lise les fichiers de paramètres pour le mode de permission de démarrage
- Exécuter
/auto-mode-setuppour rédiger les entréesautoMode.environment - Utiliser Remote Control
- Envoyer des messages aux sessions au-delà de cette machine ; la messagerie entre les sessions sur cette machine fonctionne avec la récupération désactivée
- Exécuter
claude importou la commande/import - Exécuter
/skill-doctorou ouvrir son rapport dans l'onglet Stats de/plugin - Utiliser l'outil advisor
- Lire ou répondre aux commentaires sur un artifact
- Obtenir le runtime client MCP v2 et sa sonde de protocole sans définir
MCP_SDK_GENERATIONetMCP_PROTOCOL_NEGOTIATION; Claude Code utilise le runtime v1 sauf si vous définissezMCP_SDK_GENERATION=v2, et ignore la sonde sauf si vous définissezMCP_PROTOCOL_NEGOTIATION=auto - Obtenir l'outil PowerShell par défaut pour les comptes claude.ai et Console sur Windows avec Git Bash installé ; Claude Code achemine les commandes shell via Git Bash sauf si vous définissez
CLAUDE_CODE_USE_POWERSHELL_TOOL=1. Sur Windows sans Git Bash, l'outil reste activé - Obtenir les retours rédigés par Claude, que Claude Code active via un flag récupéré
- Faire en sorte que Claude Code exclue les outils MCP dont le schéma d'entrée serait rejeté par l'API ; il envoie le schéma de toute façon, et une requête qui l'inclut échoue avec une erreur 400 nommant l'outil par sa position
Première session après une installation ou une mise à jour
Lors de votre première session après l'installation de Claude Code, ou la mise à jour vers une version qui ajoute une fonctionnalité, une fonctionnalité contrôlée par flag peut être manquante, et la session peut démarrer en mode Manuel sur un plan qui démarre autrement en mode auto. Claude Code récupère les flags lors de cette session, donc les deux sont présents dans votre session suivante.
Après une installation propre, dans une session non-interactive telle que claude -p, le SDK Agent, ou l'extension VS Code, Claude Code peut toujours récupérer les flags avant de choisir le mode de permission de démarrage.
Voir aussi
- Paramètres : tous les paramètres de configuration
settings.json, y compris la cléenv - Référence CLI : drapeaux de lancement
- Configuration réseau : configuration du proxy et TLS
- Surveillance : configuration OpenTelemetry