Source: https://aiprimetech.io/de/blog/cc-switch-claude-code-account-provider-manager/ Juli 22, 2026 · 6 Min. · Werkzeuge # CC Switch für Claude Code: Konten, Anbieter und Konfigurationen verwalten A Von [AI Prime Tech](https://aiprimetech.io/de/) · KI-unterstützt Um 9:05 Uhr morgens richten Sie Claude Code auf ein Unternehmens-Gateway aus. Um 11:30 benötigen Sie ein persönliches Anthropic-Konto. Nach dem Mittagessen erfordert ein Kunden-Repository eigene MCP-Server und Modellaliasnamen. Am Ende des Tages wurde ~/.claude/settings.json dreimal bearbeitet, eine Shell enthält noch ein altes Token und niemand ist sicher, welchen Endpunkt die nächste Anfrage erreichen wird. CC Switch löst dieses betriebliche Problem mit benannten Profilen, die über eine Desktop-Anwendung verwaltet werden. Statt Zugangsdaten, Anbieter-URLs, MCP-Definitionen und agentenspezifische Konfigurationsdateien manuell zu verschieben, wählen Sie das Profil aus, das aktiv sein soll. Das wichtige technische Detail ist, dass es sich um Konfigurationsmanagement handelt, nicht um Kontovirtualisierung: Claude Code liest weiterhin seine üblichen lokalen Dateien und Umgebungseinstellungen, während CC Switch koordiniert, was dort geschrieben wird. Diese Erleichterung ist erheblich, doch dasselbe gilt für die damit verbundene Vertrauensgrenze. Ein Dienstprogramm, das zwischen Entwicklerkonten wechseln kann, muss Zugangsdaten von Entwicklern lesen oder schreiben können. Bevor Sie es einsetzen, sollten Sie genau verstehen, welche Dateien es verändert, wo seine eigene Datenbank liegt und wie diese Dateien geschützt sind. ## Was CC Switch bei der Verwaltung von Claude Code tatsächlich leistet CC Switch ist ein quelloffener Desktop-Konfigurationsmanager für Coding-Agenten. Die unterstützten Integrationen wurden im Laufe der Zeit erweitert. Prüfen Sie daher das aktuelle Repository und die Versionshinweise, bevor Sie sich auf eine feste Liste als Standard festlegen. Claude Code ist eine der wichtigsten Integrationen; aktuelle Versionen unterstützen auch andere Coding-Agenten für die Kommandozeile wie Codex und Gemini CLI. Für Claude Code kombiniert ein Anbieterprofil in der Regel: - Einen Anthropic-kompatiblen API-Endpunkt - Einen API-Schlüssel oder ein Authentifizierungstoken - Modellzuordnungen oder modellbezogene Umgebungswerte - Zusätzliche Umgebungsvariablen - MCP-Serverdefinitionen - Claude Code-Einstellungen, die zum Profil gehören sollen Das ist nützlich, wenn „Konto“ nicht einfach eine Anthropic-Anmeldung bedeutet. In realen Einsatzumgebungen wechseln Entwickler möglicherweise zwischen: - Direktem Zugriff auf die Anthropic API - Einem API-Gateway einer Organisation mit Authentifizierung - Einem Anthropic-kompatiblen Drittanbieter - Getrennten Abrechnungskonten für persönliche Nutzung, Staging und Produktion - Einem lokalen oder entfernten Proxy mit kompatibler Anfragesemantik CC Switch bündelt diese Optionen und aktiviert die ausgewählte Konfiguration. Es sorgt nicht dafür, dass sich alle kompatiblen Endpunkte identisch verhalten. Unterschiede bei Modellnamen, Authentifizierungsheadern, Ratenlimits, Prompt-Caching und nicht unterstützten API-Feldern bleiben in der Verantwortung des Anbieters. | Ansatz | Aufwand beim Wechsel | Zugangsdaten zugänglich für | MCP-Verwaltung | Am besten geeignet für | Shell-Exporte | Anfangs gering, später fehleranfällig | Shell, Befehlsverlauf, untergeordnete Prozesse | Manuell | Ein temporäres Konto | Manuell bearbeitete Konfigurationsdateien | Mittel | Editor, Sicherungen, lokale Dateien | Manuell | Stabile Einrichtung mit einem einzigen Anbieter | Wrapper-Skripte | Nach der Einrichtung gering | Skript oder Secret-Manager | Skriptabhängig | Teams, die bereit sind, ihre Werkzeuge zu pflegen | CC Switch-Profile | Gering über die Desktop-Oberfläche | CC Switch und Konfigurationsdateien der Agenten | Zentrale Oberfläche | Mehrere Konten, Anbieter oder Agenten | Externer Secret-Manager mit Wrappern | Höchster Einrichtungsaufwand | Secret-Manager und Laufzeitprozess | Individuell | Strenge Kontrollvorgaben im Unternehmen Die Tabelle verdeutlicht die Abwägung: CC Switch reduziert Bedienfehler, wird aber selbst zu einer weiteren privilegierten lokalen Anwendung. ## Installation und Plattformunterstützung CC Switch wird über die GitHub Releases-Seite des Projekts verteilt. Das Repository beschreibt derzeit Desktop-Unterstützung für macOS, Windows und Linux, wobei die verfügbaren Release-Artefakte je nach Plattform und Version variieren. Prüfen Sie die Dateien, die dem Release beigefügt sind, das Sie bereitstellen möchten. Die Verfügbarkeit des Quellcodes garantiert nicht, dass für jedes Release jede Betriebssystemversion, CPU-Architektur oder jedes Paketformat gebaut wird. Unter macOS bietet das Projekt einen Workflow mit einem Homebrew-Cask: ``` brew tap farion1231/cc-switch brew install --cask cc-switch ``` Bevor Sie eine heruntergeladene Binärdatei in einer verwalteten Umgebung verwenden, prüfen Sie, was Homebrew installiert hat: ``` brew info --cask cc-switch brew list --cask cc-switch codesign -dv --verbose=4 "/Applications/CC Switch.app" 2>&1 ``` Windows- und Linux-Nutzer sollten das Installationsprogramm oder Paket aus den veröffentlichten Dateien des Releases beziehen. Paketnamen und Kanäle können sich ändern. Deshalb nehme ich keinen möglicherweise veralteten winget-, Scoop- .deb- oder AppImage-Befehl in Skripte zur Ersteinrichtung von Arbeitsstationen auf, ohne das genaue Release festzulegen und zu testen. Für einen kontrollierten Rollout: - Legen Sie eine bestimmte CC Switch-Version fest. - Dokumentieren Sie die erwartete Prüfsumme des Releases. - Testen Sie es mit einer Claude Code-Konfiguration, die anschließend verworfen werden kann. - Erfassen Sie alle Dateien, die während der Profilaktivierung geändert werden. - Definieren Sie einen Upgrade-Prozess, statt unbemerkt immer dem neuesten Release zu folgen. Eine einfache Momentaufnahme vor der Installation hilft: ``` mkdir -p /tmp/claude-config-before cp -R ~/.claude /tmp/claude-config-before/ 2>/dev/null || true # Install CC Switch, create a test profile, and activate it. diff -ru /tmp/claude-config-before/.claude ~/.claude || true ``` Damit lässt sich Verhalten erkennen, das in der Dokumentation möglicherweise fehlt, etwa Änderungen an der Formatierung, entfernte Felder oder MCP-Einträge, die in einem unerwarteten Geltungsbereich zusammengeführt werden. ## Anbieterprofile erstellen und wechseln Ein Profil sollte einen einheitlichen Sicherheits- und Abrechnungskontext abbilden. Ich verwende Namen, die die Auswirkungen deutlich machen, zum Beispiel: - anthropic-personal - company-gateway-dev - customer-a-restricted - local-proxy-test Vermeiden Sie Bezeichnungen wie default-2. Bei einem Vorfall in der Produktionsumgebung sollte der Name des aktiven Profils die Frage „Wohin geht diese Anfrage?“ beantworten, ohne dass Sie einen Editor öffnen müssen. Ein Claude Code-Profil, das ein Anthropic-kompatibles Gateway verwendet, könnte Einstellungen erzeugen, die konzeptionell etwa so aussehen: ``` { "env": { "ANTHROPIC_BASE_URL": "https://ai-gateway.example.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "${TOKEN_MANAGED_BY_PROFILE}", "ANTHROPIC_MODEL": "company-claude-default" }, "permissions": { "defaultMode": "default" } } ``` Welche Variablen genau erforderlich sind, hängt vom Anbieter und der Claude Code-Version ab. Einige Dienste erwarten ANTHROPIC_API_KEY; einige Gateway-Integrationen verwenden ANTHROPIC_AUTH_TOKEN. Belegen Sie nicht einfach beide, um die Wahrscheinlichkeit einer funktionierenden Authentifizierung zu erhöhen. Ermitteln Sie, welche Zugangsdaten Claude Code bevorzugt, denn ein veralteter Wert mit höherer Priorität kann dazu führen, dass Anfragen über das falsche Konto laufen. Starten Sie nach dem Wechsel einen neuen Claude Code-Prozess: ``` claude ``` Was tatsächlich passiert, wenn Sie wechseln, während Claude Code bereits läuft, wird leicht missverstanden. Das Dienstprogramm kann Dateien auf dem Datenträger aktualisieren, aber es kann Umgebungswerte, die ein laufender Prozess bereits geerbt hat, nicht zuverlässig ersetzen. Bestehende Sitzungen verwenden daher möglicherweise bis zum Neustart weiterhin ihren ursprünglichen Anbieter. Prüfen Sie die tatsächlich wirksame Konfiguration, ohne Geheimnisse auszugeben: ``` python3 - <<'PY' import json from pathlib import Path path = Path.home() / ".claude" / "settings.json" data = json.loads(path.read_text()) env = data.get("env", {}) for key, value in sorted(env.items()): if "KEY" in key or "TOKEN" in key or "SECRET" in key: value = "" print(f"{key}={value}") PY ``` Ein häufiger Fallstrick besteht darin, nur zu testen, ob Claude antwortet. Ein kompatibler Proxy kann eine gültige Antwort zurückgeben und dabei Ihr angefordertes Modell unbemerkt einem anderen Modell zuordnen. Prüfen Sie die Anfrageprotokolle des Anbieters oder das Audit-Protokoll des Gateways, wenn die Identität des Modells wichtig ist. ## MCP-Einstellungen über mehrere Agenten hinweg Bei der MCP-Konfiguration bietet die zentrale Verwaltung mehr Nutzen als die bloße Auswahl eines Tokens. Ein Entwickler hat möglicherweise Server für Dateisysteme, Issue-Tracker, Datenbanken und Browser in mehreren Agenten konfiguriert, jeweils mit eigenem Schema oder Speicherort. Eine typische MCP-Serverdefinition enthält einen Befehl und Argumente: ``` { "mcpServers": { "project-files": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/alex/work/customer-a" ] } } } ``` Behandeln Sie dies als ausführbare Konfiguration. Die Aktivierung des Profils kann einem Agenten erlauben, npxzu starten, ein Paket auszuführen und das angegebene Verzeichnis über die dem Modell zugängliche Werkzeugebene bereitzustellen. In der Praxis trenne ich MCP-Profile nach der Sensibilität des Repositorys: - Ein allgemeines Profil stellt Dokumentation und Werkzeuge mit geringem Risiko bereit. - Ein Kundenprofil stellt ausschließlich das Arbeitsverzeichnis dieses Kunden bereit. - Server für Datenbanken und die Steuerung von Produktionssystemen werden nicht global aktiviert. - Der Geltungsbereich von Tokens für MCP-Server wird unabhängig vom Token des Modellanbieters festgelegt. Vergleichen Sie außerdem das von CC Switch erzeugte Ergebnis mit dem nativen MCP-Befehl des Agenten, sofern verfügbar. Prüfen Sie bei Claude Code nach dem Wechsel die aktiven Server: ``` claude mcp list ``` Gehen Sie nicht davon aus, dass ein MCP-Objekt JSON unverändert in jeden Coding-Agenten kopiert werden kann. CC Switch kann die Verwaltung in seiner Oberfläche vereinheitlichen, doch jeder nachgelagerte Agent hat weiterhin sein eigenes Schema, seine eigenen Regeln für Geltungsbereiche und sein eigenes Lebenszyklusverhalten. ## Wo Zugangsdaten gespeichert werden Es gibt zwei Speicherebenen, die geprüft werden müssen: - Die Anwendungsdaten von CC Switch, in denen Profile gespeichert werden. - Die native Konfiguration des Coding-Agenten, die beim Aktivieren eines Profils geschrieben oder aktualisiert wird. CC Switch verwendet lokalen Anwendungsspeicher statt eines gehosteten Kontodienstes. Der genaue Pfad hängt von der Plattform ab und hat sich mit der Weiterentwicklung der Anwendung geändert. Ermitteln Sie ihn daher anhand des installierten Builds, statt sich auf einen Pfad aus einem alten Issue zu verlassen. Häufige Stammverzeichnisse für Anwendungsdaten der Betriebssysteme sind: ``` macOS: ~/Library/Application Support/ Windows: %APPDATA% Linux: ~/.local/share/ or an XDG data directory ``` Suchen Sie, ohne den Inhalt von Zugangsdaten auszugeben: ``` find "$HOME/Library/Application Support" \ -maxdepth 3 -iname '*cc*switch*' -print 2>/dev/null find "${XDG_DATA_HOME:-$HOME/.local/share}" \ -maxdepth 3 -iname '*cc*switch*' -print 2>/dev/null ``` Prüfen Sie bei Claude Code ~/.claude/, insbesondere settings.json, sowie gegebenenfalls die Claude-Konfiguration auf Projektebene. Andere Agenten verwenden häufig separate Verzeichnisse wie ~/.codex/ oder ~/.gemini/, aber Dateinamen und Formate für Zugangsdaten hängen von der Agentenversion ab. Gehen Sie nicht davon aus, dass „lokal gespeichert“ auch „verschlüsselt“ bedeutet. Sofern Ihre installierte CC Switch-Version für das jeweilige Geheimnis nicht ausdrücklich einen Zugangsdaten-Tresor des Betriebssystems verwendet, sollten Sie davon ausgehen, dass die Anwendungsdatenbank und die generierten Agentendateien über Ihr Benutzerkonto möglicherweise im Klartext lesbar sind. Prüfen Sie dies durch Untersuchung der Dateien und eine Codeprüfung des Repositorys. Achten Sie dabei darauf, keine Geheimnisse in Terminals, Tickets oder Chats einzufügen. ## Sicherheitsauswirkungen des Token-Zugriffs auf dem Desktop CC Switch arbeitet zwangsläufig mit den Berechtigungen Ihres Desktop-Benutzers. Wenn dieses Konto ein Token lesen kann, können möglicherweise auch Schadsoftware oder andere Prozesse, die unter demselben Benutzer laufen, darauf zugreifen. CC Switch macht Anforderungen an die Endgerätesicherheit nicht überflüssig. Die wichtigsten Risiken sind: - Konzentration von Zugangsdaten: Mehrere Anbieter-Tokens können gemeinsam in einem lokalen Profilspeicher liegen. - Überschreiben der Konfiguration: Die Aktivierung eines Profils kann Dateien, die ein Agent verwendet, ersetzen oder zusammenführen. - Datenabfluss durch Backups: Anwendungsdaten und Dotfiles können in unverschlüsselte Backups gelangen. - Vererbung an Prozesse: Bereits geöffnete Terminals und laufende Agenten können frühere Zugangsdaten beibehalten. - MCP-Ausführung: Ein Profil kann Befehle mit Zugriff auf das Dateisystem oder das Netzwerk aktivieren. - Risiken in der Software-Lieferkette: Durch die Installation von Updates erhält neuer Desktop-Code Zugriff auf gespeicherte Tokens. - Offenlegung auf dem Bildschirm und in Protokollen: Diagnoseinformationen in der Benutzeroberfläche oder Fehlerberichte können Endpunkt- und Zugangsdaten offenlegen. Setzen Sie rund um das Tool Kontrollen nach dem Prinzip der geringsten Rechte ein: ``` chmod 700 ~/.claude chmod 600 ~/.claude/settings.json ``` Bevorzugen Sie kurzlebige oder widerrufbare Gateway-Tokens, sofern der Anbieter diese unterstützt. Hinterlegen Sie niemals administrative Zugangsdaten für die Produktion in einem Komfortprofil. Rotieren Sie Tokens, nachdem ein Rechner außer Betrieb genommen wurde; das Löschen eines Profils ist kein Beleg dafür, dass die Zugangsdaten niemals an einen anderen Ort kopiert wurden. Für den unternehmensweiten Einsatz würde ich Folgendes verlangen: - Festgelegte, geprüfte Releases - Vollständige Festplattenverschlüsselung - Restriktive Handhabung von Backups - Ausgabenlimits und Audit-Protokolle auf Anbieterseite - Separate Tokens pro Entwickler und Umgebung - Ein dokumentiertes Verfahren zum Widerrufen von Tokens - Regelmäßige Prüfung der MCP-Befehle und freigegebenen Pfade CC Switch eignet sich gut für lokale Workflows mit mehreren Anbietern. Es eignet sich jedoch nicht automatisch für Umgebungen, deren Richtlinien hardwaregestützte Geheimnisse, kurzlebige Zugangsdaten oder zentral durchgesetzte Konfigurationen verlangen. In solchen Fällen kann ein Unternehmens-Gateway zusammen mit einem Launcher, der auf einen Secret Manager zurückgreift, die besser vertretbare Architektur sein. ## Praktische Empfehlungen - Verwenden Sie CC Switch, wenn wiederholte manuelle Änderungen zu Fehlern bei Konten, Endpunkten oder MCP führen. - Prüfen Sie vor der Einführung die plattformspezifischen Artefakte im aktuellen GitHub-Release des Projekts. - Geben Sie jedem Profil einen Namen, der Anbieter, Eigentümer und Umgebung erkennen lässt. - Starten Sie Claude Code nach dem Wechsel neu, da laufende Prozesse alte Werte beibehalten können. - Prüfen Sie die generierten Dateien und verwenden Sie claude mcp list , um den tatsächlich wirksamen Zustand zu überprüfen. - Behandeln Sie die lokalen Daten von CC Switch und die nachgelagerten Agentenkonfigurationen als sensible Zugangsdaten-Speicher. - Begrenzen Sie den Zugriff von MCP-Servern ebenso sorgfältig wie den von API-Tokens; sie können Befehle ausführen und Dateien offenlegen. - Legen Sie Release-Versionen fest, prüfen Sie Konfigurationsunterschiede und halten Sie ein Verfahren zum Widerrufen von Tokens bereit. - Halten Sie Produktionszugangsdaten mit weitreichenden Befugnissen aus Desktop-Tools zum Profilwechsel heraus, sofern die begleitenden Kontrollen dieses Risiko nicht ausdrücklich abdecken. [Programmierung](/de/blog/tag/coding/)[Claude](/de/blog/tag/claude/)[API](/de/blog/tag/api/) A [AI Prime Tech](https://aiprimetech.io/de/) AI Prime Tech veröffentlicht diesen Blog. Die Artikel werden mit KI-Unterstützung verfasst; prüfen Sie versionsspezifische Angaben wie Modell-IDs, Preise und Limits anhand der offiziellen Dokumentation, bevor Sie sich darauf verlassen. Günstigeren Zugang zur Claude API erhalten Ein API-Schlüssel für Claude Opus 5.5, Sonnet 5, Haiku 4.5 und Fable 5.1 sowie GPT-6 Modelle. Nutzungsbasierte Abrechnung, kein Abonnement. [API-Schlüssel erhalten →](/register) AI Prime Tech ist ein unabhängiges API-Gateway eines Drittanbieters. Claude™ und Anthropic® sind Marken von Anthropic, PBC. Eine Verbindung oder Unterstützung wird nicht impliziert.