Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

Wenn Claude Code nach einem Wechsel mit CC Switch nicht mehr verbindet, prüfen Sie zuerst, welcher Anbieter und welche Anmeldung tatsächlich aktiv sind. Danach kontrollieren Sie bei Bedrock oder Vertex die Cloud-Zugangsdaten und Modellberechtigung; Proxy-, TLS- und Installationsprobleme kommen erst infrage, wenn die Fehlermeldung darauf hindeutet.

Was CC Switch beim Anbieterwechsel ändert

CC Switch kann ausgewählte Einträge in Claudes settings.json austauschen: Verbindungs- und Authentifizierungsvariablen in env wie ANTHROPIC_* oder AWS_*, Protokollschalter wie CLAUDE_CODE_USE_BEDROCK sowie Werte auf oberster Ebene wie model und apiKeyHelper. Auch einige anbieterspezifische Kompatibilitätsoptionen können wechseln.

Laut der CC-Switch-FAQ bleiben nicht anbieterspezifische Einstellungen wie permissions, hooks, enabledPlugins und statusLine erhalten. Das ist eine Aussage der Projektdokumentation, keine unabhängig bestätigte Garantie für jede Version. Die Dokumentation liegt auf dem veränderlichen main-Branch; Bezeichnungen und Details können sich ändern. Kontrollieren Sie deshalb vor und nach einem Wechsel ~/.claude/settings.json und die aktive CC-Switch-Konfiguration. Teilen Sie API-Schlüssel niemals in Screenshots, Tickets oder öffentlich zugänglichen Logs.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Fehlermeldung zuerst der richtigen Schicht zuordnen

Ein Anbieterwechsel betrifft mehrere Ebenen. Gehen Sie von Anmeldung und Identität über Cloud-Zugriff bis zum Netzwerk vor, statt den Anbieter wiederholt umzuschalten. Ändern Sie jeweils nur die Einstellung, die zum erkannten Problem passt.

#1 Best Overall
Sale
Pearson Computer Networking, 8E
  • brand: Pearson
  • Computer Networking, 8e
Symptom Wahrscheinliche Prüfebene Nächster Schritt
Not authenticated oder unerwartete Nutzung eines API-Schlüssels Anmeldung und Authentifizierungsquelle Aktive Umgebungsvariablen und den in CC Switch gewählten Authentifizierungstyp prüfen.
Could not load credentials Cloud-Credentials Wirksame AWS-Identität oder Google-Cloud-Anmeldung kontrollieren.
403 oder model not available Modellzugriff, Projekt, Region oder Organisation Prüfen, ob das Konto für das angefragte Modell freigeschaltet ist.
TLS-Handshake-, Proxy- oder Verbindungsfehler Proxy, Zertifikat oder Firewall Proxy-Variablen, CA-Zertifikat, mTLS-Dateien und freigegebene Endpunkte kontrollieren.
claude: command not found Installation oder PATH Neue Shell öffnen oder Shell-Profil neu laden.

Anthropics Fehlerhilfe zu Installation und Authentifizierung behandelt unter anderem die Meldungen Not authenticated, Could not load credentials und 403 / model not available.

Prüfen, welches Konto und welcher Schlüssel verwendet werden

Claude Code kann eine gesetzte Umgebungsvariable ANTHROPIC_API_KEY anstelle einer Anmeldung über ein Claude-Abonnement verwenden. Dann kann die Anfrage über API-Verbrauch abgerechnet werden, statt die im Abonnement enthaltene Nutzung zu verwenden. Ein Schlüssel, der in einem anderen Terminal gesetzt wurde, gilt nicht automatisch in dem Terminal, aus dem Sie Claude Code starten. Je nach Schlüssel kann außerdem eine einmalige Vertrauensfreigabe erforderlich sein.

  1. Prüfen Sie im selben Terminal, in dem Sie claude starten, ob ANTHROPIC_API_KEY gesetzt ist. Geben Sie den Wert nicht aus und veröffentlichen Sie ihn nicht.
  2. Kontrollieren Sie in CC Switch, welcher Anbieter aktiv ist und welche Authentifizierungsart dafür vorgesehen ist.
  3. Wenn Sie ein anderes Claude-Abonnementkonto verwenden möchten und es nicht angeboten wird, melden Sie die CLI mit /logout ab, aktualisieren Sie Claude Code, starten Sie das Terminal neu und melden Sie sich erneut an. Anthropic beschreibt diese Abfolge für Probleme beim Kontowechsel in der Hilfe zu Claude Code mit einem Pro- oder Max-Plan.
  4. Bevor Sie die nächste Anfrage senden, vergewissern Sie sich, ob Sie eine Subscription-Anmeldung oder einen API-Schlüssel verwenden möchten. Bei Console-Organisationen kann eine SSO-Anforderung eine einfache Anmeldung per API-Schlüssel verhindern.

Bedrock- und Vertex-Zugang unabhängig vom Modell testen

Ein Anbieterwechsel allein verschafft nicht automatisch Zugriff auf ein Cloud-Modell. Zugangsdaten, aktive Identität, Region, Projekt und Modellfreigabe müssen zusammenpassen.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Amazon Bedrock

Führen Sie aws sts get-caller-identity aus, um die wirksame AWS-Identität zu prüfen. Kontrollieren Sie außerdem AWS_REGION: Sie muss auf eine Region zeigen, in der das gewünschte Modell aktiviert ist.

Google Vertex AI

Für die Anmeldung mit Application Default Credentials nennt Anthropic den Befehl gcloud auth application-default login. Prüfen Sie, ob ANTHROPIC_VERTEX_PROJECT_ID und CLOUD_ML_REGION zum vorgesehenen Projekt und zur passenden Region gehören.

Wenn die Meldung Could not load credentials erscheint, prüfen Sie zuerst diese Anmeldung und Identität, statt den Anbieter erneut umzuschalten. Bei 403 oder model not available kann die Authentifizierung funktionieren, während dem Konto, Projekt oder der Organisation der Zugriff auf das angefragte Modell fehlt. Kontrollieren Sie die aktive Organisationsberechtigung und den Modellzugriff; mit /model können Sie ein Modell auswählen, auf das tatsächlich Zugriff besteht. Die Beispiele und Prüfungen führt Anthropics Fehlerhilfe auf.

Proxy, TLS-Zertifikate und Firewall eingrenzen

Claude Code unterstützt Standard-HTTP(S)-Proxyvariablen, darunter HTTPS_PROXY und HTTP_PROXY. SOCKS-Proxies werden nicht unterstützt. Die beim Start gesetzten Shellvariablen werden von Claude Code eingelesen; starten Sie die CLI nach einer Änderung neu.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Proxy-URL: Prüfen Sie, ob die URL korrekt ist und das erwartete Schema enthält.
  • Firewall-Freigaben: Stellen Sie sicher, dass die für Ihren Anmelde- und Anbieterweg benötigten Endpunkte erreichbar sind. Anthropics Dokumentation zur Unternehmensnetzwerkkonfiguration nennt unter anderem api.anthropic.com, claude.ai und für Downloads downloads.claude.ai. Je nach Verbindungsweg werden unterschiedliche Hosts benötigt.
  • Firmenzertifikat: Prüfen Sie, ob die benötigte Firmen-CA im Zertifikatsspeicher verfügbar ist oder über NODE_EXTRA_CA_CERTS eingebunden wurde.
  • mTLS: Kontrollieren Sie, ob Zertifikat und privater Schlüssel vorhanden, gültig und korrekt gepaart sind. Bei TLS-Handshake- oder Verbindungsfehlern kann ein erneutes Einlesen der Zertifikatsdateien helfen; das genaue Verhalten hängt von der Claude-Code-Version ab.
  • Proxy-Anmeldedaten: Schreiben Sie Zugangsdaten für einen authentifizierten Proxy nicht fest in Skripte oder gemeinsam genutzte Konfigurationsdateien.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Installation und PATH nur bei passenden Symptomen prüfen

Die folgenden Schritte sind für Installationsfehler gedacht, nicht für einen HTTP-Fehler nach erfolgreichem Start von Claude Code.

  • Bei claude: command not found öffnen Sie eine neue Shell oder laden Sie Ihr Shell-Profil erneut.
  • Wenn eine globale npm-Installation an Berechtigungen scheitert, empfiehlt Anthropic, nicht sudo npm install -g zu verwenden. Als Alternativen nennt die Dokumentation die native Installation oder ein benutzereigenes npm-Präfix.
  • Mit claude doctor erhalten Sie Diagnoseinformationen für Installations- und Updateprobleme.

Die offizielle Setup-Dokumentation für Claude Code nennt als unterstützte Mindestversionen macOS 13+, Windows 10 1809+ oder Server 2019+, Ubuntu 20.04+, Debian 10+ und Alpine 3.19+. Außerdem nennt sie mindestens 4 GB RAM sowie einen x64- oder ARM64-Prozessor. Das Aktualisierungsverhalten hängt vom Installationsweg ab: Die native Installation aktualisiert automatisch; Homebrew und WinGet aktualisieren standardmäßig nicht automatisch.

Die passende Verbindungsroute bewusst wählen

Keine Anmelde- oder Providervariante ist grundsätzlich die beste. Entscheidend ist, dass die ausgewählte Route zu Abrechnung, Organisationsregeln, Cloud-Berechtigungen und Netzwerkumgebung passt.

Entscheidungspunkt Was Sie festlegen oder prüfen
Authentifizierung Claude-Subscription/OAuth, Anthropic-API-Schlüssel oder Zugangsdaten des Cloud-Providers.
Abrechnung und Organisation Subscription-Nutzung oder API-Verbrauch sowie mögliche SSO- und Organisationsvorgaben.
Cloud-Providerzugriff Konto, Projekt, Region und ausdrückliche Modellfreigabe bei Bedrock oder Vertex.
Netzwerkweg Direktverbindung oder Unternehmensproxy mit Anforderungen an CA-Zertifikat und mTLS.

Notieren Sie vor einem Wechsel, welche Route Sie verwenden möchten. Ordnen Sie anschließend die konkrete Meldung einer dieser Ebenen zu und ändern Sie nur die betroffene Einstellung.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.