# Cline CLI nutzen: Schritt-für-Schritt-Anleitung für Cline im Terminal URL: https://agentvera.dev/de/blog/how-to-use-cline-cli/ · Veröffentlicht: 2026-11-15 Cline CLI nutzen: per npm installieren, anmelden oder eigenen Key nutzen, zwischen Plan und Act wechseln, headless mit --json laufen lassen, Regeln und MCP einrichten. **Kurz gesagt:** - Installiere mit npm install -g cline, melde dich mit cline auth bei einem Cline-Konto an oder hinterlege einen eigenen Key, starte dann cline im Projekt und beschreibe die Aufgabe. Tab wechselt zwischen Plan und Act. - Rückfragen sind standardmäßig aus: --auto-approve ist true, und Einmal-Läufe oder Eingaben per Pipe laufen im Yolo-Modus. Mit --auto-approve false fragt Cline vor jedem Tool nach. - Die CLI ist kostenlos; Inferenz zahlst du per Cline-Credits, ClinePass (9,99 $ im Monat, Stand November 2026) oder eigenen API-Keys. Regeln gehören in .clinerules/ oder AGENTS.md, MCP-Server in cline_mcp_settings.json. 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](https://cline.bot "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 ```bash npm install -g cline ``` Das 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 ```bash cline auth ``` Damit 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: ```bash cline auth -p anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5 ``` Cline 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 ```bash cd my-project cline ``` Beschreibe 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: - `Tab` wechselt 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 -p` startet im Plan-Modus. - `Shift+Tab` schaltet Auto-Approve ein oder aus. - `@file` hängt eine Datei (oder ein Bild) an die Nachricht an. - `/model` und `/settings` ändern die Einrichtung; `/mcp` verwaltet Server; `/compact` kürzt eine lange Unterhaltung; `/undo` macht die letzte Änderung rückgängig; `/history` öffnet frühere Sitzungen. - `Ctrl+C` stoppt den aktuellen Durchgang; zweimal drücken oder `Ctrl+D` beendet 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: ```bash 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: ```bash cline history --json --limit 10 cline --id ``` Sitzungen liegen in `~/.cline/data/sessions/`. `cline history export -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](/de/blog/claude-md-agents-md/ "CLAUDE.md und AGENTS.md"). **Skills und Hooks.** Skills liegen in `.cline/skills/` oder `.agents/skills/` und laufen als `/skill-name`; `cline skill add ` 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: ```bash cline mcp add memory --yes -- npx -y @modelcontextprotocol/server-memory cline mcp add docs https://example.com/mcp --transport http --yes ``` Sie werden unter `mcpServers` in `~/.cline/data/settings/cline_mcp_settings.json` gespeichert. `cline mcp` öffnet ein Menü, und `cline mcp remove ` 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](https://cline.bot/pricing "Cline-Preise"). ## Häufige Stolperfallen - **Auto-Approve ist standardmäßig an.** Schalte es mit `--auto-approve false` aus, 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 --help` für deine Version aus; einige Flags wie `-y` fehlen 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 ` aus. - **Hängende Hintergrundprozesse.** `cline doctor` prüft die Einrichtung, und `cline doctor fix` beendet verwaiste Prozesse. - **`.clineignore` läuft aus.** Nutze einen `PreToolUse`-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](/de/ "AgentVera") ist eine Desktop-App, die diese CLIs nebeneinander in echten Terminals ausführt, mit deinen eigenen Installationen und Keys. Die [Cline-Unterstützung](/de/agents/cline/ "Cline CLI in AgentVera") funktioniert so: - **Eine Sitzung pro Agent.** AgentVera findet die Sitzung, die Cline anlegt, über `cline history --json` und öffnet sie bei späteren Starts mit `cline --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](/de/features/mcp-manager/ "MCP-Manager") von AgentVera erreichen Cline über dessen MCP-Einstellungsdatei, und AgentVera liest Clines Token-Verbrauch für die [Token-Budgets](/de/features/token-budgets/ "Token-Budgets") aus. - **Bereiche und Review.** Führe Cline im Raster des [Workspace](/de/features/workspace/ "Workspace") neben anderen Agenten aus und prüfe ihre Änderungen mit dem [Code-Review](/de/features/code-review/ "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](/de/download/ "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](https://docs.cline.bot/cli/cli-reference "Cline-CLI-Referenz"), [CLI-Überblick](https://docs.cline.bot/usage/cli-overview "Überblick über Cline CLI"), [Autorisierung](https://docs.cline.bot/getting-started/authorizing-with-cline "Autorisierung mit Cline"), [Cline-Regeln](https://docs.cline.bot/customization/cline-rules "Cline-Regeln"), [MCP](https://docs.cline.bot/mcp/mcp-overview "Cline MCP"), [CLI-Changelog](https://github.com/cline/cline/blob/main/apps/cli/CHANGELOG.md "Cline-CLI-Changelog"). ## Häufige Fragen **Ist Cline CLI kostenlos?** Die CLI selbst kostet nichts. Bezahlt wird das Modell: mit Cline-Credits von app.cline.bot, einem ClinePass-Abo (9,99 $ im Monat, Stand November 2026, für ausgewählte offene Modelle) oder deinem eigenen API-Key von Anthropic, OpenAI, OpenRouter und vielen weiteren Anbietern. Einige kostenlose Modelle haben ein kleines Kontingent. **Fragt Cline CLI, bevor es Dateien ändert?** Standardmäßig nicht. --auto-approve ist auf true gesetzt, und ein Einmal-Lauf wie cline "task" läuft im Yolo-Modus. Starte mit --auto-approve false, um für jedes Tool eine Ja/Nein-Abfrage zu bekommen, oder schalte Auto-Approve in der interaktiven Ansicht mit Shift+Tab um. **Wie setze ich eine Cline-CLI-Sitzung fort?** Mit cline history wählst du eine frühere Sitzung aus einer Liste, mit cline --id öffnest du sie direkt. cline history --json listet die Sitzungen mit ihren IDs auf, was in Skripten praktisch ist. **Liest Cline CLI AGENTS.md?** Ja. Neben den eigenen Regelordnern (.clinerules/ oder .cline/rules/ im Projekt, ~/.cline/rules global) liest Cline AGENTS.md im Projektstamm sowie .cursorrules und .windsurfrules. **Kann ich mein Claude-Code- oder ChatGPT-Abo mit Cline CLI nutzen?** Cline führt unter seinen Anbietern einen Claude-Code-Provider und eine ChatGPT-Anmeldung (openai-codex). Prüfe die Bedingungen des Anbieters, bevor du ein Abo über ein anderes Tool nutzt. --- **Über AgentVera.** AgentVera ist eine Desktop-App für macOS, Windows und Linux, entwickelt von Solviera Teknoloji. Sie führt 18 KI-Coding-Agenten (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) nebeneinander aus, pro Projekt, in echten Terminals mit den eigenen CLI-Installationen und Logins des Nutzers. Der kostenlose Plan führt 2 Agenten gleichzeitig aus. Download: https://agentvera.dev/de/download/ · Preise: https://agentvera.dev/de/pricing/