SpyBara
Go Premium

env-vars.md 2026-10-02 22:59 UTC to 2026-10-03 16:02 UTC

This page contains 376 additions and 374 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 17:01

Variables d'environnement

Référence pour les variables d'environnement qui contrôlent le comportement de Claude Code.

Les variables d'environnement peuvent contrôler le comportement de Claude Code, comme la sélection du modèle, l'authentification, le routage des requêtes et les bascules de fonctionnalités. Beaucoup des mêmes comportements peuvent également être configurés via un fichier de paramètres, un drapeau CLI ou une commande en session comme /model.

Cette page couvre comment :

Définir les variables d'environnement

Une variable que vous définissez dans votre shell dure pendant cette session de terminal, tandis qu'une variable dans un fichier de paramètres s'applique chaque fois que claude s'exécute.

Dans votre shell

Définissez la variable avant de lancer claude :

export API_TIMEOUT_MS="1200000"
claude

Pour la définir pour chaque session, ajoutez la ligne export à ~/.bashrc, ~/.zshrc, ou le fichier de profil de votre shell.

La ligne d'assignation n'affiche rien en cas de succès. Pour confirmer que la variable est définie, affichez-la dans le même shell :

echo $API_TIMEOUT_MS

Dans les fichiers de paramètres

Ajoutez les variables sous la clé env dans un fichier settings.json, en créant le fichier s'il n'existe pas. Claude Code les lit directement depuis le fichier, donc elles prennent effet peu importe comment claude a été lancé. Une session en cours applique les valeurs nouvelles et modifiées à son environnement lorsque vous enregistrez le fichier, mais une fonctionnalité qui lit ses variables une seule fois au démarrage, comme la surveillance OpenTelemetry, conserve ses valeurs de démarrage jusqu'à ce que vous relancez. Retirer une variable du fichier ne la supprime pas d'une session en cours ; ce retrait prend effet la prochaine fois que vous lancez claude.

{
  "env": {
    "API_TIMEOUT_MS": "1200000",
    "BASH_DEFAULT_TIMEOUT_MS": "300000"
  }
}

Le fichier que vous choisissez contrôle à qui les variables s'appliquent :

Fichier S'applique à
~/.claude/settings.json Vous, dans chaque projet
.claude/settings.json Tous ceux qui travaillent dans le projet, archivé dans le contrôle de source
.claude/settings.local.json Vous, dans ce projet uniquement, ignoré par git lorsque Claude Code enregistre un paramètre ; ajoutez-le à votre gitignore si vous le créez manuellement
Paramètres gérés Tous les membres de votre organisation, déployés par un administrateur

Consultez Fichiers de paramètres pour savoir où se trouve chaque fichier et Précédence des paramètres pour savoir comment ils se combinent lorsque plusieurs définissent la même variable.

Précédence

Certains comportements ont à la fois une variable d'environnement et une clé de paramètres dédiée, et celle que Claude Code lit en premier diffère selon la clé. Pour ANTHROPIC_MODEL et CLAUDE_CODE_AUTO_CONNECT_IDE, Claude Code lit d'abord la variable et utilise le paramètre model ou autoConnectIde uniquement lorsque la variable n'est pas définie. Pour la paire que vous définissez, vérifiez la ligne de la variable ci-dessous et l'entrée de la clé sur la référence des paramètres.

Lorsque la même variable est définie à la fois dans votre shell et dans un bloc env du fichier de paramètres, la valeur du fichier de paramètres s'applique dans la plupart des sessions. Claude Code écrit chaque entrée env dans l'environnement du processus, en remplaçant la valeur héritée du shell. Comment les valeurs env interagissent avec votre shell couvre les sessions qui conservent la valeur héritée à la place, et le paramètre env indique quand il les applique. Quelques variables sont traitées de manière spéciale ; le paramètre env énumère les exceptions.

Dans un fichier de paramètres, vous pouvez définir une variable mais vous ne pouvez pas en retirer une. Pour remplacer une variable que vous ne pouvez pas supprimer, comme une CLAUDE_CODE_USE_VERTEX obsolète exportée par un profil de shell que vous ne contrôlez pas, définissez-la sur une chaîne vide dans le bloc env : "CLAUDE_CODE_USE_VERTEX": "". Claude Code traite la valeur vide comme non définie pour la sélection du fournisseur. Les sous-processus héritent toujours de la valeur vide.

Entre les fichiers de paramètres, les valeurs env suivent la précédence des paramètres, de sorte qu'une entrée de paramètres gérée remplace la même variable dans les paramètres utilisateur ou projet. Les paramètres de projet et locaux ne peuvent pas définir certaines variables, comme CLAUDE_CONFIG_DIR et les variables d'exportateur OpenTelemetry. Les variables que Claude Code ignore dans env les énumère, ainsi que les valeurs d'arrêt OpenTelemetry qui s'appliquent toujours.

La façon dont une variable d'environnement interagit avec les drapeaux CLI et les commandes en session varie selon la fonctionnalité : --model et /model remplacent ANTHROPIC_MODEL, tandis que CLAUDE_CODE_EFFORT_LEVEL remplace --effort et /effort. Lorsqu'une variable interagit avec une autre source de configuration, sa ligne dans la liste Variables indique la précédence ou établit un lien vers la page qui la documente.

Claude Code lit les variables d'environnement du shell au démarrage, de sorte que les modifications apportées à celles-ci prennent effet la prochaine fois que vous lancez claude. Les variables définies sous la clé env dans les fichiers de paramètres sont réappliquées à une session en cours lorsque le fichier change, à l'exception du démarrage uniquement décrite dans Dans les fichiers de paramètres.

Variables

Les variables numériques telles que les délais d'expiration, les budgets de tokens et les nombres de nouvelles tentatives acceptent la notation scientifique et les séparateurs de chiffres en plus des chiffres simples, sauf lorsque la ligne d'une variable indique qu'elle n'accepte que des chiffres simples. Par exemple, Claude Code lit 2e3 comme 2000 et 64_000 comme 64000. Avant la v2.1.211, ces écritures pouvaient définir silencieusement une valeur beaucoup plus petite, par exemple 1e6 fixant un délai d'expiration à 1.

Variable Objectif
ANTHROPIC_API_KEY Clé API envoyée dans l'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, il vous est demandé d'approuver la clé une fois avant qu'elle ne remplace votre abonnement. Pour utiliser plutôt votre abonnement, exécutez unset ANTHROPIC_API_KEY
ANTHROPIC_AUTH_TOKEN Valeur personnalisée pour l'en-tête Authorization (la valeur définie ici sera préfixée par Bearer )
ANTHROPIC_AWS_API_KEY Clé API d'espace de travail pour Claude Platform on AWS, générée dans la console AWS. Envoyée en tant que x-api-key et prioritaire sur AWS SigV4
ANTHROPIC_AWS_BASE_URL Remplace l'URL de l'endpoint Claude Platform on AWS. À utiliser pour des régions personnalisées ou lors du routage via une passerelle LLM. Par défaut https://aws-external-anthropic.{region}.api.aws. Claude Code résout la région selon la même priorité que sur Amazon Bedrock
ANTHROPIC_AWS_WORKSPACE_ID Requis pour Claude Platform on AWS. Envoyé avec chaque requête dans l'en-tête anthropic-workspace-id
ANTHROPIC_BASE_URL Remplace l'endpoint de l'API pour router les requêtes via un proxy ou une passerelle. Lorsqu'il pointe vers 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 transmet les blocs tool_reference. Depuis la v2.1.196, Remote Control est désactivé lorsque cette variable pointe vers un hôte autre que api.anthropic.com, comme c'est le cas sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL Remplace l'URL de l'endpoint Amazon Bedrock. À utiliser pour des endpoints Amazon Bedrock personnalisés ou lors du routage via une passerelle LLM. Voir Amazon Bedrock
ANTHROPIC_BEDROCK_MANTLE_BASE_URL Remplace l'URL de l'endpoint Amazon Bedrock Mantle. Voir Endpoint Mantle
ANTHROPIC_BEDROCK_REGION_PREFIX Préfixe de profil d'inférence interrégional (us, eu, apac, jp, au ou global) que Claude Code essaie en premier au lieu de celui dérivé de la région AWS. Ignoré dans les régions AWS GovCloud. Nécessite Claude Code v2.1.224 ou ultérieur. Voir Amazon Bedrock
ANTHROPIC_BEDROCK_SERVICE_TIER Niveau de service Amazon Bedrock (default, flex ou priority). Envoyé dans l'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 cette variable pour activer une bêta de l'API Anthropic avant que Claude Code n'en ajoute la prise en charge native. Contrairement au flag --betas, qui nécessite une authentification par clé API, cette variable fonctionne avec toutes les méthodes d'authentification, y compris l'abonnement Claude.ai
ANTHROPIC_CUSTOM_HEADERS En-têtes personnalisés à ajouter aux requêtes (format Name: Value, séparés par des retours à la ligne pour plusieurs en-têtes). Si un nom ou une valeur contient un caractère qu'un en-tête HTTP ne peut pas transporter, comme un guillemet typographique ou un espace de largeur nulle, la requête échoue avec une erreur qui identifie la paire par sa position. Nécessite Claude Code v2.1.227 ou ultérieur. Invalid request header value indique le jeu de caractères exact et l'endroit où la vérification s'effectue. Une valeur qui définit un en-tête d'identifiants, d'organisation ou de tenant, de routage ou de comportement de l'API, comme Authorization ou Host, compte comme un paramètre nécessitant une approbation lorsque des paramètres gérés par le serveur la fournissent. Depuis les paramètres de projet ou locaux, une telle valeur suit les règles déterminant quand les valeurs env s'appliquent
ANTHROPIC_CUSTOM_MODEL_OPTION ID de modèle à ajouter comme entrée personnalisée dans le sélecteur /model. Utilisez-la pour rendre sélectionnable un modèle non standard ou propre à une passerelle sans remplacer les alias intégrés. Voir Configuration du modèle
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION Description affichée pour l'entrée de modèle personnalisé dans le sélecteur /model. Par défaut Custom model (<model-id>) lorsqu'elle n'est pas définie
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME Nom affiché pour l'entrée de modèle personnalisé dans le sélecteur /model. Lorsqu'il n'est pas défini, l'entrée affiche le nom du modèle si Claude Code reconnaît l'ID, et l'ID du modèle sinon
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES Liste, séparée par des virgules, des capacités prises en charge par le modèle personnalisé, par exemple effort,thinking. Voir Configuration du modèle
ANTHROPIC_DEFAULT_FABLE_MODEL ID de modèle vers lequel l'alias fable est résolu, et ID que Claude Code reconnaît comme un modèle Fable pour le basculement automatique de modèle chez les fournisseurs tiers. Voir Configuration du modèle
ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION Description affichée pour le modèle Fable épinglé dans le sélecteur /model. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par Custom Fable model. Voir Configuration du modèle
ANTHROPIC_DEFAULT_FABLE_MODEL_NAME Nom affiché pour le modèle Fable épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir Configuration du modèle
ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES Liste, séparée par des virgules, des capacités prises en charge par le modèle Fable épinglé, par exemple effort,thinking. Voir Configuration du modèle
ANTHROPIC_DEFAULT_HAIKU_MODEL ID de modèle vers lequel l'alias haiku est résolu, également utilisé pour les fonctionnalités en arrière-plan. Voir Configuration du modèle
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION Description affichée pour le modèle Haiku épinglé dans le sélecteur /model. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par Custom Haiku model. Voir Configuration du modèle
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME Nom affiché pour le modèle Haiku épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir Configuration du modèle
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES Liste, séparée par des virgules, des capacités prises en charge par le modèle Haiku épinglé, par exemple effort,thinking. Voir Configuration du modèle
ANTHROPIC_DEFAULT_MODEL Modèle sur lequel les nouvelles sessions démarrent par défaut. Nécessite Claude Code v2.1.236 ou ultérieur. Voir Définir un modèle par défaut pour les nouvelles sessions
ANTHROPIC_DEFAULT_OPUS_MODEL ID de modèle vers lequel l'alias opus est résolu, et que opusplan utilise lorsque le mode plan est actif. Voir Configuration du modèle
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION Description affichée pour le modèle Opus épinglé dans le sélecteur /model. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par Custom Opus model. Voir Configuration du modèle
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME Nom affiché pour le modèle Opus épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir Configuration du modèle
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES Liste, séparée par des virgules, des capacités prises en charge par le modèle Opus épinglé, par exemple effort,thinking. Voir Configuration du modèle
ANTHROPIC_DEFAULT_SONNET_MODEL ID de modèle vers lequel l'alias sonnet est résolu, et que opusplan utilise lorsque le mode plan n'est pas actif. Voir Configuration du modèle
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION Description affichée pour le modèle Sonnet épinglé dans le sélecteur /model. Lorsqu'elle n'est pas définie, la ligne affiche une description par défaut commençant par Custom Sonnet model. Voir Configuration du modèle
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME Nom affiché pour le modèle Sonnet épinglé dans le sélecteur /model. Lorsqu'il n'est pas défini, la ligne affiche le nom du modèle si Claude Code reconnaît l'ID épinglé, et l'ID épinglé sinon. Voir Configuration du modèle
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES Liste, séparée par des virgules, des capacités prises en charge par le modèle Sonnet épinglé, par exemple effort,thinking. Voir Configuration du modèle
ANTHROPIC_FEDERATION_RULE_ID ID de règle de fédération pour Workload Identity Federation. Lorsque vous la définissez avec ANTHROPIC_ORGANIZATION_ID, Claude Code sélectionne les identifiants de fédération, qui ont priorité sur vos identifiants /login. Voir priorité d'authentification
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 dans l'en-tête Authorization: Bearer. Prioritaire sur ANTHROPIC_FOUNDRY_API_KEY et sur la chaîne d'identifiants Azure par défaut. Voir Microsoft Foundry. Nécessite Claude Code v2.1.203 ou ultérieur
ANTHROPIC_FOUNDRY_BASE_URL URL de base complète de 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). Claude Code refuse une URL ou un nom d'hôte. Requis si ANTHROPIC_FOUNDRY_BASE_URL n'est pas défini (voir Microsoft Foundry)
ANTHROPIC_MODEL Nom du paramètre de modèle à utiliser (voir Configuration du modèle)
ANTHROPIC_ORGANIZATION_ID ID d'organisation pour Workload Identity Federation. Définissez-le avec ANTHROPIC_FEDERATION_RULE_ID. Voir priorité d'authentification
ANTHROPIC_PROFILE Nom du profil Anthropic avec lequel s'authentifier, comme un profil créé par ant auth login ou par une connexion à un compte Console sans clé API. Voir priorité d'authentification
ANTHROPIC_SMALL_FAST_MODEL [DÉPRÉCIÉ] Nom du modèle de classe Haiku pour les tâches en arrière-plan
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION Remplace la région AWS pour le modèle de classe Haiku lors de l'utilisation d'Amazon Bedrock ou d'Amazon Bedrock Mantle. Sur Amazon Bedrock, cela ne prend effet que si ANTHROPIC_DEFAULT_HAIKU_MODEL ou la variable dépréciée ANTHROPIC_SMALL_FAST_MODEL est également définie, car sinon Amazon Bedrock exécute les tâches en arrière-plan sur le modèle Sonnet par défaut ou le modèle principal dans la région de la session
ANTHROPIC_VERTEX_BASE_URL Remplace l'URL de l'endpoint de Google Cloud's Agent Platform. À utiliser pour des endpoints 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 du projet GCP auquel les requêtes Google Cloud's Agent Platform sont adressées. Voir Configurer les identifiants GCP
ANTHROPIC_WORKSPACE_ID ID d'espace de travail pour la fédération d'identité de charge de travail. Définissez-le lorsque votre règle de fédération couvre plusieurs espaces de travail, afin que l'échange de jetons sache quel espace de travail cibler
API_FORCE_IDLE_TIMEOUT Remplace le délai d'inactivité de 5 minutes sur le corps de la réponse, qui interrompt une réponse de modèle en streaming lorsqu'aucun octet n'arrive. Définissez 0 pour désactiver ce délai, par exemple lorsqu'une passerelle lente ou un modèle local marque une pause de plus de 5 minutes entre deux fragments, ou 1 pour le maintenir actif pour tous les fournisseurs. Lorsque la variable n'est pas définie, le délai est actif chez les fournisseurs autres que l'API Anthropic directe, Claude Platform on AWS et Amazon Bedrock avec CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1 défini. Les watchdogs de flux fonctionnent indépendamment de celui-ci et interrompent une longue pause silencieuse même si vous définissez 0 ici
API_TIMEOUT_MS Délai d'expiration des requêtes API en millisecondes (par défaut : 600000, soit 10 minutes ; maximum : 2147483647). Augmentez-le lorsque les requêtes expirent sur des réseaux lents ou lors du routage via un proxy. Les valeurs supérieures au maximum font déborder 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 d'une commande de l'outil Bash ou PowerShell au premier plan, en millisecondes (par défaut : 120000, soit 2 minutes). Une valeur par défaut supérieure à 30 minutes devient également la limite de temps par défaut des commandes en arrière-plan dans les sessions sans surveillance. La limite de temps en arrière-plan nécessite Claude Code v2.1.285 ou ultérieur
BASH_MAX_OUTPUT_LENGTH Nombre maximal de caractères de la sortie bash que Claude Code relit dans le résultat d'une commande (par défaut : 30000 ; maximum : 150000). Si vous définissez le paramètre bashOutputMaxChars, Claude Code ignore cette variable. Voir Limites de sortie
BASH_MAX_TIMEOUT_MS Délai d'expiration maximal que le modèle peut définir pour une commande de l'outil Bash ou PowerShell au premier plan, en millisecondes (par défaut : 600000, soit 10 minutes). Le plafond effectif est la plus grande valeur entre celle-ci et BASH_DEFAULT_TIMEOUT_MS. Un plafond effectif supérieur à 2 heures devient également la limite de temps maximale des commandes en arrière-plan dans les sessions sans surveillance. La limite de temps en arrière-plan nécessite Claude Code v2.1.285 ou ultérieur
BETA_TRACING_ENDPOINT Endpoint OTLP pour le traçage bêta détaillé : avec ENABLE_BETA_TRACING_DETAILED=1, les logs et les traces y sont envoyés au lieu des exportateurs configurés. Définissez-le dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignoré dans les paramètres de projet et locaux
CCR_FORCE_BUNDLE Définissez 1 pour forcer claude --cloud à empaqueter et téléverser votre dépôt local au lieu de le cloner depuis son remote
CLAUDECODE Défini à 1 dans les sous-processus lancés par Claude Code (outils Bash et PowerShell, sessions tmux, commandes de hook, commandes de barre de statut, sous-processus de serveur MCP stdio). Les extensions IDE le définissent également dans leurs terminaux intégrés. Utilisez-la pour détecter si un script s'exécute dans un sous-processus lancé par Claude Code. Pour vérifier si le processus actuel a été lancé directement par un appel d'outil ou un hook, plutôt qu'au sein d'un serveur MCP stdio démarré par Claude Code, utilisez plutôt CLAUDE_CODE_CHILD_SESSION
CLAUDE_AFK_COUNTDOWN_MS Nombre de millisecondes avant la poursuite automatique auquel le compte à rebours apparaît à l'écran sur une boîte de dialogue AskUserQuestion sans réponse. Par défaut 20000 (20 secondes), plafonné au délai de poursuite automatique. Sans effet si la poursuite automatique n'est pas 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 Nombre de millisecondes d'inactivité avant qu'une boîte de dialogue AskUserQuestion sans réponse ne se poursuive automatiquement sans vous. La poursuite automatique est désactivée par défaut ; activez-la avec le paramètre askUserQuestionTimeout. Cette variable est un remplacement destiné aux démos et aux tests automatisés : lorsqu'elle est définie, elle a priorité sur ce paramètre et active la poursuite automatique même si le paramètre n'est pas défini ou vaut never. Définir 0 ne désactive pas le délai ; cela ferme immédiatement la boîte de dialogue. Dans les v2.1.198 et v2.1.199, la poursuite automatique était activée par défaut avec un délai de 60000 (60 secondes). Nécessite Claude Code v2.1.198 ou ultérieur
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS Définissez 1 pour désactiver tous les types de sous-agents intégrés tels qu'Explore et Plan. S'applique uniquement en mode non interactif (le flag -p). Utile pour les utilisateurs du SDK qui veulent partir de zéro. Cela supprime également general-purpose, le sous-agent que Claude Code exécute lorsqu'un appel de l'outil Agent omet subagent_type. Un tel appel échoue alors avec subagent_type is required
CLAUDE_AGENT_SDK_MCP_NO_PREFIX Définissez 1 pour omettre le préfixe mcp__<server>__ des noms d'outils provenant de serveurs MCP créés par le SDK. Les outils utilisent leurs noms d'origine. Usage SDK uniquement
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS Délai de blocage en millisecondes pour les sous-agents. Par défaut 600000 (10 minutes) ; si vous augmentez CLAUDE_STREAM_IDLE_TIMEOUT_MS alors que le watchdog de flux est actif, la valeur par défaut augmente avec lui, comme le décrit Gérer les réponses API lentes ou bloquées. Le minuteur est réinitialisé à chaque événement de progression du streaming ; si aucune progression n'arrive dans l'intervalle, Claude Code interrompt le sous-agent et signale le blocage au parent
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE Définit le pourcentage (1-100) de la fenêtre de compaction automatique auquel la compaction automatique se déclenche. Utilisez des valeurs plus basses comme 50 pour compacter plus tôt ; la variable ne peut pas relever le seuil, les valeurs supérieures au pourcentage par défaut sont donc ignorées. Elle s'applique uniquement aux sessions qui compactent avant la limite de contexte du modèle. S'applique aux conversations principales comme aux sous-agents
CLAUDE_AUTO_BACKGROUND_TASKS Définissez 1 pour forcer l'activation de la mise en arrière-plan automatique des tâches d'agent de longue durée. Lorsqu'elle est activée, les sous-agents passent en arrière-plan après environ deux minutes d'exécution. Active également la mise en arrière-plan automatique des longs appels d'outils MCP en mode non interactif sur Claude Code v2.1.212 ou ultérieur
CLAUDE_AX_PREPARK_MS En mode lecteur d'écran, nombre de millisecondes que Claude Code attend avant d'écrire une ligne nouvelle ou modifiée. Par défaut 0, Claude Code n'attend donc pas. Avant la v2.1.287, la valeur par défaut était 50. Claude Code plafonne l'attente à 5000. Nécessite Claude Code v2.1.233 ou ultérieur
CLAUDE_AX_SCREEN_READER Définissez 1 pour produire une sortie adaptée aux lecteurs d'écran : texte brut sans bordures décoratives ni animations. Définissez 0 pour forcer la désactivation du mode lecteur d'écran même lorsque axScreenReader vaut true. Le flag --ax-screen-reader est prioritaire. Nécessite Claude Code v2.1.181 ou ultérieur
CLAUDE_AX_STARTUP_QUIET_MS En mode lecteur d'écran, nombre de millisecondes pendant lesquelles Claude Code retient le premier rendu de l'interface après la ligne de confirmation de démarrage, afin que votre lecteur d'écran puisse lire la ligne en entier avant qu'une nouvelle sortie ne l'interrompe. Par défaut 3000. Définissez 0 pour un rendu immédiat. Claude Code plafonne cette attente à 600000 (10 minutes). Votre première frappe met fin à l'attente plus tôt. Nécessite Claude Code v2.1.217 ou ultérieur
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR Revenir au répertoire de travail d'origine après chaque commande Bash ou PowerShell dans la session principale
CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS Délai d'expiration en millisecondes du watchdog d'inactivité du streaming au niveau des octets ; lorsqu'il est défini, il a priorité sur CLAUDE_STREAM_IDLE_TIMEOUT_MS pour ce watchdog et laisse inchangé le watchdog au niveau des événements. Claude Code limite cette variable à une valeur comprise entre 10 secondes et 30 minutes. Nécessite Claude Code v2.1.210 ou ultérieur
CLAUDE_CLIENT_PRESENCE_FILE Chemin vers un fichier qu'un outil externe, comme un écouteur de verrouillage d'écran, crée lorsque vous déverrouillez votre écran et supprime lorsque vous le verrouillez. Tant que le fichier existe, Claude Code ignore les notifications push mobiles de Remote Control, afin que vous ne receviez plus de notifications push pendant que vous utilisez activement l'ordinateur. Lorsque le fichier est absent ou illisible, les notifications sont envoyées normalement. Claude Code vérifie le fichier une fois par événement déclenchant une notification push plutôt que de l'interroger en continu. Nécessite Claude Code v2.1.181 ou ultérieur
CLAUDE_CODE_ACCESSIBILITY Définissez 1 pour garder le curseur natif du terminal visible et désactiver l'indicateur de curseur en texte inversé. Permet aux loupes d'écran comme le Zoom de macOS de suivre la position du curseur
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD Définissez 1 pour charger les fichiers mémoire depuis les 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 de fichiers mémoire
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT Définissez 1 pour redessiner l'écran entier à chaque image en rendu plein écran au lieu d'envoyer des mises à jour incrémentielles. Utilisez-la si le mode plein écran affiche des fragments de texte obsolètes ou mal placés. Claude Code l'active automatiquement pour les sessions en arrière-plan et la vue des agents sous Windows
CLAUDE_CODE_ALWAYS_ENABLE_EFFORT Définissez 1 pour envoyer le paramètre effort avec chaque requête, même lorsque Claude Code ne reconnaît pas l'ID du modèle comme compatible avec l'effort. Utilisez-la lors du routage via une passerelle LLM ou un fournisseur tiers qui sert des modèles sous des identifiants personnalisés. Les modèles qui rejettent le paramètre effort au niveau de 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, restent exclus afin que les requêtes n'échouent pas
CLAUDE_CODE_API_KEY_HELPER_TTL_MS Intervalle en millisecondes auquel les identifiants doivent être actualisés (lors de l'utilisation de apiKeyHelper)
CLAUDE_CODE_ARTIFACT_AUTO_OPEN Définissez 0 pour empêcher Claude Code d'ouvrir automatiquement le navigateur lorsqu'un nouvel artefact est publié
CLAUDE_CODE_ARTIFACT_COMMENTS Définissez 0 pour empêcher Claude de lire les commentaires sur un artefact et d'y répondre. Sans effet lorsque CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC a désactivé les artefacts. Nécessite Claude Code v2.1.221 ou ultérieur
CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT Définissez 0 pour empêcher Claude de répondre de lui-même aux commentaires qui lui sont envoyés. Nécessite Claude Code v2.1.228 ou ultérieur
CLAUDE_CODE_ATTRIBUTION_HEADER Définissez 0 pour omettre le bloc d'attribution, qui contient la version du client et une empreinte du prompt, au début du prompt système. La mise en cache sur une connexion directe à l'API Anthropic n'est pas affectée dans un cas comme dans l'autre. Dans certaines configurations à connexion directe, Claude Code conserve le bloc sur les requêtes du classifieur du mode auto même si vous définissez 0. Dans Bloc d'attribution du prompt système, vérifiez quelles connexions et quels identifiants sont concernés. Avant la v2.1.181, le bloc incluait un jeton par requête sur les URL de base personnalisées et les connexions Microsoft Foundry ; sur ces versions, définissez-le donc à 0 lorsque votre passerelle LLM met en cache sur le corps de la requête ou transmet les requêtes à un fournisseur tiers, ou lorsque vous vous connectez directement à Microsoft Foundry
CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS Lorsque CLAUDE_AUTO_BACKGROUND_TASKS est activé, nombre de secondes entre les rappels invitant Claude à vérifier les sous-agents en arrière-plan encore en cours d'exécution. Accepte uniquement un entier simple de 1 à 86400 ; toute autre valeur ou écriture est traitée comme non définie. Lorsqu'elle n'est pas définie, il n'y a pas de rappels. Nécessite Claude Code v2.1.248 ou ultérieur
CLAUDE_CODE_AUTO_COMPACT_WINDOW Définit la fenêtre de compaction automatique en tokens, de 100000 à 1000000. Accepte uniquement un entier simple tel que 500000 : une valeur comme 500k est lue comme 500 et ramenée au minimum de 100K. La fenêtre effective est également plafonnée à la fenêtre de contexte du modèle. Prioritaire sur la commande /autocompact, le flag --autocompact et le paramètre autoCompactWindow. Le used_percentage de la barre de statut se mesure toujours par rapport à la fenêtre de contexte complète du modèle ; une fois cette variable définie, ce pourcentage n'indique donc plus quand la compaction aura lieu
CLAUDE_CODE_AUTO_CONNECT_IDE Remplace 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 false pour l'en empêcher. Définissez true pour forcer une tentative de connexion lorsque la détection automatique échoue, par exemple lorsque tmux masque le terminal parent. Prioritaire sur le paramètre de configuration globale autoConnectIde
CLAUDE_CODE_AUTO_MODE_SERVER Contrôle si Claude Code demande au serveur d'examiner les actions du mode auto. Définissez 0 pour utiliser à la place les requêtes de classifieur propres à Claude Code. Sur une connexion directe à l'API Anthropic, nécessite la v2.1.281 ou ultérieure. La section liée indique quelles sessions interrogent le serveur lorsque la variable n'est pas définie, et à partir de quelle version. Nécessite Claude Code v2.1.271 ou ultérieur
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS Temps en millisecondes pendant lequel Claude Code attend que la chaîne de fournisseurs d'identifiants AWS par défaut produise des identifiants avant que la requête échoue avec AWS default-chain credential resolve timed out (par défaut : 60000). Augmentez-le lorsqu'une étape de votre chaîne a légitimement besoin de plus de temps, comme une connexion SSO via navigateur avec MFA à travers un wrapper tel que aws-vault. S'applique partout où Claude Code signe avec la chaîne par défaut : Amazon Bedrock, Claude Platform on AWS et l'endpoint Mantle. Nécessite Claude Code v2.1.207 ou ultérieur
CLAUDE_CODE_BASH_EDIT_DIFF Définissez 0 pour désactiver le diff des fichiers modifiés pendant l'exécution d'une commande Bash, ou 1 pour l'enregistrer dans tous les modes de permission. Prioritaire sur le paramètre bashEditDiffEnabled. Nécessite Claude Code v2.1.269 ou ultérieur
CLAUDE_CODE_BG_TASKS_REPORT_RUNNING Définissez 0 pour qu'une session non interactive signale un statut inactif à son hôte à chaque fin de tour, même lorsque du travail en arrière-plan est encore en cours. Par défaut, la session continue de signaler un statut en cours d'exécution après la fin du tour tant qu'un travail en arrière-plan, tel qu'un agent en arrière-plan ou une exécution de workflow, est encore actif. Cela évite qu'un hôte qui surveille le statut, comme une liste de sessions à distance, annonce que Claude attend votre saisie en plein travail. Les commandes shell en arrière-plan, comme un serveur de développement, ne maintiennent pas le statut en cours d'exécution. Le statut en cours d'exécution par défaut et la désactivation via 0 nécessitent Claude Code v2.1.269 ou ultérieur ; sur les versions antérieures, définissez 1 pour maintenir le statut en cours d'exécution
CLAUDE_CODE_BRIDGE_SESSION_ID Défini automatiquement dans les sous-processus de l'outil Bash et des commandes de hook tant que la session dispose d'une connexion Remote Control active, et supprimé à la fin de la connexion. La valeur est l'identifiant de la session au format session_, le même identifiant que celui qui apparaît dans l'URL claude.ai/code de la session, afin qu'un script puisse renvoyer vers la session qui l'a exécuté. Nécessite Claude Code v2.1.199 ou ultérieur. Dans les sessions cloud, lisez plutôt CLAUDE_CODE_REMOTE_SESSION_ID
CLAUDE_CODE_BS_AS_CTRL_BACKSPACE Définissez 0 pour que Claude Code lise l'octet 0x08, également noté ^H, comme un simple Backspace, ou 1 pour le lire comme Ctrl+Backspace. L'une ou l'autre valeur remplace le comportement par défaut de la plateforme. Par défaut, Claude Code le lit comme Ctrl+Backspace sous Windows, sauf lorsque TERM_PROGRAM vaut mintty ou TERM vaut cygwin, et comme un simple Backspace sous macOS et Linux. Définissez 0 dans un terminal Windows où Backspace supprime un mot entier
CLAUDE_CODE_CERT_STORE Liste, séparée par des virgules, des sources de certificats CA pour les connexions TLS. bundled est l'ensemble de CA Mozilla fourni avec Claude Code. system est le magasin de certificats de confiance du système d'exploitation, lu uniquement sur les runtimes disposant de 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 à 1 dans les sous-processus que Claude Code lance via les outils Bash, PowerShell et Monitor, les commandes de hook et les commandes de barre de statut. Non défini pour les sous-processus de serveur MCP stdio, qui sont de longue durée et survivent à la session qui les a lancés. Contrairement à CLAUDECODE, cette variable n'est définie que par Claude Code lui-même lorsqu'il lance un sous-processus, et non par les extensions IDE ; elle distingue donc de manière fiable une session imbriquée d'un claude de premier niveau lancé dans un terminal intégré à un IDE. Un TUI claude interactif imbriqué démarré de cette façon est automatiquement exclu de --resume, --continue, de l'historique de la flèche haut et de la liste claude agents. Les sessions claude -p non interactives restent persistées. Définissez CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 pour annuler cette exclusion. Nécessite Claude Code v2.1.172 ou ultérieur
CLAUDE_CODE_CLIENT_CERT Chemin vers le fichier de certificat client pour l'authentification mTLS
CLAUDE_CODE_CLIENT_KEY Chemin vers le fichier de clé privée client pour l'authentification mTLS
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE Phrase secrète pour la CLAUDE_CODE_CLIENT_KEY chiffrée (facultatif)
CLAUDE_CODE_CONNECT_TIMEOUT_MS Supprimée dans la v2.1.186 et désormais sans effet. Définissait auparavant un délai d'expiration distinct pour la phase de connexion, TLS et en-têtes de réponse d'une requête API en streaming. Utilisez API_TIMEOUT_MS pour le délai d'expiration par requête. Pour la phase d'en-têtes de réponse d'une requête en streaming, voir CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS
CLAUDE_CODE_DEBUG_LOGS_DIR Remplace le chemin du fichier de log de débogage. Malgré son nom, il s'agit d'un chemin de fichier, et non 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 : définir cette variable seule n'active pas la journalisation. Le flag --debug-file fait les deux à la fois. Par défaut ~/.claude/debug/<session-id>.txt
CLAUDE_CODE_DEBUG_LOG_LEVEL Niveau de log minimal écrit dans le fichier de log de débogage. Valeurs : verbose, debug (par défaut), info, warn, error. Définissez verbose pour inclure des diagnostics volumineux comme la sortie complète de la commande de barre de statut, ou montez à error pour réduire le bruit
CLAUDE_CODE_DISABLE_1M_CONTEXT Définissez 1 pour désactiver la prise en charge de la fenêtre de contexte de 1M. Lorsqu'elle est définie, les variantes de modèles 1M ne sont pas disponibles dans le sélecteur de modèle, et Claude Code limite à une fenêtre de 200K les sessions sur des modèles dotés d'une fenêtre native de 1M, comme Sonnet 5.5 et les modèles Fable ; voir Contexte étendu pour savoir comment cette limite est appliquée. Utile pour les environnements d'entreprise soumis à des exigences de conformité. Pour son rôle dans la correction de la fenêtre d'un ID de modèle [1m] non reconnu, voir Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING Définissez 1 pour désactiver le raisonnement adaptatif sur Opus 4.6 et Sonnet 4.6 et revenir au budget de réflexion fixe contrôlé par MAX_THINKING_TOKENS. Sans effet sur les modèles Fable, Sonnet 5 et ultérieurs, ou Opus 4.7 et ultérieurs, qui utilisent toujours le raisonnement adaptatif
CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION Définissez 1 pour empêcher Claude Code de fusionner clé par clé les blocs env des paramètres gérés entre les sources d'administration, de sorte que seul le bloc env complet de la source la plus prioritaire s'applique, comme avant la v2.1.223. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc env de paramètres. Nécessite Claude Code v2.1.223 ou ultérieur
CLAUDE_CODE_DISABLE_ADVISOR_TOOL Définissez 1 pour désactiver l'outil advisor. La commande /advisor devient indisponible, tout advisorModel configuré est ignoré, et le flag --advisor est accepté mais sans effet, de sorte que les scripts existants qui le transmettent continuent de fonctionner sans erreur
CLAUDE_CODE_DISABLE_AGENT_VIEW Définissez 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 1 pour désactiver le rendu plein écran et utiliser le moteur de rendu classique sur l'écran principal. La conversation reste dans l'historique de défilement natif de votre terminal, de sorte que Cmd+f et le mode copie de tmux fonctionnent normalement. Prioritaire 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 depuis la vue des agents, qui utilisent toujours le rendu plein écran
CLAUDE_CODE_DISABLE_ARTIFACT Définissez 1 pour désactiver l'outil Artifact, qui publie la sortie de la session sous forme de page web privée sur claude.ai. Une fois la variable définie, aucun fichier de paramètres ne peut réactiver l'outil. Pour désactiver plutôt l'outil depuis un fichier de paramètres, définissez enableArtifact sur false ; la clé dépréciée disableArtifact le désactive également
CLAUDE_CODE_DISABLE_ATTACHMENTS Définissez 1 pour désactiver le traitement des pièces jointes. Les mentions de fichiers avec la syntaxe @ sont envoyées en texte brut au lieu d'être développées en contenu de fichier
CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK Définissez 1 pour qu'un processus Claude Code exécute lui-même sa commande gcpAuthRefresh ou awsAuthRefresh au lieu d'attendre qu'un autre processus l'exécute. Nécessite Claude Code v2.1.286 ou ultérieur
CLAUDE_CODE_DISABLE_AUTO_MEMORY Définissez 1 pour désactiver la mémoire automatique. Définissez 0 pour forcer l'activation de 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 de fichiers de mémoire automatique
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS Définissez 1 pour désactiver toutes les fonctionnalités de tâches en arrière-plan, y compris le paramètre run_in_background des outils Bash et de sous-agent, la mise en arrière-plan automatique et le raccourci Ctrl+B
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT Définissez 1 pour empêcher Claude Code de traiter une réponse en streaming Amazon Bedrock dont l'en-tête Content-Type est absent ou vide comme le flux d'événements binaire d'Amazon Bedrock. Par défaut, Claude Code suppose qu'une passerelle a supprimé l'en-tête d'une réponse par ailleurs non modifiée ; il décode donc le corps et le streaming continue de fonctionner. Ne la définissez que pour une passerelle qui réémet également le flux sous forme de server-sent events ; Claude Code lit alors le corps sans en-tête comme des server-sent events. Nécessite Claude Code v2.1.239 ou ultérieur
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD Définissez 1 pour ignorer la vérification selon laquelle une réponse en streaming Amazon Bedrock porte le content-type application/vnd.amazon.eventstream. Sans cette variable, lorsqu'une réponse porte un autre content-type, Claude Code fait échouer la requête avec une erreur nommant ce type, ce qui signifie qu'une passerelle ou un proxy transforme la réponse. Configurez la passerelle pour qu'elle transmette l'en-tête Content-Type et le corps sans modification plutôt que de définir cette variable. Nécessite Claude Code v2.1.208 ou ultérieur
CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF Définissez 1 pour arrêter les commandes shell en arrière-plan et les workflows dynamiques en cours d'une session en arrière-plan, ainsi que, depuis la v2.1.198, ses sous-agents 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. N'affecte que ce transfert : mettre une session en arrière-plan avec ← ou /background transfère 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 1 pour empêcher Claude Code de terminer les commandes shell en arrière-plan en cas de pression mémoire. Par défaut, sous macOS et Linux, Claude Code termine les shells en arrière-plan lorsque le système d'exploitation signale une pression mémoire critique et que la session est inactive depuis 30 minutes sans tour ni sous-agent en cours. Windows n'a pas de signal de pression mémoire, cette variable n'y a donc aucun effet. Nécessite Claude Code v2.1.193 ou ultérieur
CLAUDE_CODE_DISABLE_BUNDLED_SKILLS Définissez 1 pour désactiver les skills et workflows inclus avec Claude Code : les skills et workflows fournis sont entièrement supprimés, tandis que les commandes intégrées comme /init restent saisissables mais sont masquées pour le modèle. /doctor reste saisissable comme les commandes intégrées ; masquez-la plutôt avec DISABLE_DOCTOR_COMMAND. Les skills provenant des plugins, de .claude/skills/ et de .claude/commands/ ne sont pas affectés. Équivalent au paramètre disableBundledSkills
CLAUDE_CODE_DISABLE_CFC_PROMPT Définissez 1 pour conserver les outils de navigateur Claude in Chrome tout en omettant la section Chrome du prompt système et le skill fourni /claude-in-chrome. Destiné aux hôtes qui intègrent Claude Code et fournissent leurs propres instructions de navigation. Nécessite Claude Code v2.1.257 ou ultérieur
CLAUDE_CODE_DISABLE_CLAUDE_MDS Définissez 1 pour empêcher le chargement de tout fichier mémoire CLAUDE.md dans le contexte, y compris les fichiers de mémoire utilisateur, de projet et de mémoire automatique
CLAUDE_CODE_DISABLE_CRON Définissez 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 celles déjà en cours d'exécution en cours de session
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT Définissez 1 pour désactiver la limite de temps sur les demandes de permission de suppression de chemins critiques. En mode auto, Claude Code envoie alors ces suppressions au classifieur, et en mode bypassPermissions, la demande attend votre réponse. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc env de paramètres. Nécessite Claude Code v2.1.281 ou ultérieur
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS Définissez 1 pour retirer des requêtes API les en-têtes de requête anthropic-beta de préversion, les champs de corps qui les accompagnent, et les champs bêta de schéma d'outil tels que defer_loading et eager_input_streaming. Utilisez-la lorsqu'une passerelle proxy rejette les requêtes avec une erreur Unexpected value(s) pour l'en-tête anthropic-beta ou une erreur Extra inputs are not permitted. Désactiver les capacités de préversion liste ce que la variable supprime, y compris la recherche d'outils MCP, et ce que Claude Code continue d'envoyer
CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS Définissez 1 pour désactiver les sous-agents Explore et Plan intégrés. Claude explore alors avec ses outils de recherche ou le sous-agent general-purpose, et le mode plan lit les fichiers directement au lieu de lancer les agents Explore et Plan. Les sous-agents personnalisés nommés Explore ou Plan ne sont pas affectés. Pour supprimer tous les types de sous-agents intégrés dans l'Agent SDK ou en mode non interactif, utilisez plutôt CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS. Nécessite Claude Code v2.1.198 ou ultérieur
CLAUDE_CODE_DISABLE_FAST_MODE Définissez 1 pour désactiver le mode rapide
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY Définissez 1 pour désactiver les enquêtes de qualité de session « How is Claude doing? ». Les enquêtes sont également désactivées lorsque DISABLE_TELEMETRY, DO_NOT_TRACK ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC est défini, sauf si CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL les réactive. Pour définir un taux d'échantillonnage au lieu de les désactiver complètement, utilisez le paramètre feedbackSurveyRate. Voir Enquêtes de qualité de session
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING Définissez 1 pour désactiver le checkpointing des fichiers. La commande /rewind ne pourra pas restaurer les modifications de code. Remplace le paramètre fileCheckpointingEnabled
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS Définissez 1 pour retirer du contexte de Claude les instructions intégrées de workflow de commit et de PR ainsi que l'instantané du statut git. Utile lorsque vous utilisez vos propres skills de workflow git. Lorsqu'elle est définie, elle est prioritaire sur le paramètre includeGitInstructions
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP Définissez 1 pour empêcher le remappage automatique d'Opus 4.0 et 4.1 vers la version actuelle d'Opus sur l'API Anthropic. À utiliser lorsque vous souhaitez délibérément épingler un ancien modèle. Le remappage ne s'exécute pas sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry
CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK Définissez 1 pour empêcher Claude Code, sur Amazon Bedrock et Google Cloud's Agent Platform, de basculer vers un modèle plus ancien lorsque votre compte perd l'accès au modèle d'une session en cours de session ; la requête refusée échoue alors immédiatement. Une chaîne de modèles de secours que vous configurez bascule toujours lors de ce refus, et les vérifications de modèle au démarrage se rabattent toujours sur un autre modèle au lancement. Nécessite Claude Code v2.1.285 ou ultérieur
CLAUDE_CODE_DISABLE_MOUSE Définissez 1 pour désactiver le suivi de la souris en rendu plein écran. Le défilement au clavier avec PgUp et PgDn fonctionne toujours. Utilisez-la pour conserver le comportement natif de copie à la sélection de votre terminal
CLAUDE_CODE_DISABLE_MOUSE_CLICKS Définissez 1 pour désactiver la gestion des clics, du glisser et du survol en rendu plein écran tout en conservant le défilement à la molette. Utilisez-la lorsque vous souhaitez que le défilement à la molette fonctionne dans Claude Code sans que les clics positionnent le curseur, développent la sortie des outils ou ouvrent des liens. CLAUDE_CODE_DISABLE_MOUSE est prioritaire lorsque les deux sont définies. Nécessite Claude Code v2.1.195 ou ultérieur
CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION Définissez 1 pour empêcher Claude Code de relire le certificat et la clé client mTLS lorsqu'une requête API échoue avec une erreur au niveau de la connexion, comme une réinitialisation de connexion ou une erreur de handshake TLS. Avec le rechargement désactivé, Claude Code ne charge les fichiers renouvelés que la prochaine fois qu'il applique les paramètres ou au prochain démarrage. Nécessite Claude Code v2.1.232 ou ultérieur
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC Définissez une valeur non vide quelconque, comme 1, pour désactiver le trafic réseau non essentiel : mises à jour automatiques, télémétrie, rapports d'erreurs, la commande /feedback, les retours rédigés par Claude, les notes de version, les vérifications du badge de statut des PR et MR et les vérifications de disponibilité telles que celle du mode rapide. Elle arrête également les exécutions en arrière-plan des sources command de plugins, qui sont des commandes locales plutôt que du trafic réseau, car elles peuvent déclencher des installations de dépendances. La définir à 0 ou false désactive tout de même ce trafic, contrairement à la plupart des variables d'activation ; supprimez la variable pour l'autoriser à nouveau. Désactive également la récupération des feature flags, ce qui rend indisponibles Remote Control et les autres fonctionnalités nécessitant la récupération des feature flags. L'installation automatique de la marketplace de plugins officielle n'est pas concernée ; désactivez-la avec CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL. N'affecte pas la découverte des modèles de passerelle, qui dispose de sa propre activation
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK Définissez 1 pour désactiver la solution de repli sans streaming lorsqu'une requête en streaming échoue en cours de flux. Les erreurs de streaming sont alors transmises à la couche de nouvelles tentatives. Utile lorsqu'un proxy ou une passerelle amène la solution de repli à exécuter des outils en double
CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK Définissez 1 pour envoyer la notification de bureau de l'outil PushNotification même lorsque vous tapez dans le terminal ou que celui-ci a le focus. Par défaut, l'outil ignore à la fois la notification de bureau et la notification push mobile lorsqu'il détecte une activité récente du clavier ou le focus du terminal. Cette variable désactive uniquement cette vérification locale ; le serveur peut donc toujours supprimer la notification push mobile lorsqu'il détecte que vous êtes actif. Nécessite Claude Code v2.1.193 ou ultérieur
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL Définissez 1 pour désactiver l'enregistrement automatique de la marketplace de plugins officielle. Claude Code lit la variable au moment d'enregistrer la marketplace, généralement lors du premier lancement interactif sur une machine. Si la variable est définie à ce moment-là, Claude Code ignore définitivement l'enregistrement. Supprimer la variable ultérieurement n'annule pas cet abandon. Exécutez claude plugin marketplace add anthropics/claude-plugins-official pour enregistrer la marketplace à tout moment
CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS Définissez 1 pour empêcher Claude Code d'exécuter vos hooks Notification pour les demandes de permission sans réponse dans les sessions où Claude Code les envoie au callback canUseTool de l'Agent SDK, ce qui correspond à la façon dont Claude Desktop et l'extension VS Code hébergent Claude Code. Sans effet dans les sessions de terminal. Nécessite Claude Code v2.1.233 ou ultérieur
CLAUDE_CODE_DISABLE_POLICY_SKILLS Définissez 1 pour ne pas charger les skills du répertoire de skills gérés à l'échelle du système. Utile pour les sessions en conteneur ou en CI qui ne doivent pas charger les skills provisionnés par l'opérateur
CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY Définissez 1 pour désactiver la vérification de l'outil PowerShell qui refuse les commandes intégrées cmd rd, rmdir, del et erase sur un chemin système, comme la racine d'un lecteur ou votre répertoire personnel. Claude Code ignore cette variable dans le bloc env d'un fichier de paramètres. Nécessite Claude Code v2.1.283 ou ultérieur
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS Définissez 1 pour empêcher Claude Code d'envoyer le champ de sortie structurée output_config.format et la valeur anthropic-beta associée, pour une passerelle LLM dont l'amont les rejette. Cela laisse activées les autres capacités de préversion que CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS désactive. Nécessite Claude Code v2.1.288 ou ultérieur
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT Définissez 1 pour désactiver la vérification de chemin critique pour un rm récursif dont la cible est entièrement la sortie d'une substitution de commande, comme rm -rf "$(pwd)". Les autres vérifications de chemins critiques continuent de s'exécuter. Définissez-la dans l'environnement qui lance Claude Code, car Claude Code ignore une copie fournie via un bloc env de paramètres. Nécessite Claude Code v2.1.281 ou ultérieur
CLAUDE_CODE_DISABLE_TERMINAL_TITLE Définissez 1 pour désactiver les mises à jour automatiques du titre du terminal basées sur le contexte de la conversation. Cela ignore également la requête en arrière-plan au modèle small/fast qui génère un titre de session
CLAUDE_CODE_DISABLE_THINKING Définissez 1 pour omettre entièrement le paramètre thinking des requêtes API. Il s'agit d'une option de compatibilité pour les proxys et passerelles qui rejettent ce paramètre. Sur les modèles qui réfléchissent par défaut, omettre le paramètre signifie que le modèle peut toujours réfléchir. Pour désactiver explicitement la réflexion étendue sur l'API Anthropic, utilisez plutôt MAX_THINKING_TOKENS=0. Aucune des deux variables ne désactive la réflexion sur Opus 5.5, Sonnet 5.5 ou les modèles Fable, sur lesquels la réflexion ne peut pas être désactivée. Chez les fournisseurs tiers, MAX_THINKING_TOKENS=0 omet également le paramètre, de sorte que les deux variables s'y comportent de la même manière
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT Définissez 1 pour ignorer la compaction automatique proactive lorsque Claude Code ne reconnaît pas l'ID du modèle, comme un alias de passerelle LLM. Sans cette variable, Claude Code compacte selon la fenêtre de contexte qu'il suppose pour l'ID. CLAUDE_CODE_MAX_CONTEXT_TOKENS peut plutôt corriger la fenêtre supposée ; voir Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé pour savoir quand chaque variable s'applique. Nécessite Claude Code v2.1.223 ou ultérieur
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL Définissez 1 pour désactiver le défilement virtuel en rendu plein écran et afficher chaque message de la transcription. Utilisez-la si le défilement en mode plein écran affiche des zones vides là où des messages devraient apparaître
CLAUDE_CODE_DISABLE_WEB_FETCH Définissez 1 pour désactiver l'outil WebFetch. L'outil WebSearch reste disponible. Nécessite Claude Code v2.1.285 ou ultérieur
CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER Définissez 1 pour démarrer directement les commandes de l'outil PowerShell sous Windows au lieu de passer par le lanceur cmd.exe. Par défaut, le lanceur permet à une commande PowerShell exécutée en arrière-plan d'être transférée au processus suivant de la session, par exemple lorsque vous mettez la session en arrière-plan. Si vous définissez la variable, une commande PowerShell en arrière-plan s'arrête lorsque le processus de la session se termine. Les commandes Bash ne sont pas affectées. Nécessite Claude Code v2.1.269 ou ultérieur
CLAUDE_CODE_DISABLE_WORKFLOWS Définissez 1 pour désactiver les workflows. Équivalent au paramètre disableWorkflows
CLAUDE_CODE_EFFORT_LEVEL Définit le niveau d'effort pour les modèles pris en charge. Valeurs : low, medium, high, xhigh, max, ou auto pour utiliser la valeur par défaut du modèle. Les niveaux disponibles dépendent du modèle. Prioritaire sur --effort, /effort et les paramètres modelSettings et effortLevel. Un plafond maxEffortLevel s'applique toujours. Voir Ajuster le niveau d'effort
CLAUDE_CODE_ENABLE_AUTO_MODE Acceptée pour la compatibilité avec les versions antérieures et sans effet. Le mode auto est disponible par défaut chez tous les fournisseurs, y compris Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry et les sessions Claude apps gateway connectées. De la v2.1.158 à la v2.1.206, définir cette variable à 1 était nécessaire pour rendre le mode auto disponible chez ces fournisseurs
CLAUDE_CODE_ENABLE_AWAY_SUMMARY Remplace la disponibilité du récapitulatif de session. Définissez 0 pour forcer la désactivation des récapitulatifs quel que soit le réglage /config. Définissez 1 pour forcer leur activation lorsque awaySummaryEnabled vaut false. Prioritaire sur le paramètre et le réglage /config
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH Définir sur 1 pour actualiser l'état des plugins 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 le prompt système en cours de session, ce qui invalide le prompt caching pour ce tour
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL Définir sur 1 pour acheminer l'enquête de qualité de session « How is Claude doing? » vers votre propre collecteur OpenTelemetry lorsque le trafic non essentiel destiné à Anthropic est bloqué. Les évaluations de l'enquête sont émises uniquement sous forme d'événements OTEL vers votre collecteur configuré. Aucune donnée d'enquête n'est envoyée à Anthropic dans ce mode. S'applique lorsque CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY ou DO_NOT_TRACK est défini, et n'a aucun effet sinon. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY et la politique de feedback produit de l'organisation ont priorité
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING Contrôle si les entrées des appels d'outils sont diffusées en streaming depuis l'API au fur et à mesure que Claude les génère. Lorsque cette option est désactivée, une entrée d'outil volumineuse, comme l'écriture d'un long fichier, n'arrive qu'une fois que Claude a fini de la générer, ce qui peut donner l'impression d'un blocage. Activé par défaut sur l'API Anthropic. Sur Amazon Bedrock et Google Cloud's Agent Platform, activé par modèle lorsque le conteneur déployé le prend en charge. Définir sur 0 pour le désactiver. Définir sur 1 pour forcer l'activation lors du routage via un proxy avec ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL ou ANTHROPIC_BEDROCK_BASE_URL. Désactivé par défaut sur Microsoft Foundry et les connexions via une passerelle
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY Définir sur 1 pour alimenter le sélecteur /model à partir de l'endpoint /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 reposant sur une clé API partagée montreraient sinon à chaque utilisateur tous les modèles auxquels la clé peut accéder. Les modèles découverts restent filtrés par une liste d'autorisation availableModels reçue par la session ; distribuez la liste via MDM ou un fichier de paramètres gérés, car la distribution gérée par le serveur n'est pas disponible sur les configurations de passerelle
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE Supprimée dans la v2.1.142, lorsque le mode rapide par défaut est passé d'Opus 4.6 à Opus 4.7
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION Définir sur false pour désactiver les suggestions de prompt, les prédictions grisées qui apparaissent dans votre zone de saisie. A priorité sur le paramètre promptSuggestionEnabled, qui est celui qu'écrit le bouton Prompt suggestions dans /config. Claude Code met également les suggestions en pause lorsque votre compte est proche de sa limite d'utilisation ou l'a atteinte. Définir sur true pour les conserver jusqu'à ce que vous atteigniez la limite. Nécessite Claude Code v2.1.238 ou ultérieur. Voir Suggestions de prompt
CLAUDE_CODE_ENABLE_TASKS Sélectionne les outils de suivi des tâches que Claude Code fournit dans les sessions qui en disposent. Par défaut, Claude Code fournit les outils Task TaskCreate, TaskUpdate, TaskGet et TaskList. Définir sur 0 pour obtenir à la place l'ancien outil TodoWrite. Voir Liste des tâches
CLAUDE_CODE_ENABLE_TELEMETRY Définir sur 1 pour activer la collecte de données OpenTelemetry pour les métriques et les logs. Requis avant de configurer les exportateurs OTel. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les paramètres de projet et locaux. Voir Surveillance
CLAUDE_CODE_ENABLE_TODO_TOOLS Définir sur 1 pour obtenir les outils de suivi des tâches sur tous les modèles. Sans cela, Claude Code ne les fournit par défaut que sur les modèles listés sous Disponibilité de l'outil Task. CLAUDE_CODE_ENABLE_TASKS sélectionne toujours les outils Task ou TodoWrite. Nécessite Claude Code v2.1.233 ou ultérieur
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY Durée en millisecondes à attendre après que la boucle de requêtes devient inactive avant de quitter automatiquement. Utile pour les workflows automatisés et les scripts utilisant le mode SDK
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS Définir sur 1 pour activer les équipes d'agents. Les équipes d'agents sont expérimentales et désactivées par défaut
CLAUDE_CODE_EXTRA_BODY Objet JSON à fusionner au niveau supérieur de chaque corps de requête API. Utile pour transmettre des paramètres propres à un 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 lancez avec claude agents ou --bg. Avant la v2.1.206, les sessions en arrière-plan ignoraient une valeur exportée depuis le shell et utilisaient la copie héritée par le processus superviseur en arrière-plan
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS Remplace la limite de tokens par défaut pour la lecture de fichiers. Utile lorsque vous devez lire intégralement des fichiers plus volumineux
CLAUDE_CODE_FORCE_SESSION_PERSISTENCE Définir sur 1 pour forcer la persistance de la transcription, l'historique des prompts et l'enregistrement dans claude agents, même lorsque ce claude a été lancé depuis une autre session Claude Code. À utiliser lorsqu'une valeur CLAUDE_CODE_CHILD_SESSION héritée, par exemple d'une session screen ou d'un lanceur en arrière-plan démarré à l'origine par l'outil Bash de Claude Code, fait qu'une véritable session de premier niveau est classée à tort comme imbriquée. Depuis la v2.1.178, Claude Code détecte automatiquement le cas de tmux et ignore le marqueur hérité, de sorte que tmux n'a plus besoin de cette variable. Également prise en compte dans la v2.1.169 et antérieures ; sans effet dans les v2.1.170 et v2.1.171, où la détection des sessions imbriquées qu'elle remplace avait été supprimée
CLAUDE_CODE_FORCE_STRIKETHROUGH Définir sur 1 pour forcer le rendu barré de ~~text~~ dans les réponses de Claude lorsque votre terminal le prend en charge mais n'est pas détecté automatiquement, par exemple via SSH sans transmission de TERM_PROGRAM. Sans cela, les terminaux non détectés affichent les marqueurs ~~ littéraux au lieu de rendre le texte barré. Nécessite Claude Code v2.1.186 ou ultérieur
CLAUDE_CODE_FORCE_SYNC_OUTPUT Définir sur 1 pour forcer l'activation de la sortie synchronisée du mode privé DEC 2026 lorsque votre terminal la prend en charge mais n'est pas détecté automatiquement. Utile pour les émulateurs tels qu'Emacs eat qui implémentent BSU/ESU mais ne répondent pas à la sonde de capacités. Sans effet sous tmux. Contrairement à CLAUDE_CODE_NO_FLICKER, qui bascule vers le rendu plein écran, cette variable ne change pas le moteur de rendu
CLAUDE_CODE_FORK_SUBAGENT Contrôle le mode fork, qui permet à Claude de lancer lui-même des sous-agents forkés et qui est activé par défaut uniquement dans les sessions interactives. Définir sur 1 pour l'activer également dans claude -p et l'Agent SDK, ou sur 0 pour le désactiver dans tous les types de sessions. Vous pouvez exécuter /subtask que le mode fork soit activé ou non. L'activation par défaut en mode interactif nécessite Claude Code v2.1.232 ou ultérieur ; dans les versions antérieures, définissez la variable sur 1 pour activer le mode fork
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT Définir sur 1 pour émettre le texte et les blocs de réflexion des sous-agents dans la sortie de claude -p --output-format stream-json, avec le même comportement que le flag --forward-subagent-text. Utilisez la variable lorsqu'un harnais invoque claude et ne peut pas transmettre le flag lui-même. Contrairement au flag, qui se termine avec une erreur en dehors du mode non interactif avec une sortie stream-json, la variable y est ignorée afin que les invocations imbriquées continuent de fonctionner lorsqu'elle est définie pour tout le processus. Nécessite Claude Code v2.1.211 ou ultérieur
CLAUDE_CODE_GATEWAY_HINT_HEADERS Définir sur 1 pour envoyer les en-têtes d'indication de passerelle, tels que x-claude-code-request-class et x-claude-code-compaction, vers un proxy personnalisé ou un fournisseur tiers tel qu'Amazon Bedrock ou Claude Platform on AWS. Définir sur 0 pour cesser de les envoyer sur toutes les connexions, y compris une connexion directe à l'API Anthropic, où Claude Code les envoie par défaut. Nécessite Claude Code v2.1.273 ou ultérieur
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS Délai d'expiration en millisecondes pour la requête de découverte des modèles de la passerelle qu'active CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY (par défaut : 3000). Augmentez-le lorsque votre passerelle a besoin de plus de trois secondes pour répondre à /v1/models au démarrage. N'accepte que des chiffres simples ; 0, les valeurs négatives et les autres écritures conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou ultérieur
CLAUDE_CODE_GIT_BASH_PATH Windows uniquement : chemin vers l'exécutable Git Bash (bash.exe). À utiliser lorsque Git Bash est installé mais ne figure pas dans votre PATH. Si le chemin n'existe pas ou si le fichier ne s'appelle pas bash.exe, sh.exe, bash ou sh, Claude Code ignore la variable et détecte automatiquement Git Bash comme si elle n'était pas définie, en consignant un avertissement visible avec --debug. Avant la v2.1.219, Claude Code se fermait au démarrage lorsque le chemin n'existait pas, et utilisait n'importe quel fichier existant comme shell sans vérifier qu'il s'agissait de bash ou sh. Voir Configuration sous Windows
CLAUDE_CODE_GLOB_HIDDEN Définir sur false pour exclure les fichiers cachés (dotfiles) des résultats lorsque Claude invoque l'outil Glob. Inclus par défaut. N'affecte pas l'autocomplétion de fichiers @, ls, Grep ni Read
CLAUDE_CODE_GLOB_NO_IGNORE Définir sur false pour que l'outil Glob respecte les motifs .gitignore. Par défaut, Glob renvoie tous les fichiers correspondants, y compris ceux ignorés par Git. N'affecte pas l'autocomplétion de fichiers @, qui dispose de son propre paramètre respectGitignore
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS Délai d'expiration en secondes pour la découverte de fichiers par l'outil Glob. 20 secondes par défaut sur la plupart des plateformes et 60 secondes sur WSL
CLAUDE_CODE_GOAL_CHECKIN_MINUTES Nombre de minutes pendant lesquelles un travail en arrière-plan peut maintenir un objectif actif en attente avant que Claude Code demande à Claude de le vérifier. Valeur par défaut : 30. Définir sur 0 pour désactiver les vérifications. Indiquez des minutes entières en chiffres simples, au maximum 10080, soit une semaine. Claude Code traite toute autre valeur comme non définie et utilise la valeur par défaut. Nécessite Claude Code v2.1.234 ou ultérieur
CLAUDE_CODE_HIDE_CWD Définir 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 révèle votre nom d'utilisateur système
CLAUDE_CODE_IDE_HOST_OVERRIDE Remplace l'adresse de l'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 de WSL vers Windows
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL Définir sur 1 pour ignorer l'installation automatique des extensions IDE. Équivaut à définir autoInstallIdeExtension sur false
CLAUDE_CODE_IDE_SKIP_VALID_CHECK Définir sur 1 pour ignorer la validation des entrées du fichier de verrouillage de l'IDE lors de la connexion. À utiliser lorsque la connexion automatique ne trouve pas votre IDE alors qu'il est en cours d'exécution
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS Nombre de sous-agents pouvant s'exécuter dans une session avant que l'outil Agent refuse d'en lancer un autre (par défaut : 20). Accepte un nombre entier positif en chiffres simples ; toute autre valeur est ignorée, de sorte que la variable peut ajuster le plafond mais pas le désactiver. Nécessite Claude Code v2.1.217 ou ultérieur
CLAUDE_CODE_MAX_CONTEXT_TOKENS Remplace la taille de la fenêtre de contexte que Claude Code suppose pour le modèle actif. Depuis la v2.1.193, la manière dont elle s'applique dépend de la façon dont Claude Code résout l'ID du modèle ; voir Corriger la fenêtre pour une passerelle ou un ID de modèle personnalisé. À 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 associée à son nom
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH Longueur maximale en caractères de chaque description d'outil MCP et des instructions de chaque serveur MCP que Claude Code envoie au modèle (par défaut : 2048). Claude Code tronque les textes plus longs. Accepte un nombre entier positif en chiffres simples. Toute autre valeur est ignorée et la valeur par défaut s'applique. Nécessite Claude Code v2.1.280 ou ultérieur
CLAUDE_CODE_MAX_OUTPUT_TOKENS Définit le nombre maximal de tokens de sortie pour la plupart des requêtes. Les valeurs par défaut et les plafonds varient selon le modèle ; voir tokens de sortie maximum. Claude Code ramène au plafond toute valeur qui dépasse le plafond d'un modèle. Pour un ID de modèle que Claude Code ne peut pas associer à un modèle connu, la valeur par défaut est 32000 et le plafond est 128000. Augmenter cette valeur réduit la fenêtre de contexte effective disponible avant le déclenchement de la compaction automatique
CLAUDE_CODE_MAX_RETRIES Remplace le nombre de nouvelles tentatives pour les requêtes API ayant échoué (par défaut : 10). Plafonné à 15 depuis la v2.1.186 ; depuis la v2.1.199, CLAUDE_CODE_RETRY_WATCHDOG augmente la valeur par défaut et supprime le plafond. Pour les sessions sans surveillance qui doivent patienter pendant des pannes plus longues, définissez plutôt CLAUDE_CODE_RETRY_WATCHDOG
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION Supprimée dans la v2.1.224 et désormais sans effet. Plafonnait auparavant le nombre total de sous-agents que Claude pouvait lancer avec l'outil Agent dans une session (par défaut : 200) ; tout lancement au-delà du plafond échouait avec Subagent spawn limit reached. La limite de sous-agents simultanés et la limite de profondeur s'appliquent toujours
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH Nombre de niveaux de sous-agents autorisés sous la conversation principale (par défaut : 3). Avec la valeur par défaut, les sous-agents peuvent lancer leurs propres sous-agents, et un sous-agent au troisième niveau ne peut pas en lancer d'autres ; définir sur 1 pour désactiver l'imbrication. Dans les v2.1.217 à v2.1.218, la valeur par défaut était 1, de sorte qu'un sous-agent ne pouvait pas lancer les siens à moins que vous n'augmentiez la limite ; la v2.1.219 a porté la valeur par défaut à 3. Accepte un nombre entier positif en chiffres simples ; toute autre valeur est ignorée, de sorte que la limite peut être ajustée mais pas supprimée. Nécessite Claude Code v2.1.217 ou ultérieur
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY Nombre maximal d'outils en lecture seule et de sous-agents pouvant s'exécuter en parallèle (par défaut : 10). Des valeurs plus élevées augmentent le parallélisme mais consomment davantage de ressources
CLAUDE_CODE_MAX_TURNS Plafonne le nombre de tours agentiques lorsqu'aucune limite explicite n'est transmise. Équivaut à transmettre --max-turns, qui a 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 au lieu d'être traitée comme une absence de plafond
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION Plafond du nombre total d'appels WebSearch qu'une session peut effectuer (par défaut : 200). Lorsque Claude atteint le plafond, les appels WebSearch suivants renvoient un avis lui indiquant de continuer avec les informations déjà recueillies. Accepte un nombre entier positif sans limite supérieure. Toute autre valeur est ignorée et la valeur par défaut s'applique, de sorte que le plafond peut être relevé mais pas désactivé. Nécessite Claude Code v2.1.212 ou ultérieur
CLAUDE_CODE_MCP_ALLOWLIST_ENV Définir sur 1 pour lancer les serveurs MCP stdio avec uniquement un environnement de base sûr plus l'env configuré du serveur, au lieu d'hériter de l'environnement de votre shell
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS Temps écoulé en millisecondes avant qu'un appel d'outil MCP encore en cours passe en tâche en arrière-plan (par défaut : 120000, soit 2 minutes). Définir sur 0 pour désactiver le passage automatique en arrière-plan. Nécessite Claude Code v2.1.212 ou ultérieur
CLAUDE_CODE_MCP_STARTUP_WAIT_MS Durée en millisecondes pendant laquelle le premier tour d'une session non interactive attend les serveurs MCP encore en cours de connexion, à la place de l'attente du premier tour par défaut. Lorsqu'elle est définie, l'attente couvre tous les serveurs en attente. Définir sur 0 pour ignorer l'attente. Un serveur --permission-prompt-tool conserve sa propre attente MCP_TIMEOUT quelle que soit la valeur. Nécessite Claude Code v2.1.274 ou ultérieur
CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT Délai d'inactivité en millisecondes pour les appels d'outils MCP. Lorsqu'un serveur MCP stdio, HTTP, SSE, WebSocket ou connecteur claude.ai n'envoie ni réponse ni notification de progression pendant cette durée, l'appel d'outil s'interrompt avec une erreur au lieu d'attendre le MCP_TOOL_TIMEOUT global. Remplace les valeurs par défaut par transport de 300000 (5 minutes) pour les serveurs réseau et de 1800000 (30 minutes) pour les serveurs stdio. Définir sur 0 pour désactiver la vérification d'inactivité. Les valeurs inférieures à 1000 sont portées à une seconde, et la valeur est plafonnée au MCP_TOOL_TIMEOUT effectif. Un timeout par serveur d'au moins 1000 dans .mcp.json porte la fenêtre d'inactivité de ce serveur à au moins la valeur de timeout. Ne s'applique pas aux serveurs IDE ni aux serveurs SDK in-process. Nécessite Claude Code v2.1.187 ou ultérieur. Avant la v2.1.203, les serveurs stdio étaient exemptés du délai d'inactivité
CLAUDE_CODE_MESSAGING_SOCKET Définie par Claude Code, pas par vous : dans les sessions qui lient un socket de boîte de réception, Claude Code exporte le chemin de ce socket vers les hooks et les commandes Bash lorsqu'il lie le socket. Dans une session qui démarre avec la messagerie activée, Claude Code lie le socket avant l'exécution de tout hook. Les autres sessions de la machine délivrent des messages vers ce chemin. Chaque session exporte son propre socket plutôt qu'un socket hérité d'un parent, et les messages qui y arrivent passent par les contrôles entrants de la session. Les blocs env des paramètres ne peuvent pas la définir. Nécessite Claude Code v2.1.224 ou ultérieur
CLAUDE_CODE_MESSAGING_TOKEN Définie par Claude Code, pas par vous : dans les sessions qui lient un socket de boîte de réception, Claude Code exporte ce jeton propre à la session vers les hooks et les commandes Bash, en même temps que CLAUDE_CODE_MESSAGING_SOCKET. Un script qui écrit sur le socket peut envoyer {"type":"auth","token":"<token>"} comme première ligne pour prouver qu'il appartient à la session. Sous Windows natif, Claude Code exige cette ligne et ferme toute connexion qui ne s'ouvre pas avec une ligne valide. Les règles des processus enfants propres indiquent quand Claude Code consulte le jeton. Chaque session exporte son propre jeton, jamais un jeton hérité d'une session parente. Les blocs env des paramètres ne peuvent pas la définir. Nécessite Claude Code v2.1.228 ou ultérieur
CLAUDE_CODE_NATIVE_CURSOR Définir sur 1 pour afficher le curseur propre au terminal au point d'insertion au lieu d'un bloc dessiné. Le curseur respecte les paramètres de clignotement, de forme et de focus du terminal
CLAUDE_CODE_NEW_INIT Définir sur 1 pour que /init exécute un flux de configuration interactif. Le flux demande quels fichiers générer, notamment CLAUDE.md, les skills et les hooks, avant d'explorer la base de code et de les écrire. Sans cette variable, /init génère automatiquement un CLAUDE.md sans rien demander
CLAUDE_CODE_NONBLOCKING_STDOUT Définir sur 1 pour écrire la sortie du terminal via un second descripteur de fichier non bloquant, afin qu'un terminal qui cesse de lire, comme un volet tmux en mode contrôle mis en pause ou une connexion SSH bloquée, ne puisse pas figer Claude Code en cours de session. S'applique sur macOS, Linux et WSL lorsque stdout est un terminal. Nécessite Claude Code v2.1.261 ou ultérieur
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES Limite le nombre de fois où Claude Code renvoie une requête non streaming qui expire. Avec 0, la requête échoue dès le premier délai d'expiration. Non définie par défaut, de sorte que CLAUDE_CODE_MAX_RETRIES limite ces renvois. Voir Ajuster le comportement des nouvelles tentatives pour le délai d'expiration. Nécessite Claude Code v2.1.285 ou ultérieur
CLAUDE_CODE_NO_FLICKER Définir sur 1 pour activer le rendu plein écran, une research preview qui réduit le scintillement et maintient une consommation de mémoire stable dans les longues conversations. Remplace le paramètre tui ; vous pouvez également basculer avec /tui fullscreen
CLAUDE_CODE_OAUTH_REFRESH_TOKEN Jeton d'actualisation OAuth pour l'authentification Claude.ai. Lorsqu'il est défini, claude auth login échange directement ce jeton au lieu d'ouvrir un navigateur. Nécessite CLAUDE_CODE_OAUTH_SCOPES. Utile pour provisionner l'authentification dans des environnements automatisés
CLAUDE_CODE_OAUTH_SCOPES Scopes OAuth séparés par des espaces avec lesquels le jeton d'actualisation a été émis, par exemple "user:profile user:inference user:sessions:claude_code". Requis lorsque CLAUDE_CODE_OAUTH_REFRESH_TOKEN est défini
CLAUDE_CODE_OAUTH_TOKEN Jeton d'accès OAuth pour l'authentification claude.ai. Alternative à /login pour le SDK et les environnements automatisés. A priorité sur les identifiants stockés dans le trousseau. Générez-en un avec claude setup-token. Sauf si vous exécutez /login, Claude Code utilise le jeton que vous avez défini pendant toute la session. Pour remplacer un jeton expiré, générez-en un nouveau et redémarrez
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE Supprimée dans la v2.1.160 et désormais sans effet. Épinglait auparavant le mode rapide sur Claude Opus 4.6 au lieu du modèle par défaut actuel. Opus 4.6 ne prend plus en charge le mode rapide
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH Longueur maximale des attributs OpenTelemetry porteurs de contenu (réponses du modèle, contenu des outils, prompts système, corps bruts de l'API), marqueur de troncature inclus, en unités de code UTF-16 (par défaut : 61440, soit 60 Ko). Augmentez-la uniquement si votre backend de télémétrie accepte des valeurs d'attribut supérieures à 64 Ko, ou réduisez-la pour diminuer le volume de télémétrie. Nécessite Claude Code v2.1.214 ou ultérieur. Voir Surveillance
CLAUDE_CODE_OTEL_DIAG_STDERR Définir 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é, par exemple en cas de conflit de port Prometheus, échoue sinon silencieusement. 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 le vidage des spans OpenTelemetry en attente (par défaut : 5000). Voir Surveillance
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS Intervalle d'actualisation des en-têtes OpenTelemetry dynamiques en millisecondes (par défaut : 1740000 / 29 minutes). Voir En-têtes dynamiques
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS Délai d'expiration en millisecondes accordé à l'exportateur OpenTelemetry pour terminer lors de l'arrêt (par défaut : 2000). Augmentez-le si des métriques sont perdues à la sortie. Voir Surveillance
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE Définir sur 1 pour permettre à Claude Code d'exécuter en arrière-plan la commande de mise à niveau de votre gestionnaire de paquets lorsqu'une nouvelle version est disponible. S'applique aux installations Homebrew et WinGet. Les autres gestionnaires de paquets continuent d'afficher la commande de mise à niveau sans l'exécuter. Voir Mises à jour automatiques
CLAUDE_CODE_PERFORCE_MODE Définir sur 1 pour activer la protection en écriture compatible avec Perforce. Lorsqu'elle est définie, Edit, Write et NotebookEdit échouent avec une indication p4 edit <file> si le fichier cible ne possède pas le bit d'écriture du propriétaire, que Perforce retire 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 Remplace le répertoire racine des plugins. Malgré son nom, cette variable définit le répertoire parent, pas le cache lui-même : les marketplaces et le cache des plugins se trouvent dans des sous-répertoires de ce chemin. Par défaut : ~/.claude/plugins
CLAUDE_CODE_PLUGIN_DIRS Répertoires de plugins à charger pour la session, chacun chargé de la même manière qu'avec un flag --plugin-dir. Séparez plusieurs chemins par : sous Unix ou ; sous Windows. Indiquez chaque chemin sous forme de chemin absolu ou commencez-le par ~, car Claude Code ignore les chemins relatifs. Nécessite Claude Code v2.1.280 ou ultérieur. Voir Charger un plugin pour une session
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS Délai d'expiration en millisecondes pour le clonage ou l'actualisation d'une marketplace de plugins (par défaut : 120000). Augmentez cette valeur pour les dépôts volumineux ou les connexions réseau lentes. Voir Git clone timed out
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE Définir sur 1 pour ignorer la tentative de reclonage et continuer à utiliser le checkout existant de la marketplace lorsqu'une actualisation de marketplace ne parvient pas à joindre le dépôt distant ou à s'y authentifier. Utile dans les environnements hors ligne ou isolés (airgapped) où un reclonage échouerait de la même manière. Voir Les mises à jour de marketplace échouent dans les environnements hors ligne
CLAUDE_CODE_PLUGIN_PREFER_HTTPS Définir sur 1 pour cloner les sources GitHub au format abrégé owner/repo via HTTPS plutôt que SSH. S'applique à l'installation et à la mise à jour des plugins, ainsi qu'à /plugin marketplace add et update. Utile sur les runners CI, dans les conteneurs ou dans tout environnement sans clé SSH configurée pour github.com
CLAUDE_CODE_PLUGIN_SEED_DIR Chemin vers un ou plusieurs répertoires d'amorçage de plugins en lecture seule, séparés par : sous Unix ou ; sous Windows. Utilisez-la pour intégrer un répertoire de plugins préremplis dans une image de conteneur. Claude Code enregistre les marketplaces de ces répertoires au démarrage et utilise les plugins déjà mis en cache sans les recloner. Voir Préremplir les plugins pour les conteneurs
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY Définir sur 1 pour empêcher Claude Code de transmettre -ExecutionPolicy Bypass lorsqu'il lance PowerShell pour les appels d'outils, les hooks et les commandes de la barre de statut, et respecter à la place la stratégie d'exécution effective de la machine. Par défaut, Claude Code contourne la stratégie d'exécution au niveau du processus afin que les scripts .ps1 et les importations de modules fonctionnent sur les installations Windows configurées par défaut en mode Restricted. Le contournement au niveau du processus ne remplace jamais les stratégies de groupe MachinePolicy ou UserPolicy, quel que soit ce paramètre
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS Plafond en millisecondes de l'attente inactive des sous-agents et workflows en arrière-plan après le dernier tour en mode non interactif avec le flag -p. L'attente inactive redémarre chaque fois que Claude effectue un tour pour traiter un résultat en arrière-plan. Par défaut : 600000, soit 10 minutes. Lorsque l'attente inactive atteint le plafond, Claude Code cesse d'attendre les tâches en arrière-plan restantes et se ferme. Définir sur 0 pour attendre indéfiniment. Ce plafond est distinct du délai de grâce de cinq secondes qui s'applique aux shells en arrière-plan simples. Nécessite Claude Code v2.1.182 ou ultérieur
CLAUDE_CODE_PROCESS_WRAPPER Lance les processus que Claude Code démarre à partir de son propre binaire, comme le service en arrière-plan qui héberge les sessions de la vue agents, via un lanceur d'entreprise indiqué sous forme de préfixe argv tel que /opt/corp/launcher. Définissez-la dans le bloc env des paramètres utilisateur ou des paramètres gérés, et non sous forme d'export shell, afin que le service en arrière-plan détaché en hérite ; les paramètres de projet et locaux ne peuvent pas la définir. Équivaut au paramètre processWrapper, qui nécessite Claude Code v2.1.210 ou ultérieur ; cette variable a priorité lorsque les deux sont définis. L'extension VS Code configure son propre lanceur séparément via son paramètre claudeProcessWrapper. Ignorée sous Windows. Voir Exécuter Claude Code derrière un lanceur d'entreprise pour le format de la valeur, ce que couvre le lanceur et le contrat que le lanceur doit respecter. Nécessite Claude Code v2.1.208 ou ultérieur
CLAUDE_CODE_PROJECT_DIR_NAME À définir avec CLAUDE_CONFIG_DIR pour choisir le nom du répertoire projects/ sous lequel Claude Code stocke les transcriptions et la mémoire automatique de cette session, à la place d'un nom dérivé du chemin du répertoire de travail. Par exemple, démarrer Claude Code avec CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude les stocke sous /srv/tenant-a/projects/work/. Claude Code ignore cette variable lorsque CLAUDE_CONFIG_DIR n'est pas définie, et ne la lit que depuis l'environnement à partir duquel vous lancez claude, jamais depuis un bloc env d'un fichier de paramètres. Voir Nommer vous-même le répertoire du projet. Nécessite Claude Code v2.1.234 ou ultérieur
CLAUDE_CODE_PROMPT_CACHE_TTL Définir sur 5m ou 1h, les seules valeurs acceptées par Claude Code, pour choisir le TTL du cache de prompts de la conversation principale : vos tours interactifs, -p et SDK, ainsi que les assistants qui s'exécutent en ligne avec eux. A priorité sur le paramètre promptCacheTtl et sur ENABLE_PROMPT_CACHING_1H, et FORCE_PROMPT_CACHING_5M la remplace. L'API facture les écritures en cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur
CLAUDE_CODE_PROPAGATE_TRACEPARENT Définir 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 des requêtes vers le modèle et vers les serveurs MCP HTTP, ainsi que la variable d'environnement TRACEPARENT pour les sous-processus Bash, PowerShell et des hooks. Par défaut, la propagation n'est activée qu'en cas de connexion directe à l'API Anthropic. Ajoutée dans la v2.1.152. Voir Traces (bêta)
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST Définie par les plateformes hôtes qui intègrent Claude Code et gèrent le routage vers le fournisseur de modèles en son nom. Lorsqu'elle est définie, Claude Code ignore les variables de sélection du fournisseur, d'endpoint et d'authentification telles que CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL et ANTHROPIC_API_KEY dans les fichiers de paramètres, de sorte que les paramètres utilisateur ne peuvent pas remplacer le routage de l'hôte. Claude Code ignore également les clés de sélection de modèle telles que model, fallbackModel et modelOverrides dans les paramètres gérés, quelle que soit la source gérée qui les fournit, de sorte que la configuration de modèle de l'hôte a priorité sur un épinglage de modèle géré obsolète. Claude Code ignore aussi les variables de sélection de modèle telles que ANTHROPIC_MODEL et la famille ANTHROPIC_DEFAULT_*_MODEL dans un bloc env géré ; une liste d'autorisation availableModels dans les paramètres gérés s'applique toujours, sauf si l'hôte fournit la sienne. Claude Code ignore également la désactivation automatique de la télémétrie qu'il applique sinon sur les fournisseurs tiers tels qu'Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform et Microsoft Foundry, de sorte que la télémétrie suit la désactivation standard DISABLE_TELEMETRY. Voir Comportements par défaut selon le fournisseur d'API
CLAUDE_CODE_PROXY_RESOLVES_HOSTS Définir sur 1 pour permettre au proxy d'effectuer la résolution DNS à la place de l'appelant. Option à activer pour les environnements où le proxy doit gérer la résolution des noms d'hôte
CLAUDE_CODE_REMOTE Définie automatiquement sur true lorsque Claude Code s'exécute en tant que session cloud. Lisez-la depuis un hook ou un script de configuration pour détecter si vous êtes dans une session cloud
CLAUDE_CODE_REMOTE_SESSION_ID Définie automatiquement dans les sessions cloud sur l'ID de la session en cours. Lisez-la pour construire un lien vers la transcription de la session. Voir Relier la sortie à la session
CLAUDE_CODE_RESTRICTED Définir sur 1 pour démarrer la session en mode restreint, comme en transmettant --restricted. Claude Code ignore cette variable dans le bloc env d'un fichier de paramètres. Nécessite Claude Code v2.1.248 ou ultérieur
CLAUDE_CODE_RESUME_INTERRUPTED_TURN Définir sur 1 pour reprendre automatiquement si la session précédente s'est terminée en cours de tour. Utilisée en mode SDK pour que le modèle continue sans que le SDK ait à renvoyer le prompt. Pour la désactiver, supprimez la variable ou définissez-la sur 0. Pour le panneau de chat VS Code, voir Poursuivre les conversations après un rechargement
CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS Âge maximal en millisecondes du dernier message de la transcription pour qu'une session terminée en cours de tour continue automatiquement à la reprise. Lorsque le dernier message est plus ancien que cette limite, Claude Code ignore la reprise automatique CLAUDE_CODE_RESUME_INTERRUPTED_TURN et son message de continuation CLAUDE_CODE_RESUME_PROMPT, et la session démarre inactive afin que vous continuiez explicitement. Non définie ou 0 signifie aucune limite, sauf qu'un tour dont la dernière requête a échoué avec une erreur API ne reprend que si cette erreur date de moins de six heures. Une valeur positive limite chaque tour, y compris ceux-ci ; une valeur négative ou non numérique applique une limite d'une heure. Les scripts de lancement d'agents de longue durée peuvent la définir afin qu'un redémarrage sur une ancienne transcription ne réexécute pas un prompt obsolète. Claude Code définit lui-même une limite d'une heure lorsqu'il redémarre une session de la vue agents ayant planté qui a hérité sa conversation d'une session interactive. Nécessite Claude Code v2.1.211 ou ultérieur
CLAUDE_CODE_RESUME_PROMPT Remplace le message de continuation que Claude Code envoie à Claude lorsque CLAUDE_CODE_RESUME_INTERRUPTED_TURN poursuit un tour interrompu au lieu de renvoyer son prompt, ou lorsque vous reprenez un appel d'outil différé avec -p. Par défaut : Continue from where you left off.. Une chaîne vide utilise la valeur par défaut
CLAUDE_CODE_RETRY_WATCHDOG Définir sur 1 pour les sessions sans surveillance telles que les harnais d'évaluation, les jobs CI ou les workers distants. Réessaie indéfiniment les erreurs de capacité 429 et 529 au lieu d'échouer après CLAUDE_CODE_MAX_RETRIES tentatives. Claude Code échoue immédiatement lorsqu'une requête à vitesse standard reçoit une erreur 429 signalant une limite de dépenses ou des crédits d'utilisation épuisés, même si elle provient d'un plafond de dépenses de passerelle qui se réinitialise selon un calendrier. Avant la v2.1.239, le watchdog réessayait ces requêtes indéfiniment. Pour les requêtes en mode rapide, voir Gérer les limites de débit. Le watchdog espace les tentatives jusqu'à 5 minutes, ou jusqu'à la réinitialisation de la limite lorsque la réponse contient une heure de réinitialisation de la limite de débit, de sorte qu'une session qui atteint une limite d'utilisation attend la fin de la fenêtre restante. Dans la v2.1.199 ou ultérieure, il porte également à 300 le nombre de nouvelles tentatives par défaut pour les autres erreurs transitoires, telles que les erreurs serveur, les délais d'expiration et les connexions interrompues, soit environ trois heures d'attente progressive, et supprime le plafond de 15 sur CLAUDE_CODE_MAX_RETRIES si vous définissez explicitement cette variable. Nécessite Claude Code v2.1.186 ou ultérieur
CLAUDE_CODE_SAFE_MODE Définir sur 1 pour démarrer en mode sans échec : CLAUDE.md, les skills, les plugins, les hooks, les serveurs MCP, les commandes et agents personnalisés, les styles de sortie, les workflows, les thèmes personnalisés, les raccourcis clavier personnalisés, les commandes de barre de statut et de suggestion de fichiers, les serveurs LSP et la mémoire automatique ne sont pas chargés, afin de dépanner une configuration défaillante. La politique des paramètres gérés s'applique toujours, y compris les hooks, la barre de statut et les commandes de suggestion de fichiers configurés par la politique ; ce n'est pas le cas des plugins gérés, des skills gérés, du CLAUDE.md géré et des serveurs MCP configurés par la politique. Équivaut à transmettre --safe-mode. Les processus enfants lancés directement héritent de la variable
CLAUDE_CODE_SCRIPT_CAPS Objet JSON limitant le nombre de fois où des scripts spécifiques peuvent être invoqués par session lorsque CLAUDE_CODE_SUBPROCESS_ENV_SCRUB est défini. Les clés sont des sous-chaînes comparées au texte de la commande ; les valeurs sont des limites d'appels entières. Par exemple, {"deploy.sh": 2} permet d'appeler deploy.sh au maximum deux fois. La correspondance repose sur des sous-chaînes, de sorte que les astuces d'expansion du shell comme ./scripts/deploy.sh $(evil) sont tout de même comptabilisées dans le plafond. La démultiplication à l'exécution 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éfinit le multiplicateur de défilement de la molette de la souris en rendu plein écran. Accepte toute valeur positive jusqu'à 20, y compris des valeurs fractionnaires inférieures à 1 comme 0.5 pour ralentir le défilement accéléré du trackpad et de la molette dans les terminaux qui amplifient déjà les événements de molette. Définir sur 3 pour correspondre à vim si votre terminal envoie un événement de molette par cran sans amplification. Ignorée dans le terminal des IDE JetBrains, où Claude Code utilise sa propre gestion du défilement
CLAUDE_CODE_SEND_FEEDBACK Définir sur 0 pour désactiver le feedback rédigé par Claude pour une session. Définir sur 1 pour l'activer lorsque votre compte y a déjà accès ; la variable ne peut pas accorder l'accès elle-même, et les autres options qui désactivent le feedback, telles que DISABLE_FEEDBACK_COMMAND et la valeur off du paramètre feedbackDrafts, s'appliquent toujours
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS Remplace le budget de temps en millisecondes des hooks SessionEnd. La valeur sert également de délai d'expiration pour chaque hook qui ne définit pas son propre timeout. S'applique à la sortie de session, à /clear et au changement de session via /resume en mode interactif. Par défaut, le budget est de 1,5 seconde, automatiquement porté au timeout par hook le plus élevé configuré dans les fichiers de paramètres, jusqu'à 60 secondes. Les délais d'expiration des hooks fournis par des plugins n'augmentent pas le budget
CLAUDE_CODE_SESSION_ID Définie automatiquement sur l'ID de la session en cours dans les sous-processus des outils Bash et PowerShell, les sous-processus des commandes de hook et les sous-processus des serveurs MCP stdio. Pour Bash, PowerShell et les hooks, elle correspond au champ session_id de l'entrée JSON du hook et est mise à jour lors de /clear. Un sous-processus de serveur MCP conserve l'ID avec lequel il a été lancé. Avec --resume <session-id>, il reçoit l'ID de la session reprise, comme les hooks et Bash. Avec --continue ou --resume sans ID explicite, il peut recevoir à la place l'ID initial du démarrage. À utiliser pour corréler les scripts et les outils externes avec la session Claude Code qui les a lancés
CLAUDE_CODE_SHELL Définit 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 fonctionnel, Claude Code l'ignore et revient à la détection automatique. La détection automatique utilise votre $SHELL lorsqu'il pointe vers bash ou zsh, sinon elle choisit le premier zsh puis bash fonctionnel trouvé dans votre PATH et les emplacements d'installation standard
CLAUDE_CODE_SHELL_PREFIX Préfixe de commande qui encapsule les commandes shell que Claude Code lance : les appels de l'outil Bash, les commandes de hook, les commandes de barre de statut et les commandes de démarrage des serveurs MCP stdio. Les hooks PowerShell et les hooks au format exec s'exécutent sans le préfixe. Utile pour la journalisation ou l'audit. Définir un simple chemin d'exécutable tel que /path/to/logger.sh exécute chaque commande sous la forme /path/to/logger.sh '<command>'. Le wrapper reçoit la ligne de commande sous la forme d'un seul argument entre guillemets shell dans $1, il doit donc réévaluer $1 avec un shell, par exemple exec bash -c "$1". Traiter $1 comme un simple chemin d'exécutable casse les serveurs MCP stdio qui transmettent des arguments tels que npx -y <package>. Pour les appels de l'outil Bash, $1 contient l'invocation shell complète assemblée par Claude Code, y compris la configuration de l'environnement, et pas seulement la commande exécutée par Claude
CLAUDE_CODE_SIMPLE Définir sur 1 pour s'exécuter avec un prompt système minimal et uniquement les outils Bash, de lecture de fichiers et de modification de fichiers. Les outils MCP provenant de --mcp-config restent disponibles. Désactive la découverte automatique des hooks, des skills, des commandes personnalisées, des sous-agents, des plugins installés, des serveurs MCP, de la mémoire automatique et de CLAUDE.md. Les skills d'un répertoire que vous transmettez avec --add-dir sont toujours chargés. Les jetons OAuth et les identifiants du trousseau ne sont pas lus, l'authentification Anthropic doit donc provenir de ANTHROPIC_API_KEY ou d'un apiKeyHelper dans --settings. Équivaut à transmettre --bare
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT Définir sur 1 pour utiliser un prompt système plus court et des descriptions d'outils abrégées sur n'importe quel modèle. Définir sur 0, false, no ou off pour le désactiver, même sur les modèles où l'expérimentation ou la configuration du serveur l'activeraient sinon. L'ensemble complet des outils, les hooks, les serveurs MCP et la découverte de CLAUDE.md restent activés
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH Ignore l'authentification côté client pour Claude Platform on AWS, pour les passerelles qui signent elles-mêmes les requêtes
CLAUDE_CODE_SKIP_AWS_CRED_CACHE Définir sur 1 pour désactiver le cache en mémoire du processus des identifiants résolus depuis la chaîne de fournisseurs d'identifiants AWS par défaut, afin que Claude Code résolve la chaîne à chaque requête API. Lorsque le cache est désactivé, un profil reposant sur 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 Ignore l'authentification AWS pour Amazon Bedrock (par exemple, lors de l'utilisation d'une passerelle LLM)
CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS Définir sur 1 pour traiter un échec de la vérification de disponibilité du mode rapide comme une disponibilité, pour les réseaux qui bloquent la requête directe de la vérification vers api.anthropic.com. Claude Code respecte toujours une réponse « disabled by your organization »
CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK Définir sur 1 pour ignorer la vérification côté client de la disponibilité du mode rapide, pour les proxys qui interceptent la requête de vérification au lieu de la refuser. L'API rejette toujours les requêtes en mode rapide lorsque votre organisation a désactivé le mode rapide
CLAUDE_CODE_SKIP_FOUNDRY_AUTH Ignore 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 conserve l'en-tête Authorization que vous fournissez, par exemple via ANTHROPIC_CUSTOM_HEADERS. Ignorée lorsque ANTHROPIC_FOUNDRY_API_KEY ou ANTHROPIC_FOUNDRY_AUTH_TOKEN est défini. Avant la v2.1.203, cette variable empêchait le client Microsoft Foundry d'envoyer des requêtes sauf si une clé API était également définie
CLAUDE_CODE_SKIP_MANTLE_AUTH Ignore l'authentification AWS pour Amazon Bedrock Mantle (par exemple, lors de l'utilisation d'une passerelle LLM)
CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY Les vérifications de modèles au démarrage sur Amazon Bedrock et Google Cloud's Agent Platform mémorisent sur cette machine, pendant au maximum une journée, les modèles que votre compte ne peut pas invoquer. Définir sur 1 pour désactiver cette mémorisation. Nécessite Claude Code v2.1.285 ou ultérieur
CLAUDE_CODE_SKIP_PROMPT_HISTORY Définir sur 1 pour ne pas écrire l'historique des prompts et les transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n'apparaissent pas dans --resume, --continue ni dans l'historique accessible avec la flèche haut. Utile pour les sessions scriptées éphémères
CLAUDE_CODE_SKIP_VERTEX_AUTH Ignore l'authentification Google pour Google Cloud's Agent Platform (par exemple, lors de l'utilisation d'une passerelle LLM)
CLAUDE_CODE_STARTUP_FAILURE_RESULTS Définir sur 1 pour qu'une session démarrée avec --output-format stream-json écrive un message de résultat indiquant pourquoi Claude Code a refusé de démarrer pour les échecs de démarrage qui se terminent sinon uniquement par stderr. Nécessite Claude Code v2.1.274 ou ultérieur
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Nombre maximal de fois consécutives où un hook Stop ou SubagentStop peut empêcher la fin du tour avant que Claude Code ne passe outre et termine tout de même le tour (par défaut : 8). Définir sur 0 pour désactiver le plafond. Augmentez-le si votre hook a légitimement besoin de plus d'itérations pour aboutir
CLAUDE_CODE_SUBAGENT_MODEL Le modèle par défaut des sous-agents, des coéquipiers d'une équipe d'agents et des agents de workflow auxquels aucun modèle n'est attribué d'une autre manière. Accepte un alias tel que haiku ou un nom de modèle complet. Deux sources ont priorité sur elle : un modèle que Claude transmet lorsqu'il lance l'agent, et un champ model dans la définition de l'agent, y compris inherit. Pour changer cela, définissez CLAUDE_CODE_SUBAGENT_MODEL_FORCE. Voir Choisir un modèle pour l'ordre complet. La définir sur inherit revient à la laisser non définie. Avant la v2.1.251, cette variable remplaçait à la fois le modèle par invocation et le champ model de la définition
CLAUDE_CODE_SUBAGENT_MODEL_FORCE Définir sur 1 pour imposer un même modèle aux sous-agents, aux coéquipiers et aux agents de workflow. Exécuter tous les sous-agents sur un même modèle indique de quel modèle il s'agit. Nécessite Claude Code v2.1.257 ou ultérieur
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL Définir sur 5m ou 1h, les seules valeurs acceptées par Claude Code, pour choisir le TTL du cache de prompts des requêtes en dehors de la conversation principale, telles que les sous-agents, les workflows et le travail en arrière-plan. A priorité sur le paramètre subagentPromptCacheTtl et sur ENABLE_PROMPT_CACHING_1H, et FORCE_PROMPT_CACHING_5M la remplace. L'API facture les écritures en cache d'une heure à un tarif plus élevé. Nécessite Claude Code v2.1.242 ou ultérieur
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB Définir sur 1 pour retirer les identifiants des environnements des sous-processus (outil Bash, hooks, serveurs MCP stdio) : les identifiants Anthropic et des fournisseurs cloud, toute autre variable que Claude Code reconnaît comme un identifiant, et les identifiants intégrés dans les URL de registres de paquets. Le processus Claude parent conserve ces identifiants pour les appels API, mais les processus enfants ne peuvent pas les lire, ce qui réduit l'exposition aux attaques par injection de prompt qui tentent d'exfiltrer des secrets via l'expansion du shell. Dans la v2.1.251 ou ultérieure, le nettoyage supprime également les variables pointant vers le stockage de configuration de Claude Code (comme CLAUDE_CONFIG_DIR), de sorte qu'un processus enfant ne peut pas localiser un répertoire de configuration déplacé. Laissez le nettoyage non défini si un sous-processus a besoin de ces variables. Sous Linux, cela exécute également les sous-processus Bash dans un espace de noms PID isolé afin qu'ils ne puissent pas lire les environnements des processus hôtes via /proc ; par effet secondaire, ps, pgrep et kill ne peuvent ni voir ni signaler les processus hôtes. claude-code-action la définit automatiquement lorsque allowed_non_write_users est configuré
CLAUDE_CODE_SYNC_PLUGIN_INSTALL Définir sur 1 en mode non interactif (le flag -p) pour attendre la fin de l'installation des plugins 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. À combiner 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 les plugins et consigne une erreur. Aucune valeur par défaut : sans cette variable, l'installation synchrone attend jusqu'à son achèvement
CLAUDE_CODE_SYNC_SKILLS Définir sur 1 en mode non interactif avec le flag -p pour que Claude Code télécharge les skills activés pour votre compte claude.ai lors de cette exécution et attende leur liste, jusqu'à CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS, avant d'exécuter la première requête. Les téléchargements eux-mêmes se terminent en arrière-plan, et Claude attend le téléchargement d'un skill lorsqu'il invoque ce skill. Nécessite l'authentification claude.ai. Les sessions de terminal dans lesquelles vous vous connectez avec votre compte claude.ai téléchargent ces skills dans ~/.claude/skills/synced/ et les resynchronisent environ toutes les 10 minutes sans cette variable ; définissez-la donc uniquement lorsqu'une exécution -p a besoin de vos skills actuels dès sa première requête. Avant la v2.1.273, les sessions de terminal ne les téléchargeaient que lors d'une exécution -p avec cette variable définie. Le nom de dossier synced est réservé à ce téléchargement. Avant la v2.1.227, les skills étaient téléchargés directement dans ~/.claude/skills/. Claude Code applique des règles supplémentaires aux skills téléchargés, comme ne pas exécuter leurs commandes ! sur votre machine
CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS Délai d'expiration en millisecondes pour la resynchronisation des skills qui s'exécute en cours de session lorsqu'une application construite sur l'Agent SDK recharge les skills (par défaut : 30000). Lorsqu'il est dépassé, le rechargement se poursuit avec les skills déjà arrivés, et les téléchargements restants se terminent en arrière-plan
CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS Délai d'expiration en millisecondes pendant lequel la première requête attend la liste initiale des skills lorsque CLAUDE_CODE_SYNC_SKILLS est défini (par défaut : 5000). Lorsqu'il est dépassé, la première requête s'exécute avec les skills déjà arrivés. Les téléchargements se terminent en arrière-plan dans tous les cas, et Claude attend le téléchargement d'un skill lorsqu'il invoque ce skill
CLAUDE_CODE_SYNTAX_HIGHLIGHT Définir sur false pour désactiver la coloration syntaxique dans la sortie des diffs. Utile lorsque les couleurs interfèrent avec la configuration de votre 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 Partage une liste de tâches entre les sessions. Définissez le même ID dans plusieurs instances de Claude Code pour vous coordonner sur une liste de tâches partagée, dans les sessions qui disposent des outils Task. Voir Liste des tâches
CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS Remplace, en millisecondes, la durée pendant laquelle une session non interactive attend à la sortie que son équipe d'agents ait fini de se démanteler. Accepte de 1000 à 60000 ; une valeur hors plage est ignorée et la valeur par défaut de 10000 s'applique. Nécessite Claude Code v2.1.206 ou ultérieur
CLAUDE_CODE_TMPDIR Remplace le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute /claude-{uid}/ à ce chemin sous Unix, ou /claude/ sous Windows. Par défaut : /tmp sur macOS, os.tmpdir() sous Linux et Windows. Sur macOS et Linux, les sous-processus Bash en sandbox reçoivent un $TMPDIR de secours court sous le répertoire système par défaut lorsque votre remplacement est un chemin long, car certains outils échouent lorsque les chemins temporaires deviennent trop longs. Les commandes Bash hors sandbox héritent du $TMPDIR de votre shell lorsqu'il est défini. Sous Windows natif, lorsque votre shell ne définit pas $TMPDIR, une commande Bash qui référence $TMPDIR reçoit votre remplacement, ou %TEMP% si vous n'en avez pas défini. Les fichiers temporaires propres à Claude Code utilisent toujours votre remplacement. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les paramètres de projet et locaux
CLAUDE_CODE_TMUX_TRUECOLOR Définir sur n'importe quelle valeur non vide, par exemple 1, pour autoriser la sortie truecolor 24 bits dans tmux. La définir sur 0 ou false autorise tout de même le truecolor, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour rétablir la limitation à 256 couleurs. Par défaut, Claude Code se limite à 256 couleurs lorsque $TMUX est défini, car tmux ne transmet pas les séquences d'échappement truecolor sauf s'il est configuré pour le faire. Définissez-la après avoir ajouté set -ga terminal-overrides ',*:Tc' à votre ~/.tmux.conf. Voir Configuration du terminal pour les autres paramètres tmux
CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE Sous Linux et WSL, définir sur une liste séparée par des virgules des types de processus que Claude Code exclut du plafond de mémoire des outils, comme mcp ou lsp. Définir sur none pour plafonner tous les types, ou sur all-new pour ne plafonner que les commandes des outils Bash, PowerShell et Monitor. Claude Code maintient les commandes des outils Bash, PowerShell et Monitor sous le plafond, quoi que vous listiez. Nécessite Claude Code v2.1.246 ou ultérieur
CLAUDE_CODE_TOOL_MEMORY_LIMIT Sous Linux et WSL, définir sur une taille telle que 4G pour plafonner la mémoire que peuvent utiliser les commandes des outils Bash et PowerShell, ainsi que les commandes de l'outil Monitor dans la v2.1.246 ou ultérieure. Écrivez la taille en chiffres simples, seuls pour un nombre d'octets ou avec un suffixe K, M, G ou T. Définir sur 0 ou off pour désactiver le plafond. Une fois que le premier processus lancé par Claude Code a activé ou désactivé le plafond, une valeur modifiée prend effet au prochain lancement de claude. Nécessite Claude Code v2.1.233 ou ultérieur
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS Délai en millisecondes avant que Claude Code annule une boîte de dialogue qu'il transmet à un client distant tel qu'un hôte Remote Control ou SDK, ou la boîte de dialogue d'approbation d'un message inter-sessions retenu ; les demandes de permission et les questions AskUserQuestion utilisent leurs propres flux et ne sont pas régies par cette variable. Dans Claude Code v2.1.236 ou ultérieur, elle limite également la demande de consentement aux crédits d'utilisation Fable en cours de session dans une session susceptible de s'exécuter sans surveillance. Contrôler les messages entrants et Sessions non interactives détaillent l'ensemble des règles d'expiration des messages retenus, y compris les cas où le délai ne s'applique pas. Remplace le paramètre dialogExpiry. 0 ou une valeur négative désactive le délai
CLAUDE_CODE_USE_ANTHROPIC_AWS Utiliser Claude Platform on AWS
CLAUDE_CODE_USE_BEDROCK Utiliser Amazon Bedrock
CLAUDE_CODE_USE_FOUNDRY Utiliser Microsoft Foundry
CLAUDE_CODE_USE_MANTLE Utiliser l'endpoint Mantle d'Amazon Bedrock
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH Définir sur 1 pour découvrir les commandes personnalisées, les sous-agents et les styles de sortie à l'aide des API de fichiers de Node.js au lieu de ripgrep. Définissez-la si le binaire ripgrep fourni est indisponible ou bloqué dans votre environnement. N'affecte pas Grep ni les outils de recherche de fichiers
CLAUDE_CODE_USE_POWERSHELL_TOOL Contrôle l'outil PowerShell. Sous Windows sans Git Bash, l'outil est activé automatiquement ; définir sur 0 pour le désactiver. Sous Windows avec Git Bash installé, l'outil est activé par défaut pour les comptes claude.ai et Console ; définir sur 1 pour l'activer dans les sessions Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, ou sur 0 pour le désactiver. Sous Linux, macOS et WSL, définir sur 1 pour l'activer, ce qui nécessite pwsh dans votre PATH. Lorsqu'il est activé sous Windows, Claude peut exécuter des commandes PowerShell nativement au lieu de passer par Git Bash. Voir Outil PowerShell
CLAUDE_CODE_USE_VERTEX Utiliser Google Cloud's Agent Platform
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS Définir sur le nombre de millisecondes pendant lesquelles WebFetch conserve en cache la réponse de chaque URL récupérée. La valeur par défaut est 900000, soit 15 minutes. N'accepte que des chiffres simples ; 0, un nombre décimal ou toute autre écriture conserve la valeur par défaut. Claude Code lit la valeur une fois par lancement, de sorte qu'une modification dans un bloc env des paramètres s'applique au prochain lancement de claude. Nécessite Claude Code v2.1.233 ou ultérieur
CLAUDE_CODE_WEBFETCH_DEADLINE_MS Limite supérieure en millisecondes de la durée pendant laquelle WebFetch attend le téléchargement d'une page, y compris les redirections qu'il suit. Un téléchargement qui n'est pas terminé à ce moment-là échoue avec une erreur de délai. La valeur par défaut est 300000, soit cinq minutes. Définir sur 0 pour supprimer la limite. N'accepte que des chiffres simples ; un nombre décimal ou toute autre écriture conserve la valeur par défaut. Nécessite Claude Code v2.1.268 ou ultérieur
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS Nombre d'agents qu'une seule exécution de workflow exécute simultanément, de 1 à 256. Par défaut, une exécution lance jusqu'à 16 agents simultanément, moins lorsque Claude Code dispose de moins de CPU ; les appels agent() en file d'attente attendent qu'un emplacement se libère. La transcription de chaque agent en cours d'exécution reste dans la mémoire de Claude Code, de sorte que des valeurs plus élevées augmentent l'utilisation de la mémoire. N'accepte que des chiffres simples ; les valeurs hors plage et les autres écritures conservent la valeur par défaut. Nécessite Claude Code v2.1.269 ou ultérieur
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS Limite supérieure, en millisecondes, du temps pendant lequel un agent de workflow attend que la première réponse d'un agent frère partageant le même préfixe commence avant d'envoyer sa propre première requête. Lorsqu'un fan-out démarre plusieurs agents qui partagent un préfixe de cache de prompt, Claude Code retient tous les agents sauf le premier pendant au plus cette durée, afin que les autres lisent le préfixe mis en cache au lieu de le traiter chacun sans cache. Valeur par défaut 5000. Définissez sur 0 pour désactiver l'attente. Lorsque DISABLE_PROMPT_CACHING est défini, les agents n'attendent jamais. Nécessite Claude Code v2.1.229 ou ultérieur
CLAUDE_CONFIG_DIR Remplace le répertoire de configuration (par défaut : ~/.claude). Tous les paramètres, l'historique des sessions et les plugins sont stockés sous ce chemin. Pour les identifiants, consultez où Claude Code stocke les identifiants. Utile pour exécuter plusieurs comptes côte à côte : par exemple, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les paramètres de projet et locaux
CLAUDE_DISABLE_ADOPT Définissez sur 1 pour arrêter le travail en arrière-plan en cours au lieu de le reporter lorsque vous mettez une session en arrière-plan en appuyant sur ← ou avec /background. Claude Code vous demande de confirmer avant la mise en arrière-plan, puis arrête les tâches qui auraient sinon été reportées. Nécessite Claude Code v2.1.195 ou ultérieur
CLAUDE_EFFORT Définie automatiquement dans les sous-processus de l'outil Bash et les commandes de hook sur le niveau d'effort en vigueur au démarrage du sous-processus : low, medium, high, xhigh ou max. Correspond au champ effort.level transmis aux hooks. Définie 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 watchdog d'inactivité du streaming au niveau des octets, ou sur 0 pour forcer sa désactivation. 0 désactive également le délai du premier octet sur les connexions où ce délai s'applique. Lorsque la variable n'est pas définie, le watchdog est activé par défaut pour les connexions directes à l'API Anthropic et à Claude Platform on AWS, ainsi que pour les réponses en streaming sur les connexions de passerelle atteintes via ANTHROPIC_BASE_URL ou ANTHROPIC_AWS_BASE_URL ; avant la v2.1.222, il ne s'exécutait pas sur ces connexions de passerelle, de sorte que le watchdog au niveau des événements pouvait y signaler un blocage même lorsque des pings keep-alive arrivaient. Pour les délais d'expiration et la façon dont les minuteurs interagissent, consultez Watchdogs d'inactivité du streaming
CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK Définissez sur 1 pour activer le watchdog d'inactivité du streaming au niveau des octets sur les réponses Amazon Bedrock vnd.amazon.eventstream, ce qui active également le délai du premier octet sur les requêtes de streaming Bedrock. Désactivé par défaut. Configurez le délai d'expiration avec CLAUDE_STREAM_IDLE_TIMEOUT_MS
CLAUDE_ENABLE_STREAM_WATCHDOG Définissez sur 0 pour forcer la désactivation du watchdog d'inactivité du streaming au niveau des événements, ou sur 1 pour forcer son activation. Lorsque la variable n'est pas définie, le watchdog est activé par défaut pour tous les fournisseurs. Avant la v2.1.196, la valeur par défaut en l'absence de définition était contrôlée par le serveur sur l'API Anthropic directe et désactivée sur les autres fournisseurs. Configurez le délai d'expiration avec CLAUDE_STREAM_IDLE_TIMEOUT_MS ; pour les autres minuteurs de blocage qui s'exécutent en parallèle de celui-ci, consultez Watchdogs d'inactivité du streaming
CLAUDE_ENV_FILE Chemin vers un script shell dont Claude Code exécute le contenu avant chaque commande Bash dans le même processus shell, de sorte que les exports du fichier sont visibles par la commande. Utilisez-la pour conserver l'activation de virtualenv ou de conda d'une commande à l'autre. Également renseignée dynamiquement par les hooks SessionStart, Setup, CwdChanged et FileChanged
CLAUDE_JOB_DIR Définie par Claude Code dans chaque session en arrière-plan sur le répertoire ~/.claude/jobs/<id> de cette session. Les commandes shell exécutées par la session en héritent. Écrivez les fichiers temporaires dans $CLAUDE_JOB_DIR/tmp. Les appels Write et Edit de Claude à cet emplacement ne demandent pas de permission, et le répertoire est supprimé lorsque la session est supprimée
CLAUDE_PID Claude Code la définit sur son propre ID de processus dans les sous-processus qu'il lance : les commandes des outils Bash et PowerShell et les commandes de hook. Sous Linux, l'intégration shell de l'outil Bash l'utilise pour refuser un motif pkill qui correspondrait au processus Claude Code lui-même ; consultez la référence des erreurs. Lisez-la depuis vos propres scripts pour identifier ou signaler délibérément le processus Claude Code parent. Nécessite Claude Code v2.1.214 ou ultérieur
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX Préfixe des noms de session Remote Control générés automatiquement lorsqu'aucun nom explicite n'est fourni. Par défaut, le nom d'hôte de votre machine, ce qui produit des noms comme myhost-graceful-unicorn. Le flag CLI --remote-control-session-name-prefix définit la même valeur pour une seule invocation
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS Délai en millisecondes pour le premier octet de réponse d'une requête de streaming, sur les connexions où le délai du premier octet s'applique. Pour savoir comment Claude Code le borne, le temps supplémentaire qu'il ajoute pour les corps de requête volumineux et comment il choisit le délai lorsque vous ne définissez pas cette variable, consultez No response from API. Nécessite Claude Code v2.1.242 ou ultérieur
CLAUDE_STREAM_IDLE_TIMEOUT_MS Délai d'expiration en millisecondes avant que les watchdogs d'inactivité du streaming au niveau des événements et des octets ne ferment une connexion bloquée. Lorsque vous définissez explicitement cette variable, le minimum est 300000 (5 minutes) ; les valeurs inférieures sont silencieusement relevées pour absorber les longues pauses de réflexion étendue et la mise en mémoire tampon du proxy, et le watchdog au niveau des octets plafonne la valeur à 30 minutes. CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS a priorité sur cette variable pour le watchdog au niveau des octets. Pour les valeurs par défaut de chaque watchdog en l'absence de définition, consultez Watchdogs d'inactivité du streaming
CLAUDE_SUBAGENT_BG_SHELL_MAX_MS Supprimée dans la v2.1.260 et désormais sans effet. Limitait auparavant la durée d'exécution, en millisecondes, d'une commande shell en arrière-plan lancée par un sous-agent, avec une valeur par défaut de 60 minutes. Consultez les règles de durée de vie des commandes en arrière-plan
DEBUG Définissez sur 1 pour activer le mode débogage, équivalent à un lancement avec --debug. Les logs de débogage sont écrits dans ~/.claude/debug/<session-id>.txt, ou dans le chemin défini par CLAUDE_CODE_DEBUG_LOGS_DIR. Seules les valeurs vraies 1, true, yes et on activent le mode débogage, de sorte que les motifs 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 la compaction automatique à l'approche de la limite de contexte. La commande manuelle /compact reste disponible. Utilisez-la lorsque vous souhaitez contrôler explicitement le moment où la compaction a lieu. Remplace le paramètre autoCompactEnabled
DISABLE_COMPACT Définissez sur 1 pour désactiver toute compaction : à la fois la compaction automatique et la commande manuelle /compact
DISABLE_COST_WARNINGS Définissez sur 1 pour désactiver les messages d'avertissement de coût
DISABLE_DOCTOR_COMMAND Définissez sur 1 pour masquer le skill de vérification de la configuration /doctor et son alias /checkup. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter de diagnostics de configuration depuis une session. N'affecte pas la commande de terminal claude doctor. Avant la v2.1.205, cette variable masquait la commande d'écran de diagnostic /doctor
DISABLE_ERROR_REPORTING Définissez sur n'importe quelle valeur non vide, comme 1, pour désactiver le signalement des erreurs. La définir sur 0 ou false le désactive quand même, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour réactiver le signalement des erreurs
DISABLE_EXTRA_USAGE_COMMAND Définissez sur 1 pour masquer la commande /usage-credits qui permet aux utilisateurs d'acheter une utilisation supplémentaire au-delà des limites de débit
DISABLE_FEEDBACK_COMMAND Définissez sur 1 pour désactiver la commande /feedback et les commentaires rédigés par Claude. Désactive également /bug et /share, qui effectuent leurs signalements par le même chemin ; avant la v2.1.212, il s'agissait d'alias de /feedback, de sorte que la commande était désactivée sous tous ses noms. L'ancien nom DISABLE_BUG_COMMAND est également accepté
DISABLE_GROWTHBOOK Définissez sur 1 ou true pour désactiver la récupération des feature flags GrowthBook et utiliser les valeurs par défaut du code pour chaque flag. Cela rend indisponibles Remote Control et les autres fonctionnalités qui nécessitent la récupération des feature flags. La définir sur 0 ou false laisse la récupération activée. La journalisation des événements de télémétrie reste activée, sauf si DISABLE_TELEMETRY est également défini
DISABLE_INSTALLATION_CHECKS Définissez sur 1 pour désactiver les avertissements d'installation. À utiliser uniquement lorsque vous gérez manuellement l'emplacement d'installation, car cela peut masquer des 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, l'Agent Platform de Google Cloud ou Microsoft Foundry)
DISABLE_INTERLEAVED_THINKING Définissez sur 1 pour empêcher l'envoi de l'en-tête bêta interleaved-thinking. Utile lorsque votre passerelle LLM ou votre 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 le prompt caching pour tous les modèles (a priorité sur les paramètres par modèle)
DISABLE_PROMPT_CACHING_FABLE Définissez sur 1 pour désactiver le prompt caching pour les modèles Fable
DISABLE_PROMPT_CACHING_HAIKU Définissez sur 1 pour désactiver le prompt caching pour le modèle Haiku par défaut, où qu'il s'exécute
DISABLE_PROMPT_CACHING_OPUS Définissez sur 1 pour désactiver le prompt caching pour le modèle Opus par défaut
DISABLE_PROMPT_CACHING_SONNET Définissez sur 1 pour désactiver le prompt caching pour le modèle Sonnet par défaut
DISABLE_TELEMETRY Définissez sur n'importe quelle valeur non vide, comme 1, pour désactiver la télémétrie. La définir sur 0 ou false la désactive quand même, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour réactiver la télémétrie. Les événements de télémétrie n'incluent pas de données utilisateur comme le code, les chemins de fichiers ou les commandes Bash. Désactive également la récupération des feature flags. Consultez Désactiver la télémétrie pour votre organisation
DISABLE_UPDATES Définissez sur 1 pour bloquer toutes les mises à jour, y compris les commandes manuelles claude update et claude install. Plus strict que DISABLE_AUTOUPDATER. À utiliser lorsque vous distribuez Claude Code via vos propres canaux et que les utilisateurs ne doivent pas effectuer eux-mêmes les mises à jour
DISABLE_UPGRADE_COMMAND Définissez sur 1 pour masquer la commande /upgrade
DO_NOT_TRACK Définissez sur 1 pour désactiver la télémétrie, avec le même effet que DISABLE_TELEMETRY, y compris sur la récupération des feature flags. Claude Code lit cette variable comme un booléen standard, donc 0 laisse la télémétrie activée, et la respecte en tant que convention inter-outils reconnue par de nombreuses CLI de développement
ENABLE_BETA_TRACING_DETAILED Définissez sur 1, avec BETA_TRACING_ENDPOINT, pour activer le traçage bêta détaillé, qui ajoute des attributs de span porteurs de contenu et le span claude_code.hook. Les sessions CLI interactives nécessitent également que votre organisation figure sur la liste d'autorisation de la bêta. Les deux variables sont ignorées dans les paramètres de projet et locaux
ENABLE_CLAUDEAI_MCP_SERVERS Définissez sur false pour empêcher Claude Code de récupérer les serveurs MCP claude.ai. Activé par défaut pour les utilisateurs connectés. Pour désactiver par projet ou par organisation, définissez plutôt disableClaudeAiConnectors dans les paramètres
ENABLE_PROMPT_CACHING_1H Définissez sur 1 pour demander un TTL de cache de prompt d'1 heure au lieu des 5 minutes par défaut. Destiné aux utilisateurs de clé API, d'Amazon Bedrock, de l'Agent Platform de Google Cloud, de Microsoft Foundry et de Claude Platform on AWS. Les utilisateurs d'un abonnement dans les limites de l'utilisation incluse bénéficient automatiquement du TTL d'1 heure sur la conversation principale. Les utilisateurs d'un abonnement qui puisent dans leurs crédits d'utilisation peuvent la définir pour conserver le TTL d'1 heure. Les écritures de cache d'1 heure sont facturées à un tarif plus élevé. Pour choisir plutôt le TTL par catégorie de requêtes, utilisez CLAUDE_CODE_PROMPT_CACHE_TTL et CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, qui ont priorité sur cette variable
ENABLE_PROMPT_CACHING_1H_BEDROCK Dépréciée. Utilisez plutôt ENABLE_PROMPT_CACHING_1H
ENABLE_TOOL_SEARCH Contrôle MCP Tool Search. Lorsque la variable n'est pas définie, Claude Code diffère par défaut tous les outils MCP. Il les charge néanmoins dès le départ sur les modèles de l'Agent Platform de Google Cloud antérieurs à la génération Claude 4.5, sur un déploiement Microsoft Foundry hébergé sur Azure, et lorsque ANTHROPIC_BASE_URL pointe vers un hôte non first-party. true diffère toujours et envoie l'en-tête bêta, sauf sur ces mêmes modèles Agent Platform et déploiements Microsoft Foundry ; les requêtes échouent sur les proxys qui ne prennent pas en charge tool_reference. auto charge dès le départ lorsque les définitions d'outils tiennent dans 10 % du contexte. auto:N définit un seuil personnalisé, comme auto:5 pour 5 %. false charge tous les outils dès le départ. Une valeur que vous définissez vous-même est ignorée lorsque CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS est défini. Avant la v2.1.221, Claude Code désactivait la recherche d'outils pour tous les modèles sur l'Agent Platform de Google Cloud, sauf si vous définissiez cette variable sur true
FALLBACK_FOR_ALL_PRIMARY_MODELS Définissez sur n'importe quelle valeur non vide, comme 1, pour que Claude Code cesse de réessayer en cas d'erreurs de surcharge répétées pour tous les modèles lorsqu'aucun modèle de secours n'est configuré. La définir sur 0 ou false l'active quand même, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour rétablir le comportement par défaut des nouvelles tentatives. Sans elle, Claude Code cesse de réessayer de cette façon sur les modèles qu'il reconnaît comme des modèles Opus, Fable ou Mythos lorsque vous vous authentifiez avec une clé API ou un fournisseur tiers plutôt qu'avec un abonnement Claude. Sur Claude Code v2.1.160 ou ultérieur, Claude Code bascule sur votre chaîne de modèles de secours configurée en cas d'erreurs de surcharge répétées pour tout 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 le programme de mise à jour automatique principal est désactivé 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 sur 0 pour les désactiver. Lorsque la variable n'est pas définie, Claude Code n'active les hyperliens que lorsqu'il détecte leur prise en charge par le terminal. Claude Code analyse cette valeur comme un nombre et non comme un booléen, de sorte qu'une valeur comme false, no ou off active les hyperliens au lieu de les désactiver. Le badge de PR ou de merge request du pied de page s'affiche sous forme d'hyperlien même lorsque Claude Code ne peut pas détecter la prise en charge par le terminal, par exemple via SSH. Définissez 0 pour afficher le badge en texte brut
FORCE_PROMPT_CACHING_5M Définissez sur 1 pour forcer le TTL de cache de prompt de 5 minutes même lorsque le TTL d'1 heure s'appliquerait autrement. Remplace CLAUDE_CODE_PROMPT_CACHE_TTL, CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, ENABLE_PROMPT_CACHING_1H et les paramètres promptCacheTtl et subagentPromptCacheTtl
HTTP_PROXY Spécifie le serveur proxy HTTP pour les connexions réseau
HTTPS_PROXY Spécifie le serveur proxy HTTPS pour les connexions réseau
IS_DEMO Définissez sur n'importe quelle valeur non vide, comme 1, pour activer le mode démo : masque votre e-mail et le nom de votre organisation dans l'en-tête et dans la sortie de /status, et ignore l'onboarding. La définir sur 0 ou false active quand même le mode démo, contrairement à la plupart des variables d'activation/désactivation ; supprimez la variable pour le désactiver. Utile lors de la diffusion en streaming ou de 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 plutôt cette limite de caractères pour le contenu textuel, mais le contenu image de ces outils reste soumis à cette variable (par défaut : 25000)
MAX_STRUCTURED_OUTPUT_RETRIES Nombre de tentatives que Claude Code autorise lorsque la réponse du modèle échoue à la validation par rapport au --json-schema en mode non interactif avec le flag -p ; après ce nombre de tentatives infructueuses sans sortie valide, l'exécution échoue. La même limite s'applique lorsque la sortie structurée d'un sous-agent de workflow échoue à la validation. Par défaut 5, soit une première tentative plus quatre nouvelles tentatives
MAX_THINKING_TOKENS Budget de tokens fixe pour la réflexion étendue. Claude Code le plafonne à un token en dessous du nombre maximal de tokens de sortie de la requête, et jamais en dessous de 1 024. Consultez CLAUDE_CODE_MAX_OUTPUT_TOKENS pour savoir comment cette limite est définie. Lorsque la variable n'est pas définie et que la réflexion est activée, les modèles dotés du raisonnement adaptatif choisissent eux-mêmes leur profondeur de réflexion, et les autres modèles utilisent le plafond. Définissez sur 0 pour désactiver la réflexion sur l'API Anthropic, sauf sur Opus 5.5, Sonnet 5.5 et les modèles Fable, dont la réflexion ne peut pas être désactivée. Sur les fournisseurs tiers, 0 omet plutôt le paramètre thinking. Lorsque la réflexion est désactivée sur l'API Anthropic, Claude Code envoie l'effort high au lieu d'un niveau supérieur aux modèles dont il sait qu'ils n'acceptent pas cette combinaison, comme Opus 5. Claude Code ignore les valeurs non nulles sur les modèles à raisonnement adaptatif, sauf sur les modèles où CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING désactive le raisonnement adaptatif
MCP_CLIENT_SECRET Secret client OAuth pour les serveurs MCP qui nécessitent des identifiants préconfigurés. Évite la demande interactive lors de l'ajout d'un serveur avec --client-secret
MCP_CONNECTION_NONBLOCKING Contrôle si le démarrage attend que les serveurs MCP se connectent avant la première requête. Le démarrage MCP est non bloquant par défaut : les serveurs se connectent en arrière-plan et leurs outils deviennent disponibles à mesure qu'ils terminent. Définissez sur 0 pour que Claude Code attende la connexion des serveurs avant la première requête. Les serveurs configurés avec alwaysLoad: true font toujours attendre le démarrage malgré tout, sauf lorsqu'ils sont servis depuis le cache de découverte, car leurs outils doivent être présents lors de la construction du premier prompt. En mode non interactif (-p) sans --input-format stream-json, Claude Code attend également les serveurs encore en attente avant le premier tour, quelle que soit cette variable. Lorsque vous passez explicitement --mcp-config, l'attente a une échéance plus longue ; consultez l'entrée de ce flag pour l'exception concernant les serveurs en cache
MCP_CONNECT_TIMEOUT_MS Durée, en millisecondes, pendant laquelle le démarrage MCP bloquant attend le lot de connexions avant de capturer la liste des outils (par défaut : 5000). S'applique lorsque MCP_CONNECTION_NONBLOCKING=0 ou pour les serveurs marqués alwaysLoad: true. Les serveurs encore en attente à l'échéance continuent de se connecter en arrière-plan. Distinct de MCP_TIMEOUT, qui limite la tentative de connexion d'un serveur individuel
MCP_DISCOVERY_CACHE Active ou désactive le cache de découverte MCP. Lorsque le cache est activé, un serveur HTTP ou SSE distant que vous avez déjà utilisé peut afficher le statut cached, et Claude Code le connecte lors de son premier appel d'outil au lieu du démarrage. Le cache est désactivé par défaut, sauf si un déploiement progressif l'a activé pour votre compte. Définissez sur 1 pour l'activer, ou sur 0 pour le maintenir désactivé même lorsque le déploiement progressif l'a activé. Avant la v2.1.238, le cache était activé par défaut. Le statut cached nécessite Claude Code v2.1.221 ou ultérieur
MCP_DISCOVERY_CACHE_MAX_STALE_S Âge maximal, en secondes, d'une entrée du cache de découverte (par défaut : 14400, soit 4 heures). Lors d'un démarrage où l'entrée est plus ancienne, Claude Code la supprime et connecte le serveur au démarrage, comme lorsque le cache est désactivé. Claude Code plafonne la valeur à 7 jours. Avant la v2.1.238, la valeur par défaut était 86400, soit 24 heures, et Claude Code ne plafonnait pas la valeur
MCP_DISCOVERY_CACHE_STRIKES Lors d'un démarrage où une entrée du cache de découverte est plus ancienne que MCP_DISCOVERY_CACHE_TTL_S, Claude Code l'actualise en arrière-plan. Cette variable définit combien d'actualisations consécutives peuvent échouer avant que Claude Code ne supprime l'entrée et connecte plutôt le serveur au démarrage suivant (par défaut : 1). Augmentez-la si votre connexion réseau est parfois interrompue, afin qu'une seule actualisation échouée ne supprime pas l'entrée. Nécessite Claude Code v2.1.238 ou ultérieur
MCP_DISCOVERY_CACHE_TTL_S Nombre de secondes pendant lesquelles Claude Code utilise une entrée du cache de découverte sans l'actualiser (par défaut : 900). Lors d'un démarrage où l'entrée est plus ancienne, Claude Code l'utilise quand même mais l'actualise en arrière-plan. Une fois l'entrée plus ancienne que MCP_DISCOVERY_CACHE_MAX_STALE_S, Claude Code la supprime à la place. Claude Code plafonne la valeur à MCP_DISCOVERY_CACHE_MAX_STALE_S, soit 4 heures par défaut. Avant la v2.1.238, Claude Code ne plafonnait pas la valeur
MCP_OAUTH_CALLBACK_PORT Port fixe pour le callback de redirection OAuth, comme alternative à --callback-port lors de l'ajout d'un serveur MCP avec des identifiants préconfigurés
MCP_PROTOCOL_NEGOTIATION Sur le runtime client MCP v2 uniquement, détermine si Claude Code sonde les serveurs pour la révision 2026-07-28 du protocole MCP. Définissez auto pour sonder les serveurs HTTP, de connecteur claude.ai et stdio, ou legacy pour n'en sonder aucun. Lorsque la variable n'est pas définie, Claude Code sonde les serveurs décrits dans Runtimes client MCP. Toute autre valeur est ignorée avec un avertissement dans le log de débogage. Nécessite Claude Code v2.1.221 ou ultérieur
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_SDK_GENERATION Fixe le runtime client MCP avec lequel ce processus se connecte aux serveurs MCP : v1, basé sur le SDK TypeScript MCP 1.x, ou v2, basé sur le SDK TypeScript MCP 2.0. Sans la variable, Claude Code utilise v2, à partir des versions indiquées dans cette section. Sur Claude Code v2.1.221 ou ultérieur, le runtime v2 vérifie l'émetteur qu'un serveur OAuth MCP renvoie dans sa réponse d'autorisation et fait échouer la connexion avec une erreur commençant par Issuer mismatch in authorization response lorsqu'il ne correspond pas. Le runtime v1 n'effectue pas cette vérification. Si vous définissez une valeur non reconnue, Claude Code l'ignore et écrit un avertissement dans le log de débogage. Claude Code lit la valeur une fois par processus. Nécessite Claude Code v2.1.218 ou ultérieur
MCP_SERVER_CONNECTION_BATCH_SIZE Nombre 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 : 30000, soit 30 secondes)
MCP_TOOL_TIMEOUT Délai d'expiration en millisecondes pour l'exécution des outils MCP (par défaut : 100000000, environ 28 heures). Pour un serveur HTTP, SSE ou de connecteur claude.ai, chaque requête expire également après 60 secondes par défaut ; définissez cette variable, ou le timeout par serveur, au-dessus de 60000 pour relever cette limite par requête. Une valeur inférieure raccourcit toujours le délai d'expiration global de l'exécution de l'outil, mais laisse la limite par requête à 60 secondes. Les serveurs stdio et WebSocket n'ont pas de minuteur par requête. Un champ timeout par serveur dans .mcp.json remplace cette valeur pour ce serveur. Un timeout par serveur d'au moins 1000 définit également la fenêtre d'inactivité minimale pour les appels d'outils de ce serveur, de sorte que CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT ne les interrompt jamais plus tôt ; ce plancher nécessite Claude Code v2.1.203 ou ultérieur. Pour la variable d'environnement, les valeurs inférieures à 1000 sont relevées à une seconde ; pour le champ par serveur, les valeurs inférieures à 1000 sont ignorées
NO_PROXY Liste des domaines et adresses IP vers lesquels les requêtes seront émises directement, en contournant le proxy
OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT Limite standard du SDK OpenTelemetry sur la longueur des valeurs d'attributs. Claude Code plafonne les attributs de télémétrie porteurs de contenu à la plus petite valeur entre celle-ci et CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH, afin que le marqueur de troncature reste dans la limite du SDK. Claude Code lit les variantes OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT et OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT de la même façon, et la plus petite valeur définie s'applique à tous les signaux. Nécessite Claude Code v2.1.214 ou ultérieur. Consultez Surveillance
OTEL_LOG_ASSISTANT_RESPONSES Définissez sur 1 pour inclure le texte de réponse du modèle dans les événements de log OpenTelemetry assistant_response. Lorsque la variable n'est pas définie, Claude Code utilise plutôt la valeur de OTEL_LOG_USER_PROMPTS. Définissez sur 0 pour garder les réponses masquées même lorsque OTEL_LOG_USER_PROMPTS est défini. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les paramètres de projet et locaux. Nécessite Claude Code v2.1.193 ou ultérieur. Consultez Surveillance
OTEL_LOG_MANAGED_SETTINGS Définissez sur 1 pour ajouter les paramètres gérés masqués, ainsi qu'un condensé SHA-256 des paramètres avant masquage, aux événements de log OpenTelemetry managed_settings_resolved. Désactivé par défaut. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés ; une valeur dans les paramètres de projet ou locaux ne l'active pas. Nécessite Claude Code v2.1.274 ou ultérieur. Consultez Surveillance
OTEL_LOG_RAW_API_BODIES Émet le JSON des requêtes et réponses de l'API Messages d'Anthropic sous forme d'événements de log api_request_body / api_response_body. Définissez sur 1 pour des corps intégrés tronqués à la limite de contenu, ou sur file:<dir> pour écrire les corps non tronqués sur le disque et émettre plutôt un chemin body_ref. CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH configure la limite de contenu, 60 Ko par défaut. Désactivé par défaut ; les corps incluent l'intégralité de l'historique de conversation. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les paramètres de projet et locaux. Consultez Surveillance
OTEL_LOG_TOOL_CONTENT Définissez sur 1 pour inclure le contenu des outils dans l'événement de span OpenTelemetry tool.output. Les attributs de span transportent le contenu des outils selon leurs propres conditions. Nécessite le traçage. Désactivé par défaut pour protéger les données sensibles. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les paramètres de projet et locaux, à l'exception des valeurs de désactivation décrites dans cette section. Consultez Surveillance
OTEL_LOG_TOOL_DETAILS Définissez sur 1 pour inclure les arguments d'entrée des outils ; les noms des serveurs MCP ; les noms des workflows créés par l'utilisateur ; les chaînes d'erreur brutes en cas d'échec d'un outil ; la category de refus sur les événements api_refusal ; les vrais noms des agents, skills, plugins et serveurs MCP sur les métriques de coût et de tokens ; et d'autres détails des outils dans les métriques, traces et logs OpenTelemetry. Désactivé par défaut pour protéger les données personnelles. Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les paramètres de projet et locaux, à l'exception des valeurs de désactivation décrites dans cette section. Consultez Surveillance
OTEL_LOG_USER_PROMPTS Définissez sur 1 pour inclure le texte des prompts utilisateur dans les traces et logs OpenTelemetry. Désactivé par défaut (les prompts sont masqués). Définissez-la dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Ignorée dans les paramètres de projet et locaux, à l'exception des valeurs de désactivation décrites dans cette section. Consultez 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). Consultez Surveillance
OTEL_METRICS_INCLUDE_ENTRYPOINT Définissez sur true pour inclure le point d'entrée de la session dans les attributs de métriques (par défaut : exclu). Ajoutée dans la v2.1.152. Consultez Surveillance
OTEL_METRICS_INCLUDE_REPOSITORY Définissez sur true pour marquer les métriques et événements OpenTelemetry avec des attributs vcs.* identifiant le dépôt de la session (par défaut : exclus). Nécessite Claude Code v2.1.269 ou ultérieur. Consultez Attributs de dépôt
OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES Depuis la v2.1.161, Claude Code associe les clés de OTEL_RESOURCE_ATTRIBUTES aux libellés des points de données des métriques. Définissez sur false pour les exclure (par défaut : incluses). Consultez 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). Consultez 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 : exclue). Consultez Surveillance
SLASH_COMMAND_TOOL_CHAR_BUDGET Remplace le budget de caractères pour les métadonnées des skills présentées à l'outil Skill. Le budget s'ajuste dynamiquement à 1 % de la fenêtre de contexte, avec une valeur de secours de 8 000 caractères. Ancien nom conservé pour la rétrocompatibilité
TASK_MAX_OUTPUT_LENGTH Supprimée dans la v2.1.277 et désormais sans effet, de même que l'outil TaskOutput dont elle définissait la taille. Définissait auparavant le nombre maximal de caractères de la sortie d'une tâche en arrière-plan que l'outil TaskOutput conservait. Claude lit désormais le fichier de sortie d'une tâche en arrière-plan avec Read
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 Remplace la région pour Claude 3.5 Haiku lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_3_5_SONNET Remplace la région pour Claude 3.5 Sonnet lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_3_7_SONNET Remplace la région pour Claude 3.7 Sonnet lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_0_OPUS Remplace la région pour Claude 4.0 Opus lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_0_SONNET Remplace la région pour Claude 4.0 Sonnet lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_1_OPUS Remplace la région pour Claude 4.1 Opus lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_5_OPUS Remplace la région pour Claude Opus 4.5 lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_5_SONNET Remplace la région pour Claude Sonnet 4.5 lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_6_OPUS Remplace la région pour Claude Opus 4.6 lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_6_SONNET Remplace la région pour Claude Sonnet 4.6 lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_7_OPUS Remplace la région pour Claude Opus 4.7 lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_4_8_OPUS Remplace la région pour Claude Opus 4.8 lors de l'utilisation de l'Agent Platform de Google Cloud
VERTEX_REGION_CLAUDE_5_5_OPUS Remplace la région pour Claude Opus 5.5 lors de l'utilisation de l'Agent Platform de Google Cloud. Ajoutée dans la v2.1.280
VERTEX_REGION_CLAUDE_5_5_SONNET Remplace la région pour Claude Sonnet 5.5 lors de l'utilisation de l'Agent Platform de Google Cloud. Ajoutée dans la v2.1.284
VERTEX_REGION_CLAUDE_5_OPUS Remplace la région pour Claude Opus 5 lors de l'utilisation de l'Agent Platform de Google Cloud. Ajoutée dans la v2.1.219
VERTEX_REGION_CLAUDE_5_SONNET Remplace la région pour Claude Sonnet 5 lors de l'utilisation de l'Agent Platform de Google Cloud. Ajoutée dans la v2.1.197
VERTEX_REGION_CLAUDE_FABLE_5 Remplace la région pour Claude Fable 5 lors de l'utilisation de l'Agent Platform de Google Cloud. Ajoutée dans la v2.1.170
VERTEX_REGION_CLAUDE_FABLE_5_1 Remplace la région pour Claude Fable 5.1 lors de l'utilisation de l'Agent Platform de Google Cloud. Ajoutée dans la v2.1.257
VERTEX_REGION_CLAUDE_HAIKU_4_5 Remplace la région pour Claude Haiku 4.5 lors de l'utilisation de l'Agent Platform de Google Cloud

Les variables standard d'exportateur OpenTelemetry (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 propres à chaque signal) sont également prises en charge. Consultez Surveillance pour les détails de configuration.

Définissez CLAUDE_CODE_ENABLE_TELEMETRY et les variables OpenTelemetry qui activent l'export, choisissent sa destination ou capturent du contenu dans votre shell, vos paramètres utilisateur ou vos paramètres gérés. Claude Code les ignore dans les paramètres de projet et locaux, à l'exception des valeurs de désactivation décrites dans cette section. OTEL_RESOURCE_ATTRIBUTES et les variables d'intervalle, de délai d'expiration et de compression de l'export, comme OTEL_METRIC_EXPORT_INTERVAL, s'appliquent toujours depuis les paramètres de projet et locaux.

Fonctionnalités nécessitant la récupération de feature flags

Claude Code active certaines fonctionnalités via des feature flags qu'il récupère auprès d'Anthropic. Claude Code ignore cette récupération dans ces sessions :

  • Une session où vous définissez DISABLE_GROWTHBOOK, DISABLE_TELEMETRY, DO_NOT_TRACK, ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ; la ligne de chaque variable dans le tableau des variables indique quelles valeurs désactivent la récupération
  • Une session sur un fournisseur tiers, tel qu'Amazon Bedrock, Claude Platform sur AWS, Agent Platform de Google Cloud, ou Microsoft Foundry, sauf si une plateforme hôte qui intègre Claude Code définit CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
  • Une session de passerelle d'applications Claude

Avec la récupération désactivée, vous ne pouvez pas :

Première session après une installation ou une mise à jour

Lors de votre première session après l'installation de Claude Code, ou la mise à jour vers une version qui ajoute une fonctionnalité, une fonctionnalité contrôlée par flag peut être manquante. Cette session peut également démarrer dans un mode de permission différent de celui de vos sessions ultérieures. Claude Code récupère les flags lors de cette session, donc votre session suivante dispose de la fonctionnalité et du mode de permission de démarrage habituel.

Après une installation propre, dans une session non-interactive telle que claude -p, le SDK Agent, ou l'extension VS Code, Claude Code peut toujours récupérer les flags avant de choisir le mode de permission de démarrage.

Voir aussi