Claude Code unter Windows, macOS und Linux installieren — und ohne Abonnement nutzen

Für die Installation von Claude Code genügt ein Befehl: Unter macOS, Linux oder WSL führen Sie curl -fsSL https://claude.ai/install.sh | bash aus; unter Windows irm https://claude.ai/install.ps1 | iex in PowerShell (in der Eingabeaufforderung CMD verwenden Sie die Zeile aus install.cmd weiter unten). Öffnen Sie anschließend ein neues Terminal, prüfen Sie mit claude --version, wechseln Sie in den Projektordner und führen Sie claude aus; der erste nützliche Befehl ist /init. Für die Verbindung gibt es zwei Wege: Anmeldung mit einem Pro-, Max-, Team-, Enterprise- oder Console-Konto (der kostenlose Claude.ai-Tarif enthält Claude Code nicht) oder die Definition zweier Umgebungsvariablen, ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN, mit einem nutzungsabhängig abgerechneten API-Schlüssel ohne Abonnement.

Am 11. September 2026 geprüfte Befehle mit der offiziellen Installationsdokumentation von Anthropic.

Voraussetzungen

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 ein eigenständiges Binärprogramm, das sich automatisch im Hintergrund aktualisiert. Die ausführbare Datei wird in ~/.local/bin/claude abgelegt; ein bereits geöffnetes Terminal sieht den neuen PATH nicht. Öffnen Sie daher vor dem Testen ein neues Fenster. In WSL ist der Befehl identisch.

Claude Code unter Windows installieren

Unter Windows gibt es zwei unterschiedliche Zeilen; nur das Terminal ändert sich. Wenn der Prompt mit PS C:\Users\TuNombre> beginnt, befinden Sie sich in PowerShell; ohne PS, also nur mit C:\Users\TuNombre>, in der Eingabeaufforderung (CMD). Die Ausführung als Administrator ist nicht erforderlich.

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

:: Windows Símbolo del sistema (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 einem spanischen Windows „wird nicht als interner oder externer Befehl erkannt“); und curl … | bash von macOS, in PowerShell eingefügt, ergibt A parameter cannot be found that matches parameter name 'fsSL'. In allen drei Fällen genügt es, die passende Zeile zu verwenden.

Die Installation von Git for Windows ist optional, aber empfehlenswert: Claude Code verwendet dessen Git Bash zum Ausführen von Befehlen und nutzt ohne Git Bash PowerShell. Wenn Git installiert ist und Git Bash trotzdem nicht gefunden wird, definieren Sie CLAUDE_CODE_GIT_BASH_PATH im Block env der Konfiguration mit dem Pfad zu bash.exe.

Führen Sie unter WSL die macOS/Linux-Zeile im WSL-Terminal aus und öffnen Sie claude dort, nicht in PowerShell oder CMD.

Mit einem Paketmanager

Dies funktioniert ebenfalls, mit einem wichtigen Unterschied: Keiner aktualisiert sich standardmäßig automatisch (Sie müssen brew upgrade claude-code oder winget upgrade Anthropic.ClaudeCode ausführen). Außerdem gibt es 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 — requiere Node.js 22 o posterior; nunca con sudo
npm install -g @anthropic-ai/claude-code

Bei npm benötigt das Paket ab Version 2.1.198 Node.js 22 oder höher; mit einer älteren Node-Version zeigt npm nur eine Warnung EBADENGINE und die Installation wird abgeschlossen. Es installiert dasselbe native Binärprogramm, das zur Ausführung kein Node.js verwendet. Verwenden Sie niemals sudo npm install -g: Dies verursacht Berechtigungsprobleme und stellt ein Sicherheitsrisiko dar.

Installation überprüfen

claude --version   # imprime la versión, por ejemplo 2.1.211 (Claude Code)
claude doctor      # diagnóstico de la instalación y la configuración, sin abrir sesión

Verwenden Sie claude doctor: Ohne Anmeldung zeigt der Befehl den Installationsstatus, Fehler in den Konfigurationsdateien und die empfohlene Lösung an. So lässt sich am schnellsten feststellen, ob die Installation oder die Konfiguration fehlschlägt.

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

# 1. Comprueba si la carpeta de instalación ya está en el PATH
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. ¿Sin salida? Añádela al PATH de usuario y abre una terminal nueva
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. En la terminal nueva: si hay dos instalaciones, verás dos rutas
where.exe claude

Erste Verbindung: Abonnement oder API-Schlüssel

Option A — mit Ihrem Abonnement anmelden

Führen Sie im Projektordner claude aus und folgen Sie der Anmeldung im Browser mit einem Pro-, Max-, Team-, Enterprise- oder Console-Konto. Ein verwirrendes Detail: Wenn die Variable ANTHROPIC_API_KEY bereits definiert ist, fragt Claude Code einmalig, ob Sie diesen Schlüssel verwenden möchten. Wenn Sie Nein wählen, ignoriert es ihn künftig, ohne erneut zu fragen, sodass es scheint, als würde die Variable nicht gelesen. So aktivieren Sie sie wieder: /config → Use custom API key.

Option B — ohne Abonnement mit einem nutzungsabhängig abgerechneten Schlüssel

Claude Code liest ANTHROPIC_BASE_URL nativ, daher ist die Weiterleitung an jeden Endpoint der Anthropic Messages API eine unterstützte Konfiguration: ohne Plugins, Proxy oder modifizierte Binärprogramme. Die Schritte: Konto erstellen, Guthaben aufladen (mindestens $10), einen sk-kn--Schlüssel im Schlüsselbereich erzeugen (er wird nur einmal angezeigt) und diesen env-Block zu Ihrer Benutzerkonfiguration ~/.claude/settings.json hinzufügen (unter Windows %USERPROFILE%\.claude\settings.json). So wird er von allen Terminals, der Editor-Erweiterung und Hintergrundprozessen verwendet:

{
  "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"
  }
}

Um zunächst in einem einzelnen PowerShell-Fenster zu testen:

# Solo para esta ventana de PowerShell (en macOS/Linux: export VARIABLE=valor)
$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

• 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 funktioniert sofort; der zweite sendet x-api-key und durchläuft zusätzlich die oben beschriebene einmalige Genehmigung.
• Schreiben Sie den exakten Modellnamen in ANTHROPIC_MODEL. Kunavo erkennt nur den identischen Namen und übersetzt keine älteren Namen mit Datum.
• Lege auch ANTHROPIC_DEFAULT_OPUS_MODEL fest. Das Standardmodell von Claude Code und sein Alias opus verweisen auf das neueste Opus. Falls Kunavo es noch nicht anbietet, gibt die erste Anfrage einen 404-Fehler zurück. Hier wird der Alias opus auf Claude Opus 5.5 (claude-opus-5-5) festgelegt; dafür ist Claude Code v2.1.280 oder höher erforderlich. Führe bei einer älteren Version claude update aus.
• Und auch ANTHROPIC_DEFAULT_SONNET_MODEL. Der Alias sonnet fordert Sonnet 5.5 an, das Kunavo nicht anbietet: Ohne diese Variable liefern /model sonnet, die Ausführungsphase von opusplan und mit sonnet konfigurierte Subagenten einen 404-Fehler zurück. Durch das Setzen auf claude-sonnet-5 wird dies verhindert.
• ANTHROPIC_DEFAULT_HAIKU_MODEL deckt die Hintergrundaufrufe ab, die Claude Code selbst ausführt (Zusammenfassungen, Titel): Die Weiterleitung an Haiku spart mühelos Kosten.

Legen Sie den Schlüssel niemals in die .claude/settings.json des Projekts: Diese Datei wird in das Repository übernommen. In der VS-Code-Erweiterung gehören die Variablen in claudeCode.environmentVariables, innerhalb der VS-Code-Benutzerkonfiguration, weil die Erweiterung die Anmeldedaten vor dem Start prüft.

Tarife pro 1M Token, aus dem Katalog gelesen:

So erkennen Sie, welche Option 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 zusammen mit einem claude.ai-Konto bedeutet, dass die Variable nicht gelesen wurde. Sie werden nicht addiert: Solange die Variable vorhanden ist, wird das Abonnement pausiert; entfernen Sie sie, kehrt Claude Code zum Abonnement zurück, ohne dass eine Neuinstallation erforderlich ist.

Hinter einem Gateway ändern sich drei Dinge: Remote Control und die Spracheingabe sind nicht verfügbar (sie benötigen die Identität von claude.ai); /fast kann melden, dass der Schnellmodus nicht verfügbar ist, weil diese Prüfung direkt bei Anthropic erfolgt, obwohl sich normale Anfragen nicht ändern; und die Werte von /context werden zu lokalen Schätzungen. Code, Tools, Subagents, MCP, Hooks und Prompt-Caching funktionieren unverändert. Alle Details finden Sie in der Dokumentation zur Integration und im Leitfaden für Claude-Code-API-Schlüssel (beide auf Englisch).

Claude Code verwenden: die ersten Schritte

# 1. Arranca siempre dentro de la carpeta del proyecto
cd ~/proyectos/mi-app
claude

# 2. Primer comando: lee el repositorio y genera CLAUDE.md
> /init

# 3. Pide las tareas en español y con la ruta del archivo
> cambia la validación de src/api/user.ts a zod y arregla los tests

# 4. Para tareas que tocan muchos archivos: Shift+Tab activa el modo plan

Claude Code bittet Sie um Erlaubnis, bevor eine Datei bearbeitet oder ein Befehl ausgeführt wird; wenn es in die falsche Richtung geht, drücken Sie Esc zum Anhalten und /rewind, um zu einem früheren Stand zurückzukehren. Die von /init erzeugte CLAUDE.md ist ein Entwurf: Beschränken Sie sie auf Dinge, die Sie in jeder Sitzung wiederholen würden (Testbefehle, Konventionen, Verzeichnisse, die nicht verändert werden dürfen). Sie wird in jede Sitzung geladen und mit jeder Anfrage übertragen; Anthropic empfiehlt, 200 Zeilen nicht zu überschreiten.

• Modell wechseln: /model gefolgt vom vollständigen Namen, zum Beispiel /model claude-opus-5, oder starten Sie mit claude --model claude-opus-5. Tun Sie dies zwischen Aufgaben: Jedes Modell hat seinen eigenen Cache, und ein Wechsel mitten in einer Aufgabe zwingt dazu, die gesamte Unterhaltung ohne Cache erneut zu lesen.
• /clear zwischen unabhängigen Aufgaben. Starten Sie eine neue Unterhaltung; das kostet nichts. Die vorherige rufen Sie mit /resume wieder auf.
• /compact, wenn eine Aufgabe länger dauert: Fassen Sie den Verlauf zusammen und fahren Sie fort. Mit einem API-Schlüssel dauert der Cache standardmäßig fünf Minuten; komprimieren Sie daher vor einer längeren Pause, nicht danach.
• Was eine Sitzung kostet: /usage zeigt die Token an, aber der berechnete Betrag ist eine lokale Schätzung zum Listenpreis von Anthropic; mit Kunavo wird der tatsächliche Betrag auf Ihrer Nutzungsseite angezeigt.

Zahlung und Transparenz bei der Auswahl

Das Guthaben wird per Stripe im Voraus bezahlt: Karte (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay oder Link; SEPA-Lastschrift ist nicht verfügbar. Die Mindestaufladung beträgt 10 $, das Guthaben verfällt nicht, fehlgeschlagene Anfragen werden nicht berechnet und für jeden Schlüssel kann ein monatliches Ausgabenlimit festgelegt werden. Alle Tarife stehen auf der Preisseite.

Wenn Sie Claude Code täglich viele Stunden nutzen, ist die feste Gebühr eines Abonnements meist günstiger; nutzungsabhängige Zahlung lohnt sich bei unregelmäßiger Nutzung oder wenn Sie nicht vom 5-Stunden-Fenster abhängig sein möchten, und ein Monat ohne Aktivität kostet null. Der vollständige Vergleich ist auf Englisch unter Claude Code pricing verfügbar. Über Kunavo nutzen Sie gemeinsam genutzte Kapazität, ohne dediziertes Kontingent und ohne vertragliches SLA: Wenn Sie diese Garantien benötigen, schließen Sie den Vertrag direkt mit Anthropic.

Häufig gestellte Fragen