Cline ist eine Open-Source-Agent-Erweiterung für KI-gestütztes Programmieren, die typischerweise in der VS-Code-Seitenleiste Code liest, Dateien ändert und Befehle ausführt. Sie ist nicht an einen Modellanbieter gebunden: Neben dem Cline-Konto kann im Feld „API Provider“ eine OpenAI-kompatible Schnittstelle gewählt und eine eigene Base URL, ein eigener Key und eine Modell-ID hinterlegt werden. Für Teams bedeutet das, Cline an ein einheitliches Gateway anzubinden und Keys, Verbrauch und Modelle zentral zu verwalten.

Dieser Artikel folgt der Reihenfolge Installation, Konfiguration, Prüfung und Einführung im Team. Cline wird schnell weiterentwickelt; Schaltflächen und Feldnamen richten sich nach der aktuellen Version.

Hinweis: Cline ist eine Marke von Cline Bot Inc. Dieser Artikel dient ausschließlich der technischen Erläuterung; es besteht keine Zugehörigkeit, Vertretung oder Billigung durch Cline Bot Inc. Produktfunktionen, Oberfläche und Abrechnungsregeln richten sich nach der offiziellen Cline-Dokumentation.

1. Drei Dinge vorbereiten

Für die eigene Anbindung benötigt Cline nur drei Angaben: eine kompatible Adresse, einen API-Key und eine exakte Modell-ID. Bereiten Sie diese besser im Gateway vor, bevor Sie den Editor öffnen.

  1. Öffnen Sie die Registrierungsseite der ZSQH AI Gateway, registrieren Sie sich und melden Sie sich in der Konsole an.
  2. Gehen Sie zu „API-Keys“, legen Sie einen neuen Key an und benennen Sie ihn nach Nutzer und Gerät, etwa cline-zhang-macbook.
  3. Legen Sie nach Bedarf ein Ausgabenlimit und ein Ablaufdatum fest. Auch für private Tests empfiehlt sich das, um ungewöhnlichen Verbrauch zu begrenzen.
  4. Kopieren Sie den Key und speichern Sie ihn im Passwortmanager. Die Konsole zeigt ihn in der Regel nur einmal vollständig an.
  5. Öffnen Sie die Modellpreise und kopieren Sie die benötigte Modell-ID. Modelle und Preise ändern sich; maßgeblich ist die aktuelle Anzeige.

Notieren Sie die drei Angaben für Fehlersuche und Übergabe:

Base URL: https://ai.zhongshangqihang.com/v1
API Key: sk-... (nur im Passwortmanager gespeichert)
Model: Modell-ID laut aktueller Anzeige auf der Seite „Modellpreise“
Context Window: gemäß offizieller Spezifikation des Modells

Die Base URL ist die OpenAI-kompatible Adresse und endet auf /v1. Tragen Sie weder die Website-Startseite noch zusätzlich /chat/completions ein, sonst entstehen doppelte Pfade und 404.

2. Cline in VS Code installieren

Die Installation ist unkompliziert; heikler sind später Vertrauen im Arbeitsbereich und Berechtigungen.

  1. Öffnen Sie VS Code und die Erweiterungsansicht mit Cmd/Ctrl + Shift + X.
  2. Suchen Sie nach Cline, prüfen Sie den Herausgeber und klicken Sie auf Install.
  3. Nach der Installation das Cline-Symbol in der linken Aktivitätsleiste öffnen.
  4. Beim ersten Öffnen erscheint die Konfiguration; wählen Sie die Nutzung eines eigenen API-Keys. Je nach Version lautet der Text Use your own API key.
  5. Aktivieren Sie die Erweiterung nur in vertrauenswürdigen Ordnern. In einem unbekannten Repository sollte der Agent bei aktivierter automatischer Freigabe keine Befehle ausführen.

Die Installation in Cursor, Windsurf oder VSCodium ist ähnlich, der Erweiterungsmarkt kann jedoch abweichen; dieser Artikel bezieht sich auf VS Code.

3. OpenAI-kompatiblen Anbieter wählen

Öffnen Sie das Zahnrad oben rechts im Cline-Panel und wählen Sie im Dropdown API Provider den Eintrag OpenAI Compatible. Dies ist der entscheidende Schritt für ein universelles Gateway.

Tragen Sie den Gateway-Key nicht in die speziellen Felder von OpenAI, Anthropic oder Google ein; diese verwenden meist eigene Standardendpunkte und Authentifizierungsverfahren, was häufig zu 401, 404 oder Verbindungsfehlern führt. Sofern das Gateway nicht ausdrücklich das jeweilige native Protokoll anbietet, wählen Sie OpenAI Compatible.

Use Azure Identity Authentication gilt nur für Azure Managed Identity und sollte bei einem normalen Gateway-Key nicht aktiviert werden.

Bei einem Cline-eigenen Anbieter wird das Cline-Kontingent verbraucht; bei OpenAI Compatible mit eigenem Key gehen die Anfragen an Ihr Gateway, und die Abrechnung erfolgt dort. Vermischen Sie beide Wege bei der Fehlersuche nicht.

4. Base URL, Key und Modell eintragen

Die drei Kernfelder:

Feld Inhalt Beachten
Base URL https://ai.zhongshangqihang.com/v1 /v1 behalten, kein /chat/completions
API Key in der Konsole erstelltes sk-... Ein Key pro Person, nicht mit anderen Werkzeugen teilen
Model Modell-ID von der Preisseite Unverändert kopieren, Groß-/Kleinschreibung und Versionssuffix beachten
Model Configuration Kontextfenster, maximaler Output usw. Gemäß tatsächlicher Modellspezifikation, nicht zu groß angeben
Azure Identity nicht aktivieren Nur für Azure Managed Identity

Model ist die Routing-Kennung, nicht der Anzeigename. Ein fehlendes Versionssuffix oder eine abweichende Schreibweise kann zu „Model Not Found“ führen. Fehlt der Eintrag im Dropdown, lässt sich die Modell-ID meist direkt eingeben, sofern die Version dies zulässt.

Die Felder für Max Output Tokens, Context Window, Image Support, Computer Use und Preise in Model Configuration dienen Cline vor allem zur Kontextverwaltung und Kostenschätzung, nicht als Grundlage der Gateway-Abrechnung. Ein zu groß eingetragenes Kontextfenster lässt den Agenten den verfügbaren Platz falsch einschätzen, bis das Gateway die Überschreitung meldet. Tragen Sie die tatsächliche Spezifikation ein.

Unterstützt das Modell keine Tool-Aufrufe, sind Agent-Funktionen wie Dateizugriff und Befehlsausführung eingeschränkt; auch Bild- und Computer-Nutzung hängen von den Modellfähigkeiten ab.

5. Prüfen, ob die Konfiguration wirklich wirkt

Ein erfolgreicher Verify-Test belegt nur, dass Adresse, Key und Modellname grob stimmen – nicht, dass alle Tool-Funktionen verfügbar sind. Führen Sie deshalb eine echte Prüfung durch.

  1. Legen Sie eine leere Aufgabe an, damit kein alter Verlauf stört.
  2. Wählen Sie ausdrücklich das eben konfigurierte Modell, nicht die automatische Auswahl.
  3. Senden Sie eine reine Leseanfrage, zum Beispiel die Erklärung einer kleinen Datei im aktuellen Verzeichnis.
  4. Öffnen Sie Verbrauch oder Anfrageprotokoll der Gateway-Konsole und prüfen Sie, ob ein Eintrag mit gleichem Zeitpunkt, Modell und Key erscheint.
  5. Lassen Sie anschließend eine kleine Änderung ohne Dateischreiben ausführen und beobachten Sie, ob eine Freigabe nötig ist und ob sie gelingt.

Häufige Fehler lassen sich so zuordnen:

  • Invalid API Key oder 401: Key falsch, deaktiviert oder beim Kopieren mit Leerzeichen und Zeilenumbrüchen versehen.
  • 403: fehlende Key-Rechte, aufgebrauchtes Kontingent oder Modell nicht im erlaubten Bereich.
  • 404 oder Model Not Found: Base-URL-Pfad oder Modell-ID falsch.
  • 429: Rate Limit erreicht oder Key-Kontingent erschöpft.
  • Timeout: Endpunkt nicht erreichbar oder Netzwerkpfad gestört.
  • Chat funktioniert, Agent-Aktionen scheitern: zuerst prüfen, ob das Modell Tool-Aufrufe unterstützt, statt den Key zu verdächtigen.

6. Automatische Freigaben richtig setzen

Auto Approve wird nach Kategorien gesteuert: Lesen, Bearbeiten, Terminalbefehle, Browser und MCP-Tools. Jede Kategorie lässt sich einzeln schalten, teilweise mit Unterscheidung zwischen „nur sichere Befehle“ und „alle Befehle“.

Erlauben Sie zunächst nur das Lesen von Projektdateien; Bearbeiten, Terminal, Browser und MCP bleiben aus. Lockern Sie die Regeln erst, wenn der Workflow stabil ist; beim Freigeben von Bearbeitungen sollten Sie zugleich Checkpoints aktivieren, um zurückrollen zu können.

Terminalbefehle bergen das höchste Risiko. Cline verwendet keine feste Whitelist, sondern lässt das Modell anhand von Befehl und Argumenten entscheiden; Builds, Tests und git status gelten meist als sicher, während npm install, rm -rf, mv oder sed -i in der Regel bestätigt werden müssen. Diese Einschätzung ist keine Sicherheitsgrenze und ersetzt keine menschliche Prüfung.

Der YOLO-Modus überspringt alle Bestätigungen, einschließlich Dateiänderungen, Terminalbefehlen, Browser- und MCP-Aufrufen; die offizielle Dokumentation weist ausdrücklich auf die Risiken hin. Wer ihn testet, sollte dies in einem Einweg-Repository oder einer Sandbox tun und vorher ein Git-Backup anlegen. Checkpoints helfen beim Zurückrollen, sind aber kein Backup und decken keine Aktionen außerhalb des Repositories ab.

7. Einführung im Team

  • Zuerst in kleinem Kreis testen: drei bis fünf Entwickler, ein einheitliches Hauptmodell, eine Woche Laufzeit.
  • Erfolgsquote der Anfragen, durchschnittliche Latenz und Tagesverbrauch pro Person erfassen.
  • Im Gateway für jede Person einen eigenen Key anlegen, mit persönlichem Limit und Ablaufdatum; keine gemeinsamen Keys.
  • Eine Modellzuordnung pflegen: Welche ID steht in Cline, welches Modell entspricht ihr im Gateway, worauf wird bei Ausfall gewechselt?
  • Base URL, Modell-ID, Rechte und häufige Fehler in der internen Dokumentation festhalten.
  • Erweiterungsquelle und Version vereinheitlichen, um manipulierte Pakete aus unbekannten Quellen zu vermeiden.
  • Projektregeln in die Regeldatei des Repositories aufnehmen. Neuere Versionen nutzen .cline/, ältere häufig .clinerules; maßgeblich ist die Dokumentation der aktuellen Version. Keine Keys in Regeldateien schreiben.
  • Bei Austritt, Gerätewechsel oder Projektende den zugehörigen Key noch am selben Tag deaktivieren.

Kostenbetrachtungen richten sich nach den Modellpreisen und sollten anhand tatsächlicher Anfragen und Kontextlängen erfolgen, nicht nach dem subjektiven Eindruck einer einzelnen Aufgabe.

8. Sicherheit und Datengrenzen

  • Keys können in lokalen Konfigurationsdateien liegen. Neuere Versionen speichern Anbieterkonfigurationen in ~/.cline/data/settings/providers.json, möglicherweise einschließlich Key. Nicht ins Repository übernehmen oder in öffentliche Cloud-Laufwerke synchronisieren.
  • Festplattenverschlüsselung aktivieren und lokale Rechte begrenzen. Auf gemeinsam genutzten Rechnern Keys nicht dauerhaft speichern.
  • Der Agent liest Dateien im Arbeitsbereich. .env, Zugangsdaten und private Schlüssel vom lesbaren Bereich ausschließen; falls die Version Ignore-Dateien unterstützt, diese aktiv konfigurieren und prüfen.
  • MCP-Server, Plugins und Hooks können Code ausführen oder auf das Netzwerk zugreifen. Nur vertrauenswürdige Quellen installieren und die Berechtigungshinweise lesen.
  • Automatische Freigaben verstärken das Risiko von Prompt-Injection. Liest der Agent Webseiten, Issues oder fremde Repositories, können darin enthaltene Anweisungen Befehle auslösen. Bei Terminal- und Netzwerkaktionen die menschliche Bestätigung beibehalten.
  • Klären Sie zuerst, welche Daten den Rechner verlassen und an welche Dienste sie gehen, bevor Sie entscheiden, welche Repositories zulässig sind; sensiblen Code vorher bewerten.

9. Häufige Fragen

Kann Cline an jede OpenAI-kompatible Schnittstelle angebunden werden?

Meist ja, sofern die Schnittstelle die von Cline tatsächlich verwendeten Pfade und Parameter unterstützt und das Modell Tool-Aufrufe beherrscht. Prüfen Sie zuerst mit einem normalen Chat, dann mit Dateibearbeitung und Terminalaktionen.

Gehört in die Base URL die Stammadresse oder /v1?

Beim OpenAI-kompatiblen Protokoll die Adresse bis /v1, etwa https://ai.zhongshangqihang.com/v1; ohne /chat/completions, sonst entsteht ein doppelter Pfad.

Verify ist erfolgreich, Aufgaben scheitern aber – woran liegt das?

Prüfen Sie Fehlercode und Gateway-Protokoll. Häufig unterstützt das Modell keine Tool-Aufrufe, das Kontextfenster ist falsch gesetzt, das Kontingent reicht nicht oder die Anfrage wird gedrosselt. Verify prüft nur die grundlegende Erreichbarkeit, nicht alle Fähigkeiten.

Was unterscheidet das Cline-Konto vom eigenen Key?

Das Cline-Konto verbraucht das Kontingent auf Cline-Seite; mit eigenem Key gehen die Anfragen an Ihr Gateway, das abrechnet und protokolliert. Modellbereich, Datenweg und Fehlersuche unterscheiden sich.

Kann ein Team einen gemeinsamen Key verwenden?

Technisch möglich, aber nicht empfehlenswert. Ein gemeinsamer Key erlaubt keine Zuordnung des Verbrauchs und erschwert bei einer Offenlegung die Eingrenzung. Ein Key pro Person mit Limit, Ablaufdatum und Protokollen ist verlässlicher.

Nächste Schritte

Registrieren Sie sich bei der ZSQH AI Gateway, legen Sie einen Cline-spezifischen Key an und tragen Sie Base URL und Modell wie beschrieben ein. Nach einer erfolgreichen Leseaufgabe geben Sie schrittweise Bearbeitungs- und Terminalrechte frei und passen Hauptmodell und Limits anhand der Modellpreise an.

Weitere Artikel: