SwitchVroege toegang
← Alle gidsen
Claude Code

CLAUDE_CONFIG_DIR: wat het doet in Claude Code

CLAUDE_CONFIG_DIR zegt tegen Claude Code dat het een andere configuratiemap moet gebruiken dan de standaardmap ~/.claude. Instellingen, sessiegeschiedenis, plug-ins en de login gaan mee, dus elke map werkt als een aparte Claude Code-installatie. Anthropic raadt het aan om een werk- en een privéaccount tegelijk ingelogd te houden.

Door Switch · Bijgewerkt op

Ook beschikbaar in: English · Español · Deutsch · Français · 日本語 · 简体中文 · Português (Brasil) · 한국어 · Italiano · 繁體中文

Een gids van Switch, een onafhankelijke beheerder voor Claude Desktop-profielen. Switch is in vroege toegang, in aanloop naar de publieke release.

Wat de variabele doet

In Anthropics overzicht van omgevingsvariabelen staat CLAUDE_CONFIG_DIR beschreven als een manier om de configuratiemap te vervangen, die standaard ~/.claude is. Alle instellingen, sessiegeschiedenis en plug-ins worden opgeslagen onder het pad dat je opgeeft.

Verder verandert er niets aan Claude Code. De opdracht claude is hetzelfde programma; het leest en schrijft alleen een andere map. Start je het met de ene waarde, dan krijg je de ene installatie. Start je het met een andere waarde, dan krijg je een tweede, onafhankelijke installatie.

Wat er in een configuratiemap staat

Volgens Anthropics uitleg over de .claude-map komt, zodra je CLAUDE_CONFIG_DIR instelt, elk pad dat normaal onder ~/.claude staat in jouw map terecht. Daaronder vallen:

  • Je persoonlijke CLAUDE.md, settings.json, skills, commands, subagents en output styles.
  • Sessietranscripten in projects/, plus het automatische geheugen per project.
  • Bestandssnapshots voor het herstellen van checkpoints, planbestanden en je promptgeschiedenis.
  • Sneltoetsinstellingen en eigen thema’s.

Projectbestanden blijven buiten schot. De eigen CLAUDE.md, de map .claude/ en .mcp.json van een repository horen bij het project, dus elke configuratiemap ziet ze.

Hoe logins op een Mac gescheiden blijven

Op macOS bewaart Claude Code inloggegevens in de versleutelde sleutelhanger. Volgens Anthropics uitleg over inloggegevens koppelt Claude Code het sleutelhangeronderdeel aan die map wanneer CLAUDE_CONFIG_DIR is ingesteld, dus een sessie met een andere map leest een ander onderdeel. Weigert de sleutelhanger het opslaan, dan komt het reservebestand .credentials.json ook in die map.

Er is één gedocumenteerde uitzondering. Aparte mappen houden twee Claude Console-logins zonder API-sleutel niet uit elkaar, omdat Claude Code dat soort login buiten de configuratiemap opslaat (authenticatiedocumentatie, stand oktober 2026).

Ook omgevingsvariabelen kunnen de login in elke map overschrijven. Als ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN of CLAUDE_CODE_OAUTH_TOKEN in je shell is geëxporteerd, kan die voorrang krijgen op het account waarmee je bent ingelogd. Zie hoe je van Claude Code-account wisselt voor de volledige volgorde.

Waar je het instelt

De eenvoudigste manier is een shell-alias, het voorbeeld dat Anthropic zelf geeft. Zet het in ~/.zshrc en open een nieuw Terminal-venster:

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

De eerste keer leidt Claude Code je door het inloggen en instellen voor de nieuwe map. Gewoon claude blijft ~/.claude gebruiken.

Je kunt de variabele ook in gebruikers- of beheerde instellingen zetten. Schrijf in een instellingenbestand het absolute pad. Claude Code negeert de variabele in project- en lokale instellingen, dus op die manier kun je hem niet per repository instellen.

Wil je weten welke map een shell gebruikt, voer dan claude auth status uit. In recente versies bevat de JSON-uitvoer een veld configDirectory (CLI-referentie).

Veelgemaakte fouten

  • De variabele vergeten in één venster. Een Terminal-tabblad zonder de variabele gebruikt ~/.claude en de login daarvan, en dat zie je makkelijk over het hoofd. Met aliassen voorkom je dit.
  • ~ gebruiken in een instellingenbestand. Instellingenbestanden hebben het absolute pad nodig, zoals /Users/you/.claude-work.
  • Een hele map kopiëren om een nieuwe te maken. Dan kopieer je de geschiedenis en status van het ene account naar het andere. Begin met een lege map en voeg toe wat je nodig hebt. Skills en MCP-servers delen legt dit uit.
  • Verwachten dat oude sessies meekomen. Transcripten staan in de map die ze heeft aangemaakt, dus claude --resume in een andere map toont ze niet. Zie Claude Code-sessies hervatten.
  • Een geëxporteerde API-sleutel. Die overschrijft de login in elke map.

Hoe Switch het gebruikt voor Claude Desktop

Claude Code in Claude Desktop leest je shell-aliassen niet. Switch regelt die situatie. Elk Switch-profiel opent Anthropics eigen Claude Desktop-app met een eigen datamap. Met Keep coding preferences separate aan, de standaard voor nieuwe profielen, krijgt het profiel ook een eigen Claude Code-configuratiemap, en start Switch de Claude Desktop van dat profiel met CLAUDE_CONFIG_DIR naar die map gericht.

Switch voegt geen Terminal-opdracht toe, en elk account houdt zijn eigen abonnement en gebruikslimieten. Hoe Switch met Claude Code omgaat.

Verder lezen