Claude Code ist ein kommandozeilenbasierter Coding-Agent von Anthropic, der Ihre Codebasis liest, Dateien bearbeitet, Befehle ausführt und im Backend mit LLM-APIs kommuniziert. Dieser Leitfaden umfasst die vollständige CLI-Dokumentation: Einrichtung, verfügbare Flags und Slash-Befehle, Erstellung benutzerdefinierter Slash-Befehle und wie Sie die API-Aufrufe anstelle des Standard-Anthropic-Endpunkts an Novita AI weiterleiten.
Was ist Claude Code?
Claude Code ist ein agentisches Codierungswerkzeug, das als CLI, VS Code-Erweiterung, JetBrains-Plugin, Desktop-App und Browser-Oberfläche verfügbar ist. Alle Oberflächen nutzen dieselbe zugrundeliegende Engine: Claude Code stellt eine Verbindung zu einem LLM-API-Backend her, liest Ihr Projekt und führt mehrstufige Aufgaben aus, wie das Schreiben von Tests, Refactoring über mehrere Dateien hinweg, das Erstellen von Pull Requests und die Verwaltung von Git.
Die CLI ist die flexibelste Oberfläche. Sie folgt Unix-Konventionen – Sie können Logs hineinleiten, sie in CI mit dem -p-Flag ausführen oder mit anderen Tools verketten. Die Konfiguration erfolgt in Dateien (CLAUDE.md, .claude/settings.json, Umgebungsvariablen), sodass sie sich in automatisierten Kontexten vorhersagbar verhält.
Im Hintergrund sendet Claude Code jede Anfrage an einen Anthropic-kompatiblen API-Endpunkt. Standardmäßig ist dieser Endpunkt api.anthropic.com, aber Sie können ihn mit einer einzigen Umgebungsvariable auf einen beliebigen Anthropic-kompatiblen Anbieter umleiten – einschließlich Novita AI.
Claude Code Einrichtung
Installation
Die empfohlene Methode unter macOS, Linux und WSL ist das native Installationsprogramm:
curl -fsSL https://claude.ai/install.sh | bash
Unter Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Native Installationen aktualisieren sich automatisch im Hintergrund.
Wenn Sie npm bevorzugen, ist Node.js 18 oder höher erforderlich:
node --version # muss 18 oder höher sein
npm install -g @anthropic-ai/claude-code
Homebrew (macOS) folgt dem stabilen Release-Kanal:
brew install --cask claude-code
Homebrew aktualisiert nicht automatisch. Führen Sie brew upgrade claude-code aus, wenn Sie die neueste Version wünschen.
Erster Start
Navigieren Sie zu einem Projektverzeichnis und starten Sie die interaktive Sitzung:
cd your-project
claude
Bei der ersten Verwendung fordert Claude Code Sie zur Anmeldung auf. Nach der Authentifizierung liest es Ihr Projekt und wartet auf Anweisungen.
Projekteinrichtung
Führen Sie /init in einem neuen Repository aus, um eine Starterdatei CLAUDE.md zu generieren. Claude Code liest CLAUDE.md zu Beginn jeder Sitzung, daher ist dies der richtige Ort für Codierungsstandards, bevorzugte Bibliotheken, Architekturnotizen und Checklisten für Reviews.
/init
Nach /init können Sie mit /memory die Datei bearbeiten oder den automatischen Speicher aktivieren, der Beobachtungen von Claude über Ihr Projekt hinweg sitzungsübergreifend speichert.
Referenz der CLI-Befehle
Die CLI-Befehle von Claude Code auf oberster Ebene starten Sitzungen, verwalten die Authentifizierung und erledigen Hintergrundarbeiten. Eine Auswahl der nützlichsten:
| Befehl | Beschreibung |
|---|---|
claude |
Startet eine interaktive Sitzung im aktuellen Verzeichnis |
claude "Frage" |
Startet eine Sitzung mit einer initialen Eingabeaufforderung |
claude -p "Frage" |
Führt eine Anfrage aus und beendet sich (nicht-interaktiv / SDK-Modus) |
cat datei | claude -p "Frage" |
Leitet Inhalt in eine Anfrage |
claude -c |
Setzt die letzte Sitzung im aktuellen Verzeichnis fort |
claude -r "name" "Frage" |
Setzt eine Sitzung nach Name oder ID fort |
claude update |
Aktualisiert auf die neueste Version |
claude install stable |
Installiert oder installiert eine bestimmte Version neu |
claude auth login |
Meldet sich bei Ihrem Anthropic-Konto an |
claude auth login --console |
Meldet sich mit API-Key-Abrechnung anstelle eines Abonnements an |
claude auth status |
Zeigt den Authentifizierungsstatus an |
claude agents --json |
Öffnet die Agentenansicht, gibt aktive Sitzungen als JSON aus |
claude mcp |
Konfiguriert MCP-Server |
claude daemon status |
Überprüft den Status des Hintergrundsitzungs-Supervisors |
Wenn Sie einen Unterbefehl falsch eingeben, schlägt Claude Code die nächstgelegene Übereinstimmung vor: claude udpate gibt Meinten Sie claude update? aus.
Referenz der CLI-Flags
Flags ändern das Verhalten von Claude Code für eine Sitzung. Sie werden nach claude bei jedem Aufruf angegeben. Eine Auswahl der am häufigsten benötigten Flags:
| Flag | Wirkung |
|---|---|
-p, --print |
Nicht-interaktiver Modus; Antwort ausgeben und beenden |
-c, --continue |
Lädt die letzte Unterhaltung |
-r, --resume |
Setzt eine Sitzung nach ID oder Name fort |
--model |
Legt das Modell für diese Sitzung fest (sonnet, opus, haiku oder eine vollständige Modell-ID) |
--permission-mode |
Startet in einem Berechtigungsmodus: default, plan, auto, acceptEdits, bypassPermissions |
--add-dir |
Gewährt Dateizugriff auf ein zusätzliches Verzeichnis |
--system-prompt |
Ersetzt den System-Prompt vollständig |
--append-system-prompt |
Hängt an den Standard-System-Prompt an |
--max-turns |
Begrenzt die agentischen Schritte im -p-Modus |
--max-budget-usd |
Begrenzt die API-Kosten im -p-Modus |
--output-format |
Ausgabeformat für den -p-Modus: text, json, stream-json |
--bg |
Startet als Hintergrundagent und kehrt sofort zurück |
--worktree, -w |
Startet in einem isolierten Git-Worktree |
--bare |
Überspringt die automatische Erkennung von Hooks, Skills, Plugins, MCP für schnellere scriptgesteuerte Aufrufe |
--verbose |
Zeigt die vollständige schrittweise Ausgabe |
--mcp-config |
Lädt MCP-Server aus einer JSON-Datei |
--effort |
Legt den Reasoning-Aufwand fest: low, medium, high, xhigh, max |
Die Kombination --print + --output-format json ist das Standardmuster für Skripte. Für CI-Pipelines mit Budgetbeschränkungen kombinieren Sie dies mit --max-budget-usd und --max-turns.
Dokumentation der Slash-Befehle
Slash-Befehle werden innerhalb einer aktiven Sitzung ausgeführt. Geben Sie / ein, um alle verfügbaren zu sehen, oder / gefolgt von Buchstaben, um zu filtern. Befehle funktionieren nur am Anfang einer Nachricht.
Sitzungs- und Kontextverwaltung
| Befehl | Zweck |
|---|---|
/clear |
Beginnt eine neue Unterhaltung; die vorherige Sitzung bleibt unter /resume erhalten |
/compact |
Fasst die Unterhaltung zusammen, um Platz im Kontextfenster freizugeben |
/context |
Visualisiert die Kontextnutzung und zeigt Optimierungsvorschläge |
/resume |
Öffnet eine vorherige Sitzung nach Namen oder aus einer Auswahl erneut |
/branch |
Verzweigt die Unterhaltung, um eine andere Richtung auszuprobieren |
/rewind |
Setzt Code und Unterhaltung auf einen früheren Prüfpunkt zurück |
Projekteinrichtung
| Befehl | Zweck |
|---|---|
/init |
Erstellt eine Starter-CLAUDE.md für das Projekt |
/memory |
Bearbeitet CLAUDE.md-Dateien und verwaltet den automatischen Speicher |
/mcp |
Verwaltet MCP-Serververbindungen interaktiv |
/agents |
Konfiguriert Subagenten-Einstellungen |
/permissions |
Legt Erlauben-, Fragen- und Verweigern-Regeln für Werkzeuge fest |
/hooks |
Zeigt Hook-Konfigurationen an |
Entwicklungsworkflow
| Befehl | Zweck |
|---|---|
/plan |
Wechselt in den Planungsmodus vor einer größeren Änderung |
/model |
Wechselt das aktive Modell |
/effort |
Passt den Reasoning-Aufwand an |
/diff |
Öffnet den interaktiven Diff-Viewer |
/code-review [--fix] |
Überprüft den aktuellen Diff; --fix wendet Erkenntnisse an |
/security-review |
Führt eine gründliche Sicherheitsprüfung der ausstehenden Änderungen durch |
/batch <Anweisung> |
Zerlegt eine große Änderung und führt sie parallel in Worktrees aus |
/background |
Trennt die Sitzung, um sie als Hintergrundagent auszuführen |
Dienstprogramme
| Befehl | Zweck |
|---|---|
/help |
Zeigt verfügbare Befehle an |
/doctor |
Diagnostiziert Installations- und Einstellungsprobleme |
/usage |
Zeigt Sitzungskosten und Plannutzung |
/export |
Exportiert die Unterhaltung als Klartext |
/config |
Öffnet Einstellungen oder setzt einen Wert direkt: /config thinking=false |
/skills |
Listet verfügbare Skills auf |
Benutzerdefinierte Slash-Befehle
Benutzerdefinierte Slash-Befehle – jetzt als Skills bezeichnet – ermöglichen es Ihnen, wiederholbare Abläufe zu paketieren, die Ihr Team teilen kann.
Wie man einen benutzerdefinierten Befehl erstellt
Erstellen Sie ein Verzeichnis unter .claude/skills/ (projektebene) oder ~/.claude/skills/ (persönlich, in allen Projekten verfügbar):
mkdir -p .claude/skills/review-pr
Erstellen Sie eine SKILL.md-Datei in diesem Verzeichnis:
---
description: Überprüfen Sie einen offenen GitHub-PR auf Sicherheitsprobleme und Lücken in der Testabdeckung. Verwenden Sie dies, wenn der Benutzer nach einer PR-Review oder Prüfung der Pull-Request-Qualität fragt.
---
## Anweisungen
Überprüfen Sie den Pull Request mit diesen Prioritäten:
1. Identifizieren Sie Sicherheitslücken: Injection-Risiken, Auth-Lücken, Datenoffenlegung.
2. Überprüfen Sie die Testabdeckung für neue Codepfade.
3. Markieren Sie fehlende Fehlerbehandlungen an Systemgrenzen.
Fassen Sie die Ergebnisse in drei Abschnitten zusammen: Sicherheit, Abdeckung, Sonstiges. Verwenden Sie ✓ für bestandene Prüfungen und ⚠ für Probleme.
Dadurch wird ein /review-pr-Befehl erstellt, den Sie direkt aufrufen können:
/review-pr
Claude lädt den Skill auch automatisch, wenn Sie etwas fragen, das der Beschreibung entspricht.
Skill-Speicherorte und Priorität
Skills folgen einer Prioritätsreihenfolge: Unternehmens-Skills überschreiben persönliche, persönliche überschreiben Projekt-Skills. Projekt-Skills befinden sich in .claude/skills/. Persönliche Skills (in allen Ihren Projekten verfügbar) werden in ~/.claude/skills/ abgelegt.
~/.claude/skills/ → persönlich, alle Projekte
.claude/skills/ → nur dieses Projekt
Benutzerdefinierte Befehle in .claude/commands/ funktionieren weiterhin. Eine Datei unter .claude/commands/deploy.md und ein Skill unter .claude/skills/deploy/SKILL.md erstellen beide /deploy und verhalten sich identisch.
Dynamische Kontextinjektion
Skills können Live-Daten einfügen, bevor Claude den Prompt sieht. Das Präfix ! führt einen Shell-Befehl aus und fügt dessen Ausgabe ein:
---
description: Nicht committete Änderungen zusammenfassen und Risiken kennzeichnen.
---
## Aktueller Diff
!`git diff HEAD`
## Anweisungen
Fassen Sie die Änderungen in Stichpunkten zusammen. Kennzeichnen Sie Risiken: fehlende Fehlerbehandlung, hartcodierte Werte, ungetestete Pfade.
Wenn Sie diesen Skill ausführen, führt Claude Code git diff HEAD aus und ersetzt diese Zeile durch die tatsächliche Diff-Ausgabe. Claude sieht den tatsächlichen Arbeitsverzeichniszustand, anstatt ihn durch Tool-Aufrufe anfordern zu müssen.
Verwendung von Novita AI als LLM-Backend
Claude Code leitet den gesamten API-Traffic über die Umgebungsvariable ANTHROPIC_BASE_URL. Wenn Sie diese auf den Anthropic-kompatiblen Endpunkt von Novita AI setzen, erhalten Sie Zugriff auf eine breite Palette von Modellen – darunter DeepSeek, Kimi, Qwen und GLM-Varianten – zu deutlich geringeren Kosten pro Token als beim Standard-Anthropic-Endpunkt.
Holen Sie Ihren Novita AI API-Schlüssel
Registrieren Sie sich für ein Novita AI-Konto, um kostenlose Testguthaben zu erhalten. Navigieren Sie zur Schlüsselverwaltungsseite, klicken Sie auf Neuen Schlüssel erstellen, und kopieren Sie den Schlüssel sofort.
Umgebungsvariablen setzen
Auf Mac und Linux:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Ihr Novita API-Schlüssel>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
Unter Windows (Eingabeaufforderung):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Ihr Novita API-Schlüssel>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash
Um diese unter Mac/Linux dauerhaft zu setzen, fügen Sie die export-Zeilen in ~/.bashrc oder ~/.zshrc hinzu.
ANTHROPIC_SMALL_FAST_MODEL steuert das leichte Modell, das Claude Code für schnelle interne Aufgaben wie Dateisuchen und kurze Zusammenfassungen verwendet. Wenn Sie es auf dieselbe Modell-ID setzen, bleibt der gesamte Traffic auf einem Abrechnungskonto.
Starten Sie Claude Code
Setzen Sie die Umgebungsvariablen und starten Sie Claude Code normal:
cd your-project
claude
Claude Code verbindet sich mit dem Endpunkt von Novita AI mit dem von Ihnen angegebenen Modell. Die interaktive Sitzung funktioniert identisch – alle CLI-Flags, Slash-Befehle und benutzerdefinierten Skills verhalten sich unabhängig vom verwendeten Backend gleich.
Für Skripte und CI gilt derselbe Ansatz:
cat logs.txt | claude -p "finde Fehlermuster" --output-format json
Die LLM-API von Novita AI unterstützt das vollständige Anthropic-Nachrichtenformat, einschließlich Tool-Nutzung, strukturierter Ausgaben und Streaming, sodass alle Claude Code-Funktionen ohne Änderungen funktionieren.
Agent Sandbox für isolierte Ausführung
Wenn Sie automatisierte Pipelines auf Basis von Claude Code erstellen, bietet die Agent Sandbox von Novita AI isolierte, Firecracker-gestützte Ausführungsumgebungen für den programmatischen Betrieb von Agenten. Dies ist relevant für CI-Workflows, Hintergrundagenten und Multi-Agenten-Setups, bei denen Sie Ausführungsisolierung benötigen, anstatt direkt auf Ihrem Entwicklungsrechner zu arbeiten.
Claude Code als IDE-Werkzeug
Claude Code integriert sich direkt in Editoren, was gemeint ist, wenn Benutzer sagen “claude code ist eine IDE” – es ist keine eigenständige IDE, sondern ein Coding-Agent, der sich in Ihre bestehende Umgebung einbettet.
VS Code und Cursor
Installieren Sie die Claude Code-Erweiterung aus dem VS Code Marketplace (suchen Sie nach “Claude Code”) oder aus dem Cursor Marketplace. Nach der Installation öffnen Sie die Befehlspalette (Cmd+Shift+P / Ctrl+Shift+P), geben Sie “Claude Code” ein und wählen Sie In neuem Tab öffnen.
Die VS Code-Integration fügt Inline-Diff-Review, @-Dateierwähnungen, Planüberprüfung vor Bearbeitungen und den Gesprächsverlauf direkt im Editor-Panel hinzu. Sie können Claude Code auch im integrierten Terminal zusammen mit der Erweiterung verwenden.
JetBrains
Installieren Sie das Claude Code-Plugin aus dem JetBrains Marketplace und starten Sie Ihre IDE neu. Das Plugin erfordert die separat installierte CLI. Es bietet interaktive Diff-Ansicht und Kontextfreigabe für Auswahlen in IntelliJ IDEA, PyCharm, WebStorm und anderen JetBrains-IDEs.
Desktop-App und Web
Die Claude Code Desktop-App (macOS und Windows) ermöglicht es Ihnen, Diffs visuell zu überprüfen, mehrere Sitzungen nebeneinander auszuführen und wiederkehrende Aufgaben zu planen. Die Weboberfläche unter claude.ai/code führt Sitzungen im Browser ohne lokale Einrichtung aus – nützlich für Repositories, die Sie nicht lokal haben, oder um langlaufende Aufgaben zu starten, die Sie remote überwachen können.
FAQ
Was ist ANTHROPIC_BASE_URL und warum ist es wichtig?
ANTHROPIC_BASE_URL teilt Claude Code mit, an welchen API-Endpunkt Anfragen gesendet werden sollen. Der Standard ist api.anthropic.com. Wenn Sie ihn auf https://api.novita.ai/anthropic setzen, wird der gesamte Traffic an den Anthropic-kompatiblen Endpunkt von Novita AI geleitet, wo Sie alternative Modelle zu verschiedenen Preispunkten verwenden können. Es sind keine Codeänderungen oder Plugins erforderlich – nur die Umgebungsvariable.
Was ist der Unterschied zwischen CLI-Flags und Slash-Befehlen?
CLI-Flags (wie --model, --permission-mode, --max-turns) werden beim Start des claude-Binärprogramms von der Shell aus gesetzt. Sie konfigurieren die Sitzung vor dem Start. Slash-Befehle (wie /model, /plan, /compact) werden innerhalb einer aktiven Sitzung ausgeführt und ändern das Verhalten während des Gesprächs.
Kann ich Claude Code ohne ein Claude-Abonnement verwenden?
Ja. Mit claude auth login --console melden Sie sich mit der API-Key-Abrechnung der Anthropic-Konsole an, die eine nutzungsbasierte Bezahlung pro Token verwendet, anstatt ein Abonnement. Wenn Sie über ANTHROPIC_BASE_URL zu Novita AI routen, benötigen Sie nur ein Novita AI-Konto – Ihr Anthropic-Konto wird nicht belastet.
Wie unterscheiden sich benutzerdefinierte Slash-Befehle von CLAUDE.md?
Der Inhalt von CLAUDE.md wird zu Beginn jeder Sitzung geladen und bleibt während der gesamten Sitzung im Kontext. Skills (benutzerdefinierte Befehle) werden nur beim Aufruf geladen, sodass umfangreiches Referenzmaterial keine Token-Kosten verursacht, bis Sie es tatsächlich benötigen. Verwenden Sie CLAUDE.md für Projektfakten, die Claude immer wissen sollte – Codierungsstandards, Build-Befehle, Architekturnotizen. Verwenden Sie Skills für Abläufe, die Sie bei Bedarf ausführen – PR-Review-Checklisten, Bereitstellungsschritte, Workflows zur Testgenerierung.
Funktioniert Claude Code in CI?
Ja. Verwenden Sie claude -p "Abfrage" --output-format json für den nicht-interaktiven Modus mit strukturierter Ausgabe. Fügen Sie --max-budget-usd hinzu, um die Kosten zu begrenzen, und --max-turns, um die Ausführungszeit zu beschränken. Das Flag --bare überspringt die automatische Erkennung von Hooks, Skills und Plugins für einen schnelleren Start in skriptgesteuerten Kontexten. Claude Code lässt sich auch über offizielle Workflow-Vorlagen in GitHub Actions und GitLab CI/CD integrieren.
Novita AI ist eine KI-Cloud-Plattform, die Entwicklern eine einfache Möglichkeit bietet, KI-Modelle über eine einfache API bereitzustellen, und gleichzeitig erschwingliche und zuverlässige GPU-Cloud für das Erstellen und Skalieren bereitstellt.
