Claude Code prend en charge les variables d’environnement suivantes pour contrôler son comportement. Définissez-les dans votre shell avant de lancerDocumentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
claude, ou configurez-les dans settings.json sous la clé env pour les appliquer à chaque session ou les déployer dans votre équipe.
| Variable | Objectif |
|---|---|
ANTHROPIC_API_KEY | Clé API envoyée en tant qu’en-tête X-Api-Key. Lorsqu’elle est définie, cette clé est utilisée à la place de votre abonnement Claude Pro, Max, Team ou Enterprise, même si vous êtes connecté. En mode non interactif (-p), la clé est toujours utilisée lorsqu’elle est présente. En mode interactif, vous êtes invité à approuver la clé une fois avant qu’elle ne remplace votre abonnement. Pour utiliser votre abonnement à la place, exécutez unset ANTHROPIC_API_KEY |
ANTHROPIC_AUTH_TOKEN | Valeur personnalisée pour l’en-tête Authorization (la valeur que vous définissez ici sera préfixée par Bearer ) |
ANTHROPIC_AWS_API_KEY | Clé API de l’espace de travail pour Claude Platform on AWS, générée dans la console AWS. Envoyée en tant que x-api-key et prend la priorité sur AWS SigV4 |
ANTHROPIC_AWS_BASE_URL | Remplacer l’URL du point de terminaison Claude Platform on AWS. À utiliser pour les régions personnalisées ou lors du routage via une passerelle LLM. Par défaut https://aws-external-anthropic.{AWS_REGION}.api.aws |
ANTHROPIC_AWS_WORKSPACE_ID | Requis pour Claude Platform on AWS. Envoyé à chaque requête en tant qu’en-tête anthropic-workspace-id |
ANTHROPIC_BASE_URL | Remplacer le point de terminaison de l’API pour acheminer les requêtes via un proxy ou une passerelle. Lorsqu’elle est définie sur un hôte non-first-party, la recherche d’outils MCP est désactivée par défaut. Définissez ENABLE_TOOL_SEARCH=true si votre proxy transfère les blocs tool_reference |
ANTHROPIC_BEDROCK_BASE_URL | Remplacer l’URL du point de terminaison Bedrock. À utiliser pour les points de terminaison Bedrock personnalisés ou lors du routage via une passerelle LLM. Voir Amazon Bedrock |
ANTHROPIC_BEDROCK_MANTLE_BASE_URL | Remplacer l’URL du point de terminaison Bedrock Mantle. Voir Point de terminaison Mantle |
ANTHROPIC_BEDROCK_SERVICE_TIER | Bedrock niveau de service (default, flex ou priority). Envoyé en tant qu’en-tête X-Amzn-Bedrock-Service-Tier. Voir Amazon Bedrock |
ANTHROPIC_BETAS | Liste séparée par des virgules de valeurs d’en-tête anthropic-beta supplémentaires à inclure dans les requêtes API. Claude Code envoie déjà les en-têtes bêta dont il a besoin ; utilisez ceci pour participer à une bêta de l’API Anthropic avant que Claude Code n’ajoute la prise en charge native. Contrairement à l’indicateur --betas, qui nécessite l’authentification par clé API, cette variable fonctionne avec toutes les méthodes d’authentification, y compris l’abonnement Claude.ai |
ANTHROPIC_CUSTOM_HEADERS | En-têtes personnalisés à ajouter aux requêtes (format Name: Value, séparés par des sauts de ligne pour plusieurs en-têtes) |
ANTHROPIC_CUSTOM_MODEL_OPTION | ID de modèle à ajouter comme entrée personnalisée dans le sélecteur /model. Utilisez ceci pour rendre un modèle non standard ou spécifique à une passerelle sélectionnable sans remplacer les alias intégrés. Voir Configuration du modèle |
ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION | Description d’affichage pour l’entrée de modèle personnalisé dans le sélecteur /model. Par défaut Custom model (<model-id>) lorsqu’il n’est pas défini |
ANTHROPIC_CUSTOM_MODEL_OPTION_NAME | Nom d’affichage pour l’entrée de modèle personnalisé dans le sélecteur /model. Par défaut l’ID du modèle lorsqu’il n’est pas défini |
ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_OPUS_MODEL | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_OPUS_MODEL_NAME | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_SONNET_MODEL | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_SONNET_MODEL_NAME | Voir Configuration du modèle |
ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES | Voir Configuration du modèle |
ANTHROPIC_FOUNDRY_API_KEY | Clé API pour l’authentification Microsoft Foundry (voir Microsoft Foundry) |
ANTHROPIC_FOUNDRY_BASE_URL | URL de base complète pour la ressource 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 Foundry (par exemple, my-resource). Requis si ANTHROPIC_FOUNDRY_BASE_URL n’est pas défini (voir Microsoft Foundry) |
ANTHROPIC_MODEL | Nom du paramètre de modèle à utiliser (voir Configuration du modèle) |
ANTHROPIC_SMALL_FAST_MODEL | [DÉPRÉCIÉ] Nom du modèle de classe Haiku pour les tâches en arrière-plan |
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION | Remplacer la région AWS pour le modèle de classe Haiku lors de l’utilisation de Bedrock ou Bedrock Mantle. Sur Bedrock, cela ne prend effet que lorsque ANTHROPIC_DEFAULT_HAIKU_MODEL ou le ANTHROPIC_SMALL_FAST_MODEL déprécié est également défini, car Bedrock utilise autrement le modèle principal pour les tâches en arrière-plan |
ANTHROPIC_VERTEX_BASE_URL | Remplacer l’URL du point de terminaison Vertex AI. À utiliser pour les points de terminaison Vertex personnalisés ou lors du routage via une passerelle LLM. Voir Google Vertex AI |
ANTHROPIC_VERTEX_PROJECT_ID | ID de projet GCP pour les requêtes Vertex AI. Remplacé par GCLOUD_PROJECT, GOOGLE_CLOUD_PROJECT ou le projet dans votre fichier d’identifiants GOOGLE_APPLICATION_CREDENTIALS. Voir Google Vertex AI |
ANTHROPIC_WORKSPACE_ID | ID d’espace de travail pour la fédération d’identité de charge de travail. Définissez ceci lorsque votre règle de fédération est limitée à plus d’un espace de travail pour que l’échange de jetons sache quel espace de travail cibler |
API_TIMEOUT_MS | Délai d’expiration pour les requêtes API en millisecondes (par défaut : 600 000, ou 10 minutes ; maximum : 2 147 483 647). Augmentez ceci lorsque les requêtes expirent sur les réseaux lents ou lors du routage via un proxy. Les valeurs au-dessus du maximum dépassent le minuteur sous-jacent et provoquent l’échec immédiat des requêtes |
AWS_BEARER_TOKEN_BEDROCK | Clé API Bedrock pour l’authentification (voir Clés API Bedrock) |
BASH_DEFAULT_TIMEOUT_MS | Délai d’expiration par défaut pour les commandes bash longues (par défaut : 120 000, ou 2 minutes) |
BASH_MAX_OUTPUT_LENGTH | Nombre maximum de caractères dans les sorties bash avant que la sortie complète soit enregistrée dans un fichier et que Claude reçoive le chemin plus un court aperçu. Voir Comportement de l’outil Bash |
BASH_MAX_TIMEOUT_MS | Délai d’expiration maximal que le modèle peut définir pour les commandes bash longues (par défaut : 600 000, ou 10 minutes) |
CCR_FORCE_BUNDLE | Définissez sur 1 pour forcer claude --remote à regrouper et télécharger votre référentiel local même lorsque l’accès à GitHub est disponible |
CLAUDECODE | Défini sur 1 dans les environnements shell que Claude Code génère (outil Bash, sessions tmux). Non défini dans les hooks ou les commandes de ligne d’état. Utilisez pour détecter quand un script s’exécute à l’intérieur d’un shell généré par Claude Code |
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS | Définissez sur 1 pour désactiver tous les types de subagent intégrés tels que Explore et Plan. S’applique uniquement en mode non interactif (l’indicateur -p). Utile pour les utilisateurs du SDK qui veulent une ardoise vierge |
CLAUDE_AGENT_SDK_MCP_NO_PREFIX | Définissez sur 1 pour ignorer le préfixe mcp__<server>__ sur les noms d’outils des serveurs MCP créés par le SDK. Les outils utilisent leurs noms d’origine. Utilisation du SDK uniquement |
CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS | Délai d’expiration de blocage en millisecondes pour les subagents en arrière-plan. Par défaut 600000 (10 minutes). Le minuteur se réinitialise à chaque événement de progression en continu ; si aucune progression n’arrive dans la fenêtre, le subagent est interrompu et la tâche est marquée comme échouée, exposant tout résultat partiel au parent |
CLAUDE_AUTOCOMPACT_PCT_OVERRIDE | Définissez le pourcentage de capacité de contexte (1-100) auquel le compactage automatique se déclenche. Par défaut, le compactage automatique se déclenche à environ 95 % de capacité. Utilisez des valeurs plus basses comme 50 pour compacter plus tôt. Les valeurs au-dessus du seuil par défaut n’ont aucun effet. S’applique aux conversations principales et aux subagents. Ce pourcentage s’aligne avec le champ context_window.used_percentage disponible dans la ligne d’état |
CLAUDE_AUTO_BACKGROUND_TASKS | Définissez sur 1 pour forcer l’activation de la mise en arrière-plan automatique des tâches d’agent longues. Lorsqu’elle est activée, les subagents sont déplacés en arrière-plan après environ deux minutes d’exécution |
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR | Retourner au répertoire de travail d’origine après chaque commande Bash ou PowerShell dans la session principale |
CLAUDE_CODE_ACCESSIBILITY | Définissez sur 1 pour garder le curseur du terminal natif visible et désactiver l’indicateur de curseur en texte inversé. Permet aux loupes d’écran comme macOS Zoom de suivre la position du curseur |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD | Définissez sur 1 pour charger les fichiers de mémoire à partir des répertoires spécifiés avec --add-dir. Charge CLAUDE.md, .claude/CLAUDE.md, .claude/rules/*.md et CLAUDE.local.md. Par défaut, les répertoires supplémentaires ne chargent pas les fichiers de mémoire |
CLAUDE_CODE_API_KEY_HELPER_TTL_MS | Intervalle en millisecondes auquel les identifiants doivent être actualisés (lors de l’utilisation de apiKeyHelper) |
CLAUDE_CODE_ATTRIBUTION_HEADER | Définissez sur 0 pour omettre le bloc d’attribution (version client et empreinte digitale d’invite) du début de l’invite système. La désactiver améliore les taux de succès du cache d’invite lors du routage via une passerelle LLM. La mise en cache de l’API Anthropic n’est pas affectée |
CLAUDE_CODE_AUTO_COMPACT_WINDOW | Définissez la capacité de contexte en tokens utilisée pour les calculs de compactage automatique. Par défaut, la fenêtre de contexte du modèle : 200 K pour les modèles standard ou 1 M pour les modèles de contexte étendu. Utilisez une valeur inférieure comme 500000 sur un modèle 1 M pour traiter la fenêtre comme 500 K à des fins de compactage. La valeur est plafonnée à la fenêtre de contexte réelle du modèle. CLAUDE_AUTOCOMPACT_PCT_OVERRIDE est appliqué en pourcentage de cette valeur. La définition de cette variable découple le seuil de compactage du used_percentage de la ligne d’état, qui utilise toujours la fenêtre de contexte complète du modèle |
CLAUDE_CODE_AUTO_CONNECT_IDE | Remplacer la connexion IDE automatique. Par défaut, Claude Code se connecte automatiquement lorsqu’il est lancé dans le terminal intégré d’un IDE pris en charge. Définissez sur false pour empêcher cela. Définissez sur true pour forcer une tentative de connexion lorsque la détection automatique échoue, par exemple lorsque tmux masque le terminal parent. Prend la priorité sur le paramètre de configuration globale autoConnectIde |
CLAUDE_CODE_CERT_STORE | Liste séparée par des virgules de sources de certificats CA pour les connexions TLS. bundled est l’ensemble Mozilla CA fourni avec Claude Code. system est le magasin de confiance du système d’exploitation. Par défaut bundled,system |
CLAUDE_CODE_CLIENT_CERT | Chemin d’accès au fichier de certificat client pour l’authentification mTLS |
CLAUDE_CODE_CLIENT_KEY | Chemin d’accès au fichier de clé privée client pour l’authentification mTLS |
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE | Phrase de passe pour CLAUDE_CODE_CLIENT_KEY chiffré (facultatif) |
CLAUDE_CODE_DEBUG_LOGS_DIR | Remplacer le chemin d’accès au fichier journal de débogage. Malgré le nom, il s’agit d’un chemin de fichier, pas d’un répertoire. Nécessite que le mode débogage soit activé séparément via --debug, /debug ou la variable d’environnement DEBUG : la définition de cette variable seule n’active pas la journalisation. L’indicateur --debug-file fait les deux à la fois. Par défaut ~/.claude/debug/<session-id>.txt |
CLAUDE_CODE_DEBUG_LOG_LEVEL | Niveau de journal minimum écrit dans le fichier journal de débogage. Valeurs : verbose, debug (par défaut), info, warn, error. Définissez sur verbose pour inclure les diagnostics à haut volume comme la sortie complète de la commande de ligne d’état, ou augmentez à error pour réduire le bruit |
CLAUDE_CODE_DISABLE_1M_CONTEXT | Définissez sur 1 pour désactiver la prise en charge de la fenêtre de contexte 1 M. Lorsqu’elle est définie, les variantes de modèle 1 M ne sont pas disponibles dans le sélecteur de modèle. Utile pour les environnements d’entreprise avec des exigences de conformité |
CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING | Définissez sur 1 pour désactiver le raisonnement adaptatif sur Opus 4.6 et Sonnet 4.6 et revenir au budget de réflexion fixe contrôlé par MAX_THINKING_TOKENS. N’a aucun effet sur Opus 4.7, qui utilise toujours le raisonnement adaptatif |
CLAUDE_CODE_DISABLE_AGENT_VIEW | Définissez sur 1 pour désactiver les agents en arrière-plan et la vue des agents : claude agents, --bg, /background et le superviseur à la demande. Équivalent au paramètre disableAgentView |
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN | Définissez sur 1 pour désactiver le rendu en plein écran et utiliser le rendu classique de l’écran principal. La conversation reste dans le défilement natif de votre terminal pour que Cmd+f et le mode copie tmux fonctionnent comme d’habitude. Prend la priorité sur CLAUDE_CODE_NO_FLICKER et le paramètre tui. Vous pouvez également basculer avec /tui default |
CLAUDE_CODE_DISABLE_ATTACHMENTS | Définissez sur 1 pour désactiver le traitement des pièces jointes. Les mentions de fichiers avec la syntaxe @ sont envoyées en tant que texte brut au lieu d’être développées dans le contenu du fichier |
CLAUDE_CODE_DISABLE_AUTO_MEMORY | Définissez sur 1 pour désactiver la mémoire automatique. Définissez sur 0 pour forcer la mémoire automatique même lorsque le mode --bare ou autoMemoryEnabled: false la désactiverait autrement. Lorsqu’elle est désactivée, Claude ne crée ni ne charge les fichiers de mémoire automatique |
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS | Définissez sur 1 pour désactiver toutes les fonctionnalités de tâche en arrière-plan, y compris le paramètre run_in_background sur les outils Bash et subagent, l’arrière-plan automatique et le raccourci Ctrl+B |
CLAUDE_CODE_DISABLE_CLAUDE_MDS | Définissez sur 1 pour empêcher le chargement de tous les fichiers de mémoire CLAUDE.md dans le contexte, y compris les fichiers utilisateur, projet et mémoire automatique |
CLAUDE_CODE_DISABLE_CRON | Définissez sur 1 pour désactiver les tâches planifiées. Le skill /loop et les outils cron deviennent indisponibles et toutes les tâches déjà planifiées cessent de se déclencher, y compris les tâches qui s’exécutent déjà en milieu de session |
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS | Définissez sur 1 pour supprimer les en-têtes de requête anthropic-beta spécifiques à Anthropic et les champs de schéma d’outil bêta (tels que defer_loading et eager_input_streaming) des requêtes API. Utilisez ceci lorsqu’une passerelle proxy rejette les requêtes avec des erreurs comme « Unexpected value(s) for the anthropic-beta header » ou « Extra inputs are not permitted ». Les champs standard (name, description, input_schema, cache_control) sont conservés. |
CLAUDE_CODE_DISABLE_FAST_MODE | Définissez sur 1 pour désactiver le mode rapide |
CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY | Définissez sur 1 pour désactiver les sondages de qualité de session « Comment Claude se débrouille-t-il ? ». Les sondages sont également désactivés lorsque DISABLE_TELEMETRY, DO_NOT_TRACK ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC est défini, sauf si CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL participe à nouveau. Pour définir un taux d’échantillonnage au lieu de désactiver complètement, utilisez le paramètre feedbackSurveyRate. Voir Sondages de qualité de session |
CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING | Définissez sur 1 pour désactiver le checkpointing de fichier. La commande /rewind ne pourra pas restaurer les modifications de code |
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS | Définissez sur 1 pour supprimer les instructions de flux de travail de commit et PR intégrées et l’instantané du statut git de l’invite système de Claude. Utile lors de l’utilisation de vos propres skills de flux de travail git. Prend la priorité sur le paramètre includeGitInstructions lorsqu’il est défini |
CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP | Définissez sur 1 pour empêcher le remappage automatique d’Opus 4.0 et 4.1 à la version Opus actuelle sur l’API Anthropic. À utiliser lorsque vous souhaitez intentionnellement épingler une version plus ancienne du modèle. Le remappage ne s’exécute pas sur Bedrock, Vertex ou Foundry |
CLAUDE_CODE_DISABLE_MOUSE | Définissez sur 1 pour désactiver le suivi de la souris dans le rendu en plein écran. Le défilement au clavier avec PgUp et PgDn fonctionne toujours. Utilisez ceci pour conserver le comportement natif de copie à la sélection de votre terminal |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | Équivalent de la définition de DISABLE_AUTOUPDATER, DISABLE_FEEDBACK_COMMAND, DISABLE_ERROR_REPORTING et DISABLE_TELEMETRY |
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK | Définissez sur 1 pour désactiver le secours non-streaming lorsqu’une requête streaming échoue en milieu de flux. Les erreurs de streaming se propagent à la couche de nouvelle tentative à la place. Utile lorsqu’un proxy ou une passerelle provoque le secours pour produire l’exécution d’outils en double |
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL | Définissez sur 1 pour ignorer l’ajout automatique de la place de marché officielle des plugins au premier lancement |
CLAUDE_CODE_DISABLE_POLICY_SKILLS | Définissez sur 1 pour ignorer le chargement des skills à partir du répertoire des skills gérés au niveau du système. Utile pour les sessions de conteneur ou CI qui ne doivent pas charger les skills fournis par l’opérateur |
CLAUDE_CODE_DISABLE_TERMINAL_TITLE | Définissez sur 1 pour désactiver les mises à jour automatiques du titre du terminal en fonction du contexte de la conversation |
CLAUDE_CODE_DISABLE_THINKING | Définissez sur 1 pour forcer la désactivation de la réflexion étendue indépendamment de la prise en charge du modèle ou d’autres paramètres. Plus direct que MAX_THINKING_TOKENS=0 |
CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL | Définissez sur 1 pour désactiver le défilement virtuel dans le rendu en plein écran et afficher chaque message dans la transcription. Utilisez ceci si le défilement en mode plein écran affiche des régions vierges où les messages devraient apparaître |
CLAUDE_CODE_EFFORT_LEVEL | Définissez le niveau d’effort pour les modèles pris en charge. Valeurs : low, medium, high, xhigh, max ou auto pour utiliser le niveau par défaut du modèle. Les niveaux disponibles dépendent du modèle. Prend la priorité sur /effort et le paramètre effortLevel. Voir Ajuster le niveau d’effort |
CLAUDE_CODE_ENABLE_AWAY_SUMMARY | Remplacer la disponibilité du récapitulatif de session. Définissez sur 0 pour forcer les récapitulatifs désactivés indépendamment du bouton bascule /config. Définissez sur 1 pour forcer les récapitulatifs activés lorsque awaySummaryEnabled est false. Prend la priorité sur le paramètre et le bouton bascule /config |
CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH | Définissez sur 1 pour actualiser l’état du plugin aux limites de tour en mode non interactif après la fin d’une installation en arrière-plan. Désactivé par défaut car l’actualisation modifie l’invite système en milieu de session, ce qui invalide la mise en cache des invites pour ce tour |
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL | Définissez sur 1 pour acheminer le sondage de qualité de session « Comment Claude se débrouille-t-il ? » vers votre propre collecteur OpenTelemetry lorsque le trafic non essentiel lié à Anthropic est bloqué. Les évaluations du sondage sont émises uniquement en tant qu’événements OTEL vers votre collecteur configuré. Aucune donnée de sondage n’est envoyée à Anthropic dans ce mode. S’applique lorsque CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, DISABLE_TELEMETRY ou DO_NOT_TRACK est défini, et n’a aucun effet autrement. CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY et la politique de rétroaction produit de l’organisation prennent la priorité |
CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING | Contrôle si les entrées d’appel d’outil se transmettent en continu depuis l’API au fur et à mesure que Claude les génère. Avec ceci désactivé, une grande entrée d’outil telle qu’une longue écriture de fichier n’arrive qu’après que Claude ait terminé de la générer, ce qui peut sembler qu’il se bloque. Activé par défaut sur l’API Anthropic. Sur Bedrock et Vertex, activé par modèle où le conteneur déployé le prend en charge. Définissez sur 0 pour refuser. Définissez sur 1 pour forcer l’activation lors du routage via un proxy via ANTHROPIC_BASE_URL, ANTHROPIC_VERTEX_BASE_URL ou ANTHROPIC_BEDROCK_BASE_URL. Désactivé par défaut sur Foundry et les connexions gateway |
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY | Définissez sur 1 pour remplir le sélecteur /model à partir du point de terminaison /v1/models de votre passerelle lorsque ANTHROPIC_BASE_URL pointe vers une passerelle compatible Anthropic telle que LiteLLM, Kong ou un proxy interne. Désactivé par défaut car les passerelles soutenues par une clé API partagée afficheraient autrement à chaque utilisateur chaque modèle auquel la clé peut accéder. Les modèles découverts sont toujours filtrés par la liste d’autorisation availableModels |
CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE | Définissez sur 1 pour exécuter le mode rapide sur Claude Opus 4.7 au lieu d’Opus 4.6. Avec la variable définie, /fast bascule vers Opus 4.7 ; sans elle, /fast continue à utiliser Opus 4.6 |
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION | Définissez sur false pour désactiver les suggestions d’invite (le bouton bascule « Suggestions d’invite » dans /config). Ce sont les prédictions grisées qui apparaissent dans votre entrée d’invite après que Claude répond. Voir Suggestions d’invite |
CLAUDE_CODE_ENABLE_TASKS | Définissez sur 1 pour activer le système de suivi des tâches en mode non interactif (l’indicateur -p). Les tâches sont activées par défaut en mode interactif. Voir Liste des tâches |
CLAUDE_CODE_ENABLE_TELEMETRY | Définissez sur 1 pour activer la collecte de données OpenTelemetry pour les métriques et la journalisation. Requis avant de configurer les exportateurs OTel. Voir Surveillance |
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY | Temps en millisecondes à attendre après que la boucle de requête devienne inactive avant de quitter automatiquement. Utile pour les flux de travail automatisés et les scripts utilisant le mode SDK |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS | Définissez sur 1 pour activer les équipes d’agents. Les équipes d’agents sont expérimentales et désactivées par défaut |
CLAUDE_CODE_EXTRA_BODY | Objet JSON à fusionner dans le niveau supérieur de chaque corps de requête API. Utile pour transmettre des paramètres spécifiques au fournisseur que Claude Code n’expose pas directement |
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS | Remplacer la limite de tokens par défaut pour les lectures de fichiers. Utile lorsque vous devez lire des fichiers plus volumineux en intégralité |
CLAUDE_CODE_FORCE_SYNC_OUTPUT | Définissez sur 1 pour forcer l’activation du mode privé DEC 2026 synchronized output lorsque votre terminal le prend en charge mais n’est pas détecté automatiquement. Utile pour les émulateurs tels que Emacs eat qui implémentent BSU/ESU mais ne répondent pas à la sonde de capacité. N’a aucun effet sous tmux |
CLAUDE_CODE_FORK_SUBAGENT | Définissez sur 1 pour activer les subagents forked. Un subagent forked hérite du contexte de conversation complet de la session principale au lieu de commencer à zéro. Lorsqu’elle est activée, /fork génère un subagent forked plutôt que d’agir comme un alias pour /branch, et tous les spawns de subagent s’exécutent en arrière-plan. Fonctionne en mode interactif et via le SDK ou claude -p |
CLAUDE_CODE_GIT_BASH_PATH | Windows uniquement : chemin d’accès à l’exécutable Git Bash (bash.exe). À utiliser lorsque Git Bash est installé mais pas dans votre PATH. Voir Configuration Windows |
CLAUDE_CODE_GLOB_HIDDEN | Définissez sur false pour exclure les fichiers pointés des résultats lorsque Claude appelle l’outil Glob. Inclus par défaut. N’affecte pas l’autocomplétion de fichier @, ls, Grep ou Read |
CLAUDE_CODE_GLOB_NO_IGNORE | Définissez sur false pour faire respecter à l’outil Glob les modèles .gitignore. Par défaut, Glob retourne tous les fichiers correspondants, y compris ceux ignorés par git. N’affecte pas l’autocomplétion de fichier @, qui a son propre paramètre respectGitignore |
CLAUDE_CODE_GLOB_TIMEOUT_SECONDS | Délai d’expiration en secondes pour la découverte de fichiers de l’outil Glob. Par défaut 20 secondes sur la plupart des plates-formes et 60 secondes sur WSL |
CLAUDE_CODE_HIDE_CWD | Définissez sur 1 pour masquer le répertoire de travail dans le logo de démarrage. Utile pour les partages d’écran ou les enregistrements où le chemin expose votre nom d’utilisateur du système d’exploitation |
CLAUDE_CODE_IDE_HOST_OVERRIDE | Remplacer l’adresse d’hôte utilisée pour se connecter à l’extension IDE. Par défaut, Claude Code détecte automatiquement l’adresse correcte, y compris le routage WSL vers Windows |
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL | Ignorer l’installation automatique des extensions IDE. Équivalent à la définition de autoInstallIdeExtension sur false |
CLAUDE_CODE_IDE_SKIP_VALID_CHECK | Définissez sur 1 pour ignorer la validation des entrées du fichier de verrouillage IDE lors de la connexion. À utiliser lorsque la connexion automatique ne trouve pas votre IDE malgré son exécution |
CLAUDE_CODE_MAX_CONTEXT_TOKENS | Remplacer la taille de la fenêtre de contexte que Claude Code suppose pour le modèle actif. Ne prend effet que lorsque DISABLE_COMPACT est également défini. À utiliser lors du routage vers un modèle via ANTHROPIC_BASE_URL dont la fenêtre de contexte ne correspond pas à la taille intégrée pour son nom |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | Définissez le nombre maximal de tokens de sortie pour la plupart des requêtes. Les valeurs par défaut et les plafonds varient selon le modèle ; voir max output tokens. L’augmentation de cette valeur réduit la fenêtre de contexte effective disponible avant que le compactage automatique ne se déclenche. |
CLAUDE_CODE_MAX_RETRIES | Remplacer le nombre de fois pour réessayer les requêtes API échouées (par défaut : 10) |
CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY | Nombre maximal d’outils en lecture seule et de subagents qui peuvent s’exécuter en parallèle (par défaut : 10). Les valeurs plus élevées augmentent le parallélisme mais consomment plus de ressources |
CLAUDE_CODE_MAX_TURNS | Plafonner le nombre de tours d’agent lorsqu’aucune limite explicite n’est transmise. Équivalent à la transmission de --max-turns, qui prend la priorité lorsque les deux sont définis. Une valeur qui n’est pas un entier positif est rejetée au démarrage avec une erreur plutôt que traitée comme aucun plafond |
CLAUDE_CODE_MCP_ALLOWLIST_ENV | Définissez sur 1 pour générer les serveurs MCP stdio avec uniquement un environnement de base sûr plus l’env configuré du serveur, au lieu d’hériter de votre environnement shell |
CLAUDE_CODE_NATIVE_CURSOR | Définissez sur 1 pour afficher le curseur propre du terminal au curseur d’entrée au lieu d’un bloc dessiné. Le curseur respecte les paramètres de clignotement, de forme et de focus du terminal |
CLAUDE_CODE_NEW_INIT | Définissez sur 1 pour faire exécuter /init un flux de configuration interactif. Le flux demande quels fichiers générer, y compris CLAUDE.md, skills et hooks, avant d’explorer la base de code et de les écrire. Sans cette variable, /init génère un CLAUDE.md automatiquement sans demander. |
CLAUDE_CODE_NO_FLICKER | Définissez sur 1 pour activer le rendu en plein écran, un aperçu de recherche qui réduit le scintillement et maintient la mémoire plate dans les longues conversations. Équivalent au paramètre tui ; vous pouvez également basculer avec /tui fullscreen |
CLAUDE_CODE_OAUTH_REFRESH_TOKEN | Jeton d’actualisation OAuth pour l’authentification Claude.ai. Lorsqu’il est défini, claude auth login échange ce jeton directement au lieu d’ouvrir un navigateur. Nécessite CLAUDE_CODE_OAUTH_SCOPES. Utile pour provisionner l’authentification dans les environnements automatisés |
CLAUDE_CODE_OAUTH_SCOPES | Portées OAuth séparées par des espaces avec lesquelles le jeton d’actualisation a été émis, telles que "user:profile user:inference user:sessions:claude_code". Requis lorsque CLAUDE_CODE_OAUTH_REFRESH_TOKEN est défini |
CLAUDE_CODE_OAUTH_TOKEN | Jeton d’accès OAuth pour l’authentification Claude.ai. Alternative à /login pour le SDK et les environnements automatisés. Prend la priorité sur les identifiants stockés dans le trousseau. Générez-en un avec claude setup-token |
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE | Définissez sur 1 pour conserver le mode rapide sur Claude Opus 4.6. Prend la priorité sur CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE, donc définissez ceci si vous devez épingler Opus 4.6 indépendamment de la façon dont la valeur par défaut change |
CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS | Délai d’expiration en millisecondes pour vider les spans OpenTelemetry en attente (par défaut : 5 000). Voir Surveillance |
CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS | Intervalle pour actualiser les en-têtes OpenTelemetry dynamiques en millisecondes (par défaut : 1 740 000 / 29 minutes). Voir En-têtes dynamiques |
CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS | Délai d’expiration en millisecondes pour que l’exportateur OpenTelemetry se termine à l’arrêt (par défaut : 2 000). Augmentez si les métriques sont supprimées à la sortie. Voir Surveillance |
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE | Définissez sur 1 pour permettre à Claude Code d’exécuter la commande de mise à niveau de votre gestionnaire de packages en arrière-plan lorsqu’une nouvelle version est disponible. S’applique aux installations Homebrew et WinGet. Les autres gestionnaires de packages continuent à afficher la commande de mise à niveau sans l’exécuter. Voir Mises à jour automatiques |
CLAUDE_CODE_PERFORCE_MODE | Définissez sur 1 pour activer la protection en écriture consciente de Perforce. Lorsqu’elle est définie, Edit, Write et NotebookEdit échouent avec un indice p4 edit <file> si le fichier cible manque le bit propriétaire-écriture, que Perforce efface sur les fichiers synchronisés jusqu’à ce que p4 edit les ouvre. Cela empêche Claude Code de contourner le suivi des modifications de Perforce |
CLAUDE_CODE_PLUGIN_CACHE_DIR | Remplacer le répertoire racine des plugins. Malgré le nom, ceci définit le répertoire parent, pas le cache lui-même : les places de marché et le cache des plugins se trouvent dans des sous-répertoires sous ce chemin. Par défaut ~/.claude/plugins |
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS | Délai d’expiration en millisecondes pour les opérations git lors de l’installation ou de la mise à jour des plugins (par défaut : 120 000). Augmentez cette valeur pour les grands référentiels ou les connexions réseau lentes. Voir Les opérations Git expirent |
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE | Définissez sur 1 pour conserver le cache de la place de marché existante lorsqu’un git pull échoue au lieu de l’effacer et de le re-cloner. Utile dans les environnements hors ligne ou isolés où le re-clonage échouerait de la même manière. Voir Les mises à jour de la place de marché échouent dans les environnements hors ligne |
CLAUDE_CODE_PLUGIN_PREFER_HTTPS | Définissez sur 1 pour cloner les sources de plugin GitHub owner/repo sur HTTPS au lieu de SSH. Utile dans les exécuteurs CI, les conteneurs ou tout environnement sans clé SSH configurée pour github.com |
CLAUDE_CODE_PLUGIN_SEED_DIR | Chemin d’accès à un ou plusieurs répertoires de seed de plugins en lecture seule, séparés par : sur Unix ou ; sur Windows. Utilisez ceci pour regrouper un répertoire de plugins pré-rempli dans une image de conteneur. Claude Code enregistre les places de marché à partir de ces répertoires au démarrage et utilise les plugins pré-mis en cache sans re-cloner. Voir Pré-remplir les plugins pour les conteneurs |
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST | Défini par les plates-formes hôtes qui intègrent Claude Code et gèrent le routage du fournisseur de modèles en son nom. Lorsqu’elle est définie, la sélection du fournisseur, le point de terminaison et les variables d’authentification telles que CLAUDE_CODE_USE_BEDROCK, ANTHROPIC_BASE_URL et ANTHROPIC_API_KEY dans les fichiers de paramètres sont ignorés pour que les paramètres utilisateur ne puissent pas remplacer le routage de l’hôte. L’opt-out automatique de la télémétrie pour Bedrock, Vertex et Foundry est également ignoré, de sorte que la télémétrie suit l’opt-out standard DISABLE_TELEMETRY. Voir Comportements par défaut par fournisseur API |
CLAUDE_CODE_PROXY_RESOLVES_HOSTS | Définissez sur 1 pour permettre au proxy d’effectuer la résolution DNS au lieu de l’appelant. Opt-in pour les environnements où le proxy doit gérer la résolution du nom d’hôte |
CLAUDE_CODE_REMOTE | Défini automatiquement sur true lorsque Claude Code s’exécute en tant que session cloud. Lisez ceci à partir d’un hook ou d’un script de configuration pour détecter si vous êtes dans un environnement cloud |
CLAUDE_CODE_REMOTE_SESSION_ID | Défini automatiquement dans les sessions cloud à l’ID de session actuel. Lisez ceci pour construire un lien vers la transcription de session. Voir Lier les artefacts à la session |
CLAUDE_CODE_RESUME_INTERRUPTED_TURN | Définissez sur 1 pour reprendre automatiquement si la session précédente s’est terminée en milieu de tour. Utilisé en mode SDK pour que le modèle continue sans que le SDK ait besoin de renvoyer l’invite |
CLAUDE_CODE_RESUME_PROMPT | Remplacer le message de continuation injecté lors de la reprise d’une session qui s’est terminée en milieu de tour. Par défaut Continue from where you left off.. Les scripts de génération pour les agents longues peuvent définir ceci sur un message de démarrage plus directif. Une chaîne vide utilise la valeur par défaut |
CLAUDE_CODE_SCRIPT_CAPS | Objet JSON limitant le nombre de fois que des scripts spécifiques peuvent être appelés par session lorsque CLAUDE_CODE_SUBPROCESS_ENV_SCRUB est défini. Les clés sont des sous-chaînes mises en correspondance avec le texte de la commande ; les valeurs sont des limites d’appels entiers. Par exemple, {"deploy.sh": 2} permet à deploy.sh d’être appelé au maximum deux fois. La correspondance est basée sur des sous-chaînes, donc les astuces d’expansion de shell comme ./scripts/deploy.sh $(evil) comptent toujours contre le plafond. L’expansion en fan-out au runtime via xargs ou find -exec n’est pas détectée ; il s’agit d’un contrôle de défense en profondeur |
CLAUDE_CODE_SCROLL_SPEED | Définissez le multiplicateur de défilement de la molette de la souris dans le rendu en plein écran. Accepte les valeurs de 1 à 20. Définissez sur 3 pour correspondre à vim si votre terminal envoie un événement de molette par cran sans amplification. Ignoré dans le terminal IDE JetBrains, où Claude Code utilise sa propre gestion du défilement |
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS | Remplacer le budget de temps en millisecondes pour les hooks SessionEnd. S’applique à la sortie de session, /clear et au changement de sessions via /resume interactif. Par défaut, le budget est de 1,5 secondes, automatiquement augmenté au timeout par hook le plus élevé configuré dans les fichiers de paramètres, jusqu’à 60 secondes. Les délais d’expiration sur les hooks fournis par les plugins ne relèvent pas du budget |
CLAUDE_CODE_SESSION_ID | Défini automatiquement dans les sous-processus des outils Bash et PowerShell à l’ID de session actuel. Correspond au champ session_id passé aux hooks. Mis à jour sur /clear. À utiliser pour corréler les scripts et les outils externes avec la session Claude Code qui les a lancés |
CLAUDE_CODE_SHELL | Remplacer la détection automatique du shell. Utile lorsque votre shell de connexion diffère de votre shell de travail préféré (par exemple, bash vs zsh) |
CLAUDE_CODE_SHELL_PREFIX | Préfixe de commande pour envelopper les commandes shell que Claude Code génère : appels d’outil Bash, commandes hook et commandes de démarrage du serveur MCP stdio. Utile pour la journalisation ou l’audit. Exemple : la définition de /path/to/logger.sh exécute chaque commande en tant que /path/to/logger.sh <command> |
CLAUDE_CODE_SIMPLE | Définissez sur 1 pour exécuter avec une invite système minimale et uniquement les outils Bash, lecture de fichier et édition de fichier. Les outils MCP de --mcp-config sont toujours disponibles. Désactive la découverte automatique des hooks, skills, plugins, serveurs MCP, mémoire automatique et CLAUDE.md. L’indicateur CLI --bare définit ceci |
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT | Définissez sur 1 pour utiliser l’invite système minimale et les descriptions d’outils réduites sur n’importe quel modèle. Définissez sur 0, false, no ou off pour refuser même sur les modèles où l’expérience ou la configuration du serveur l’activerait autrement. L’ensemble complet d’outils, les hooks, les serveurs MCP et la découverte CLAUDE.md restent activés |
CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH | Ignorer l’authentification côté client pour Claude Platform on AWS, pour les passerelles qui signent les requêtes elles-mêmes |
CLAUDE_CODE_SKIP_BEDROCK_AUTH | Ignorer l’authentification AWS pour Bedrock (par exemple, lors de l’utilisation d’une passerelle LLM) |
CLAUDE_CODE_SKIP_FOUNDRY_AUTH | Ignorer l’authentification Azure pour Microsoft Foundry (par exemple, lors de l’utilisation d’une passerelle LLM) |
CLAUDE_CODE_SKIP_MANTLE_AUTH | Ignorer l’authentification AWS pour Bedrock Mantle (par exemple, lors de l’utilisation d’une passerelle LLM) |
CLAUDE_CODE_SKIP_PROMPT_HISTORY | Définissez sur 1 pour ignorer l’écriture de l’historique des invites et des transcriptions de session sur le disque. Les sessions démarrées avec cette variable définie n’apparaissent pas dans --resume, --continue ou l’historique de la flèche vers le haut. Utile pour les sessions scriptées éphémères |
CLAUDE_CODE_SKIP_VERTEX_AUTH | Ignorer l’authentification Google pour Vertex (par exemple, lors de l’utilisation d’une passerelle LLM) |
CLAUDE_CODE_SUBAGENT_MODEL | Voir Configuration du modèle |
CLAUDE_CODE_SUBPROCESS_ENV_SCRUB | Définissez sur 1 pour supprimer les identifiants Anthropic et des fournisseurs de cloud des environnements de sous-processus (outil Bash, hooks, serveurs MCP stdio). Le processus Claude parent conserve ces identifiants pour les appels API, mais les processus enfants ne peuvent pas les lire, réduisant l’exposition aux attaques par injection de prompt qui tentent d’exfiltrer les secrets via l’expansion du shell. Sur Linux, cela exécute également les sous-processus Bash dans un espace de noms PID isolé pour qu’ils ne puissent pas lire les environnements de processus hôte via /proc ; en conséquence, ps, pgrep et kill ne peuvent pas voir ou signaler les processus hôte. claude-code-action définit ceci automatiquement lorsque allowed_non_write_users est configuré |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL | Définissez sur 1 en mode non interactif (l’indicateur -p) pour attendre que l’installation du plugin se termine avant la première requête. Sans cela, les plugins s’installent en arrière-plan et peuvent ne pas être disponibles au premier tour. Combinez avec CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS pour limiter l’attente |
CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS | Délai d’expiration en millisecondes pour l’installation synchrone des plugins. Lorsqu’il est dépassé, Claude Code continue sans plugins et enregistre une erreur. Pas de défaut : sans cette variable, l’installation synchrone attend jusqu’à la fin |
CLAUDE_CODE_SYNTAX_HIGHLIGHT | Définissez sur false pour désactiver la coloration syntaxique dans la sortie diff. Utile lorsque les couleurs interfèrent avec votre configuration de terminal. Pour désactiver également la coloration dans les blocs de code et les aperçus de fichiers, utilisez le paramètre syntaxHighlightingDisabled |
CLAUDE_CODE_TASK_LIST_ID | Partager une liste de tâches entre les sessions. Définissez le même ID dans plusieurs instances de Claude Code pour coordonner une liste de tâches partagée. Voir Liste des tâches |
CLAUDE_CODE_TEAM_NAME | Nom de l’équipe d’agents à laquelle appartient ce coéquipier. Défini automatiquement sur les membres de l’équipe d’agents |
CLAUDE_CODE_TMPDIR | Remplacer le répertoire temporaire utilisé pour les fichiers temporaires internes. Claude Code ajoute /claude-{uid}/ (Unix) ou /claude/ (Windows) à ce chemin. Par défaut : /tmp sur macOS, os.tmpdir() sur Linux/Windows |
CLAUDE_CODE_TMUX_TRUECOLOR | Définissez sur 1 pour permettre la sortie truecolor 24 bits à l’intérieur de tmux. Par défaut, Claude Code limite à 256 couleurs lorsque $TMUX est défini car tmux ne transmet pas les séquences d’échappement truecolor à moins d’être configuré. Définissez ceci après avoir ajouté set -ga terminal-overrides ',*:Tc' à votre ~/.tmux.conf. Voir Configuration du terminal pour d’autres paramètres tmux |
CLAUDE_CODE_USE_ANTHROPIC_AWS | Utiliser Claude Platform on AWS |
CLAUDE_CODE_USE_BEDROCK | Utiliser Bedrock |
CLAUDE_CODE_USE_FOUNDRY | Utiliser Microsoft Foundry |
CLAUDE_CODE_USE_MANTLE | Utiliser le point de terminaison Mantle de Bedrock |
CLAUDE_CODE_USE_NATIVE_FILE_SEARCH | Définissez sur 1 pour découvrir les commandes personnalisées, les subagents et les styles de sortie à l’aide des API de fichiers Node.js au lieu de ripgrep. Définissez ceci si le binaire ripgrep fourni est indisponible ou bloqué dans votre environnement. N’affecte pas les outils Grep ou de recherche de fichiers |
CLAUDE_CODE_USE_POWERSHELL_TOOL | Contrôle l’outil PowerShell. Sur Windows sans Git Bash, l’outil est activé automatiquement ; définissez sur 0 pour le désactiver. Sur Windows avec Git Bash installé, l’outil se déploie progressivement : définissez sur 1 pour participer ou 0 pour refuser. Sur Linux, macOS et WSL, définissez sur 1 pour l’activer, ce qui nécessite pwsh sur votre PATH. Lorsqu’il est activé sur Windows, Claude peut exécuter les commandes PowerShell en mode natif au lieu de les acheminer via Git Bash. Voir Outil PowerShell |
CLAUDE_CODE_USE_VERTEX | Utiliser Vertex |
CLAUDE_CONFIG_DIR | Remplacer le répertoire de configuration (par défaut : ~/.claude). Tous les paramètres, identifiants, historique de session et plugins sont stockés sous ce chemin. Utile pour exécuter plusieurs comptes côte à côte : par exemple, alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude' |
CLAUDE_EFFORT | Défini automatiquement dans les sous-processus des outils Bash et les commandes hook au niveau d’effort actif pour le tour : low, medium, high, xhigh ou max. Correspond au champ effort.level passé aux hooks. Défini uniquement lorsque le modèle actuel prend en charge le paramètre d’effort |
CLAUDE_ENABLE_BYTE_WATCHDOG | Définissez sur 1 pour forcer l’activation du chien de garde d’inactivité au niveau des octets, ou définissez sur 0 pour forcer la désactivation. Lorsqu’il n’est pas défini, le chien de garde est activé par défaut pour les connexions API Anthropic. Le chien de garde d’octets abandonne une connexion lorsqu’aucun octet n’arrive sur le fil pendant la durée définie par CLAUDE_STREAM_IDLE_TIMEOUT_MS, avec un minimum de 5 minutes, indépendamment du chien de garde au niveau des événements |
CLAUDE_ENABLE_STREAM_WATCHDOG | Définissez sur 1 pour activer le chien de garde d’inactivité de streaming au niveau des événements. Désactivé par défaut. Pour Bedrock, Vertex et Foundry, c’est le seul chien de garde d’inactivité disponible. Configurez le délai d’expiration avec CLAUDE_STREAM_IDLE_TIMEOUT_MS |
CLAUDE_ENV_FILE | Chemin d’accès à un script shell dont le contenu Claude Code exécute avant chaque commande Bash dans le même processus shell, de sorte que les exports du fichier sont visibles pour la commande. À utiliser pour persister l’activation de virtualenv ou conda entre les commandes. Également rempli dynamiquement par les hooks SessionStart, Setup, CwdChanged et FileChanged |
CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX | Préfixe pour les noms de session Contrôle à distance générés automatiquement lorsqu’aucun nom explicite n’est fourni. Par défaut, le nom d’hôte de votre machine, produisant des noms comme myhost-graceful-unicorn. L’indicateur CLI --remote-control-session-name-prefix définit la même valeur pour une seule invocation |
CLAUDE_STREAM_IDLE_TIMEOUT_MS | Délai d’expiration en millisecondes avant que le chien de garde d’inactivité de streaming ferme une connexion bloquée. Par défaut et minimum 300000 (5 minutes) pour les deux chiens de garde au niveau des octets et au niveau des événements ; les valeurs inférieures sont silencieusement limitées pour absorber les pauses de réflexion étendue et la mise en mémoire tampon du proxy. Pour les fournisseurs tiers, nécessite CLAUDE_ENABLE_STREAM_WATCHDOG=1 |
DEBUG | Définissez sur 1 pour activer le mode débogage, équivalent au lancement avec --debug. Les journaux de débogage sont écrits dans ~/.claude/debug/<session-id>.txt, ou dans le chemin défini par CLAUDE_CODE_DEBUG_LOGS_DIR. Seules les valeurs véridiques 1, true, yes et on activent le mode débogage, donc les modèles d’espace de noms comme DEBUG=express:* définis pour d’autres outils ne le déclenchent pas |
DISABLE_AUTOUPDATER | Définissez sur 1 pour désactiver les mises à jour automatiques en arrière-plan. La commande manuelle claude update fonctionne toujours. Utilisez DISABLE_UPDATES pour bloquer les deux |
DISABLE_AUTO_COMPACT | Définissez sur 1 pour désactiver le compactage automatique lorsque vous approchez de la limite de contexte. La commande manuelle /compact reste disponible. À utiliser lorsque vous souhaitez un contrôle explicite sur le moment du compactage |
DISABLE_COMPACT | Définissez sur 1 pour désactiver tout compactage : à la fois le compactage automatique et la commande manuelle /compact |
DISABLE_COST_WARNINGS | Définissez sur 1 pour désactiver les messages d’avertissement de coût |
DISABLE_DOCTOR_COMMAND | Définissez sur 1 pour masquer la commande /doctor. Utile pour les déploiements gérés où les utilisateurs ne doivent pas exécuter les diagnostics d’installation |
DISABLE_ERROR_REPORTING | Définissez sur 1 pour refuser la création de rapports d’erreurs Sentry |
DISABLE_EXTRA_USAGE_COMMAND | Définissez sur 1 pour masquer la commande /extra-usage qui permet aux utilisateurs d’acheter une utilisation supplémentaire au-delà des limites de débit |
DISABLE_FEEDBACK_COMMAND | Définissez sur 1 pour désactiver la commande /feedback. Le nom plus ancien DISABLE_BUG_COMMAND est également accepté |
DISABLE_GROWTHBOOK | Définissez sur 1 pour désactiver la récupération des drapeaux de fonctionnalités GrowthBook et utiliser les valeurs par défaut du code pour chaque drapeau. La journalisation des événements de télémétrie reste activée sauf si DISABLE_TELEMETRY est également défini |
DISABLE_INSTALLATION_CHECKS | Définissez sur 1 pour désactiver les avertissements d’installation. À utiliser uniquement lors de la gestion manuelle de l’emplacement d’installation, car cela peut masquer les problèmes avec les installations standard |
DISABLE_INSTALL_GITHUB_APP_COMMAND | Définissez sur 1 pour masquer la commande /install-github-app. Déjà masquée lors de l’utilisation de fournisseurs tiers (Bedrock, Vertex ou Foundry) |
DISABLE_INTERLEAVED_THINKING | Définissez sur 1 pour empêcher l’envoi de l’en-tête bêta de réflexion entrelacée. Utile lorsque votre passerelle LLM ou fournisseur ne prend pas en charge la réflexion entrelacée |
DISABLE_LOGIN_COMMAND | Définissez sur 1 pour masquer la commande /login. Utile lorsque l’authentification est gérée en externe via des clés API ou apiKeyHelper |
DISABLE_LOGOUT_COMMAND | Définissez sur 1 pour masquer la commande /logout |
DISABLE_PROMPT_CACHING | Définissez sur 1 pour désactiver la mise en cache des invites pour tous les modèles (prend la priorité sur les paramètres par modèle) |
DISABLE_PROMPT_CACHING_HAIKU | Définissez sur 1 pour désactiver la mise en cache des invites pour les modèles Haiku |
DISABLE_PROMPT_CACHING_OPUS | Définissez sur 1 pour désactiver la mise en cache des invites pour les modèles Opus |
DISABLE_PROMPT_CACHING_SONNET | Définissez sur 1 pour désactiver la mise en cache des invites pour les modèles Sonnet |
DISABLE_TELEMETRY | Définissez sur 1 pour refuser la télémétrie. Les événements de télémétrie n’incluent pas les données utilisateur comme le code, les chemins de fichiers ou les commandes bash. Désactive également les drapeaux de fonctionnalités, de sorte que certaines fonctionnalités qui sont toujours en cours de déploiement peuvent ne pas être disponibles |
DISABLE_UPDATES | Définissez sur 1 pour bloquer toutes les mises à jour, y compris la commande manuelle claude update et claude install. Plus strict que DISABLE_AUTOUPDATER. À utiliser lors de la distribution de Claude Code via vos propres canaux et les utilisateurs ne doivent pas se mettre à jour automatiquement |
DISABLE_UPGRADE_COMMAND | Définissez sur 1 pour masquer la commande /upgrade |
DO_NOT_TRACK | Définissez sur 1 pour refuser la télémétrie. Équivalent à la définition de DISABLE_TELEMETRY. Honoré en tant que convention standard inter-outils |
ENABLE_CLAUDEAI_MCP_SERVERS | Définissez sur false pour désactiver les serveurs MCP claude.ai dans Claude Code. Activé par défaut pour les utilisateurs connectés |
ENABLE_PROMPT_CACHING_1H | Définissez sur 1 pour demander une TTL de cache d’invite d’une heure au lieu des 5 minutes par défaut. Destiné aux utilisateurs de clé API, Bedrock, Vertex, Foundry et Claude Platform on AWS. Les utilisateurs d’abonnement reçoivent automatiquement une TTL d’une heure. Les écritures de cache d’une heure sont facturées à un taux plus élevé |
ENABLE_PROMPT_CACHING_1H_BEDROCK | Déprécié. Utilisez ENABLE_PROMPT_CACHING_1H à la place |
ENABLE_TOOL_SEARCH | Contrôle la recherche d’outils MCP. Non défini : tous les outils MCP différés par défaut, mais chargés en amont sur Vertex AI ou lorsque ANTHROPIC_BASE_URL pointe vers un hôte non-first-party. Valeurs : true (toujours différer et envoyer l’en-tête bêta, les requêtes échouent sur Vertex AI ou les proxies qui ne prennent pas en charge tool_reference), auto (mode seuil : charger en amont si les outils s’ajustent dans 10 % du contexte), auto:N (seuil personnalisé, par exemple, auto:5 pour 5 %), false (charger tous en amont) |
FALLBACK_FOR_ALL_PRIMARY_MODELS | Définissez sur n’importe quelle valeur non vide pour déclencher le basculement vers --fallback-model après des erreurs de surcharge répétées sur n’importe quel modèle principal. Par défaut, seuls les modèles Opus déclenchent le basculement |
FORCE_AUTOUPDATE_PLUGINS | Définissez sur 1 pour forcer les mises à jour automatiques des plugins même lorsque la mise à jour automatique principale est désactivée via DISABLE_AUTOUPDATER |
FORCE_PROMPT_CACHING_5M | Définissez sur 1 pour forcer la TTL de cache d’invite de 5 minutes même lorsque la TTL d’une heure s’appliquerait autrement. Remplace ENABLE_PROMPT_CACHING_1H |
HTTP_PROXY | Spécifier le serveur proxy HTTP pour les connexions réseau |
HTTPS_PROXY | Spécifier le serveur proxy HTTPS pour les connexions réseau |
IS_DEMO | Définissez sur 1 pour activer le mode démo : masque votre e-mail et le nom de l’organisation de l’en-tête et de la sortie /status, et ignore l’intégration. Utile pour la diffusion en continu ou l’enregistrement d’une session |
MAX_MCP_OUTPUT_TOKENS | Nombre maximal de tokens autorisés dans les réponses des outils MCP. Claude Code affiche un avertissement lorsque la sortie dépasse 10 000 tokens. Les outils qui déclarent anthropic/maxResultSizeChars utilisent cette limite de caractères pour le contenu textuel à la place, mais le contenu d’image de ces outils est toujours soumis à cette variable (par défaut : 25 000) |
MAX_STRUCTURED_OUTPUT_RETRIES | Nombre de fois pour réessayer lorsque la réponse du modèle échoue la validation par rapport au --json-schema en mode non interactif (l’indicateur -p). Par défaut 5 |
MAX_THINKING_TOKENS | Remplacer le budget de tokens de réflexion étendue. Le plafond est le max output tokens du modèle moins un. Définissez sur 0 pour désactiver complètement la réflexion. Sur les modèles avec raisonnement adaptatif, le budget est ignoré sauf si le raisonnement adaptatif est désactivé via CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING |
MCP_CLIENT_SECRET | Secret client OAuth pour les serveurs MCP qui nécessitent des identifiants préconfigurés. Évite l’invite interactive lors de l’ajout d’un serveur avec --client-secret |
MCP_CONNECTION_NONBLOCKING | Définissez sur true en mode non interactif (-p) pour ignorer complètement l’attente de connexion MCP. Utile pour les pipelines scriptés où les outils MCP ne sont pas nécessaires. Sans cette variable, la première requête attend jusqu’à 5 secondes pour les connexions du serveur --mcp-config. Les serveurs configurés avec alwaysLoad: true bloquent toujours le démarrage indépendamment de cette variable, car leurs outils doivent être présents lorsque la première invite est construite |
MCP_CONNECT_TIMEOUT_MS | Combien de temps la première requête attend, en millisecondes, pour le lot de connexion MCP avant de prendre un instantané de la liste d’outils (par défaut : 5 000). Les serveurs toujours en attente à la date limite continuent à se connecter en arrière-plan mais n’apparaîtront pas jusqu’à la requête suivante. Distinct de MCP_TIMEOUT, qui limite la tentative de connexion d’un serveur individuel. Plus pertinent pour les sessions non interactives qui émettent une seule requête et ont besoin que les serveurs à connexion lente soient visibles |
MCP_OAUTH_CALLBACK_PORT | Port fixe pour le rappel de redirection OAuth, comme alternative à --callback-port lors de l’ajout d’un serveur MCP avec des identifiants préconfigurés |
MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE | Nombre maximal de serveurs MCP distants (HTTP/SSE) à connecter en parallèle au démarrage (par défaut : 20) |
MCP_SERVER_CONNECTION_BATCH_SIZE | Nombre maximal de serveurs MCP locaux (stdio) à connecter en parallèle au démarrage (par défaut : 3) |
MCP_TIMEOUT | Délai d’expiration en millisecondes pour le démarrage du serveur MCP (par défaut : 30 000, ou 30 secondes) |
MCP_TOOL_TIMEOUT | Délai d’expiration en millisecondes pour l’exécution de l’outil MCP (par défaut : 100 000 000, environ 28 heures) |
NO_PROXY | Liste des domaines et adresses IP vers lesquels les requêtes seront émises directement, en contournant le proxy |
OTEL_LOG_RAW_API_BODIES | Émettre la requête et la réponse JSON complètes de l’API Anthropic Messages en tant qu’événements de journal api_request_body / api_response_body. Définissez sur 1 pour les corps en ligne tronqués à 60 Ko, ou file:<dir> pour écrire les corps non tronqués sur le disque et émettre une référence de chemin body_ref à la place. Désactivé par défaut ; les corps incluent l’historique complet de la conversation. Voir Surveillance |
OTEL_LOG_TOOL_CONTENT | Définissez sur 1 pour inclure le contenu d’entrée et de sortie d’outil dans les événements d’intervalle OpenTelemetry. Désactivé par défaut pour protéger les données sensibles. Voir Surveillance |
OTEL_LOG_TOOL_DETAILS | Définissez sur 1 pour inclure les arguments d’entrée d’outil, les noms de serveurs MCP, les chaînes d’erreur brutes en cas d’échec d’outil et d’autres détails d’outils dans les traces et journaux OpenTelemetry. Désactivé par défaut pour protéger les informations personnelles. Voir Surveillance |
OTEL_LOG_USER_PROMPTS | Définissez sur 1 pour inclure le texte de l’invite utilisateur dans les traces et journaux OpenTelemetry. Désactivé par défaut (les invites sont masquées). Voir Surveillance |
OTEL_METRICS_INCLUDE_ACCOUNT_UUID | Définissez sur false pour exclure l’UUID du compte des attributs de métriques (par défaut : inclus). Voir Surveillance |
OTEL_METRICS_INCLUDE_SESSION_ID | Définissez sur false pour exclure l’ID de session des attributs de métriques (par défaut : inclus). Voir Surveillance |
OTEL_METRICS_INCLUDE_VERSION | Définissez sur true pour inclure la version de Claude Code dans les attributs de métriques (par défaut : exclu). Voir Surveillance |
SLASH_COMMAND_TOOL_CHAR_BUDGET | Remplacer le budget de caractères pour les métadonnées de skill affichées à l’outil Skill. Le budget s’adapte dynamiquement à 1 % de la fenêtre de contexte, avec un repli de 8 000 caractères. Nom hérité conservé pour la compatibilité rétroactive |
TASK_MAX_OUTPUT_LENGTH | Nombre maximal de caractères dans la sortie du subagent avant la troncature (par défaut : 32 000, maximum : 160 000). Lorsqu’elle est tronquée, la sortie complète est enregistrée sur le disque et le chemin est inclus dans la réponse tronquée |
USE_BUILTIN_RIPGREP | Définissez sur 0 pour utiliser le rg installé sur le système au lieu du rg inclus avec Claude Code |
VERTEX_REGION_CLAUDE_3_5_HAIKU | Remplacer la région pour Claude 3.5 Haiku lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_3_5_SONNET | Remplacer la région pour Claude 3.5 Sonnet lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_3_7_SONNET | Remplacer la région pour Claude 3.7 Sonnet lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_4_0_OPUS | Remplacer la région pour Claude 4.0 Opus lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_4_0_SONNET | Remplacer la région pour Claude 4.0 Sonnet lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_4_1_OPUS | Remplacer la région pour Claude 4.1 Opus lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_4_5_OPUS | Remplacer la région pour Claude Opus 4.5 lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_4_5_SONNET | Remplacer la région pour Claude Sonnet 4.5 lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_4_6_OPUS | Remplacer la région pour Claude Opus 4.6 lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_4_6_SONNET | Remplacer la région pour Claude Sonnet 4.6 lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_4_7_OPUS | Remplacer la région pour Claude Opus 4.7 lors de l’utilisation de Vertex AI |
VERTEX_REGION_CLAUDE_HAIKU_4_5 | Remplacer la région pour Claude Haiku 4.5 lors de l’utilisation de Vertex AI |
OTEL_METRICS_EXPORTER, OTEL_LOGS_EXPORTER, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_PROTOCOL, OTEL_EXPORTER_OTLP_HEADERS, OTEL_METRIC_EXPORT_INTERVAL, OTEL_RESOURCE_ATTRIBUTES et les variantes spécifiques au signal) sont également prises en charge. Voir Surveillance pour les détails de configuration.
Voir aussi
- Paramètres : configurez les variables d’environnement dans
settings.jsonpour qu’elles s’appliquent à chaque session - Référence CLI : indicateurs de lancement
- Configuration réseau : configuration du proxy et TLS
- Surveillance : configuration OpenTelemetry