Was ist Cline AI? Installation in VS Code, API-Einrichtung und sicherer Einsatz

Cline — auch als Cline AI, ClineAI oder Cline agent gesucht — ist ein quelloffener KI-Programmieragent, der im Editor und im Terminal arbeitet. In VS Code kann er Projektdateien lesen, Code durchsuchen, Dateien bearbeiten, Terminalbefehle ausführen, einen Browser verwenden und MCP-Werkzeuge aufrufen. Welche Aktionen möglich sind, bestimmen Ihre Berechtigungen. Cline selbst ist kein Sprachmodell: Der Agent verbindet sich mit einem Modellanbieter und nutzt das ausgewählte Modell zum Analysieren und Erzeugen von Code.

Diese Anleitung erklärt, was Cline ist, wie Sie Cline in VS Code installieren, eine eigene API über OpenAI Compatible anbinden und die Konfiguration testen, ohne dem Agenten unnötig weitreichende Rechte zu geben. Als Beispiel dient BetterToken; der grundlegende Ablauf gilt jedoch auch für andere kompatible Endpunkte.

Das Wichtigste auf einen Blick

• Cline ist ein Programmieragent, kein eigenes Modell.
• Nach der Installation können Sie den Modellzugang von Cline verwenden oder einen eigenen API Key hinterlegen.
• Für BetterToken wählen Sie OpenAI Compatible und tragen https://www.bettertoken.ai/v1 als Base URL ein.
• Beginnen Sie mit reinem Lesezugriff. Aktivieren Sie nicht sofort automatische Änderungen, Terminalbefehle, Browser, MCP oder YOLO Mode.

Welche Aufgaben Cline, VS Code und die Modell-API übernehmen

Eine typische Cline-Aufgabe besteht aus drei Ebenen:

1. VS Code zeigt Projekt, Unterhaltung, Diffs, Terminalausgaben und Freigabeanfragen.
2. Der Cline-Agent sammelt Kontext, wählt Werkzeuge aus, strukturiert die Aufgabe und prüft die Berechtigungen.
3. Die Modell-API erhält den Kontext und liefert Analysen, Code oder den Vorschlag für einen Werkzeugaufruf zurück.

Das Ergebnis hängt deshalb nicht allein von der Erweiterung ab. Das Modell beeinflusst Denk- und Codequalität, Geschwindigkeit, Kontextgröße und Kosten. Die Cline-Einstellungen bestimmen, auf welche Dateien und Werkzeuge das Modell zugreifen darf und welche Aktionen bestätigt werden müssen.

Darin unterscheidet sich Cline von einem einfachen Chat im Editor. Ein Chat erzeugt in erster Linie Text. Cline arbeitet in einer Agentenschleife: Informationen lesen, den nächsten Schritt vorschlagen, ein Werkzeug ausführen, das Ergebnis prüfen und fortfahren, bis die Aufgabe abgeschlossen ist oder eine Entscheidung erforderlich wird.

Cline in VS Code installieren

1. Öffnen Sie VS Code.
2. Drücken Sie Ctrl/Cmd + Shift + X, um Extensions zu öffnen.
3. Suchen Sie nach Cline und wählen Sie die offizielle Cline-Erweiterung.
4. Klicken Sie auf Install.
5. Öffnen Sie Cline über die Activity Bar.
6. Wählen Sie beim Einstieg Use your own API key, um einen eigenen Anbieter zu konfigurieren.

Falls das Symbol nach der Installation nicht erscheint, führen Sie Developer: Reload Window aus oder starten Sie VS Code vollständig neu. Einzelne Bezeichnungen können sich zwischen Versionen ändern; die Einstellungen für Provider und Modell bleiben jedoch über die Cline-Seitenleiste erreichbar.

Was Sie vor der API-Verbindung benötigen

Für die Verbindung von Cline mit BetterToken brauchen Sie:

• ein BetterToken-Konto;
• einen separaten API Key;
• eine aktuelle Model ID von der Seite Modelle und Preise;
• eine Netzwerkverbindung zum Endpunkt;
• aktuelle Versionen von VS Code und der Cline-Erweiterung.

Behandeln Sie den API Key wie ein Passwort. Speichern Sie ihn nicht im Repository und zeigen Sie ihn nicht in Screenshots, Logs, Issues oder öffentlichen Konfigurationsdateien. In Teams sollten Benutzer und Umgebungen eigene Schlüssel erhalten, damit Limits, Sperrung und Nachverfolgung übersichtlich bleiben.

BetterToken in Cline konfigurieren

Öffnen Sie die Cline-Einstellungen und tragen Sie folgende Werte ein:

Feld	Wert
API Provider	OpenAI Compatible
Base URL	https://www.bettertoken.ai/v1
API Key	Ihr BetterToken API Key
Model	Die exakte aktuelle Model ID von der Modellseite

Achten Sie auf diese Punkte:

1. Die Base URL lautet https://www.bettertoken.ai/v1. Hängen Sie weder /chat/completions noch /responses oder einen anderen Methodenpfad an.
2. Kopieren Sie die Model ID exakt aus der aktuellen Liste und nicht aus einem älteren Artikel oder Screenshot.
3. Ein zusätzlicher User-Agent oder eigene Header sind normalerweise nicht nötig. Ergänzen Sie sie nur, wenn die offizielle Dokumentation des vorgeschalteten Dienstes dies ausdrücklich verlangt.
4. Nicht jedes Modell verwendet zwingend dasselbe Protokoll. Prüfen Sie die aktuell bestätigte Kompatibilität in der BetterToken-Dokumentation für Cline.

Wenn früher OpenAI-Umgebungsvariablen gesetzt wurden und Cline weiterhin einen alten Endpunkt verwendet, entfernen Sie sie in der aktuellen macOS- oder Linux-Sitzung:

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Unter Windows PowerShell:

Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue

Speichern Sie mit Done und laden Sie Cline neu. Nach einer Änderung von Base URL, Schlüssel oder Modell sollten Sie eine neue Aufgabe anlegen, damit keine veralteten Einstellungen oder ein unnötig großer Kontext aus der alten Sitzung übernommen werden.

Erste Anfrage: mit einem reinen Lesetest beginnen

Starten Sie nicht mit „Refaktoriere das gesamte Projekt“. Öffnen Sie eine normale Codedatei und senden Sie folgenden Prompt:

Lies ausschließlich die aktuell geöffnete Datei. Erkläre ihren Zweck, die wichtigsten Eingaben und Ausgaben. Verändere keine Dateien und führe keine Terminalbefehle aus.

Ein erfolgreicher erster Test erfüllt vier Bedingungen:

• Cline antwortet auf Grundlage des Dateiinhalts;
• es erscheint kein Authentifizierungs-, Modell- oder Verbindungsfehler;
• keine Datei wird verändert und kein Befehl ausgeführt;
• Anfrage und Token-Verbrauch erscheinen im BetterToken Dashboard.

Falls Cline antwortet, aber im Dashboard kein Eintrag erscheint, prüfen Sie zunächst, ob wirklich OpenAI Compatible aktiv ist. Kontrollieren Sie anschließend Base URL, API Key, Model ID und Netzwerk-Proxy. Veröffentlichen Sie bei Supportanfragen niemals den vollständigen Schlüssel in einem Screenshot.

Wie Cline eine Programmieraufgabe bearbeitet

Der typische Ablauf sieht so aus:

1. Sie beschreiben Ergebnis, erlaubten Änderungsumfang und Abnahmekriterien.
2. Cline liest relevante Dateien und sucht nach zusammenhängendem Code.
3. Das Modell schlägt den nächsten Schritt vor: weiterlesen, bearbeiten, testen oder nachfragen.
4. Cline prüft die Berechtigungskategorie und fordert bei Bedarf eine Freigabe an.
5. Das Werkzeugergebnis wird dem Kontext hinzugefügt, danach entscheidet das Modell über den nächsten Schritt.
6. Sie prüfen den abschließenden Diff, die Befehlsausgaben und die Testergebnisse.

Bei unklaren Aufgaben beginnen Sie im Plan Mode. Dort kann Cline die Codebasis untersuchen und eine Lösung diskutieren, aber keine Dateien verändern oder Befehle ausführen. Nach Ihrer Zustimmung wechseln Sie in den Act Mode.

Beispiel für den Plan Mode:

Untersuche, warum der Login-Endpunkt gelegentlich HTTP 500 zurückgibt. Lies nur den zugehörigen Code und die Tests. Nenne die wahrscheinlichsten Ursachen, betroffene Dateien und die kleinste sichere Korrektur. Ändere keinen Code.

Nach der Prüfung des Plans wechseln Sie in den Act Mode:

Setze die kleinste freigegebene Korrektur um. Ändere nur den Login-Endpunkt und unmittelbar zugehörige Tests. Führe die relevantesten Tests aus und stoppe, sobald sie erfolgreich sind. Refaktorisiere keine anderen Module.

Das ist deutlich besser überprüfbar als eine vage Aufforderung wie „Repariere den Login“.

Empfohlene Berechtigungen für die ersten Aufgaben

Beginnen Sie mit einem vorsichtigen Profil:

Berechtigung	Empfehlung zum Start
Read project files	Aktivieren
Read all files / außerhalb des Workspace	Deaktivieren
Edit project files	Jedes Mal bestätigen oder zunächst deaktivieren
Execute safe commands	Bei den ersten Aufgaben manuell bestätigen
Execute all commands	Deaktivieren
Use the browser	Nur bei konkretem Bedarf aktivieren
Use MCP servers	Erst nach Prüfung eines bestimmten Servers aktivieren
YOLO Mode	In realen Projekten deaktiviert lassen

Prüfen Sie vor der Freigabe eines Befehls Argumente, Arbeitsverzeichnis und Zieldateien. npm test und npm install haben unterschiedliche Folgen; das gilt ebenso für git status und git push.

Checkpoints und Git können lokale Codeänderungen zurücksetzen. Sie können jedoch keine bereits gesendete Netzwerkanfrage, gelöschte Cloud-Daten oder ein offengelegtes Geheimnis rückgängig machen. Verwenden Sie für wichtige Repositories einen Branch oder Worktree und halten Sie sensible Dateien nach Möglichkeit außerhalb des Agentenzugriffs.

API, MCP und Cline Rules sind nicht dasselbe

Diese Begriffe werden häufig verwechselt:

• Die Modell-API liefert die Denk- und Generierungsleistung.
• MCP ergänzt externe Werkzeuge und Datenquellen, etwa Datenbanken, gehostete Dienste oder interne Systeme.
• Cline Rules beschreiben Coding-Standards, Architekturgrenzen, Testanforderungen und Arbeitsweisen des Projekts.

MCP ersetzt die Modell-API nicht. Eine zuverlässige Reihenfolge ist: zuerst die API anbinden und den Lesetest bestehen, anschließend Projektregeln ergänzen und erst danach vertrauenswürdige MCP-Server für konkrete Aufgaben verbinden. MCP-Zugangsdaten gehören in Umgebungsvariablen oder einen sicheren Secret Store, nicht ins Repository.

Wie die Kosten bei Cline entstehen

Cline ist Open Source, doch die Modellausführung benötigt Rechenleistung. Cline bietet mehrere Zugangswege, darunter integrierte nutzungsabhängige Abrechnung, Abonnements und BYOK. BetterToken wird als eigene API angebunden; die endgültigen Kosten ergeben sich daher aus den tatsächlichen Anfragen an das gewählte Modell.

Zum Verbrauch können gehören:

• input tokens: Prompts, Projektdateien, Regeln und Aufgabenverlauf;
• output tokens: Antworten, erzeugter Code und Inhalte von tool calls;
• cache tokens: nur, wenn Modell und Endpunkt Caching unterstützen.

Die in Cline angezeigten Kosten sind in der Regel eine Schätzung. Maßgeblich sind die Abrechnung des Anbieters oder das BetterToken Dashboard. So vermeiden Sie unnötigen Verbrauch:

• pro Aufgabe nur ein überprüfbares Ziel festlegen;
• nicht ohne Grund das gesamte Repository laden;
• erst suchen und lesen, dann umfangreiche Änderungen anfordern;
• bei einem Themenwechsel eine neue Aufgabe beginnen;
• vor einem langen Lauf den aktuellen Modellpreis prüfen;
• für einfache Arbeiten ein schnelleres, günstigeres Modell mit zuverlässigem tool calling verwenden;
• größere Änderungen zuerst planen, damit keine kostspielige Nacharbeit entsteht.

Häufige Fehler und ihre Behebung

Symptom	Zuerst prüfen
401, Unauthorized oder Invalid API Key	Schlüssel, Leerzeichen am Anfang/Ende und mögliche Sperrung
404	Base URL exakt https://www.bettertoken.ai/v1, ohne Endpunkt-Suffix
model not found	Aktuelle Model ID mit identischer Groß-/Kleinschreibung und Zeichensetzung
Alte Einstellung bleibt aktiv	Speichern, Erweiterung oder VS Code neu laden und neue Aufgabe erstellen
Verbindung schlägt ständig fehl	Lokales Netzwerk, Proxy, Firewall und DNS zum Endpunkt
Antwort vorhanden, Dashboard leer	Aktiver Provider, Konto, alte Umgebungsvariablen und Base URL
Unerwartete Ausgabe oder fehlerhafte Tools	Eignung des Modells für Agent/tool calling und korrekte Modellparameter
Token-Verbrauch steigt sehr schnell	Zu großer Kontext, langer Verlauf oder wiederholtes Lesen derselben Dateien

Ändern Sie jeweils nur eine Variable. Bestätigen Sie zuerst Provider, Base URL, Schlüssel und Model. Erst danach sollten Sie Kontextfenster, Ausgabelimit, Header oder Proxy anpassen.

Für welche Aufgaben Cline gut geeignet ist

Cline eignet sich besonders für:

• das Verstehen eines unbekannten Moduls und das Auffinden zugehöriger Dateien;
• die Behebung eines klar begrenzten Bugs mit Reproduktionsschritten oder vorhandenem Test;
• konsistente Änderungen über mehrere Dateien hinweg;
• das Ausführen von lint, build oder Tests und das Erklären von Fehlern;
• die Umsetzung einer klar abgegrenzten Funktion nach bestehenden Mustern;
• MCP-Werkzeugaufrufe unter einer eindeutigen Zugriffsrichtlinie.

Ein praxisnaher Prompt:

Ziel: Die Bestellliste um einen Statusfilter erweitern.
Erlaubter Umfang: die Seite der Bestellliste, unmittelbar verwendete Abfrageparameter und zugehörige Tests.
Nicht durchführen: das Bestellmodul nicht refaktorisieren, keine Abhängigkeiten aktualisieren und die Zahlungslogik nicht ändern.
Abnahmekriterien: Benutzer können einen Status auswählen und sehen die richtigen Ergebnisse; der Filter bleibt nach dem Neuladen der Seite erhalten.
Prüfung: die Tests der Bestellliste ausführen und nach erfolgreichem Lauf stoppen.

Für eine einzelne kurze Frage ist Cline möglicherweise unnötig. Ein hochsensibles Repository sollte der Agent nicht ohne Isolation und Richtlinien vollständig lesen dürfen. Für feste, wiederholte und unbeaufsichtigte Abläufe sind CLI- oder CI-Integrationen oft sinnvoller als ein dauerhaft geöffnetes VS Code.

Häufig gestellte Fragen

Was ist Cline AI?

Cline ist ein quelloffener KI-Programmieragent für Editoren und Terminals. Er kann Code lesen, Dateien bearbeiten, Befehle ausführen, den Browser verwenden und MCP aufrufen. Eine externe Modell-API liefert Analyse und Generierung, während das Berechtigungssystem die Werkzeugnutzung unter Benutzerkontrolle hält.

Sind ClineAI, Cline agent und Cline dasselbe?

In Suchanfragen bezeichnen diese Begriffe üblicherweise denselben Programmieragenten. Der offizielle Produktname lautet Cline.

Funktioniert Cline in VS Code?

Ja. Die offizielle Erweiterung läuft in der VS-Code-Seitenleiste und zeigt Unterhaltung, Diffs, Aufgabenstatus und Freigabeanfragen.

Wie verbinde ich eine eigene API mit Cline?

Wählen Sie in den Cline-Einstellungen den passenden Provider. Für BetterToken wählen Sie OpenAI Compatible, tragen https://www.bettertoken.ai/v1, Ihren API Key und die exakte aktuelle Model ID ein, speichern und laden die Erweiterung neu.

Benötige ich ein Cline-Abonnement?

Nicht zwingend. Cline unterstützt unterschiedliche Modellzugänge, darunter eigene Abrechnungswege und externe API Keys. Die passende Variante hängt von Konto, Region, Modellen und Budget ab.

Worin unterscheiden sich Cline und MCP?

Cline ist der Agent, der die Aufgabe ausführt. Die Modell-API liefert Intelligenz, MCP ergänzt externe Werkzeuge und Daten. Diese Ebenen arbeiten zusammen und ersetzen einander nicht.

Ist Cline sicher?

Das hängt von Berechtigungen, Prompt, Modell, MCP-Servern und Umgebung ab. Minimale Rechte, Befehlsprüfung, Git, isolierte Secrets und ein standardmäßig deaktivierter YOLO Mode reduzieren das Risiko deutlich.

Fazit

Cline ist mehr als ein Chatfenster in VS Code. Der Agent verbindet Projektkontext, Dateiänderungen, Terminalbefehle und überprüfbare Diffs in einem Arbeitsablauf. Der richtige Einstieg ist: offizielle Erweiterung installieren, eine Modell-API konfigurieren, einen Lesetest bestehen und Bearbeitungs-, Terminal-, Browser- und MCP-Rechte nur bei tatsächlichem Bedarf erweitern.

Mit BetterToken verwenden Sie OpenAI Compatible, die Base URL https://www.bettertoken.ai/v1, Ihren eigenen API Key und eine aktuelle gültige Model ID. Beginnen Sie mit einer kleinen, klaren Aufgabe und behandeln Sie jede zusätzliche Berechtigung als bewusste Entscheidung.

Weiterführende Informationen:

• Offizieller Cline-Überblick
• Cline installieren
• OpenAI-Compatible-Anbieter in Cline
• BetterToken-Anleitung für Cline
• BetterToken-Konto erstellen