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

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

```powershell
# 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](/docs/getting-started/one-click-install).

> 📖 Unsicher, was Sie in `ANTHROPIC_BASE_URL` eintragen oder welche der drei Zugangsdomains Sie wählen sollen? Siehe [Endpunkte & API-Pfade](./endpoints-and-api-paths).

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

<div data-os="windows" markdown="1">

## Windows

### Schritt 1: Node.js installieren

#### Option A: Offizieller Download (Empfohlen)

1. Öffnen Sie Ihren Browser und rufen Sie [https://nodejs.org/](https://nodejs.org/) auf

2. Klicken Sie auf den Download der „LTS“-Version (empfohlene Version mit langfristiger Unterstützung)

3. Doppelklicken Sie auf die heruntergeladene `.msi`-Datei

4. Folgen Sie dem Installationsassistenten mit den Standardeinstellungen

#### Option B: Mit einem Paketmanager

Falls Sie Chocolatey oder Scoop installiert haben:

```powershell
# Using Chocolatey
choco install nodejs

# Or using Scoop
scoop install nodejs
```

#### Installation überprüfen

```powershell
node --version
npm --version
```

### Schritt 2: Claude Code installieren

Öffnen Sie PowerShell oder CMD:

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

Installation überprüfen:

```powershell
claude --version
```

### Schritt 3: Umgebungsvariablen setzen

#### Temporär (Aktuelle Sitzung)

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

#### Permanent (Empfohlen)

```powershell
[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](https://qcode.cc/dashboard).

#### Einstellungen überprüfen

```powershell
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
```

### Schritt 4: Loslegen

```powershell
# 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?**

```powershell
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

</div>

<div data-os="macos" markdown="1">

## macOS

### Schritt 1: Node.js installieren

#### Option A: Mit Homebrew (Empfohlen)

```bash
brew update
brew install node
```

#### Option B: Offizieller Download

1. Rufen Sie [https://nodejs.org/](https://nodejs.org/) auf

2. Laden Sie die macOS-LTS-Version herunter

3. Öffnen Sie die heruntergeladene `.pkg`-Datei

4. Folgen Sie den Installationsanweisungen

#### Installation überprüfen

```bash
node --version
npm --version
```

### Schritt 2: Claude Code installieren

#### Option A: Mit npm

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

Bei Berechtigungsproblemen:

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

#### Option B: Mit Homebrew

```bash
brew install --cask claude-code
```

### Schritt 3: Umgebungsvariablen setzen

#### Temporär (Aktuelle Sitzung)

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

#### Permanent (Empfohlen)

Bearbeiten Sie Ihre Shell-Konfigurationsdatei:

```bash
# 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](https://qcode.cc/dashboard).

### Schritt 4: Loslegen

```bash
# 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“

</div>

<div data-os="linux" markdown="1">

## Linux / WSL2

### Schritt 1: Node.js installieren

#### Option A: Über NodeSource (Empfohlen)

```bash
# 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

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

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm
```

#### Installation überprüfen

```bash
node --version
npm --version
```

### Schritt 2: Claude Code installieren

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

Falls ein Berechtigungsproblem auftritt:

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

Installation überprüfen:

```bash
claude --version
```

### Schritt 3: Umgebungsvariablen setzen

#### Temporär

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

#### Permanent

```bash
# 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

```bash
cd /path/to/your/project
claude
```

### Linux FAQ

**Fehlende Build-Abhängigkeiten?**

```bash
# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"
```

</div>

## Erweiterte Konfiguration (Optionale Umgebungsvariablen)

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

### ANTHROPIC_MODEL

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.

```bash
# 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):

```bash
export MAX_THINKING_TOKENS=16000
```

### CLAUDE_CODE_EFFORT_LEVEL

Anpassen des Anstrengungslevels von Claude:

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

### CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

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

```bash
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
```

## Nächste Schritte

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

1. Schauen Sie sich den [Schnellstart](/docs/getting-started/quick-start) an, um die grundlegende Nutzung kennenzulernen

2. Entdecken Sie [CLI-Tipps](/docs/usage/cli-tips), um Ihre Effizienz zu steigern