VS Code-Integration

Verwenden Sie die Claude Code-Erweiterung und GitHub Copilot Custom Endpoints in VS Code: Installation der Erweiterung, die primaryApiKey-Konfiguration und das Verbinden von QCode über chatLanguageModels.json

Zuletzt überprüft: 2026-09-18 · 📄 Laut offizieller Dokumentation (VS Code 1.138.0, veröffentlicht am 2026-09-16)

Auf einen Blick¶

Sie nutzen Trae IDE? Trae ist ein VS Code-Fork, daher lassen sich die meisten Schritte hier direkt übernehmen. Trae-spezifische Details — Marktplatz-Unterschiede, Offline-Installation über .vsix, Zusammenspiel mit Traes integrierter KI — finden Sie im Trae-Integrationsleitfaden.

Zusätzlich zur Verwendung von Claude Code CLI im Terminal können Sie die VS Code-Erweiterung nutzen, um direkt im Editor auf Claude Code zuzugreifen und so eine bequemere Entwicklungsumgebung zu erhalten.

Voraussetzungen¶

Bevor Sie die VS Code-Erweiterung konfigurieren, stellen Sie sicher:

1. Claude Code CLI ist installiert und funktioniert

2. Siehe Installationsanleitung zur Installation

3. Siehe Umgebungskonfiguration zur Einrichtung

4. VS Code-Version >= 1.98.0

Installationsschritte¶

Schritt 1: VS Code installieren¶

Falls VS Code nicht installiert ist, besuchen Sie die VS Code-Website, um VS Code herunterzuladen und zu installieren.

Schritt 2: Claude Code-Erweiterung installieren¶

In VS Code:

1. Öffnen Sie das Erweiterungen-Panel (Ctrl+Shift+X / Cmd+Shift+X)

2. Suchen Sie nach „Claude Code for VS Code“

3. Klicken Sie auf Installieren

Alternativ können Sie die Erweiterung über die Kommandozeile installieren:

code --install-extension anthropic.claude-code

Schritt 3: primaryApiKey konfigurieren¶

Dies ist ein entscheidender Schritt! Die Claude Code-Erweiterung benötigt primaryApiKey in der Konfigurationsdatei.

{
  "primaryApiKey": "qcode"
}

# Create directory (if it doesn't exist)
mkdir -p ~/.claude

# Create config file
cat > ~/.claude/config.json << 'EOF'
{
  "primaryApiKey": "qcode"
}
EOF

# Create directory (if it doesn't exist)
mkdir -p ~/.claude

# Create config file
cat > ~/.claude/config.json << 'EOF'
{
  "primaryApiKey": "qcode"
}
EOF

Hinweis: Der Wert von primaryApiKey kann beliebig sein (z. B. qcode). Sie müssen lediglich dieses Feld konfigurieren. Die tatsächliche API-Authentifizierung erfolgt weiterhin über das ANTHROPIC_AUTH_TOKEN, das Sie in den Umgebungsvariablen festgelegt haben.

Wichtig: Die Konfigurationsdatei heißt config.json, NICHT settings.json. Bitte unterscheiden Sie sorgfältig zwischen diesen beiden Dateien.

Schritt 4: VS Code neu starten¶

Nach der Konfiguration starten Sie VS Code neu, damit die Änderungen wirksam werden.

Verwendung¶

Tastenkombinationen¶

Häufige Funktionen¶

1. Code-Erklärung

2. Code markieren

3. Rechtsklick und „Ask Claude“ wählen oder die Tastenkombination verwenden

4. Ihre Frage eingeben, z. B. „Erkläre diesen Code“

5. Code-Generierung

6. Claude-Panel öffnen

7. Die gewünschte Funktion beschreiben

8. Claude generiert den Code und bietet Optionen zum Einfügen an

9. Code-Refactoring

10. Den zu refaktorierenden Code markieren

11. Claude um Hilfe beim Refactoring bitten

12. Änderungen in der Vorschau ansehen und anwenden

13. Fehlerbehebung

14. Wenn der Code Fehler enthält

15. Den fehlerhaften Code oder die Fehlermeldung markieren
16. Claude bitten, den Fehler zu analysieren und Korrekturen vorzuschlagen

Konfigurationsoptionen¶

In den VS-Code-Einstellungen können Sie das Verhalten der Claude-Code-Erweiterung konfigurieren:

1. Öffnen Sie die Einstellungen (Ctrl+, / Cmd+,)

2. Suchen Sie nach „Claude Code“

3. Passen Sie die Optionen nach Bedarf an

Häufige Einstellungen¶

{
  "claude-code.autoSuggest": true,
  "claude-code.inlineChat": true
}

Nutzung mit dem Terminal-CLI¶

Die VS-Code-Erweiterung und das Terminal-CLI lassen sich gemeinsam verwenden:

Benutzerdefinierte GitHub-Copilot-Endpunkte¶

Seit VS Code 1.122 können Sie mit dem integrierten Copilot Custom Endpoint die Protokollzugänge von QCode direkt in Copilot einbinden (Claude nur über messages, url erwartet den vollständigen Pfad). Minimale Konfiguration:

[
  { "name": "QCode Claude", "vendor": "customendpoint", "apiKey": "cr_your-QCode-key",
    "apiType": "messages",
    "url": "https://api.qcode.cc/api/v1/messages",
    "toolCalling": true,
    "models": [ { "id": "claude-sonnet-5" } ] }
]

Die vollständige Einrichtung aller drei Zugänge, Copilot CLI BYOK und bekannte Einschränkungen (Inline-Vervollständigungen laufen weiterhin über GitHub) finden Sie auf der eigenen Seite: GitHub-Copilot-Integration.

Fehlerbehebung¶

Erweiterung startet nicht¶

1. Vergewissern Sie sich, dass das Claude Code CLI korrekt installiert ist

2. Prüfen Sie die Konfiguration der Umgebungsvariablen

3. Stellen Sie sicher, dass das Format der Datei config.json korrekt ist

Fehler bei primaryApiKey¶

1. Vergewissern Sie sich, dass der Dateipfad korrekt ist:

2. Windows: C:\Users\YourUsername\.claude\config.json

3. macOS/Linux: ~/.claude/config.json

4. Vergewissern Sie sich, dass es sich um config.json und nicht um settings.json handelt

5. Vergewissern Sie sich, dass das JSON-Format gültig ist

Verbindungs-Timeout¶

1. Prüfen Sie Ihre Netzwerkverbindung

2. Überprüfen Sie die Umgebungsvariable ANTHROPIC_BASE_URL

3. Führen Sie claude im Terminal aus, um zu prüfen, ob das CLI funktioniert

Nächste Schritte¶

• Entdecken Sie die CLI-Tipps, um effizienter zu arbeiten

• Lernen Sie die Workflow-Tipps kennen, um Ihren Entwicklungsablauf zu optimieren