Claude Code VS Code-Erweiterung: API-Key und eigenes Gateway einrichten
Stand 2026-10-07 nennt die offizielle Claude Code-Dokumentation einen zuverlässigen Weg, die VS Code-Erweiterung mit einem eigenen Gateway zu verbinden: ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN in claudeCode.environmentVariables in den VS Code-Benutzereinstellungen eintragen, denn die Erweiterung prüft die Zugangsdaten aus dieser Einstellung vor dem Start. Tragen Sie dieselben zwei Werte zusätzlich in den env-Block von ~/.claude/settings.json ein, damit die CLI im Terminal sie mitnutzt. Für QCode sind das https://api.qcode.cc/api und ein Schlüssel, der mit cr_ beginnt. Diese Seite zeigt die Schritte, das Verhältnis zur CLI und drei häufige Probleme: Der Schlüssel wird nicht gefunden, die Anmeldung wird weiter verlangt, die Modellauswahl.
Aktualisiert 2026-10-08
Vier Punkte vorab
Mehr braucht QCode nicht
ANTHROPIC_BASE_URL auf https://api.qcode.cc/api (bis /api, ohne Schrägstrich am Ende) und ANTHROPIC_AUTH_TOKEN auf den cr_-Schlüssel, den Sie im Dashboard erstellen.
Der zuverlässige Ort für den Gateway-Schlüssel
Laut offizieller Dokumentation prüft die Erweiterung vor dem Start die Zugangsdaten in claudeCode.environmentVariables; Werte aus ~/.claude/settings.json erreichen den gestarteten Prozess, aber nicht die eigene Anmeldeprüfung der Erweiterung.
Gemeinsame Konfiguration mit der CLI
~/.claude/settings.json teilen sich Erweiterung und CLI. Tragen Sie dort im env-Block dieselben zwei Werte ein, dann nutzt claude im Terminal dasselbe Gateway. Nicht in die .claude/settings.json des Projekts schreiben, denn diese Datei wird committet.
Kontextfenster hinter eigener Base URL
Seit 2.1.285 laufen Sitzungen hinter einer eigenen ANTHROPIC_BASE_URL auf Opus 4.7+, Sonnet 5+ und Fable direkt mit 1M; endet Ihr Gateway bei 200K, rät das offizielle Changelog zu /autocompact 200k.
Wie die VS Code-Erweiterung ihre Konfiguration liest
Stand 2026-10-07 lautet die kurze Antwort: Die Erweiterung hat zwei Arten von Einstellungen. Laut offizieller Dokumentation steuern die Erweiterungseinstellungen in VS Code das Verhalten der Erweiterung, während ~/.claude/settings.json von Erweiterung und CLI gemeinsam genutzt wird und Umgebungsvariablen, erlaubte Befehle, Hooks und MCP-Server enthält. Für ein eigenes Gateway legt die offizielle Gateway-Dokumentation die Zugangsdaten in claudeCode.environmentVariables in den VS Code-Benutzereinstellungen ab, weil die Erweiterung sie dort vor dem Start prüft. Die Erweiterung bringt eine eigene Kopie der CLI für das Chat-Panel mit, fügt claude aber nicht zum PATH hinzu; um claude im integrierten Terminal zu nutzen, installieren Sie die CLI separat. Vorausgesetzt wird VS Code 1.94.0 oder neuer. Mit einem kostenpflichtigen Claude-Abo oder einem Console-Konto brauchen Sie keinen API-Key; bei einem Gateway ersetzt eine Variable mit Zugangsdaten die Anmeldung bei claude.ai.
Neuere Änderungen rund um VS Code (Stand 2026-10-07)
Stand 2026-10-07 ist 2.1.292 die neueste Version in den GitHub Releases, veröffentlicht am 2026-10-06 (UTC). Für Gateways relevant: Seit 2.1.285 nutzen Sitzungen hinter einer eigenen ANTHROPIC_BASE_URL das 1M-Kontextfenster von Modellen, die eines haben (Opus 4.7+, Sonnet 5+, Fable), und das offizielle Changelog rät zu /autocompact 200k, wenn Ihr Gateway bei 200K endet; 2.1.280 brachte VS Code einen Status-Dialog, der nach Eingabe von /status Version, Konto, Modell und Serverdetails der Sitzung zeigt; seit 2.1.277 zeigt der Dialog Account & usage dort, wo keine Tariflimits gelten (das Changelog nennt Vertex, Bedrock, Foundry und API key), Kosten und Token-Verbrauch der Sitzung; 2.1.290 behob, dass Anmeldung und neue Sitzungen keinen klaren Grund nannten, wenn Claude Code sein Programm nicht finden oder starten kann.
Zeitleiste der Versionen
2.1.261 erschienen (UTC): Behoben wurde, dass in VS Code trotz aktivierter Einstellung Disable Login Prompt der Anmeldebildschirm erschien, wenn Claude Code keine Anmeldung meldete oder eine Anfrage mangels Anmeldung fehlschlug.
2.1.280 erschienen (UTC): VS Code erhielt einen Status-Dialog. Geben Sie im Panel /status ein, um Version, Konto, Modell und Serverdetails der Sitzung zu sehen – so lässt sich leichter prüfen, ob die Konfiguration greift.
2.1.285 erschienen (UTC): Sitzungen hinter einer eigenen ANTHROPIC_BASE_URL laufen bei Modellen mit 1M-Fenster (Opus 4.7+, Sonnet 5+, Fable) jetzt direkt mit 1M.
Bestätigt vs. nicht dokumentiert
Bestätigt (wörtlich in der Dokumentation)
Folgendes lässt sich wörtlich in der offiziellen Claude Code-Dokumentation, im Changelog oder in der QCode-Dokumentation nachprüfen: VS Code 1.94.0 oder neuer; die Erweiterung bringt die CLI mit, fügt sie aber nicht zum PATH hinzu; ~/.claude/settings.json teilen sich Erweiterung und CLI; Gateway-Variablen gehören in claudeCode.environmentVariables, deren Zugangsdaten die Erweiterung vor dem Start prüft; Disable Login Prompt überspringt Anmeldeaufforderungen; ANTHROPIC_AUTH_TOKEN wird als Authorization: Bearer gesendet, ANTHROPIC_API_KEY als x-api-key; eine Variable mit Zugangsdaten hat Vorrang vor einer gespeicherten claude.ai-Anmeldung; nur ANTHROPIC_BASE_URL ohne Zugangsdaten ersetzt die Abo-Anmeldung nicht; Erweiterung und CLI teilen den Gesprächsverlauf; die Umstellung auf 1M als Standardfenster in 2.1.285; die QCode-Werte https://api.qcode.cc/api und ein cr_-Schlüssel.
Nicht dokumentiert oder nicht geprüft
Zu drei Punkten zieht diese Seite keine Schlüsse. Erstens: Stand 2026-10-07 führt die offizielle Tabelle der Erweiterungseinstellungen keine eigene Einstellung für API-Key oder Base URL auf; diese Seite behandelt nur die Orte, die die offizielle Dokumentation nennt, andere Wege über eigene Konfigurationsdateien gehören nicht dazu. Zweitens: Laut offizieller Dokumentation kann Claude Code ein niedrigeres Limit, das ein Gateway setzt, nicht erkennen; ob Ihr Gateway 1M durchlässt, zeigen nur dessen Dokumentation oder eigene Tests. Drittens: Namen von Einstellungen und Schaltflächen ändern sich von Version zu Version; diese Seite folgt der am 2026-10-07 abgerufenen offiziellen Dokumentation ohne Test jeder Version, maßgeblich ist Ihre Version.
Wohin damit und wie es mit der CLI zusammenhängt
environmentVariables oder settings.json
Am einfachsten füllen Sie beides. claudeCode.environmentVariables ist eine VS Code-Benutzereinstellung, die Umgebungsvariablen für den Claude-Prozess setzt; die Erweiterung prüft die Zugangsdaten dort vor dem Start, deshalb legt die offizielle Gateway-Dokumentation den Schlüssel hier ab. Den env-Block in ~/.claude/settings.json teilen sich Erweiterung und CLI im Terminal, und die offizielle VS Code-Dokumentation empfiehlt ihn für gemeinsame Konfiguration. Nur Letzteres: Die Werte erreichen den Prozess, aber nicht die Anmeldeprüfung der Erweiterung. Nur Ersteres: Die Konfiguration wird nicht mit der CLI im Terminal geteilt.
VS Code-Erweiterung oder CLI im Terminal
Beide lesen dieselben Einstellungsdateien und teilen den Gesprächsverlauf: claude --resume im Terminal setzt ein Gespräch aus der Erweiterung fort. Der Unterschied liegt im Funktionsumfang. Laut offizieller Vergleichstabelle hat die CLI alle Befehle und Skills, die Erweiterung eine Teilmenge (mit / anzeigen); die !-Abkürzung für Bash und die Tab-Vervollständigung gibt es nur in der CLI. Die Erweiterung fügt claude nicht zum PATH hinzu, die CLI wird also separat installiert; zeigt die Erweiterung keinen Grund für einen Fehler, rät die offizielle Dokumentation, claude im Terminal zu starten und die ausführlicheren Meldungen anzusehen.
In fünf Schritten zum eigenen Gateway
① Erweiterung installieren: Öffnen Sie die Erweiterungsansicht (Cmd+Shift+X / Ctrl+Shift+X), suchen Sie nach Claude Code und klicken Sie auf Install, oder führen Sie im Terminal code --install-extension anthropic.claude-code aus; nötig ist VS Code 1.94.0 oder neuer. ② Führen Sie in der Befehlspalette Preferences: Open User Settings (JSON) aus und fügen Sie claudeCode.environmentVariables mit zwei Einträgen hinzu: name ANTHROPIC_BASE_URL mit value https://api.qcode.cc/api sowie name ANTHROPIC_AUTH_TOKEN mit Ihrem cr_-Schlüssel als value. ③ Erscheint trotzdem ein Anmeldebildschirm, suchen Sie in den Einstellungen nach Claude Code login und aktivieren Sie Disable Login Prompt (laut offizieller Dokumentation überspringt diese Einstellung Anmeldeaufforderungen bei externen Anbindungen). ④ Damit die CLI im Terminal dieselben Werte nutzt, tragen Sie sie in den env-Block von ~/.claude/settings.json ein (unter Windows %USERPROFILE%\.claude\settings.json); nicht in die .claude/settings.json des Projekts. ⑤ Führen Sie Developer: Reload Window aus, geben Sie im Panel /status ein, prüfen Sie Version, Konto, Modell und Serverdetails und senden Sie dann eine Testnachricht.
Auf QCode
Auf QCode stammen beide Werte aus der QCode-Dokumentation: ANTHROPIC_BASE_URL=https://api.qcode.cc/api (bis /api, ohne Schrägstrich am Ende) und ANTHROPIC_AUTH_TOKEN mit einem Schlüssel, der mit cr_ beginnt (im Dashboard erstellt); Claude Code sendet ihn als Bearer-Token. Claude-Modelle funktionieren nur über den Endpunkt mit Anthropic-Protokoll, und genau dieses Protokoll nutzt die VS Code-Erweiterung. Zu den Claude-Modellen, die Sie auf QCode aufrufen können, gehören claude-sonnet-5-5, claude-opus-5-5 und claude-sonnet-5; abgerechnet wird pro Token, die Preise je Modell stehen auf /models, und die Claude-Familie hat keine eigene Langkontext-Stufe. In Nordamerika und Europa können Sie us.qcode.cc (Los Angeles) nutzen, für Netze in Festlandchina empfiehlt die Dokumentation asia.qcode.cc; Pfad und Schlüssel bleiben gleich. Jede Anfrage lässt sich auf probe.qcode.cc mit Ihrem Schlüssel einsehen.
Häufig gestellte Fragen
Wo trage ich für Claude Code in VS Code den API-Key und die eigene Base URL ein?
In claudeCode.environmentVariables in den VS Code-Benutzereinstellungen. Führen Sie in der Befehlspalette Preferences: Open User Settings (JSON) aus und fügen Sie zwei Einträge hinzu, ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN; für QCode sind das https://api.qcode.cc/api und Ihr cr_-Schlüssel. Stand 2026-10-07 führt die offizielle Tabelle der Erweiterungseinstellungen keine eigene Einstellung für API-Key oder Base URL auf, und die offizielle Gateway-Dokumentation schreibt, dass die Erweiterung die Zugangsdaten aus dieser Einstellung vor dem Start prüft – damit ist sie der zuverlässige Ort für den Gateway-Schlüssel.
Ich habe die Variablen im Terminal exportiert, aber die Erweiterung findet den Schlüssel nicht. Warum?
Meist sind die Variablen nie bei VS Code angekommen. Laut offizieller Dokumentation gelten Shell-Exports nur für diese Terminalsitzung und von dort gestartete Programme; ein Editor, der über Dock oder Startmenü geöffnet wird, sieht sie nicht. Auch nur der env-Block in ~/.claude/settings.json reicht nicht: Diese Werte erreichen den gestarteten Prozess, aber nicht die eigene Anmeldeprüfung der Erweiterung. Tragen Sie beide Werte in claudeCode.environmentVariables ein, führen Sie Developer: Reload Window aus und prüfen Sie mit /status im Panel.
Warum werde ich nach der Einrichtung trotzdem zur Anmeldung aufgefordert?
Meist sieht die Anmeldeprüfung der Erweiterung keine Zugangsdaten. Prüfen Sie zuerst, ob der Schlüssel in claudeCode.environmentVariables steht und nicht nur ANTHROPIC_BASE_URL gesetzt ist: Laut offizieller Dokumentation ersetzt eine Base URL ohne Variable mit Zugangsdaten das Abo nicht, und die gespeicherte claude.ai-Anmeldung bleibt aktiv. Erscheint der Anmeldebildschirm weiterhin, suchen Sie in den Einstellungen nach Claude Code login und aktivieren Sie Disable Login Prompt; 2.1.261 behob, dass der Bildschirm trotz dieser Einstellung erschien, ältere Versionen also zuerst aktualisieren. Zeigt der Start eine Warnung, die zwei Quellen für Zugangsdaten nennt und mit auth may not work as expected endet, ist die offizielle Lösung /logout, damit nur der Gateway-Schlüssel bleibt.
Können die VS Code-Erweiterung und die CLI im Terminal eine Konfiguration teilen?
Ja, über ~/.claude/settings.json. Laut offizieller Dokumentation lesen Terminal, die Erweiterungen für VS Code und JetBrains und die Desktop-App dieselben Einstellungsdateien; tragen Sie ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN im env-Block ein, dann nutzt claude im Terminal dasselbe Gateway. Setzen ein Shell-Export und der env-Block einer Einstellungsdatei dieselbe Variable, gilt der Wert aus der Datei. Auch der Gesprächsverlauf ist gemeinsam: claude --resume im Terminal setzt ein Gespräch aus der Erweiterung fort. Beachten Sie, dass die Erweiterung claude nicht zum PATH hinzufügt; die CLI muss separat installiert werden.
Wie wähle ich das Modell, und was tun, wenn das gewünschte fehlt?
Klicken Sie auf die Modellanzeige unter dem Eingabefeld oder geben Sie /model ein; alternativ setzen Sie die Variable ANTHROPIC_MODEL oder das Feld model in einer Einstellungsdatei. Laut offizieller Dokumentation speichert /model Ihre Wahl als Standard für neue Sitzungen im Feld model der Benutzereinstellungen, daher lesen Erweiterung und CLI denselben Standard. Fehlen die Modellnamen Ihres Gateways in der eingebauten Liste von Claude Code, ist die offizielle Lösung CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, womit die Auswahl die Modellliste des Gateways übernimmt. Auf QCode können Sie claude-sonnet-5-5, claude-opus-5-5 oder claude-sonnet-5 angeben; die aktuelle Liste steht auf /models.
ANTHROPIC_AUTH_TOKEN oder ANTHROPIC_API_KEY – was nehme ich?
Für QCode ANTHROPIC_AUTH_TOKEN. Laut offizieller Dokumentation wird er im Header Authorization: Bearer gesendet, ANTHROPIC_API_KEY dagegen in x-api-key; steht der Schlüssel in der falschen Variable, kommt er in einem Header an, den das Gateway nicht liest, und die Anfrage scheitert mit 401 – dann die andere Variable probieren. Die QCode-Dokumentation legt den Schlüssel per Konvention in ANTHROPIC_AUTH_TOKEN ab, und Werkzeuge, die nur ANTHROPIC_API_KEY lesen, funktionieren mit demselben cr_-Schlüssel ebenfalls. Ein weiterer Unterschied: ANTHROPIC_API_KEY muss im interaktiven Modus einmal bestätigt werden, ANTHROPIC_AUTH_TOKEN hat sofort Vorrang vor einer gespeicherten Anmeldung.
Quellen
Konfigurationsorte und Verhalten der Erweiterung: die offizielle Claude Code-Dokumentation zu VS Code (code.claude.com: Voraussetzungen, Tabelle der Erweiterungseinstellungen, Schritte für externe Anbindungen, Vergleich mit der CLI und häufige Probleme) sowie die Seiten zur Verbindung mit einem LLM-Gateway, zur LLM-Gateway-Übersicht, zur Authentifizierung, zu Einstellungen, Umgebungsvariablen und Modellkonfiguration, alle abgerufen am 2026-10-07. Versionsänderungen: CHANGELOG und Veröffentlichungszeiten (UTC) der GitHub Releases des Repositorys anthropics/claude-code, am selben Tag abgerufen. QCode-Werte: die QCode-Dokumentation zu Umgebungsvariablen (aktualisiert 2026-09-25), zu Endpunkten und API-Formaten, zur VS Code-Integration (aktualisiert 2026-09-18) sowie die Seite /models, am selben Tag abgerufen.
VS Code mit QCode verbinden
Zwei Variablen, ein cr_-Schlüssel – gemeinsam für Erweiterung und CLI im Terminal. Bezahlt wird pro Token, Preise je Modell auf /models.
Weiterführende Lektüre
Einrichtung von ANTHROPIC_BASE_URL und AUTH_TOKEN
Claude Code auf einen eigenen Endpunkt ausrichten: die beiden Umgebungsvariablen und die Form in settings.json.
Claude Code Benutzerhandbuch
Komplettes Tutorial von der Installation bis zur täglichen Arbeit.
Claude Code in China: Vollständiger Leitfaden
Anbindung von Claude Code und der Codex-API für Entwickler in Festlandchina, Bezahlung per Alipay.
Die Schritte und Zitate auf dieser Seite wurden am 2026-10-07 anhand der offiziellen Claude Code-Dokumentation, des Changelogs und der QCode-Dokumentation geprüft; Änderungen beim Anbieter sind ohne Vorankündigung möglich. Oberfläche und Namen der Einstellungen ändern sich mit den Versionen, maßgeblich ist Ihre Version; die Modellverfügbarkeit richtet sich nach /models.