Claude Code Installationsanleitung — macOS-, Windows-Befehle und Verbindung per Abo oder API-Schlüssel nach der Installation

Für die Installation von Claude Code genügt ein Befehl: Unter macOS, Linux und WSL führst du curl -fsSL https://claude.ai/install.sh | bash aus; unter Windows in PowerShell irm https://claude.ai/install.ps1 | iex (in der Eingabeaufforderung CMD dagegen die folgende Zeile install.cmd). Öffne nach der Installation ein neues Terminal, prüfe mit claude --version und starte anschließend mit claude. Für die erste Verbindung gibt es zwei Wege: Anmeldung mit einem Pro-, Max-, Team-, Enterprise- oder Console-Konto (der kostenlose Claude.ai-Tarif umfasst Claude Code nicht) oder Konfiguration von ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN als nutzungsbasierte API-Schlüssel; dafür ist überhaupt kein Abonnement erforderlich.

Befehle geprüft am 11. September 2026, gemäß der offiziellen Installationsdokumentation von Anthropic. Diese Seite behandelt nur Installation und erste Verbindung; die tägliche Nutzung nach der Installation wird im Claude-Code-Tutorial beschrieben.

Vor der Installation prüfen

Installation unter macOS

Öffne das „Terminal“ und füge diese Zeile ein:

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

Dies ist die offiziell empfohlene native Installationsmethode: Installiert wird eine eigenständige ausführbare Datei, die sich automatisch im Hintergrund aktualisiert. Der Einstiegspunkt der ausführbaren Datei befindet sich unter ~/.local/bin/claude. Bereits geöffnete Terminals lesen den neuen PATH nicht ein. Öffne daher nach der Installation ein neues Fenster. Unter Linux und WSL wird derselbe Befehl verwendet.

Installation unter Windows

Unter Windows gibt es zwei verschiedene Befehle. Der Unterschied hängt nur davon ab, welches Terminal du geöffnet hast. Wenn die Eingabeaufforderung PS C:\Users\你的名字> enthält, handelt es sich um PowerShell; ohne PS und mit nur C:\Users\你的名字> handelt es sich um die Eingabeaufforderung (CMD). Administratorrechte sind nicht erforderlich.

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

:: Windows 命令提示字元（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Das Einfügen am falschen Ort ist der häufigste Fehler unter Windows. Wenn du den CMD-Befehl in PowerShell ausführst, erscheint The token '&&' is not a valid statement separator; wenn du den PowerShell-Befehl in CMD ausführst, erscheint 'irm' is not recognized as an internal or external command. Wenn du den macOS-Befehl curl … | bash in PowerShell einfügst, erscheint A parameter cannot be found that matches parameter name 'fsSL'. In allen drei Fällen musst du lediglich die passende Zeile verwenden.

Die zusätzliche Installation von Git for Windows wird empfohlen: Claude Code verwendet die enthaltene Git-Bash zum Ausführen von Befehlen; wenn sie nicht installiert ist, wird PowerShell verwendet. Wenn Git Bash installiert ist, aber nicht gefunden wird, füge im Abschnitt env der Konfigurationsdatei CLAUDE_CODE_GIT_BASH_PATH hinzu und verweise auf den Pfad zu bash.exe.

Wenn du WSL auswählst, führe die oben angegebene macOS-/Linux-Zeile im WSL-Terminal aus und starte claude ebenfalls in WSL, nicht in PowerShell oder CMD.

Installation mit einem Paketmanager

Du kannst auch deinen vorhandenen Paketmanager verwenden. Der Nachteil ist, dass standardmäßig keine automatische Aktualisierung erfolgt; du musst regelmäßig selbst aktualisieren (zum Beispiel mit brew upgrade claude-code oder winget upgrade Anthropic.ClaudeCode). Für Debian/Ubuntu, Fedora/RHEL und Alpine gibt es außerdem offiziell signierte apt-, dnf- und apk-Paketquellen.

# Homebrew（macOS、Linux）— stable 通道
brew install --cask claude-code

# WinGet（Windows）
winget install Anthropic.ClaudeCode

# npm — 需要 Node.js 22 以上；絕對不要加 sudo
npm install -g @anthropic-ai/claude-code

Für die Installation über npm wird seit v2.1.198 Node.js 22 oder höher benötigt. Bei älteren Versionen gibt npm lediglich die Warnung EBADENGINE aus, die Installation wird aber abgeschlossen. Installiert wird dieselbe ausführbare Datei wie beim nativen Installationsprogramm; zur Laufzeit ist Node.js nicht erforderlich. Verwende keinesfalls sudo npm install -g. Dadurch können Berechtigungsprobleme entstehen, außerdem besteht ein Sicherheitsrisiko.

Installation überprüfen

claude --version   # 正常會印出版本號，例如 2.1.211 (Claude Code)
claude doctor      # 唯讀的安裝與設定診斷，不會開啟工作階段

claude doctor ist besonders wichtig: Es startet keine Sitzung, sondern zeigt nur den Installationsstatus, Fehler in Konfigurationsdateien und empfohlene Korrekturen an. Damit lässt sich am schnellsten unterscheiden, ob die Installation oder die Konfiguration fehlerhaft ist.

Wenn command not found: claude oder unter Windows 'claude' is not recognized erscheint, befindet sich das Installationsverzeichnis nicht im PATH. Öffne unter macOS/Linux zunächst ein neues Terminal und versuche es erneut. Wenn es weiterhin nicht funktioniert, füge ~/.local/bin zum PATH von ~/.zshrc oder ~/.bashrc hinzu. Das Installationsverzeichnis unter Windows ist %USERPROFILE%\.local\bin. Prüfe es mit PowerShell und füge es hinzu:

# 1. 檢查安裝目錄是否已在 PATH 裡
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 沒有任何輸出的話，把它加進「使用者」PATH，然後關掉終端機重開
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 重開後再確認一次；若有兩份安裝，這行會列出兩個路徑
where.exe claude

Erste Verbindung: Abonnement-Login oder nutzungsbasierter Abrechnungsschlüssel

Weg A: Mit dem Abonnementkonto anmelden

Führe im Projektordner claude aus und melde dich anhand der Browseranweisungen mit deinem Pro-, Max-, Team-, Enterprise- oder Console-Konto an. Ein Detail ist wichtig: Wenn in der Umgebung bereits ANTHROPIC_API_KEY vorhanden ist, fragt Claude Code stattdessen einmal, ob du diesen Schlüssel verwenden möchtest. Wenn du diese Abfrage ablehnst, ignoriert es den Schlüssel danach stillschweigend und fragt nicht erneut nach – es wirkt dann, als würde die Variable nicht gelesen. Zum erneuten Aktivieren gehe in /config zu Use custom API key.

Weg B: Ohne Abonnement, stattdessen mit nutzungsbasierter Abrechnung

Claude Code unterstützt ANTHROPIC_BASE_URL nativ. Daher ist die Verwendung jedes Endpunkts, der die Anthropic Messages API bereitstellt, eine offiziell unterstützte Konfiguration – ohne Plugin, Proxy oder modifizierte ausführbare Datei. Die Schritte sind: Konto registrieren, Guthaben aufladen (mindestens $10), auf der Schlüsselverwaltungsseite einen Schlüssel mit dem Präfix sk-kn- erstellen (wird nur einmal angezeigt) und anschließend die folgenden Variablen festlegen. macOS/Linux:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # 只寫到網域，不要加 /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

Unter Windows kannst du zunächst in einem PowerShell-Fenster testen:

# 只對這個 PowerShell 視窗有效，關掉就沒了
$env:ANTHROPIC_BASE_URL = "https://api.kunavo.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-kn-..."
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Für die dauerhafte Nutzung empfiehlt es sich, dies im Benutzerprofil ~/.claude/settings.json im Abschnitt env zu speichern (unter Windows ist es %USERPROFILE%\.claude\settings.json). Einstellungen an dieser Stelle werden von jedem Terminal, jeder Editor-Erweiterung und jedem Hintergrundprozess gelesen. Wenn die Datei bereits andere Einstellungen enthält, füge env einfach hinzu:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kunavo.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

An jeder dieser sechs Zeilen gibt es eine Stelle, deren falsche Einstellung Sie lange aufhalten kann:

• ANTHROPIC_BASE_URL enthält nur die Domain. Claude Code hängt /v1/messages selbst an. Wenn du zusätzlich /v1 einträgst, wird daraus /v1/v1/messages und die Antwort lautet 404.
• Verwende ANTHROPIC_AUTH_TOKEN, nicht ANTHROPIC_API_KEY. Beide werden in unterschiedlichen HTTP-Headern übertragen: Ersteres sendet Authorization: Bearer und wird sofort wirksam; Letzteres sendet x-api-key und erfordert zusätzlich die oben beschriebene einmalige Bestätigung.
• ANTHROPIC_MODEL muss den vollständigen, korrekten Modellnamen enthalten. Kunavo akzeptiert nur exakt übereinstimmende Namen und ordnet alte Namen mit Datums-Suffix nicht automatisch zu.
• ANTHROPIC_DEFAULT_OPUS_MODEL ist für den Alias opus zuständig. Das Standardmodell von Claude Code und der Alias opus verweisen beide auf das neueste Opus. Wenn Kunavo dieses Modell noch nicht anbietet, wird 404 zurückgegeben. Daher müssen diese Zeile und ANTHROPIC_MODEL festgelegt werden. Hier wird der Alias opus auf Opus 5.5 (claude-opus-5-5) festgelegt. Dafür ist Claude Code v2.1.280 oder höher erforderlich; bei älteren Versionen führen Sie zunächst claude update aus.
• ANTHROPIC_DEFAULT_SONNET_MODEL ist für den Alias sonnet zuständig. In der Anthropic API verweist der Alias sonnet auf Sonnet 5.5, das Kunavo nicht anbietet. Ohne eine feste Zuordnung würden /model sonnet, die Ausführungsphasen von opusplan und Subagenten mit der Einstellung model: sonnet einen 404-Fehler zurückgeben. Daher wird er hier ebenfalls auf Claude Sonnet 5 (claude-sonnet-5) festgelegt.
• ANTHROPIC_DEFAULT_HAIKU_MODEL ist für Hintergrundaufrufe zuständig. Von Claude Code selbst erstellte Zusammenfassungen und Titel verwenden dieses Modell: Claude Haiku 4.5 pro 1M Token $0.70 / $3.50; das Hauptmodell Claude Sonnet 5 kostet $1.40 / $7.00 (zum gleichen Preis wie bei Anthropic).

Schreibe den Schlüssel nicht in .claude/settings.json im Projekt – diese Datei wird committed und mit allen Personen geteilt, die das Projekt klonen. Wenn du die VS-Code-Erweiterung verwendest, muss die Variable in den VS-Code-Benutzereinstellungen unter claudeCode.environmentVariables stehen, da die Erweiterung die Anmeldedaten bereits vor dem Start prüft.

Überprüfen, welcher Weg verbunden ist

Führe nach dem Start von Claude Code /status aus. Wenn die Zeile Auth token angezeigt wird, ist der Schlüssel aktiv. Wenn Login method erscheint und ein claude.ai-Konto aufgelistet wird, wurde die Variable nicht gelesen. Beides wird nicht kombiniert: Solange die Schlüsselvariable vorhanden ist, wird das angemeldete Abonnement zurückgestellt; entferne die Variable, um zum Abonnement zurückzukehren – eine Neuinstallation ist nicht erforderlich.

Bei der Verwendung des Gateways gibt es drei Unterschiede: Remote Control und Spracheingabe benötigen eine claude.ai-Identität und sind nicht verfügbar; die Verfügbarkeitsprüfung von /fast fragt direkt bei Anthropic an und kann „nicht verfügbar“ anzeigen, ohne dass normale Anfragen betroffen sind; die Zahlen von /context werden zu lokalen Schätzungen. Programmierung, Tools, Subagenten, MCP, Hooks und Prompt-Caching funktionieren wie gewohnt. Die vollständigen Hinweise stehen in der Claude-Code-Integrationsdokumentation und im Leitfaden für Claude-Code-API-Schlüssel (beide auf Englisch).

Häufige Fehler im Überblick

Nach der Installation

Beim ersten Öffnen des Projekts führe zunächst /init aus, damit das gesamte Projekt gelesen und CLAUDE.md erzeugt wird. Wie du danach je nach Aufgabe zwischen Opus, Sonnet und Haiku wechselst, wie viel eine Sitzung tatsächlich kostet und wie du mit /clear und /compact die Kosten senkst, wird im Claude-Code-Tutorial erklärt.

Welche Option du wählst, sollte man ehrlich sagen: Wer täglich lange interagiert und viel nutzt, fährt mit der festen monatlichen Abonnementgebühr normalerweise günstiger. Nutzungsbasierte Abrechnung eignet sich für stark schwankende Nutzung oder wenn du nicht durch ein 5-Stunden-Nutzungsfenster eingeschränkt sein möchtest; in Monaten ohne Nutzung sind es $0. Über Kunavo nutzt du gemeinsam genutzte Kapazität, ohne dediziertes Kontingent und ohne vertragliches SLA. Teams, die diese Garantien benötigen, sollten direkt bei Anthropic einkaufen. Die monatlichen Kosten und der Break-even-Punkt beider Wege stehen unter Claude-Code-Kosten.

Häufig gestellte Fragen