Installation und Einrichtung

Claude Code unter Windows, macOS und Linux installieren und konfigurieren

Aktualisiert 2026-10-01

Auf dieser Seite

Installation ¶

⚡ Empfehlung: Setup mit einem Klick — ein einzelner Befehl erledigt alles auf dieser Seite (Endpunkt-Geschwindigkeitstest, Konfiguration, Installation von Node.js / Claude Code, Verbindungstest; ohne sudo). Lesen Sie weiter für die manuelle Installation.

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

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

Weitere Informationen zu Flags, Problembehandlung und Rollback finden Sie im Abschnitt Setup-Skript mit einem Klick.

📖 Unsicher, was Sie in ANTHROPIC_BASE_URL eintragen oder welche der drei Zugangsdomains Sie wählen sollen? Siehe Endpunkte & API-Pfade.

Folgen Sie dieser Anleitung, um Claude Code einfach auf Ihrem Computer zu installieren und zu verwenden. Der gesamte Vorgang dauert nur 5 Minuten.

Voraussetzungen ¶

Claude Code benötigt Node.js. Bitte stellen Sie sicher, dass Node.js 18.0 oder höher auf Ihrem Computer installiert ist (22 LTS empfohlen).

Windows ¶

Schritt 1: Node.js installieren ¶

Option A: Offizieller Download (Empfohlen)¶

Öffnen Sie Ihren Browser und rufen Sie https://nodejs.org/ auf
Klicken Sie auf den Download der „LTS“-Version (empfohlene Version mit langfristiger Unterstützung)
Doppelklicken Sie auf die heruntergeladene .msi-Datei
Folgen Sie dem Installationsassistenten mit den Standardeinstellungen

Option B: Mit einem Paketmanager ¶

Falls Sie Chocolatey oder Scoop installiert haben:

# Using Chocolatey
choco install nodejs

# Or using Scoop
scoop install nodejs

Installation überprüfen ¶

node --version
npm --version

Schritt 2: Claude Code installieren ¶

Öffnen Sie PowerShell oder CMD:

npm install -g @anthropic-ai/claude-code

Installation überprüfen:

claude --version

Schritt 3: Umgebungsvariablen setzen ¶

Temporär (Aktuelle Sitzung)¶

$env:ANTHROPIC_BASE_URL = "https://api.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"

Permanent (Empfohlen)¶

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.qcode.cc/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key", [System.EnvironmentVariableTarget]::User)

Ersetzen Sie your-api-key durch Ihren tatsächlichen API-Key im QCode.cc Dashboard.

Einstellungen überprüfen ¶

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

Schritt 4: Loslegen ¶

# Go to your project directory
cd C:\path\to\your\project

# Start Claude Code
claude

Windows FAQ ¶

Berechtigungsfehler?

Führen Sie PowerShell als Administrator aus
Oder weisen Sie npm Ihr Benutzerzeichnis zu: npm config set prefix %APPDATA%\npm

Fehler bei der PowerShell-Ausführungsrichtlinie?

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Umgebungsvariablen werden nicht übernommen?

Starten Sie PowerShell oder CMD nach dem permanenten Setzen neu
Oder melden Sie sich bei Windows ab und wieder an

macOS ¶

Schritt 1: Node.js installieren ¶

Option A: Mit Homebrew (Empfohlen)¶

brew update
brew install node

Option B: Offizieller Download ¶

Rufen Sie https://nodejs.org/ auf
Laden Sie die macOS-LTS-Version herunter
Öffnen Sie die heruntergeladene .pkg-Datei
Folgen Sie den Installationsanweisungen

Installation überprüfen ¶

node --version
npm --version

Schritt 2: Claude Code installieren ¶

Option A: Mit npm ¶

npm install -g @anthropic-ai/claude-code

Bei Berechtigungsproblemen:

sudo npm install -g @anthropic-ai/claude-code

Option B: Mit Homebrew ¶

brew install --cask claude-code

Schritt 3: Umgebungsvariablen setzen ¶

Temporär (Aktuelle Sitzung)¶

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"

Permanent (Empfohlen)¶

Bearbeiten Sie Ihre Shell-Konfigurationsdatei:

# For zsh (macOS default)
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc

# For bash
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bash_profile
source ~/.bash_profile

Ersetzen Sie your-api-key durch Ihren tatsächlichen API-Key im QCode.cc Dashboard.

Schritt 4: Loslegen ¶

# Go to your project directory
cd /path/to/your/project

# Start Claude Code
claude

macOS FAQ ¶

Berechtigungsfehler?

Mit sudo installieren: sudo npm install -g @anthropic-ai/claude-code
Oder weisen Sie npm Ihr Benutzerzeichnis zu: npm config set prefix ~/.npm-global

macOS blockiert die Binary?

Öffnen Sie „Systemeinstellungen“ → „Datenschutz & Sicherheit“
Klicken Sie auf „Trotzdem öffnen“ oder „Erlauben“

Linux / WSL2 ¶

Schritt 1: Node.js installieren ¶

Option A: Über NodeSource (Empfohlen)¶

# Add the NodeSource repository
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# Install Node.js
sudo apt-get install -y nodejs

Option B: Über den System-Paketmanager ¶

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

Installation überprüfen ¶

node --version
npm --version

Schritt 2: Claude Code installieren ¶

npm install -g @anthropic-ai/claude-code

Falls ein Berechtigungsproblem auftritt:

sudo npm install -g @anthropic-ai/claude-code

Installation überprüfen:

claude --version

Schritt 3: Umgebungsvariablen setzen ¶

Temporär ¶

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"

Permanent ¶

# For bash (default)
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bashrc
source ~/.bashrc

# For zsh
echo 'export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc

Schritt 4: Loslegen ¶

cd /path/to/your/project
claude

Linux FAQ ¶

Fehlende Build-Abhängigkeiten?

# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"

Erweiterte Konfiguration (Optionale Umgebungsvariablen)¶

Über die zwei erforderlichen Variablen hinaus können Sie mit diesen optionalen Variablen weitere Anpassungen vornehmen:

Geben Sie das Standardmodell an. Wir empfehlen, ausdrücklich Sonnet 5 zu setzen. Falls nichts gesetzt ist, verwendet Claude Code das jeweils eingebaute Standardmodell der CLI-Version – verlassen Sie sich nicht auf einen historischen Standardnamen von dieser Seite. 4.x-IDs wie claude-sonnet-4-6 und claude-opus-4-8 sind weiterhin erhältlich.

# Daily recommendation (Sonnet 5)
export ANTHROPIC_MODEL=claude-sonnet-5

# Heavy work (Opus 5, higher cost)
export ANTHROPIC_MODEL=claude-opus-5

MAX_THINKING_TOKENS ¶

Steuern Sie die maximale Token-Anzahl für den Denkprozess des Modells (auf 0 setzen zum Deaktivieren):

export MAX_THINKING_TOKENS=16000

CLAUDE_CODE_EFFORT_LEVEL ¶

Anpassen des Anstrengungslevels von Claude:

# Options: low / medium / high
export CLAUDE_CODE_EFFORT_LEVEL=high

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ¶

Nicht erforderliche Netzwerkanfragen deaktivieren (z. B. Telemetrie):

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Nächste Schritte ¶

Glückwunsch! Sie haben Claude Code erfolgreich installiert. Weiter:

Schauen Sie sich den Schnellstart an, um die grundlegende Nutzung kennenzulernen
Entdecken Sie CLI-Tipps, um Ihre Effizienz zu steigern

← Vorheriges

Endpunkte & API-Pfade

Umgebungsvariablen

Installation und Einrichtung

Verwandte Dokumente