Zurück zu den Leitfäden
Installation·3. Oktober 2026·12 Min. Lesezeit

Claude Code installieren: Befehle für Windows, macOS und Linux, API-Schlüssel ohne Abonnement und Zahlung mit iDEAL

Claude Code installierst du mit einem Befehl. Meist gerätst du danach ins Stocken: im falschen Windows-Fenster, beim PATH oder bei der Node.js-Version mit npm. Außerdem musst du noch einen API-Schlüssel ohne Abonnement einrichten und wissen, wie du in Euro bezahlst.

Claude Code installierst du mit einem offiziellen Befehl: unter macOS, Linux und WSL mit curl -fsSL https://claude.ai/install.sh | bash, unter Windows in PowerShell mit irm https://claude.ai/install.ps1 | iex (in der Eingabeaufforderung, CMD, mit der folgenden install.cmd-Zeile). Danach wählst du, wie du bezahlst. Du meldest dich mit einem Pro-, Max-, Team-, Enterprise- oder Console-Konto an (das kostenlose Claude.ai-Abonnement enthält Claude Code nicht) oder verwendest ohne Abonnement einen API-Schlüssel: Du setzt ANTHROPIC_BASE_URL (nur die Domain, ohne /v1), ANTHROPIC_AUTH_TOKEN und vier Modellvariablen und überprüfst mit /status, ob der Schlüssel aktiv ist. Das Kunavo-Guthaben lädst du mit iDEAL (Niederlande) oder Bancontact (Belgien) ab $10 auf, ohne monatliche Gebühr.

Befehle und Variablen wurden am 3. Oktober 2026 in der offiziellen Installationsdokumentation von Claude Code und der Dokumentation zu Umgebungsvariablen überprüft; Preise und Zahlungsmethoden am 3. Oktober 2026. Die Niederlande und Belgien stehen beide auf der Liste der von Anthropic unterstützten Länder (überprüft am 3. Oktober 2026), sowohl für Claude.ai als auch für die API. Diese Anleitung gibt es auch auf Englisch: Install Claude Code.

Vor der Installation

KomponenteAnforderung (offizielle Installationsdokumentation, überprüft am 3. Oktober 2026)
BetriebssystemmacOS 13.0 oder neuer; Windows 10 1809 oder neuer oder Windows Server 2019 oder neuer; Ubuntu 20.04+; Debian 10+; Alpine Linux 3.19+
HardwareMindestens 4 GB RAM, x64- oder ARM64-Prozessor (kein 32-Bit-Windows)
ShellBash, Zsh, PowerShell oder CMD
Netzwerk und StandortInternetverbindung in einem von Anthropic unterstützten Land (die Niederlande und Belgien sind aufgeführt)
KontoZum Anmelden benötigst du Pro, Max, Team, Enterprise oder Console; das kostenlose Claude.ai-Abonnement enthält Claude Code nicht. Mit einem API-Schlüssel benötigst du kein Abonnement und meldest dich nicht an.
Node.jsNur für die npm-Variante, und dann Version 22 oder neuer; der native Installer benötigt es nicht

Claude Code unter macOS und Linux installieren

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

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

Dies ist die empfohlene native Installation: ein eigenständiges Programm, das sich im Hintergrund selbst aktualisiert. Der Befehl claude wird in ~/.local/bin abgelegt. Ein bereits geöffnetes Terminal kennt den neuen PATH noch nicht. Öffne daher zunächst ein neues Fenster, bevor du testest. In WSL verwendest du genau dieselbe Zeile im WSL-Terminal.

Claude Code unter Windows installieren

Unter Windows gibt es zwei Zeilen; welche du benötigst, hängt ausschließlich vom geöffneten Fenster ab. Beginnt die Eingabeaufforderung mit PS C:\Users\Naam>, befindest du dich in PowerShell. Steht dort nur C:\Users\Naam> ohne PS, handelt es sich um die Eingabeaufforderung (CMD). Du musst das Fenster nicht als Administrator öffnen: Laut der offiziellen Dokumentation ist das nicht erforderlich.

PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows Opdrachtprompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Der häufigste Fehler besteht darin, die Zeile im falschen Fenster einzufügen. Die CMD-Zeile in PowerShell liefert The token '&&' is not a valid statement separator; die PowerShell-Zeile in CMD liefert 'irm' is not recognized as an internal or external command. Auf einem deutschsprachigen Windows kann die zweite Meldung auf Deutsch erscheinen, mit derselben Ursache. Die macOS-Zeile mit | bash in PowerShell führt zu einer Fehlermeldung, dass bash nicht erkannt wird. Verwende in allen drei Fällen die Zeile, die zu deinem Fenster gehört.

Git for Windows ist optional. Wenn es installiert ist, führt Claude Code Befehle über die mitgelieferte Git Bash aus; ohne Git wird PowerShell verwendet. Wenn Git installiert ist, Git Bash aber nicht gefunden wird, tragen Sie CLAUDE_CODE_GIT_BASH_PATH im env-Block von ~/.claude/settings.json mit dem Pfad zu bash.exe ein. Als Beispielpfad nennt die Dokumentation C:\Program Files\Git\bin\bash.exe.

OptionWas du brauchstSandboxingWann auswählen
Natives WindowsNichts; Git for Windows optionalNicht unterstütztProjekte und Tools, die direkt unter Windows ausgeführt werden
WSL 2WSL 2 aktiviertUnterstütztLinux-Tools erforderlich oder Befehle in einer Sandbox
WSL 1WSL 1 aktiviertNicht unterstütztWenn WSL 2 nicht verfügbar ist

WSL ist also keine Voraussetzung, wie manche älteren Anleitungen behaupten, sondern eine Option. Wenn du WSL wählst, führst du die macOS-/Linux-Zeile im WSL-Terminal aus und startest claude auch dort, nicht in PowerShell oder CMD.

Über Homebrew, WinGet oder npm

Das ist ebenfalls möglich, mit einem wichtigen Unterschied: Laut der offiziellen Dokumentation werden Homebrew- und WinGet-Installationen nicht automatisch aktualisiert. Die Aktualisierung führst du dann selbst durch:

# Homebrew (macOS)
brew install --cask claude-code
brew upgrade claude-code              # bijwerken gebeurt niet vanzelf

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # bijwerken gebeurt niet vanzelf

Das npm-Paket erfordert Node.js 22 oder neuer, nicht Node.js 18, wie ältere Anleitungen noch schreiben. Mit einer älteren Node.js-Version zeigt npm lediglich eine EBADENGINE-Warnung an, und die Installation wird normal fortgesetzt: Das Paket installiert dasselbe native Programm, das zum Ausführen kein Node.js benötigt. Verwende niemals sudo npm install -g: Das führt zu Berechtigungsproblemen und stellt ein Sicherheitsrisiko dar. Aktualisieren kannst du mit @latest, nicht mit npm update -g.

Terminal
node -v                                           # moet v22 of hoger zijn
npm install -g @anthropic-ai/claude-code          # nooit met sudo

# later bijwerken: met @latest, niet met npm update -g
npm install -g @anthropic-ai/claude-code@latest

Installation überprüfen

claude --version   # toont het versienummer, gevolgd door (Claude Code)
claude doctor      # alleen-lezen diagnose van installatie en instellingen, start geen sessie

claude doctor startet keine Sitzung, sondern zeigt den Zustand der Installation und deiner Einstellungsdateien an. So erkennst du schnell, ob ein Problem bei der Installation oder bei der Konfiguration liegt.

Wenn command not found: claude erscheint oder Windows meldet, dass claude nicht erkannt wird, ist das Installationsverzeichnis nicht in Ihrem PATH enthalten. Öffnen Sie zuerst ein neues Terminalfenster. Falls das nicht hilft, fügen Sie unter macOS und Linux ~/.local/bin über ~/.zshrc oder ~/.bashrc zu Ihrem PATH hinzu. Unter Windows lautet das Verzeichnis %USERPROFILE%\.local\bin; laut der offiziellen Anleitung zur Fehlerbehebung können Sie es in PowerShell wie folgt überprüfen und hinzufügen:

PowerShell
# 1. Staat de installatiemap al in je PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Geen uitvoer? Voeg de map toe aan je gebruikers-PATH en open een nieuw venster
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. In het nieuwe venster: twee paden betekent twee installaties naast elkaar
where.exe claude

Wenn du über npm installierst und PowerShell npm.ps1 cannot be loaded because running scripts is disabled on this system meldet, blockiert die Ausführungsrichtlinie von PowerShell die Startskripte von npm. Verwende den nativen Installer, starte npm.cmd und claude.cmd oder erlaube lokale Skripte für deinen eigenen Benutzer:

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Erster Start: Abonnement oder API-Schlüssel

Beim ersten Start wählst du, wie Claude Code bezahlt wird. Die beiden Varianten schließen sich gegenseitig aus: Wenn ein API-Schlüssel eingerichtet ist, bleibt eine gespeicherte Anmeldung ungenutzt. Wenn du die Variable entfernst, greift Claude Code wieder auf die Anmeldung zurück, ohne dass du es erneut installieren musst.

Variante A: Mit einem Abonnement anmeldenVariante B: API-Schlüssel ohne Abonnement
Was du brauchstPro-, Max-, Team-, Enterprise- oder Console-KontoEin Kunavo-Schlüssel, der mit sk-kn- beginnt
Wie Sie bezahlenPro und Max: fester monatlicher Betrag; Console: pro Token bei AnthropicPro Token aus vorausbezahltem Guthaben; keine monatliche Gebühr
ZahlungsmethodeÜber die Website ausschließlich Kredit- oder DebitkarteiDEAL, Bancontact, Karte, Apple Pay, Google Pay oder Link
Remote Control und SprachdiktatVerfügbar: Beides funktioniert nur mit einer claude.ai-AnmeldungNicht verfügbar
EinrichtenIm Browser anmeldenSechs Umgebungsvariablen

Variante A: Mit deinem Abonnement anmelden

Starte claude in deinem Projektverzeichnis und melde dich über den Browser an. Eine Falle: Wenn ANTHROPIC_API_KEY bereits gesetzt ist, fragt Claude Code einmal, ob dieser Schlüssel verwendet werden soll. Wenn du ablehnst, ignoriert Claude Code den Schlüssel anschließend, ohne erneut zu fragen, und es wirkt, als würde die Variable nicht gelesen. Aktiviere ihn wieder über /config → Use custom API key.

Variante B: Ohne Abonnement mit einem API-Schlüssel

ANTHROPIC_BASE_URL ist eine integrierte Variable von Claude Code. Laut der offiziellen Dokumentation überschreibt sie den API-Endpunkt, um Anfragen über einen Proxy oder ein Gateway zu senden. Claude Code auf einen Endpunkt mit der Anthropic Messages API zu verweisen ist daher eine unterstützte Konfiguration, ohne Plug-in und ohne angepasste Version. Die Schritte:

  1. Erstelle ein Kunavo-Konto.
  2. Lade dein Guthaben über Billing ab $10 auf (iDEAL und Bancontact werden weiter unten behandelt).
  3. Erstelle unter /app/keys einen Schlüssel, der mit sk-kn- beginnt. Er wird nur einmal angezeigt, speichere ihn daher sofort.
  4. Setze die Variablen. Unter macOS und Linux in ~/.zshrc oder ~/.bashrc:
~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # alleen het domein, zonder /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 zunächst in einem PowerShell-Fenster:

PowerShell
# Geldt alleen voor dit PowerShell-venster
$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 Verwendung ist der env-Block deiner Benutzereinstellungen der beste Ort: ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json). Dort gelten die Werte überall, wo Claude Code ausgeführt wird, auch für Hintergrundagenten. Variablen aus deiner Shell gelten nur für dieses Terminalfenster: Ein Editor, den du über das Dock oder das Startmenü öffnest, sieht sie nicht. Wenn die Datei bereits andere Einstellungen enthält, füge nur den env-Block hinzu:

~/.claude/settings.json
{
  "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"
  }
}

Tragen Sie den Key niemals in die Projektdatei .claude/settings.json ein: Laut der offiziellen Gateway-Dokumentation (überprüft am 3. Oktober 2026) wird diese Datei versioniert und mit allen geteilt, die das Repository klonen. Achten Sie auch auf die Priorität: Wenn sowohl Ihre Shell als auch eine Einstellungsdatei dieselbe Variable setzen, hat die Einstellungsdatei Vorrang. Wenn eine Änderung der Shell-Variable keine Wirkung hat, prüfen Sie zuerst settings.json.

Jede Zeile hat ihre eigene Falle:

  • ANTHROPIC_BASE_URL ist nur die Domain. Claude Code hängt selbst /v1/messages an. Mit /v1 am Ende wird die Anfrage an /v1/v1/messages gesendet, und du erhältst einen 404-Fehler.
  • Verwende ANTHROPIC_AUTH_TOKEN, nicht ANTHROPIC_API_KEY. Laut der Dokumentation wird ANTHROPIC_AUTH_TOKEN als Authorization-Header mit vorangestelltem Bearer mitgesendet und gilt sofort. ANTHROPIC_API_KEY wird im x-api-key-Header gesendet und muss im interaktiven Modus zunächst einmal genehmigt werden (siehe Variante A).
  • Schreibe den Modellnamen in ANTHROPIC_MODEL exakt. Kunavo erkennt nur den exakten Namen und übersetzt keine alten Namen mit einem angehängten Datum.
  • Legen Sie auch ANTHROPIC_DEFAULT_OPUS_MODEL und ANTHROPIC_DEFAULT_SONNET_MODEL fest. Laut der Dokumentation zur Modellkonfiguration (überprüft am 3. Oktober 2026) verweisen die Standardeinstellung und der Alias opus für API-Nutzer auf Opus 5.5 und der Alias sonnet auf Sonnet 5.5; diese Aliase wechseln mit dem Erscheinen neuer Versionen ebenfalls zu den neuen Versionen. Sie können sie mit dem vollständigen Modellnamen oder Variablen wie ANTHROPIC_DEFAULT_OPUS_MODEL festlegen. Kunavo bietet Sonnet 5.5 derzeit nicht an, und ein neues Opus-Modell ist nicht immer sofort verfügbar; ein nicht verfügbares Modell führt zu einem 404-Fehler. Ohne ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 schlagen daher /model sonnet, die Ausführungsphase von opusplan und Subagenten mit der Einstellung model: sonnet fehl. Legen Sie den Alias opus auf Opus 5.5 fest (claude-opus-5-5); dafür ist Claude Code v2.1.280 oder neuer erforderlich. Eine ältere Version können Sie mit claude update aktualisieren.
  • Legen Sie auch ANTHROPIC_DEFAULT_HAIKU_MODEL fest. Der Alias haiku fordert eine ID an, die Kunavo nicht anbietet: ab v2.1.293 Haiku 5.5, davor eine Haiku-4.5-ID mit Datum. Ohne diese Zeile geben /model haiku und Subagenten mit model: haiku einen 404-Fehler zurück.
  • ANTHROPIC_DEFAULT_HAIKU_MODEL gilt auch für Hintergrundaufgaben. Laut der Dokumentation bestimmt diese Variable den Alias haiku und das Modell für Hintergrundfunktionen, etwa Sitzungstitel. Mit Claude Haiku 4.5 bleiben diese kostengünstig.

Wenn du die VS-Code-Erweiterung verwendest, setze die Variablen in claudeCode.environmentVariables, in den Benutzereinstellungen von VS Code selbst (Befehl Preferences: Open User Settings (JSON)). Die Erweiterung überprüft die Anmeldedaten dort bereits vor dem Start; Werte aus ~/.claude/settings.json erreichen zwar den gestarteten Prozess, aber nicht diese Prüfung.

VS Code settings.json
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.kunavo.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-kn-..." },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_OPUS_MODEL", "value": "claude-opus-5-5" },
    { "name": "ANTHROPIC_DEFAULT_SONNET_MODEL", "value": "claude-sonnet-5" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

Preise pro Million Token aus dem Kunavo-Katalog; der Listenpreis von Anthropic stammt von claude.com/pricing (überprüft am 3. Oktober 2026):

ModellKunavo (Input / Output)Listenpreis von Anthropic (Eingabe / Ausgabe)UnterschiedWofür
claude-haiku-4-5$0,70 / $3,50$1,00 / $5,00~30 % niedrigerHintergrundaufgaben von Claude Code selbst und einfache Arbeiten
claude-sonnet-5$1,40 / $7,00$2,00 / $10,00~30 % niedrigerDas Standardmodell für die tägliche Arbeit
claude-opus-5-5$2,80 / $14,00$4,00 / $20,00~30 % niedrigerGroße Refactorings und Planung

Innerhalb einer Sitzung wechselst du mit /model claude-opus-5-5 oder startest direkt mit claude --model claude-opus-5-5. Wie viel Claude Code pro Monat ungefähr kostet und wann ein Abonnement günstiger ist, steht in Claude Code pricing (auf Englisch); deinen eigenen Verbrauch berechnest du mit dem Claude-Tokencalculator. Alle Modelle und Preise findest du auf der Preisseite.

Mit /status überprüfen

Starte claude. Wenn ANTHROPIC_AUTH_TOKEN gesetzt ist, erhältst du keinen Anmeldebildschirm: Die Variable gilt sofort. Wenn der Anmeldebildschirm dennoch erscheint, hat Claude Code keinen Schlüssel gelesen. Setze ihn dann an einem Ort, den Claude Code vor dem Assistenten für den ersten Start liest: als export in deiner Shell oder im env-Block von ~/.claude/settings.json. Ein env-Block in .claude/settings.json oder .claude/settings.local.json eines Projekts gilt in einer interaktiven Sitzung erst nach dem Assistenten für den ersten Start und der Frage, ob du dem Verzeichnis vertraust.

Geben Sie in der Sitzung /status ein und sehen Sie sich auf der Registerkarte „Status“ zwei Zeilen an (Quelle: die offizielle Gateway-Dokumentation, überprüft am 3. Oktober 2026):

  • Anthropic base URL muss https://api.kunavo.com anzeigen. Diese Zeile erscheint nur, wenn eine Gateway-Adresse gesetzt ist. Fehlt sie, hat ANTHROPIC_BASE_URL die Sitzung nicht erreicht.
  • Auth token muss ANTHROPIC_AUTH_TOKEN nennen. Wenn stattdessen Login method mit einem claude.ai-Konto angezeigt wird, wurde die Variable nicht gelesen und die Sitzung läuft über dein Abonnement.

Wenn du zuvor mit einem Abonnement angemeldet warst, kann Claude Code beim Start warnen, dass zwei Anmeldequellen aktiv sind (die Meldung endet mit auth may not work as expected). Die Anfragen werden dann über den Schlüssel gesendet; mit /logout entfernst du die alte Anmeldung.

Möchtest du Adresse und Schlüssel testen, bevor du Claude Code öffnest? Sende dann, wie in der Dokumentation vorgeschlagen, eine Anfrage mit einem Output-Token; das kostet nur sehr wenig Guthaben. Die Befehle lesen die Variablen aus deiner Shell. Setze sie dort daher ebenfalls, wenn sie bereits in settings.json stehen.

Terminal
curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'
PowerShell
Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-5", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'

Eine JSON-Antwort, die mit {"id":"msg_ beginnt, bedeutet, dass Adresse und Schlüssel funktionieren; in PowerShell siehst du eine id, die mit msg_ beginnt. Ein 401 bedeutet, dass der Schlüssel abgelehnt wurde.

Was mit einem API-Schlüssel außerdem funktioniert

  • Kein Remote Control und kein Sprachdiktat. Beides erfordert ein claude.ai-Konto und ist nicht verfügbar, solange ANTHROPIC_AUTH_TOKEN aktiv ist. Remote Control ist außerdem deaktiviert, solange ANTHROPIC_BASE_URL auf eine Adresse außerhalb von Anthropic verweist.
  • /fast meldet, dass der Schnellmodus deaktiviert ist. Mit ausschließlich einem Bearer-Token behandelt Claude Code den Schnellmodus als deaktiviert, ohne die Prüfung zu senden.
  • MCP-Tool-Suche ist standardmäßig deaktiviert, sobald ANTHROPIC_BASE_URL auf eine Adresse außerhalb von Anthropic verweist.
  • Die Zahlen in /context sind Schätzungen: Kunavo bietet /v1/messages/count_tokens derzeit nicht an. Laut der offiziellen Dokumentation zur Gateway-Kompatibilität (überprüft am 3. Oktober 2026) greift Claude Code ohne diesen Endpunkt auf eine Schätzung anhand der Zeichen zurück. Daher zeigt /context Näherungswerte an.

Code, Tools, Subagents, MCP-Server, Hooks und Prompt-Caching funktionieren wie gewohnt. Weitere Informationen findest du in der Claude-Code-Integrationsdokumentation (auf Englisch) und in Claude Code without a subscription (auf Englisch).

Mit iDEAL oder Bancontact bezahlen

Ein Claude-Abonnement kann auf der Website nur mit einer Kredit- oder Debitkarte bezahlt werden (Hilfeartikel von Claude zu kostenpflichtigen Abonnements, überprüft am 3. Oktober 2026); die Preise auf claude.com/pricing verstehen sich ohne Steuern.

Das Kunavo-Guthaben laden Sie über Stripe Checkout auf. Die Preise werden in US-Dollar angegeben; Käufern in den Niederlanden und Belgien zeigt Stripe den Betrag in Euro an. Laut der Stripe-Dokumentation zu Adaptive Pricing (überprüft am 3. Oktober 2026) enthält dieser Wechselkurs einen Aufschlag von 2–4 % für die Umrechnung, den der Käufer zahlt. Wer in US-Dollar zahlt (mit Karte, Apple Pay, Google Pay oder Link), zahlt diesen Aufschlag nicht. iDEAL und Bancontact funktionieren nur in Euro. Auf der Zahlungsseite werden folgende Methoden angeboten:

  • iDEAL für die Niederlande. Die Zahlungsmethode heißt inzwischen iDEAL | Wero (Stripe hat darum gebeten, den Namen im ersten Quartal 2026 zu übernehmen), daher kann dieser Name ebenfalls auf der Zahlungsseite erscheinen. Sie werden zur Umgebung Ihrer eigenen Bank weitergeleitet und bestätigen die Zahlung dort (Stripe zu iDEAL, überprüft am 3. Oktober 2026).
  • Bancontact für Belgien, mit Ihrer Bancontact-Karte oder der App (Stripe zu Bancontact, überprüft am 3. Oktober 2026).
  • Karten (Visa, Mastercard), Apple Pay, Google Pay und Link.

Nicht angeboten: PayPal, SEPA-Lastschrift, Klarna (nur für Käufer in den Vereinigten Staaten verfügbar), Tikkie, Riverty (früher AfterPay) und eine gewöhnliche Banküberweisung.

  1. Erstelle ein Kunavo-Konto.
  2. Wähle unter Billing einen Betrag, mindestens $10. Wer mehr auf einmal auflädt, erhält zusätzliches Guthaben: bei $100 erhältst du $110, bei $1.000 erhältst du $1.200 und bei $5.000 erhältst du $6.250.
  3. Wähle auf der Stripe-Zahlungsseite iDEAL oder Bancontact und schließe die Zahlung in der Umgebung deiner Bank (iDEAL) oder mit der Bancontact-App oder -Karte ab. Den Betrag in Euro siehst du auf der Zahlungsseite, bevor du bestätigst.
  4. Erstelle unter /app/keys einen Schlüssel und trage ihn in ANTHROPIC_AUTH_TOKEN ein.

Das Guthaben ist vorausbezahlt: keine monatliche Gebühr, das Guthaben verfällt nicht, und fehlgeschlagene Anfragen werden nicht berechnet. Automatisches Aufladen funktioniert nur mit einer gespeicherten Karte oder Link; mit iDEAL und Bancontact lädst du also jedes Mal manuell auf. Kunavo stellt keine Mehrwertsteuerrechnungen aus; deine Aufladehistorie findest du unter Billing. Diese Zahlungsmethoden laden ausschließlich dein Kunavo-API-Guthaben auf: Ein Claude-Pro- oder Max-Abonnement kannst du damit nicht bezahlen. Mehr über das Bezahlen in Euro: Claude mit iDEAL bezahlen.

Häufige Fehler

Was du siehstUrsache und Lösung
The token '&&' is not a valid statement separatorDie CMD-Zeile in PowerShell eingefügt. Verwende irm … | iex.
'irm' is not recognized as an internal or external command (oder die deutsche Version dieser Meldung)Die PowerShell-Zeile in CMD eingefügt. Verwende die install.cmd-Zeile.
'bash' is not recognized as the name of a cmdletDie macOS-/Linux-Zeile unter Windows eingefügt. Verwende die PowerShell-Zeile.
Der Befehl zeigt den Text des Skripts an, installiert aber nichtsDie zweite Hälfte fehlt. In PowerShell ist es die vollständige Zeile irm … | iex, in CMD der vollständige Befehl mit -o install.cmd.
syntax error near unexpected token '<' oder ein 403Der Download hat statt des Skripts eine Webseite oder einen Fehlercode geliefert. Laut der offiziellen Fehlerbehebung kann dies an Netzwerkproblemen, regionalem Routing, einer vorübergehenden Störung oder (bei einem reinen 403-Fehler) an einem Unternehmensproxy oder einer Firewall liegen. Versuche es nach einigen Minuten erneut oder installiere unter macOS über Homebrew und unter Windows über WinGet.
Claude Code does not support 32-bit WindowsDu hast Windows PowerShell (x86) geöffnet. Öffne die normale Windows PowerShell.
npm.ps1 cannot be loadedDie Ausführungsrichtlinie von PowerShell blockiert npm. Führe die Set-ExecutionPolicy-Zeile aus oder verwende den nativen Installer.
command not found: claude oder claude wird nicht erkanntDas Installationsverzeichnis befindet sich nicht in deinem PATH. Öffne ein neues Fenster; unter Windows das oben angegebene PATH-Fragment.
Anmeldebildschirm, obwohl der Schlüssel gesetzt istClaude Code hat keinen Schlüssel gelesen. Setze die Variablen in deiner Shell oder in ~/.claude/settings.json, nicht nur in den Projekteinstellungen, und öffne ein neues Fenster.
Warnung, die mit auth may not work as expected endetSchlüssel und alte Anmeldung sind beide aktiv. Verwende /logout, um nur den Schlüssel beizubehalten, oder entferne die Variable, um die Anmeldung zu verwenden.
401Der Schlüssel wird nicht erkannt: Überprüfe, dass du den vollständigen sk-kn--Schlüssel ohne Leerzeichen kopiert hast, dass er nicht unter /app/keys gelöscht wurde und dass er in ANTHROPIC_AUTH_TOKEN steht.
404ANTHROPIC_BASE_URL endet mit /v1 oder das angeforderte Modell ist bei Kunavo nicht verfügbar (beispielsweise weil die vier Modellvariablen fehlen).

Nach der Installation

Wenn du zum ersten Mal in einem Projekt startest, gib /init ein: Claude Code liest das Repository und erstellt eine CLAUDE.md mit den gefundenen Testbefehlen und Konventionen. Überprüfe diese Datei und halte sie kurz, da sie in jeder Sitzung geladen wird. Zwischen einzelnen Aufgaben beginnt /clear ein neues Gespräch; wird eine Aufgabe lang, fasst /compact den bisherigen Verlauf zusammen, und du arbeitest weiter.

Was du wissen solltest

  • Dies ist eine API mit Bezahlung pro Token, kein Claude-Pro- oder Max-Abonnement. Wer Claude Code täglich stundenlang verwendet, ist mit einem Abonnement oft günstiger dran; die Bezahlung pro Token eignet sich für wechselnde Nutzung, und ein Monat ohne Nutzung kostet nichts. Der Vergleich steht in Claude Code pricing (auf Englisch).
  • Mit einem API-Schlüssel sind Remote Control und Spracheingabe nicht verfügbar.
  • Über Kunavo nutzen Sie gemeinsam genutzte Kapazität ohne reserviertes Kontingent und ohne vertragliche Garantien; wenn Sie diese benötigen, schließen Sie direkt einen Vertrag mit Anthropic ab.
  • iDEAL und Bancontact sind nur für manuelles Aufladen verfügbar; automatisches Aufladen ist nur mit einer Karte oder Link möglich.
  • Beträge in Euro enthalten den Umrechnungsaufschlag von Stripe. Kunavo stellt keine Mehrwertsteuerrechnungen aus.

Häufig gestellte Fragen

Wie installiere ich Claude Code?

Mit einem einzigen offiziellen Befehl. Unter macOS, Linux und WSL: curl -fsSL https://claude.ai/install.sh | bash. Unter Windows in PowerShell: irm https://claude.ai/install.ps1 | iex. In der Windows-Eingabeaufforderung (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Dies ist die von Anthropic empfohlene native Installation; sie aktualisiert sich im Hintergrund selbst. Öffne anschließend ein neues Terminalfenster, prüfe mit claude --version und starte mit claude.

Benötige ich WSL oder Administratorrechte, um Claude Code unter Windows zu installieren?

Nein. Laut der offiziellen Installationsdokumentation führst du den Installationsbefehl in PowerShell oder CMD aus, ohne das Fenster als Administrator zu öffnen. Git for Windows ist optional: Wenn es installiert ist, führt Claude Code Befehle über Git Bash aus, andernfalls über PowerShell. WSL 2 ist nur erforderlich, wenn du Linux-Tools oder Sandboxing benötigst; installiere und starte Claude Code dann innerhalb des WSL-Terminals. Öffne nicht Windows PowerShell (x86): Claude Code unterstützt kein 32-Bit-Windows.

Benötige ich Node.js für Claude Code?

Nur wenn du über npm installierst, und dann Node.js 22 oder neuer. Der native Installer, Homebrew und WinGet benötigen kein Node.js. Mit einer älteren Node.js-Version zeigt npm lediglich eine EBADENGINE-Warnung an, und die Installation wird normal fortgesetzt. Verwende niemals sudo npm install -g und aktualisiere mit npm install -g @anthropic-ai/claude-code@latest statt mit npm update -g.

Kann ich Claude Code ohne Abonnement verwenden?

Ja. Zum Anmelden benötigst du ein Pro-, Max-, Team-, Enterprise- oder Console-Konto; das kostenlose Claude.ai-Abonnement enthält Claude Code nicht. Ohne Abonnement setzt du ANTHROPIC_BASE_URL=https://api.kunavo.com und ANTHROPIC_AUTH_TOKEN mit einem Kunavo-Schlüssel. Claude Code überspringt dann den Anmeldebildschirm, und du zahlst pro verwendetem Token aus einem vorausbezahlten Kunavo-Guthaben, ab $10, ohne monatliche Gebühr. Remote Control und Sprachdiktat sind auf diese Weise nicht verfügbar, da sie ein claude.ai-Konto benötigen.

Wie richte ich einen API-Schlüssel für Claude Code ein?

Setze die Variablen im env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json) oder als export-Zeilen in ~/.zshrc, ~/.bashrc oder deinem PowerShell-$PROFILE. Verwende ANTHROPIC_AUTH_TOKEN, nicht ANTHROPIC_API_KEY: Ersterer wird als Authorization: Bearer mitgesendet und gilt sofort, Letzterer wird im x-api-key-Header gesendet und muss zunächst einmal genehmigt werden. ANTHROPIC_BASE_URL ist nur die Domain https://api.kunavo.com, ohne /v1: Claude Code hängt selbst /v1/messages an. Mit /v1 erhältst du daher /v1/v1/messages und einen 404-Fehler. Lege den Schlüssel niemals in der .claude/settings.json eines Projekts ab, da diese Datei committet wird. Wenn Shell und Einstellungsdatei dieselbe Variable setzen, hat die Einstellungsdatei Vorrang.

Warum gibt es bei Claude Code über einen API-Schlüssel vier Modellvariablen?

Ohne festgelegte Modelle verwendet Claude Code Aliase, die sich mit neuen Anthropic-Versionen ändern. Laut der offiziellen Dokumentation zur Modellkonfiguration (überprüft am 3. Oktober 2026) verweisen die Standardeinstellung und der Alias opus für API-Nutzer auf Opus 5.5 und der Alias sonnet auf Sonnet 5.5. Kunavo bietet Sonnet 5.5 derzeit nicht an, und ein nicht verfügbares Modell liefert einen 404-Fehler: Ohne eine feste sonnet-Variable schlagen /model sonnet, die Ausführungsphase von opusplan und Subagents mit model: sonnet fehl. Mit ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 und ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 fordert jede Anfrage ein von Kunavo angebotenes Modell an, und du weißt, was du bezahlst. Opus 5.5 erfordert Claude Code v2.1.280 oder neuer; eine ältere Version aktualisierst du mit claude update. Die haiku-Variable bestimmt auch das Modell für die Hintergrundaufgaben von Claude Code.

Wie überprüfe ich, ob Claude Code meinen API-Schlüssel verwendet?

Gib /status in Claude Code ein. Auf dem Tab Status muss die Zeile Anthropic base URL https://api.kunavo.com anzeigen, und die Zeile Auth token muss ANTHROPIC_AUTH_TOKEN nennen. Wenn stattdessen Login method mit einem claude.ai-Konto angezeigt wird, wurde die Variable nicht gelesen und die Sitzung läuft über dein Abonnement. Wenn beim Start ein Anmeldebildschirm erscheint, hat Claude Code überhaupt keinen Schlüssel gelesen.

Kann ich Claude Code mit iDEAL oder Bancontact bezahlen?

Für das Kunavo-API-Guthaben ja. Auf der Stripe-Zahlungsseite werden iDEAL (Niederlande) und Bancontact (Belgien) neben Karten, Apple Pay, Google Pay und Link angeboten. Der Preis wird in Dollar angegeben, und Stripe zeigt den Betrag in Euro an; laut Stripe enthält dieser Wechselkurs einen Umrechnungsaufschlag von 2–4 %. Der Mindestbetrag beträgt $10, es gibt keine monatliche Gebühr, und das Guthaben verfällt nicht. iDEAL und Bancontact sind nur für manuelles Aufladen verfügbar: Automatisches Aufladen funktioniert nur mit einer gespeicherten Karte oder Link. PayPal und SEPA-Lastschrift werden nicht angeboten, und Kunavo stellt keine Mehrwertsteuerrechnungen aus. Ein Claude-Pro- oder Max-Abonnement kannst du damit nicht bezahlen; claude.ai rechnet es auf der Website ausschließlich mit einer Kredit- oder Debitkarte ab.