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

Claude Code installieren: Befehle für Windows, macOS und Linux, API-Key ohne Abo und Bezahlen ohne PayPal

Claude Code ist mit einem Befehl installiert. Hängen bleibt man meist danach: am falschen Windows-Fenster, am PATH oder an der Node.js-Version bei npm. Dazu kommen der API-Key ohne Abo und die Frage, wie man ohne PayPal und SEPA bezahlt.

Kurz gesagt: Claude Code installieren Sie mit einer einzigen Zeile im Terminal, ohne Node.js und ohne Administratorrechte. Welche Zeile, hängt nur vom Fenster ab: curl -fsSL https://claude.ai/install.sh | bash unter macOS, Linux und WSL, irm https://claude.ai/install.ps1 | iex in Windows PowerShell, die dritte Zeile unten in der Eingabeaufforderung (CMD). Wer kein Claude-Abo hat, verbindet Claude Code danach per API-Key mit Kunavo: ANTHROPIC_BASE_URL=https://api.kunavo.com (ohne /v1), ANTHROPIC_AUTH_TOKEN und drei Modellvariablen. Ob das greift, zeigt /status. Bezahlt wird pro Token aus einem Guthaben ab $10, aufgeladen per Debit- oder Kreditkarte (auch Visa Debit und Debit Mastercard), Apple Pay, Google Pay, Link oder in Österreich per EPS. PayPal und SEPA-Lastschrift gehen nicht.

Terminal
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
PowerShell
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
cmd.exe
:: Windows-Eingabeaufforderung (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Anthropic pflegt die Claude-Code-Dokumentation vollständig auf Deutsch, deshalb verweist diese Anleitung auf die deutschen Seiten. Die Befehle oben sind am 3. Oktober 2026 mit Claude Code einrichten abgeglichen, die Variablen mit der Liste der Umgebungsvariablen. Kunavos Preise und Zahlungswege sind auf dem Stand vom 3. Oktober 2026. Deutschland, Österreich und die Schweiz stehen in Anthropics Länderliste sowohl für Claude.ai als auch für die API (Stand 3. Oktober 2026). Eine englische Fassung gibt es unter Install Claude Code.

Der Ablauf im Überblick

  1. Installieren: die passende Zeile oben ausführen, danach ein neues Terminalfenster öffnen.
  2. Prüfen: claude --version gibt eine Versionsnummer aus.
  3. Entscheiden: mit einem Claude-Abo anmelden oder einen API-Key verwenden (Vergleich weiter unten).
  4. Mit API-Key: Guthaben aufladen, Key anlegen, fünf Umgebungsvariablen setzen.
  5. Kontrollieren: in der Sitzung /status eingeben.

Voraussetzungen: was heute gilt

Manche deutschsprachigen Anleitungen beschreiben einen älteren Stand von Claude Code. Die Tabelle stellt verbreitete Angaben neben das, was die offizielle Einrichtungsseite am 3. Oktober 2026 verlangt.

ThemaOft noch zu lesenLaut Anthropic
macOSmacOS 10.15 oder neuermacOS 13.0 oder neuer
Windowsnur über WSLnativ unter Windows 10 ab 1809 oder Windows Server 2019; WSL ist eine Option, keine Pflicht
RechtePowerShell als Administrator startennicht nötig
Node.jsNode.js 18 oder neuernur für die npm-Installation, dann Version 22 oder neuer
npmveraltetweiterhin ein dokumentierter Weg; empfohlen wird der native Installer
Linux—Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+
Rechner und Shell—mindestens 4 GB RAM, x64 oder ARM64, kein 32-Bit-Windows; Bash, Zsh, PowerShell oder CMD
Standort—ein von Anthropic unterstütztes Land; Deutschland, Österreich und die Schweiz gehören dazu
Konto—zum Anmelden Pro, Max, Team, Enterprise oder Console; mit API-Key weder Abo noch Login

Installieren unter macOS, Linux und WSL

Fügen Sie im Terminal die Zeile mit install.sh ein. In der offiziellen Dokumentation steht dieser Weg auf dem Reiter „Native Installation (Empfohlen)“. Das Skript legt den Starter unter ~/.local/bin/claude ab, und die Installation aktualisiert sich danach im Hintergrund selbst. Unter WSL gilt dieselbe Zeile, ausgeführt im WSL-Terminal.

Claude Code unter Windows installieren

Unter Windows entscheidet das offene Fenster, welche Zeile funktioniert, und ein Blick auf die Eingabezeile genügt: PS C:\Users\Name> ist PowerShell, C:\Users\Name> ohne PS ist die Eingabeaufforderung (CMD). Administratorrechte brauchen Sie laut Einrichtungsseite für keine der beiden Varianten. Der Installer legt claude.exe unter %USERPROFILE%\.local\bin ab.

Wer die Fenster verwechselt, bekommt eine englische Meldung, auf einem deutschsprachigen Windows unter Umständen eine deutsche. Die CMD-Zeile in PowerShell endet mit The token '&&' is not a valid statement separator, die PowerShell-Zeile in CMD mit 'irm' is not recognized as an internal or external command. Gemeint ist beide Male dasselbe: falsches Fenster, also die andere Zeile nehmen.

Lassen Sie im Startmenü den Eintrag „Windows PowerShell (x86)“ links liegen. Laut Fehlerbehebung startet er einen 32-Bit-Prozess, und der Installer bricht dann auch auf einem 64-Bit-PC mit Claude Code does not support 32-bit Windows ab. Gibt [Environment]::Is64BitOperatingSystem in diesem Fenster True aus, ist Ihr Windows in Ordnung, und Sie öffnen einfach „Windows PowerShell“ ohne den Zusatz.

Git für Windows müssen Sie nicht installieren. Ist es vorhanden, führt Claude Code Shell-Befehle in der Git Bash aus, sonst in PowerShell. Findet Claude Code eine installierte Git Bash nicht, tragen Sie den Pfad zur bash.exe als CLAUDE_CODE_GIT_BASH_PATH in den env-Block von ~/.claude/settings.json ein, bei einer Standardinstallation C:\Program Files\Git\bin\bash.exe.

Ob nativ oder in WSL, hängt davon ab, wo Ihre Projekte liegen:

VarianteVoraussetzungSandboxingPasst, wenn
Natives Windowskeine; Git für Windows optionalneinIhre Projekte und Werkzeuge unter Windows selbst laufen
WSL 2WSL 2 aktiviertjaSie Linux-Werkzeuge brauchen oder Befehle in einer Sandbox ausführen wollen
WSL 1WSL 1 aktiviertneinWSL 2 auf dem Rechner nicht verfügbar ist

Mit WSL installieren und starten Sie claude im WSL-Terminal, nicht in PowerShell oder CMD.

Alternativen: Homebrew, WinGet und npm

Wer Software lieber über einen Paketmanager pflegt, kann das tun, mit einem Haken: Laut Dokumentation aktualisieren sich Homebrew- und WinGet-Installationen nicht von selbst, Sie rufen also regelmäßig upgrade auf. Homebrew bietet zwei Casks. claude-code folgt dem stabilen Kanal, der etwa eine Woche hinterherläuft und Versionen mit großen Regressionen überspringt; claude-code@latest bekommt jede Version sofort.

# Homebrew (macOS) – stabiler Kanal; claude-code@latest für den neuesten Stand
brew install --cask claude-code
brew upgrade claude-code              # aktualisiert sich nicht von selbst

# WinGet (Windows)
winget install Anthropic.ClaudeCode
winget upgrade Anthropic.ClaudeCode   # aktualisiert sich nicht von selbst

Über npm

npm bleibt ein offiziell beschriebener Weg. Voraussetzung ist Node.js 22 oder neuer. Das npm-Paket lädt dieselbe native Binärdatei wie der Installer und braucht Node.js zur Laufzeit gar nicht. Darum bricht die Installation mit einem älteren Node.js auch nicht ab, npm warnt nur mit EBADENGINE. Haben Sie noch kein Node.js, ist der native Installer der kürzere Weg.

Terminal
node -v                                    # muss v22 oder neuer zeigen
npm install -g @anthropic-ai/claude-code   # niemals mit sudo

# später aktualisieren: mit @latest, nicht mit npm update -g
npm install -g @anthropic-ai/claude-code@latest

Drei Regeln aus der Einrichtungsseite: kein sudo npm install -g, weil das Rechteprobleme und Sicherheitsrisiken schafft. Aktualisieren mit @latest, denn npm update -g bleibt im ursprünglichen Versionsbereich hängen. Und optionale Abhängigkeiten nicht abschalten: Die Binärdatei kommt als plattformspezifische optionale Abhängigkeit, mit --omit=optional oder optional=false in der .npmrc fehlt sie, und claude meldet unter macOS und Linux Error: claude native binary not installed.

Installation prüfen

Öffnen Sie dafür ein neues Terminalfenster. Ein Fenster, das schon vor der Installation offen war, kennt den erweiterten PATH noch nicht und findet claude deshalb nicht.

claude --version   # zeigt eine Versionsnummer wie 2.1.211 (Claude Code)
claude doctor      # Diagnose von Installation und Einstellungen, startet keine Sitzung

claude doctor ist das Werkzeug, wenn etwas nicht stimmt. Es startet keine Sitzung, listet aber Installationsstatus, Fehler in Einstellungsdateien und Warnungen mit Lösungsvorschlägen auf. So erkennen Sie, ob das Problem bei der Installation oder bei der Konfiguration liegt.

Wenn die Installation hakt

Der Download liefert HTML oder einen 403

Beginnt die Ausgabe mit syntax error near unexpected token '<' oder meldet curl einen 403, kam laut Fehlerbehebung (Stand 3. Oktober 2026) statt des Skripts eine Webseite oder ein Fehlerstatus zurück. Steht auf dieser Seite App unavailable in region, hält Anthropic die Verbindung für eine aus einem nicht unterstützten Land. Aus Deutschland, Österreich oder der Schweiz spricht das für einen VPN- oder Proxy-Ausgang im Ausland. Ein 403 ohne Text kann dieselbe Ursache haben oder von einer Firmen-Firewall kommen. Die Dokumentation rät, zuerst die Netzwerkverbindung zu prüfen, weil die anderen Installationswege dieselben Server ansprechen. Ein anderes Netz oder eine Freigabe durch die IT hilft hier mehr als ein anderer Installer.

„claude“ wird nicht gefunden

command not found: claude unter macOS und Linux oder ein nicht erkanntes claude unter Windows heißt: Der Installationsordner fehlt im PATH. Meist reicht ein neues Fenster. Hilft das unter macOS oder Linux nicht, tragen Sie ~/.local/bin in ~/.zshrc bzw. ~/.bashrc ein. Unter Windows prüfen und ergänzen Sie den Ordner so, wie es die Fehlerbehebung zeigt:

PowerShell
# 1. Steht der Installationsordner schon im PATH?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Keine Ausgabe? Ordner zum Benutzer-PATH hinzufügen, dann ein neues Fenster öffnen
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Im neuen Fenster
claude --version

PowerShell blockiert npm.ps1

Das betrifft nur die npm-Variante. Die Meldung npm.ps1 cannot be loaded because running scripts is disabled on this system heißt, dass die Ausführungsrichtlinie das Startskript von npm sperrt. Sie können npm.cmd und claude.cmd aufrufen, die von der Richtlinie nicht erfasst werden, auf den nativen Installer wechseln oder lokale Skripte für Ihr Benutzerkonto erlauben:

PowerShell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Abo oder API-Key?

Beim ersten Start will Claude Code wissen, wer bezahlt. Entweder melden Sie sich mit einem Claude-Konto an, oder Sie geben per Umgebungsvariable einen API-Key mit. Ist ein Key gesetzt, hat er laut Gateway-Anleitung Vorrang: Ein gespeicherter Login bleibt ungenutzt liegen und greift wieder, sobald Sie die Variable entfernen. Neu installieren müssen Sie für den Wechsel nichts.

Claude-AboAPI-Key von Kunavo
Abrechnungmonatlich: Pro $20 oder $17 pro Monat bei jährlicher Zahlung ($200 im Voraus), Max ab $100, jeweils ohne etwaige Steuern (claude.com/de/pricing, Stand 3. Oktober 2026)pro Token aus Prepaid-Guthaben, Aufladung ab $10, ohne Monatsgebühr und ohne Verfall
Passt zutäglicher, stundenlanger Nutzungwechselnder Nutzung; ein Monat ohne Nutzung kostet nichts
Bezahlenim Web nur Kredit- oder Debitkarte, in den iOS- und Android-Apps über App Store bzw. Google Play (Abrechnungs-FAQ von Anthropic, Stand 3. Oktober 2026)Debit- und Kreditkarte (Visa, Mastercard), Apple Pay, Google Pay, Link; in Österreich EPS
Einrichtungclaude starten und im Browser anmeldenfünf Umgebungsvariablen, kein Login
Nicht dabei—Remote Control und Sprachdiktat

Ab wann sich Pro oder Max gegenüber dem Key rechnet, zeigt der Guide zum Claude-Code-Preis.

API-Key einrichten (ohne Abo)

Dass Claude Code einen anderen Endpunkt anspricht, ist kein Trick. ANTHROPIC_BASE_URL steht in Anthropics Variablenliste und ist genau dafür da, Anfragen über einen Proxy oder ein Gateway zu leiten. Ein Plugin oder eine veränderte Claude-Code-Version brauchen Sie nicht.

  1. Bei Kunavo registrieren, per E-Mail-Adresse oder Google-Konto.
  2. Unter Billing mindestens $10 aufladen (Zahlungswege im Abschnitt zum Bezahlen).
  3. Unter API-Keys einen Key erzeugen. Er beginnt mit sk-kn- und ist nur einmal sichtbar, kopieren Sie ihn also sofort.
  4. Die Variablen setzen, wie unten gezeigt.

In ~/.zshrc oder ~/.bashrc eingetragen, gelten die Werte für jedes neue Terminal unter macOS, Linux und WSL:

~/.zshrc
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # nur die Domain, ohne /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

In PowerShell gelten $env:-Zuweisungen nur für das offene Fenster, gut für einen ersten Versuch:

PowerShell
# Gilt nur für dieses PowerShell-Fenster
$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"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "claude-haiku-4-5"
claude

Auf Dauer gehören die Werte in den env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json). Diese Datei gilt laut Gateway-Anleitung (Stand 3. Oktober 2026) für alle Ihre Projekte. Gibt es sie schon, ergänzen Sie nur den env-Block:

~/.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",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
  }
}

Die VS-Code-Erweiterung liest die Variablen aus claudeCode.environmentVariables in den Benutzereinstellungen von VS Code (Befehl Preferences: Open User Settings (JSON)):

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" },
    { "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL", "value": "claude-haiku-4-5" }
  ]
}

Was jede Variable tut

VariableWertWirkungWenn sie fehlt oder falsch ist
ANTHROPIC_BASE_URLhttps://api.kunavo.comleitet alle Anfragen an Kunavo; Claude Code hängt /v1/messages selbst anMit /v1 am Ende geht die Anfrage an /v1/v1/messages und scheitert mit 404.
ANTHROPIC_AUTH_TOKENIhr Key (sk-kn-…)geht als Authorization: Bearer mit und hat sofort VorrangWer stattdessen ANTHROPIC_API_KEY setzt (Header x-api-key), muss den Key im interaktiven Modus einmal bestätigen. Wird das abgelehnt, ignoriert Claude Code den Key ohne erneute Nachfrage; einschalten lässt er sich wieder unter /config → Use custom API key. Kunavo nimmt den Key in beiden Headern an.
ANTHROPIC_MODELclaude-sonnet-5Startmodell jeder SitzungOhne sie startet die Sitzung auf Opus 5.5, oder auf Claude Opus 5, wenn nur der Opus-Pin gesetzt ist.
ANTHROPIC_DEFAULT_OPUS_MODELclaude-opus-5Ziel von /model opus und die Version, die der Standard ohne ANTHROPIC_MODEL verwendetOhne sie folgt der Alias Anthropics Vorgabe, derzeit Opus 5.5.
ANTHROPIC_DEFAULT_HAIKU_MODELclaude-haiku-4-5Ziel von /model haiku und Modell für HintergrundfunktionenOhne sie entscheidet Anthropics Alias, welches Haiku läuft.
ANTHROPIC_DEFAULT_SONNET_MODEL (optional)claude-sonnet-5Ziel von /model sonnetOhne sie zeigt der Alias für API-Nutzer auf Sonnet 5.5, das Kunavo derzeit (Stand 3. Oktober 2026) nicht anbietet: 404.

Warum ein festes Startmodell? Laut Modellkonfiguration (Stand 3. Oktober 2026) ist Opus 5.5 der Standard für API-Nutzer, und Aliase werden im Lauf der Zeit auf neue Versionen umgestellt. Kunavo bietet Opus 5.5 an; ein Start ganz ohne Modellvariablen läuft hier also auf Opus 5.5, das pro Token doppelt so viel kostet wie Claude Sonnet 5. Mit festen Modellnamen wissen Sie, welches Modell antwortet und zu welchem Tarif. Der Opus-Pin hält den Alias auf Claude Opus 5. Opus 5.5 kostet bei Kunavo pro Token weniger als Claude Opus 5 ($2,80 / $14,00 gegenüber $3,50 / $17,50 pro 1 Mio. Input-/Output-Tokens). Wer es nutzen will, wechselt mit /model claude-opus-5-5 oder trägt claude-opus-5-5 als Opus-Pin ein. Claude Haiku 4.5 hält die Hintergrundaufgaben günstig, und mit /model wechseln Sie in der Sitzung jederzeit.

Zwei Dinge zur Ablage. Der Key gehört nie in die .claude/settings.json eines Projekts, denn diese Datei wird laut Gateway-Anleitung committet und landet bei jedem, der das Repository klont. Und setzen ein Shell-Export und ein env-Block dieselbe Variable, gewinnt die Einstellungsdatei. Ändern Sie also eine Variable in der Shell und es passiert nichts, steht der alte Wert vermutlich noch in einer settings.json.

Die Modelle im Vergleich, Kunavo-Preise aus dem Katalog, Anthropics Listenpreise nach claude.com/de/pricing (Stand 3. Oktober 2026), jeweils pro 1 Mio. Tokens:

ModellKunavo (Input / Output)Listenpreis Anthropic (Input / Output)UnterschiedRolle in Claude Code
claude-haiku-4-5$0,70 / $3,50$1,00 / $5,00~30 % günstigerAlias haiku und Hintergrundaufgaben von Claude Code
claude-sonnet-5$1,40 / $7,00$2,00 / $10,00~30 % günstigerHauptmodell (ANTHROPIC_MODEL) für die tägliche Arbeit
claude-opus-5$3,50 / $17,50$5,00 / $25,00~30 % günstigerAlias opus mit dem Pin oben: große Refactorings, Planung
claude-opus-5-5$2,80 / $14,00$4,00 / $20,00~30 % günstigerLäuft, wenn kein Modell gepinnt ist (Standard für API-Nutzer)

Alle Claude-Modelle und Tarife stehen im Guide zu den Claude-API-Preisen und auf der Preisseite.

Erster Start: mit /status prüfen

Wechseln Sie in Ihren Projektordner und starten Sie claude. Mit gesetztem ANTHROPIC_AUTH_TOKEN geht es direkt in die Sitzung, ohne Anmeldebildschirm. Erscheint er trotzdem, hat Claude Code keinen Key gefunden. Der häufigste Grund laut Gateway-Anleitung: Der Key steht nur in der .claude/settings.json oder .claude/settings.local.json des Projekts. Solche env-Blöcke wertet Claude Code in einer interaktiven Sitzung erst nach dem Einrichtungsassistenten und der Frage aus, ob Sie dem Ordner vertrauen. Legen Sie den Key deshalb in die Shell (export) oder in ~/.claude/settings.json.

In der Sitzung zeigt /status im Tab Status, woher Claude Code Adresse und Zugangsdaten nimmt. Zwei Zeilen sind entscheidend:

ZeileRichtigWenn nicht
Anthropic base URLhttps://api.kunavo.comDie Zeile erscheint nur, wenn eine Gateway-Adresse gesetzt ist. Fehlt sie, ist ANTHROPIC_BASE_URL nicht in der Sitzung angekommen.
Auth tokennennt ANTHROPIC_AUTH_TOKENSteht stattdessen Login method mit einem claude.ai-Konto da, wurde die Variable nicht gelesen, und die Sitzung läuft über Ihr Abo.

Die Verbindung lässt sich auch ohne Claude Code testen, mit der Anfrage aus der Gateway-Anleitung (Modell hier auf claude-sonnet-5 gesetzt). Sie fordert genau einen Output-Token an und kostet entsprechend nur einen winzigen Betrag. Die Befehle lesen die Shell-Variablen; stehen Ihre Werte nur in der settings.json, exportieren Sie sie für den Test zusätzlich.

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": "."}]}'

Kommt JSON zurück, das mit {"id":"msg_ beginnt, oder in PowerShell ein Objekt mit einer id, die mit msg_ anfängt, stimmen Adresse und Key. Ein 401 heißt, dass der Key abgelehnt wurde.

Was sich mit API-Key ändert

Das meiste bleibt, wie es ist: Code bearbeiten, Werkzeuge, Subagents, MCP-Server, Hooks und Prompt-Caching funktionieren wie gewohnt. Vier Unterschiede sollten Sie kennen:

  • Remote Control und Sprachdiktat fallen weg. Beide brauchen laut Gateway-Anleitung eine claude.ai-Identität und sind gesperrt, solange ANTHROPIC_AUTH_TOKEN oder ANTHROPIC_API_KEY aktiv ist. Remote Control ist seit Version 2.1.196 zusätzlich gesperrt, wenn ANTHROPIC_BASE_URL auf einen Host außerhalb von Anthropic zeigt.
  • /fast meldet den Fast-Mode als nicht verfügbar. Mit nur einem Bearer-Token behandelt Claude Code ihn als deaktiviert und schickt die Verfügbarkeitsprüfung gar nicht erst ab.
  • Die Tool-Suche für MCP ist aus. Laut MCP-Dokumentation (Stand 3. Oktober 2026) schaltet Claude Code sie ab, sobald ANTHROPIC_BASE_URL auf einen Drittanbieter zeigt; mit ENABLE_TOOL_SEARCH lässt sie sich ausdrücklich einschalten.
  • /context zeigt Schätzwerte. Kunavo bietet /v1/messages/count_tokens nicht an. Ohne diesen Endpunkt zählt Claude Code laut Gateway-Kompatibilitätsleitfaden (Stand 3. Oktober 2026) anhand der Zeichen.

Mehr zur Integration steht in der Integrationsanleitung für Claude Code (auf Englisch).

Bezahlen ohne PayPal und SEPA

Vorweg eine Abgrenzung: Kunavo verkauft keine Claude-Abos, sondern Guthaben für API-Zugang, von dem Claude Code jeden Token abbucht. Für Pro und Max bei Anthropic gilt: Im Web nur Kredit- oder Debitkarte, in den Apps rechnen App Store bzw. Google Play ab (Abrechnungs-FAQ). PayPal oder Venmo nimmt Anthropic laut dem Hilfeartikel zu abgelehnten Karten nicht an (beides Stand 3. Oktober 2026).

Kunavo lädt über den Stripe-Checkout auf. Die Preise stehen in US-Dollar; wer aus Deutschland oder Österreich zahlt, sieht den Betrag in Euro. In diesem Kurs steckt laut Stripes Dokumentation zu Adaptive Pricing (Stand 3. Oktober 2026) eine Umrechnungsgebühr von 2–4 %, die der Käufer trägt. Wählen Sie im Checkout US-Dollar, entfällt sie; dann rechnet Ihre Bank zu ihrem eigenen Kurs um und kann eigene Gebühren verlangen. Der Checkout bietet an:

ZahlungswegWoHinweis
Karte (Visa, Mastercard, Amex, JCB, UnionPay)überallKredit- und Debitkarten, also auch Visa Debit und Debit Mastercard; eine reine girocard nicht
Apple PaySafari, iPhone und iPadmit einer Karte im Wallet, auch einer Visa- oder Mastercard-Debitkarte; eine reine girocard nicht
Google PayChrome und Android mit eingerichtetem Google Paymit einer Karte im Wallet, auch einer Visa- oder Mastercard-Debitkarte; eine reine girocard nicht
LinküberallStripes Bezahldienst, speichert Ihre Karte; damit geht auch automatisches Aufladen
EPSÖsterreich, Checkout in EuroWeiterleitung ins Online-Banking Ihrer Bank

EPS ist laut Stripe ein österreichisches Verfahren, das alle österreichischen Banken unterstützen. Sie werden auf die Seite Ihrer Bank weitergeleitet und bestätigen dort; es funktioniert nur bei Zahlung in Euro. Wer aus der Schweiz zahlt, nimmt Karte, Apple Pay, Google Pay oder Link.

girocard: Eine Karte, die nur girocard ist (früher EC-Karte), wird im Kunavo-Checkout nicht angenommen, weil Stripe girocard nicht unter seinen unterstützten Kartenmarken führt (Stand 3. Oktober 2026). Trägt Ihre Karte zusätzlich das Visa- oder Mastercard-Logo, läuft die Zahlung über dieses Netz, auch in Apple Pay und Google Pay.

Nicht im Angebot: PayPal, SEPA-Lastschrift, manuelle Überweisung (Vorkasse), Klarna im Euro-Checkout, giropay und Sofort.

  1. Konto anlegen; bei der Registrierung fragt Kunavo nach keiner Karte.
  2. Unter Billing eine Aufladestufe ab $10 wählen. Größere Stufen bringen Bonusguthaben: $100 ergeben $110, $1.000 ergeben $1.200, $5.000 ergeben $6.250.
  3. Im Stripe-Checkout die Zahlungsart wählen. Den Euro-Betrag sehen Sie vor der Bestätigung; bei EPS bestätigen Sie im Online-Banking.
  4. Unter API-Keys einen Key anlegen und als ANTHROPIC_AUTH_TOKEN eintragen.

Das Guthaben ist im Voraus bezahlt: keine Monatsgebühr, kein Verfall, und fehlgeschlagene Anfragen werden nicht berechnet. Automatisch nachladen lässt es sich nur mit gespeicherter Karte oder Link; mit Apple Pay, Google Pay und EPS laden Sie von Hand auf. Kunavo stellt keine Rechnungen mit ausgewiesener Umsatzsteuer aus; Ihre Aufladungen sehen Sie unter Billing. Mehr zu Zahlungswegen und abgelehnten Karten: Claude ohne Kreditkarte bezahlen.

Was eine Sitzung kostet: Rechenbeispiel

Mit API-Key zahlen Sie Tokens, und Claude Code schickt bei jedem Schritt den gesamten bisherigen Kontext mit. Voll bezahlt wird dieser Kontext trotzdem nicht jedes Mal: Den unveränderten Anfang liest das Modell aus dem Cache, und dafür gilt der niedrigere Cache-Lese-Tarif. Die Tabelle rechnet ein angenommenes Muster durch; sie ist weder Messung noch Obergrenze. Angenommen:

  • 40.000 Input-Tokens pro Anfrage, davon 36.000 (90 %) aus dem Cache gelesen und 4.000 neu in den Cache geschrieben;
  • 1.000 Output-Tokens pro Anfrage;
  • 50 solcher Anfragen pro Arbeitssitzung, Hintergrundaufrufe nicht mitgezählt;
  • Cache-Lesen kostet bei Claude Sonnet 5 10 % des Input-Tarifs, Cache-Schreiben das 1,25-Fache; jedes Modell in der Tabelle ist mit seinen eigenen Faktoren gerechnet.
ModellEine Anfrage50 Anfragen50 Anfragen ganz ohne Cache-Treffer
Claude Sonnet 5$0,019$0,952$3,15
Claude Opus 5$0,0476$2,38$7,88
Claude Opus 5.5$0,033$1,65$6,30

Was Sie tatsächlich zahlen, hängt von Kontextlänge, Cache-Treffern und Antwortlänge ab, und davon, ob Sie zwischen zwei Aufgaben mit /clear neu anfangen. Für Ihre eigenen Zahlen gibt es den Claude-Token-Rechner (auf Englisch); den Vergleich mit Pro und Max rechnet der Claude-Code-Preis-Guide durch.

Fehlermeldungen und was sie bedeuten

MeldungBedeutung und Abhilfe
The token '&&' is not a valid statement separatorDie CMD-Zeile steckt im PowerShell-Fenster. Dort gehört irm … | iex hin.
'irm' is not recognized as an internal or external command (oder dieselbe Meldung auf Deutsch)Die PowerShell-Zeile steckt in CMD. Dort gehört die Zeile mit install.cmd hin.
Claude Code does not support 32-bit WindowsGeöffnet ist „Windows PowerShell (x86)“. Den Eintrag ohne (x86) nehmen.
syntax error near unexpected token '<' oder 403Statt des Skripts kam eine Webseite oder ein Fehlercode. VPN, Proxy und Firmen-Firewall prüfen oder ein anderes Netz versuchen.
App unavailable in regionDie Verbindung scheint aus einem nicht unterstützten Land zu kommen. In DE, AT und CH ist das meist ein VPN oder Proxy.
command not found: claude oder claude wird nicht erkanntDer Installationsordner fehlt im PATH. Neues Fenster öffnen; unter Windows den PATH-Befehl oben.
Warnung EBADENGINENode.js ist älter als 22. Die Installation läuft trotzdem durch; ein Update lohnt sich dennoch.
claude native binary not installed (macOS, Linux)npm hat die optionalen Abhängigkeiten übersprungen (--omit=optional, optional=false). Einstellung entfernen und neu installieren.
npm.ps1 cannot be loadedDie Ausführungsrichtlinie sperrt npm. npm.cmd verwenden, die Set-ExecutionPolicy-Zeile ausführen oder den nativen Installer nehmen.
Anmeldebildschirm, obwohl der Key gesetzt istDer Key steht nur in den Projekteinstellungen. Per export oder in ~/.claude/settings.json setzen und ein neues Terminal öffnen.
ANTHROPIC_API_KEY gesetzt, aber ohne WirkungDie einmalige Bestätigung wurde abgelehnt. Unter /config → Use custom API key einschalten oder auf ANTHROPIC_AUTH_TOKEN umsteigen.
401Der Key wurde abgelehnt. Ist er vollständig und ohne Leerzeichen kopiert, unter /app/keys noch vorhanden und in ANTHROPIC_AUTH_TOKEN eingetragen?
404ANTHROPIC_BASE_URL endet auf /v1, oder das angefragte Modell gibt es bei Kunavo nicht, etwa nach /model sonnet ohne Sonnet-Pin.

Grenzen dieses Wegs

  • Bezahlt wird pro Token, nicht pauschal. Wer Claude Code täglich stundenlang nutzt, fährt mit Pro oder Max oft günstiger. Bei wechselnder Nutzung zahlen Sie nur, was anfällt, und ein Monat ohne Nutzung kostet nichts.
  • Ohne claude.ai-Konto gibt es kein Remote Control und kein Sprachdiktat; /fast gilt als ausgeschaltet, und die Tool-Suche für MCP ist standardmäßig aus.
  • Sonnet 5.5 bietet Kunavo derzeit nicht an; /model sonnet braucht deshalb den Sonnet-Pin.
  • Apple Pay, Google Pay und EPS taugen nur zum Aufladen von Hand, automatisch geht es nur mit Karte oder Link. Euro-Beträge enthalten Stripes Umrechnungsgebühr.
  • Kunavo stellt keine Rechnungen mit ausgewiesener Umsatzsteuer aus.
  • Anthropics Claude-Code-Dokumentation gibt es auf Deutsch, Kunavos Integrationsanleitung nur auf Englisch.

Häufige Fragen

Wie läuft die Installation von Claude Code ab?

Sie öffnen ein Terminal und führen den offiziellen Befehl für Ihr System aus. Unter macOS, Linux und WSL: curl -fsSL https://claude.ai/install.sh | bash. In Windows 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. Danach öffnen Sie ein neues Terminalfenster und geben claude --version ein. Erscheint eine Versionsnummer, ist Claude Code installiert. Diese native Installation hält sich im Hintergrund selbst aktuell, Installationen über Homebrew oder WinGet müssen Sie selbst aktualisieren.

Claude Code unter Windows installieren: Brauche ich WSL oder Administratorrechte?

Weder noch. Claude Code läuft nativ unter Windows 10 ab Version 1809 und unter Windows Server 2019, und laut Anthropic muss der Installer nicht als Administrator laufen. WSL 2 lohnt sich nur, wenn Sie Linux-Werkzeuge oder Sandboxing brauchen; dann installieren und starten Sie Claude Code im WSL-Terminal. Git für Windows ist optional: Mit Git führt Claude Code Befehle in der Git Bash aus, ohne Git in PowerShell. Typische Stolperfallen sind die CMD-Zeile im PowerShell-Fenster (oder umgekehrt) und der Startmenü-Eintrag „Windows PowerShell (x86)“, der als 32-Bit-Prozess abbricht.

Brauche ich Node.js für Claude Code?

Nur wenn Sie über npm installieren, und dann Node.js 22 oder neuer. Ältere Anleitungen nennen oft Node.js 18, das ist überholt. Der native Installer, Homebrew und WinGet kommen ganz ohne Node.js aus. Ist Ihr Node.js zu alt, warnt npm mit EBADENGINE, installiert aber trotzdem. Installieren Sie nie mit sudo, und aktualisieren Sie mit npm install -g @anthropic-ai/claude-code@latest statt mit npm update -g.

Kann ich Claude Code ohne Abo nutzen?

Ja, mit einem API-Key. Zum Anmelden brauchen Sie Pro, Max, Team, Enterprise oder ein Console-Konto; der kostenlose Claude-Plan enthält Claude Code nicht. Mit Kunavo setzen Sie stattdessen ANTHROPIC_BASE_URL=https://api.kunavo.com und ANTHROPIC_AUTH_TOKEN, und Claude Code startet ohne Anmeldebildschirm. Jeder Token wird von einem Prepaid-Guthaben abgebucht, das Sie ab $10 aufladen; eine Monatsgebühr gibt es nicht. Verzichten müssen Sie auf Remote Control und das Sprachdiktat, denn beide setzen ein claude.ai-Konto voraus.

Wie richte ich in Claude Code einen API-Key ein?

Am besten im env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json), sonst als export-Zeilen in ~/.zshrc oder ~/.bashrc. Sie brauchen fünf Werte: ANTHROPIC_BASE_URL=https://api.kunavo.com ohne /v1 (sonst geht die Anfrage an /v1/v1/messages und scheitert mit 404), ANTHROPIC_AUTH_TOKEN mit Ihrem Key sowie ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5 und ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5. ANTHROPIC_AUTH_TOKEN greift sofort. ANTHROPIC_API_KEY geht auch, denn Kunavo nimmt den Key in beiden Headern an, muss im interaktiven Modus aber einmal bestätigt werden. Den Key nie in die .claude/settings.json eines Projekts schreiben, denn die wird mit dem Repository geteilt.

Welches Modell nutzt Claude Code mit API-Key?

Das Modell, das Sie festlegen. Ohne Festlegung startet Claude Code für API-Nutzer laut Anthropic (Stand 3. Oktober 2026) mit Opus 5.5. Kunavo bietet Opus 5.5 an, das pro Token doppelt so viel kostet wie Claude Sonnet 5. Mit ANTHROPIC_MODEL=claude-sonnet-5 wird Claude Sonnet 5 zum Startmodell; eine Anfrage aus dem Rechenbeispiel auf dieser Seite kostet damit etwa $0,019. ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5 bestimmt, was /model opus startet, und ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5 gilt auch für Hintergrundaufgaben. Wer mit /model sonnet wechselt, ergänzt ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5, weil der Alias für API-Nutzer auf Sonnet 5.5 zeigt und Kunavo Sonnet 5.5 nicht anbietet.

Woran erkenne ich in /status, dass Claude Code den API-Key nutzt?

Geben Sie in der laufenden Sitzung /status ein und sehen Sie im Tab Status nach. Die Zeile Anthropic base URL muss https://api.kunavo.com zeigen, und die Zeile Auth token muss ANTHROPIC_AUTH_TOKEN nennen. Fehlt die Base-URL-Zeile, hat die Variable die Sitzung nicht erreicht. Steht dort Login method mit einem claude.ai-Konto, läuft die Sitzung über Ihr Abo. Sehen Sie schon beim ersten Start den Anmeldebildschirm, steht der Key vermutlich nur in den Projekteinstellungen, die Claude Code erst nach dem Einrichtungsassistenten auswertet.

Kann ich Claude Code mit PayPal, SEPA-Lastschrift, girocard oder EPS bezahlen?

Für das Kunavo-Guthaben gilt: EPS ja, wenn Sie aus Österreich in Euro zahlen. PayPal, SEPA-Lastschrift und Klarna im Euro-Checkout gibt es nicht. Eine reine girocard scheitert, weil Stripe girocard nicht als Kartenmarke führt. Trägt Ihre Karte zusätzlich das Visa- oder Mastercard-Logo, zahlen Sie über dieses Netz, auch per Apple Pay oder Google Pay. Kredit- und Debitkarten sowie Link gehen ebenfalls. Mindestbetrag $10, keine Monatsgebühr, das Guthaben verfällt nicht; im Euro-Betrag steckt laut Stripe eine Umrechnungsgebühr von 2–4 %. Automatisch aufladen geht nur mit gespeicherter Karte oder Link. Kunavo stellt keine Rechnungen mit ausgewiesener Umsatzsteuer aus. Ein Claude-Pro- oder Max-Abo bezahlen Sie so nicht; Anthropic selbst nimmt im Web nur Karten und kein PayPal.