Cline-Integration

QCode.cc-API mit der Cline-Erweiterung in VS Code verwenden

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¶

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 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:

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:

🔴 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.

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):

# 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:

Nutzer in Festlandchina sollten asia.qcode.cc bevorzugen, das in der Regel die niedrigste Latenz bietet. Details finden Sie unter Endpoints & API-Formate.

Cline Desktop¶

Am 2026-09-14 hat Cline eine Desktop-App veröffentlicht (offizielle Ankündigung: „Bring your own API key and connect natively to any provider — Anthropic, OpenAI, Gemini, open-weight models, or a local endpoint“; die Produktseite 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.

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¶

Vollständige Preise finden Sie unter Abrechnung.

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:

{
  "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:

# .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 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:

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.

• Ein weiteres Open-Source-Tool, das mit QCode.cc kompatibel ist, finden Sie unter Aider-Integration.

• Informationen zur offiziellen Claude-Code-Erweiterung finden Sie unter VS-Code-Integration.

• Wie Sie GLM / Kimi / DeepSeek / Qwen mit denselben OpenAI-kompatiblen Feldern aufrufen, lesen Sie unter Chinesische Modelle.

• Details zu den Preisen finden Sie unter Abrechnung.

Sie haben noch keinen API-Key? QCode.cc-Tarife und Preise ansehen →