Claude Code: Installation und erster Start

Der kürzeste Weg von der Installation zum ersten Start: ein Befehl richtet Claude Code mit QCode ein, dann nur noch den cr_-Schlüssel eintragen (2026).

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

Zuletzt überprüft: 2026-10-20 · 📄 Gemäß offizieller Dokumentation und qcode.cc (Claude Code Einrichtung; QCode-Seite zum Ein-Klick-Skript; geprüft am 2026-10-20)

Kürzester Weg

# macOS / Linux
curl -fsSL https://qcode.cc/install/claude-code.sh | bash

# Windows PowerShell
irm https://qcode.cc/install/claude-code.ps1 | iex

1. Führen Sie den Befehl für Ihr System aus.
2. Fügen Sie auf Aufforderung den API-Schlüssel ein, der mit cr_ beginnt: Das Skript misst die Latenz und wählt den Endpunkt, schreibt die Konfiguration, installiert Node.js, falls es fehlt, und sendet abschließend eine minimale Anfrage zur Prüfung der Verbindung.
3. Starten Sie nach Abschluss claude. Die Oberfläche des Skripts folgt der Systemsprache und wechselt automatisch zwischen Englisch und Chinesisch.

Dies ist ein umfassendes Claude Code Tutorial für Entwickler. Ob Sie neu in KI-Coding-Tools sind oder von anderen Tools migrieren — dieser Leitfaden hilft Ihnen, Claude Code zu beherrschen: den leistungsfähigsten KI-Coding-Assistenten 2026.

1. Was ist Claude Code¶

Ein agentischer Coding-Assistent, keine Codevervollständigung¶

Claude Code ist Anthropics offizieller CLI-agentischer Coding-Assistent. Im Gegensatz zu traditionellen Codevervollständigungs-Tools wie GitHub Copilot verhält es sich wie ein erfahrener Entwickler:

• Versteht die Aufgabe eigenständig: Sie beschreiben, was Sie möchten, es erstellt einen Plan
• Arbeitet direkt am Code: liest, bearbeitet und erstellt jede Datei im Projekt
• Führt Terminalbefehle aus: Tests, Abhängigkeitsinstallationen, Builds
• Versteht das Projekt tiefgehend: 200K Token Kontextfenster standardmäßig (claude-opus-5 / claude-sonnet-5 und weitere erweitern auf 1M)
• Dispatcht Subagenten: teilt eine komplexe Aufgabe auf mehrere spezialisierte Subagenten auf, die parallel laufen

Wer nutzt es¶

Seit der Veröffentlichung im Mai 2025 ist Claude Code ein zentrales Entwicklungswerkzeug bei führenden Unternehmen weltweit, darunter Netflix, Spotify, KPMG, L'Oréal und Salesforce. Es erreichte die Marke von $1B Jahresumsatz in nur sechs Monaten.

Wichtige Updates 2025-2026¶

Warum über QCode.cc¶

Claude Code direkt vom chinesischen Festland aus zu nutzen, führt zu zwei Problemen: das Netzwerk ist nicht erreichbar und die Kosten sind hoch. Über QCode.cc:

• Geringe Latenz auf Asien-Pazifik-Knoten — kein selbst gehosteter Proxy nötig
• Abrechnung nach Tokens — die Preise der einzelnen Modelle stehen auf qcode.cc/models
• Claude Code und Codex teilen ein Plan-Kontingent — ein Plan, zwei Tools
• Hohe Verfügbarkeit über Knoten hinweg (Asien / Nordamerika & Europa / global Route 53)

2. Installation & Einrichtung¶

Systemanforderungen¶

Claude Code läuft unter Windows nativ oder in WSL; Der native Installer braucht kein Node.js; das npm-Paket benötigt Node.js 22 oder neuer (offizielle Dokumentation, geprüft am 2026-10-20).

Claude Code installieren¶

Offiziell derzeit empfohlen: Native Install (geprüft am 2026-10-20):

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Homebrew
brew install --cask claude-code

Die Installation über npm funktioniert weiterhin:

# npm-Installation (weiterhin verfügbar)
npm install -g @anthropic-ai/claude-code

# Nutzer in China können das mit dem Taobao-Mirror beschleunigen
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

QCode.cc konfigurieren¶

Setzen Sie die Umgebungsvariablen in Ihrem Terminal:

# In ~/.bashrc oder ~/.zshrc eintragen
export ANTHROPIC_BASE_URL=https://api.qcode.cc/api
export ANTHROPIC_AUTH_TOKEN=cr_your_api_key

Warum ANTHROPIC_AUTH_TOKEN und nicht ANTHROPIC_API_KEY: Ein QCode.cc-Schlüssel, der mit cr_ beginnt, ist ein Drittanbieter-Gateway-Schlüssel, kein offizieller Anthropic-Schlüssel. Wenn Claude Code ANTHROPIC_AUTH_TOKEN sieht, sendet es Authorization: Bearer <token> an das Gateway; mit ANTHROPIC_API_KEY sendet es stattdessen x-api-key, was mit der OAuth-Sitzung eines Anthropic-Kontos kollidieren kann, bei dem Sie bereits angemeldet sind. Die Verwendung von ANTHROPIC_AUTH_TOKEN ist die offizielle QCode-Empfehlung.

Holen Sie sich Ihren API-Key in der QCode.cc Konsole; er beginnt mit cr_.

Endpunktauswahl: Der Standard ist https://api.qcode.cc/api (global Route 53 wählt automatisch den nächstgelegenen Knoten). Nutzer vom chinesischen Festland sollten asia.qcode.cc bevorzugen (Asien-Knoten, nächstgelegener von Korea / Taiwan / Hong Kong, geringste Latenz). Die anderen Domains (us / asia) und die BASE_URL-Regeln sind in Endpunkte & API-Formate beschrieben.

Wenden Sie die Konfiguration an:

source ~/.bashrc  # or source ~/.zshrc

Installation überprüfen¶

# Version prüfen
claude --version
# Gibt eine Versionsnummer aus (Ihre kann abweichen, siehe https://github.com/anthropics/claude-code/releases)

# Schnelltest
claude -p "Hello, please introduce yourself"

Wenn Claude antwortet, waren Installation und Konfiguration erfolgreich.

Shell-Vervollständigung (optional)¶

# Bash
claude completion bash >> ~/.bashrc

# Zsh
claude completion zsh >> ~/.zshrc

# Fish
claude completion fish > ~/.config/fish/completions/claude.fish

3. Erste Verwendung¶

Start¶

Führen Sie es in einem beliebigen Projektverzeichnis aus:

cd ~/my-project
claude

Claude Code durchsucht die Projektstruktur automatisch und wechselt in den interaktiven Modus.

Minimale Prüfung nach dem Start¶

# Prüfen, ob die CLI bereit ist
claude --version

# Eine minimale nicht-interaktive Anfrage
claude -p "Beschreibe in einem Satz, wofür dieses Projekt gedacht ist"

Wenn beide Befehle normal zurückkommen, sind CLI und QCode-Konfiguration aktiv.

Die Oberfläche lesen¶

╭─────────────────────────────────────────╮
│ claude                                   │
│                                          │
│ Project: my-project                      │
│ Model: claude-sonnet-5                   │
│ Context: 12,345 / 1,000,000 tokens       │
╰─────────────────────────────────────────╯

> _

Geben Sie Aufgaben in natürlicher Sprache ein – Claude versteht sie und handelt entsprechend.

Erste Aufgabe: das Projekt verstehen¶

> Analyse this project's architecture and tell me the main modules and how they relate

Claude führt automatisch folgende Schritte aus: 1. Liest package.json, README.md und die Verzeichnisstruktur 2. Überfliegt die wichtigsten Quelldateien 3. Erstellt eine strukturierte Architekturanalyse

Berechtigungsanfragen¶

Wenn Claude eine Aktion ausführen möchte, bittet es Sie um Bestätigung:

Claude wants to run:
  Tool: Bash
  Command: npm test

  [y] allow  [n] deny  [a] always allow in this session

• y: einmalig erlauben
• n: ablehnen
• a: diese Art von Aktion für den Rest der Sitzung immer erlauben (praktisch für die tägliche Entwicklung)

Gängige Berechtigungsmodi¶

4. Kernfunktionen¶

4.1 Plan-Modus¶

Der Plan-Modus veranlasst Claude, zunächst zu recherchieren und zu analysieren, bevor ein Plan vorgeschlagen wird. Er eignet sich für komplexe Aufgaben.

# In den Planungsmodus wechseln
> /plan

# Oder im Prompt auslösen
> Analyse the requirements and draft a plan first — don't change any code yet

Funktionsweise: 1. Claude analysiert die Codebasis und die Anforderungen 2. Es schlägt einen Plan vor (welche Dateien erstellt/geändert werden, in welcher Reihenfolge) 3. Sie prüfen den Plan und bitten um Änderungen 4. Nach der Bestätigung führt Claude den Plan aus

Beispiel:

> /plan
> I want to add JWT-based user authentication to this project

Claude: Let me analyse the current project structure and draft a plan...

📋 Plan:
1. Create src/middleware/auth.ts — JWT verification middleware
2. Create src/services/auth-service.ts — authentication business logic
3. Modify src/routes/index.ts — add login/register routes
4. Create src/models/user.ts — user data model
5. Add dependencies: jsonwebtoken, bcrypt
6. Create test files

Does this plan work? Anything to adjust?

4.2 Erweitertes Denken¶

Opus 5 (sowie 4.8 / 4.7, weiterhin im Angebot) verfügt über ein eingebautes erweitertes Denken – wir empfehlen adaptives Denken in Kombination mit dem effort-Parameter, siehe den Leitfaden zur Konfiguration des adaptiven Denkens. Bei schwierigen Problemen denkt Claude zunächst intern gründlich nach.

> I've been chasing this concurrency bug for two days. Analyse the race condition in src/worker.ts

[Claude reasons internally for thousands of tokens, walking execution paths, locking and timing]

Claude: Found it. On line 127 of worker.ts...

Wann es automatisch aktiv wird:

• Komplexes Debugging
• Analyse auf Architekturebene
• Mehrstufige Reasoning-Ketten

4.3 Sub-Agents¶

Claude kann spezialisierte Sub-Agents für bestimmte Aufgaben starten:

> Review this PR for me, and check for security issues at the same time

Claude: I'll start two subagents in parallel:

  - Subagent 1: code quality review
  - Subagent 2: security vulnerability scan

Sub-Agents laufen in einem eigenen Kontext, sodass sie die Hauptsitzung nicht belasten.

4.4 Wichtige Befehle¶

4.5 Kontextverwaltung¶

Claude Code verfügt über ein Kontextfenster von 200K Tokens. Lange Sitzungen müssen verwaltet werden:

# Aktuelle Kontextauslastung anzeigen
/cost

# Kontext komprimieren (Wichtiges behalten, Platz freigeben)
/compact

# Eine komplett neue Sitzung starten
/clear

Bewährte Praktiken:

• Führen Sie /compact aus, sobald die Kontextnutzung 70 % überschreitet
• Starten Sie bei einem Aufgabenwechsel eine neue Sitzung mit /clear
• Halten Sie Hintergrundinformationen bei komplexen Projekten in CLAUDE.md (/compact entfernt sie niemals)

5. CLAUDE.md — Projektkonfiguration¶

Warum Sie CLAUDE.md benötigen¶

Jedes Mal, wenn Claude Code startet, liest es die CLAUDE.md des Projekts, um die Architektur, Codestandards und lokalen Konventionen zu erfassen. Ohne diese Datei müssen Sie das Projekt in jeder Sitzung erneut erklären.

Schnell anlegen¶

# Claude analysiert das Projekt und erzeugt die Datei
/init

Datei-Hierarchie¶

Praxisvorlage: React + TypeScript-Projekt¶

# MyApp

## Tech Stack

- React 19 + TypeScript 5.x + Vite
- Styling: Tailwind CSS v4
- State: Zustand
- Testing: Vitest + Testing Library

## Commands

- Dev: `pnpm dev`
- Test: `pnpm test`
- Build: `pnpm build`
- Lint: `pnpm lint`

## Coding Standards

- Function components only; define Props with an interface
- The any type is not allowed
- CSS through Tailwind utility classes only
- Commit format: feat: / fix: / docs:

## Project Structure

- src/components/ — reusable components
- src/pages/ — page components
- src/hooks/ — custom hooks
- src/lib/ — utility functions
- src/api/ — API request wrappers

## Notes

- Node.js 22+, pnpm als Paketmanager
- All API requests go through src/api/client.ts

Die vollständige Anleitung finden Sie unter CLAUDE.md-Konfiguration.

6. Modellauswahl¶

Die drei Modelle im Vergleich¶

Die Abrechnung erfolgt pro Token; die Preise je Modell stehen auf qcode.cc/models (geprüft am 2026-10-20). Die Modelle der 4.x-Serie sind weiterhin im Angebot, sie sind lediglich nicht mehr standardmäßig ausgewählt.

Modelle wechseln¶

# Innerhalb einer interaktiven Sitzung wechseln
/model opus    # switch to Opus
/model sonnet  # switch to Sonnet
/model haiku   # switch to Haiku

# Beim Start angeben
claude --model claude-opus-5

Empfehlungen nach Szenario¶

Eine gemischte Strategie (empfohlen)¶

A day's model usage:
├── Sonnet 5 (70%) — tägliche Entwicklung, Bugfixes, Tests
├── Opus 5  (15%) — architecture decisions, hard problems
└── Haiku 4.5 (15%) — formatting, simple questions, bulk operations

Sie können jederzeit während einer Konversation wechseln:

# Zuerst mit Opus planen
/model opus
> Analyse this module's architecture and draft a refactoring plan

# Sobald der Plan steht, zur Ausführung auf Sonnet wechseln
/model sonnet
> Carry out step one of the plan

7. Erweiterte Tipps¶

Hooks¶

Konfigurieren Sie Automatisierungs-Hooks in .claude/settings.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write $FILEPATH"
          }
        ]
      }
    ]
  }
}

Vollständige Anleitung: Hooks-System.

MCP-Server¶

Verbinden Sie externe Tools über das Model Context Protocol:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    }
  }
}

Skills¶

Skills sind wiederverwendbare Wissensmodule:

# Verfügbare Skills auflisten
/skills

# Einen bestimmten Skill verwenden
> Committe diese Änderungen    # in natürlicher Sprache; /commit braucht einen eigenen Befehl oder Skill, nicht eingebaut
> /review    # review code with the review skill

--bare-Modus¶

Skriptbasierter Aufruf ohne interaktive Funktionen:

claude --bare -p "List every TODO comment" --output-format json

8. Praktische Beispiele¶

Beispiel 1: Ein unbekanntes Projekt erschließen¶

cd ~/unfamiliar-project
claude

> Analyse this project:
> 1. which technologies it uses
> 2. the core modules and their responsibilities
> 3. how data flows through it
> 4. draw a simple architecture diagram (ASCII)

Claude durchsucht package.json, die Quellcode-Verzeichnisse und die Konfigurationsdateien und erstellt eine vollständige Übersicht des Projekts.

Beispiel 2: Eine Funktion mit Plan Mode implementieren¶

> /plan
> I need to add rate limiting to the API:
> - at most 60 requests per minute per user
> - store counters in Redis
> - return 429 with a Retry-After header when exceeded

Claude:
📋 Plan:
1. Install dependency: ioredis
2. Create src/middleware/rate-limiter.ts
3. Create src/config/rate-limit.ts (settings)
4. Modify src/app.ts (register the middleware)
5. Create tests/rate-limiter.test.ts
6. Update docker-compose.yml (add the Redis service)

Confirm and I'll start.

> The plan looks good, go ahead

Beispiel 3: Einen schwierigen Bug debuggen¶

/model opus
> Users report that "stock occasionally goes negative when orders are placed concurrently".
> Analyse src/services/order-service.ts and src/services/inventory-service.ts,
> find the concurrency bug and fix it.

[Opus engages Extended Thinking and walks execution paths, locking and transaction isolation levels]

Claude: Found it. On line 45 of inventory-service.ts the stock check and the decrement are not in the same transaction,
which is a TOCTOU race. The fix is to use SELECT FOR UPDATE...

Beispiel 4: Batch-Refactoring¶

> All class components in the project need to become function components + Hooks.
> Work through every .tsx file under src/components/ one at a time.

Claude will:
1. Find every class component
2. Convert them one by one to function components
3. Turn lifecycle methods into useEffect
4. Turn this.state into useState
5. Run the tests to confirm nothing broke

Beispiel 5: Eine vollständige Testsuite schreiben¶

> Write a complete unit test suite for src/services/user-service.ts:
> - cover every public method
> - include both happy and error paths
> - mock external dependencies (database, cache)
> - target 90%+ coverage

Beispiel 6: CI/CD-Automatisierung¶

# In GitHub Actions
claude -p "Review the code changes in this PR, focusing on security and performance" \
  --output-format json \
  --max-turns 3 \
  --allowedTools Read,Glob,Grep

Weitere CI/CD-Beispiele: Automatisierung & CI/CD.

9. Claude Code + Codex zusammen¶

Claude Code und OpenAI Codex CLI sind die beiden stärksten AI-Coding-Tools des Jahres 2026, jeweils mit eigenen Stärken.

Die ideale Kombination: Claude Code plant und prüft, Codex führt aus und erledigt die Massenarbeit.

# 1. Claude Code entwirft den Plan
claude
> /plan
> Design an implementation plan for the user permission system

# 2. Codex führt ihn aus
codex "Follow the plan in PLAN.md and implement steps 1-3"

Ein QCode.cc-Tarif, ein gemeinsames Kontingent für beide Tools – das Wechseln kostet nichts. Vollständiger Vergleich: Codex vs. Claude Code. Codex-Anleitung: Komplettes Codex-Tutorial.

Arbeiten Sie im Team? Für Teams ab drei Personen empfehlen wir den Team-Tarif – eine dedizierte Domain e-xxx.qcode.cc, Verwaltung von Sub-API-Keys, Servicegarantie und Firmenüberweisung. Siehe Leitfaden zum Team-Tarif.

10. FAQ¶

Installation schlägt fehl¶

Q: npm install -g liefert einen Berechtigungsfehler

# Option 1: sudo verwenden
sudo npm install -g @anthropic-ai/claude-code

# Option 2: Node.js mit nvm verwalten (empfohlen)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code

Netzwerkprobleme¶

Q: Die Verbindung läuft in ein Timeout oder wird abgelehnt

# Konfiguration prüfen
echo $ANTHROPIC_BASE_URL    # should be https://api.qcode.cc/api
echo $ANTHROPIC_AUTH_TOKEN  # should start with cr_

# Verbindung testen
curl -s -o /dev/null -w '%{http_code}\n' \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" https://api.qcode.cc/api/v1/models
# -> 200 + JSON-Modellliste = Adresse, Schlüssel und Netzwerk sind in Ordnung

Kostenkontrolle¶

Q: Ich mache mir Sorgen um die Rechnung

• Nutzen Sie Sonnet im Alltag (Balance aus Leistung und Geschwindigkeit)
• Prüfen Sie die Ausgaben jederzeit mit /cost
• Verwenden Sie /compact, um den Kontext zu verkleinern und den Token-Verbrauch zu senken
• Leiten Sie einfache Aufgaben an Haiku (leicht und schnell) weiter
• Siehe den Leitfaden zur Kostenoptimierung

Claude versteht das Projekt nicht¶

Q: Claude interpretiert die Projektstruktur oder Konventionen immer wieder falsch

Erstellen Sie eine CLAUDE.md (siehe Kapitel 5) und notieren Sie dort den Projekthintergrund, Konventionen und häufig verwendete Befehle. Claude liest diese Datei automatisch bei jedem Start.

Abgrenzung zu anderen Tools¶

Q: Worin unterscheidet sich Claude Code von Cursor / Copilot?

Claude Code ist ein Assistent auf Agentenebene (es kann komplexe Aufgaben eigenständig abschließen), kein Werkzeug für Zeilenvervollständigung. Beide ergänzen sich gut: Cursor für Echtzeit-Bearbeitung und Vervollständigung, Claude Code für die Planung und Ausführung komplexer Aufgaben.

Hinweis: Derselbe QCode.cc-cr_-Key funktioniert mit Claude Code, Codex CLI und einer Vielzahl von IDEs / CLIs / Desktop-Apps, einschließlich Cursor. Für Cursor (benutzerdefinierte Base URL + API-Key) siehe Cursor-Editor-Integration; die Protokollmatrix und die vollständige Liste finden Sie unter Übersicht der Tool-Kompatibilität.

Weiterführende Dokumentation¶

• Installationsleitfaden — detaillierte Installationsschritte
• CLAUDE.md-Konfiguration — der vollständige Leitfaden zur Projektkonfiguration
• Hook-System — Automatisierungs-Hooks im Detail
• Automatisierung & CI/CD — Nutzung des Headless-Modus
• Modellauswahl-Leitfaden — detaillierter Modellvergleich
• Kostenoptimierung — Techniken zur Kostenkontrolle
• Codex vs. Claude Code — Vergleich der beiden Tools
• Vollständiges Codex-Tutorial — der vollständige Codex-Leitfaden
• Tarife & Preise — QCode.cc-Tarife

Enterprise →