Variables d'environnement

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

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

Cette page couvre comment :

• Définir les variables d'environnement dans votre shell ou dans un fichier de paramètres
• Vérifier quelle valeur s'applique quand un comportement peut être défini de plusieurs façons
• Consulter les variables que Claude Code lit
• Voir quelles fonctionnalités cessent de fonctionner quand une variable désactive la récupération des drapeaux de fonctionnalités

Définir les variables d'environnement

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

Définir les variables dans votre shell

Définissez la variable avant de lancer claude :

[tab] macOS, Linux, WSL

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.

[tab] Windows PowerShell

$env:API_TIMEOUT_MS = "1200000"
claude

Pour la définir pour chaque session, exécutez [Environment]::SetEnvironmentVariable("API_TIMEOUT_MS", "1200000", "User") et ouvrez un nouveau terminal.

[tab] Windows CMD

set API_TIMEOUT_MS=1200000
claude

Pour la définir pour chaque session, exécutez setx API_TIMEOUT_MS "1200000" et ouvrez un nouveau terminal.

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

[tab] macOS, Linux, WSL

echo $API_TIMEOUT_MS

[tab] Windows PowerShell

echo $env:API_TIMEOUT_MS

[tab] Windows CMD

echo %API_TIMEOUT_MS%

Définir les variables 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 relanciez. 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"
  }
}

Claude Code copie ces valeurs dans son environnement telles qu'elles sont écrites. Aucun shell ne les traite, donc les raccourcis comme ~ ou $HOME restent tels que saisis. Pour une variable qui prend un chemin, comme CLAUDE_CONFIG_DIR, écrivez le chemin absolu : "CLAUDE_CONFIG_DIR": "/home/you/.claude-work".

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

Consultez Fichiers de paramètres pour savoir où se trouve chaque fichier et Priorité 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 Définir des variables 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 l'écriture avec 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 2 000 et 64_000 comme 64 000. Avant la v2.1.211, ces écritures pouvaient définir silencieusement une valeur bien plus petite, par exemple 1e6 qui fixait un délai d'expiration à 1.

[!NOTE]

Pour les variables qui activent ou désactivent un comportement, définissez 1, true, yes ou on pour l'activer et 0, false, no ou off pour le désactiver, quelle que soit la casse.

Certaines variables vérifient uniquement si vous les avez définies ou non : toute valeur non vide, y compris 0, active alors le comportement, et vous le désactivez en supprimant la variable ou en lui attribuant une valeur vide. Ces variables fonctionnent ainsi :

• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
• DISABLE_TELEMETRY
• DISABLE_ERROR_REPORTING
• CLAUDE_CODE_TMUX_TRUECOLOR
• IS_DEMO

La ligne de chaque variable indique également sa propre règle.

Les variables standard des exportateurs 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.

Ce que supprime le nettoyage de l'environnement des sous-processus

Lorsque vous définissez CLAUDE_CODE_SUBPROCESS_ENV_SCRUB sur 1, Claude Code supprime les identifiants des environnements des sous-processus qu'il lance, tels que les commandes Bash, les hooks et les serveurs MCP stdio. Cela réduit ce qu'une attaque par injection de prompt peut lire. Le processus Claude Code conserve les identifiants pour ses propres appels API.

Le nettoyage reconnaît un identifiant à partir du nom de sa variable ou de la forme de sa valeur : utilisez-le donc comme une couche de protection parmi d'autres, aux côtés de règles de permission restrictives, plutôt que comme seul contrôle.

Le tableau indique ce que fait le nettoyage sur des exemples de variables :

Comme le nettoyage laisse GITHUB_TOKEN en place, accordez à un job GitHub Actions les permissions les plus restreintes dont il a besoin. Pour retirer un jeton GitHub des commandes Bash exécutées en sandbox, ajoutez une entrée deny sous sandbox.credentials.

Ne définissez pas le nettoyage si un sous-processus a besoin de l'une des variables supprimées.

Sous Linux, le nettoyage 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 de l'hôte via /proc. En conséquence, ps, pgrep et kill ne peuvent ni voir les processus de l'hôte ni leur envoyer de signaux.

Avant la v2.1.251, le nettoyage supprimait ANTHROPIC_API_KEY et AWS_SECRET_ACCESS_KEY et laissait inchangés les autres exemples de variables du tableau.

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

Claude Code active certaines fonctionnalités au moyen de feature flags qu'il récupère auprès d'Anthropic. Claude Code ignore cette récupération dans les sessions suivantes :

• Une session dans laquelle vous définissez CLAUDE_CODE_DISABLE_FEATURE_FLAGS, 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 on 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 des applications Claude

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

• Utiliser Remote Control lorsque CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ou CLAUDE_CODE_DISABLE_FEATURE_FLAGS est défini. Pour DISABLE_TELEMETRY et DO_NOT_TRACK, consultez les prérequis de Remote Control
• Envoyer des messages à des sessions au-delà de cette machine lorsque Remote Control n'est pas disponible. La messagerie entre sessions sur cette machine fonctionne lorsque la récupération est désactivée
• Exécuter claude import ou la commande /import
• Exécuter /skill-doctor ou ouvrir son rapport dans l'onglet Stats de /plugin
• Exécuter /restart avec les forfaits Pro, Max et Ultra
• Synchroniser les skills et les plugins activés pour votre compte claude.ai dans vos sessions de terminal
• Activer le mod You should know
• Utiliser l'outil advisor, sauf sur Claude Platform on AWS avec Claude Code v2.1.300 ou version ultérieure
• Utiliser les tâches MCP
• Lire les commentaires sur un artefact ou y répondre
• Demander à Claude de lire l'artefact public d'une autre organisation
• Obtenir l'outil PowerShell par défaut pour les comptes claude.ai et Console sous Windows avec Git Bash installé ; Claude Code fait passer les commandes shell par Git Bash, sauf si vous définissez CLAUDE_CODE_USE_POWERSHELL_TOOL=1. Sous Windows sans Git Bash, l'outil reste activé
• Obtenir des commentaires rédigés par Claude, que Claude Code active au moyen d'un flag récupéré
• Demander à Claude de traiter les collages volumineux comme du texte collé plutôt que saisi ; le contenu derrière un espace réservé [Pasted text #N] parvient à Claude sans marquage
• Demander à Claude Code d'exclure les outils MCP dont l'API rejetterait le schéma d'entrée

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

Lors de votre première session après l'installation de Claude Code, ou après une mise à niveau vers une version qui ajoute une fonctionnalité, une fonctionnalité soumise à un flag peut être absente. Lorsque Claude Code récupère ses feature flags pendant cette session, il les enregistre sur la machine, de sorte que votre session suivante sur cette machine dispose de la fonctionnalité.

Dans des configurations comme celles-ci, les sessions suivant la première démarrent également sans flags fraîchement récupérés :

• Un environnement vierge à chaque exécution : si chaque exécution démarre dans un conteneur CI, ou dans tout autre environnement dépourvu des flags enregistrés par une session antérieure, chaque exécution est une première session
• Un token de passerelle sans clé API : si vous vous authentifiez avec ANTHROPIC_AUTH_TOKEN sans clé API, et que ANTHROPIC_BASE_URL pointe vers un hôte autre que celui d'Anthropic, comme une passerelle LLM, Claude Code ne dispose d'aucun identifiant pour récupérer les flags

Voir aussi

• Paramètres : tous les paramètres de configuration settings.json, y compris la clé env
• Référence CLI : drapeaux de lancement
• Configuration réseau : configuration du proxy et TLS
• Surveillance : configuration OpenTelemetry