Startseite › Claude Code › CLI-Referenz
ÜberblickInstallationCLI-ReferenzPreise und LimitsAgent SDKSkills und PluginsGitHubWeb, Desktop und IDEModelleFehlerOpen Source?TutorialFür StudierendeQA-AutomatisierungVergleich mit CursorVergleich mit Codex und OpenCodeSubagentenHooksMCPÖkosystemVS CodeOpenRouterAnfragelimitsChinesischer Leitfaden
Zuletzt aktualisiert: 11. Oktober 2026

Claude Code CLI-Dokumentation: Befehle und Flags

Claude Code bietet zwei Betriebsarten: die interaktive Sitzung, die Sie mit claudestarten, und einen nicht interaktiven Ausgabemodus für Skripte und CI. Dies ist die Praxisreferenz für beide.

TLDR

  • claude startet eine interaktive Sitzung im aktuellen Verzeichnis; claude -p "..." führt einen Prompt aus und beendet sich.
  • Slash-Befehle verwalten die Sitzung: /init, /compact, /clear, /model, /cost, /status, /permissions, /mcp, /agents.
  • --output-format json und --allowedTools ermöglichen die Nutzung in Skripten; -c / -r setzen Sitzungen fort.

Start

claude                          # interactive session
claude "fix the failing test"   # start with a prompt
claude -p "summarise this repo"  # print mode: answer, then exit
claude -c                       # continue the most recent session
claude -r                       # pick a session to resume
claude --model claude-opus-5    # choose the model for this session

Wichtige Flags

  • -p, --print — nicht interaktiv; Eingaben per Pipe übergeben und Ausgaben erhalten. Die Grundlage jeder Nutzung in Skripten und CI.
  • --output-format text|json|stream-json — strukturierte Ausgabe für den Ausgabemodus.
  • --model <id> — jedes Modell, das der Endpunkt bereitstellt (/v1/models auf diesem Gateway listet sie auf).
  • --allowedTools "Read,Edit,Bash(git *)" — Tools vorab genehmigen, damit der Ausgabemodus nie auf eine Bestätigungsabfrage wartet.
  • --dangerously-skip-permissions — keinerlei Bestätigungsabfragen. Nur in einem Container oder einer Sandbox verwenden, die Sie verwerfen können.
  • --max-turns N — die Agentenschleife bei Headless-Ausführungen begrenzen.
  • --add-dir <path> — die Sitzung über mehrere Verzeichnisse hinweg arbeiten lassen.

Slash-Befehle innerhalb einer Sitzung

  • /init — eine CLAUDE.md für das Projekt schreiben (Konventionen, Build-Befehle, was zu vermeiden ist).
  • /compact [focus] — die Unterhaltung zusammenfassen, um Kontext freizugeben; die wirksamste einzelne Maßnahme zur Kostenkontrolle.
  • /clear — mit leerem Kontext neu beginnen.
  • /model — das Modell während der Sitzung wechseln; /cost — bisherige Tokens und Kosten; /status — Endpunkt, Schlüssel, Modell, Version.
  • /permissions — was der Agent ohne Rückfrage tun darf; /config — Einstellungen; /memory — Speicherdateien bearbeiten.
  • /mcp — verbundene MCP-Server; /agents — Subagenten definieren und verwalten; /hooks — Shell-Hooks für Tool-Ereignisse.
  • /review — einen Pull Request prüfen; /doctor — die Installation diagnostizieren; /help — alles Weitere.

claude setup-token: langlebige Authentifizierung für CI mit einem Abonnement

claude setup-token meldet Sie einmal im Browser an und gibt ein langlebiges OAuth-Token für ein Claude Pro/Max-Abonnement aus, das für Headless-Umgebungen gedacht ist, in denen /login nicht möglich ist. Exportieren Sie es in CI als CLAUDE_CODE_OAUTH_TOKEN; Ausführungen im Ausgabemodus nutzen dann das Kontingent des Abonnements. Dies gilt nur für Abonnements; mit einem API-Schlüssel (Anthropic oder Gateway) ist dieser Schritt unnötig — setzen Sie stattdessen ANTHROPIC_API_KEY.

Ausgabemodus für Skripte und CI

cat error.log | claude -p "explain the root cause in three lines"

claude -p "write a changelog entry for the staged diff" \
  --allowedTools "Read,Bash(git diff *)" \
  --output-format json

Über den Ausgabemodus nutzen die GitHub Action, Editor-Integrationen und das Agent SDK Claude Code. Wenn ANTHROPIC_BASE_URL auf das Gateway gesetzt ist, werden diese Ausführungen über Ihr Gateway-Guthaben oder Ihren unbegrenzten Tarif statt über ein Anthropic-Konto abgerechnet.

Wo die Konfiguration liegt

  • CLAUDE.md im Stammverzeichnis des Repositorys (und CLAUDE.local.md für persönliche Notizen) — Projektspeicher, der bei jeder Sitzung gelesen wird.
  • .claude/settings.json — projektspezifische Berechtigungen, Hooks und Umgebungsvariablen; ~/.claude/settings.json — global.
  • ~/.claude/skills/ und .claude/skills/ — Skills; .claude/agents/ — Subagenten-Definitionen.
  • Umgebung: ANTHROPIC_BASE_URL, ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN und die modellspezifischen Überschreibungen je Stufe, die im Modellleitfaden beschrieben werden.

Zuerst kostenlos ausprobieren

Neue Konten erhalten $5 kostenloses API-Guthaben mit dem Code CLAUDECODE — genug für einen Abend mit Claude Code auf Sonnet — danach Guthaben zum 7.69231-Fachen des Nennwerts.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Konto mit dem Code CLAUDECODE erstellen

Häufig gestellte Fragen

Wie führe ich Claude Code ohne die interaktive Eingabeaufforderung aus?

Verwenden Sie den Ausgabemodus: claude -p "Ihr Prompt". Kombinieren Sie ihn für Skripte mit --allowedTools und --output-format json und übergeben Sie Dateien per Pipe über stdin.

Was macht /compact?

Der Befehl fordert das Modell auf, die bisherige Unterhaltung zusammenzufassen, und ersetzt den Verlauf durch diese Zusammenfassung. Der Kontext wird kleiner, die Kosten pro Gesprächsrunde sinken und die Sitzung kann fortgesetzt werden. Führen Sie ihn aus, sobald eine Aufgabe eine neue Richtung einschlägt.

Kann ich Claude Code mit einer anderen API-Basis-URL verwenden?

Ja — setzen Sie ANTHROPIC_BASE_URL. /status bestätigt, welchen Endpunkt die Sitzung verwendet.

Claude Code über das Gateway nutzen

Dieselben Modelle, zwei Umgebungsvariablen, Guthaben zum 7.69231-Fachen des Nennwerts — oder ein unbegrenzter Pauschaltarif. Neue Konten: $5 kostenloses API-Guthaben mit dem Code CLAUDECODE.

API-Schlüssel erhalten Unbegrenzte Tarife ansehen

AI Prime Tech ist ein unabhängiges API-Gateway und ist weder mit Anthropic verbunden noch wird es von Anthropic unterstützt oder gesponsert. „Claude“ und „Claude Code“ sind Marken von Anthropic. Die hier beschriebenen Funktionen von Claude Code entsprechen der öffentlichen Dokumentation von Anthropic zum Zeitpunkt der Erstellung und ändern sich häufig; Preise und Modelllisten auf dieser Seite werden aus den aktuellen Einstellungen dieses Gateways ausgelesen.

Weitere Leitfäden zu Claude Code

Claude Code: der vollständige LeitfadenSo installieren Sie Claude CodePreise und Limits von Claude Code erklärtDas Claude Code SDK, jetzt Claude Agent SDKSkills und Plugins für Claude CodeClaude Code in GitHub: die App, die Action und @claudeHat Claude Code eine Weboberfläche? Web, Desktop und IDE erklärtWelches Modell Claude Code verwendet und wie Sie es ändernFehler in Claude Code und wie Sie sie behebenIst Claude Code Open Source?Claude Code Tutorial: Ihre erste echte SitzungClaude für Studierende: Claude Code, die API und was Bildungsangebote Ihnen tatsächlich bietenSo nutzen Sie Claude Code für die QA-AutomatisierungClaude Code im Vergleich mit Cursor: welches Werkzeug wann — und wie Sie beide nutzenClaude Code vs. Codex vs. OpenCode: Terminal-Agenten im VergleichClaude Code-Subagenten: Funktionsweise, Definition und AgententeamsClaude Code-Hooks: deterministische Kontrolle über die Aktionen des AgentenClaude Code MCP: Server verbinden, Geltungsbereiche, Remote-MCP und PraxisbeispieleDas Claude Code-Ökosystem: Router, Frameworks, Plugins und die Listen, die sie erfassenClaude Code in VS Code: die Erweiterung, die Nutzung im Terminal und die FehlerOpenRouter in Claude Code verwenden (und wann Sie darauf verzichten sollten)Claude-Fehler zum Ratenlimit: Was „API error: rate limit reached“ bedeutet und wie Sie ihn behebenClaude Code verwenden: von der Installation bis zur täglichen Nutzung