Variables d'environnement
Référence pour les variables d'environnement qui contrôlent le comportement de Claude Code.
Les variables d'environnement peuvent contrôler le comportement de Claude Code, comme la sélection du modèle, l'authentification, le routage des requêtes et les bascules de fonctionnalités. Beaucoup des mêmes comportements peuvent également être configurés via un fichier de paramètres, un drapeau CLI ou une commande en session comme /model.
Cette page couvre comment :
- Définir les variables d'environnement dans votre shell ou dans un fichier de paramètres
- Vérifier quelle valeur s'applique quand un comportement peut être défini de plusieurs façons
- Consulter les variables que Claude Code lit
- Voir quelles fonctionnalités cessent de fonctionner quand une variable désactive la récupération des drapeaux de fonctionnalités
Définir les variables d'environnement
Une variable que vous définissez dans votre shell dure pendant cette session de terminal, tandis qu'une variable dans un fichier de paramètres s'applique chaque fois que claude s'exécute.
Dans votre shell
Définissez la variable avant de lancer claude :
export API_TIMEOUT_MS="1200000"
claude
Pour la définir pour chaque session, ajoutez la ligne export à ~/.bashrc, ~/.zshrc, ou le fichier de profil de votre shell.
$env:API_TIMEOUT_MS = "1200000"
claude
Pour la définir pour chaque session, exécutez [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") et ouvrez un nouveau terminal.
set API_TIMEOUT_MS=1200000
claude
Pour la définir pour chaque session, exécutez setx API_TIMEOUT_MS "1200000" et ouvrez un nouveau terminal.
La ligne d'assignation n'affiche rien en cas de succès, donc confirmez que la variable est définie en l'affichant dans le même shell avant d'exécuter claude :
echo $API_TIMEOUT_MS
echo $env:API_TIMEOUT_MS
echo %API_TIMEOUT_MS%
Dans les fichiers de paramètres
Ajoutez les variables sous la clé env dans un fichier settings.json, en créant le fichier s'il n'existe pas. Claude Code les lit directement depuis le fichier, donc elles prennent effet peu importe comment claude a été lancé. Une session en cours applique les valeurs nouvelles et modifiées à son environnement lorsque vous enregistrez le fichier, mais une fonctionnalité qui lit ses variables une seule fois au démarrage, comme la surveillance OpenTelemetry, conserve ses valeurs de démarrage jusqu'à ce que vous relancez. Supprimer une variable du fichier ne la désactive pas dans une session en cours ; la suppression prend effet la prochaine fois que vous lancez claude.
{
"env": {
"API_TIMEOUT_MS": "1200000",
"BASH_DEFAULT_TIMEOUT_MS": "300000"
}
}
Le fichier que vous choisissez contrôle à qui les variables s'appliquent :
| Fichier | S'applique à |
|---|---|
~/.claude/settings.json |
Vous, dans chaque projet |
.claude/settings.json |
Tous ceux qui travaillent dans le projet, archivé dans le contrôle de source |
.claude/settings.local.json |
Vous, dans ce projet uniquement, ignoré par git lorsque Claude Code enregistre un paramètre ; ajoutez-le à votre gitignore si vous le créez manuellement |
| Paramètres gérés | Tous les membres de votre organisation, déployés par un administrateur |
Consultez Fichiers de paramètres pour savoir où se trouve chaque fichier et Précédence des paramètres pour savoir comment ils se combinent lorsque plusieurs définissent la même variable.
Précédence
Certains comportements ont à la fois une variable d'environnement et une clé de paramètres dédiée, et celle que Claude Code lit en premier diffère selon la clé. Pour ANTHROPIC_MODEL et CLAUDE_CODE_AUTO_CONNECT_IDE, Claude Code lit d'abord la variable et utilise le paramètre model ou autoConnectIde uniquement lorsque la variable n'est pas définie. Pour la paire que vous définissez, vérifiez la ligne de la variable ci-dessous et l'entrée de la clé sur la référence des paramètres.
Lorsque la même variable est définie à la fois dans votre shell et dans un bloc env du fichier de paramètres, la valeur du fichier de paramètres s'applique. Claude Code écrit chaque entrée env dans l'environnement du processus, en remplaçant la valeur héritée du shell. Le paramètre env indique quand il les applique. Quelques variables sont traitées de manière spéciale ; le paramètre env énumère les exceptions.
Dans un fichier de paramètres, vous pouvez définir une variable mais vous ne pouvez pas en supprimer une. Pour remplacer une variable que vous ne pouvez pas désactiver, comme une CLAUDE_CODE_USE_VERTEX obsolète exportée par un profil de shell que vous ne contrôlez pas, définissez-la sur une chaîne vide dans le bloc env : "CLAUDE_CODE_USE_VERTEX": "". Claude Code traite la valeur vide comme non définie pour la sélection du fournisseur. Les sous-processus héritent toujours de la valeur vide.
Entre les fichiers de paramètres, les valeurs env suivent la précédence des paramètres, de sorte qu'une entrée de paramètres gérée remplace la même variable dans les paramètres utilisateur ou projet.
La façon dont une variable d'environnement interagit avec les drapeaux CLI et les commandes en session varie selon la fonctionnalité : --model et /model remplacent ANTHROPIC_MODEL, tandis que CLAUDE_CODE_EFFORT_LEVEL remplace --effort et /effort. Lorsqu'une variable interagit avec une autre source de configuration, sa ligne dans la liste Variables indique la précédence ou établit un lien vers la page qui la documente.
Claude Code lit les variables d'environnement du shell au démarrage, de sorte que les modifications apportées à celles-ci prennent effet la prochaine fois que vous lancez claude. Les variables définies sous la clé env dans les fichiers de paramètres sont réappliquées à une session en cours lorsque le fichier change, à l'exception du démarrage uniquement décrite dans Dans les fichiers de paramètres.
Variables
Les variables numériques telles que les délais d'expiration, les budgets de jetons et les nombres de tentatives acceptent la notation scientifique et les orthographes avec séparateurs de chiffres en plus des chiffres simples, sauf si la ligne d'une variable indique qu'elle n'accepte que des chiffres simples. Par exemple, Claude Code lit 2e3 comme 2000 et 64_000 comme 64000. Avant la v2.1.211, ces orthographes pouvaient définir silencieusement une valeur beaucoup plus petite, comme 1e6 définissant un délai d'expiration à 1.
Pour les variables qui activent ou désactivent un comportement, définissez 1 ou true pour l'activer et 0 ou false pour le désactiver, dans n'importe quelle casse.
Certaines variables ne lisent que si vous les avez définies, donc toute valeur non vide, y compris 0, active le comportement, et vous désactivez le comportement en désactivant la variable ou en la définissant sur une valeur vide. Ces variables fonctionnent de cette façon :
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICDISABLE_TELEMETRYDISABLE_ERROR_REPORTINGCLAUDE_CODE_TMUX_TRUECOLORFALLBACK_FOR_ALL_PRIMARY_MODELSIS_DEMO
Une autre variable a sa propre règle : FORCE_HYPERLINK lit un nombre, donc seul 0 la désactive. La ligne de chaque variable énonce également sa propre règle.
| Variable | Objectif |
|---|---|
ANTHROPIC_API_KEY |
Clé API envoyée en tant qu'en-tête X-Api-Key. Lorsqu'elle est définie, cette clé est utilisée à la place de votre abonnement Claude Pro, Max, Team ou Enterprise, même si vous êtes connecté. En mode non interactif (-p), la clé est toujours utilisée lorsqu'elle est présente. En mode interactif, vous êtes invité à approuver la clé une fois avant qu'elle ne remplace votre abonnement. Pour utiliser votre abonnement à la place, exécutez unset ANTHROPIC_API_KEY |
ANTHROPIC_AUTH_TOKEN |
Valeur personnalisée pour l'en-tête Authorization (la valeur que vous définissez ici sera préfixée par Bearer ) |
ANTHROPIC_AWS_API_KEY |
Clé API 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 |
Contrôle si Claude Code demande au serveur d'examiner les actions du mode auto. Définissez sur 0 pour utiliser les requêtes du classificateur propre de Claude Code à la place. Sur une connexion directe à l'API Anthropic, nécessite v2.1.281 ou ultérieur. La section liée énumère les sessions qui demandent au serveur lorsque la variable n'est pas définie, et à partir de quelle version. 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. Cela ignore également la requête de modèle petit/rapide d'arrière-plan qui génère un titre de 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 proxies 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 Opus 5.5 ni 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_HINT_HEADERS |
Définissez sur 1 pour envoyer les en-têtes d'indice de passerelle, comme x-claude-code-request-class et x-claude-code-compaction, sur un proxy personnalisé ou un fournisseur tiers comme Amazon Bedrock ou Claude Platform on AWS. Définissez sur 0 pour arrêter de les envoyer sur chaque connexion, y compris une connexion directe à l'API Anthropic, où Claude Code les envoie par défaut. Nécessite Claude Code v2.1.273 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_MCP_DESCRIPTION_LENGTH |
Longueur maximale en caractères de chaque description d'outil MCP et des instructions de chaque serveur MCP que Claude Code envoie au modèle (par défaut : 2048). Claude Code tronque le texte plus long. Accepte un nombre entier positif en chiffres simples. Tout le reste est ignoré et la valeur par défaut s'applique. Nécessite Claude Code v2.1.280 ou ultérieur |
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_DIRS |
Répertoires de plugins à charger pour la session, chacun chargé de la façon qu'un drapeau --plugin-dir le charge. Séparez plusieurs chemins avec : sur Unix ou ; sur Windows. Donnez chaque chemin en tant que chemin absolu ou commencez-le par ~, car Claude Code ignore les chemins relatifs. Nécessite Claude Code v2.1.280 ou ultérieur |
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 f 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 plain |
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 Opus 5.5 et les modèles Fable, qui ne peuvent pas avoir la réflexion désactivée. Sur les fournisseurs tiers, 0 omet le paramètre thinking à la place. Avec la réflexion désactivée sur l'API Anthropic, Claude Code envoie l'effort high au lieu d'un niveau plus élevé aux modèles qu'il sait 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_MANAGED_SETTINGS |
Définissez sur 1 pour ajouter les paramètres gérés rédactés, et un digest SHA-256 des paramètres avant rédaction, aux événements de journal OpenTelemetry managed_settings_resolved. Désactivé par défaut. Définissez-le dans votre shell, vos paramètres utilisateur ou vos paramètres gérés ; une valeur dans les paramètres de projet ou locaux ne l'active pas. Nécessite Claude Code v2.1.274 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 |
Supprimé dans v2.1.277 et maintenant un no-op, avec l'outil TaskOutput qu'il dimensionnait. Auparavant, définissait le nombre maximum de caractères de la sortie d'une tâche d'arrière-plan que l'outil TaskOutput conservait. Claude lit la sortie d'une tâche d'arrière-plan avec Read à la place |
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_5_OPUS |
Remplacez la région pour Claude Opus 5.5 lors de l'utilisation de Google Cloud's Agent Platform. Ajouté dans v2.1.280 |
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, ouCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC; la ligne de chaque variable dans le tableau des variables indique quelles valeurs désactivent la récupération - Une session sur un fournisseur tiers, tel qu'Amazon Bedrock, Claude Platform sur AWS, Agent Platform de Google Cloud, ou Microsoft Foundry, sauf si une plateforme hôte qui intègre Claude Code définit
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST - Une session de passerelle d'applications Claude
Avec la récupération désactivée, vous ne pouvez pas :
- Démarrer les sessions en mode auto par défaut sur les plans Pro, Max et Team
- Faire en sorte que l'extension VS Code lise les fichiers de paramètres pour le mode de permission de démarrage
- Exécuter
/auto-mode-setuppour rédiger les entréesautoMode.environment - Utiliser Remote Control
- Envoyer des messages aux sessions au-delà de cette machine ; la messagerie entre les sessions sur cette machine fonctionne avec la récupération désactivée
- Exécuter
claude importou la commande/import - Exécuter
/skill-doctorou ouvrir son rapport dans l'onglet Stats de/plugin - Synchroniser les compétences et les plugins activés pour votre compte claude.ai dans vos sessions de terminal
- Utiliser l'outil advisor
- Lire ou répondre aux commentaires sur un artifact
- Faire en sorte que Claude Code sonde les serveurs connecteurs claude.ai pour la révision du protocole MCP 2026-07-28 sauf si vous définissez
MCP_PROTOCOL_NEGOTIATION=auto - Obtenir l'outil PowerShell par défaut pour les comptes claude.ai et Console sur Windows avec Git Bash installé ; Claude Code achemine les commandes shell via Git Bash sauf si vous définissez
CLAUDE_CODE_USE_POWERSHELL_TOOL=1. Sur Windows sans Git Bash, l'outil reste activé - Obtenir les retours rédigés par Claude, que Claude Code active via un flag récupéré
- Faire en sorte que Claude traite les grands collages comme du texte collé plutôt que du texte saisi ; le contenu derrière un espace réservé
[Pasted text #N]atteint Claude sans marquage - Faire en sorte que Claude Code exclue les outils MCP dont le schéma d'entrée serait rejeté par l'API ; il envoie le schéma de toute façon, et une requête qui l'inclut échoue avec une erreur 400 nommant l'outil par sa position
Première session après une installation ou une mise à jour
Lors de votre première session après l'installation de Claude Code, ou la mise à jour vers une version qui ajoute une fonctionnalité, une fonctionnalité contrôlée par flag peut être manquante, et la session peut démarrer en mode Manuel sur un plan qui démarre autrement en mode auto. Claude Code récupère les flags lors de cette session, donc les deux sont présents dans votre session suivante.
Après une installation propre, dans une session non-interactive telle que claude -p, le SDK Agent, ou l'extension VS Code, Claude Code peut toujours récupérer les flags avant de choisir le mode de permission de démarrage.
Voir aussi
- Paramètres : tous les paramètres de configuration
settings.json, y compris la cléenv - Référence CLI : drapeaux de lancement
- Configuration réseau : configuration du proxy et TLS
- Surveillance : configuration OpenTelemetry