# VS Code-Integration

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

## Auf einen Blick

| Punkt | Details |
|---|---|
| Verfügbare Modelle | Claude ✅ (Erweiterung über Anthropic-Protokoll / Copilot über Messages) · GPT ✅ · Chinesische Modelle ✅ (Copilot Custom Endpoint) · Gemini ❌ |
| Protokoll & Base-URL | Claude Code-Erweiterung: Umgebungsvariablen mit `https://api.qcode.cc/api` · Copilot: vollständige URLs in `chatLanguageModels.json` |
| Konfigurationsort | `~/.claude/config.json` + Umgebungsvariablen; Copilot verwendet `chatLanguageModels.json` |
| Offizielle Dokumentation | [Claude Code-Erweiterung](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) · [Sprachmodelle](https://code.visualstudio.com/docs/agent-customization/language-models) |

> **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](/docs/ide/trae).

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**
   - Siehe [Installationsanleitung](/docs/getting-started/installation) zur Installation
   - Siehe [Umgebungskonfiguration](/docs/getting-started/environment) zur Einrichtung

2. **VS Code-Version >= 1.98.0**

## Installationsschritte

### Schritt 1: VS Code installieren

Falls VS Code nicht installiert ist, besuchen Sie die [VS Code-Website](https://code.visualstudio.com/), 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:

```bash
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.

<div data-os="windows" markdown="1">

#### Windows

Bearbeiten oder erstellen Sie die Konfigurationsdatei `C:\Users\YourUsername\.claude\config.json`:

```json
{
  "primaryApiKey": "qcode"
}
```

</div>

<div data-os="macos" markdown="1">

#### macOS

Bearbeiten oder erstellen Sie die Konfigurationsdatei `~/.claude/config.json`:

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

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

</div>

<div data-os="linux" markdown="1">

#### Linux

Bearbeiten oder erstellen Sie die Konfigurationsdatei `~/.claude/config.json`:

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

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

</div>

> **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

| Tastenkombination | Funktion |
|----------|----------|
| `Cmd+Esc` / `Ctrl+Esc` | Claude Code-Panel öffnen/schließen |
| `Cmd+Shift+P` / `Ctrl+Shift+P` | Befehlspalette öffnen, nach Claude-Befehlen suchen |

### Häufige Funktionen

1. **Code-Erklärung**
   - Code markieren
   - Rechtsklick und „Ask Claude“ wählen oder die Tastenkombination verwenden
   - Ihre Frage eingeben, z. B. „Erkläre diesen Code“

2. **Code-Generierung**
   - Claude-Panel öffnen
   - Die gewünschte Funktion beschreiben
   - Claude generiert den Code und bietet Optionen zum Einfügen an

3. **Code-Refactoring**
   - Den zu refaktorierenden Code markieren
   - Claude um Hilfe beim Refactoring bitten
   - Änderungen in der Vorschau ansehen und anwenden

4. **Fehlerbehebung**
   - Wenn der Code Fehler enthält
   - Den fehlerhaften Code oder die Fehlermeldung markieren
   - 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

```json
{
  "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:

| Szenario | Empfohlenes Tool |
|----------|-----------------|
| Schnelle Code-Änderungen | VS-Code-Erweiterung |
| Komplexe Projektanalyse | Terminal-CLI |
| Code-Review | Beides möglich |
| Git-Operationen | Terminal-CLI |
| Dateigenerierung | Beides möglich |

## 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:

```json
[
  { "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](/docs/ide/github-copilot).

## 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:
   - Windows: `C:\Users\YourUsername\.claude\config.json`
   - macOS/Linux: `~/.claude/config.json`

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

3. 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](/docs/usage/cli-tips), um effizienter zu arbeiten

- Lernen Sie die [Workflow-Tipps](/docs/usage/workflow-tips) kennen, um Ihren Entwicklungsablauf zu optimieren