Variables d'environnement - Claude Code Docs

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 champ de 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 lorsqu’un comportement peut être défini de plusieurs façons
Consulter les variables que Claude Code lit

Définir les variables d’environnement

Une variable que vous définissez dans votre shell dure pour 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 :

macOS, Linux, WSL
Windows PowerShell
Windows CMD

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.

Dans les fichiers de paramètres

Ajoutez les variables sous la clé env dans un fichier settings.json. Claude Code les lit directement à partir du fichier au démarrage, donc elles prennent effet peu importe comment claude a été lancé.

~/.claude/settings.json

{
  "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 (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

Voir 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

Lorsque le même comportement a à la fois une variable d’environnement et un champ de paramètres, la variable d’environnement prend la priorité. Par exemple, ANTHROPIC_MODEL remplace le paramètre model, et CLAUDE_CODE_AUTO_CONNECT_IDE remplace autoConnectIde. Le champ de paramètres s’applique lorsque la variable d’environnement n’est pas définie. Lorsque la même variable est définie à la fois dans votre shell et dans un fichier de paramètres bloc env, la valeur du fichier de paramètres s’applique. Claude Code écrit chaque entrée env dans l’environnement du processus au démarrage, en remplaçant la valeur héritée du shell. Quelques variables sont traitées de manière spéciale ; le paramètre env énumère les exceptions. Entre les fichiers de paramètres, les valeurs env suivent la précédence des paramètres, donc 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. Lorsqu’une variable interagit avec une autre source de configuration, sa ligne dans la liste Variables indique la précédence ou renvoie à la page qui la documente. Claude Code lit les variables d’environnement au démarrage, donc les modifications prennent effet la prochaine fois que vous lancez claude.

Variables

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`	Remplacer l’URL du point de terminaison Claude Platform on AWS. À utiliser pour les régions personnalisées ou lors du routage via une passerelle LLM. Par défaut `https://aws-external-anthropic.{AWS_REGION}.api.aws`
`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`	Remplacer le point de terminaison de l’API pour acheminer les requêtes via un proxy ou une passerelle. Lorsqu’elle est définie 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 v2.1.196, le Contrôle à distance 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`	Remplacer l’URL du point de terminaison Amazon Bedrock. À utiliser 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`	Remplacer l’URL du point de terminaison Amazon Bedrock Mantle. Voir Point de terminaison Mantle
`ANTHROPIC_BEDROCK_SERVICE_TIER`	Amazon Bedrock niveau de service (`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 participer à une bêta de l’API Anthropic avant que Claude Code n’ajoute la prise en charge native. Contrairement au drapeau `--betas`, qui nécessite l’authentification par clé API, cette variable fonctionne avec toutes les méthodes d’authentification, y compris l’abonnement Claude.ai
`ANTHROPIC_CUSTOM_HEADERS`	En-têtes personnalisés à ajouter aux requêtes (format `Name: Value`, séparés par des sauts de ligne pour plusieurs en-têtes)
`ANTHROPIC_CUSTOM_MODEL_OPTION`	ID de modèle à ajouter comme entrée personnalisée dans le sélecteur `/model`. Utilisez ceci pour rendre un modèle non standard ou spécifique à une passerelle sélectionnable sans remplacer les alias intégrés. Voir Configuration du modèle
`ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION`	Description d’affichage pour l’entrée de modèle personnalisé 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é dans le sélecteur `/model`. Par défaut l’ID du modèle lorsqu’il n’est pas défini
`ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_FABLE_MODEL`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_FABLE_MODEL_NAME`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_HAIKU_MODEL`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_OPUS_MODEL`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_OPUS_MODEL_NAME`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_SONNET_MODEL`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_SONNET_MODEL_NAME`	Voir Configuration du modèle
`ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES`	Voir Configuration du modèle
`ANTHROPIC_FOUNDRY_API_KEY`	Clé API pour l’authentification Microsoft Foundry (voir Microsoft Foundry)
`ANTHROPIC_FOUNDRY_AUTH_TOKEN`	Jeton Bearer pour l’authentification Microsoft Foundry, tel qu’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’identifiants par défaut Azure. Voir Microsoft Foundry. Nécessite Claude Code v2.1.203 ou ultérieur
`ANTHROPIC_FOUNDRY_BASE_URL`	URL de base complète pour la ressource Microsoft Foundry (par exemple, `https://my-resource.services.ai.azure.com/anthropic`). Alternative à `ANTHROPIC_FOUNDRY_RESOURCE` (voir Microsoft Foundry)
`ANTHROPIC_FOUNDRY_RESOURCE`	Nom de la 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_SMALL_FAST_MODEL`	[DÉPRÉCIÉ] Nom du modèle de classe Haiku pour les tâches en arrière-plan
`ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION`	Remplacer la région AWS pour le modèle de classe Haiku lors de l’utilisation d’Amazon Bedrock ou Amazon Bedrock Mantle. Sur Amazon Bedrock, cela ne prend effet que lorsque `ANTHROPIC_DEFAULT_HAIKU_MODEL` ou le `ANTHROPIC_SMALL_FAST_MODEL` déprécié est également défini, car Amazon Bedrock utilise autrement le modèle Sonnet par défaut ou le modèle principal pour les tâches en arrière-plan dans la région de session
`ANTHROPIC_VERTEX_BASE_URL`	Remplacer l’URL du point de terminaison Google Cloud’s Agent Platform. À utiliser pour les points de terminaison Google Cloud’s Agent Platform personnalisés ou lors du routage via une passerelle LLM. Voir Google Cloud’s Agent Platform
`ANTHROPIC_VERTEX_PROJECT_ID`	ID de projet GCP pour les requêtes Google Cloud’s Agent Platform. Remplacé par `GCLOUD_PROJECT`, `GOOGLE_CLOUD_PROJECT` ou le projet dans votre fichier d’identifiants `GOOGLE_APPLICATION_CREDENTIALS`. Voir Google Cloud’s Agent Platform
`ANTHROPIC_WORKSPACE_ID`	ID d’espace de travail pour 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 pour que l’échange de jetons sache quel espace de travail cibler
`API_FORCE_IDLE_TIMEOUT`	Remplacer le délai d’expiration d’inactivité 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. Définissez sur `1` pour maintenir le délai d’expiration sur chaque fournisseur. Lorsqu’il n’est pas défini, le délai d’expiration est inactif sur les connexions API Anthropic directes et Claude Platform on AWS, où le chien de garde de flux au niveau des octets de Claude Code s’exécute, et actif sur tous les autres fournisseurs, y compris Google Cloud’s Agent Platform, Microsoft Foundry, Mantle, Amazon Bedrock et les connexions de passerelle, de sorte qu’un flux bloqué s’interrompt au lieu de rester suspendu. À partir de v2.1.169
`API_TIMEOUT_MS`	Délai d’expiration pour les requêtes API en millisecondes (par défaut : 600 000, ou 10 minutes ; maximum : 2 147 483 647). 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épassent le minuteur sous-jacent et provoquent 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 : 120 000, ou 2 minutes)
`BASH_MAX_OUTPUT_LENGTH`	Nombre maximum de caractères dans les sorties bash avant que la sortie complète soit enregistrée dans un fichier et que Claude reçoive le chemin plus un court aperçu. Voir Comportement de l’outil Bash
`BASH_MAX_TIMEOUT_MS`	Délai d’expiration maximal que le modèle peut définir pour les commandes bash longues (par défaut : 600 000, ou 10 minutes)
`CCR_FORCE_BUNDLE`	Définissez sur `1` pour forcer `claude --cloud` à regrouper et télécharger votre référentiel local même lorsque l’accès à GitHub est disponible
`CLAUDECODE`	Défini sur `1` dans les sous-processus que Claude Code génère (outils Bash et PowerShell, sessions tmux, commandes hook, commandes de ligne d’état, sous-processus du serveur MCP stdio). Les extensions IDE définissent également ceci dans leurs terminaux intégrés. À utiliser pour détecter quand un script s’exécute à l’intérieur d’un sous-processus généré par Claude Code. Pour vérifier si le processus actuel a été généré directement par un appel d’outil ou un hook, plutôt qu’à l’intérieur d’un serveur MCP stdio que Claude Code a démarré, utilisez `CLAUDE_CODE_CHILD_SESSION` à la place
`CLAUDE_AFK_COUNTDOWN_MS`	Combien de millisecondes avant le compte à rebours d’auto-continuation apparaît sur un dialogue `AskUserQuestion` sans réponse. Par défaut `20000` (20 secondes), plafonné au délai d’expiration d’auto-continuation. N’a aucun effet sauf si l’auto-continuation est 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. L’auto-continuation est désactivée par défaut ; participez 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 l’auto-continuation même lorsque le paramètre n’est pas défini ou est `never`. La définition de `0` ne désactive pas le délai d’expiration ; elle ferme le dialogue immédiatement. Dans v2.1.198 et v2.1.199, l’auto-continuation é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 subagent intégrés tels que Explore et Plan. S’applique uniquement en mode non interactif (l’indicateur `-p`). Utile pour les utilisateurs du SDK qui veulent une ardoise vierge
`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 blocage en millisecondes pour les subagents en arrière-plan. Par défaut `600000` (10 minutes). Le minuteur se réinitialise à chaque événement de progression en continu ; si aucune progression n’arrive dans la fenêtre, le subagent est interrompu et la tâche est marquée comme échouée, exposant tout résultat partiel au parent
`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`	Définissez le pourcentage (1-100) de la fenêtre de compactage automatique auquel le compactage automatique se déclenche. Utilisez des valeurs plus basses comme `50` pour compacter plus tôt. Cette variable ne provoque un compactage plus précoce que lorsque Claude Code compacte de manière proactive : lorsque `CLAUDE_CODE_AUTO_COMPACT_WINDOW` est défini, dans les sessions cloud et sur Sonnet 4.6 et Opus 4.6 sans contexte étendu, qui compactent à la limite 200K par défaut. Sur Sonnet 5, le compactage proactif s’applique au seuil par défaut du modèle. Dans d’autres cas, comme une session locale sur Opus 4.8, le compactage automatique se déclenche lorsque la conversation atteint la limite de contexte du modèle. Le remplacement ne peut que réduire le seuil, de sorte que les valeurs au-dessus de la valeur par défaut n’ont aucun effet. S’applique aux conversations principales et aux subagents
`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 subagents sont déplacés en arrière-plan après environ deux minutes d’exécution
`CLAUDE_AX_SCREEN_READER`	Définissez sur `1` pour afficher une 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` prend la priorité. Nécessite Claude Code v2.1.181 ou ultérieur
`CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR`	Retourner au répertoire de travail d’origine après chaque commande Bash ou PowerShell dans la session principale
`CLAUDE_CLIENT_PRESENCE_FILE`	Chemin d’accès à un fichier qu’un outil externe, tel qu’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 du Contrôle à distance mobile, de sorte que vous cessez 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 de déclenchement 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 loupes 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 de 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 de mémoire
`CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT`	Définissez sur `1` pour repeindre l’écran entier à chaque image dans le rendu en plein écran au lieu d’envoyer des mises à jour incrémentielles. À utiliser si le mode plein écran affiche des fragments de texte obsolètes ou mal placés. Claude Code active ceci automatiquement pour les sessions en arrière-plan et la vue des agents 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. À utiliser 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 pour 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 le navigateur automatiquement lorsqu’un nouvel artifact est publié. La republication d’un artifact existant n’ouvre pas le navigateur indépendamment de ce paramètre
`CLAUDE_CODE_ATTRIBUTION_HEADER`	Définissez sur `0` pour omettre le bloc d’attribution (version client et empreinte digitale d’invite) du début de l’invite système. La désactiver améliore les taux de succès du cache d’invite lors du routage via une passerelle LLM. La mise en cache de l’API Anthropic n’est pas affectée
`CLAUDE_CODE_AUTO_COMPACT_WINDOW`	Définissez la capacité de contexte en tokens utilisée pour les calculs de compactage automatique. Par défaut, la fenêtre de contexte du modèle : 200 K pour les modèles standard ou 1 M pour les modèles de contexte étendu, sauf sur Sonnet 5, qui a son propre seuil par défaut. Utilisez une valeur inférieure comme `500000` sur un modèle 1 M pour traiter la fenêtre comme 500 K à des fins de compactage. La valeur est plafonnée à la fenêtre de contexte réelle du modèle. `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` est appliqué en pourcentage de cette valeur. La définition de cette variable découple le seuil de compactage du `used_percentage` de la ligne d’état, qui utilise toujours la fenêtre de contexte complète du modèle
`CLAUDE_CODE_AUTO_CONNECT_IDE`	Remplacer 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 masque le terminal parent. Prend la priorité sur le paramètre de configuration globale `autoConnectIde`
`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`	Temps en millisecondes que Claude Code attend pour que la chaîne de fournisseur d’identifiants par défaut AWS produise des identifiants avant que la requête échoue avec `AWS default-chain credential resolve timed out` (par défaut : `60000`). Augmentez-le lorsqu’une étape de votre chaîne a légitimement besoin de plus de temps, par exemple une connexion SSO basée sur un navigateur avec MFA via un wrapper comme `aws-vault`. S’applique partout où Claude Code signe avec la chaîne par défaut : Amazon Bedrock, Claude Platform on AWS et le point de terminaison Mantle. Nécessite Claude Code v2.1.207 ou ultérieur
`CLAUDE_CODE_BRIDGE_SESSION_ID`	Défini automatiquement dans les sous-processus de l’outil Bash et de la commande hook tandis que la session a une connexion Contrôle à distance 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, de sorte qu’un script peut créer un lien vers 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_CERT_STORE`	Liste séparée par des virgules de 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, en lecture seule 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. Par défaut `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 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, de sorte qu’il distingue de manière fiable une session imbriquée d’une `claude` de niveau supérieur lancée dans un terminal intégré IDE. Une `claude` TUI interactive imbriquée démarrée de cette manière est automatiquement exclue de `--resume`, `--continue`, l’historique de la flèche vers le haut et la liste `claude agents`. Les sessions non-interactives `claude -p` 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é (facultatif)
`CLAUDE_CODE_CONNECT_TIMEOUT_MS`	Supprimé dans v2.1.186 et maintenant un no-op. Auparavant, définissait un délai d’expiration distinct pour la phase de connexion, TLS et 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
`CLAUDE_CODE_DEBUG_LOGS_DIR`	Remplacer le chemin d’accès au fichier journal de débogage. Malgré le nom, il s’agit d’un chemin de fichier, pas d’un répertoire. Nécessite que le mode débogage soit activé séparément via `--debug`, `/debug` ou la variable d’environnement `DEBUG` : la définition de 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 la prise en charge de la fenêtre de contexte 1 M. Lorsqu’elle est définie, les variantes de modèle 1 M ne sont pas disponibles dans le sélecteur de modèle, et les sessions Sonnet 5 sont traitées comme ayant une fenêtre 200K. Utile pour les environnements d’entreprise avec des exigences de conformité
`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`. À partir de v2.1.111, n’a aucun effet sur Fable 5, Sonnet 5 ou Opus 4.7 et versions ultérieures, qui utilisent toujours le raisonnement adaptatif
`CLAUDE_CODE_DISABLE_ADVISOR_TOOL`	Définissez sur `1` pour désactiver l’outil advisor. La commande `/advisor` devient indisponible, tout `advisorModel` configuré est ignoré, et le drapeau `--advisor` est accepté mais n’a aucun effet, de sorte 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 en arrière-plan et la vue des agents : `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 en plein écran et utiliser le rendu classique de l’écran principal. La conversation reste dans le défilement natif de votre terminal pour 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 en arrière-plan ouvertes à partir de la vue des agents, qui utilisent toujours le rendu en 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. Équivalent au paramètre `disableArtifact`
`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 brut 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 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 toutes les fonctionnalités de tâche en arrière-plan, y compris le paramètre `run_in_background` sur les outils Bash et subagent, l’arrière-plan automatique et le raccourci Ctrl+B
`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD`	Définissez sur `1` pour ignorer la vérification qu’une réponse de streaming Amazon Bedrock porte le type de contenu `application/vnd.amazon.eventstream`. Sans cette variable, une réponse avec un type de contenu différent échoue avec une erreur nommant ce type de contenu, ce qui signifie qu’une passerelle ou un proxy transforme la réponse. Définissez-le uniquement lorsque la passerelle réécrit l’en-tête `Content-Type` mais transmet le corps du flux d’événements binaires inchangé ; si le corps lui-même a été transformé, les requêtes échouent avec `Truncated event message received` à la place. 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 en arrière-plan en cours d’exécution, les workflows dynamiques, et, à partir de v2.1.198, les subagents en arrière-plan d’une session en arrière-plan lorsque le superviseur arrête, redémarre ou met à jour le processus de cette session, au lieu de les transmettre au processus suivant de la session. Affecte uniquement cette transmission : la mise en arrière-plan d’une session avec `←` ou `/background` porte toujours le travail en cours, 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 arrêter Claude Code de terminer les commandes shell en 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 en 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 subagent n’est en cours d’exécution. Windows n’a pas de signal de pression mémoire, de sorte que 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 skills et workflows qui sont fournis avec Claude Code : les skills groupés et les workflows intégrés sont supprimés entièrement, tandis que les commandes slash 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 skills des plugins, `.claude/skills/` et `.claude/commands/` ne sont pas affectés. Équivalent au paramètre `disableBundledSkills` ; `0` ne le remplace pas
`CLAUDE_CODE_DISABLE_CLAUDE_MDS`	Définissez sur `1` pour empêcher le chargement de tous les fichiers de mémoire CLAUDE.md dans le contexte, y compris les fichiers utilisateur, projet et mémoire automatique
`CLAUDE_CODE_DISABLE_CRON`	Définissez sur `1` pour désactiver les tâches planifiées. Le skill `/loop` et les outils cron deviennent indisponibles et toutes les tâches déjà planifiées cessent de se déclencher, y compris les tâches qui s’exécutent déjà en milieu de session
`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`	Définissez 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 (tels que `defer_loading` et `eager_input_streaming`) des requêtes API. Utilisez ceci lorsqu’une passerelle proxy rejette les requêtes avec des erreurs comme « Unexpected value(s) for the `anthropic-beta` header » ou « Extra inputs are not permitted ». Les champs standard (`name`, `description`, `input_schema`, `cache_control`) sont conservés. La recherche d’outils MCP est désactivée et tous les outils MCP se chargent en amont, même lorsque `ENABLE_TOOL_SEARCH` est défini
`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS`	Définissez sur `1` pour désactiver les subagents Explore et Plan intégrés. Claude explore avec ses outils de recherche ou le subagent à 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 subagents personnalisés nommés `Explore` ou `Plan` ne sont pas affectés. Pour supprimer tous les types de subagent 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 « Comment Claude se débrouille-t-il ? ». Les sondages sont également désactivés lorsque `DISABLE_TELEMETRY`, `DO_NOT_TRACK` ou `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` est défini, sauf si `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` participe à nouveau. 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 checkpointing de fichier. La commande `/rewind` ne pourra pas restaurer les modifications de code
`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é du statut git de l’invite système de Claude. Utile lors de l’utilisation de vos propres skills 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. À utiliser lorsque vous souhaitez intentionnellement épingler une version plus ancienne du modèle. 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 dans le rendu en plein écran. Le défilement au clavier avec `PgUp` et `PgDn` fonctionne toujours. Utilisez ceci pour conserver le comportement natif de copie à la sélection de votre terminal
`CLAUDE_CODE_DISABLE_MOUSE_CLICKS`	Définissez sur `1` pour désactiver le clic, le glissement et le survol dans le rendu en plein écran tout en conservant le défilement à la molette de la souris. À utiliser lorsque vous souhaitez que le défilement à la molette fonctionne à l’intérieur de Claude Code mais que vous ne souhaitez pas que les clics positionnent le curseur, développent la sortie d’outil ou ouvrent des liens. `CLAUDE_CODE_DISABLE_MOUSE` prend la priorité lorsque les deux sont définis. Nécessite Claude Code v2.1.195 ou ultérieur
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`	Équivalent de la définition de `DISABLE_AUTOUPDATER`, `DISABLE_FEEDBACK_COMMAND`, `DISABLE_ERROR_REPORTING` et `DISABLE_TELEMETRY`
`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`	Définissez sur `1` pour désactiver le secours non-streaming lorsqu’une requête streaming échoue en milieu de flux. Les erreurs de streaming se propagent à la couche de nouvelle tentative à la place. Utile lorsqu’un proxy ou une passerelle provoque le secours pour produire l’exécution d’outils en double
`CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK`	Définissez sur `1` pour envoyer la notification de bureau de l’outil `PushNotification` même lorsque vous tapez dans ou êtes concentré sur le terminal. Par défaut, l’outil ignore à la fois la notification de bureau et le push mobile lorsqu’il détecte une activité clavier récente ou une concentration sur le terminal. Cette variable désactive uniquement cette vérification locale, de sorte que le serveur peut 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 ignorer l’ajout automatique de la place de marché officielle des plugins au premier lancement
`CLAUDE_CODE_DISABLE_POLICY_SKILLS`	Définissez sur `1` pour ignorer le chargement des skills à partir du répertoire des skills gérés au niveau du système. Utile pour les sessions de conteneur ou CI qui ne doivent pas charger les skills fournis 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. En mode Agent SDK et sessions `claude -p`, cela ignore également la requête Haiku en arrière-plan qui génère le titre de la session
`CLAUDE_CODE_DISABLE_THINKING`	Définissez sur `1` pour omettre complètement le paramètre `thinking` des requêtes API. Il s’agit d’une option de compatibilité pour les proxies et les passerelles qui rejettent le paramètre. Le comportement de la variable est inchangé par rapport aux versions antérieures ; sur les modèles qui pensent par défaut, l’omission du paramètre signifie que le modèle peut toujours penser. Pour désactiver explicitement la réflexion étendue sur l’API Anthropic, utilisez `MAX_THINKING_TOKENS=0` à la place, ce qui est également inefficace sur Fable 5 car il ne peut pas avoir la réflexion désactivée. Sur les fournisseurs tiers, `0` omet également le paramètre, de sorte que les deux variables se comportent de la même manière là-bas
`CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`	Définissez sur `1` pour désactiver le défilement virtuel dans le rendu en plein écran et afficher chaque message dans la transcription. Utilisez ceci si le défilement en mode plein écran affiche des régions vierges où les messages devraient apparaître
`CLAUDE_CODE_DISABLE_WORKFLOWS`	Définissez sur `1` pour désactiver les workflows. Équivalent au paramètre `disableWorkflows`
`CLAUDE_CODE_EFFORT_LEVEL`	Définissez le niveau d’effort pour les modèles pris en charge. Valeurs : `low`, `medium`, `high`, `xhigh`, `max` ou `auto` pour utiliser le niveau par défaut du modèle. Les niveaux disponibles dépendent du modèle. Prend la priorité sur `/effort` et le paramètre `effortLevel`. Voir Ajuster le niveau d’effort
`CLAUDE_CODE_ENABLE_APPEND_SUBAGENT_PROMPT`	Définissez sur `1` pour activer l’ajout de texte supplémentaire à la fin de l’invite système de chaque subagent. Le drapeau `--append-subagent-system-prompt` fournit le texte ajouté et définit cette variable automatiquement, de sorte que vous n’ayez pas besoin de la définir vous-même. Nécessite Claude Code v2.1.205 ou ultérieur
`CLAUDE_CODE_ENABLE_AUTO_MODE`	Accepté pour la compatibilité avec les versions antérieures et n’a aucun effet. Le mode auto est disponible par défaut sur chaque fournisseur, y compris Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry et les sessions passerelle d’applications Claude signées. Dans v2.1.158 à v2.1.206, la définition de ceci sur `1` était requise pour rendre le mode auto disponible sur ces fournisseurs
`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`	Remplacer la disponibilité du récapitulatif de session. Définissez sur `0` pour forcer les récapitulatifs désactivés indépendamment du bouton bascule `/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 bouton bascule `/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 en arrière-plan. Désactivé par défaut car l’actualisation modifie l’invite système en milieu de session, ce qui invalide la mise en cache des invites pour ce tour
`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL`	Définissez sur `1` pour acheminer le sondage de qualité de session « Comment Claude se débrouille-t-il ? » vers votre propre collecteur OpenTelemetry lorsque le trafic non essentiel lié à Anthropic est bloqué. Les évaluations du sondage sont émises uniquement en tant qu’événements OTEL vers votre collecteur configuré. Aucune donnée de sondage n’est envoyée à Anthropic dans ce mode. S’applique lorsque `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`, `DISABLE_TELEMETRY` ou `DO_NOT_TRACK` est défini, et n’a aucun effet autrement. `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` et la politique de rétroaction produit 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 en continu depuis l’API au fur et à mesure que Claude les génère. Avec ceci désactivé, une grande entrée d’outil telle qu’une longue écriture de fichier n’arrive qu’après que Claude ait terminé de la générer, ce qui peut sembler qu’il se bloque. Activé par défaut sur l’API Anthropic. Sur Amazon Bedrock et Google Cloud’s Agent Platform, activé par modèle où le conteneur déployé le prend en charge. 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 gateway
`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 telle que 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 la 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 le mode rapide par défaut a changé d’Opus 4.6 à Opus 4.7
`CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`	Définissez sur `false` pour désactiver les suggestions d’invite (le bouton bascule « Suggestions d’invite » dans `/config`). Ce sont les prédictions grisées qui apparaissent dans votre entrée d’invite après que Claude répond. Voir Suggestions d’invite
`CLAUDE_CODE_ENABLE_TASKS`	Contrôle si les sessions utilisent les outils Task structurés (`TaskCreate`, `TaskUpdate`, `TaskGet`, `TaskList`) ou l’outil `TodoWrite` hérité. À partir de Claude Code v2.1.142, les outils Task sont le défaut dans tous les modes. Définissez sur `0` pour revenir à `TodoWrite`. Voir Liste des tâches et Migrer vers les outils Task
`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_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 dans le niveau supérieur de chaque corps de requête API. Utile pour transmettre des 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 en arrière-plan que vous distribuez avec `claude agents` ou `--bg`. Avant v2.1.206, les sessions en arrière-plan ignoraient une valeur exportée par shell et utilisaient la copie que le processus superviseur en arrière-plan avait héritée
`CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS`	Remplacer la limite de tokens par défaut pour les lectures de fichiers. Utile lorsque vous devez lire des fichiers plus volumineux en intégralité
`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE`	Définissez sur `1` pour forcer la persistance de la transcription, l’historique des invites et l’enregistrement `claude agents` même lorsque ce `claude` a été lancé de l’intérieur d’une autre session Claude Code. À utiliser lorsqu’une valeur `CLAUDE_CODE_CHILD_SESSION` héritée, par exemple d’une session tmux d’abord démarrée par l’outil Bash de Claude Code, provoque la mauvaise classification d’une session de niveau supérieur comme imbriquée. À partir de v2.1.178, Claude Code détecte automatiquement le cas tmux et ignore le marqueur hérité, de sorte que tmux n’a 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 prend en charge 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 synchronized output lorsque votre terminal le prend en charge mais n’est pas détecté automatiquement. Utile pour les émulateurs tels que Emacs `eat` 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 en plein écran, cela ne change pas le rendu
`CLAUDE_CODE_FORK_SUBAGENT`	Définissez sur `1` pour permettre à Claude de générer des subagents forked, ou `0` pour les désactiver, remplaçant tout déploiement côté serveur. Lorsqu’elle est activée, Claude peut demander le type de subagent `fork` pour générer un fork, un subagent qui hérite du contexte de conversation complet au lieu de commencer à zéro. Les spawns sans type de subagent utilisent toujours le subagent à usage général, et tous les spawns de subagent s’exécutent en arrière-plan. La commande `/fork` explicite fonctionne sans cette variable. Fonctionne en mode interactif et via le SDK ou `claude -p`
`CLAUDE_CODE_GIT_BASH_PATH`	Windows uniquement : chemin d’accès à l’exécutable Git Bash (`bash.exe`). À utiliser lorsque Git Bash est installé mais pas dans votre PATH. Voir Configuration Windows
`CLAUDE_CODE_GLOB_HIDDEN`	Définissez sur `false` pour exclure les fichiers pointés des résultats lorsque Claude appelle 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 respecter à l’outil Glob les modèles `.gitignore`. Par défaut, Glob retourne tous les fichiers correspondants, y compris ceux ignorés par git. 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_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`	Remplacer 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. À utiliser lorsque la connexion automatique ne trouve pas votre IDE malgré son exécution
`CLAUDE_CODE_MAX_CONTEXT_TOKENS`	Remplacer la taille de la fenêtre de contexte que Claude Code suppose pour le modèle actif. À partir de v2.1.193, appliqué directement pour les noms de modèles que Claude Code ne reconnaît pas comme un modèle Claude ; pour les modèles Claude reconnus, il ne prend effet que lorsque `DISABLE_COMPACT` est également défini. À utiliser lors du routage vers un modèle via `ANTHROPIC_BASE_URL` dont la fenêtre de contexte ne correspond pas à la taille intégrée pour son nom
`CLAUDE_CODE_MAX_OUTPUT_TOKENS`	Définissez le nombre maximal de tokens de sortie pour la plupart des requêtes. Les valeurs par défaut et les plafonds varient selon le modèle ; voir max output tokens. L’augmentation de cette valeur réduit la fenêtre de contexte effective disponible avant que le compactage automatique ne se déclenche
`CLAUDE_CODE_MAX_RETRIES`	Remplacer le nombre de fois pour réessayer les requêtes API échouées (par défaut : 10). Plafonné à 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_TOOL_USE_CONCURRENCY`	Nombre maximal d’outils en lecture seule et de subagents 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`	Plafonner le nombre de tours d’agent lorsqu’aucune limite explicite n’est transmise. Équivalent à la transmission de `--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_MCP_ALLOWLIST_ENV`	Définissez sur `1` pour générer les serveurs MCP stdio avec uniquement un environnement de base sûr plus l’`env` configuré du serveur, au lieu d’hériter de votre environnement shell
`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 s’interrompt avec une erreur au lieu d’attendre le `MCP_TOOL_TIMEOUT` mural. Remplace les délais d’expiration par défaut par transport de 300 000 (5 minutes) pour les serveurs réseau et 1 800 000 (30 minutes) pour les serveurs stdio. Définissez sur `0` pour désactiver la vérification d’inactivité. Les valeurs inférieures à 1 000 sont augmentées à une seconde, et la valeur est plafonnée au `MCP_TOOL_TIMEOUT` effectif. Un `timeout` par serveur dans `.mcp.json` d’au moins 1 000 augmente la fenêtre d’inactivité de ce serveur à au moins la valeur `timeout`. Cela nécessite Claude Code v2.1.203 ou ultérieur. Ne s’applique pas aux serveurs IDE ou SDK en processus. 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_NATIVE_CURSOR`	Définissez sur `1` pour afficher le curseur propre du terminal au curseur d’entrée au lieu d’un bloc dessiné. Le curseur respecte les paramètres de clignotement, de forme et de focus du terminal
`CLAUDE_CODE_NEW_INIT`	Définissez sur `1` pour faire exécuter `/init` un flux de configuration interactif. Le flux demande quels fichiers générer, y compris CLAUDE.md, skills et hooks, avant d’explorer la base de code et de les écrire. Sans cette variable, `/init` génère un CLAUDE.md automatiquement sans demander
`CLAUDE_CODE_NO_FLICKER`	Définissez sur `1` pour activer le rendu en plein écran, un aperçu de recherche qui réduit le scintillement et maintient la mémoire plate dans les longues conversations. Équivalent au 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, telles que `"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`
`CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE`	Supprimé dans v2.1.160 et maintenant un no-op. Auparavant épinglé le mode rapide à Claude Opus 4.6 au lieu du défaut actuel. Opus 4.6 ne prend plus en charge le mode rapide
`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 qu’avec `--debug`, de sorte qu’un exportateur mal configuré tel qu’une collision de port Prometheus échoue silencieusement autrement. Nécessite Claude Code v2.1.179 ou ultérieur. Voir Surveillance
`CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS`	Délai d’expiration en millisecondes pour vider les spans OpenTelemetry en attente (par défaut : 5 000). Voir Surveillance
`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`	Intervalle pour actualiser les en-têtes OpenTelemetry dynamiques en millisecondes (par défaut : 1 740 000 / 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 : 2 000). 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 packages en arrière-plan lorsqu’une nouvelle version est disponible. S’applique aux installations Homebrew et WinGet. Les autres gestionnaires de packages continuent à 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 propriétaire-écriture, 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`	Remplacer le répertoire racine des plugins. Malgré le nom, ceci définit le répertoire parent, pas le cache lui-même : les places de marché et le cache des plugins se trouvent dans des sous-répertoires sous ce chemin. Par défaut `~/.claude/plugins`
`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`	Délai d’expiration en millisecondes pour les opérations git lors de l’installation ou de la mise à jour des plugins (par défaut : 120 000). 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 conserver le cache de la place de marché existante lorsqu’un `git pull` échoue au lieu de l’effacer et de le re-cloner. 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 plugin 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 seed 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é-mis en cache sans re-cloner. Voir Pré-remplir les plugins pour les conteneurs
`CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY`	Définissez sur `1` pour arrêter Claude Code de passer `-ExecutionPolicy Bypass` lors du lancement de PowerShell pour les appels d’outils, les hooks 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 au niveau du processus pour que les scripts `.ps1` et les importations de modules fonctionnent sur les installations Windows par défaut avec Restricted. Le contournement au niveau du processus ne remplace jamais la `MachinePolicy` ou `UserPolicy` de Group Policy indépendamment de ce paramètre
`CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS`	Temps maximal en millisecondes que le mode non interactif avec l’indicateur `-p` attend après le tour final pour les subagents en arrière-plan et les workflows dont le résultat fait partie de la sortie. Par défaut : `600000`, ou 10 minutes. Lorsque le plafond est dépassé, les tâches en arrière-plan restantes sont terminées et le processus se termine. Définissez sur `0` pour attendre indéfiniment. Ce plafond est distinct de la période de grâce de cinq secondes qui s’applique aux shells en arrière-plan simples
`CLAUDE_CODE_PROCESS_WRAPPER`	Lancez les processus que Claude Code démarre à partir de son propre binaire via un wrapper exécutable, donné comme préfixe argv tel que `/opt/corp/launcher`. Couvre le service en arrière-plan qui héberge les sessions de vue des agents, chaque session qu’il génère et le relancement que Claude Code effectue de lui-même pour terminer l’installation d’une mise à jour. Le premier jeton doit être le chemin absolu d’un exécutable qui se termine en exécutant `exec "$@"`, et la plupart des lanceurs sont ce chemin unique. La valeur est une liste d’arguments, pas une commande shell : l’espace blanc sépare les jetons, les guillemets doubles regroupent un chemin qui contient des espaces, et une valeur qui commence par `[` est lue comme un tableau de chaînes JSON. Définissez-le dans le bloc `env` des paramètres utilisateur ou gérés, pas comme une exportation shell, pour que le service en arrière-plan détaché l’hérite ; les paramètres de projet et locaux ne peuvent pas le définir. L’extension VS Code configure son propre lanceur séparément via son paramètre `claudeProcessWrapper`. Ignoré sur Windows. `CLAUDE_CODE_SHELL_PREFIX` est un contrôle distinct : il enveloppe les commandes shell que Claude Code exécute en tant que chaîne unique entre guillemets, tandis que cette variable enveloppe les propres processus de Claude Code en tant que préfixe argv. Voir Exécuter Claude Code derrière un lanceur d’entreprise
`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 lors de la connexion directe à l’API Anthropic. Ajouté dans v2.1.152. Voir Traces (bêta)
`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`	Défini par les plates-formes hôtes qui intègrent Claude Code et gèrent le routage du fournisseur de modèles en son nom. Lorsqu’elle est définie, la sélection du fournisseur, le point de terminaison et les variables d’authentification telles que `CLAUDE_CODE_USE_BEDROCK`, `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY` dans les fichiers de paramètres sont ignorés pour que les paramètres utilisateur ne puissent pas remplacer le routage de l’hôte. L’opt-out automatique de la télémétrie pour Amazon Bedrock, Google Cloud’s Agent Platform et Microsoft Foundry est également ignoré, de sorte que la télémétrie suit 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 hook ou d’un script de configuration pour détecter si vous êtes dans un environnement cloud
`CLAUDE_CODE_REMOTE_SESSION_ID`	Défini automatiquement dans les sessions cloud à l’ID de session actuel. Lisez ceci pour construire un lien vers la transcription de session. Voir Lier la sortie à la session
`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`	Définissez sur `1` pour reprendre automatiquement si la session précédente s’est terminée en milieu de tour. Utilisé en mode SDK pour que le modèle continue sans que le SDK ait besoin de renvoyer l’invite
`CLAUDE_CODE_RESUME_PROMPT`	Remplacer le message de continuation injecté lors de la reprise d’une session qui s’est terminée en milieu de tour. Par défaut `Continue from where you left off.`. Les scripts de génération pour les agents longues 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. 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 délai de réinitialisation du débit, de sorte qu’une session qui atteint une limite d’utilisation attend la fenêtre restante. À partir de v2.1.199, 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, skills, plugins, hooks, serveurs MCP, commandes personnalisées et agents, styles de sortie, workflows, thèmes personnalisés, liaisons de touches personnalisées, commandes de ligne d’état et de suggestion de fichiers, serveurs LSP et mémoire automatique ne se chargent pas, pour dépanner une configuration cassée. La politique des paramètres gérés s’applique toujours, y compris les hooks configurés par la politique, la ligne d’état et les commandes de suggestion de fichiers ; les plugins gérés, les skills gérés, 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 appelé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’appels entiers. 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, donc les astuces d’expansion de shell comme `./scripts/deploy.sh $(evil)` comptent toujours contre le plafond. L’expansion en fan-out au runtime via `xargs` ou `find -exec` n’est pas détectée ; il s’agit d’un contrôle de défense en profondeur
`CLAUDE_CODE_SCROLL_SPEED`	Définissez le multiplicateur de défilement de la molette de la souris dans le rendu en plein écran. Accepte les valeurs de 1 à 20, et les valeurs fractionnaires inférieures à 1 telles que `0.5` pour ralentir le défilement accéléré du trackpad et de la molette dans les terminaux qui amplifient déjà les événements de molette. Définissez 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_SESSIONEND_HOOKS_TIMEOUT_MS`	Remplacer le budget de temps en millisecondes pour les hooks SessionEnd. S’applique à la sortie de session, `/clear` et au changement de sessions via `/resume` interactif. Par défaut, le budget est de 1,5 secondes, automatiquement augmenté au `timeout` par hook le plus élevé configuré dans les fichiers de paramètres, jusqu’à 60 secondes. Les délais d’expiration sur les hooks fournis par les plugins ne relèvent pas du budget
`CLAUDE_CODE_SESSION_ID`	Défini automatiquement dans les sous-processus des outils Bash et PowerShell, les sous-processus des commandes hook et les sous-processus du serveur MCP stdio à l’ID de session actuel. Pour Bash, PowerShell et hooks, cela correspond au champ `session_id` dans l’entrée JSON du hook et est mis à jour sur `/clear`. Un sous-processus du serveur MCP conserve l’ID avec lequel il a été généré. Sur `--resume <session-id>` il reçoit l’ID repris, correspondant aux hooks et Bash. Sur `--continue` ou `--resume` sans ID explicite, il peut recevoir l’ID de démarrage initial à la place. À utiliser pour corréler les scripts et les outils externes avec la session Claude Code qui les a lancés
`CLAUDE_CODE_SHELL`	Définir le shell que Claude Code utilise pour exécuter les commandes de l’outil Bash. Accepte un chemin vers un binaire `bash` ou `zsh`, par exemple `/opt/homebrew/bin/bash`. Les autres shells tels que `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 pour envelopper les commandes shell que Claude Code génère : appels d’outil Bash, commandes hook, commandes de ligne d’état et commandes de démarrage du serveur MCP stdio. Les hooks PowerShell et les hooks de forme exec s’exécutent sans le préfixe. Utile pour la journalisation ou l’audit. La définition d’un chemin d’exécutable nu tel que `/path/to/logger.sh` exécute chaque commande en tant que `/path/to/logger.sh '<command>'`. Le wrapper reçoit la ligne de commande en tant qu’argument shell-quoted unique dans `$1`, de sorte 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 passent des arguments tels que `npx -y <package>`. Pour les appels d’outil Bash, `$1` contient l’invocation shell complète que Claude Code assemble, y compris la configuration de l’environnement, pas seulement la commande que Claude a exécutée
`CLAUDE_CODE_SIMPLE`	Définissez sur `1` pour exécuter avec une invite système minimale et uniquement les outils Bash, lecture de fichier et édition de fichier. Les outils MCP de `--mcp-config` sont toujours disponibles. Désactive la découverte automatique des hooks, skills, plugins, serveurs MCP, mémoire automatique et CLAUDE.md. Les jetons OAuth et les identifiants du trousseau ne sont pas lus, donc 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 une invite système plus courte 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, les hooks, les serveurs MCP et la découverte 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 de fournisseur d’identifiants par défaut AWS, de sorte 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_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 invites 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 scriptées é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_STOP_HOOK_BLOCK_CAP`	Nombre maximal de fois consécutives qu’un hook Stop ou SubagentStop peut bloquer la fin du tour avant que Claude Code le remplace et termine le tour de toute façon (par défaut : 8). Définissez sur `0` pour désactiver le plafond. Augmentez ceci si votre hook a légitimement besoin de plus d’itérations pour se résoudre
`CLAUDE_CODE_SUBAGENT_MODEL`	Voir Configuration du modèle. À partir de v2.1.196, la définir sur `inherit` est la même que de la laisser non définie ; les versions antérieures traitaient `inherit` comme un remplacement qui forçait chaque subagent sur le modèle de la conversation principale
`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`	Définissez sur `1` pour supprimer les identifiants Anthropic et des fournisseurs de cloud des environnements de sous-processus (outil Bash, hooks, serveurs MCP stdio). Le processus Claude parent conserve 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 du shell. Sur Linux, cela exécute également les sous-processus Bash dans un espace de noms PID isolé pour qu’ils ne puissent pas lire les environnements de processus hôte via `/proc` ; en conséquence, `ps`, `pgrep` et `kill` ne peuvent pas voir ou signaler les processus hôte. `claude-code-action` définit ceci automatiquement lorsque `allowed_non_write_users` est configuré
`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`	Définissez sur `1` en mode non interactif (l’indicateur `-p`) pour attendre que l’installation du plugin se termine 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 des plugins. Lorsqu’il est dépassé, Claude Code continue sans plugins et enregistre une erreur. Pas de défaut : sans cette variable, l’installation synchrone attend jusqu’à la fin
`CLAUDE_CODE_SYNC_SKILLS`	Définissez sur `1` pour télécharger vos skills claude.ai activés dans `~/.claude/skills/` avant la première requête et resynchroniser toutes les 10 minutes. S’applique uniquement en mode non interactif avec l’indicateur `-p`. Nécessite l’authentification claude.ai. Les sessions Claude Code on the web reçoivent vos skills claude.ai activés automatiquement ; vous n’avez pas besoin de définir ceci là-bas
`CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS`	Délai d’expiration en millisecondes pour une resynchronisation des skills en milieu de session lorsque `CLAUDE_CODE_SYNC_SKILLS` est défini (par défaut : 30 000). Limite le téléchargement déclenché lorsque l’hôte demande un rechargement des skills pendant la session. Lorsqu’il est dépassé, la resynchronisation s’arrête et les téléchargements restants continuent en arrière-plan
`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS`	Délai d’expiration en millisecondes pour que la première requête attende la synchronisation initiale des skills lorsque `CLAUDE_CODE_SYNC_SKILLS` est défini (par défaut : 5 000). Lorsqu’il est dépassé, la requête continue et les téléchargements de skills restants continuent en arrière-plan
`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`	Partager une liste de tâches entre les sessions. Définissez le même ID dans plusieurs instances de Claude Code pour coordonner une liste de tâches partagée. Voir Liste des tâches
`CLAUDE_CODE_TEAM_NAME`	Nom de l’équipe d’agents à laquelle appartient ce coéquipier. Défini automatiquement sur les membres de l’équipe d’agents
`CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS`	Remplacer, en millisecondes, combien de temps une session non-interactive attend à la sortie pour que son équipe d’agents termine le démontage. Accepte 1 000 à 60 000 ; une valeur hors plage est ignorée et la valeur par défaut de 10 000 s’applique. Nécessite Claude Code v2.1.206 ou ultérieur
`CLAUDE_CODE_TMPDIR`	Remplacer 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. À partir de v2.1.161, 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 de Claude Code utilisent toujours votre remplacement
`CLAUDE_CODE_TMUX_TRUECOLOR`	Définissez sur `1` pour permettre la sortie truecolor 24 bits à l’intérieur de tmux. Par défaut, Claude Code limite à 256 couleurs lorsque `$TMUX` est défini car tmux ne transmet pas les séquences d’échappement truecolor à moins d’être configuré. Définissez ceci après avoir ajouté `set -ga terminal-overrides ',*:Tc'` à votre `~/.tmux.conf`. Voir Configuration du terminal pour d’autres paramètres tmux
`CLAUDE_CODE_USE_ANTHROPIC_AWS`	Utiliser Claude Platform on AWS
`CLAUDE_CODE_USE_BEDROCK`	Utiliser Amazon Bedrock
`CLAUDE_CODE_USE_FOUNDRY`	Utiliser Microsoft Foundry
`CLAUDE_CODE_USE_MANTLE`	Utiliser 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 subagents et les styles de sortie à l’aide des API de fichiers Node.js au lieu de ripgrep. Définissez ceci si le binaire ripgrep fourni 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 se déploie progressivement : définissez sur `1` pour participer ou `0` pour refuser. 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 acheminer via Git Bash. Voir Outil PowerShell
`CLAUDE_CODE_USE_VERTEX`	Utiliser Google Cloud’s Agent Platform
`CLAUDE_CONFIG_DIR`	Remplacer le répertoire de configuration (par défaut : `~/.claude`). Tous les paramètres, identifiants, historique de session et plugins sont stockés sous ce chemin. Utile pour exécuter plusieurs comptes côte à côte : par exemple, `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`
`CLAUDE_DISABLE_ADOPT`	Définissez sur `1` pour arrêter le travail en arrière-plan en cours au lieu de le transporter lorsque vous mettez une session en arrière-plan en appuyant sur `←` ou avec `/background`. Claude Code vous demande de confirmer avant la mise en arrière-plan, puis arrête les tâches qui seraient autrement transportées. Nécessite Claude Code v2.1.195 ou ultérieur
`CLAUDE_EFFORT`	Défini automatiquement dans les sous-processus des outils Bash et les commandes hook au niveau d’effort actif pour le tour : `low`, `medium`, `high`, `xhigh` ou `max`. Ultracode n’est pas un niveau distinct et rapporte comme `xhigh`. Correspond au champ `effort.level` passé aux hooks. Défini uniquement lorsque le modèle actuel prend en charge le paramètre d’effort
`CLAUDE_ENABLE_BYTE_WATCHDOG`	Définissez sur `1` pour forcer l’activation du chien de garde d’inactivité au niveau des octets, ou définissez sur `0` pour forcer la désactivation. 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. Le chien de garde d’octets abandonne une connexion lorsqu’aucun octet n’arrive sur le fil pendant 180 secondes par défaut sur les connexions API Anthropic directes, 300 secondes sur Claude Platform on AWS et lorsqu’il est activé sur Amazon Bedrock, ou pour la valeur de `CLAUDE_STREAM_IDLE_TIMEOUT_MS` lorsqu’elle est définie, qui est limitée à un minimum de 5 minutes, indépendamment du chien de garde au niveau des événements
`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK`	Définissez sur `1` pour activer le chien de garde d’inactivité de streaming au niveau des octets sur les réponses Amazon Bedrock `vnd.amazon.eventstream`. 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-désactiver le chien de garde d’inactivité de streaming au niveau des événements, ou définissez sur `1` pour 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. À partir de v2.1.169, les fournisseurs autres que l’API Anthropic directe et Claude Platform on AWS ont également un délai d’expiration d’inactivité du corps de 5 minutes par défaut indépendant de cette variable ; voir `API_FORCE_IDLE_TIMEOUT`. Sur Amazon Bedrock, vous pouvez également activer le chien de garde indépendant au niveau des octets avec `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` ; les deux s’exécutent ensemble lorsque les deux sont définis. Configurez le délai d’expiration avec `CLAUDE_STREAM_IDLE_TIMEOUT_MS`
`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, de sorte que les exports du fichier sont visibles pour la commande. À utiliser pour persister l’activation de virtualenv ou conda entre les commandes. Également rempli dynamiquement par les hooks SessionStart, Setup, CwdChanged et FileChanged
`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX`	Préfixe pour les noms de session Contrôle à distance 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_IDLE_TIMEOUT_MS`	Délai d’expiration en millisecondes avant que le chien de garde d’inactivité de streaming ferme une connexion bloquée. Lorsque vous définissez cette variable explicitement, le minimum est `300000` (5 minutes) ; les valeurs inférieures sont silencieusement limitées pour absorber les pauses de réflexion étendue et la mise en mémoire tampon du proxy. Lorsqu’il n’est pas défini, le chien de garde au niveau des événements par défaut à 300 secondes et le chien de garde au niveau des octets par défaut à 180 secondes sur les connexions API Anthropic directes (300 secondes sur Claude Platform on AWS et les autres fournisseurs). La valeur par défaut non définie de 180 secondes du chien de garde au niveau des octets est une valeur distincte et n’est pas soumise à la limite de 5 minutes. Le délai d’expiration d’inactivité du corps décrit sous `API_FORCE_IDLE_TIMEOUT` s’applique indépendamment. Sur Amazon Bedrock, s’applique également lorsque `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1`
`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 véridiques `1`, `true`, `yes` et `on` activent le mode débogage, donc 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 en 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 le compactage automatique lorsque vous approchez de la limite de contexte. La commande manuelle `/compact` reste disponible. À utiliser lorsque vous souhaitez un contrôle explicite sur le moment du compactage
`DISABLE_COMPACT`	Définissez sur `1` pour désactiver tout compactage : à la fois le compactage 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 commande `/doctor` et son alias `/checkup`. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter les diagnostics d’installation à partir d’une session. N’affecte pas la commande du terminal `claude doctor`. Avant v2.1.205, cette variable masquait l’écran de diagnostics `/doctor`
`DISABLE_ERROR_REPORTING`	Définissez sur `1` pour refuser la création de rapports d’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`. Le nom plus ancien `DISABLE_BUG_COMMAND` est également accepté
`DISABLE_GROWTHBOOK`	Définissez sur `1` pour désactiver la récupération des drapeaux de fonctionnalités GrowthBook et utiliser les valeurs par défaut du code pour chaque drapeau. 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. À utiliser uniquement lors de la gestion manuelle de 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 prend pas en charge 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 des invites 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 des invites pour les modèles Fable
`DISABLE_PROMPT_CACHING_HAIKU`	Définissez sur `1` pour désactiver la mise en cache des invites pour les modèles Haiku
`DISABLE_PROMPT_CACHING_OPUS`	Définissez sur `1` pour désactiver la mise en cache des invites pour les modèles Opus
`DISABLE_PROMPT_CACHING_SONNET`	Définissez sur `1` pour désactiver la mise en cache des invites pour les modèles Sonnet
`DISABLE_TELEMETRY`	Définissez sur `1` pour refuser 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és avec le même effet que `DISABLE_GROWTHBOOK`, de sorte que certaines fonctionnalités signalées peuvent ne pas être disponibles
`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`. À utiliser lors de la distribution de Claude Code via vos propres canaux et les utilisateurs ne doivent pas se mettre à jour automatiquement
`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. Équivalent à la définition de `DISABLE_TELEMETRY`. Claude Code honore ceci en tant que convention standard inter-outils reconnue par de nombreux CLI de développeurs
`ENABLE_CLAUDEAI_MCP_SERVERS`	Définissez sur `false` pour désactiver les serveurs MCP claude.ai dans Claude Code. 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 TTL de cache d’invite 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 reçoivent automatiquement une TTL d’une heure. Les écritures de cache d’une heure sont facturées à un taux plus élevé
`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 : tous les outils MCP différés par défaut, mais chargés en amont sur Google Cloud’s Agent Platform ou lorsque `ANTHROPIC_BASE_URL` pointe vers un hôte non-first-party. Valeurs : `true` (toujours différer et envoyer l’en-tête bêta, les requêtes échouent sur les modèles Google Cloud’s Agent Platform antérieurs à Sonnet 4.5 ou Opus 4.5, ou sur les proxies qui ne prennent pas en charge `tool_reference`), `auto` (mode seuil : charger en amont si les outils s’ajustent dans 10 % du contexte), `auto:N` (seuil personnalisé, par exemple, `auto:5` pour 5 %), `false` (charger tous en amont). Ignoré lorsque `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` est défini, ce qui force tous les outils à se charger en amont
`FALLBACK_FOR_ALL_PRIMARY_MODELS`	Définissez sur n’importe quelle valeur non vide pour faire arrêter tous les modèles, pas seulement Opus, de réessayer avec une erreur de surcharge répétée lorsqu’aucun modèle de secours n’est configuré. À partir de v2.1.160, une chaîne de modèles de secours configurée se déclenche sur les erreurs de surcharge répétées pour n’importe quel modèle principal, de sorte 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 la 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 prend en charge mais n’est pas détecté automatiquement, ou `0` pour les désactiver
`FORCE_PROMPT_CACHING_5M`	Définissez sur `1` pour forcer la TTL de cache d’invite de 5 minutes même lorsque la TTL d’une heure s’appliquerait autrement. Remplace `ENABLE_PROMPT_CACHING_1H`
`HTTP_PROXY`	Spécifier le serveur proxy HTTP pour les connexions réseau
`HTTPS_PROXY`	Spécifier le serveur proxy HTTPS pour les connexions réseau
`IS_DEMO`	Définissez sur `1` pour activer le mode démo : masque votre e-mail et le nom de l’organisation de l’en-tête et de la sortie `/status`, et ignore l’intégration. Utile pour la diffusion en continu ou l’enregistrement d’une session
`MAX_MCP_OUTPUT_TOKENS`	Nombre maximal de tokens autorisés dans les réponses des outils MCP. Claude Code affiche un avertissement lorsque la sortie dépasse 10 000 tokens. 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 : 25 000)
`MAX_STRUCTURED_OUTPUT_RETRIES`	Nombre de fois pour réessayer lorsque la réponse du modèle échoue la validation par rapport au `--json-schema` en mode non interactif (l’indicateur `-p`). Par défaut 5
`MAX_THINKING_TOKENS`	Remplacer le budget de tokens de réflexion étendue. Le plafond est le max output tokens du modèle moins un. Définissez sur `0` pour désactiver la réflexion sur l’API Anthropic sauf sur Fable 5, qui ne peut pas avoir la réflexion désactivée. Sur les fournisseurs tiers, `0` omet le paramètre `thinking` à la place, et les modèles avec raisonnement adaptatif peuvent toujours penser. Pour les valeurs non nulles sur les modèles de raisonnement adaptatif, le budget est ignoré sauf si le raisonnement adaptatif est désactivé via `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`
`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 les serveurs MCP pour se connecter avant la première requête. À partir de Claude Code v2.1.142, 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 restaurer l’attente de connexion bloquante de 5 secondes. Les serveurs configurés avec `alwaysLoad: true` bloquent toujours le démarrage indépendamment, car leurs outils doivent être présents lorsque la première invite est construite
`MCP_CONNECT_TIMEOUT_MS`	Combien de temps l’attente de démarrage bloquante pour MCP, en millisecondes, pour le lot de connexion avant de prendre un instantané de la liste d’outils (par défaut : 5 000). S’applique lorsque `MCP_CONNECTION_NONBLOCKING=0` ou pour les serveurs marqués `alwaysLoad: true`. Les serveurs toujours en attente à la date limite continuent à se connecter en arrière-plan mais n’apparaîtront pas jusqu’à la requête suivante. Distinct de `MCP_TIMEOUT`, qui limite la tentative de connexion d’un serveur individuel
`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_REMOTE_SERVER_CONNECTION_BATCH_SIZE`	Nombre maximal de serveurs MCP distants (HTTP/SSE) à connecter en parallèle au démarrage (par défaut : 20)
`MCP_SERVER_CONNECTION_BATCH_SIZE`	Nombre maximal 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 : 30 000, ou 30 secondes)
`MCP_TOOL_TIMEOUT`	Délai d’expiration en millisecondes pour l’exécution de l’outil MCP (par défaut : 100 000 000, 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 60 000 pour augmenter cette limite par requête. Une valeur inférieure raccourcit toujours le délai d’expiration global d’exécution d’outil mais laisse la limite par requête à 60 secondes. Les serveurs stdio et WebSocket n’ont pas de minuteur par requête. Un champ `timeout` par serveur dans `.mcp.json` remplace ceci pour ce serveur. Un `timeout` par serveur d’au moins 1 000 définit également la fenêtre d’inactivité minimale pour les appels d’outils de ce serveur, de sorte que `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` ne les interrompt jamais plus tôt ; cela nécessite Claude Code v2.1.203 ou ultérieur. Pour la variable env, les valeurs inférieures à 1 000 sont arrondies à une seconde ; pour le champ par serveur, les valeurs inférieures à 1 000 sont ignorées
`NO_PROXY`	Liste des domaines et adresses IP vers lesquels les requêtes seront émises directement, en contournant le proxy
`OTEL_LOG_ASSISTANT_RESPONSES`	Définissez sur `1` pour inclure le texte de la 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 masquées même lorsque `OTEL_LOG_USER_PROMPTS` est défini. Nécessite Claude Code v2.1.193 ou ultérieur. Voir Surveillance
`OTEL_LOG_RAW_API_BODIES`	Émettre la requête et la réponse JSON complètes 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 à 60 Ko, ou `file:<dir>` pour écrire les corps non tronqués sur le disque et émettre une référence de chemin `body_ref` à la place. Désactivé par défaut ; les corps incluent l’historique complet de la conversation. Voir Surveillance
`OTEL_LOG_TOOL_CONTENT`	Définissez sur `1` pour inclure le contenu d’entrée et de sortie d’outil dans les événements d’intervalle OpenTelemetry. 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 d’outil, les noms de serveurs MCP, les noms de workflows créés par l’utilisateur, les chaînes d’erreur brutes en cas d’échec d’outil, la catégorie 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 personnelles. Voir Surveillance
`OTEL_LOG_USER_PROMPTS`	Définissez sur `1` pour inclure le texte de l’invite utilisateur dans les traces et journaux OpenTelemetry. Désactivé par défaut (les invites sont masquées). 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 session dans les attributs de métriques (par défaut : exclu). Ajouté dans v2.1.152. Voir Surveillance
`OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES`	À partir de v2.1.161, Claude Code attache les clés `OTEL_RESOURCE_ATTRIBUTES` aux étiquettes de points de données de métriques. 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`	Remplacer le budget de caractères pour les métadonnées de skill affichées à l’outil Skill. Le budget s’adapte dynamiquement à 1 % de la fenêtre de contexte, avec un repli de 8 000 caractères. Nom hérité conservé pour la compatibilité rétroactive
`TASK_MAX_OUTPUT_LENGTH`	Nombre maximal de caractères dans la sortie du subagent avant la troncature (par défaut : 32 000, maximum : 160 000). Lorsqu’elle est tronquée, la sortie complète est enregistrée sur le disque et le chemin est inclus dans la réponse tronquée
`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`	Remplacer la région pour Claude 3.5 Haiku lors de l’utilisation de Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_3_5_SONNET`	Remplacer la région pour Claude 3.5 Sonnet lors de l’utilisation de Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_3_7_SONNET`	Remplacer la région pour Claude 3.7 Sonnet lors de l’utilisation de Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_0_OPUS`	Remplacer la région pour Claude 4.0 Opus lors de l’utilisation de Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_0_SONNET`	Remplacer la région pour Claude 4.0 Sonnet lors de l’utilisation de Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_1_OPUS`	Remplacer la région pour Claude 4.1 Opus lors de l’utilisation de Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_5_OPUS`	Remplacer la région pour Claude Opus 4.5 lors de l’utilisation de Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_5_SONNET`	Remplacer la région pour Claude Sonnet 4.5 lors de l’utilisation de Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_6_OPUS`	Remplacer la région pour Claude Opus 4.6 lors de l’utilisation de Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_6_SONNET`	Remplacer la région pour Claude Sonnet 4.6 lors de l’utilisation de Google Cloud’s Agent Platform
`VERTEX_REGION_CLAUDE_4_7_OPUS`	Remplacer la région pour Claude Opus 4.7 lors de l’utilisation de Google Cloud’s Agent Platform. Ajouté dans v2.1.111
`VERTEX_REGION_CLAUDE_4_8_OPUS`	Remplacer la région pour Claude Opus 4.8 lors de l’utilisation de Google Cloud’s Agent Platform. Ajouté dans v2.1.154
`VERTEX_REGION_CLAUDE_5_SONNET`	Remplacer 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`	Remplacer 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_HAIKU_4_5`	Remplacer 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.

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

​Définir les variables d’environnement

​Dans votre shell

​Dans les fichiers de paramètres

​Précédence

​Variables

​Voir aussi