Trae-Integration

Die Claude Code-Erweiterung in Trae IDE von ByteDance verwenden (einschließlich Offline-Installationsanleitung für Trae CN)

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

Auf einen Blick¶

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

2. Siehe Installationsanleitung zur Installation

3. Siehe Umgebungskonfiguration zur Einrichtung

4. Trae oder Trae CN ist installiert und aktuell

5. Internationale Edition: trae.ai

6. China-Edition (Trae CN): 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

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.

1. Ö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.

{
  "primaryApiKey": "qcode"
}

mkdir -p ~/.claude

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

mkdir -p ~/.claude

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

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.

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

Verwenden Sie eine model ID genau wie auf 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¶

Häufige Funktionen¶

1. Code-Erklärung

2. Code auswählen

3. Rechtsklick und „Ask Claude“ wählen oder Tastaturkürzel verwenden

4. Ihre Frage eingeben, z. B. „Explain this code“

5. Code-Generierung

6. Claude-Panel öffnen

7. Die benötigte Funktion beschreiben

8. Claude generiert Code mit Einfügeoptionen

9. Code-Refactoring

10. Zu refactoringenden Code auswählen

11. Claude um Refactoring-Hilfe bitten

12. Änderungen prüfen und anwenden

13. Fehlerbehebung

14. Wenn der Code Fehler aufweist

15. Den fehlerhaften Code oder die Meldung auswählen
16. 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¶

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

Verwendung mit Terminal-CLI¶

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

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)

Nächste Schritte¶

• Entdecken Sie CLI-Tipps zur Effizienzsteigerung

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

• Siehe VS Code Integration, falls Sie auch VS Code verwenden