Claude Code CLI — Vollstaendige Referenz

Dieses Dokument ist eine REFERENCE — nicht ein Guide, nicht ein Ueberblick. Jedes Flag, jedes Kommando, jede Option wird dokumentiert. Basiert auf der offiziellen Anthropic Dokumentation (Stand: März 2026).

Installation

Unterstuetzte Plattformen

Claude Code ist verfuegbar fuer:

• macOS 13.0 oder neuer (Intel und Apple Silicon)
• Linux x86_64 und aarch64 (glibc-Systeme)
• Alpine Linux und musl-basierte Distributionen (spezielle Behandlung noetig)
• Windows 10/11 mit Git Bash
• WSL1/WSL2 auf Windows

Installationsmethoden

Shell-Installer (macOS / Linux)

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

Das Skript:

• Prueft Systemanforderungen
• Erkennt CPU-Architektur automatisch
• Installiert nach ~/.local/bin/claude
• Erkennt Ihr Shell-Profil und ergaenzt es mit PATH

Nach Installation:

• Terminal neu starten ODER
• source ~/.zshrc / source ~/.bashrc ausfuehren

PowerShell-Installer (Windows)

irm https://claude.ai/install.ps1 | iex

Das Skript:

• Prueft Systemanforderungen
• Erkennt Windows-Architektur
• Installiert nach %USERPROFILE%\.local\bin\claude.exe
• Ergaenzt User PATH Umgebungsvariable

Nach Installation: Terminal neu starten.

CMD-Installer (Windows)

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Homebrew (macOS)

brew install --cask claude-code

WinGet (Windows)

winget install Anthropic.ClaudeCode

NPM (alle Plattformen, deprecated)

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

NPM-Installation ist deprecated. Verwenden Sie den Shell/PowerShell-Installer statt dessen. Sie sind 3-4x schneller.

Systemanforderungen

Verifizierung nach Installation

claude --version

Sollte die Versionsnummer ausgeben, z.B. claude 2.1.42.

CLI Kommandos

CLI Flags — Komplette Referenz

Allgemeine Flags

Debug-Kategorien:

• api — API-Aufrufe
• mcp — MCP Server
• hooks — Lifecycle Hooks
• file — Datei-Operationen
• statsig — Feature Flags

Negation mit ! (z.B. "!statsig,!file").

Session Management

Directory und File Management

Model und Agent Configuration

Permission und Security

Tool Control

Syntax:

• "Bash" — alle Bash Commands
• "Bash(git log *)" — nur git log Pattern-Matching
• "Read" — Read Tool vollstaendig
• "" — alle Tools deaktivieren

Browser Integration

System Prompt Customization

--system-prompt und --system-prompt-file sind mutually exclusive. Append-Flags koennen mit beiden kombiniert werden.

Configuration Files

Print Mode (Non-Interactive)

IDE und Development

Plugins und Extensions

MCP und Channels (Research Preview)

Maintenance und Initalisierung

API und Erweiterte Options

Built-In Keyboard Shortcuts (Interactive Mode)

Allgemeine Controls

Text Editing

Multiline Input (Verschiedene Methoden)

Shift+Enter funktioniert out-of-the-box auf iTerm2, WezTerm, Ghostty, Kitty. Andere Terminals: /terminal-setup ausfuehren zum Konfigurieren.

Quick Commands (Prefix Notation)

Vim Editor Mode

Aktiviere mit /vim Kommando oder /config.

Mode Switching

Navigation (NORMAL Mode)

Editing (NORMAL Mode)

Text Objects

Voice Input

Zeichenfolge wird bei Cursor eingefuegt. Key ist rebindbar.

Environment Variables

API und Authentication

Netzwerk und Proxy

Feature Flags und Verhalten

Terminal und IDE

Development und Debugging

Configuration Files

Speicherorte

Settings File Struktur

{
  "model": "claude-opus-4-1",
  "tools": ["Read", "Bash", "Edit", "Glob", "Grep"],
  "allowedTools": [
    "Bash(git log *)",
    "Bash(git diff *)",
    "Read"
  ],
  "permissionMode": "plan",
  "maxTurns": 50,
  "env": {
    "CUSTOM_VAR": "value"
  },
  "hooks": {
    "PreToolUse": ["check-schema"],
    "PostToolUse": ["format-output"]
  }
}

MCP Configuration

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["./server.js"],
      "env": {
        "API_KEY": "key"
      }
    }
  }
}

Exit Codes

Beispiele:

claude auth status
echo $?  # Gibt 0 wenn logged in, 1 wenn nicht

Haeufige Fehlerbehandlung

Installation

Authentication

Performance

Konfiguration

Debugging und Diagnostics

Doctor Command

claude /doctor

Prueft:

• Installation Type, Version, Search Funktionalitaet
• Auto-Update Status und verfuegbare Versionen
• Invalid Settings Files (malformed JSON, falsche Typen)
• MCP Server Configuration Errors
• Keybinding Configuration Probleme
• Context Usage Warnings (grosse CLAUDE.md, hohe MCP Token)
• Plugin und Agent Loading Errors

Verbose Output

claude --verbose

Zeigt:

• Komplette Turn-by-Turn Output
• Tool Invocations und Results
• Token Usage pro Turn
• API Request/Response Details

Debug Kategorien

claude --debug "api,mcp"
claude --debug "!statsig,!file"  # Alles AUSSER statsig, file

macOS Terminal Konfiguration (Fuer Alt-Keys)

Falls Alt+B, Alt+F, Alt+Y, Alt+M, Alt+P nicht funktionieren, konfigurieren Sie Option als Meta:

iTerm2

1. Settings → Profiles → Keys
2. Left Option Key setzen zu "Esc+"
3. Right Option Key setzen zu "Esc+"

Terminal.app

1. Settings → Profiles → Keyboard
2. Check "Use Option as Meta Key"

VS Code Terminal

1. Settings → Profiles → Keys
2. Left/Right Option Key setzen zu "Esc+"

Best Practices

Session Management

1. Named Sessions verwenden fuer bessere Organization:

   Kopieren

   claude -n "feature-auth-refactor"
   

2. Continue statt Resume fuer gleichen Verzeichnis:

   Kopieren

   claude -c  # Statt -r session-id
   

3. Worktrees fuer parallele Work:

   Kopieren

   claude -w feature-1  # Isolierter Branch
   claude -w feature-2  # Anderer Branch
   

Performance

1. Context regularmaessig compacten:

   Kopieren

   /compact
   

2. Grossere Codebases mit --add-dir scoping:

   Kopieren

   claude --add-dir ./src ./tests
   

3. Limit Turns bei API-Kosten-Sensitivitaet:

   Kopieren

   claude -p --max-turns 3 "query"
   

Sicherheit

1. Niemals Credentials in CLI Flags:

   Kopieren

   # FALSCH
   claude --betas "api_key=secret"
   
   # RICHTIG
   export ANTHROPIC_API_KEY=sk-ant-...
   claude
   

2. Print Mode fuer sensible Arbeit:

   Kopieren

   claude -p "query"  # No persistent session
   

3. Permission Modes nutzen:

   Kopieren

   claude --permission-mode plan  # Ueberpruefen vor Execution
   

Letztes Update: März 2026 | Quelle: Anthropic Code Dokumentation

Quellen und Links

• CLI Reference
• Interactive Mode
• npm Package
• Official Claude Code Documentation
• GitHub (Anthropic)
• Anthropic SDK Python
• Anthropic SDK TypeScript
• Claude Code Docs Index