Kilo Code einrichten
QCode.cc in der VS-Code-Erweiterung Kilo Code anbinden: Settings -> Providers -> Custom provider, mit Provider API auf Anthropic Messages für Claude
Auf dieser Seite
Zuletzt geprüft: 2026-09-18 · 📄 Laut offizieller Dokumentation (Kilo-Code-Erweiterung; Dokumentation unter kilo.ai)
⚠️ Eigentümerwechsel und geänderte Oberfläche: Am 2026-07-15 hat Anaconda die Übernahme von Kilo Code angekündigt. Seitdem hat Kilo die Eingabe eines benutzerdefinierten Endpunkts überarbeitet: Es ist nicht mehr das „API Provider“-Dropdown von Roo Code mit dem Häkchen „Use custom base URL“, sondern Settings → der Tab Providers → der Dialog Custom provider (so wörtlich auf den offiziellen Seiten anthropic und openai-compatible angegeben). Die folgenden Schritte richten sich nach der neuen Oberfläche.
Auf einen Blick¶
| Punkt | Details |
|---|---|
| Nutzbare Modelle | Claude ✅ (Provider API = Anthropic Messages) · GPT ✅ · Chinesische Modelle ✅ (Provider API = OpenAI Compatible) · Gemini ❌ (auf dieser Seite ist keine Gemini-Route dokumentiert) |
| Protokoll & Base URL | Anthropic: https://api.qcode.cc/api · OpenAI: https://api.qcode.cc/openai/v1 |
| Wo wird konfiguriert? | Erweiterungseinstellungen (Zahnrad) → Tab Providers → ganz nach unten scrollen → Dialog Custom provider |
| Offizielle Dokumentation | kilo.ai |
Kilo Code ist eine Open-Source-Erweiterung für KI-gestütztes Programmieren in VS Code. Sie ist ein Fork von Roo Code, das seinerseits von Cline abgespalten wurde – gleiche Herkunft, inzwischen unterschiedliche Oberflächen: Kilo nutzt den Custom-provider-Dialog im Tab „Providers“, während Roo Code und Cline weiterhin ein API-Provider-Dropdown verwenden. Übertragen Sie diese Schritte nicht auf die beiden anderen Tools, sondern lesen Sie deren eigene Seiten.
Welches Protokoll¶
| Gewünschte Modelle | Provider API | Base URL |
|---|---|---|
| Claude | Anthropic Messages |
https://api.qcode.cc/api |
| GPT und die vier chinesischen Modellfamilien | OpenAI Compatible |
https://api.qcode.cc/openai/v1 |
| GPT / xAI im Responses-Stil | OpenAI Responses |
siehe Endpunkte und API-Formate |
🔴 Rufen Sie Claude niemals über OpenAI Compatible auf – der OpenAI-Endpunkt von QCode weist Claude-Modelle mit
model_not_available_on_endpoint ab. Auch die offizielle Dokumentation ordnet Anthropic und MiniMax
unter Anthropic Messages ein.
Installation¶
Suchen Sie im VS-Code-Marketplace nach Kilo Code oder folgen Sie den Anweisungen auf kilo.ai.
Claude konfigurieren (Custom provider)¶
- Öffnen Sie in der Seitenleiste von Kilo Code die Settings (Zahnrad-Symbol) und wechseln Sie zum Tab Providers
- Scrollen Sie ganz nach unten und klicken Sie auf Custom provider
- Füllen Sie den Dialog aus:
| Feld | Eingabe |
|---|---|
| Provider ID | eine eindeutige Kennung, z. B. qcode |
| Display name | der in der Oberfläche angezeigte Name, frei wählbar |
| Provider API | wählen Sie für Claude Anthropic Messages |
| Base URL | https://api.qcode.cc/api |
| API key | Ihr QCode-Key (beginnt mit cr_) |
| Models | selbst eintippen oder aus der automatisch abgerufenen Liste wählen (z. B. claude-sonnet-5) |
| Headers | optionale benutzerdefinierte HTTP-Header als Schlüssel-Wert-Paare |
- Klicken Sie auf Submit; die Modelle erscheinen in der Modellauswahl
- Senden Sie zur Kontrolle eine Nachricht im Chat
Festlandchina: Tauschen Sie den Host gegen
https://asia.qcode.cc/api(Asien-Knoten, nahe Korea / Taiwan / Hongkong); der Key bleibt derselbe. Die Base-URL-Beispiele der offiziellen Dokumentation sind in versionierter Form geschrieben (etwahttps://api.your-provider.com/v1), und Kilo ruft die Modellliste automatisch von einer gültigen URL ab. Für den Anthropic-Messages-Zweig empfehlen wir, bei/apiaufzuhören und die Erweiterung/v1/messagesanhängen zu lassen. Kein abschließender Schrägstrich. Ob ein zusätzlicher Schrägstrich tatsächlich einen 404 verursacht, haben wir nicht getestet; halten Sie sich daher an die empfohlene Form. Alles, was Sie in der Oberfläche festlegen, wird in einer Konfigurationsdatei gespeichert (die offiziellen Seiten nennen sie an einer Stellekilo.json, an einer anderenkilo.jsonc) und kann direkt bearbeitet werden.
GPT und chinesische Modelle konfigurieren (OpenAI-kompatibel)¶
Derselbe Dialog Custom provider, es ändern sich nur zwei Felder:
- Setzen Sie Provider API auf OpenAI Compatible
- Base URL:
https://api.qcode.cc/openai/v1 - API key: derselbe
cr_-Schlüssel - Modelle: Geben Sie
gpt-6-sol,gpt-5.6-terraoder eine chinesische Modell-ID wieglm-5.2ein
Für die Responses-Schnittstelle von GPT / xAI ist der offizielle Wert OpenAI Responses; Anthropic-Modelle
funktionieren weiterhin nur über Anthropic Messages (Base URL https://api.qcode.cc/api). Die beiden Varianten sind nicht austauschbar.
Verbindung überprüfen¶
Prüfen Sie Endpunkt und Schlüssel zuerst mit curl, damit Sie wissen, ob Sie die UI der Erweiterung debuggen müssen:
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 die Endpunktseite in Ordnung ist; wenn die Erweiterung weiterhin fehlschlägt, liegt das Problem in ihren 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 überflüssige 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 obigen Tabelle |
| Ihre Modell-ID fehlt in der Dropdown-Liste | Nicht in der integrierten Liste der Erweiterung | Geben Sie sie im Feld für die benutzerdefinierte Modell-ID ein |
Weiteres¶
- Endpunkte & API-Pfade — Tabelle Protokoll × Modellfamilie
- Roo Code-Einrichtung — Upstream-Projekt, nahezu identische Einrichtung
- Cline-Integration — weiter oben im Upstream
- Chinesische Modelle