# Roo Code Einrichtung

> **⚠️ Projekt archiviert**: das GitHub-Repository [RooCodeInc/Roo-Code](https://github.com/RooCodeInc/Roo-Code) ist seit dem **2026-05-15 archiviert (nur lesbar)** – keine weiteren Updates oder Fixes mehr. Die nachfolgende Konfiguration funktioniert weiterhin für bestehende Installationen und dient als Referenz; für eine aktiv gepflegte Alternative erwägen Sie den Wechsel zu [Kilo Code](/docs/ide/kilo-code) oder [Cline](/docs/ide/cline).

> **Letzte Verifizierung**: 2026-09-18 · 📄 Gemäß offizieller Doku (Archivstatus über die GitHub-API geprüft; Roo Code veröffentlicht keine Releases mehr)

## Auf einen Blick

| Punkt | Details |
|---|---|
| Nutzbare Modelle | Claude ✅ (Anthropic-Anbieter + benutzerdefinierte Base-URL) · GPT ✅ · Chinesische Modelle ✅ (OpenAI Compatible) · Gemini ❌ |
| Protokoll & Base URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| Konfigurationsort | Einstellungsfeld der VS Code Extension (API Provider / Base-URL-Checkbox) |
| Offizielle Doku | [Roo Code Repository](https://github.com/RooCodeInc/Roo-Code) |

[Roo Code](https://github.com/RooCodeInc/Roo-Code) ist eine Open-Source-KI-Coding-Erweiterung für VS Code, geforkt von [Cline](/docs/ide/cline); [Kilo Code](/docs/ide/kilo-code) wiederum wurde von Roo Code geforkt – alle drei teilen nahezu identische Einstellungsdialoge, sodass diese Seite auf alle drei übertragbar ist.

## Welches Protokoll

| Gewünschtes Modell | API Provider | Base URL |
|---|---|---|
| Claude | `Anthropic` | `https://api.qcode.cc/api` |
| GPT / die vier chinesischen Modellfamilien | `OpenAI Compatible` | `https://api.qcode.cc/openai/v1` |

🔴 **Verwenden Sie nicht OpenAI Compatible für Claude** – der QCode-OpenAI-Endpunkt lehnt Claude-Modelle mit `model_not_available_on_endpoint` ab. Siehe [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths).

## Installation

Suchen Sie im VS Code Marketplace nach **Roo Code**, oder folgen Sie den Anweisungen im [Projekt-Repository](https://github.com/RooCodeInc/Roo-Code).

## Claude konfigurieren (Anthropic-Anbieter)

1. Öffnen Sie **Settings** (Zahnrad-Symbol) in der Roo-Code-Seitenleiste
2. Stellen Sie **API Provider** auf **Anthropic**
3. Tragen Sie Ihren QCode-API-Key (beginnt mit `cr_`) unter **API Key** ein
4. Aktivieren Sie **Use custom base URL** und geben Sie `https://api.qcode.cc/api` ein
5. Wählen Sie `claude-sonnet-5` (oder eine andere verfügbare ID) im Modellauswahlmenü
6. Speichern Sie, und senden Sie eine Nachricht im Chatfenster, um die Verbindung zu bestätigen

> **Aus dem chinesischen Festland** tauschen Sie den Host gegen `https://asia.qcode.cc/api` (Asien-Knoten, nächstgelegener von Korea / Taiwan / Hongkong); der API-Key bleibt unverändert.
> **Kein abschließender Schrägstrich in der Base URL** – die Extension ergänzt `/v1/messages` selbst, und ein zusätzlicher Schrägstrich erzeugt einen 404-Fehler.

## GPT und chinesische Modelle konfigurieren (OpenAI Compatible)

1. Stellen Sie **API Provider** auf **OpenAI Compatible**
2. **Base URL**: `https://api.qcode.cc/openai/v1`
3. **API Key**: derselbe `cr_`-Schlüssel
4. **Model ID**: `gpt-6-sol`, `gpt-5.6-terra` oder eine [chinesische Modell-ID](/docs/usage/cn-models) wie `glm-5.2`

## Konnektivität prüfen

Überprüfen Sie den Endpunkt und API-Key zunächst per curl, damit Sie wissen, ob Sie die Oberfläche der Extension debuggen müssen:

```bash
KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
```

JSON mit `content` bedeutet, dass der Endpunkt einwandfrei arbeitet; falls die Extension dennoch fehlschlägt, liegt das Problem in deren Einstellungen.

## Fehlerbehebung

| Symptom | Ursache | Lösung |
|---------|-------|-----|
| `model_not_available_on_endpoint` | Zugriff auf Claude über OpenAI Compatible | Wechseln Sie zum Anthropic-Anbieter mit `/api` |
| `Invalid API key` | Falscher Schlüssel oder versehentliche Leerzeichen | Prüfen Sie das `cr_`-Präfix und entfernen Sie Leerzeichen |
| 404 | Abschließender Schrägstrich in der Base URL oder falscher Pfad | Vergleichen Sie mit der Tabelle oben |
| Ihre Modell-ID fehlt im Dropdown | Nicht in der eingebauten Liste der Extension | Geben Sie die Modell-ID im Feld für benutzerdefinierte Modell-IDs ein |

## Weiterführende Links

- [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths) — Tabelle Protokoll × Modellfamilie
- [Kilo Code Einrichtung](/docs/ide/kilo-code) — nachgelagerter Fork, nahezu identische Einrichtung
- [Cline Integration](/docs/ide/cline) — ursprüngliches Projekt
- [Chinesische Modelle](/docs/usage/cn-models)