CLI-Nutzung und -Steuerung

​

Erste Schritte

Claude Code bietet zwei Hauptmöglichkeiten zur Interaktion:

• Interaktiver Modus: Führen Sie claude aus, um eine REPL-Sitzung zu starten
• Einmal-Modus: Verwenden Sie claude -p "Anfrage" für schnelle Befehle

# Interaktiven Modus starten
claude

# Mit einer Anfangsanfrage starten
claude "erkläre dieses Projekt"

# Einzelnen Befehl ausführen und beenden
claude -p "was macht diese Funktion?"

# Weitergeleiteten Inhalt verarbeiten
cat logs.txt | claude -p "analysiere diese Fehler"

​

CLI-Befehle

​

CLI-Flags

Passen Sie das Verhalten von Claude Code mit diesen Kommandozeilen-Flags an:

​

Details zum Druckmodus

Das Flag -p (oder --print) aktiviert den nicht-interaktiven Modus in Claude Code und ermöglicht das Weiterleiten von Ein- und Ausgabe für programmatische Nutzung. Dieses Flag unterstützt verschiedene Ausgabeformate für unterschiedliche Anwendungsfälle.

​

Grundlegende Verwendung

# Grundlegender Druckmodus - gibt nur den finalen Antworttext aus
claude -p "Erkläre wie man das Print-Flag verwendet"

# Mit stdin-Eingabe
echo "Was ist 2+2?" | claude -p

# Sitzung im Druckmodus mit einer Anfrage fortsetzen
claude -p --resume <session-id> "Sitzung mit dieser Anfrage fortsetzen"

​

Ausgabeformate

Die Option --output-format (verwendet mit -p) unterstützt drei Formate:

1. Textausgabe (Standard)

claude -p "Erkläre die Ausgabeformate"
# Gibt nur den Antworttext aus

2. JSON-Ausgabe

claude -p --output-format json "Erkläre wie man JSON-Ausgabe verwendet"

Gibt ein strukturiertes JSON-Objekt aus:

{
  "cost_usd": 0.003,
  "duration_ms": 1234,
  "duration_api_ms": 800,
  "result": "Der Antworttext hier...",
  "session_id": "abc123"
}

3. Streaming-JSON-Ausgabe

claude -p --output-format stream-json "Erstelle ein Python-Skript"

Im Streaming-Modus wird jede Nachricht als separates JSON-Objekt ausgegeben, sobald sie empfangen wird:

• Tool-Verwendungsnachrichten
• Assistenten-Textnachrichten
• Tool-Ergebnisnachrichten
• Finale Systemnachricht mit Statistiken

​

Ausführliche Ausgabe im Druckmodus

Bei Verwendung von --verbose mit -p muss es mit --output-format json oder --output-format stream-json kombiniert werden:

claude -p --verbose --output-format json "Debugge diesen Code"

Im ausführlichen JSON-Modus enthält die Ausgabe das vollständige Konversationsprotokoll:

[
  {
    "role": "user",
    "content": "Debugge diesen Code"
  },
  {
    "role": "assistant",
    "content": "Ich helfe dir beim Debuggen des Codes..."
  },
  {
    "role": "system",
    "cost_usd": 0.003,
    "duration_ms": 1234,
    "duration_api_ms": 800,
    "result": "Der Antworttext hier...",
    "session_id": "abc123"
  }
]

​

Zusätzliche Optionen für den Druckmodus

Maximale Durchgänge

claude -p --max-turns 3 "Korrigiere diesen Code" < file.py

Begrenzt die Anzahl der agentischen Durchgänge im nicht-interaktiven Modus.

Berechtigungsabfrage-Tool

claude -p --permission-prompt-tool mcp_auth_tool "Erstelle eine Datei"

Legt ein MCP-Tool für Berechtigungsabfragen im nicht-interaktiven Modus fest.

Sitzung fortsetzen

claude -p --resume abc123 "Sitzung mit dieser Anfrage fortsetzen"

Setzt eine bestimmte Sitzung nach ID im Druckmodus mit einer neuen Anfrage fort.

​

Sitzung fortführen

claude -c -p "Fahre mit dieser nächsten Aufgabe fort"

Setzt die letzte Konversation in diesem Projekt fort.

​

Slash-Befehle

Steuern Sie Claudes Verhalten während einer interaktiven Sitzung:

​

Spezielle Shortcuts

​

Schneller Speicher mit #

Fügen Sie Erinnerungen sofort hinzu, indem Sie Ihre Eingabe mit # beginnen:

# Immer beschreibende Variablennamen verwenden

Sie werden aufgefordert, die Speicherdatei auszuwählen, in der dies gespeichert werden soll.

​

Zeilenumbrüche im Terminal

Geben Sie mehrzeilige Befehle ein mit:

• Schnelles Escape: Tippen Sie \ gefolgt von Enter
• Tastenkombination: Option+Enter (oder Shift+Enter wenn konfiguriert)

Um Option+Enter in Ihrem Terminal einzurichten:

Für Mac Terminal.app:

1. Öffnen Sie Einstellungen → Profile → Tastatur
2. Aktivieren Sie “Option als Meta-Taste verwenden”

Für iTerm2 und VSCode Terminal:

1. Öffnen Sie Einstellungen → Profile → Tasten
2. Unter Allgemein, setzen Sie linke/rechte Option-Taste auf “Esc+”

Tipp für iTerm2- und VSCode-Benutzer: Führen Sie /terminal-setup in Claude Code aus, um Shift+Enter automatisch als intuitivere Alternative zu konfigurieren.

Siehe Terminal-Einrichtung in den Einstellungen für Konfigurationsdetails.

​

Vim-Modus

Claude Code unterstützt eine Teilmenge von Vim-Tastenbindungen, die mit /vim aktiviert oder über /config konfiguriert werden können.

Die unterstützte Teilmenge umfasst:

• Moduswechsel: Esc (zu NORMAL), i/I, a/A, o/O (zu INSERT)
• Navigation: h/j/k/l, w/e/b, 0/$/^, gg/G
• Bearbeitung: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (wiederholen)