Schnellstart
Die Grundlagen von Claude Code in 5 Minuten lernen
Brauchen Sie einen API-Key? Registrieren →Endpunkte & Base-URLs →
Auf dieser Seite
- Claude Code starten
- Kerninteraktionen
- Dateien mit @ referenzieren
- Pipe-Eingabe
- Häufige Slash-Befehle
- Tastenkombinationen
- Projektkonfiguration initialisieren
- Praxisbeispiele
- Effizienz-Tipps
- Wichtige Einstellungen
- Sitzungsverwaltung: einige offizielle Befehle
- Häufige Fehler und Fehlersuche
- FAQ
- Nächste Schritte
⚡ Noch nicht eingerichtet? Ein Befehl erledigt alles:
curl -fsSL https://qcode.cc/install/claude-code.sh | bash(Windows:irm https://qcode.cc/install/claude-code.ps1 | iex). Siehe One-Click-Installationsskript.Noch keinen Key? Wählen Sie zuerst einen Tarif und holen Sie sich den Key: Der Key wird bei jeder Option gleich verwendet, die folgenden Schritte ändern sich also nicht.
Nachdem Sie die Installation und Umgebungskonfiguration abgeschlossen haben, meistern Sie die Kernfunktionen von Claude Code in 5 Minuten.
Claude Code starten¶
Navigieren Sie im Terminal zu Ihrem Projektverzeichnis und führen Sie aus:
cd /path/to/your/project
claude
Sie sehen die interaktive Oberfläche von Claude Code, bereit für eine Konversation.
Kerninteraktionen¶
1. Code verstehen¶
> What's the architecture of this project?
> Explain how src/auth/login.ts works
> Find all places that call the database
2. Code generieren¶
> Write a user registration API endpoint
> Add unit tests for the UserService class
> Create a React login form component
3. Vorhandenen Code bearbeiten¶
> Refactor utils.js to improve readability
> Fix the memory leak in handleSubmit function
> Add TypeScript types to all public functions
4. Probleme debuggen¶
> Why is the user redirected to 404 after login?
> Analyze this error: TypeError: Cannot read property 'id' of undefined
> Investigate why the API response is slow
5. Git-Operationen¶
> Show me what files I've modified
> Commit these changes with a good commit message
> Create a PR description
Dateien mit @ referenzieren¶
Verwenden Sie das Symbol @, um bestimmte Dateien präzise zu referenzieren, sodass Claude deren Inhalt direkt lesen kann:
> Review @src/components/Header.tsx and optimize performance
> Compare @src/v1/api.js with @src/v2/api.js
> Analyze project dependencies based on @package.json
Tipp: Drücken Sie Tab nach der Eingabe von @, um Dateipfade automatisch zu vervollständigen.
Pipe-Eingabe¶
Leiten Sie die Ausgabe anderer Befehle zur Analyse an Claude Code weiter:
# Explain git changes
git diff | claude "explain these code changes"
# Analyze log errors
cat error.log | claude "analyze these errors and provide solutions"
# Review PR changes
gh pr diff 123 | claude "review this PR for code quality"
Häufige Slash-Befehle¶
Verwenden Sie /-Befehle während einer Sitzung:
| Befehl | Beschreibung |
|---|---|
/help |
Hilfeinfos und alle verfügbaren Befehle anzeigen |
/clear |
Aktuellen Konversationsverlauf löschen |
/compact |
Konversationsverlauf komprimieren, um Tokens zu sparen |
/model |
Modelle anzeigen oder wechseln (z. B. opus, sonnet) |
/memory |
Projektdatei CLAUDE.md bearbeiten |
/init |
Projektkonfiguration automatisch generieren |
| Einfach sagen: „Committe diese Änderungen“ | Claude prüft die Änderungen, erzeugt eine Commit-Nachricht und committet (/commit braucht einen eigenen Befehl oder Skill von Ihnen oder einem Plugin und ist nicht eingebaut) |
/review |
Code-Review |
/cost |
Kosten der aktuellen Sitzung anzeigen |
/doctor |
Installations- und Konfigurationsprobleme diagnostizieren |
/config |
Konfiguration anzeigen oder bearbeiten |
/mcp |
Status der MCP-Server anzeigen |
/loop |
Claude Code im autonomen Loop-Modus ausführen |
/bug |
Ein Problem melden |
Tastenkombinationen¶
| Tastenkombination | Funktion |
|---|---|
Tab |
Dateipfade automatisch vervollständigen |
Esc |
Aktuelle Ausgabe unterbrechen |
Ctrl+C |
Aktuelle Operation abbrechen |
↑ / ↓ |
Befehlsverlauf durchblättern |
Projektkonfiguration initialisieren¶
Führen Sie bei der ersten Verwendung /init aus, damit Claude Ihr Projekt analysiert und die Konfiguration generiert:
> /init
Dadurch wird eine Datei CLAUDE.md mit folgendem Inhalt erstellt:
-
Technologie-Stack und Architekturüberblick des Projekts
-
Übliche Build- und Testbefehle
-
Code-Stil-Richtlinien
-
Projektspezifische Konventionen
Zweck von CLAUDE.md: Claude Code liest diese Datei beim Start automatisch ein, damit die KI den Projektkontext besser versteht.
Praxisbeispiele¶
Beispiel 1: Eine neue Funktion hinzufügen¶
> I need to add a user avatar upload feature with:
1. Support for JPG/PNG formats
2. 2MB file size limit
3. Auto-crop to 200x200 after upload
4. Store in S3
Beispiel 2: Einen Fehler beheben¶
> User feedback: Page freezes after clicking "Save" button
> Please investigate the issue in @src/pages/EditProfile.tsx
Beispiel 3: Code-Review¶
> /review
> Focus on security issues and performance bottlenecks
Beispiel 4: Intelligentes Commit¶
> Committe diese Änderungen und schreibe eine gute Commit-Nachricht
Claude führt automatisch Folgendes aus:
-
Alle Änderungen analysieren
-
Eine passende Commit-Nachricht generieren
-
Das Commit abschließen
Effizienz-Tipps¶
-
Präzise formulieren: Beschreiben Sie klar, was Sie benötigen, einschließlich Einschränkungen
-
Aufteilen: Komplexe Aufgaben in kleinere Schritte zerlegen
-
Frühzeitig unterbrechen: Drücken Sie
Esc, sobald die Ausgabe nicht Ihren Erwartungen entspricht -
Referenzen nutzen: Verwenden Sie
@, um Dateien anzugeben, statt die KI raten zu lassen -
Kontext beibehalten: Claude erinnert sich in derselben Sitzung an den vorherigen Konversationsverlauf
Wichtige Einstellungen¶
Für den Einstieg genügen vier Stellen, den Rest schauen Sie bei Bedarf an:
| Einstellung | Wirkung | Ort |
|---|---|---|
ANTHROPIC_BASE_URL |
Verweist auf QCode: https://api.qcode.cc/api (in Festlandchina https://asia.qcode.cc/api), ohne abschließenden Schrägstrich |
Umgebungsvariable oder der env-Block in ~/.claude/settings.json |
ANTHROPIC_AUTH_TOKEN |
Ihr QCode-Schlüssel mit Präfix cr_ |
Wie oben |
/model |
Modell in der Sitzung anzeigen oder wechseln, z. B. claude-sonnet-5 |
Befehl in der Sitzung |
CLAUDE.md |
Projektbeschreibung, wird bei jedem Start automatisch gelesen | Projektstamm, erzeugt mit /init |
Die vollständige Variablenliste steht unter Umgebungsvariablen, die Einrichtung in einem Schritt unter Ein-Klick-Einrichtungsskript.
Sitzungsverwaltung: einige offizielle Befehle¶
Stand 2026-10-15 gilt laut Claude-Code-Dokumentation:
/usagezeigt Kosten und Verbrauch der Sitzung,/costist ein Alias dafür;claude --continuesetzt die letzte Sitzung im aktuellen Verzeichnis fort,claude --resumelistet Sitzungen zur Auswahl auf, und in einer Sitzung funktioniert/resume;- um erst einen Plan zu sehen, ohne dass Dateien geändert werden, wechseln Sie mit
Shift+Tabzwischen den Berechtigungsmodi; zeigt die Statusleiste⏸ plan mode on, ist der Planmodus aktiv und es wird nichts bearbeitet, bevor Sie den Plan genehmigen.
Häufige Fehler und Fehlersuche¶
| Symptom | Mögliche Ursache | Abhilfe |
|---|---|---|
401 / Invalid API key |
Schlüssel falsch oder mit Leerzeichen, oder eine übrig gebliebene ANTHROPIC_API_KEY in der Umgebung übernimmt die Authentifizierung |
Mit env \| grep -i anthropic Reste suchen, entfernen und das Terminal neu öffnen |
402 / insufficient_quota |
Kontingent aufgebraucht (täglich, gesamt oder wöchentlich); der Key selbst ist in Ordnung | code in der Antwort prüfen: Das Tageskontingent wird um 00:00 Pekinger Zeit zurückgesetzt, Booster-Packs sind verfügbar; siehe Fehlercode-Referenz |
| 404 | /v1 an die Base URL angehängt oder abschließender Schrägstrich |
Zurück auf https://api.qcode.cc/api setzen |
model_not_available_on_endpoint |
In Claude Code wurde ein GPT-Modell gewählt | Claude Code nutzt die Anthropic-Schnittstelle, daher gehen nur Claude und chinesische Modelle; für GPT Codex verwenden |
Langsame Antworten, E015 / 429 |
Die Unterhaltung ist zu lang, der Kontext fast voll | Zuerst /compact, sonst Sitzung neu starten; siehe Kontextverwaltung |
| Gar keine Verbindung | Netzwerk oder System-Proxy-Variablen stören | asia.qcode.cc ausprobieren, dann Punkt 6 in der Fehlerbehebung prüfen |
Ist unklar, auf welcher Ebene der Fehler liegt, führen Sie den curl-Test aus Abschnitt 5 von Endpunkte und API-Formate aus: Eine Antwort 400 oder 401 bedeutet, dass der Pfad erreichbar ist.
FAQ¶
Wie prüfe ich, dass Anfragen wirklich über QCode laufen?¶
Geben Sie Ihren API Key auf probe.qcode.cc ein; dort sehen Sie Modell und Tokens der letzten Anfragen. Erscheint nichts, sind die Anfragen nicht bei QCode angekommen – prüfen Sie dann die Umgebungsvariablen.
Wo sehe ich, was eine Sitzung gekostet hat?¶
In der Sitzung zeigt /usage (oder /cost) den Verbrauch der aktuellen Sitzung. Der Verbrauch auf Kontoebene steht in der QCode-Konsole. QCode rechnet pro Token ab; die Preise je Modell finden Sie unter qcode.cc/models.
Kann ich nach dem Schließen des Terminals das letzte Gespräch fortsetzen?¶
Ja. Führen Sie im selben Projektverzeichnis claude --continue aus, um die letzte Sitzung fortzusetzen, oder claude --resume, um eine aus der Liste zu wählen.
Mit welchem Modell fange ich an?¶
Nehmen Sie für den Alltag claude-sonnet-5 und wechseln Sie für schwierigere Aufgaben mit /model zu einem stärkeren Modell; einen Vergleich finden Sie unter Modellauswahl.
Was, wenn ich GPT oder chinesische Modelle nutzen möchte?¶
Claude Code selbst verwendet die Anthropic-Schnittstelle, chinesische Modelle lassen sich also direkt wählen. Für GPT-Modelle nutzen Sie die Codex CLI; die Einrichtung steht in der vollständigen Codex-Anleitung.
Nächste Schritte¶
Herzlichen Glückwunsch – Sie beherrschen die Grundlagen von Claude Code! Machen Sie weiter mit:
-
Entdecken Sie CLI-Tipps mit 34 praktischen Hinweisen
-
Lernen Sie Workflow-Tipps, um Ihre Produktivität zu steigern
-
Sehen Sie sich Codex-Integration an, um ein weiteres KI-Tool zu nutzen
Mit QCode starten
Ein API-Key für Claude Code, Codex und mehr – Abrechnung pro Token, Preise je Modell auf qcode.cc/models