SpyBara
Go Premium

env-vars.md 2026-09-17 05:00 UTC to 2026-09-18 23:58 UTC

This page contains 275 additions and 266 deletions.

2026
Wed 9 22:58 Mon 14 22:58 Fri 18 23:58 Sat 19 23:57 Tue 22 23:59 Wed 23 23:57 Thu 24 22:57 Fri 25 23:58

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

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.

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

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.

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 de l'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 prend 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'il est défini sur un hôte non-first-party, 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 à la place 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 une 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 ou 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 à la 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 le mode Plan 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 le mode Plan 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 sont classés au-dessus de 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. Prend la priorité sur ANTHROPIC_FOUNDRY_API_KEY et sur la chaîne d'authentification 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 d'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 de 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 auquel les requêtes de Google Cloud's Agent Platform sont adressées. Voir Configurer les identifiants GCP
ANTHROPIC_WORKSPACE_ID ID d'espace de travail pour la fédération d'identité de charge de travail. 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 sur 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 du minuteur sous-jacent 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 de 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à-bas 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 sur 1 pour forcer claude --cloud à regrouper et télécharger votre référentiel local au lieu de le cloner à partir de son distant
CLAUDECODE Définissez sur 1 dans les sous-processus que Claude Code génère (outils Bash et PowerShell, sessions tmux, commandes hook, commandes ligne d'état, sous-processus du 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 la continuation automatique le compte à rebours à l'écran apparaît sur un dialogue AskUserQuestion sans réponse. Par défaut 20000 (20 secondes), limité au délai d'expiration de la continuation automatique. N'a aucun effet à moins que la continuation automatique soit activée ; 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. La continuation automatique est désactivée par défaut ; activez-la avec le paramètre askUserQuestionTimeout. Cette variable est un remplacement pour les démos et les tests automatisés : lorsqu'elle est définie, elle prend la priorité sur ce paramètre et active la continuation automatique même lorsque le paramètre n'est pas défini ou 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, la continuation automatique était activée 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 sur 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 sur 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 stagnation 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 Gérer les réponses API lentes ou bloquées le décrit. Le minuteur 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 la stagnation 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 sur 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 sur 1 pour rendre la sortie conviviale pour les lecteurs d'écran : texte plat sans bordures décoratives ni animations. Définissez sur 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 rendre 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 prend 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 sur 1 pour garder le curseur du terminal natif visible et désactiver l'indicateur de curseur en texte inversé. Permet aux agrandisseurs d'écran comme macOS Zoom de suivre la position du curseur
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD Définissez sur 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 sur 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 sur 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 sur 0 pour empêcher Claude Code d'ouvrir automatiquement le navigateur lorsqu'un nouvel artefact est publié
CLAUDE_CODE_ARTIFACT_COMMENTS Définissez sur 0 pour arrêter la lecture et la réponse de Claude aux commentaires sur un artefact. N'a aucun effet lorsque CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC a désactivé les artefacts. Nécessite Claude Code v2.1.221 ou ultérieur
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT Définissez sur 0 pour arrêter Claude de répondre d'elle-même aux commentaires qui lui sont envoyés. Nécessite Claude Code v2.1.228 ou ultérieur
CLAUDE_CODE_ATTRIBUTION_HEADER Définissez sur 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 affectée de toute façon. Dans certaines configurations de connexion directe, Claude Code garde le bloc en mode auto pour les requêtes du classificateur 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 sur 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éfinie. 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. Prend la priorité sur la commande /autocompact, le drapeau --autocompact et le paramètre autoCompactWindow. Le used_percentage de la ligne d'état 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 pris en charge. Définissez sur false pour empêcher cela. Définissez sur true pour forcer une tentative de connexion lorsque la détection automatique échoue, par exemple lorsque tmux obscurcit le terminal parent. Prend la priorité sur le paramètre de configuration global autoConnectIde
CLAUDE_CODE_AUTO_MODE_SERVER Sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, définissez sur 1 pour que le classificateur côté serveur de la plateforme examine les actions du mode auto ; où la plateforme n'exécute pas le classificateur, Claude Code revient à ses propres requêtes de classificateur. Lorsqu'il n'est pas défini ou 0, le classificateur s'exécute via les requêtes que Claude Code lui-même envoie. N'a aucun effet sur les autres fournisseurs, y compris l'API Anthropic. Nécessite Claude Code v2.1.271 ou ultérieur
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS Temps en millisecondes que Claude Code attend que le 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_BASH_EDIT_DIFF Définissez sur 0 pour désactiver le diff des fichiers qu'une commande Bash a modifiés, ou 1 pour l'enregistrer dans chaque mode de permission. Prend la priorité sur le paramètre bashEditDiffEnabled. Nécessite Claude Code v2.1.269 ou ultérieur
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING Définissez sur 0 pour faire en sorte qu'une session non interactive signale un statut inactif à son hôte à chaque fin de tour, même si le travail d'arrière-plan est toujours en cours. Par défaut, la session continue de signaler un statut en cours au-delà de la fin du tour tandis que le travail d'arrière-plan, comme un agent d'arrière-plan ou une exécution de flux de travail, est toujours actif. Cela empêche un hôte qui surveille le statut, comme une liste de sessions distantes, d'annoncer que Claude attend votre entrée au milieu du travail. Les commandes shell d'arrière-plan, comme un serveur de développement, ne maintiennent pas le statut en cours. La valeur par défaut en cours et l'opt-out 0 nécessitent Claude Code v2.1.269 ou ultérieur ; sur les versions antérieures, définissez 1 pour maintenir le statut en cours
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 sur 0 pour faire en sorte que Claude Code lise l'octet 0x08, également écrit ^H, comme Backspace simple, ou 1 pour le lire comme Ctrl+Backspace. L'une ou l'autre 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 des sources de certificats CA pour les connexions TLS. bundled est l'ensemble Mozilla CA fourni 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 sur 1 dans les sous-processus que Claude Code génère via les outils Bash, PowerShell et Monitor, les commandes hook et les commandes de ligne d'état. Non défini pour les sous-processus du serveur MCP stdio, qui sont de 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'un claude de niveau supérieur lancé dans un terminal intégré IDE. Un claude TUI interactif imbriqué démarré de cette façon est automatiquement exclu 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 sur verbose pour inclure les diagnostics à haut volume comme la sortie complète de la commande de ligne d'état, ou augmentez à error pour réduire le bruit
CLAUDE_CODE_DISABLE_1M_CONTEXT Définissez sur 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 non reconnu [1m], voir Corriger la fenêtre pour un ID de modèle de passerelle ou personnalisé
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING Définissez sur 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 sur 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 des paramètres. Nécessite Claude Code v2.1.223 ou ultérieur
CLAUDE_CODE_DISABLE_ADVISOR_TOOL Définissez sur 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 sur 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 sur 1 pour désactiver le rendu plein écran et utiliser le rendu d'écran principal classique. La conversation reste dans le défilement natif de votre terminal afin que Cmd+f et le mode copie tmux fonctionnent comme d'habitude. Prend 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 sur 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 l'avez défini, aucun fichier de paramètres ne réactive l'outil. Pour désactiver l'outil à partir d'un fichier de paramètres à la place, définissez enableArtifact sur false ; la clé disableArtifact dépréciée le désactive également
CLAUDE_CODE_DISABLE_ATTACHMENTS Définissez sur 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 dans le contenu du fichier
CLAUDE_CODE_DISABLE_AUTO_MEMORY Définissez sur 1 pour désactiver la mémoire automatique. Définissez sur 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 sur 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 sur 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 le flux 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 sur 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 sur 1 pour arrêter les commandes shell d'arrière-plan en cours d'exécution d'une session d'arrière-plan, les flux de travail 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 sur 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 un shell d'arrière-plan démarré 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à-bas. Nécessite Claude Code v2.1.193 ou ultérieur
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS Définissez sur 1 pour désactiver les compétences et les flux de travail inclus avec Claude Code : les compétences et flux de travail groupés 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 sur 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 sur 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 sur 1 pour désactiver les tâches programmées. La compétence /loop et les outils cron deviennent indisponibles et toutes les tâches déjà programmées cessent de se déclencher, y compris les tâches qui s'exécutent déjà au milieu d'une session
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS Définissez sur 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 (comme 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 conservé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 sur 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 sur 1 pour désactiver le mode rapide
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY Définissez sur 1 pour désactiver les sondages de qualité de session « How is Claude doing? ». 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 sur 1 pour désactiver le point de contrôle 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 sur 1 pour supprimer les instructions de flux de travail 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 flux de travail git. Prend la priorité sur le paramètre includeGitInstructions lorsqu'il est défini
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP Définissez sur 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 sur 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 sur 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 de l'outil ou ouvrent les liens. CLAUDE_CODE_DISABLE_MOUSE prend 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 sur 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 sur n'importe quelle valeur non vide, comme 1, pour désactiver le trafic réseau non essentiel : les mises à jour automatiques, la télémétrie, la signalisation des erreurs, la commande /feedback, les commentaires rédigés par Claude, les 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 sur 0 ou false désactive toujours ce trafic, contrairement à la plupart des variables activées/désactivées ; désactivez 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 sur 1 pour désactiver le secours non-continu lorsqu'une requête en continu échoue au milieu du flux. Les erreurs de flux continu se propagent à la couche de nouvelle tentative à la place. Utile lorsqu'une passerelle ou une passerelle proxy cause le secours pour produire une exécution d'outil dupliquée
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK Définissez sur 1 pour envoyer la notification de bureau de l'outil PushNotification même tandis que 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 sur 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. Désactiver 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 sur 1 pour empêcher Claude Code d'exécuter vos crochets de notification pour les requêtes 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 sur 1 pour ignorer le chargement des compétences à partir du répertoire de 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 sur 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 sur 1 pour omettre complètement le paramètre thinking des requêtes API. C'est une option de compatibilité pour les passerelles et les passerelles qui rejettent le paramètre. Sur les modèles qui pensent par défaut, omettre le 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. Aucune variable ne désactive la réflexion sur les modèles Fable, qui ne peuvent pas avoir la réflexion désactivée. Sur les fournisseurs tiers, MAX_THINKING_TOKENS=0 omet également le paramètre, afin que les deux variables se comportent de la même manière là-bas
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT Définissez sur 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 sur 1 pour désactiver le défilement virtuel en rendu plein écran et rendre chaque message dans la transcription. Utilisez ceci si le défilement en mode plein écran affiche des régions vierges où les messages doivent apparaître
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER Définissez sur 1 pour démarrer les commandes de l'outil PowerShell sur Windows directement au lieu de via le lanceur cmd.exe. Par défaut, le lanceur permet à une commande PowerShell s'exécutant en arrière-plan de se reporter au processus suivant de la session, par exemple lorsque vous mettez la session en arrière-plan. Si vous définissez la variable, une commande PowerShell mise en arrière-plan s'arrête lorsque le processus de la session se termine. Les commandes Bash ne sont pas affectées. Nécessite Claude Code v2.1.269 ou ultérieur
CLAUDE_CODE_DISABLE_WORKFLOWS Définissez sur 1 pour désactiver les flux de travail. Équivalent au paramètre disableWorkflows
CLAUDE_CODE_EFFORT_LEVEL Définissez le niveau d'effort pour les modèles pris en charge. 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. Prend la priorité sur --effort, /effort et les paramètres modelSettings et effortLevel. Un plafond maxEffortLevel s'applique toujours. Voir Ajuster le niveau d'effort
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 d'applications Claude signées. Dans v2.1.158 à v2.1.206, définir ceci sur 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 sur 0 pour forcer les récapitulatifs désactivés quel que soit le basculement /config. Définissez sur 1 pour forcer les récapitulatifs activés lorsque awaySummaryEnabled est false. Prend la priorité sur le paramètre et le basculement /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH Définissez sur 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 modifie le prompt système au milieu de la session, ce qui invalide la mise en cache du prompt pour ce tour
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL Définissez sur 1 pour router le sondage de qualité de session « How is Claude doing? » 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 commentaires des produits de l'organisation prennent la priorité
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING Contrôle si les entrées d'appel d'outil se transmettent depuis 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'elle 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 sur 0 pour refuser. Définissez sur 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 sur 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 sur false pour désactiver les suggestions de prompt, les prédictions grisées qui apparaissent dans votre entrée de prompt. Prend la priorité sur le paramètre promptSuggestionEnabled, qui est ce que le basculement Prompt suggestions dans /config écrit. Claude Code met également en pause les suggestions tandis que votre compte est proche ou à sa limite d'utilisation. Définissez sur 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 sur 0 pour obtenir l'outil TodoWrite hérité à la place. Voir Liste des tâches
CLAUDE_CODE_ENABLE_TELEMETRY Définissez sur 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 sur 1 pour obtenir les outils de suivi des tâches sur chaque modèle. Sans cela, Claude Code les fournit par défaut uniquement sur les modèles énumérés sous Disponibilité de l'outil Task. 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 flux de travail automatisés et les scripts utilisant le mode SDK
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS Définissez sur 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 fichiers. Utile lorsque vous devez lire des fichiers plus volumineux en entier
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE Définissez sur 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 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 sur 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, par exemple sur SSH sans TERM_PROGRAM transféré. Sans cela, 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 sur 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, cela ne change pas le rendu
CLAUDE_CODE_FORK_SUBAGENT Contrôle le mode fork, qui permet à Claude de générer des sous-agents forked elle-même et est activé par défaut uniquement dans les sessions interactives. Définissez sur 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 sur 1 pour activer le mode fork
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT Définissez sur 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à-bas 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_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS Délai d'expiration en millisecondes pour la requête de découverte de modèles de passerelle que CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY active (par défaut : 3000). Augmentez-le lorsque votre passerelle a besoin de plus de trois secondes pour répondre à /v1/models au démarrage. Accepte uniquement des chiffres simples ; 0, les valeurs négatives et les autres orthographes conservent la valeur par défaut. Nécessite Claude Code v2.1.269 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 sur 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 sur false pour faire en sorte que l'outil Glob respecte 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 sur 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 sur 1 pour ignorer l'installation automatique des extensions IDE. Équivalent à la définition de autoInstallIdeExtension sur false
CLAUDE_CODE_IDE_SKIP_VALID_CHECK Définissez sur 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 jetons de sortie max. 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 que la compaction automatique ne se déclenche
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 d'autres ; 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 prend 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 sur 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 sur 0 pour désactiver la mise en arrière-plan automatique. Nécessite Claude Code v2.1.212 ou ultérieur
CLAUDE_CODE_MCP_STARTUP_WAIT_MS Combien de temps en millisecondes le premier tour d'une session non-interactive attend les serveurs MCP qui se connectent toujours, à la place de l'attente du premier tour par défaut. Lorsqu'elle est définie, l'attente couvre chaque serveur en attente. Définissez sur 0 pour ignorer l'attente. Un serveur --permission-prompt-tool garde sa propre attente MCP_TIMEOUT quel que soit la valeur. Nécessite Claude Code v2.1.274 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 sur 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 crochets 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 l'exécution de tout crochet. 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 crochets 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 exige cette ligne et ferme toute connexion qui ne s'ouvre pas avec une ligne 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 sur 1 pour afficher le curseur propre du terminal à la position du curseur d'insertion 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 sur 1 pour faire en sorte que /init exécute un flux de configuration interactif. Le flux demande quels fichiers générer, y compris CLAUDE.md, les compétences et les crochets, 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_NONBLOCKING_STDOUT Définissez sur 1 pour écrire la sortie du terminal via un deuxième descripteur de fichier non bloquant, afin qu'un terminal qui arrête la lecture, comme un volet en mode contrôle tmux en pause ou une connexion SSH bloquée, ne puisse pas geler Claude Code au milieu d'une session. S'applique sur macOS, Linux et WSL lorsque stdout est un terminal. Nécessite Claude Code v2.1.261 ou ultérieur
CLAUDE_CODE_NO_FLICKER Définissez sur 1 pour activer le rendu plein écran, un aperçu de recherche qui réduit le scintillement et maintient 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. Prend 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 de l'outil, prompts système, corps API bruts), marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, c'est-à-dire 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 sur 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 sinon. 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 sur 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 d'afficher la commande de mise à niveau sans l'exécuter. Voir Mises à jour automatiques
CLAUDE_CODE_PERFORCE_MODE Définissez sur 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 les 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 sur 1 pour ignorer la tentative de re-clonage et continuer à utiliser le checkout de place de marché existant lorsqu'une actualisation de place de marché ne peut pas atteindre ou s'authentifier auprès du distant. 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 la place de marché échouent dans les environnements hors ligne
CLAUDE_CODE_PLUGIN_PREFER_HTTPS Définissez sur 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 graines 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 sur 1 pour empêcher Claude Code de transmettre -ExecutionPolicy Bypass lors du lancement de PowerShell pour les appels d'outils, les crochets et les commandes de ligne d'état, 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 la stratégie de groupe quel que soit ce paramètre
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS Plafond en millisecondes sur l'attente inactive pour les sous-agents d'arrière-plan et les flux de travail 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 arrête d'attendre les tâches d'arrière-plan restantes et quitte. Définissez sur 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 prend 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éfinissez 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 des 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 durée de vie du cache du prompt pour la conversation principale : vos tours interactifs, -p et SDK, plus les assistants qui s'exécutent en ligne avec eux. Prend la priorité sur le paramètre promptCacheTtl et sur ENABLE_PROMPT_CACHING_1H, et FORCE_PROMPT_CACHING_5M le remplace. L'API facture les écritures de cache d'une heure à un taux plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur
CLAUDE_CODE_PROPAGATE_TRACEPARENT Définissez sur 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 prenne 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 sur 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 sur true lorsque Claude Code s'exécute en tant que session cloud. Lisez ceci à partir d'un crochet 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 sur 1 pour démarrer la session en mode restreint, identique à la transmission de --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 sur 1 pour reprendre automatiquement si la session précédente s'est terminée au milieu d'un tour. Utilisé en mode SDK afin que le modèle continue sans exiger que le SDK renvoie le prompt. Pour désactiver ceci, désactivez la variable ou définissez-la sur 0. Avant v2.1.221, Claude Code ignorait 0 et les autres valeurs fausses, afin que la définition de 0 déclenchait toujours la reprise en mode non interactif et la désactivation de 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 au milieu d'un 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, sauf qu'un tour dont la dernière requête a échoué avec une erreur API reprend uniquement tandis que cette erreur a moins de six heures. Une valeur positive limite chaque tour, y compris ceux-ci ; une valeur négative ou non numérique applique une limite d'une heure. Les scripts de génération pour les agents de longue durée peuvent définir ceci afin qu'un redémarrage contre une transcription ancienne 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 échoué et 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 au milieu d'un tour. Par défaut Continue from where you left off.. Les scripts de génération pour les agents de 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 sur 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 lorsqu'une requête à vitesse standard reçoit 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 la passerelle qui se réinitialise selon un calendrier. Avant v2.1.239, le chien de garde réessayait ceux-ci indéfiniment. Pour les requêtes en mode rapide, voir Gérer les limites de débit. 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 de limite de débit, 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 de serveur, les délais d'expiration et les connexions abandonné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 sur 1 pour démarrer en mode sûr : CLAUDE.md, les compétences, les plugins, les crochets, les serveurs MCP, les commandes et agents personnalisés, les styles de sortie, les flux de travail, les thèmes personnalisés, les liaisons de clés personnalisées, les commandes de ligne d'état 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 crochets configurés par la politique, la ligne d'état 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 à la transmission de --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 défilement à 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 pavé tactile et de la molette dans les terminaux qui amplifient déjà les événements de molette. Définissez sur 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 sur 0 pour désactiver les commentaires rédigés par Claude pour une session. Définissez sur 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 commentaires, comme 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 crochets SessionEnd. La valeur est également le délai d'expiration pour chaque crochet qui ne définit pas son propre timeout. S'applique à la sortie de session, /clear et au changement de session via /resume interactif. Par défaut, le budget est de 1,5 secondes, augmenté automatiquement au plus haut timeout par crochet configuré dans les fichiers de paramètres, jusqu'à 60 secondes. Les délais d'expiration sur les crochets fournis par les plugins ne relèvent pas du 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 crochets, cela correspond au champ session_id dans l'entrée JSON du crochet 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, correspondant aux crochets et à Bash. 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 d'accès à un binaire bash ou zsh, par exemple /opt/homebrew/bin/bash. Les autres shells comme fish ne sont pas pris en charge. 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 il 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 : les appels de l'outil Bash, les commandes hook, les commandes de ligne d'état et les commandes de démarrage du serveur MCP stdio. Les crochets PowerShell et les crochets 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 unique entre guillemets 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 de l'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 sur 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 crochets, des compétences, des commandes personnalisées, des sous-agents, des plugins, des serveurs MCP, de la mémoire automatique et de 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 à la transmission de --bare
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT Définissez sur 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 sur 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, la découverte des crochets, des serveurs MCP et de CLAUDE.md restent activés
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH Ignorer 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 sur 1 pour désactiver le cache en processus des identifiants résolus à partir de la chaîne du 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 Ignorer 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 sur 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 à api.anthropic.com. Claude Code honore toujours une réponse « disabled by your organization »
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK Définissez sur 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 en mode rapide lorsque votre organisation a le mode rapide désactivé
CLAUDE_CODE_SKIP_FOUNDRY_AUTH Ignorer 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 Ignorer l'authentification AWS pour Amazon Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM)
CLAUDE_CODE_SKIP_PROMPT_HISTORY Définissez sur 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 Ignorer l'authentification Google pour Google Cloud's Agent Platform (par exemple, lors de l'utilisation d'une passerelle LLM)
CLAUDE_CODE_STARTUP_FAILURE_RESULTS Définissez sur 1 pour qu'une session démarrée avec --output-format stream-json écrive un message de résultat nommant pourquoi Claude Code a refusé de démarrer pour les défaillances de démarrage qui se terminent autrement par stderr seul. Nécessite Claude Code v2.1.274 ou ultérieur
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Nombre maximum de fois consécutives qu'un crochet 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 sur 0 pour désactiver le plafond. Augmentez ceci si votre crochet 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 flux de travail 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 prennent 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 sur 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 sur 1 pour forcer un modèle sur les sous-agents, les coéquipiers et les agents de flux de travail. 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 durée de vie du cache du prompt pour les requêtes en dehors de la conversation principale, telles que les sous-agents, les flux de travail et le travail d'arrière-plan. Prend la priorité sur le paramètre subagentPromptCacheTtl et sur ENABLE_PROMPT_CACHING_1H, et FORCE_PROMPT_CACHING_5M le remplace. L'API facture les écritures de cache d'une heure à un taux plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB Définissez sur 1 pour supprimer les identifiants des environnements de sous-processus (outil Bash, crochets, serveurs MCP stdio) : les identifiants Anthropic et du fournisseur cloud, toute autre variable que Claude Code reconnaît comme un identifiant, et les 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 v2.1.251 ou ultérieur, le nettoyage supprime également les variables de pointeur de magasin de configuration propres à Claude Code (comme CLAUDE_CONFIG_DIR), afin qu'un processus enfant ne puisse pas localiser un répertoire de configuration réinstallé. Laissez le nettoyage non défini si un sous-processus a besoin de ces variables. 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 tant qu'effet secondaire, 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 sur 1 en mode non interactif (le drapeau -p) pour attendre la fin de l'installation du plugin avant la première requête. Sans cela, 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 sur 1 en mode non interactif avec le drapeau -p pour faire en sorte que Claude Code télécharge les compétences activées pour votre compte claude.ai dans cette exécution et attende la liste d'entre elles, jusqu'à CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS, avant d'exécuter la première requête. 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. Nécessite l'authentification claude.ai. Les sessions de terminal où vous vous connectez avec votre compte claude.ai téléchargent ces compétences dans ~/.claude/skills/synced/ et se resynchronisent environ toutes les 10 minutes sans cette variable, afin de la définir uniquement lorsqu'une exécution -p a besoin de vos compétences actuelles à sa première requête. Avant v2.1.273, les sessions de terminal les téléchargeaient uniquement dans une exécution -p avec cette variable définie. Le nom du dossier synced est réservé pour ce téléchargement. Avant v2.1.227, les compétences téléchargeaient dans ~/.claude/skills/ directement. 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 la resynchronisation des compétences qui s'exécute au milieu de la session lorsqu'une application construite sur le SDK Agent recharge les compétences (par défaut : 30000). Lorsqu'il est dépassé, le rechargement continue avec les compétences qui sont arrivées, et les téléchargements restants se terminent 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 de compétences initiale 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 sur 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 fichiers, 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, combien de temps une session non interactive 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 remplacement est un chemin long, car certains outils échouent lorsque les chemins temporaires deviennent trop longs. Les commandes Bash non sandboxées héritent de votre $TMPDIR shell inchangé. Les fichiers temporaires propres à Claude Code utilisent toujours votre remplacement. 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 sur n'importe quelle valeur non vide, comme 1, pour permettre la sortie truecolor 24 bits à l'intérieur de tmux. Définir sur 0 ou false permet toujours truecolor, contrairement à la plupart des variables activées/désactivées ; désactivez la variable pour restaurer le serrage 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 sur une liste séparée par des virgules des types de processus que Claude Code exclut du plafond de mémoire de l'outil, comme mcp ou lsp. Définissez none pour limiter chaque type, 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 sur 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 avant que Claude Code annule un dialogue qu'il transfère à un client distant comme un Remote Control ou un hôte SDK, ou le dialogue d'approbation pour un message inter-session retenu ; les invites de permission et les questions AskUserQuestion utilisent leurs propres flux et ne sont pas régis par celui-ci. Sur Claude Code v2.1.236 ou ultérieur, il limite également le dialogue de consentement des crédits d'utilisation Fable au milieu de la 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 Mantle d'Amazon Bedrock
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH Définissez sur 1 pour découvrir les commandes personnalisées, les sous-agents et les styles de sortie en utilisant les API de fichiers 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 fichiers
CLAUDE_CODE_USE_POWERSHELL_TOOL Contrôle l'outil PowerShell. Sur Windows sans Git Bash, l'outil est activé automatiquement ; définissez sur 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 sur 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 sur 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 sur le nombre de millisecondes que WebFetch garde la réponse de chaque URL récupérée en cache. La valeur par défaut est 900000, ce qui est 15 minutes. Accepte uniquement des chiffres simples ; 0, une décimale ou toute autre orthographe conserve 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_WEBFETCH_DEADLINE_MS Limite supérieure en millisecondes sur combien de temps WebFetch attend qu'une page se télécharge, y compris les redirections qu'elle suit. Un téléchargement qui n'est pas terminé à ce moment échoue avec une erreur de délai. La valeur par défaut est 300000, ce qui est cinq minutes. Définissez sur 0 pour supprimer la limite. Accepte uniquement des chiffres simples ; une décimale ou toute autre orthographe conserve la valeur par défaut. Nécessite Claude Code v2.1.268 ou ultérieur
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS Combien d'agents une seule exécution de flux de travail exécute à la fois, de 1 à 256. Par défaut, une exécution exécute jusqu'à 16 agents à la fois, moins lorsque Claude Code a moins de CPU disponibles ; les appels agent() en attente attendent un créneau libre. La transcription de chaque agent en cours d'exécution reste en mémoire de Claude Code, afin que les valeurs plus élevées augmentent l'utilisation de la mémoire. Accepte uniquement des chiffres simples ; les valeurs hors plage et les autres orthographes conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou ultérieur
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS Limite supérieure en millisecondes sur combien de temps un agent de flux de travail 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 retient 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 sur 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 sur 1 pour arrêter le travail d'arrière-plan en vol au lieu de le reporter 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 reporté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 crochets. Défini uniquement lorsque le modèle actuel supporte le paramètre d'effort
CLAUDE_ENABLE_BYTE_WATCHDOG Définissez sur 1 pour forcer l'activation du chien de garde d'inactivité de flux au niveau des octets, ou définissez sur 0 pour le forcer à désactiver. 0 désactive également le délai du 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 une stagnation là-bas même tandis que les pings de maintien de la connexion arrivaient. Pour les délais d'expiration et la façon dont les minuteurs interagissent, voir Chiens de garde d'inactivité de flux
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK Définissez sur 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 du 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 sur 0 pour forcer la désactivation du chien de garde d'inactivité de flux au niveau des événements, ou définissez sur 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 minuteurs de stagnation qui s'exécutent aux côtés de celui-ci, voir Chiens de garde d'inactivité de flux
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 du fichier soient visibles à la commande. Utilisez pour persister l'activation virtualenv ou conda entre les commandes. Également rempli dynamiquement par les crochets SessionStart, Setup, CwdChanged et FileChanged
CLAUDE_JOB_DIR Défini par Claude Code dans chaque session d'arrière-plan à ce répertoire ~/.claude/jobs/<id> de la session. Les commandes shell que la session exécute l'héritent. Écrivez les fichiers de travail temporaire à $CLAUDE_JOB_DIR/tmp. Les appels Write et Edit de Claude là-bas ne demandent pas la permission, et le répertoire est supprimé lorsque la session est supprimée
CLAUDE_PID Claude Code définit ceci à son propre ID de processus dans les sous-processus qu'il génère : les commandes de l'outil Bash et PowerShell et les 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 en millisecondes pour le premier octet de réponse d'une requête en continu, sur les connexions où le délai du premier octet s'exécute. Pour la façon dont Claude Code le serre, le temps supplémentaire qu'il ajoute pour les grands corps de requête 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 prend 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
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS Supprimé dans v2.1.260 et maintenant un no-op. Auparavant, limitait combien de temps une commande shell d'arrière-plan qu'un sous-agent a démarrée pouvait s'exécuter, en millisecondes, avec une valeur par défaut de 60 minutes. Voir les règles de durée de vie de la commande d'arrière-plan
DEBUG Définissez sur 1 pour activer le mode débogage, équivalent au lancement 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 vraies 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 sur 1 pour désactiver les mises à jour automatiques d'arrière-plan. La commande manuelle claude update fonctionne toujours. Utilisez DISABLE_UPDATES pour bloquer les deux
DISABLE_AUTO_COMPACT Définissez sur 1 pour désactiver la compaction automatique lorsque vous approchez de la limite de contexte. La commande manuelle /compact 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 sur 1 pour désactiver toute la compaction : à la fois la compaction automatique et la commande manuelle /compact
DISABLE_COST_WARNINGS Définissez sur 1 pour désactiver les messages d'avertissement de coût
DISABLE_DOCTOR_COMMAND Définissez sur 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 de terminal claude doctor. Avant v2.1.205, cette variable masquait l'écran de diagnostics /doctor
DISABLE_ERROR_REPORTING Définissez sur n'importe quelle valeur non vide, comme 1, pour refuser la signalisation des erreurs. Définir sur 0 ou false refuse toujours, contrairement à la plupart des variables activées/désactivées ; désactivez la variable pour réactiver la signalisation des erreurs
DISABLE_EXTRA_USAGE_COMMAND Définissez sur 1 pour masquer la commande /usage-credits qui permet aux utilisateurs d'acheter une utilisation supplémentaire au-delà des limites de débit
DISABLE_FEEDBACK_COMMAND Définissez sur 1 pour désactiver la commande /feedback et les commentaires 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 sur 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 sur 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 sur 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 sur 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 sur 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 sur 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 sur 1 pour masquer la commande /logout
DISABLE_PROMPT_CACHING Définissez sur 1 pour désactiver la mise en cache du prompt pour tous les modèles (prend la priorité sur les paramètres par modèle)
DISABLE_PROMPT_CACHING_FABLE Définissez sur 1 pour désactiver la mise en cache du prompt pour les modèles Fable
DISABLE_PROMPT_CACHING_HAIKU Définissez sur 1 pour désactiver la mise en cache du prompt pour les modèles Haiku
DISABLE_PROMPT_CACHING_OPUS Définissez sur 1 pour désactiver la mise en cache du prompt pour les modèles Opus
DISABLE_PROMPT_CACHING_SONNET Définissez sur 1 pour désactiver la mise en cache du prompt pour les modèles Sonnet
DISABLE_TELEMETRY Définissez sur n'importe quelle valeur non vide, comme 1, pour refuser la télémétrie. Définir sur 0 ou false refuse toujours, contrairement à la plupart des variables activées/désactivées ; désactivez 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 fichiers 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 sur 1 pour bloquer toutes les mises à jour, y compris la commande manuelle claude update 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 sur 1 pour masquer la commande /upgrade
DO_NOT_TRACK Définissez sur 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 sur 1, avec BETA_TRACING_ENDPOINT, pour activer le traçage bêta détaillé, qui ajoute des attributs porteurs de contenu et l'intervalle claude_code.hook. Les sessions CLI interactives nécessitent également que votre organisation soit sur 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 sur 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 sur 1 pour demander une durée de vie 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 la durée de vie d'une heure automatiquement sur la conversation principale. Les utilisateurs d'abonnement tirant sur les crédits d'utilisation peuvent le définir pour garder la durée de vie d'une heure. Les écritures de cache d'une heure sont facturées à un taux plus élevé. Pour choisir la durée de vie par compartiment de requête à la place, utilisez CLAUDE_CODE_PROMPT_CACHE_TTL et CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, qui prennent 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 diffère 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-first-party. true diffère 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 tiennent 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 sur true
FALLBACK_FOR_ALL_PRIMARY_MODELS Définissez sur n'importe quelle valeur non vide, comme 1, pour faire en sorte que Claude Code arrête de réessayer sur les erreurs de surcharge répétées pour chaque modèle lorsqu'aucun modèle de secours n'est configuré. Définir sur 0 ou false active toujours ceci, contrairement à la plupart des variables activées/désactivées ; désactivez la variable pour restaurer le comportement de nouvelle tentative par défaut. Sans cela, Claude Code arrête de réessayer de cette façon sur les modèles qu'il reconnaît comme Opus, Fable ou Mythos lorsque vous vous authentifiez avec une clé API ou un fournisseur tiers plutôt qu'un abonnement Claude. Sur Claude Code v2.1.160 ou ultérieur, Claude Code bascule vers votre chaîne de modèle de secours configurée sur les erreurs de surcharge répétées pour n'importe quel modèle principal, afin que cette variable n'affecte pas le basculement vers un modèle de secours
FORCE_AUTOUPDATE_PLUGINS Définissez sur 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 sur 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. Le badge d'état PR ou de demande de fusion du pied de page se rend en tant qu'hyperlien même lorsque Claude Code ne peut pas détecter le support du terminal, par exemple sur SSH. Définissez 0 pour rendre le badge en tant que texte simple
FORCE_PROMPT_CACHING_5M Définissez sur 1 pour forcer la durée de vie du cache du prompt de 5 minutes même lorsque la durée de vie 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 sur 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 sur 0 ou false active toujours le mode démo, contrairement à la plupart des variables activées/désactivées ; désactivez 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 tentatives que Claude Code autorise lorsque la réponse du modèle échoue la validation par rapport au --json-schema en mode non interactif avec le drapeau -p ; après ce nombre de tentatives échouées sans sortie valide, l'exécution échoue. Le même plafond s'applique lorsque la sortie structurée d'un sous-agent de flux de travail échoue la validation. Par défaut 5, une première tentative plus quatre tentatives
MAX_THINKING_TOKENS Budget de jetons fixe pour la réflexion étendue. Claude Code le limite à un jeton en dessous des jetons de sortie max 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 sur 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 également 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 ne pas accepter cette combinaison, comme Opus 5. Claude Code ignore les valeurs non nulles sur les modèles de raisonnement adaptatif, sauf sur les modèles où CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING désactive le raisonnement adaptatif
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 sur 0 pour faire en sorte que Claude Code attende 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 le cas, 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) sans --input-format stream-json, Claude Code attend également les serveurs toujours en attente avant le premier tour quel que soit cette variable. Lorsque vous transmettez --mcp-config explicitement, l'attente a un délai plus long ; 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, le lot de connexion avant de prendre un instantané de la liste des 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 sur 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 sonde également les serveurs connecteur claude.ai dans les sessions où il récupère les drapeaux de fonctionnalité. 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 au 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, à partir des versions énumérées dans cette section. 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 au 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 de l'exécution de l'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 directement émises, 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 de 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 sur 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 sur 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 sur 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 complet de la conversation. 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 sur 1 pour inclure le contenu de l'outil dans l'événement d'intervalle OpenTelemetry tool.output. Les attributs d'intervalle portent le contenu de l'outil sous leurs propres portes. Nécessite le traçage. Désactivé par défaut pour protéger les données sensibles. Voir Surveillance
OTEL_LOG_TOOL_DETAILS Définissez sur 1 pour inclure les arguments d'entrée de l'outil, les noms des serveurs MCP, les noms de flux de travail rédigés par l'utilisateur, les chaînes d'erreur brutes sur les défaillances d'outils, la category de refus sur les événements api_refusal et d'autres détails d'outils dans les traces et journaux OpenTelemetry. Désactivé par défaut pour protéger les informations d'identification personnelle. Voir Surveillance
OTEL_LOG_USER_PROMPTS Définissez sur 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 sur false pour exclure l'UUID du compte des attributs de métriques (par défaut : inclus). Voir Surveillance
OTEL_METRICS_INCLUDE_ENTRYPOINT Définissez sur 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_REPOSITORY Définissez sur true pour étiqueter les métriques et événements OpenTelemetry avec les attributs vcs.* identifiant le référentiel de la session (par défaut : exclu). Nécessite Claude Code v2.1.269 ou ultérieur. Voir Attributs du référentiel
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 sur false pour les exclure (par défaut : inclus). Voir Surveillance
OTEL_METRICS_INCLUDE_SESSION_ID Définissez sur false pour exclure l'ID de session des attributs de métriques (par défaut : inclus). Voir Surveillance
OTEL_METRICS_INCLUDE_VERSION Définissez sur 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 la sortie d'une tâche d'arrière-plan que l'outil TaskOutput conserve (par défaut : 32000 ; maximum : 160000). Si vous définissez le paramètre taskOutputMaxChars, Claude Code ignore cette variable
USE_BUILTIN_RIPGREP Définissez sur 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.257
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 prises en charge. 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, ou CLAUDE_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 :

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