Zum Hauptinhalt springen
Claude Code ist ein terminalbasierter Coding-Agent, der Ihre Codebasis versteht und Ihnen hilft, durch Befehle in natürlicher Sprache schneller zu programmieren — Routineaufgaben ausführen, komplexen Code erklären und Git-Workflows verwalten. Claude Code wird noch leistungsfähiger mit dem Coding Plan — der Pro-Tarif bietet mehr als Claude Pro (20 USD/Monat), der Max-Tarif bietet mehr als Claude Max (200 USD/Monat). Programmieren Sie schneller, debuggen Sie intelligenter und verwalten Sie Workflows nahtlos mit mehr Tokens und höherer Zuverlässigkeit.

Schritt 1: Claude Code installieren

Voraussetzungen: Node.js 18 oder neuer
# Claude Code installieren
npm install -g @anthropic-ai/claude-code
Wenn Sie während der Installation Berechtigungsfehler erhalten, versuchen Sie sudo (MacOS/Linux) zu verwenden oder führen Sie die Eingabeaufforderung als Administrator aus (Windows).

Schritt 2: Coding Plan konfigurieren

1

API-Schlüssel erhalten

2

Umgebungsvariablen konfigurieren

Es gibt 2 Konfigurationsmöglichkeiten: über settings.json-Datei (empfohlen) oder über Exportieren von Umgebungsvariablen.

Schritt 1: Korrekten Pfad der settings.json-Datei ermitteln

Die Konfigurationsdatei befindet sich je nach Betriebssystem an unterschiedlichen Speicherorten:
Pfad: %USERPROFILE%\.claude\settings.jsonBeispiel: C:\Users\IhrName\.claude\settings.json

Schritt 2: settings.json zum Bearbeiten öffnen

Wählen Sie eine der folgenden Methoden zum Öffnen der Datei:
# Unter Windows (Git Bash oder WSL)
claude --settings "$USERPROFILE\.claude\settings.json"

# Unter macOS/Linux
claude --settings ~/.claude/settings.json
Dieser Befehl öffnet die Datei im Standard-Editor Ihres Systems. Falls es nicht funktioniert, verwenden Sie eine andere Methode unten.

Schritt 3: Konfiguration zur Datei hinzufügen

Fügen Sie die env-Felder zur settings.json-Datei hinzu:
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "ihr_api_schluessel",
    "ANTHROPIC_BASE_URL": "https://api.vibecodecheap.com/v1/ai",
    "API_TIMEOUT_MS": "3000000"
  }
}
Ersetzen Sie ihr_api_schluessel durch Ihren VibeCodeCheap API-Schlüssel und speichern Sie die Datei.

Häufige Problembehebung

Ursache: Befehle wie code, cursor befinden sich möglicherweise nicht im PATH, oder die Datei wird am falschen Ort geöffnet.Lösung:
  1. Dateispeicherort überprüfen:
    # Windows (PowerShell)
    ls $env:USERPROFILE\.claude\settings.json
    
    # macOS/Linux
    ls -la ~/.claude/settings.json
    
  2. Falls Datei nicht existiert, Verzeichnis und Datei erstellen:
    # Windows (PowerShell)
    mkdir -Force $env:USERPROFILE\.claude
    echo '{"env":{}}' > $env:USERPROFILE\.claude\settings.json
    
    # macOS/Linux
    mkdir -p ~/.claude
    echo '{"env":{}}' > ~/.claude/settings.json
    
  3. Datei mit absolutem Pfad öffnen:
    # Windows
    code "C:\Users\IhrName\.claude\settings.json"
    
    # macOS
    code "/Users/IhrName/.claude/settings.json"
    
  1. JSON-Format überprüfen: JSONLint zur Validierung verwenden
  2. Alle Terminals schließen, die Claude Code ausführen
  3. Neues Terminal öffnen und claude erneut ausführen
  4. /status in Claude Code ausführen, um die Konfiguration zu überprüfen
Ursache: Das .claude-Verzeichnis wurde nicht erstellt, da Claude Code noch nicht ausgeführt wurde.Lösung:
  1. claude einmal ausführen (kann sofort beendet werden)
  2. Oder manuell erstellen:
    # Windows
    mkdir %USERPROFILE%\.claude
    
    # macOS/Linux
    mkdir -p ~/.claude
    
Ursache: Claude Code kann settings.json in einigen Fällen automatisch überschreiben.Lösung:
  1. Sicherungskopie der Konfigurationsdatei erstellen:
    cp ~/.claude/settings.json ~/.claude/settings.json.backup
    
  2. Datei sperren, um Überschreiben zu verhindern (nur bei Bedarf):
    # macOS/Linux
    chmod 444 ~/.claude/settings.json
    
    # Windows (PowerShell - als Administrator ausführen)
    Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $true
    
  3. Entsperren, wenn Bearbeitung erforderlich:
    # macOS/Linux
    chmod 644 ~/.claude/settings.json
    
    # Windows (PowerShell)
    Set-ItemProperty -Path "$env:USERPROFILE\.claude\settings.json" -Name IsReadOnly -Value $false
    
Ursache: WSL verwendet Windows Node.js anstelle der Linux-Version.Überprüfen:
which node
which npm
# Falls Ergebnis /mnt/c/... ist, wird Windows Node verwendet
Lösung:
  1. Node.js für Linux installieren:
    # Mit nvm (empfohlen)
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
    source ~/.bashrc
    nvm install --lts
    
    # Oder mit Paketmanager
    sudo apt update
    sudo apt install nodejs npm
    
  2. PATH-Priorität korrigieren - Zu ~/.bashrc oder ~/.zshrc hinzufügen:
    # Sicherstellen, dass nvm geladen wird
    export NVM_DIR="$HOME/.nvm"
    [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
    
    # Linux-Pfade priorisieren
    export PATH="$HOME/.local/bin:/usr/local/bin:/usr/bin:$PATH"
    
  3. Änderungen anwenden:
    source ~/.bashrc
    
Ursache: macOS hat Gatekeeper und SIP (System Integrity Protection) Sicherheit.Lösung:
  1. Terminal Dateizugriff erlauben:
    • Systemeinstellungen > Datenschutz & Sicherheit > Festplattenvollzugriff öffnen
    • Terminal.app oder iTerm2 hinzufügen
  2. Verzeichnisberechtigungen korrigieren:
    sudo chown -R $(whoami) ~/.claude
    chmod -R u+w ~/.claude
    

Schritt 3: Mit Claude Code beginnen

Nach der Konfiguration können Sie Claude Code im Terminal verwenden:
cd your-project-directory
claude
Wenn Sie Windows verwenden, müssen Sie claude beim ersten Mal mit Git Bash oder Ubuntu (WSL) ausführen.
Beim ersten Ausführen von Claude Code sehen Sie möglicherweise eine Sicherheitsabfrage, die um Dateizugriffsberechtigung bittet:
Do you trust the files in this folder?

 Claude Code may read, write, or execute files contained in this directory. 
 This can pose security risks, so only use files from trusted sources.

 ❯ 1. Yes, proceed
   2. No, exit
Wählen Sie “Yes, proceed” und drücken Sie Enter, um Claude Code Zugriff auf die Dateien in Ihrem Projektverzeichnis zu gewähren.

FAQ

Wie wechsle ich das verwendete Modell

Zuordnung zwischen Claude Code internen Modell-Umgebungsvariablen und Modellen:
ModellMultiplikatorKontext
claude-sonnet-4-51x200K Tokens
claude-sonnet-4-5-202509291x200K Tokens
claude-opus-4-5-202511012x200K Tokens
gpt-5-mini0x (kostenlos)128K Tokens
glm-4.60x (kostenlos)200K Tokens
glm-4.70x (kostenlos)200K Tokens
gpt-5-mini, glm-4.6 und glm-4.7 sind kostenlose Modelle mit unbegrenzter Nutzung bei Abonnement des Coding Plans auf VibeCodeCheap.
Wenn Sie anpassen müssen, können Sie die Konfigurationsdatei ~/.claude/settings.json direkt bearbeiten:
{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5-20250929",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-5-20251101"
  }
}

Wie überprüfe ich den aktuellen Modellstatus

Öffnen Sie ein neues Terminal und führen Sie claude aus, geben Sie /help ein, um alle verfügbaren Befehle zu sehen.
  • Geben Sie /status ein, um den aktuellen Modellstatus zu überprüfen.
  • Geben Sie /models ein, um alle verfügbaren Modelle aufzulisten.

Manuelle Konfiguration funktioniert nicht

Wenn Sie die ~/.claude/settings.json-Datei bearbeitet haben, aber die Änderungen nicht wirksam werden:
  • Schließen Sie alle Claude Code-Fenster, öffnen Sie ein neues Terminal und führen Sie claude erneut aus.
  • Wenn es immer noch nicht funktioniert, versuchen Sie, die ~/.claude/settings.json-Datei zu löschen und neu zu konfigurieren.
  • Bestätigen Sie, dass das JSON-Format korrekt ist, überprüfen Sie Variablennamen und stellen Sie sicher, dass keine Kommas fehlen oder zu viel sind.

Empfohlene Claude Code-Version

Wir empfehlen die Verwendung der neuesten Version von Claude Code:
# Aktuelle Version überprüfen
claude --version

# Auf neueste Version aktualisieren
claude update