Claude Code CLI: Die vollständige Anleitung für Entwickler

Claude Code CLI ist das offizielle Kommandozeilenwerkzeug von Anthropic, das dir erlaubt, direkt aus dem Terminal heraus mit Claude zu arbeiten. Statt einen Browser zu öffnen, kannst du Fragen stellen, Code schreiben, Dateien bearbeiten und ganze Projekte verwalten – alles ohne die Entwicklungsumgebung zu verlassen. In dieser Anleitung lernst du Schritt für Schritt, wie du das Tool installierst und sofort produktiv einsetzt.

Was ist Claude Code CLI und warum solltest du es nutzen?

Claude Code CLI verwandelt dein Terminal in einen intelligenten Entwicklungsassistenten. Du kannst damit Code analysieren, Fehler debuggen, Tests schreiben und komplexe Refactoring-Aufgaben automatisieren – direkt im Kontext deines Projekts. Das System hat dabei vollen Zugriff auf deine Dateien und versteht die Struktur deines Repositories.

Für Entwickler, die täglich viel Zeit im Terminal verbringen, ist das ein erheblicher Effizienzgewinn. Es gibt keinen Kontextwechsel zwischen Editor, Browser und KI-Chat mehr. Alles passiert an einem Ort. Wenn du tiefer in die Welt der Open-Source-KI-Tools eintauchen möchtest, lohnt sich auch ein Blick auf OpenClaude: Der ultimative Leitfaden zum Open-Source-KI-Assistenten.

Du willst nur installieren? Die vollständige Schritt-für-Schritt-Installation (npm/curl, Windows/PowerShell, Fehlerbehebung) findest du in unserer Claude-Code-Installationsanleitung. Dieser Guide fokussiert auf die CLI-Nutzung im Alltag.

Voraussetzungen: Das brauchst du vor der Installation

Bevor du mit der Installation beginnst, stelle sicher, dass dein System die grundlegenden Anforderungen erfüllt. Claude Code CLI basiert auf Node.js und wird über npm installiert. Du benötigst außerdem einen aktiven Anthropic-Account und einen gültigen API Key.

Hier ist eine Übersicht der Voraussetzungen auf einen Blick:

Falls Node.js noch nicht installiert ist, empfiehlt sich die Installation über die offizielle Node.js-Website, die für alle gängigen Betriebssysteme Installer bereitstellt. Für die Versionsverwaltung ist nvm eine praktische Alternative.

Schritt 1: Claude Code CLI installieren

Die Installation läuft vollständig über npm und dauert nur wenige Sekunden. Öffne dein Terminal und führe folgenden Befehl aus:

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

Das Flag -g installiert das Paket global, sodass du den Befehl claude von überall im System aufrufen kannst. Nach der Installation prüfst du, ob alles geklappt hat:

claude --version

Du solltest eine Ausgabe wie claude-code/1.x.x sehen. Falls der Befehl nicht gefunden wird, ist das npm-Binary-Verzeichnis möglicherweise nicht in deinem PATH. Unter macOS und Linux kannst du das mit folgendem Befehl prüfen:

echo $PATH

Schritt 2: In deinem Account anmelden

Nach der Installation musst du dich einmalig authentifizieren. Dafür benötigst du deinen Anthropic API Key, den du im Anthropic Console Dashboard unter „API Keys” findest. Du kannst den Key direkt als Umgebungsvariable setzen:

export ANTHROPIC_API_KEY="sk-ant-..."

Damit der API Key dauerhaft verfügbar ist, trägst du diese Zeile in deine Shell-Konfigurationsdatei ein. Je nach System ist das ~/.bashrc, ~/.zshrc oder eine entsprechende Profildatei.

echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.zshrc
source ~/.zshrc

Aus Sicherheitsgründen solltest du den API Key niemals direkt in Skripte oder Repositories einchecken. Nutze stattdessen immer Umgebungsvariablen oder einen Secret Manager – das ist eine grundlegende Regel für den sicheren Umgang mit Zugangsdaten.

Schritt 3: Deine erste Session starten

Navigiere im Terminal in ein Projektverzeichnis deiner Wahl und starte Claude Code CLI:

cd ~/mein-projekt
claude

Das öffnet eine interaktive Session. Das System scannt automatisch dein aktuelles Verzeichnis und lädt den Kontext deiner Dateien. Du siehst eine Eingabeaufforderung, über die du direkt mit Claude kommunizieren kannst. Mit Ctrl+C oder dem Befehl /exit beendest du die Session jederzeit.

Für schnelle Einzel-Prompts ohne interaktive Session gibt es den -p-Flag (print mode):

claude -p "Erkläre mir die Struktur dieses Projekts"

Schritt 4: Deine erste Frage stellen

Innerhalb einer Session kannst du Fragen in natürlicher Sprache stellen. Claude versteht den Kontext deines Projekts und antwortet direkt auf Basis deiner Dateien. Ein typischer erster Prompt könnte so aussehen:

> Was macht die Datei app.js und wie ist sie aufgebaut?

Claude liest die Datei automatisch, analysiert den Code und liefert eine verständliche Erklärung. Du kannst auch gezielt nach Problemen fragen:

> Gibt es potenzielle Bugs oder Sicherheitsprobleme in meinem Code?

Wichtige Commands für die interaktive Session auf einen Blick:

• /help: Zeigt alle verfügbaren Befehle an.
• /clear: Setzt den Gesprächsverlauf zurück.
• /exit: Beendet die Session.
• /model: Wechselt das verwendete Modell.
• /status: Zeigt Verbindungs- und Kontextinfos an.

Schritt 5: Code-Änderungen mit Claude vornehmen

Das mächtigste Feature von Claude Code CLI ist das direkte Bearbeiten von Dateien. Claude kann nicht nur Vorschläge machen, sondern Änderungen auch sofort umsetzen. Dazu weist du Claude explizit an, Dateien zu bearbeiten:

> Refaktoriere die Funktion calculateTotal() in utils.js und füge JSDoc-Kommentare hinzu

Claude zeigt dir den geplanten Diff und fragt zur Bestätigung, bevor Änderungen geschrieben werden. Das gibt dir volle Kontrolle über jede Modifikation. Du kannst auch im sogenannten Headless-Mode arbeiten, bei dem Outputs als JSON zurückgegeben werden – nützlich für Skripte und Automatisierungen:

claude -p "Generiere Unit-Tests für src/auth.js" --output-format json

Wer komplexere Entwicklungsworkflows automatisieren möchte, findet dazu weiterführende Ansätze in unserem Artikel über Workflow Automation mit KI.

Schritt 6: Git mit Claude Code CLI verwenden

Claude Code CLI lässt sich nahtlos mit git kombinieren. Du kannst Claude direkt nach dem Status deines Repositories fragen oder Commit-Messages generieren lassen. Die Integration funktioniert, weil Claude Zugriff auf die Ausgaben von git-Befehlen hat.

> Was hat sich seit dem letzten Commit geändert und was wäre eine passende Commit-Message?

Typische git-bezogene Aufgaben, die Claude übernimmt:

• Commit-Messages: Automatisch aus den Änderungen generieren lassen.
• Diff-Analysen: Komplexe Änderungen verständlich zusammenfassen.
• Branch-Strategien: Empfehlungen für sinnvolle Branching-Strukturen.
• Merge-Konflikte: Konflikte analysieren und Lösungsvorschläge erhalten.

Du kannst Claude auch anweisen, direkt git-Befehle auszuführen. In diesem Fall musst du das Tool explizit mit der Berechtigung ausstatten, Systembefehle auszuführen – ein Hinweis, der beim ersten Mal automatisch erscheint.

Nützliche Befehle und Tipps für den Alltag

Im täglichen Einsatz wirst du schnell eigene Workflows entwickeln. Hier sind bewährte Commands, die den Einstieg erleichtern:

# Projekt-Zusammenfassung anzeigen
claude -p "Erkläre die Architektur dieses Projekts in 5 Sätzen"

# Datei auf Fehler prüfen
claude -p "Prüfe src/index.ts auf TypeScript-Fehler und Verbesserungspotenzial"

# Tests generieren
claude -p "Schreibe Jest-Unit-Tests für alle Funktionen in lib/helpers.js"

# README aktualisieren
claude -p "Aktualisiere die README.md basierend auf dem aktuellen Projektstand"

Für Teams lohnt sich die Nutzung von CLAUDE.md-Dateien im Projektverzeichnis. Diese werden automatisch als System-Kontext eingelesen und erlauben es, projektspezifische Regeln, Konventionen und Anweisungen zu hinterlegen. So verhält sich Claude in jedem Projekt konsistent nach euren internen Standards.

Wer Claude Code CLI für größere Automatisierungsprojekte oder als Teil einer KI-Strategie im Unternehmen einsetzen möchte, findet bei uns kompetente KI-Unterstützung für Entwicklungsteams.

Häufig gestellte Fragen (FAQ)

Was tun, wenn die Installation fehlschlägt?

Der häufigste Grund für einen fehlgeschlagenen Install ist eine veraltete Node.js-Version. Prüfe mit node --version, ob du mindestens v18 verwendest. Bei Berechtigungsfehlern unter Linux und macOS hilft es, nvm für eine benutzerbasierte Node.js-Installation zu verwenden, anstatt den globalen System-Node zu nutzen.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
nvm use 20
npm install -g @anthropic-ai/claude-code

Welche Node.js-Version wird benötigt?

Claude Code CLI benötigt mindestens Node.js v18.0.0. Empfohlen wird die aktuelle LTS-Version (v20 oder v22), da diese langfristigen Support und bessere Performance bieten. Ältere Versionen führen zu Installationsfehlern oder unerwartetem Verhalten zur Laufzeit.

Wie viel kostet die Nutzung von Claude Code CLI?

Die Kosten richten sich nach dem Anthropic-Preismodell und hängen von der Anzahl der verarbeiteten Tokens ab. Jede Anfrage an das System verbraucht Input- und Output-Tokens. Für moderate Nutzung liegen die monatlichen Kosten typischerweise zwischen 10 und 50 USD. Das API-Dashboard zeigt dir jederzeit den aktuellen Verbrauch an.

Kann ich Claude Code CLI ohne API Key testen?

Nein, für die Nutzung ist ein gültiger API Key zwingend erforderlich. Anthropic bietet jedoch neuen Nutzern ein kostenloses Startguthaben an. Du kannst dich unter console.anthropic.com registrieren und erhältst sofort Zugang zur API, ohne Kreditkartendaten hinterlegen zu müssen.

Ist Claude Code CLI sicher für den Einsatz in Produktionsprojekten?

Grundsätzlich ja – allerdings solltest du einige Regeln beachten. Gib Claude niemals Zugriff auf produktive Systeme ohne menschliche Überprüfung. Nutze separate Branches für von Claude vorgeschlagene Änderungen und reviewe jeden Diff sorgfältig. Für Sicherheit gilt: Secrets, Passwörter und API Keys gehören niemals in Dateien, auf die Claude zugreift. Das System hat zwar Lesezugriff auf dein lokales Verzeichnis, sendet aber keine Daten ohne dein Zutun an externe Dienste.

Wie kann ich den mode wechseln oder den Kontext einschränken?

Mit dem --allowedTools-Flag kannst du steuern, welche Tools Claude verwenden darf. Das ist besonders nützlich, wenn du Claude nur lesen, aber nicht schreiben lassen möchtest:

claude --allowedTools "Read,Grep,Glob"

Damit läuft Claude im reinen Lesemodus und kann keine Dateien verändern. Für produktionsnahe Umgebungen ist das eine empfehlenswerte Einschränkung.