Claude Code ist ein terminalbasiertes Coding-Agent von Anthropic. Es liest Ihre Codebasis, bearbeitet Dateien, führt Befehle aus und kann sich mit Anthropic-kompatiblen Backends verbinden, anstatt nur die Standard-API von Anthropic zu verwenden. Dieser Leitfaden behandelt die Einrichtung der Claude Code CLI, Slash-Befehle, benutzerdefinierte Skills und die Weiterleitung von Anfragen über Novita AI.
Wenn Sie Datenbanken, Browser oder andere externe Tools benötigen, kombinieren Sie dies mit dem Claude MCP Konfigurationsleitfaden.
Wichtige Erkenntnisse
- Claude Code ist ein Befehlszeilen-Agent, nicht nur ein Eingabefeld.
/compact,/resume,/permissionsund/modelsind Sitzungsbefehle, während-pund--resumeCLI-Flags sind.- Benutzerdefinierte Slash-Befehle leben jetzt als Skills, daher sind sowohl
.claude/skills/als auch.claude/commands/relevant. - Novita AI kann als Anthropic-kompatibles Backend über
ANTHROPIC_BASE_URLdienen. - Claude Code eignet sich sowohl für IDE-ähnliche Arbeitsabläufe als auch für automatisierte Agentenläufe.
Was ist Claude Code?
Claude Code ist das agentische Codierungstool von Anthropic. Die CLI läuft in Ihrem Terminal, aber derselbe Agent erscheint auch in der Desktop-App, der Browser-Oberfläche und Editor-Integrationen.
Die CLI ist die flexibelste Oberfläche. Sie folgt Unix-Konventionen, sodass Sie Dateien hineinleiten, sie mit -p nicht-interaktiv ausführen und in Skripte oder CI einbinden können. Die Konfiguration befindet sich in CLAUDE.md, .claude/settings.json und Umgebungsvariablen, was sie für wiederholbare Codierungsabläufe sehr geeignet macht.
Unter der Haube sendet Claude Code Anfragen an einen Anthropic-kompatiblen API-Endpunkt. Standardmäßig ist dieser Endpunkt der eigene Dienst von Anthropic, aber Sie können ihn mit einer einzigen Umgebungsvariable auf die LLM-API von Novita AI umleiten.
Claude Code Einrichtung
Installation
Installieren Sie die CLI mit Node.js 18 oder höher:
npm install -g @anthropic-ai/claude-code
Erster Start
Starten Sie Claude Code in einem Projektverzeichnis:
cd your-project
claude
Bei der ersten Nutzung 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 Starter-CLAUDE.md-Datei 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 Überprüfungen.
/init
Nach /init verwenden Sie /memory, um die Datei zu bearbeiten oder den automatischen Speicher zu aktivieren, der Beobachtungen, die Claude über Ihr Projekt macht, über Sitzungen hinweg speichert.
CLI-Befehlsreferenz
| Befehl | Beschreibung |
|---|---|
claude |
Startet eine interaktive Sitzung im aktuellen Verzeichnis |
claude "query" |
Startet eine Sitzung mit einer anfänglichen Eingabeaufforderung |
claude -p "query" |
Führt eine Abfrage aus und beendet sich |
cat file | claude -p "query" |
Leitet Dateiinhalt in eine Abfrage |
claude -c |
Setzt die letzte Sitzung im aktuellen Verzeichnis fort |
claude -r "name" "query" |
Setzt eine Sitzung nach Name oder ID fort |
claude update |
Aktualisiert auf die neueste Version |
claude install stable |
Installiert oder installiert das stabile Binary neu |
claude auth login |
Anmeldung bei Ihrem Anthropic-Konto |
claude auth login --console |
Anmeldung mit API-Key-Abrechnung statt Abonnement |
claude auth status |
Zeigt Authentifizierungsstatus an |
claude mcp |
Konfiguriert MCP-Server |
claude doctor |
Zeigt Installations- und Einstellungsdiagnose an |
CLI-Flags-Referenz
| Flag | Funktion |
|---|---|
-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 |
Setzt das Modell für diese Sitzung |
--permission-mode |
Startet in einem Berechtigungsmodus |
--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 standardmäßigen System-Prompt an |
--max-turns |
Begrenzt agentische Züge im -p-Modus |
--max-budget-usd |
Begrenzt API-Ausgaben im -p-Modus |
--output-format |
Ausgabeformat für -p-Modus: text, json, stream-json |
--bg |
Startet als Hintergrund-Agent und kehrt sofort zurück |
--worktree, -w |
Startet in einem isolierten Git-Worktree |
--bare |
Überspringt automatische Erkennung von Hooks, Skills, Plugins und MCP für schnellere Skriptaufrufe |
--verbose |
Zeigt vollständige Zug-für-Zug-Ausgabe |
--mcp-config |
Lädt MCP-Server aus einer JSON-Datei |
--effort |
Setzt den Reasoning-Aufwand |
Die Kombination --print + --output-format json ist das Standardmuster für Skripting. Für CI-Pipelines mit Budgetbeschränkungen kombinieren Sie es mit --max-budget-usd und --max-turns.
Slash-Befehle Dokumentation
Slash-Befehle werden innerhalb einer aktiven Sitzung ausgeführt. Geben Sie / ein, um alle verfügbaren Befehle zu sehen, oder / gefolgt von Buchstaben, um zu filtern. Befehle funktionieren nur am Anfang einer Nachricht.
Sitzungs- und Kontextverwaltung
| Befehl | Zweck |
|---|---|
/clear |
Startet eine neue Unterhaltung; vorherige Sitzung bleibt in /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 erneut, nach Name oder aus einer Auswahl |
/branch |
Gabelt die Unterhaltung, um eine andere Richtung zu versuchen |
/rewind |
Rollt Code und Unterhaltung zu einem Kontrollpunkt zurück |
Projekteinrichtung
| Befehl | Zweck |
|---|---|
/init |
Generiert 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 Subagent-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 großen Ä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 tiefgehende Sicherheitsprüfung ausstehender Änderungen durch |
/batch <instruction> |
Zerlegt eine große Änderung und führt sie in parallelen Worktrees aus |
/background |
Trennt die Sitzung, um als Hintergrund-Agent zu laufen |
Dienstprogramme
| Befehl | Zweck |
|---|---|
/help |
Zeigt verfügbare Befehle an |
/doctor |
Diagnostiziert Installations- und Einstellungsprobleme |
/usage |
Zeigt Sitzungskosten und Plannutzung an |
/export |
Exportiert die Unterhaltung als Klartext |
/config |
Öffnet Einstellungen oder setzt einen Wert direkt |
/skills |
Listet verfügbare Skills auf |
Benutzerdefinierte Slash-Befehle
Benutzerdefinierte Slash-Befehle leben jetzt als Skills. Vorhandene .claude/commands/-Dateien funktionieren weiterhin, aber .claude/skills/ ist das bevorzugte Format.
So erstellen Sie einen benutzerdefinierten Befehl
Erstellen Sie ein Verzeichnis unter .claude/skills/ (Projektebene) oder ~/.claude/skills/ (persönlich):
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 Testabdeckungslücken.
---
## Anweisungen
Überprüfen Sie den Pull-Request mit diesen Prioritäten:
1. Identifizieren Sie Sicherheitslücken.
2. Überprüfen Sie die Testabdeckung für neue Codepfade.
3. Markieren Sie fehlende Fehlerbehandlung an Systemgrenzen.
Dies erstellt einen /review-pr-Befehl, den Sie direkt aufrufen können:
/review-pr
Claude lädt den Skill auch automatisch, wenn Sie etwas fragen, das zur Beschreibung passt.
Skill-Orte und Priorität
~/.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.
Novita AI als LLM-Backend verwenden
Claude Code leitet den API-Verkehr über ANTHROPIC_BASE_URL. Wenn Sie es auf den Anthropic-kompatiblen Endpunkt von Novita AI setzen, erhalten Sie Zugriff auf Novita-Modelle, ohne den Claude Code-Workflow zu ändern.
Novita AI API-Key abrufen
Registrieren Sie ein Novita AI-Konto, um kostenlose Testguthaben zu erhalten. Öffnen Sie dann die 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-Key>"
export ANTHROPIC_MODEL="moonshotai/kimi-k2-instruct"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-instruct"
Auf Windows (Eingabeaufforderung):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Ihr Novita API-Key>
set ANTHROPIC_MODEL=moonshotai/kimi-k2-instruct
set ANTHROPIC_SMALL_FAST_MODEL=moonshotai/kimi-k2-instruct
ANTHROPIC_SMALL_FAST_MODEL steuert das leichte Modell, das Claude Code für schnelle interne Aufgaben wie Dateisuche und Kurzzusammenfassungen verwendet.
Claude Code starten
cd your-project
claude
Für Skripting und CI gilt derselbe Ansatz:
cat logs.txt | claude -p "find any error patterns" --output-format json
Die LLM-API von Novita AI unterstützt das Anthropic-Nachrichtenformat, einschließlich Tool-Nutzung, strukturierter Ausgaben und Streaming, sodass Claude Code ohne Änderungen funktioniert.
Agent Sandbox für isolierte Ausführung
Wenn Sie automatisierte Pipelines auf Basis von Claude Code erstellen, bietet der Agent Sandbox von Novita AI eine isolierte Ausführung für Agentenläufe, was für CI-Workflows und mehrstufige Codierungsaufgaben nützlich ist.
Claude Code als IDE-Werkzeug
Claude Code wird oft als “eine IDE” beschrieben, weil es sich in Ihren bestehenden Workflow einfügt, anstatt ihn zu ersetzen. Genauer gesagt ist es eine Agentenschicht, die mit Ihrem Terminal, Editor und Projektkontext zusammenarbeitet.
VS Code und Cursor
Installieren Sie die Claude Code-Erweiterung aus dem VS Code Marketplace oder dem Cursor Marketplace. Nach der Installation öffnen Sie die Befehlspalette, geben Sie “Claude Code” ein und wählen Sie In neuem Tab öffnen.
Die VS Code-Integration fügt eine Inline-Diff-Überprüfung, Dateierwähnungen, Planüberprüfung vor Bearbeitungen und den Gesprächsverlauf direkt im Editor-Bereich 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. Es bietet eine interaktive Diff-Ansicht und die gemeinsame Nutzung von Auswahlkontexten in IntelliJ IDEA, PyCharm, WebStorm und anderen JetBrains-IDEs.
Desktop-App und Web
Die Claude Code Desktop-App ermöglicht es Ihnen, Diffs visuell zu überprüfen und mehrere Sitzungen nebeneinander auszuführen. Die Weboberfläche unter claude.ai/code führt Sitzungen im Browser ohne lokale Einrichtung aus.
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. Standardmäßig ist es die API von Anthropic. Wenn Sie es auf https://api.novita.ai/anthropic setzen, wird der Verkehr an den Anthropic-kompatiblen Endpunkt von Novita AI weitergeleitet.
Was ist der Unterschied zwischen CLI-Flags und Slash-Befehlen?
CLI-Flags werden beim Start von claude aus Ihrer Shell gesetzt. Slash-Befehle werden innerhalb einer aktiven Sitzung ausgeführt und ändern das Verhalten mitten in der Unterhaltung.
Kann ich Claude Code ohne ein Claude-Abonnement verwenden?
Ja. claude auth login --console meldet Sie mit der API-Key-Abrechnung der Anthropic Console an. Wenn Sie über ANTHROPIC_BASE_URL zu Novita AI weiterleiten, benötigen Sie nur ein Novita AI-Konto.
Wie unterscheiden sich benutzerdefinierte Slash-Befehle von CLAUDE.md?
CLAUDE.md wird zu Beginn jeder Sitzung geladen und bleibt im Kontext. Skills werden nur bei Aufruf geladen. Verwenden Sie daher CLAUDE.md für immer aktive Projektinformationen und Skills für wiederholbare Prozeduren.
Funktioniert Claude Code in CI?
Ja. Verwenden Sie claude -p "query" --output-format json für den nicht-interaktiven Modus. Fügen Sie --max-budget-usd hinzu, um die Ausgaben zu begrenzen, und --max-turns, um die Ausführungszeit zu beschränken.
Novita AI ist eine KI-Cloud-Plattform, die Entwicklern eine einfache Möglichkeit bietet, KI-Modelle über unsere einfache API bereitzustellen, und gleichzeitig eine erschwingliche und zuverlässige GPU-Cloud zum Erstellen und Skalieren bereitstellt.
