Claude CLI installieren und starten — die komplette Anleitung

Claude CLI, offiziell Claude Code, ist das agentische Coding-Tool von Anthropic, das direkt in deinem Terminal läuft. Es liest deine Codebase, plant Aufgaben und führt sie eigenständig aus, statt dir nur einzelne Snippets vorzuschlagen. Installiert ist es in ein paar Minuten, über npm, den nativen Installer oder Homebrew. Hier bekommst du Konto, Installation, Login und die ersten Befehle in einem Rutsch.

Was ist Claude CLI

Claude CLI ist die Befehlszeilenschnittstelle von Claude Code, dem KI-gestützten Codierassistenten von Anthropic. Du installierst es einmal, öffnest dein Terminal im Projektordner und redest in normaler Sprache mit deiner Codebase. Anthropic beschreibt es als agentisches Coding-Tool: Es versteht nicht nur einzelne Zeilen, sondern den Zusammenhang deines Projekts und arbeitet Aufgaben selbstständig ab.

Der Unterschied zu einem klassischen Autocomplete ist der Ansatz. Ein normaler Code-Generator wirft dir Vorschläge hin, und du baust sie von Hand zusammen. Claude Code CLI dagegen liest die relevanten Dateien, plant die Schritte, ändert mehrere Dateien gleichzeitig und führt bei Bedarf sogar Befehle aus. Es ist weniger ein Werkzeug, das du bedienst, und mehr ein Mitarbeiter, dem du eine Aufgabe gibst.

Und genau da liegt der wirtschaftliche Punkt. Wenn du dein Geschäft führst und nicht den ganzen Tag im Code sitzt, ist der Wert nicht "cooleres Tool", sondern eingesparte Entwicklerstunden bei Routine-Arbeit. Wer die groben Zusammenhänge findet und in alle Claude Code Themen im Überblick tiefer einsteigt, spart sich das Ausprobieren im Trüben.

Claude CLI als agentisches Coding-Tool verstehen

Agentisch heißt: Das Tool plant und handelt, statt nur zu antworten. Statt dass du jede Datei einzeln öffnest, arbeitet Claude direkt in deiner Codebase und im Terminal, sucht selbst die passenden Stellen und schlägt konkrete Änderungen vor.

Praktisch merkst du das an einer typischen Aufgabe. Du sagst "finde raus, warum das Login bei abgelaufenen Sessions abstürzt, und behebe es". Ein reiner Generator bräuchte von dir die betroffene Datei. Claude Code durchsucht das Projekt selbst, liest die relevanten Module, formuliert einen Plan und setzt ihn nach deinem Okay um. Diese Eigenständigkeit ist der Grund, warum sich das im Alltag rechnet: Weniger Kontext, den du manuell zusammensuchst, bedeutet weniger Reibung pro Aufgabe.

Claude CLI vs. Claude.ai Chat: der Unterschied

Was genau macht Claude im Terminal anders als im Chat? Der Chat auf claude.ai kennt nur, was du reinkopierst. Claude CLI dagegen hat direkten Zugriff auf dein Projekt: Es liest Dateien, ändert sie, führt Befehle aus und behält den Überblick über die ganze Codebase. Der Chat ist zum Nachdenken da, der CLI zum Arbeiten.

Der praktische Unterschied wird schnell greifbar. Im Chatfenster bist du der Kurier: Du kopierst Code rein, kopierst die Antwort raus, fügst sie im Editor ein, testest, kopierst den Fehler zurück. Bei einem kleinen Snippet ist das okay. Bei einem echten Projekt mit dreißig Dateien wird dieses Hin und Her zur Zeitfalle, und genau dort verlierst du als Nicht-Vollzeit-Entwickler am meisten.

Claude CLI kürzt diese Schleife ab. Es sieht die Dateien direkt, macht die Änderung an Ort und Stelle und kann den Test gleich mitlaufen lassen. Du bleibst der Chef, der freigibt, aber du bist nicht mehr der Copy-Paste-Bote.

Voraussetzungen: Welches Konto du für Claude CLI brauchst

Bevor du dich fragst "was brauche ich für einen Claude Code Start", die kurze Antwort: ein Anthropic-Konto mit passendem Zugang und ein System mit Terminal. Der entscheidende Punkt, an dem viele beim claude code getting started hängen bleiben: Der kostenlose Plan reicht nicht. Du brauchst ein bezahltes Abo oder ein Konto mit abgerechneter API-Nutzung.

Welches Claude-Abo brauchst du für den CLI

Für die meisten Einzelnutzer ist ein Pro- oder Max-Abo der einfachste Weg, weil die Claude-Code-Nutzung dort in einem festen Monatspreis steckt. Du meldest dich später mit demselben Konto an, mit dem du dich auch im Web einloggst, und der CLI zieht seine Berechtigung daraus.

Die Alternative ist die reine API-Abrechnung über die Anthropic Console. Dabei zahlst du pro Nutzung, was sich lohnt, wenn du sehr unregelmäßig arbeitest, und teuer wird, wenn du intensiv nutzt. Für Teams gibt es Team- und Enterprise-Zugänge mit zentraler Verwaltung. Meine ehrliche Empfehlung, wenn du dein Geschäft führst und die Kosten kalkulierbar halten willst: Fang mit dem Abo an, das planbar ist, und wechsle erst auf API-Abrechnung, wenn du deinen echten Verbrauch kennst.

System-Anforderungen: macOS, Linux oder Windows

Claude CLI läuft auf macOS, auf gängigen Linux-Distributionen wie Ubuntu und auf Windows, wobei Windows am saubersten über WSL läuft. Für die Installation per npm brauchst du eine aktuelle Node.js-Version (18 oder neuer). Für den nativen Installer brauchst du gar kein Node, das Paket bringt alles mit.

Ein Terminal und eine Internetverbindung sind Pflicht, weil die eigentliche Arbeit in der Cloud passiert. Für größere Firmen mit eigener Cloud-Infrastruktur gibt es zusätzlich die Anbindung über Amazon Bedrock oder Google Vertex AI, sodass die Anfragen über deine bestehende Cloud-Umgebung laufen statt direkt über Anthropic. Das ist der Weg für Unternehmen mit strengen Compliance-Vorgaben, für den Einstieg brauchst du das nicht.

Claude CLI installieren: macOS, Windows und Linux

Die Claude Code Installation dauert auf jedem System nur wenige Minuten. Es gibt zwei Hauptwege: den nativen Installer per Skript, der alles Nötige mitbringt, und die Installation über npm, wenn du ohnehin mit Node.js arbeitest. Unten findest du für macOS, Windows und Linux jeweils den konkreten Befehl.

Ein Hinweis vorweg, weil es Zeit spart. Installiere Claude Code nie mit sudo. Wenn dir ein Rechteproblem begegnet, ist fast immer die npm-Konfiguration die Ursache und nicht fehlende Root-Rechte. Der native Installer umgeht dieses Thema komplett, deshalb ist er für die meisten der ruhigere Weg.

Claude CLI auf macOS installieren

Auf dem Mac ist der native Installer der schnellste claude code quick start. Du öffnest das Terminal und führst diesen dokumentierten Befehl aus:

curl -fsSL https://claude.ai/install.sh | bash

Das Skript lädt die passende Version, richtet sie ein und legt den Befehl claude an. Danach testest du mit claude --version, ob alles sitzt.

Wenn du lieber über npm gehst, weil du Node.js sowieso pflegst, ist das der Standard-Weg für die claude install:

npm install -g @anthropic-ai/claude-code

Und für alle, die ihre Tools über Homebrew verwalten: Anthropic dokumentiert primär den nativen Installer und npm, über Homebrew ist die Installation aber ebenfalls möglich, sodass du sie in deine bestehende brew-Routine einreihen kannst. Der wirtschaftliche Vorteil vom Paketmanager-Weg ist banal, aber real: Updates laufen dann über denselben Prozess wie dein restliches System, und du vergisst sie seltener.

Claude CLI unter Windows einrichten (WSL & WinGet)

Für die Installation von Claude Code unter Windows hast du zwei saubere Wege. Der von vielen bevorzugte ist WSL, also das Windows-Subsystem für Linux, weil du damit in einer echten Linux-Umgebung arbeitest und alle Befehle so laufen wie in der Linux-Anleitung. Innerhalb von WSL nutzt du dann entweder den nativen Installer oder npm, genau wie oben.

Der direkte Windows-Weg läuft über WinGet, den Paketmanager von Microsoft:

winget install --id Anthropic.ClaudeCode

Wenn du claude cli windows ohne WSL fahren willst, brauchst du zusätzlich Git Bash, weil Claude Code eine Bash-Umgebung erwartet. Für die meisten ist WSL trotzdem der reibungsärmere Start, gerade wenn du später ohnehin mit Linux-Tools arbeitest. Mein Punkt: Wähl den Weg, den dein Team eh schon nutzt, und bau dir keine Extra-Baustelle nur fürs Prinzip.

Claude CLI auf Linux und Ubuntu installieren

Unter Claude Code Linux, egal ob Ubuntu, Debian oder eine andere gängige Distribution, ist der native Installer der direkteste claude cli download. Ein Befehl im Terminal, und die Sache läuft:

curl -fsSL https://claude.ai/install.sh | bash

Für claude code ubuntu ist das der Weg, den ich empfehle, weil du dir das Node-Setup sparst. Wer Node.js ohnehin gepflegt hat, kann den claude cli install auch klassisch über npm machen:

npm install -g @anthropic-ai/claude-code

Nach dem install claude cli prüfst du mit claude doctor, ob die Umgebung sauber ist. Der Befehl zeigt dir, ob Version, Pfade und Berechtigungen stimmen, und erspart dir das Rätselraten, falls beim ersten Start etwas hakt. So ein Vorab-Check hat mir in fünfzehn Jahren mehr Debugging-Abende gespart, als ich zählen kann.

Claude CLI einloggen: Authentifizierung nach der Installation

Nach der Installation folgt der Schritt, den kaum eine Anleitung sauber trennt: der claude cli login. Du startest im Projektordner einfach den Befehl claude, und beim ersten Aufruf leitet dich das Tool durch die Anmeldung. In der Regel öffnet sich dein Browser, du bestätigst mit deinem Anthropic-Konto, und die CLI merkt sich die Berechtigung.

Du hast dabei zwei Wege, und die Wahl hängt an deinem Konto. Wenn du ein Pro- oder Max-Abo hast, meldest du dich mit genau diesem Login an, und die Nutzung läuft über dein Abo. Arbeitest du stattdessen mit API-Abrechnung, hinterlegst du einen API-Key aus der Anthropic Console. Innerhalb einer Session kannst du die Anmeldung jederzeit mit dem Befehl /login neu anstoßen oder das Konto wechseln.

Ist der Login durch, lohnt sich direkt der nächste Schritt. Mit /init im Projektordner lässt du Claude eine Projektdatei anlegen, in der die wichtigsten Infos zu deiner Codebase stehen. Der claude code init ist der Moment, in dem das Tool von "kennt nichts" auf "kennt dein Projekt" springt, und das zahlt sich bei jeder folgenden Aufgabe aus, weil du den Kontext nicht mehr jedes Mal erklärst.

Erste Session starten: Claude CLI in der Praxis

Deine erste Session startest du mit dem Befehl claude im Ordner deines Projekts. Von da an redest du in normaler Sprache. Du beschreibst, was du willst, Claude schlägt Änderungen vor, und du gibst sie frei. Genau dieser Freigabe-Schritt ist der Grund, warum das Tool auch für weniger geübte Entwickler funktioniert.

Für ein erstes claude code tutorial im Kleinen: Öffne ein bestehendes Projekt und gib eine überschaubare Aufgabe ein, etwa "erklär mir, was diese Datei macht" oder "schreib einen Test für diese Funktion". Du siehst dann, wie Claude die relevanten Stellen selbst findet, einen Plan zeigt und erst nach deinem Okay Dateien anfasst. Fang bewusst klein an. Ich hab genug Tools gesehen, die man mit einer Riesen-Aufgabe zumüllt und sich dann wundert, warum das Ergebnis wackelt. Kleine, klare Aufträge geben dir Kontrolle und ein Gefühl dafür, wo das Tool stark ist.

Die wichtigsten Tastenbefehle in der ersten Session

Innerhalb einer Session steuerst du vieles über sogenannte Slash-Befehle, die du mit einem Schrägstrich eintippst. /help zeigt dir die verfügbaren Kommandos, /clear setzt den Gesprächskontext zurück, wenn du das Thema wechselst, und /init legt die erwähnte Projektdatei an.

Der wichtigste Reflex am Anfang ist das saubere Beenden und Zurücksetzen. Wenn eine Aufgabe erledigt ist und du zu etwas völlig anderem springst, ist ein /clear Gold wert, weil Claude sonst alten Kontext mitschleppt und das Ergebnis verwässert. Mit der Escape-Taste unterbrichst du eine laufende Antwort, wenn du merkst, dass Claude in die falsche Richtung läuft. Diese kleinen Handgriffe klingen unspektakulär, aber sie entscheiden darüber, ob sich das Tool präzise oder chaotisch anfühlt.

Die wichtigsten Claude CLI-Befehle im Überblick

Wer wissen will, how to use claude code im Alltag, kommt mit einer Handvoll Befehle weit. Du startest mit claude, holst dir mit /help die Übersicht, hältst mit claude update die Version aktuell und prüfst mit claude doctor deine Umgebung. Alles Weitere passiert im Gespräch, in normaler Sprache.

Ein paar claude command-Bausteine, die sich schnell einprägen und die den größten Teil der täglichen Arbeit abdecken:

• claude startet eine interaktive Session im aktuellen Ordner.
• claude -p "deine Aufgabe" gibt eine Aufgabe direkt mit, ohne dass sich der interaktive Modus öffnet.
• claude update bringt die CLI auf den neuesten Stand.
• claude doctor prüft Installation, Pfade und Berechtigungen.
• /init, /clear und /help steuern eine laufende Session von innen.

Das claude code how to use ist damit weniger eine Frage von Befehlen und mehr eine Frage der Gewohnheit: Du beschreibst das Ziel, Claude findet den Weg, du gibst frei.

Claude CLI nicht-interaktiv und per Pipe nutzen

Der wirtschaftlich interessanteste Modus ist der nicht-interaktive. Mit claude -p "..." gibst du eine Aufgabe direkt mit und bekommst das Ergebnis zurück, ohne dass sich eine Session öffnet. Das eignet sich für Automatisierung, weil du diesen Aufruf in Skripte packen kannst.

Genauso funktioniert das Weiterreichen per Pipe. Du schickst den Inhalt einer Datei oder eines Befehls direkt an Claude:

cat fehler.log | claude -p "fasse die kritischen Fehler zusammen"

So verbindest du Claude mit deinem bestehenden Werkzeugkasten, egal ob im Terminal oder als Erweiterung deiner Arbeit in VS Code. Hier wird aus dem Assistenten ein Baustein in deinen Abläufen. Wenn du diesen Gedanken weiterspinnst, landest du schnell bei der Frage, wie du Workflows per KI automatisieren kannst, und genau da liegt für viele der eigentliche Zeitgewinn.

Claude CLI aktuell halten: Update-Prozess und Methoden

Der einfachste Weg für ein update claude code hängt davon ab, wie du installiert hast. Der native Installer aktualisiert sich in vielen Fällen selbst im Hintergrund. Zusätzlich kannst du jederzeit claude update ausführen, um manuell auf die neueste Version zu ziehen. Hast du über npm installiert, läuft das Update über den npm-Weg.

Konkret sieht das so aus. Bei einer npm-Installation aktualisierst du mit demselben Werkzeug, mit dem du installiert hast:

npm update -g @anthropic-ai/claude-code

Bei der nativen Installation genügt in der Regel claude update, und du bist auf dem aktuellen Stand. Mit claude doctor prüfst du danach, ob alles sauber sitzt.

Warum das mehr als Pflege ist: Diese Tools entwickeln sich rasant, und neue Versionen bringen oft spürbar bessere Ergebnisse bei gleicher Aufgabe. Solche Zyklen habe ich schon ein paar durchgemacht, damals bei den SEO-Updates war es dasselbe Spiel. Wer eine alte Version fährt, verschenkt Leistung, für die er ohnehin bezahlt. Ein Update pro Woche ist billiger als ein Nachmittag, den du mit einer schlechteren Version vergeudest.

Claude CLI im Alltag: Was sich wirklich lohnt

Claude CLI lohnt sich dann, wenn du wiederkehrende Code-Arbeit hast, die dich Zeit kostet, aber keine strategische Denkarbeit ist. Bugs eingrenzen, Tests schreiben, alten Code verstehen, kleine Features bauen: Das sind die Aufgaben, bei denen der agentische Assistent seinen Kontextvorteil ausspielt. Der Wert von Claude Code ist am Ende kein Feature, sondern zurückgewonnene Stunden pro Woche.

Ehrlich gesagt: Es ersetzt kein Verständnis. Du bleibst derjenige, der prüft und freigibt, und genau deshalb funktioniert es. Wenn du grob weißt, was richtig aussieht, verwandelt Claude CLI dein Terminal in einen Verstärker deiner eigenen Arbeit. Wenn du gar nichts vom Fach verstehst, wird es ein Blindflug. Für die Einordnung, welche KI-Tools sich wirklich lohnen, ist das die ehrlichste Trennlinie, die ich ziehen kann.

Häufige Fragen zu Claude CLI

Die kurzen Antworten auf die Fragen, die beim Einstieg in Claude CLI immer wieder aufkommen, zu Kosten, zur Abgrenzung von anderen Tools und zur Offline-Nutzung.

Ist Claude CLI kostenlos nutzbar?

Nein, der Free-Plan enthält keinen CLI-Zugang. Du brauchst ein bezahltes Abo (Pro, Max, Team oder Enterprise) oder ein Anthropic-Console-Konto mit abgerechneter API-Nutzung. Welcher Weg günstiger ist, hängt von deinem Verbrauch ab. Die aktuellen Konditionen findest du auf der offiziellen Anthropic-Preisseite, da sich die Pläne ändern können.

Claude CLI vs. Cursor: Welches Tool gewinnt?

Das ist keine Entweder-oder-Frage, weil beide unterschiedlich ansetzen. Cursor ist ein Editor mit eingebauter KI, Claude CLI ein agentischer Assistent direkt im Terminal. Wenn du gern in einer grafischen Oberfläche arbeitest, fühlt sich Cursor natürlicher an. Wenn du terminal-nah arbeitest und Aufgaben delegieren willst, passt der CLI besser. Viele nutzen beide je nach Aufgabe.

Kann ich Claude CLI offline verwenden?

Nein, offline geht nicht. Claude CLI schickt deine Anfragen an die Modelle in der Cloud, deshalb brauchst du durchgehend eine Internetverbindung. Lokal läuft nur die Bedienoberfläche im Terminal, die eigentliche Rechenarbeit passiert bei Anthropic beziehungsweise über deine angebundene Cloud, etwa Amazon Bedrock oder Google Vertex AI im Unternehmensumfeld.