Install Claude Code: commands for Windows, macOS, and Linux, an API key without a subscription, and payment without PayPal

In short: Install Claude Code with a single line in the terminal, without Node.js and without administrator rights. Which line depends only on the window: curl -fsSL https://claude.ai/install.sh | bash on macOS, Linux, and WSL; irm https://claude.ai/install.ps1 | iex in Windows PowerShell; and the third line below in Command Prompt (CMD). If you do not have a Claude subscription, connect Claude Code to Kunavo with an API key afterward: ANTHROPIC_BASE_URL=https://api.kunavo.com (without /v1), ANTHROPIC_AUTH_TOKEN, and four model variables. /status shows whether it works. You pay per token from prepaid credit starting at $10, topped up by debit or credit card (including Visa Debit and Debit Mastercard), Apple Pay, Google Pay, Link, or EPS in Austria. PayPal and SEPA direct debit are not available.

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

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

:: 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 October 3, 2026 mit Set up Claude Code abgeglichen, die Variablen mit der Liste der Environment variables. Kunavos Preise und Zahlungswege sind auf dem Stand vom October 3, 2026. Deutschland, Österreich und die Schweiz stehen in Anthropics Country list sowohl für Claude.ai als auch für die API (Stand October 3, 2026). Eine englische Fassung gibt es unter Install Claude Code.

The process at a glance

1. Install: run the appropriate line above, then open a new terminal window.
2. Check: claude --version outputs a version number.
3. Decide: sign in with a Claude subscription or use an API key (comparison below).
4. With an API key: top up credit, create a key, and set six environment variables.
5. Check: enter /status in the session.

Requirements: what applies today

Manche deutschsprachigen Anleitungen beschreiben einen älteren Stand von Claude Code. Die Tabelle stellt verbreitete Angaben neben das, was die official setup page am October 3, 2026 verlangt.

Install on macOS, Linux, and WSL

In the terminal, paste the line containing install.sh. In the official documentation, this method appears under the “Native Installation (Recommended)” tab. The script places the launcher at ~/.local/bin/claude, and the installation then updates itself in the background. In WSL, use the same line in the WSL terminal.

Install Claude Code on Windows

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 Setup page für keine der beiden Varianten. Der Installer legt claude.exe unter %USERPROFILE%\.local\bin ab.

If you use the wrong window, you get an English message, or sometimes a German one on German-language Windows. The CMD line in PowerShell ends with The token '&&' is not a valid statement separator, while the PowerShell line in CMD ends with 'irm' is not recognized as an internal or external command. Both mean the same thing: wrong window, so use the other line.

Lassen Sie im Startmenü den Eintrag „Windows PowerShell (x86)“ links liegen. Laut Troubleshooting 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 for 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.

Whether to use native Windows or WSL depends on where your projects are:

With WSL, install and run claude in the WSL terminal, not in PowerShell or CMD.

Alternatives: Homebrew, WinGet, and npm

If you prefer managing software through a package manager, you can do so, with one caveat: according to the documentation, Homebrew and WinGet installations do not update themselves, so you need to run upgrade regularly. Homebrew offers two casks. claude-code follows the stable channel, which lags by about one week and skips versions with major regressions; claude-code@latest receives every version immediately.

# 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

Using npm

npm remains an officially documented option. The requirement is Node.js 22 or later. The npm package downloads the same native binary as the installer and does not need Node.js at runtime. That is why installation with an older Node.js does not abort either; npm only warns with EBADENGINE. If you do not have Node.js yet, the native installer is the shorter route.

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 Setup page: none 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.

Verify the installation

Open a new terminal window for this. A window that was already open before installation does not yet know about the updated PATH and therefore cannot find claude.

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

claude doctor is the tool to use when something is wrong. It does not start a session, but lists installation status, errors in settings files, and warnings with suggested solutions. This helps you determine whether the problem is with the installation or the configuration.

When installation gets stuck

The download returns HTML or a 403

Beginnt die Ausgabe mit syntax error near unexpected token '<' oder meldet curl einen 403, kam laut Troubleshooting (Stand October 3, 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” is not found

command not found: claude on macOS and Linux, or an unrecognized claude on Windows, means the installation folder is missing from PATH. Usually, a new window is enough. If that does not help on macOS or Linux, add ~/.local/bin to ~/.zshrc or ~/.bashrc. On Windows, check and add the folder as shown in the troubleshooting section:

# 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 blocks npm.ps1

This affects only the npm variant. The message npm.ps1 cannot be loaded because running scripts is disabled on this system means that the execution policy blocks npm's startup script. You can run npm.cmd and claude.cmd, which are not covered by the policy, switch to the native installer, or allow local scripts for your user account:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Subscription or 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 guide 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.

The Claude Code pricing guide shows when Pro or Max becomes more cost-effective than the key.

Set up an API key (without a subscription)

Dass Claude Code einen anderen Endpunkt anspricht, ist kein Trick. ANTHROPIC_BASE_URL steht in Anthropics Variable list 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. Sign up with Kunavo using an email address or Google account.
2. Under Billing, add at least $10 in credit (payment methods are listed in the payment section).
3. Under API-Keys, create a key. It starts with sk-kn- and is only shown once, so copy it immediately.
4. Set the variables as shown below.

When entered in ~/.zshrc or ~/.bashrc, the values apply to every new terminal on macOS, Linux, and WSL:

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-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

In PowerShell, $env: assignments apply only to the open window, which is useful for a first test:

# 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-5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "claude-sonnet-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 guide (Stand October 3, 2026) für alle Ihre Projekte. Gibt es sie schon, ergänzen Sie nur den env-Block:

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

The VS Code extension reads the variables from claudeCode.environmentVariables in VS Code user settings (command Preferences: Open User 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" }
  ]
}

What each variable does

Warum ein festes Startmodell? Laut Model configuration (Stand October 3, 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 costs twice as much per token as Claude Sonnet 5. Mit festen Modellnamen wissen Sie, welches Modell antwortet und zu welchem Tarif. Der Opus-Pin hält den Alias opus auf Claude Opus 5.5 (claude-opus-5-5), auch wenn Anthropic ihn später auf ein neueres Opus umstellt. Opus 5.5 kostet bei Kunavo pro Token less than Claude Opus 5 ($2,80 / $14,00 gegenüber $3,50 / $17,50 pro 1 Mio. Input-/Output-Tokens) und setzt Claude Code ab Version 2.1.280 voraus; eine ältere Installation bringt claude update auf den aktuellen Stand. Der Sonnet-Pin ist Pflicht: Der Alias sonnet zeigt für API-Nutzer auf Sonnet 5.5, das Kunavo nicht anbietet, und ohne ANTHROPIC_DEFAULT_SONNET_MODEL enden /model sonnet, die Ausführungsphase von opusplan und Subagents mit model: sonnet mit 404. Claude Haiku 4.5 hält die Hintergrundaufgaben günstig, und mit /model wechseln Sie in der Sitzung jederzeit.

Two things about storage. The key should never go in a project's .claude/settings.json, because according to the gateway guide this file is committed and ends up with everyone who clones the repository. And if a shell export and an env block set the same variable, the settings file wins. So if you change a variable in the shell and nothing happens, the old value is probably still in a settings.json.

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

All Claude models and rates are listed in the Claude API pricing guide and on the pricing page.

First launch: check with /status

Wechseln Sie in Ihren Projektordner und starten Sie claude. Mit gesetztem ANTHROPIC_AUTH_TOKEN geht es direkt in die Sitzung, without a sign-in screen. Erscheint er trotzdem, hat Claude Code keinen Key gefunden. Der häufigste Grund laut Gateway guide: 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 the session, /status shows in the Status tab where Claude Code gets the address and credentials. Two lines are decisive:

You can also test the connection without Claude Code, using the request from the gateway guide (with the model set to claude-sonnet-5 here). It requests exactly one output token and therefore costs only a tiny amount. The commands read the shell variables; if your values exist only in settings.json, export them for the test as well.

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

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

If JSON is returned beginning with {"id":"msg_, or in PowerShell an object with an id beginning with msg_, the address and key are correct. A 401 means the key was rejected.

What changes with an API key

Most things remain the same: editing code, tools, subagents, MCP servers, hooks, and prompt caching work as usual. You should know four differences:

• Remote Control and voice dictation are unavailable. According to the gateway guide, both require a claude.ai identity and are disabled while ANTHROPIC_AUTH_TOKEN or ANTHROPIC_API_KEY is active. Since version 2.1.196, Remote Control is also disabled when ANTHROPIC_BASE_URL points to a host outside Anthropic.
• /fast reports Fast Mode as unavailable. With only a bearer token, Claude Code treats it as disabled and does not send the availability check at all.
• MCP tool search is disabled. Laut MCP documentation (Stand October 3, 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 shows estimates. Kunavo bietet /v1/messages/count_tokens nicht an. Ohne diesen Endpunkt zählt Claude Code laut Gateway compatibility guide (Stand October 3, 2026) anhand der Zeichen.

More about the integration is available in the Claude Code integration guide (in English).

Paying without PayPal and 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 (Billing FAQ). PayPal oder Venmo nimmt Anthropic laut dem Help article about declined cards nicht an (beides Stand October 3, 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 Stripe documentation on Adaptive Pricing (Stand October 3, 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:

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 supported card brands führt (Stand October 3, 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.

Not available: PayPal, SEPA direct debit, manual bank transfer (prepayment), giropay, and Sofort. Checkout offers Klarna only to buyers in the United States; switching to US dollars from outside the United States still does not show Klarna.

1. Create an account; Kunavo does not ask for a card during registration.
2. Under Billing, choose a top-up tier starting at $10. Higher tiers include bonus credit: $100 ergeben $110, $1.000 ergeben $1.200, $5.000 ergeben $6.250.
3. Choose the payment method in Stripe Checkout. You see the euro amount before confirmation; with EPS, confirm in online banking.
4. Under API-Keys, create a key and enter it as ANTHROPIC_AUTH_TOKEN.

The credit is prepaid: no monthly fee, no expiration, and failed requests are not charged. Automatic top-ups work only with a saved card or Link; use Apple Pay, Google Pay, and EPS to top up manually. Kunavo does not issue invoices showing VAT; you can view your top-ups under Billing. For more on payment methods and declined cards: Pay for Claude without a credit card.

What a session costs: example calculation

With an API key, you pay for tokens, and Claude Code sends the entire previous context with every step. That context is not charged in full every time: the model reads the unchanged beginning from the cache, for which the lower cache-read rate applies. The table works through an assumed pattern; it is neither a measurement nor a limit. Assume:

• 40.000 input tokens per request, of which 36.000 (90%) are read from the cache and 4.000 are newly written to the cache;
• 1.000 output tokens per request;
• 50 such requests per work session, excluding background calls;
• Cache reads cost Claude Sonnet 5 10 % of the input rate, while cache writes cost 1,25 times as much; each model in the table is calculated using its own factors.

What you actually pay depends on context length, cache hits, and response length, as well as whether you start over with /clear between two tasks. For your own figures, use the Claude token calculator (in English); the Claude Code pricing guide works through the comparison with Pro and Max.

Error messages and what they mean

Limitations of this approach

• You pay per token, not a flat fee. If you use Claude Code for hours every day, Pro or Max is often cheaper. With variable usage, you pay only for what you use, and a month without usage costs nothing.
• Without a claude.ai account, Remote Control and voice dictation are unavailable; /fast is considered disabled, and MCP tool search is off by default.
• Kunavo does not currently offer Sonnet 5.5; /model sonnet, opusplan, and Sonnet subagents therefore require the Sonnet pin shown in the examples above.
• Apple Pay, Google Pay, and EPS are suitable only for manual top-ups; automatic top-ups work only with a card or Link. Euro amounts include Stripe’s conversion fee.
• Kunavo does not issue invoices showing VAT separately.
• Anthropic’s Claude Code documentation is available in German; Kunavo’s integration guide is available only in English.

Frequently asked questions