# Cline-Integration

> **Zuletzt überprüft**: 2026-09-18 · 📄 Laut offizieller Dokumentation (VS Code-Erweiterung 4.1.19, veröffentlicht am 2026-09-17; Cline Desktop siehe unten)

## Auf einen Blick

| Punkt | Details |
|---|---|
| Verfügbare Modelle | Claude ✅ (Route A: Anthropic-Anbieter) · GPT ✅ · Chinesische Modelle ✅ (Route B: OpenAI Compatible) · Gemini ❌ (hier keine Gemini-Route dokumentiert) |
| Protokoll & Base URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| Konfiguration | Einstellungen der VS Code-Erweiterung (API Provider + „Use custom base URL“); die Desktop-App folgt derselben Logik |
| Offizielle Dokumentation | [cline.bot](https://cline.bot) · [GitHub](https://github.com/cline/cline) |

[Cline](https://github.com/cline/cline) ist eine beliebte VS Code AI-Coding-Erweiterung (Millionen Installationen), die jedes AI-Modell und benutzerdefinierte API-Endpunkte unterstützt. Sie bietet Plan-/Act-Dual-Modi, Dateibearbeitungs-Diff-Vorschau, Terminal-Ausführung und MCP-Tool-Aufrufe. Durch die Kopplung von Cline mit der QCode.cc-API können Sie Claude, GPT und [chinesische Modelle](/docs/usage/cn-models) in VS Code kostengünstig nutzen.

## Warum Cline?

- **Kein Aufschlag**: Keine Aufschläge auf Modellkosten — Sie zahlen nur die QCode.cc-API-Gebühren

- **Flexibler Modellwechsel**: Wechseln Sie zwischen `claude-sonnet-5`, `claude-opus-5`, `gpt-5.6-terra` und weiteren im selben Interface (4.x funktioniert weiterhin)

- **Tiefe VS Code-Integration**: Sidebar-Panel, Inline-Code-Aktionen, Dateibearbeitungs-Diff-Vorschau, automatische Genehmigung

- **Plan-/Act-Dual-Modi**: Erst planen, dann ausführen — hält komplexe Änderungen unter Kontrolle

- **Vollständig Open Source**: Transparenter Code, aktive Community

- **MCP-Unterstützung**: Verbinden Sie externe Tools (Datenbanken, Browser, Docs) über das Model Context Protocol

## Installation & Konfiguration

### Schritt 1: Cline-Erweiterung installieren

In VS Code:

1. Extensions-Panel öffnen (`Ctrl+Shift+X` / `Cmd+Shift+X`)

2. Nach **„Cline“** suchen

3. Auf **Install** klicken

4. Nach der Installation erscheint das Cline-Symbol in der linken Activity Bar

> Cline bietet auch eine Kommandozeilenversion (Cline CLI), die dieselbe Konfiguration im Terminal nutzt; dieser Leitfaden konzentriert sich auf die VS Code-Erweiterung.

### Schritt 2: QCode.cc-API konfigurieren

Ein einzelner QCode.cc-API-Key (beginnt mit `cr_`) ist sowohl mit dem Anthropic- als auch mit dem OpenAI-Protokoll kompatibel. Cline bietet zwei Verbindungsmethoden — **wählen Sie eine der beiden**:

#### Option A: Anthropic-kompatibel (empfohlen für Claude-Modelle)

Öffnen Sie in Cline-Einstellungen (Zahnrad-Symbol) das Dropdown **API Provider** und wählen Sie **„Anthropic“**, füllen Sie dann aus:

| Einstellung | Wert |
|---------|-------|
| API Key | Ihr QCode.cc-API-Key (beginnt mit `cr_`) |
| Use custom base URL | Aktivieren und `https://api.qcode.cc/api` eingeben |
| Model | `claude-sonnet-5` (tägliches Standardmodell) oder `claude-opus-5` (anspruchsvolle Aufgaben). `claude-sonnet-4-6` / `claude-opus-4-8` weiterhin erhältlich |

> Das SDK fügt automatisch `/v1/messages` nach der Base URL hinzu, stellen Sie die Base URL also auf `/api` — schreiben Sie **nicht** `/api/v1/messages`, und setzen Sie **keinen** abschließenden Schrägstrich.

#### Option B: OpenAI-kompatibel

Wählen Sie im Dropdown **API Provider** **„OpenAI Compatible“**, füllen Sie dann aus:

| Einstellung | Wert |
|---------|-------|
| Base URL | `https://api.qcode.cc/openai/v1` |
| API Key | Ihr QCode.cc-API-Key (beginnt mit `cr_`) |
| Model ID | `gpt-5.6-terra`, `gpt-6-sol` oder eine [chinesische Modell-ID](/docs/usage/cn-models) wie `glm-5.2`. **`claude-*` funktioniert hier nicht** |

> 🔴 **Im OpenAI-kompatiblen Modus kann Claude nicht genutzt werden.** QCodes OpenAI-Endpunkt bedient ausschließlich GPT und die vier chinesischen Familien; eine `claude-*`-ID gibt `model_not_available_on_endpoint` zurück. Für Claude kehren Sie zu **Option A (Anthropic)** mit Base URL `https://api.qcode.cc/api` zurück. Siehe [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths).

### Schritt 3: Verbindung überprüfen

Geben Sie eine einfache Nachricht (z. B. „Hallo“) in das Cline-Chat-Feld ein. Wenn Sie eine Antwort erhalten, ist die Konfiguration erfolgreich.

Sie können auch in einem Terminal mit curl selbst prüfen (ein `401` bedeutet, dass der Pfad korrekt ist und nur die Authentifizierung fehlt):

```bash
# Anthropic protocol
curl -i https://api.qcode.cc/api/v1/messages \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'

# OpenAI protocol (note: this leg only accepts GPT or China-family ids)
curl -i https://api.qcode.cc/openai/v1/chat/completions \
  -H "content-type: application/json" \
  -d '{"model":"gpt-6-sol","messages":[{"role":"user","content":"hi"}]}'
```

## Alternative Endpoints

Der gleiche API-Key funktioniert über 3 Zugangsdomänen, die einander absichern. Falls die primäre Domain instabil ist, tauschen Sie `api` in der Base URL gegen die entsprechende Subdomain unten:

| Endpoint | Anthropic Base URL | OpenAI Base URL |
|----------|--------------------|-----------------|
| Standard | `https://api.qcode.cc/api` | `https://api.qcode.cc/openai/v1` |
| Asien-Pazifik (empfohlen in Festlandchina) | `https://asia.qcode.cc/api` | `https://asia.qcode.cc/openai/v1` |
| Nordamerika / Europa | `https://us.qcode.cc/api` | `https://us.qcode.cc/openai/v1` |

> Nutzer in Festlandchina sollten `asia.qcode.cc` bevorzugen, das in der Regel die niedrigste Latenz bietet. Details finden Sie unter [Endpoints & API-Formate](/docs/getting-started/endpoints-and-api-paths).

## Cline Desktop

Am 2026-09-14 hat Cline eine Desktop-App veröffentlicht ([offizielle Ankündigung](https://cline.bot/blog/cline-desktop-an-open-source-app-for-open-weight-models): *„Bring your own API key and connect natively to any provider — Anthropic, OpenAI, Gemini, open-weight models, or a local endpoint“*; die [Produktseite](https://cline.bot/desktop) enthält kein Datum). Die Desktop-App folgt der gleichen Anbieter-Logik wie die Extension (API Provider + benutzerdefinierte Base URL wählen); feldbezogene Bezeichnungen für die Desktop-Version sind upstream nicht separat dokumentiert — richten Sie sich nach dem, was die App anzeigt. Downloads und Plattformunterstützung: [cline.bot/desktop](https://cline.bot/desktop).

## Plan / Act – Zwei Modi

Cline bietet unter dem Chat-Fenster einen **Plan**-/**Act**-Umschalter:

- **Plan**: Cline liest den Code, stellt Fragen und schlägt einen Umsetzungsplan vor, modifiziert aber **keine** Dateien. Ideal, um Anforderungen abzustimmen, bevor Änderungen vorgenommen werden.

- **Act**: Cline erstellt/bearbeitet tatsächlich Dateien, führt Befehle aus und ruft Tools auf. Jede Änderung wird als Diff angezeigt, damit Sie sie genehmigen oder automatisch genehmigen lassen können.

Ein typischer Workflow: Nutzen Sie zunächst den **Plan**-Modus, um das Modell einen Ansatz skizzieren und bestätigen zu lassen, und wechseln Sie dann in den **Act**-Modus, um ihn Schritt für Schritt umzusetzen. Bei komplexen Aufgaben erst mit `claude-opus-5` planen, dann mit `claude-sonnet-5` ausführen. 4.x ist weiterhin als Vergleich verfügbar.

## Nutzungstipps

### 1. Leitfaden zur Modellauswahl

| Szenario | Empfohlenes Modell | Hinweise |
|----------|-------------------|-------|
| Tägliche Programmierung | `claude-sonnet-5` | Aktuelle ausgewogene Stufe, 1M / 128K; Input war bei Erstellung dieses Dokuments günstiger als bei 4.6 |
| Komplexe Architektur / Plan-Modus | `claude-opus-5` | Aktuelles Flaggschiff. `claude-opus-4-8` noch im Angebot |
| Leichte Aufgaben / Textkorrekturen | `claude-haiku-4-5` | Niedrigste Kosten |
| GPT-Stil bevorzugt | `gpt-5.6-terra` | Unter dem OpenAI-Protokoll wählbar |
| China-Familie / niedrigerer Stückpreis | `glm-5.2` / `deepseek-v4-pro` | Siehe [China-Familienmodelle](/docs/usage/cn-models) |

Vollständige Preise finden Sie unter [Abrechnung](/docs/reference/billing).

### 2. MCP-Tools konfigurieren

Cline unterstützt das Model Context Protocol (MCP), sodass das Modell externe Tools aufrufen kann (Datenbankabfragen, Browser, Dokumentsuche usw.). Fügen Sie einen Server im **MCP Servers**-Panel von Cline hinzu:

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/project"]
    }
  }
}
```

MCP-Server sind vom Upstream-Modell entkoppelt — Tool-Aufrufe funktionieren, egal ob Sie QCode.cc über das Anthropic- oder das OpenAI-Protokoll verbinden. Installationsschritte und Parameter für jeden Server finden Sie in der offiziellen Dokumentation des jeweiligen Tools.

### 3. Projektweite benutzerdefinierte Anweisungen (.clinerules)

Erstellen Sie eine `.clinerules`-Datei im Projektstamm, um festen Kontext für dieses Repository zu injizieren — Code-Stil, Stack-Konventionen, Verzeichnisstruktur. Cline fügt diese Regeln in jede Konversation ein, sodass Sie sie nicht wiederholt einfügen müssen:

```text
# .clinerules
- Use TypeScript everywhere, strict mode
- Prefer reusing helpers under src/lib
- Run `pnpm test` before committing
```

Details zu den Feldern der Regeldatei und fortgeschrittener Nutzung finden Sie in Cline's offizieller Dokumentation.

### 4. Bildeingabe (Vision)

`claude-opus-5`, `claude-sonnet-5` (und die noch erhältlichen 4.8 / 4.6) sowie GPT-5.x unterstützen allesamt Vision-Eingabe. Ziehen Sie einen UI-Screenshot, einen Fehler-Screenshot oder ein Architekturdiagramm direkt in das Cline-Chat-Fenster und lassen Sie das Modell daraus Code generieren oder debuggen.

> Hinweis: Hier geht es darum, dass das Modell Bilder **liest**. Um Bilder zu **generieren**, nutzen Sie [gpt-image-2 Bildgenerierung](/docs/usage/image-2) mit dem Modellnamen `gpt-image-2`.

### 5. Auto-Approve & Kostenkontrolle

- In den Einstellungen können Sie **Auto-approve** getrennt für „Dateien lesen“, „Dateien schreiben“ und „Befehle ausführen“ aktivieren, um Unterbrechungen zu reduzieren; behalten Sie die manuelle Bestätigung für risikoreiche Operationen bei.

- Cline zeigt den Token-Verbrauch und die geschätzten Kosten pro Anfrage an, sodass sich Ausgaben leicht nachverfolgen lassen. Schränken Sie bei komplexen Aufgaben zunächst den Umfang im Plan-Modus ein, um unnötiges Hin und Her zu vermeiden.

- Bei großen Codebasen nutzen Sie `@` (Datei/Ordner/URL erwähnen), um präzisen Kontext bereitzustellen, anstatt das Modell das gesamte Projekt durchsuchen zu lassen — das spart Tokens und hält den Fokus.

### 6. Zusammenspiel mit Claude Code CLI

Cline und Claude Code CLI haben je eigene Stärken — nutzen Sie beide gemeinsam:

| Szenario | Empfohlenes Tool |
|----------|------------------|
| Schnelle Bearbeitungen in VS Code | Cline |
| Komplexe Projektanalyse | Claude Code CLI |
| Dateiübergreifende Refactorings | Cline |
| Git-Operationen, Code-Review | Claude Code CLI |
| Codebasisweite Migration/Review | Claude Code CLI ([Subagents](/docs/advanced/subagents)) |
| CI/CD-Automatisierung | Claude Code CLI ([Headless-Modus](/docs/advanced/headless)) |

### 7. Gemeinsames Kontingent

Cline und Claude Code CLI nutzen denselben QCode.cc API-Key und teilen das Tarif-Kontingent — es ist nicht nötig, für jedes Tool separate Keys anzufordern.
## FAQ

### Verbindung fehlgeschlagen / 401 / 404?

1. Stellen Sie sicher, dass die Base URL **keinen** abschließenden `/` enthält.

2. Setzen Sie im Anthropic-Modus die Base URL auf `/api` (das SDK hängt `/v1/messages` automatisch an) – geben Sie den vollständigen Pfad nicht manuell an.

3. Setzen Sie im OpenAI-Modus die Base URL auf `/openai/v1`.

4. Prüfen Sie, ob der API-Key mit `cr_` beginnt und vollständig kopiert wurde.

5. Wechseln Sie versuchsweise zu einem alternativen Endpunkt (z. B. `asia.qcode.cc`).

6. Vergewissern Sie sich, dass Ihr Netzwerk die QCode.cc-Dienste erreichen kann.

### Modellliste ist leer?

Geben Sie im OpenAI-kompatiblen Modus den Modellnamen manuell im Feld „Model ID“ ein (z. B. `glm-5.3`) – Sie müssen ihn nicht aus einer Liste auswählen.

### Der Plan-Modus ändert keine Dateien?

Das ist zu erwarten. Der Plan-Modus plant nur; Änderungen werden erst nach dem Wechsel in den Act-Modus geschrieben.

### 401, obwohl die Konfiguration korrekt aussieht?

Ein `401` bedeutet in der Regel, dass der Pfad stimmt und nur die Authentifizierung fehlgeschlagen ist. Prüfen Sie erneut, ob der API-Key vollständig ist und ob Sie den richtigen Provider-Typ (Anthropic oder OpenAI Compatible) mit der passenden Base URL gewählt haben.

## Nächste Schritte

- Alle Protokolle und Domains finden Sie unter [Endpunkte & API-Formate](/docs/getting-started/endpoints-and-api-paths).

- Ein weiteres Open-Source-Tool, das mit QCode.cc kompatibel ist, finden Sie unter [Aider-Integration](/docs/ide/aider).

- Informationen zur offiziellen Claude-Code-Erweiterung finden Sie unter [VS-Code-Integration](/docs/ide/vscode).

- Wie Sie GLM / Kimi / DeepSeek / Qwen mit denselben OpenAI-kompatiblen Feldern aufrufen, lesen Sie unter [Chinesische Modelle](/docs/usage/cn-models).

- Details zu den Preisen finden Sie unter [Abrechnung](/docs/reference/billing).

> Sie haben noch keinen API-Key? [QCode.cc-Tarife und Preise ansehen →](https://qcode.cc/pricing)