Um Cline CLI zu nutzen, installierst du es mit npm install -g cline, meldest dich mit cline auth an oder hinterlegst einen Anbieter-Key, startest dann cline in einem Projekt und beschreibst die Aufgabe. Anders als die meisten Coding-CLIs genehmigt Cline seine eigenen Tool-Aufrufe standardmäßig selbst. Bei einem Repository, das dir wichtig ist, solltest du also --auto-approve false übergeben.
Diese Anleitung behandelt Cline CLI 3.0 mit Stand November 2026 (Version 3.0.74): Installation, Anmeldung, Plan und Act, Freigaben, Headless-Läufe mit --json, Sitzungen, Modelle, Regeln, MCP und Kosten.
Was Cline CLI ist
Cline begann als VS-Code-Erweiterung und gehört zu den meistgenutzten offenen Coding-Agenten. Cline CLI bringt denselben Agenten ins Terminal. Version 3.0 erschien im Mai 2026 als Neuentwicklung auf Clines neuem SDK mit einer neuen Terminaloberfläche; Anleitungen für die 2.x-CLI sind damit veraltet.
Cline ist an kein Modell gebunden. Du kannst ein Cline-Konto mit Credits, ein ClinePass-Abo oder deinen eigenen Key für Anthropic, OpenAI, Gemini, OpenRouter, Bedrock, Vertex, DeepSeek, ein lokales Modell über Ollama oder LM Studio und mehr als dreißig weitere Anbieter verwenden.
Schritt 1: die CLI installieren
npm install -g clineDas ist der einzige offizielle Installationsweg. Fertige Binärdateien gibt es für macOS, Linux und Windows, jeweils für arm64 und x64. Nimm sicherheitshalber Node 22, denn Doku und Paket nennen unterschiedliche Mindestversionen. Später aktualisierst du mit cline update. Wer den neuesten Build will, installiert mit npm install -g cline@nightly den Nightly-Kanal.
Schritt 2: anmelden oder einen Key hinzufügen
cline authDamit startet eine interaktive Einrichtung. cline auth cline meldet dich im Browser bei einem Cline-Konto an. Um einen Anbieter ohne Rückfragen festzulegen, etwa auf einem Server:
cline auth -p anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5Cline liest Keys auch aus der Umgebung (ANTHROPIC_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY, CLINE_API_KEY und weitere). Gespeicherte Zugangsdaten landen in ~/.cline/data/settings/providers.json.
Schritt 3: in der interaktiven Ansicht arbeiten
cd my-project
clineBeschreibe die Aufgabe in normalen Worten oder gib sie gleich beim Start mit: cline -i "add tests for the price formatter". Nützliche Tasten und Befehle:
Tabwechselt zwischen Plan und Act. Im Plan-Modus liest und diskutiert Cline, kann aber keine Dateien ändern; der Act-Modus, die Voreinstellung, setzt die Änderungen um.cline -pstartet im Plan-Modus.Shift+Tabschaltet Auto-Approve ein oder aus.@filehängt eine Datei (oder ein Bild) an die Nachricht an./modelund/settingsändern die Einrichtung;/mcpverwaltet Server;/compactkürzt eine lange Unterhaltung;/undomacht die letzte Änderung rückgängig;/historyöffnet frühere Sitzungen.Ctrl+Cstoppt den aktuellen Durchgang; zweimal drücken oderCtrl+Dbeendet Cline.
Eine gute Gewohnheit bei größeren Aufgaben: im Plan-Modus anfangen, sich auf die Schritte einigen und dann zu Act wechseln.
Schritt 4: festlegen, wie viel Cline allein darf
Diese Einstellung überrascht die meisten. In Cline CLI gilt:
| Situation | Was passiert |
|---|---|
cline (interaktiv) | --auto-approve ist an, solange du es nicht ausschaltest |
cline --auto-approve false | Fragt vor jedem Tool Approve tool …? [y/N] |
cline "task" (Einmal-Lauf) oder Eingabe per Pipe | Läuft im Yolo-Modus |
cline -y | Yolo-Modus; Clines eigene Hilfe nennt ihn außerhalb einer Sandbox gefährlich |
Eine Allow- oder Deny-Liste für Shell-Befehle gibt es nicht. Um einen Befehl zu blockieren, fügst du einen PreToolUse-Hook hinzu (Schritt 7). In einem echten Repository startest du am besten mit --auto-approve false oder arbeitest auf einem sauberen Branch, damit sich jede Änderung leicht verwerfen lässt.
Schritt 5: Headless-Läufe und CI
Cline läuft ohne interaktive Ansicht, wenn du --json übergibst, etwas per Pipe hineinleitest oder die Ausgabe umleitest:
git diff | cline "review this diff for bugs"
cline --json "summarize the changes on this branch" | jq -r 'select(.type=="run_result") | .text'--json gibt pro Zeile ein JSON-Ereignis aus und endet mit einem run_result, das den finalen Text, den Abschlussgrund und den Token-Verbrauch enthält. Weitere nützliche Flags: -c setzt den Arbeitsordner, --worktree läuft in einem git worktree, -t setzt ein Timeout in Sekunden und --data-dir hält den Zustand in einem isolierten Ordner.
In CI installierst du per npm, führst cline auth mit einem Key aus dem Secrets-Speicher aus und startest dann die Aufgabe. Denk daran, dass Einmal-Läufe alles genehmigen; gib dem Job also nur die Rechte, die er braucht.
Schritt 6: Sitzungen und Modelle
cline history listet frühere Sitzungen in einer Auswahl auf, in der du sie fortsetzen oder löschen kannst. Um eine direkt zu öffnen:
cline history --json --limit 10
cline --id <session-id>Sitzungen liegen in ~/.cline/data/sessions/. cline history export <session-id> -o session.html speichert eine als Seite.
Um für einen einzelnen Lauf ein Modell zu wählen, nutzt du -P für den Anbieter und -m für das Modell; --thinking nimmt none, low, medium, high oder xhigh. In der interaktiven Ansicht geht das mit /model. Mit einem Cline-Konto und ohne gewähltes Modell ist seit Version 3.0.73 Claude Sonnet 5.5 voreingestellt.
Schritt 7: Regeln, Hooks und MCP-Server
Regeln. Projektregeln gehören in .clinerules/ oder .cline/rules/, globale in ~/.cline/rules. Cline liest außerdem AGENTS.md im Projektstamm, eine Datei, die du schon für Codex oder andere Agenten pflegst, funktioniert also unverändert. Was hineingehört, erklärt unsere Anleitung zu CLAUDE.md und AGENTS.md.
Skills und Hooks. Skills liegen in .cline/skills/ oder .agents/skills/ und laufen als /skill-name; cline skill add <owner/repo> installiert einen. Hooks sind ausführbare Skripte, die nach dem Ereignis benannt sind, etwa .cline/hooks/PreToolUse.sh, und mit ihnen blockierst du riskante Befehle.
MCP. Server fügst du über die Kommandozeile hinzu:
cline mcp add memory --yes -- npx -y @modelcontextprotocol/server-memory
cline mcp add docs https://example.com/mcp --transport http --yesSie werden unter mcpServers in ~/.cline/data/settings/cline_mcp_settings.json gespeichert. cline mcp öffnet ein Menü, und cline mcp remove <name> löscht einen Server.
Was Cline CLI kostet (Stand November 2026)
| Option | Preis | Hinweise |
|---|---|---|
| Cline CLI | Kostenlos | Das Tool selbst |
| Cline-Credits | Nach Verbrauch | Gekauft auf app.cline.bot; einige kostenlose Modelle mit kleinem Kontingent |
| ClinePass | 9,99 $/Monat | Höhere Limits für ausgewählte offene Modelle |
| Eigener Key | Preis deines Anbieters | Anthropic, OpenAI, OpenRouter, lokale Modelle und mehr |
| Enterprise | Individuell | SSO, SLA, rollenbasierter Zugriff, zentrale Abrechnung |
Wirf vor der Entscheidung einen Blick auf Clines Preisseite.
Häufige Stolperfallen
- Auto-Approve ist standardmäßig an. Schalte es mit
--auto-approve falseaus, bis du der Einrichtung vertraust. - Anleitungen für 2.x folgen. Die Neuentwicklung 3.0 hat Befehle und Flags geändert. Im Zweifel führst du
cline --helpfür deine Version aus; einige Flags wie-yfehlen in der Online-Referenz. - OAuth im Headless-Betrieb. OAuth-Anbieter öffnen bei Headless-Läufen nie einen Browser. Führe auf diesem Rechner zuerst einmal
cline auth <provider>aus. - Hängende Hintergrundprozesse.
cline doctorprüft die Einrichtung, undcline doctor fixbeendet verwaiste Prozesse. .clineignoreläuft aus. Nutze einenPreToolUse-Hook, um Cline von Dateien fernzuhalten.
Cline CLI neben anderen CLIs in AgentVera ausführen
Wenn Cline dein einziger Agent ist, reicht dir seine eigene Oberfläche vielleicht völlig. Schwieriger wird es, wenn Cline neben Claude Code, Codex oder Gemini CLI im selben Projekt läuft. AgentVera ist eine Desktop-App, die diese CLIs nebeneinander in echten Terminals ausführt, mit deinen eigenen Installationen und Keys. Die Cline-Unterstützung funktioniert so:
- Eine Sitzung pro Agent. AgentVera findet die Sitzung, die Cline anlegt, über
cline history --jsonund öffnet sie bei späteren Starts mitcline --id <id>wieder, sodass die Unterhaltung einen Neustart der App übersteht. - Modell und Aufwand. Das gewählte Modell wird mit
--modelübergeben, die Aufwandsstufe mit--thinking. - Ein Konto pro Agent. Unter Einstellungen → Konten kannst du Keys für Anthropic, OpenAI oder OpenRouter hinzufügen; jedes Cline-Konto bekommt eine eigene Anbieterdatei, alles andere bleibt gemeinsam.
- MCP und Tokens. Server aus dem MCP-Manager von AgentVera erreichen Cline über dessen MCP-Einstellungsdatei, und AgentVera liest Clines Token-Verbrauch für die Token-Budgets aus.
- Bereiche und Review. Führe Cline im Raster des Workspace neben anderen Agenten aus und prüfe ihre Änderungen mit dem Code-Review.
Der kostenlose Plan führt 2 Agenten gleichzeitig aus und umfasst MCP, Git, Docker, SSH, Code-Review und Token-Einsparungen. Pro kostet 9,99 $ im Monat und hat kein Agentenlimit; wenn du noch nie eine Testphase hattest, schaltet deine erste Anmeldung in der App Pro für 7 Tage frei, ohne Karte. Zum Ausprobieren: AgentVera herunterladen.
Fazit
Für den Start mit Cline CLI reichen drei Befehle: npm install -g cline, cline auth und cline. Die wichtigen Entscheidungen folgen direkt danach: Schalte Auto-Approve bei echter Arbeit aus, plane bei größeren Aufgaben, bevor du handelst, halte die Projektregeln in AGENTS.md oder .clinerules/ und gib Einmal-Läufen in CI nur den Zugriff, den sie brauchen.
Quellen: Cline-CLI-Referenz, CLI-Überblick, Autorisierung, Cline-Regeln, MCP, CLI-Changelog.