Schnellstart

Die Grundlagen von Claude Code in 5 Minuten lernen

Aktualisiert 2026-10-16

Brauchen Sie einen API-Key? Registrieren →Endpunkte & Base-URLs →

Auf dieser Seite

⚡ 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:

  1. Alle Änderungen analysieren

  2. Eine passende Commit-Nachricht generieren

  3. Das Commit abschließen

Effizienz-Tipps

  1. Präzise formulieren: Beschreiben Sie klar, was Sie benötigen, einschließlich Einschränkungen

  2. Aufteilen: Komplexe Aufgaben in kleinere Schritte zerlegen

  3. Frühzeitig unterbrechen: Drücken Sie Esc, sobald die Ausgabe nicht Ihren Erwartungen entspricht

  4. Referenzen nutzen: Verwenden Sie @, um Dateien anzugeben, statt die KI raten zu lassen

  5. 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:

  • /usage zeigt Kosten und Verbrauch der Sitzung, /cost ist ein Alias dafür;
  • claude --continue setzt die letzte Sitzung im aktuellen Verzeichnis fort, claude --resume listet 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+Tab zwischen 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:

  1. Entdecken Sie CLI-Tipps mit 34 praktischen Hinweisen

  2. Lernen Sie Workflow-Tipps, um Ihre Produktivität zu steigern

  3. 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

Enterprise →