Claude Code – CLI-Basics

Flags werden beim Start von claude aus dem Terminal gesetzt (im Gegensatz zu Slash-Commands, die innerhalb einer laufenden Session getippt werden — siehe Slash-Commands).

Session starten/fortsetzen

claude                       # neue interaktive Session im aktuellen Ordner
claude "fix den Login-Bug"   # One-Shot: Task ausführen, danach Ende
claude -c                    # letzte Session in diesem Ordner fortsetzen
claude -r <session-id>       # eine bestimmte Session fortsetzen (auch aus anderem Ordner)

Nicht-interaktiv / Scripting

claude -p "Erkläre dieses Repo"              # Print-Mode: Ergebnis auf stdout, kein REPL
claude -p "..." --output-format json         # maschinenlesbar, z.B. für CI
claude -p "..." --max-turns 3                # Agentic Loop begrenzen

Nützlich für CI/Pipelines — z. B. scaffold-check.sh-Ergebnisse per claude -p zusammenfassen lassen, oder in einer GH Action automatisiert PR-Beschreibungen generieren.

Debugging / Sichtbarkeit

claude --verbose        # zeigt Tool-Calls (und ggf. Thinking-Blöcke) live im Terminal

Praktisch, wenn unklar ist, warum Claude Code eine bestimmte Aktion nicht ausführt oder ein Tool anders aufruft als erwartet — zeigt den tatsächlichen Tool-Call inkl. Parametern, nicht nur das Endergebnis.

Modell & Verhalten

claude --model opus                          # Modell wählen (opus | sonnet | haiku | ...)
claude --permission-mode plan                 # Read-only Planungsmodus, nichts wird ausgeführt
claude --add-dir ../anderes-repo              # Zugriff auf ein Nachbarverzeichnis erlauben
claude --allowed-tools Bash,Read,Edit         # Tool-Set einschränken

--permission-mode plan ist der sichere erste Schritt bei riskanten Aufgaben (z. B. "räum die Datenbank auf") — Claude plant, führt aber nichts aus, bis man explizit bestätigt.

Named Sessions

claude --session-id "feature-$(git branch --show-current)"

Kombiniert mit /rename in der Session macht das die Session-Historie später wiederfindbar (z. B. nach einer Woche Pause auf einem Feature-Branch).

TIP

claude --help listet nicht jedes Flag. Vollständige, aktuelle Referenz: code.claude.com/docs/en/cli-reference