Claude Code in VS Code: verbinden und Integration prüfen
CLI, VS-Code-Erweiterung und API-Endpunkt getrennt konfigurieren und die Integration nachvollziehbar testen.
Inhalt
Unter Windows liegt die CLI-Konfiguration unter %USERPROFILE%\.claude\settings.json.
Du möchtest Claude Code in VS Code mit einem eigenen API-Key einrichten? Über BetterToken brauchen Nutzer in Russland für den BetterToken-API-Endpunkt weder dauerhaft ein VPN noch eine ausländische Karte. Übernimm die aktuellen Base-URL- und Key-Felder aus der Dokumentation in die VS-Code-Benutzereinstellungen; die Erweiterung sendet Anfragen dann an den gewählten API-Endpunkt.
Die drei Ebenen der Integration
Die Integration hat drei unabhängige Ebenen. Wenn Claude Code „nicht antwortet“, kann jede davon die Ursache sein.
CLI. Die offizielle Erweiterung enthält eine private CLI-Kopie für ihr Chatfenster. Sie legt claude nicht in den Shell-PATH; für das integrierte Terminal brauchst du die eigenständige Installation aus der aktuellen Anthropic-Anleitung.
VS-Code-Erweiterung. Die offizielle Erweiterung von Anthropic bietet Chat, Side-by-side-Diffs, @-Dateiverweise und Sitzungsverlauf. Die aktuelle Anthropic-Anleitung erfordert VS Code 1.94.0 oder neuer.
API-Endpunkt. Standardmäßig nutzt Claude Code die Anthropic API. Für BetterToken setzt du ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN; die Erweiterung übergibt beide Werte an Claude Code.
Ein erfolgreicher Dashboard-Eintrag bestätigt nur, dass BetterToken die Anfrage angenommen hat. Den IDE-Teil prüfst du zusätzlich über Dateikontext und Diff.
Verwende dein eigenes BetterToken-Konto, erstelle im Dashboard einen API-Key und nimm die Base URL aus der Dokumentation.
Eigenen API-Key erstellen und Claude Code nach der BetterToken-Dokumentation einrichten: docs.bettertoken.ai/ai-tools/claude-code
API-Key erstellen und Endpunkt verbinden
Möchten Sie Claude Code mit Ihrem eigenen API-Schlüssel testen? BetterToken-Konto erstellen
Schritt 1. Konto und API-Key erstellen
Öffne bettertoken.ai, registriere dich, gehe zur Schlüsselverwaltung und erstelle einen neuen API-Key. Kopiere ihn für den nächsten Schritt.
Schritt 2. Base URL übernehmen
Für Claude Code verwendest du diese Anthropic-kompatible Base URL:
https://bettertoken.ai
Füge kein /v1 hinzu: Claude Code ergänzt den Methodenpfad selbst. Die Adresse mit /v1 ist für OpenAI-kompatible Werkzeuge wie Codex CLI bestimmt.
Schritt 3. Umgebungsvariablen der Erweiterung setzen
Öffne die VS-Code-Benutzerdatei settings.json und ergänze ein separates Array claudeCode.environmentVariables:
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://bettertoken.ai" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "your_api_key_here" },
{ "name": "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "value": "1" },
{ "name": "API_TIMEOUT_MS", "value": "3000000" }
]
}
Ersetze your_api_key_here durch den Key aus Schritt 1, lass andere Felder unverändert und führe Developer: Reload Window aus. Für claude im integrierten Terminal installierst du zuerst die eigenständige CLI; unter macOS, Linux und WSL lautet der aktuelle Anthropic-Befehl curl -fsSL https://claude.ai/install.sh | bash. Windows und Alternativen stehen in der offiziellen Anleitung. Die CLI-Felder gehören laut BetterToken-Anleitung separat in ~/.claude/settings.json.
Schritt 4. Anmeldeaufforderung deaktivieren
Öffne die VS-Code-Einstellungen (Cmd+, auf dem Mac, Ctrl+, unter Windows/Linux), wähle Extensions → Claude Code und aktiviere Disable Login Prompt. Das entfernt bei einem Drittanbieter den Anthropic-Anmeldedialog, ersetzt aber nicht claudeCode.environmentVariables.
Claude Code in VS Code starten
Schritt 5. Erweiterung installieren
Drücke Cmd+Shift+X auf dem Mac oder Ctrl+Shift+X unter Windows/Linux, suche „Claude Code“ von Anthropic und wähle Install. Fehlt das Symbol danach, führe in der Befehlspalette Developer: Reload Window aus. Aktualisiere VS Code und prüfe die aktuelle Versionsanforderung im Marketplace.
Schritt 6. Datei und Panel öffnen
Öffne eine Datei. Das Spark-Symbol (✱) erscheint in der Editor Toolbar nur bei geöffneter Datei und öffnet das Chat-Panel. Alternativ nutze:
- Activity Bar — Spark-Symbol in der linken Leiste;
- Command Palette (
Cmd+Shift+P/Ctrl+Shift+P) → „Claude Code: Open in New Tab“; - Status Bar → ✱ Claude Code rechts unten, auch ohne geöffnete Datei.
Schritt 7. Dateikontext prüfen
Markiere mehrere Codezeilen. Claude Code zeigt unter dem Eingabefeld die Zahl der ausgewählten Zeilen. Mit Option+K auf dem Mac beziehungsweise Alt+K unter Windows/Linux fügst du einen @-Verweis wie @file.ts#5-10 ein.
Kontext, Diff und Dashboard überprüfen
Schritt 8. Risikoarme Testanfrage senden
Öffne ein kleines Skript oder eine Konfiguration und bitte um eine einfache, rückgängig zu machende Änderung:
Füge vor der ersten Funktion einen einzeiligen Kommentar ein, der kurz erklärt, was sie tut.
Oder:
Benenne die Variable `tmp` in dieser Datei in `result` um.
Ziel ist eine konkrete Änderung, die du visuell kontrollieren kannst.
Schritt 9. Side-by-side-Diff prüfen
Bei einer Änderung zeigt die Erweiterung einen Vorher-nachher-Vergleich und fragt nach einer Freigabe. Prüfe ihn und wähle Accept oder Reject. Ein sinnvoller Diff zeigt, dass die Erweiterung die Modellantwort erhalten und auf die aktuelle Datei bezogen hat; die BetterToken-Route prüfst du getrennt im Dashboard.
Schritt 10. Anfrage im BetterToken-Dashboard suchen
Öffne bettertoken.ai und gehe zum Dashboard oder zur Anfragehistorie. Suche den Eintrag zum Zeitpunkt der Testanfrage und vergleiche Modell, Status, Input-, Output- und Cache-Token sowie die Belastung.
Erscheinen ein passender Diff in VS Code und ein erfolgreicher Eintrag zur gleichen Zeit, funktionieren alle Ebenen: Die Erweiterung hat Kontext übergeben, BetterToken hat die Anfrage verarbeitet und die Antwort ist in die IDE zurückgekehrt.
Wenn kein Ergebnis erscheint:
- keine Antwort und kein Dashboard-Eintrag — Erweiterungsstart,
env, Base URL und Netzwerk prüfen; - Dashboard-Anfrage mit Fehlerstatus — Key, Modell und Fehlertext prüfen;
- Antwort oder Diff, aber kein passender Eintrag — Endpunkt, Zeit und Dashboard-Filter erneut prüfen; die BetterToken-Route ist noch nicht bestätigt.
Wenn die Integration nicht erkannt wird
Spark-Symbol fehlt
Das Symbol in der Editor Toolbar ist nur bei geöffneter Datei sichtbar. Ist eine Datei geöffnet und es fehlt dennoch:
- Aktualisiere VS Code und prüfe die aktuelle Anforderung unter Help → About und im Marketplace.
- Führe Developer: Reload Window über die Command Palette aus.
- Deaktiviere testweise Cline, Continue oder GitHub Copilot; andere KI-Erweiterungen können mit Toolbar-Symbolen kollidieren.
Als Alternative funktioniert ✱ Claude Code in der Status Bar auch ohne geöffnete Datei.
VS Code übernimmt Terminal-Variablen nicht
Ist ANTHROPIC_BASE_URL in der Shell gesetzt, doch die Erweiterung fragt nach einer Anmeldung, hat ein über Spotlight oder das App-Menü gestartetes VS Code die Shell-Umgebung nicht geerbt. Starte es im Terminal:
code .
Dadurch übernimmt VS Code die aktuelle Umgebung. Falls das unpraktisch ist, trage die Variablen zusätzlich unter Extensions → Claude Code → environmentVariables ein.
Erweiterung fragt erneut nach Anmeldung
Stelle sicher, dass Disable Login Prompt unter Extensions → Claude Code aktiviert ist. Die Einstellung unterdrückt den Anthropic-Dialog, die Verbindungsvariablen müssen trotzdem gesetzt sein.
Geänderte Konfiguration wird nicht gelesen
Prüfe die VS-Code-Benutzerdatei settings.json: Ein zusätzliches Komma oder eine fehlende Klammer verhindert das Laden von claudeCode.environmentVariables. Führe dann Developer: Reload Window aus. Kontrolliere auch Shell und CLI-Konfiguration auf eine alte Base URL oder einen alten Key. Feldnamen gehören aus der aktuellen BetterToken-Dokumentation, nicht aus einem alten Blog-Auszug.
Authentifizierungsfehler: 401 oder keine Antwort
Prüfe der Reihe nach:
- Base URL —
https://bettertoken.aiohne/v1; mit/v1verwendet Claude Code die falsche Protokollroute. - API-Key — keine Leerzeichen, Zeilenumbrüche oder zusätzlichen Anführungszeichen.
- Variablenkonflikt — ein anders gesetztes
ANTHROPIC_AUTH_TOKENoderANTHROPIC_BASE_URLkann die Konfiguration überschreiben. Entferne den Konflikt aus dem Shell-Profil oder starte mitcode ..
Kein Dashboard-Eintrag bedeutet zuerst Versand, Endpunkt und Netzwerk prüfen; ein 401-Eintrag weist auf den Key oder dessen Format hin.
Vollständige Claude-Code-Anleitung für BetterToken: docs.bettertoken.ai/ai-tools/claude-code