SwitchFrühzugangCLAUDE_CONFIG_DIR: was die Variable in Claude Code bewirkt
CLAUDE_CONFIG_DIR weist Claude Code an, statt des Standardordners ~/.claude ein anderes Konfigurationsverzeichnis zu verwenden. Einstellungen, Sitzungsverlauf, Plugins und der Login folgen der Variable, sodass jedes Verzeichnis wie eine eigene Claude Code-Einrichtung wirkt. Anthropic empfiehlt sie, um einen Arbeitsaccount und einen privaten Account gleichzeitig angemeldet zu halten.
Auch auf: English · Español · Français · 日本語 · 简体中文 · Português (Brasil) · 한국어 · Italiano · Nederlands · 繁體中文
Ein Ratgeber von Switch, einer unabhängigen Profilverwaltung für Claude Desktop. Switch ist vor der öffentlichen Veröffentlichung im Frühzugang.
Was CLAUDE_CONFIG_DIR bewirkt
Anthropics Referenz der Umgebungsvariablen beschreibt CLAUDE_CONFIG_DIR als Überschreibung des Konfigurationsverzeichnisses, das standardmäßig ~/.claude ist. Alle Einstellungen, der Sitzungsverlauf und die Plugins werden unter dem Pfad gespeichert, den Sie angeben.
Sonst ändert sich an Claude Code nichts. Der Befehl claude ist dasselbe Programm; er liest und schreibt nur einen anderen Ordner. Starten Sie ihn mit einem Wert, erhalten Sie eine Einrichtung. Starten Sie ihn mit einem anderen, erhalten Sie eine zweite, unabhängige.
Was in einem Claude Code-Config-Verzeichnis liegt
Laut Anthropics Leitfaden zum .claude-Verzeichnis liegt, wenn Sie CLAUDE_CONFIG_DIR setzen, jeder Pfad, der normalerweise unter ~/.claude stünde, stattdessen unter Ihrem Verzeichnis. Dazu gehören:
- Ihre persönliche
CLAUDE.md,settings.json, Skills, Befehle, Subagents und Output Styles. - Sitzungsprotokolle in
projects/sowie die Auto Memory für jedes Projekt. - Datei-Snapshots für die Wiederherstellung von Checkpoints, Plan-Dateien und Ihr Prompt-Verlauf.
- Keybindings und eigene Themes.
Projektdateien sind nicht betroffen. Die eigene CLAUDE.md, der .claude/-Ordner und die .mcp.json eines Repositorys gehören zum Projekt, daher sieht jedes Konfigurationsverzeichnis sie.
Wie Logins auf dem Mac getrennt bleiben
Unter macOS speichert Claude Code Zugangsdaten im verschlüsselten Schlüsselbund. Laut Anthropics Hinweisen zur Verwaltung von Zugangsdaten verknüpft Claude Code den Schlüsselbund-Eintrag mit diesem Verzeichnis, wenn CLAUDE_CONFIG_DIR gesetzt ist, sodass eine Sitzung mit einem anderen Verzeichnis einen anderen Eintrag liest. Verweigert der Schlüsselbund das Schreiben, landet auch die Ausweichdatei .credentials.json in diesem Verzeichnis.
Es gibt eine dokumentierte Ausnahme. Getrennte Verzeichnisse halten zwei Claude Console-Anmeldungen ohne API-Schlüssel nicht auseinander, weil Claude Code diese Art der Anmeldung außerhalb des Konfigurationsverzeichnisses speichert (Dokumentation zur Authentifizierung, Stand: Oktober 2026).
Auch Umgebungsvariablen können den Login in jedem Verzeichnis überschreiben. Wenn ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN oder CLAUDE_CODE_OAUTH_TOKEN in Ihrer Shell exportiert ist, kann es gegenüber dem Account gewinnen, mit dem Sie sich angemeldet haben. Die vollständige Reihenfolge finden Sie unter Claude Code-Account wechseln.
Wo Sie die Variable setzen
Am einfachsten ist ein Shell-Alias, das Beispiel, das Anthropic selbst gibt. Fügen Sie ihn in ~/.zshrc ein und öffnen Sie ein neues Terminal-Fenster:
alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'Beim ersten Start führt Claude Code Sie durch Login und Einrichtung für das neue Verzeichnis. Das einfache claude verwendet weiterhin ~/.claude.
Sie können die Variable auch in den Benutzer- oder verwalteten Einstellungen setzen. Schreiben Sie in einer Einstellungsdatei den absoluten Pfad. In Projekt- und lokalen Einstellungen ignoriert Claude Code sie, daher lässt sie sich auf diesem Weg nicht pro Repository festlegen.
Um zu prüfen, welches Verzeichnis eine Shell verwendet, führen Sie claude auth status aus. In neueren Versionen enthält die JSON-Ausgabe ein Feld configDirectory (CLI-Referenz).
Häufige Fehler
- Die Variable in einem Fenster vergessen. Ein Terminal-Tab ohne sie verwendet
~/.claudeund dessen Login, was leicht übersehen wird. Aliase verhindern das. ~in einer Einstellungsdatei verwenden. Einstellungsdateien brauchen den absoluten Pfad, etwa/Users/you/.claude-work.- Einen ganzen Ordner kopieren, um einen neuen anzulegen. Damit kopieren Sie Verlauf und Zustand eines Accounts in den anderen. Beginnen Sie mit einem leeren Ordner und fügen Sie hinzu, was Sie brauchen. Skills und MCP-Server teilen behandelt das.
- Erwarten, dass alte Sitzungen mitkommen. Sitzungsprotokolle liegen in dem Verzeichnis, das sie erstellt hat, daher listet
claude --resumesie in einem anderen Verzeichnis nicht auf. Siehe Claude Code-Sitzungen fortsetzen. - Ein exportierter API-Schlüssel. Er überschreibt den Login in jedem Verzeichnis.
Wie Switch die Variable für Claude Desktop nutzt
Claude Code in Claude Desktop liest Ihre Shell-Aliase nicht. Diesen Fall übernimmt Switch. Jedes Switch-Profil öffnet Anthropics eigene Claude Desktop-App mit einem eigenen Datenordner. Wenn Keep coding preferences separate (Coding-Einstellungen getrennt halten) aktiviert ist, was bei neuen Profilen die Standardeinstellung ist, bekommt das Profil außerdem einen eigenen Claude Code-Konfigurationsordner, und Switch startet das Claude Desktop dieses Profils mit CLAUDE_CONFIG_DIR, das auf diesen Ordner zeigt.
Switch fügt keinen Terminal-Befehl hinzu, und jeder Account behält seinen eigenen Plan und seine Nutzungslimits. Wie Switch mit Claude Code umgeht.