CLAUDE_CONFIG_DIR : à quoi il sert dans Claude Code

Ce que fait la variable CLAUDE_CONFIG_DIR

La liste des variables d’environnement d’Anthropic décrit CLAUDE_CONFIG_DIR comme un moyen de remplacer le répertoire de configuration, ~/.claude par défaut. Tous les réglages, l’historique des sessions et les plug-ins sont stockés sous le chemin que vous lui donnez.

Rien d’autre ne change dans Claude Code. La commande claude reste le même programme ; elle lit et écrit simplement un autre dossier. Lancez-la avec une valeur, vous obtenez une configuration. Lancez-la avec une autre, vous en obtenez une seconde, indépendante.

Ce que contient un répertoire de configuration

D’après le guide d’Anthropic sur le répertoire .claude, quand vous définissez CLAUDE_CONFIG_DIR, tout chemin normalement situé sous ~/.claude se trouve à la place dans votre répertoire. Cela comprend :

Votre CLAUDE.md personnel, votre settings.json, vos compétences (skills), commandes, sous-agents et styles de sortie.
Les transcriptions de sessions dans projects/, ainsi que la mémoire automatique de chaque projet.
Les instantanés de fichiers servant à restaurer un point de contrôle (checkpoint), les fichiers de plan et l’historique de vos invites.
Les raccourcis clavier et les thèmes personnalisés.

Les fichiers de projet ne sont pas concernés. Le CLAUDE.md, le dossier .claude/ et le .mcp.json propres à un dépôt appartiennent au projet : chaque répertoire de configuration les voit.

Comment les connexions restent séparées sur Mac

Sur macOS, Claude Code stocke les identifiants dans le trousseau chiffré (Keychain). Les notes d’Anthropic sur la gestion des identifiants indiquent qu’avec CLAUDE_CONFIG_DIR défini, Claude Code associe l’entrée du trousseau à ce répertoire : une session qui utilise un autre répertoire lit donc une autre entrée. Si le trousseau refuse l’écriture, le fichier de secours .credentials.json est lui aussi placé dans ce répertoire.

Il existe une exception documentée. Des répertoires distincts ne séparent pas deux connexions Claude Console effectuées sans clé API, car Claude Code stocke ce type de connexion en dehors du répertoire de configuration (documentation sur l’authentification, en octobre 2026).

Des variables d’environnement peuvent aussi remplacer la connexion dans tous les répertoires. Si ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN ou CLAUDE_CODE_OAUTH_TOKEN est exporté dans votre shell, il peut l’emporter sur le compte avec lequel vous vous êtes connecté. Voir comment changer de compte Claude Code pour l’ordre complet.

Où définir CLAUDE_CONFIG_DIR

Le plus simple est un alias de shell, l’exemple que donne Anthropic. Ajoutez-le à ~/.zshrc et ouvrez une nouvelle fenêtre de Terminal :

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

Au premier lancement, Claude Code vous guide dans la connexion et la configuration du nouveau répertoire. La commande claude seule continue d’utiliser ~/.claude.

Vous pouvez aussi définir la variable dans les réglages utilisateur ou gérés. Dans un fichier de réglages, indiquez le chemin absolu. Claude Code l’ignore dans les réglages de projet et les réglages locaux : vous ne pouvez donc pas la définir par dépôt de cette façon.

Pour savoir quel répertoire un shell utilise, lancez claude auth status. Sur les versions récentes, sa sortie JSON comprend un champ configDirectory (référence de la CLI).

Erreurs fréquentes

Oublier la variable dans une fenêtre. Un onglet de Terminal sans elle utilise ~/.claude et sa connexion, ce qui passe facilement inaperçu. Les alias évitent ce piège.
Utiliser ~ dans un fichier de réglages. Les fichiers de réglages exigent le chemin absolu, comme /Users/you/.claude-work.
Copier un dossier entier pour en créer un nouveau. Vous copiez alors l’historique et l’état d’un compte dans l’autre. Partez d’un dossier vide et ajoutez ce dont vous avez besoin. Partager compétences (skills) et serveurs MCP explique comment faire.
S’attendre à retrouver les anciennes sessions. Les transcriptions restent dans le répertoire qui les a créées : claude --resume lancé dans un autre répertoire ne les affichera pas. Voir reprendre une session Claude Code.
Une clé API exportée. Elle remplace la connexion dans tous les répertoires.

Comment Switch l’utilise pour Claude Desktop

Claude Code dans Claude Desktop ne lit pas vos alias de shell. C’est là que Switch intervient. Chaque profil Switch ouvre l’app Claude Desktop d’Anthropic avec son propre dossier de données. Quand Keep coding preferences separate (garder les préférences de code séparées) est activé, ce qui est le cas par défaut pour les nouveaux profils, le profil reçoit aussi son propre dossier de configuration Claude Code, et Switch lance le Claude Desktop de ce profil avec CLAUDE_CONFIG_DIR pointé dessus.

Switch n’ajoute aucune commande au Terminal, et chaque compte garde son propre forfait et ses propres limites d’utilisation. Comment Switch gère Claude Code.