# Kilo Code einrichten

> **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](https://www.anaconda.com/press/anaconda-acquires-kilo-code). 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](https://kilo.ai/docs/ai-providers/anthropic) und [openai-compatible](https://kilo.ai/docs/ai-providers/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](https://kilo.ai) |

[Kilo Code](https://kilo.ai) ist eine Open-Source-Erweiterung für KI-gestütztes Programmieren in VS Code. Sie ist ein Fork von [Roo Code](/docs/ide/roo-code), das seinerseits von [Cline](/docs/ide/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](/docs/getting-started/endpoints-and-api-paths) |

🔴 **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](https://kilo.ai).

## Claude konfigurieren (Custom provider)

1. Öffnen Sie in der Seitenleiste von Kilo Code die **Settings** (Zahnrad-Symbol) und wechseln Sie zum Tab **Providers**
2. Scrollen Sie ganz nach unten und klicken Sie auf **Custom provider**
3. 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 |

4. Klicken Sie auf **Submit**; die Modelle erscheinen in der Modellauswahl
5. 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 (etwa
> `https://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 `/api` aufzuhören und die Erweiterung `/v1/messages` anhä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 Stelle `kilo.json`, an einer anderen `kilo.jsonc`) und kann direkt bearbeitet werden.
## GPT und chinesische Modelle konfigurieren (OpenAI-kompatibel)

Derselbe Dialog **Custom provider**, es ändern sich nur zwei Felder:

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

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:

```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 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](/docs/getting-started/endpoints-and-api-paths) — Tabelle Protokoll × Modellfamilie
- [Roo Code-Einrichtung](/docs/ide/roo-code) — Upstream-Projekt, nahezu identische Einrichtung
- [Cline-Integration](/docs/ide/cline) — weiter oben im Upstream
- [Chinesische Modelle](/docs/usage/cn-models)