Claude Code installieren: der Befehl für Windows, macOS und Linux — und wie Sie es ohne Abonnement verwenden

Für die Installation von Claude Code genügt ein Befehl: Führen Sie unter macOS, Linux oder WSL curl -fsSL https://claude.ai/install.sh | bash aus; unter Windows führen Sie im PowerShell irm https://claude.ai/install.ps1 | iex aus (in der Eingabeaufforderung, also CMD, verwenden Sie die Zeile aus install.cmd weiter unten). Öffnen Sie anschließend ein neues Terminal, prüfen Sie die Installation mit claude --version und führen Sie claude aus, um zu beginnen. Bei der ersten Verbindung gibt es zwei Wege: Melden Sie sich mit einem Pro-, Max-, Team-, Enterprise- oder Console-Konto an (der kostenlose Claude.ai-Plan umfasst Claude Code nicht) oder setzen Sie die beiden Umgebungsvariablen ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN und verwenden Sie einen nutzungsabhängig bezahlten API-Schlüssel — ganz ohne Abonnement.

Überprüfte Befehle vom 11. September 2026 in der offiziellen Installationsdokumentation von Anthropic.

Vor der Installation

Unter macOS und Linux installieren

Öffnen Sie das Terminal und fügen Sie Folgendes ein:

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

Dies ist die empfohlene Methode: Sie installiert eine eigenständige Binärdatei, die sich im Hintergrund selbst aktualisiert. Die Verknüpfung befindet sich in ~/.local/bin/claude, und ein bereits geöffnetes Terminal erkennt den neuen PATH nicht — öffnen Sie daher vor dem Testen ein weiteres Fenster. In WSL ist der Befehl derselbe.

Unter Windows installieren

Unter Windows gibt es zwei verschiedene Varianten; der einzige Unterschied ist das Terminal, in dem Sie sich befinden. Beginnt die Eingabeaufforderung mit PS C:\Users\SeuNome>, ist es PowerShell; ohne PS, nur mit C:\Users\SeuNome>, handelt es sich um die Eingabeaufforderung (CMD). Sie müssen es nicht als Administrator ausführen.

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

:: Windows Prompt de Comando (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Das Einfügen der Zeile in das falsche Terminal ist der häufigste Fehler. Die CMD-Zeile in PowerShell ergibt The token '&&' is not a valid statement separator; die PowerShell-Zeile in CMD ergibt 'irm' is not recognized as an internal or external command (unter portugiesischem Windows „wird nicht als interner oder externer Befehl erkannt“). Und curl … | bash von macOS in PowerShell ergibt A parameter cannot be found that matches parameter name 'fsSL'. In allen drei Fällen genügt es, die richtige Zeile zu verwenden.

Die Installation von Git for Windows ist optional, wird aber empfohlen: Claude Code verwendet die enthaltene Git Bash zum Ausführen von Befehlen; ohne sie wird PowerShell verwendet. Wenn Git installiert ist und Git Bash trotzdem nicht gefunden wird, setzen Sie CLAUDE_CODE_GIT_BASH_PATH im env-Block der Einstellungen auf den bash.exe.

Führen Sie in WSL die macOS/Linux-Zeile innerhalb des WSL-Terminals aus und öffnen Sie claude ebenfalls dort — nicht in PowerShell oder CMD.

Über den Paketmanager

Es funktioniert, mit einem wichtigen Unterschied: Keines davon aktualisiert sich standardmäßig automatisch. Sie aktualisieren manuell (brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode). Es gibt außerdem signierte apt-, dnf- und apk-Repositories für Debian/Ubuntu, Fedora/RHEL und Alpine.

# Homebrew (macOS, Linux) — canal stable
brew install --cask claude-code

# WinGet (Windows)
winget install Anthropic.ClaudeCode

# npm — exige Node.js 22 ou mais novo; nunca com sudo
npm install -g @anthropic-ai/claude-code

Über npm erfordert das Paket seit Version 2.1.198 Node.js 22 oder neuer; bei einer älteren Node-Version zeigt npm nur eine Warnung EBADENGINE an und die Installation wird abgeschlossen. Das Paket installiert dieselbe native Binärdatei, die zum Ausführen kein Node.js verwendet. Verwenden Sie niemals sudo npm install -g: Das verursacht Berechtigungsprobleme und stellt ein Sicherheitsrisiko dar.

Installation überprüfen

claude --version   # imprime a versão, por exemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico da instalação e das configurações, sem abrir sessão

Merken Sie sich claude doctor: Ohne eine Sitzung zu öffnen, zeigt es den Installationsstatus, Fehler in Konfigurationsdateien und die empfohlene Korrektur an — so erkennen Sie am schnellsten, ob das Problem bei der Installation oder der Konfiguration liegt.

Wenn command not found: claude erscheint (oder unter Windows, dass claude nicht erkannt wird), befindet sich der Installationsordner nicht im PATH. Öffnen Sie unter macOS und Linux ein neues Terminal; falls das nicht hilft, fügen Sie ~/.local/bin im ~/.zshrc oder ~/.bashrc zum PATH hinzu. Unter Windows lautet der Ordner %USERPROFILE%\.local\bin; prüfen Sie dies und fügen Sie ihn über PowerShell hinzu:

# 1. Veja se a pasta de instalação já está no PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sem saída? Adicione ao PATH do usuário e abra um terminal novo
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. No terminal novo: se houver duas instalações, aparecem dois caminhos
where.exe claude

Erste Verbindung: Abonnement oder API-Schlüssel

Weg A — Anmeldung mit dem Abonnement

Führen Sie im Projektordner claude aus und folgen Sie der Browser-Anmeldung mit einem Pro-, Max-, Team-, Enterprise- oder Console-Konto. Ein häufig verwirrendes Detail: Wenn die Variable ANTHROPIC_API_KEY bereits gesetzt ist, fragt Claude Code einmal, ob dieser Schlüssel verwendet werden soll. Wenn Sie ablehnen, ignoriert es die Variable künftig stillschweigend und fragt nicht erneut — es wirkt dann, als würde die Variable nicht gelesen. Um sie wieder zu aktivieren, gehen Sie zu /config → Use custom API key.

Weg B — ohne Abonnement, mit nutzungsabhängig bezahltem Schlüssel

Claude Code liest ANTHROPIC_BASE_URL nativ, daher ist es eine unterstützte Konfiguration, es auf jeden beliebigen Endpunkt der Anthropic Messages API zu verweisen — ohne Plugin, Proxy oder modifizierte Binärdatei. Der Ablauf: Erstellen Sie das Konto, laden Sie das Guthaben auf (mindestens $10), erzeugen Sie einen sk-kn--Schlüssel im Schlüssel-Dashboard (er wird nur einmal angezeigt) und setzen Sie die Variablen. Unter macOS und Linux:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # só o domínio, sem /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 zum Testen in einem PowerShell-Fenster:

# Vale só para esta janela do 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 eine dauerhafte Einstellung ist der env-Block der Benutzereinstellungsdatei am besten geeignet, ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json). Dort gelten die Variablen für jedes Terminal, die Editor-Erweiterung und Hintergrundprozesse. Wenn die Datei bereits andere Einstellungen enthält, fügen Sie nur den env-Block 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"
  }
}

Jede dieser Zeilen hat einen wichtigen Stolperstein:

• ANTHROPIC_BASE_URL enthält nur die Domain. Claude Code fügt /v1/messages hinzu; mit /v1 am Ende geht die Anfrage an /v1/v1/messages und gibt 404 zurück.
• Verwenden Sie ANTHROPIC_AUTH_TOKEN, nicht ANTHROPIC_API_KEY. Sie werden in unterschiedlichen HTTP-Headern übertragen: Der erste sendet Authorization: Bearer und gilt sofort; der zweite sendet x-api-key und durchläuft außerdem die oben beschriebene einmalige Genehmigung.
• Schreiben Sie den exakten Modellnamen in ANTHROPIC_MODEL. Kunavo erkennt nur den identischen Namen und übersetzt keine alten Namen mit Datumssuffix.
• Fixieren Sie außerdem ANTHROPIC_DEFAULT_OPUS_MODEL und ANTHROPIC_DEFAULT_SONNET_MODEL. Das Standardmodell von Claude Code und der Alias opus verweisen auf das neueste Opus. Wenn Kunavo es noch nicht anbietet, gibt die erste Anfrage 404 zurück. Der Alias sonnet fordert bereits Sonnet 5.5 an, das Kunavo nicht anbietet: Ohne Fixierung von /model sonnet erhalten die Ausführungsphase von opusplan und die Subagenten mit model: sonnet eine 404-Antwort. Der Alias opus ist auf Opus 5.5 (claude-opus-5-5) fixiert, das Claude Code v2.1.280 oder neuer erfordert — führen Sie bei einer älteren Installation claude update aus.
• ANTHROPIC_DEFAULT_HAIKU_MODEL deckt die Hintergrundaufrufe ab, die Claude Code selbstständig ausführt (Zusammenfassungen, Titel). Auf Haiku zu verweisen spart ohne zusätzlichen Aufwand Kosten.

Legen Sie den Schlüssel niemals in .claude/settings.json des Projekts ab — diese Datei gelangt in git und zu jedem, der das Repository klont. In der VS-Code-Erweiterung befinden sich die Variablen in claudeCode.environmentVariables, in den Benutzereinstellungen von VS Code selbst, da die Erweiterung die Zugangsdaten vor dem Start überprüft.

Tarife pro 1M Tokens, aus dem Katalog:

Um das Modell innerhalb der Sitzung zu wechseln, verwenden Sie /model mit dem vollständigen Namen (zum Beispiel /model claude-opus-5-5) oder starten Sie Claude Code mit claude --model claude-opus-5-5. Was ein Monat Nutzung kostet und wann sich das Abonnement eher lohnt, steht im Claude-Code-Preisleitfaden.

So erkennen Sie, welcher Weg aktiv ist

Führen Sie in Claude Code /status aus. Eine Zeile Auth token bedeutet, dass der Schlüssel verwendet wird; eine Zeile Login method mit einem claude.ai-Konto bedeutet, dass die Variable nicht gelesen wurde. Beides wird nicht kombiniert: Wenn die Variable gesetzt ist, bleibt das Abonnement inaktiv; entfernen Sie die Variable, kehrt Claude Code zum Abonnement zurück, ohne dass eine Neuinstallation erforderlich ist.

Hinter einem Gateway ändern sich drei Dinge: Remote Control und Spracheingabe funktionieren nicht (sie erfordern die Identität von claude.ai); /fast kann melden, dass der Schnellmodus nicht verfügbar ist, weil diese Prüfung direkt bei Anthropic erfolgt, die normalen Anfragen jedoch unverändert bleiben; und die Zahlen von /context werden zu lokalen Schätzungen. Code, Tools, Subagents, MCP, Hooks und Prompt-Caching funktionieren unverändert. Einzelheiten stehen in der Integrationsdokumentation (auf Englisch).

Aus Brasilien bezahlen – Pix im Checkout

Das Abonnement von claude.ai ist eine wiederkehrende Belastung in US-Dollar und erfordert eine für Auslandskäufe freigeschaltete internationale Karte. Beim API-Schlüssel-Weg läuft die Aufladung über den Stripe-Checkout, und Pix wird als Zahlungsmethode für Zahlungen aus Brasilien angezeigt: Der Preis lautet auf USD, und Stripe zeigt den umgerechneten Betrag in brasilianischen Real an, bevor Sie bestätigen. Internationale Karten (Visa, Mastercard, American Express), Apple Pay, Google Pay und Link werden ebenfalls im Checkout angezeigt. Das Guthaben ist vorausbezahlt — Mindestaufladung $10, Guthaben ohne Ablaufdatum, fehlgeschlagene Anfragen werden nicht berechnet — und für jeden Schlüssel kann ein monatliches Ausgabenlimit gelten. Die Schritt-für-Schritt-Anleitung mit jeder einzelnen Ansicht finden Sie unter So bezahlen Sie die API mit Pix.

Häufige Fehler

Nach der Installation

Führen Sie bei der ersten Verwendung /init im Projekt aus: Claude Code liest das Repository und erstellt ein CLAUDE.md mit den Testbefehlen und Konventionen, die es findet. Prüfen Sie diese Datei und halten Sie sie kurz — sie wird in jeder Sitzung geladen. Zwischen unabhängigen Aufgaben startet /clear ein neues Gespräch; bei einer lang gewordenen Aufgabe fasst /compact den Verlauf zusammen und macht weiter.

Ehrlich gesagt: Wer Claude Code viele Stunden pro Tag nutzt, fährt mit der monatlichen Abonnementgebühr meist günstiger; Pay-as-you-go lohnt sich bei schwankender Nutzung oder wenn Sie nicht an das 5-Stunden-Fenster gebunden sein möchten — und ein ungenutzter Monat kostet null. Über Kunavo nutzen Sie gemeinsam genutzte Kapazität, ohne dediziertes Kontingent und ohne vertragliches SLA; wer diese Garantien benötigt, sollte direkt bei Anthropic buchen.

Häufig gestellte Fragen