# Trae-Integration

> **Zuletzt überprüft**: 2026-09-18 · 📄 Laut offizieller Dokumentation (Trae 3.3.101 (veröffentlicht am 2026-09-15))

## Auf einen Blick

| Punkt | Details |
|---|---|
| Verfügbare Modelle | Claude ✅ (Claude Code-Erweiterung; die integrierte KI akzeptiert auch benutzerdefinierte Modelle im Anthropic-Messages-Format) · GPT ✅ · Chinesische Modelle ✅ (integrierte KI, OpenAI-Format) · Gemini ❌ |
| Protokoll & Base-URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| Konfiguration | Integrierte KI: Einstellungen → benutzerdefinierte Modelle; die Claude Code-Erweiterung nutzt `~/.claude/` |
| Offizielle Dokumentation | [docs.trae.ai](https://docs.trae.ai) |

Trae ist eine KI-native IDE von ByteDance, abgeleitet von VS Code. Sie nimmt Erweiterungen entgegen und bringt ihre eigenen **Agent**- und **Chat**-Modi mit — ab v3.3.56 (2026-05-08) wurden die früheren Builder- und Builder-with-MCP-Agenten in **Agent** **zusammengeführt**, und die offizielle Dokumentation erwähnt Builder nicht mehr. Dieses Handbuch behandelt zwei Themen: die Installation und Nutzung der Claude Code-Erweiterung in Trae (international) oder Trae CN (China), sowie das Hinzufügen von QCode.cc als **benutzerdefiniertes Modell der integrierten KI**.

> **Hinweis zur Benennung**: Die offizielle Dokumentationsseite (Chinesisch und Englisch) bezeichnet diese IDE derzeit als **TraeCode**, während die chinesische Marketingseite **TraeWork** (Work-/Code-/Design-Modi) hervorhebt. Es gibt keine offizielle Umbenennungsbekanntmachung — das Changelog verwendet ab v3.3.84 (2026-08-07) in den Veröffentlichungstiteln einfach TraeCode. Diese Seite behält ihren Dateinamen und ihre URL bei.

## Voraussetzungen

Stellen Sie vor der Konfiguration der Trae-Erweiterung 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. **Trae oder Trae CN ist installiert und aktuell**
   - Internationale Edition: [trae.ai](https://www.trae.ai/)
   - China-Edition (Trae CN): [trae.com.cn](https://www.trae.com.cn/)

> **Trae CN oder die internationale Edition?** Die offizielle Dokumentation beschreibt keinen regionalen Unterschied. Sie enthält lediglich: „Wenn die von Ihnen benötigte Erweiterung im TraeCode-Erweiterungsmarktplatz nicht verfügbar ist, können Sie eine Erweiterung aus dem VS Code-Erweiterungsmarktplatz in TraeCode installieren.“ Jeder Schritt unten, der mit „nicht im Marktplatz gefunden“ beginnt, ist daher bedingt: Nutzen Sie den Marktplatz, wenn die Erweiterung dort vorhanden ist, andernfalls verwenden Sie eine `.vsix`.

## Installationsschritte

### Schritt 1: Claude Code-Erweiterung installieren

Die Claude Code-Erweiterung kann auf zwei Wegen installiert werden — versuchen Sie diese der Reihe nach. Beachten Sie auch den offiziellen Hinweis: Eine Erweiterungsversion, die von neueren VS Code-APIs abhängt, funktioniert möglicherweise nicht in TraeCode. In diesem Fall verweist die Dokumentation auf eine ältere Version im Versionsverlauf.

#### Weg A: Installation aus dem integrierten Trae-Erweiterungsmarktplatz (empfohlen)

1. Öffnen Sie Trae und navigieren Sie zum Erweiterungspanel (`Ctrl+Shift+X` / `Cmd+Shift+X`)

2. Suchen Sie nach **„Claude Code“** (Herausgeber: Anthropic)

3. Klicken Sie auf **Installieren**

Wenn der Trae-Marktplatz Claude Code nicht anzeigt, verwenden Sie Weg B. (Der Anbieter dokumentiert nicht, welche Builds die Erweiterung nicht enthalten, daher behaupten wir nichts.)

#### Weg B: Offline-Installation über .vsix

Nutzen Sie diesen Weg, wenn der Marktplatz die Erweiterung nicht anbietet:

1. Öffnen Sie die [Claude Code-Erweiterungsseite](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code)

2. Laden Sie die `.vsix` herunter, die zu Ihrer **Plattform und Architektur** passt. Die Methode aus Traes eigener Dokumentation: Öffnen Sie auf der Erweiterungsseite den **Versionsverlauf**, entnehmen Sie die Felder `itemName` und `version` und erstellen Sie die Download-URL:

   ```text
   https://marketplace.visualstudio.com/_apis/public/gallery/publishers/<publisher>/vsextensions/<extension>/<version>/vspackage
   ```

   Für Claude Code ergibt sich daraus `publishers/anthropic/vsextensions/claude-code/<version>/vspackage`.
   🔴 **Die richtige Architektur wählen**: Claude Code wird plattformbezogen veröffentlicht (Dateinamen tragen Suffixe wie `@win32-x64` oder `@alpine-arm64`), und die Trae-Dokumentation warnt ausdrücklich, dass architekturspezifische Erweiterungen für die genutzte Plattform heruntergeladen werden müssen. Der falsche Build wird installiert, funktioniert aber nicht. macOS unterscheidet Apple Silicon / Intel; Linux und Windows unterscheiden x64 / arm64.

   Oder klicken Sie auf **Erweiterung herunterladen** in der rechten Seitenleiste der Erweiterungsseite, sofern dieser Link auf Ihrer Seite angezeigt wird.

   > **Tipp**: Der Zugriff auf den VS Code Marketplace aus dem chinesischen Festland erfordert möglicherweise einen Proxy. Falls der Download lokal fehlschlägt, laden Sie die `.vsix` auf einem Rechner mit zuverlässiger internationaler Verbindung herunter und kopieren Sie die Datei.

3. Öffnen Sie in Trae das Erweiterungspanel → klicken Sie auf das **⋯**-Menü oben rechts → **Aus VSIX installieren**, und wählen Sie die heruntergeladene `.vsix`-Datei aus

   Die Dokumentation bietet eine weitere Möglichkeit: **Ziehen Sie die heruntergeladene `.vsix` in das Erweiterungspanel**, und Trae beginnt automatisch mit der Installation.
   Einige Umgebungen verfügen über einen `trae`-Starterbefehl, aber Traes Dokumentation verzeichnet keinen Parameter zur Installation von Erweiterungen damit, und wir haben es nicht getestet — daher geben wir hier keinen Befehl an.

### Schritt 2: primaryApiKey konfigurieren

Dies ist ein entscheidender Schritt! Die Claude Code-Erweiterung erfordert `primaryApiKey` in der Konfigurationsdatei.

> **Gute Nachricht**: Trae nutzt denselben Konfigurationspfad wie VS Code (`~/.claude/config.json`). Benutzer, die VS Code bereits konfiguriert haben, müssen diesen Schritt nicht wiederholen.

<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
mkdir -p ~/.claude

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
mkdir -p ~/.claude

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

</div>

> **Hinweis**: Der Wert von `primaryApiKey` kann beliebig sein (z. B. `qcode`); entscheidend ist, dass das Feld gesetzt ist. Die tatsächliche API-Authentifizierung erfolgt weiterhin über das `ANTHROPIC_AUTH_TOKEN` aus Ihren Umgebungsvariablen.

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

### Schritt 3: Trae neu starten

Starten Sie Trae nach der Konfiguration neu, damit die Änderungen wirksam werden.

## Verhältnis zur integrierten KI von Trae

Die integrierte KI von Trae (**Agent** und **Chat**) ist nicht mehr auf das Backend von ByteDance beschränkt. Laut offiziellen Dokumentationen können Sie neben den integrierten Modellen auch eigene hinzufügen. Der Typ **Custom configuration** verlangt ein **API format**, eine **request URL**, eine **model ID** und Zugangsdaten – eines der API-Formate ist **Anthropic Messages**, das wörtlich als kompatibel mit der Anthropic-Spezifikation `/v1/messages` beschrieben wird, geeignet für die Claude-Serie und kompatible Dienste, wobei „einige Claude-API-Proxy-Dienste“ als typischer Anwendungsfall genannt werden.

| | Custom Model in der integrierten KI | Claude Code Extension |
|---|---|---|
| Protokoll | API format: Anthropic Messages oder OpenAI Chat Completions | Anthropic Messages |
| Wo | Einstellungen → **Models** → **Add model** → **Custom model** | Extension-Einstellungen sowie die Konfiguration unter `~/.claude/` |
| URL | Zwei Modi: **Full URL** aktivieren und die vollständige Adresse angeben, oder deaktiviert lassen und eine Basis-URL angeben, die Trae je nach API format vervollständigt | `ANTHROPIC_BASE_URL` |
| Achtung | **Der Auto-Modus ruft niemals Custom Models auf** (so in der Dokumentation angegeben), verlassen Sie also den Auto-Modus, um Ihre eigenen Modelle zu verwenden | unabhängig von der integrierten KI; beide koexistieren |

Zugeordnet auf QCode-Endpunkte (**nur als Referenz — wir haben dies nicht in Trae ausgeführt**):

| API format | Full URL an | Full URL aus (Basis-URL) |
|---|---|---|
| Anthropic Messages | `https://api.qcode.cc/api/v1/messages` | `https://api.qcode.cc/api` |
| OpenAI Chat Completions | `https://api.qcode.cc/openai/v1/chat/completions` | `https://api.qcode.cc/openai/v1` |

Verwenden Sie eine **model ID** genau wie auf [qcode.cc/models](https://qcode.cc/models) aufgeführt, und Ihren `cr_`-Schlüssel als **API-Key**.

Wenn Sie bereits ein QCode.cc-Abo erworben haben, empfehlen wir die Claude Code Extension als primären Treiber zu nutzen, um den größten Mehrwert aus Ihrem Tarif zu ziehen.

## Nutzung

### Tastaturkürzel

| Kürzel | 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 auswählen
   - Rechtsklick und „Ask Claude“ wählen oder Tastaturkürzel verwenden
   - Ihre Frage eingeben, z. B. „Explain this code“

2. **Code-Generierung**
   - Claude-Panel öffnen
   - Die benötigte Funktion beschreiben
   - Claude generiert Code mit Einfügeoptionen

3. **Code-Refactoring**
   - Zu refactoringenden Code auswählen
   - Claude um Refactoring-Hilfe bitten
   - Änderungen prüfen und anwenden

4. **Fehlerbehebung**
   - Wenn der Code Fehler aufweist
   - Den fehlerhaften Code oder die Meldung auswählen
   - Claude um Analyse und Lösungsvorschläge bitten

## Konfigurationsoptionen

In den Trae-Einstellungen können Sie das Verhalten der Claude Code Extension anpassen (diese Einstellungen sind identisch mit VS Code):

1. Einstellungen öffnen (`Ctrl+,` / `Cmd+,`)

2. Nach „Claude Code“ suchen

3. Optionen nach Bedarf anpassen

### Häufige Einstellungen

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

## Verwendung mit Terminal-CLI

Die Trae Extension und die Terminal-CLI können zusammen verwendet werden:

| Szenario | Empfohlenes Werkzeug |
|----------|-----------------|
| Schnelle Code-Bearbeitung | Trae Extension |
| Komplexe Projektanalyse | Terminal-CLI |
| Code-Review | Beides |
| Git-Operationen | Terminal-CLI |
| Datei-Generierung | Beides |

## Fehlerbehebung

### Claude Code nicht im Marketplace gefunden

**Symptome**: Die Suche nach „Claude Code“ im Trae-Erweiterungspanel liefert keine Ergebnisse, oder die Ergebnisse sind nicht die offiziell von Anthropic veröffentlichte Extension.

**Lösung**: Verwenden Sie **Pfad B: Offline .vsix Lokale Installation** (siehe Schritt 1 oben). Die Position des Anbieters ist lediglich, dass im TraeCode-Marketplace fehlende Erweiterungen aus dem VS Code Marketplace installiert werden können; es wird nicht nach China-/International-Build unterschieden.

### Trae CN kann die .vsix nicht herunterladen

**Symptome**: Der Zugriff auf `marketplace.visualstudio.com` schlägt fehl oder der Download läuft mit 0 B/s.

**Lösung**:

1. Die `.vsix` über eine zuverlässige internationale Verbindung oder über einen Proxy herunterladen

2. Oder den QCode.cc-Support kontaktieren und einen Mirror-Link für die Claude Code Extension `.vsix` anfordern

3. Über „Install from VSIX“ installieren, sobald die Datei lokal verfügbar ist

### Claude Code Panel leer oder startet nicht

1. Sicherstellen, dass `~/.claude/config.json` existiert und gültiges JSON enthält

2. Sicherstellen, dass der Dateiname `config.json` lautet, NICHT `settings.json` (die häufigste Fehlerquelle)

3. Sicherstellen, dass die Umgebungsvariablen `ANTHROPIC_BASE_URL` und `ANTHROPIC_AUTH_TOKEN` gesetzt sind

4. `claude` im Terminal ausführen, um zu überprüfen, dass die CLI funktioniert

### Tastaturkürzel-Konflikt mit der integrierten KI von Trae

Wenn `Cmd+Esc` / `Ctrl+Esc` vom Agent oder Chat von Trae belegt wird:

1. Trae-Einstellungen → Tastaturkürzel öffnen

2. Nach `claude-code` oder `Claude Code` suchen

3. „Claude Code: Toggle Panel“ auf eine nicht belegte Taste umbelegen

### Verbindungstimeout

1. Prüfen, ob `https://asia.qcode.cc` von Ihrem Netzwerk aus erreichbar ist

2. Die Umgebungsvariable `ANTHROPIC_BASE_URL` überprüfen

3. CN-Nutzer ohne Proxy sollten die schnelle Inlandsroute `https://api.qcode.cc/api` bevorzugen (Unterstützung der Anfrageprüfung über [probe.qcode.cc](https://probe.qcode.cc))

## Nächste Schritte

- Entdecken Sie [CLI-Tipps](/docs/usage/cli-tips) zur Effizienzsteigerung

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

- Siehe [VS Code Integration](/docs/ide/vscode), falls Sie auch VS Code verwenden