Claude Code wird mit einem einzigen offiziellen Befehl installiert (unten findest du Versionen für macOS und Linux, PowerShell sowie CMD). Anthropic empfiehlt den nativen Installer; npm ist eine Alternative, die Node.js 22 oder neuer erfordert. Ohne Pro-/Max-Abonnement und ohne Anmeldung reicht es, ANTHROPIC_BASE_URL=https://api.kunavo.com (ohne /v1), ANTHROPIC_AUTH_TOKEN mit dem API-Schlüssel und vier Variablen zur Fixierung der Modelle festzulegen. Dann zahlst du nur für die verbrauchten Token aus deinem Guthaben, das du in Złoty per BLIK ab 10 USD aufladen kannst. Gib zum Schluss in Claude Code /status ein, um zu prüfen, ob der Schlüssel funktioniert.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows – wiersz polecenia (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdPolecenia i zmienne sprawdziliśmy 3. Oktober 2026 w offiziellen Dokumentation zur Installation von Claude Code i w Dokumentation zu Umgebungsvariablen. Polskiej wersji tej dokumentacji nie ma. Ceny i metody płatności sprawdziliśmy 3. Oktober 2026. Polska jest na Liste der von Anthropic unterstützten Länder (sprawdzone 3. Oktober 2026), zarówno dla Claude.ai, jak i dla API.
Anmeldung oder API-Schlüssel?
Nach der Installation muss sich Claude Code authentifizieren. Es gibt zwei Wege, und dieser Leitfaden beschreibt den zweiten ausführlich:
| Kriterium | Anmeldung mit einem Claude-Konto | API-Schlüssel (Kunavo) |
|---|---|---|
| Was erforderlich ist | Pro-, Max-, Team- oder Enterprise-Plan oder ein Console-Konto. Der kostenlose Claude.ai-Plan umfasst Claude Code nicht. | Schlüssel sk-kn-… und Umgebungsvariablen. Du benötigst weder ein Abonnement noch eine Anmeldung. |
| Wie du bezahlst | Abonament: Pro kosztuje 20 USD miesięcznie (albo 17 USD miesięcznie przy płatności rocznej, czyli 200 USD z góry), Max od 100 USD miesięcznie. Ceny nie zawierają podatku (Claude-Preise, sprawdzone 3. Oktober 2026). | Für verbrauchte Token aus einem vorausbezahlten Guthaben. Aufladung ab 10 USD, ohne monatliche Gebühr. Das Guthaben verfällt nicht. |
| Zahlungsmethoden | Subskrypcje kupowane przez stronę Anthropic można opłacić wyłącznie kartą kredytową lub debetową (FAQ zur Abrechnung von Claude, sprawdzone 3. Oktober 2026). | BLIK (Betrag in Złoty), Visa- und Mastercard-Karten, Apple Pay, Google Pay, Link |
| Was fehlt | Nicht zutreffend | Remote Control und Spracheingabe. Kunavo stellt ebenfalls keine VAT-Rechnungen aus. |
Bevor du beginnst
| Anforderung | Was die offizielle Dokumentation sagt (überprüft am 3. Oktober 2026) |
|---|---|
| System | macOS 13.0 oder neuer; Windows 10 1809 oder neuer oder Windows Server 2019 oder neuer; Ubuntu 20.04+; Debian 10+; Alpine Linux 3.19+ |
| Hardware | Mindestens 4 GB RAM, x64- oder ARM64-Prozessor (32-Bit-Windows wird nicht unterstützt) |
| Shell | Bash, Zsh, PowerShell oder CMD |
| Netzwerk und Standort | Internetverbindung in einem von Anthropic unterstützten Land (Polen steht auf der Liste) |
| Konto | Für die Anmeldung ist ein Pro-, Max-, Team- oder Enterprise-Plan oder ein Console-Konto erforderlich. Mit einem API-Schlüssel benötigst du weder ein Abonnement noch eine Anmeldung. |
| Node.js | Nur bei der Installation über npm in Version 22 oder neuer. Der native Installer benötigt es nicht. |
Methode 1: nativer Installer (empfohlen)
In der offiziellen Dokumentation trägt diese Methode den Tab „Native Install (Recommended)“. Die Befehle findest du am Anfang der Seite. Unter macOS, Linux und in WSL dient dazu die Zeile mit install.sh. Verwende in Windows PowerShell irm … | iex und in der CMD-Eingabeaufforderung die Zeile mit install.cmd. Die native Installation aktualisiert sich automatisch im Hintergrund. Claude Code kann auch über Homebrew oder WinGet installiert werden; laut Dokumentation aktualisieren sich diese Installationen standardmäßig jedoch nicht selbst, sodass du sie manuell im Paketmanager aktualisierst:
# Homebrew – kanał stable; domyślnie nie aktualizuje się sam
brew install --cask claude-code
# WinGet (Windows) – domyślnie nie aktualizuje się sam
winget install Anthropic.ClaudeCodeÖffne nach der Installation ein neues Terminalfenster, da ein zuvor geöffnetes Fenster die aktualisierte Variable PATH nicht sieht. Prüfe anschließend:
claude --version # wypisuje numer wersji, np. 2.1.280 (Claude Code)
claude doctor # diagnostyka instalacji i ustawień, bez otwierania sesjiclaude doctor öffnet keine Sitzung. Der Befehl zeigt nur den Installationsstatus und die Diagnose der Einstellungsdateien an. So kannst du ein Installationsproblem am schnellsten von einem Konfigurationsproblem unterscheiden.
Wenn der Download fehlschlägt
Jeśli terminal pokazuje syntax error near unexpected token '<' albo curl: (22) The requested URL returned error: 403, to według offiziellen Seite zu Installationsproblemen (sprawdzone 3. Oktober 2026) adres instalatora zwrócił stronę HTML lub kod błędu zamiast skryptu. Strona z napisem App unavailable in region oznacza według dokumentacji, że Claude Code nie jest dostępny w Twoim kraju. Polska jest jednak na liście obsługiwanych krajów, więc jeśli widzisz ten napis w Polsce, sprawdź, czy połączenie nie wychodzi przez VPN albo proxy. Samo 403 bez treści może też pochodzić z firmowego proxy lub zapory, która blokuje pobieranie. Dokumentacja radzi wtedy najpierw sprawdzić połączenie sieciowe, bo inne metody instalacji łączą się z tymi samymi serwerami. Spróbuj z innej sieci albo poproś administratora o odblokowanie tych adresów.
Methode 2: npm (Node.js 22 oder neuer)
npm nadal jest jedną z metod opisanych w oficjalnej dokumentacji. Pakiet wymaga Node.js 22 lub nowszego. Część polskich poradników wciąż podaje Node.js 18, co jest już nieaktualne. Na starszym Node.js npm wypisze ostrzeżenie EBADENGINE, ale nie przerwie instalacji, a claude będzie działać, bo pakiet pobiera natywny program, który nie korzysta z Node.js w czasie działania. Jeśli nie masz Node.js, zainstaluj wersję 22 lub nowszą ze Seite nodejs.org.
node -v # potrzebna wersja v22 lub nowsza
npm install -g @anthropic-ai/claude-code # bez sudo
# aktualizacja: @latest, a nie npm update -g
npm install -g @anthropic-ai/claude-code@latest- Verwende niemals
sudo npm install -g. Die Dokumentation warnt, dass dies zu Berechtigungsproblemen führt und ein Sicherheitsrisiko darstellt. - Aktualisiere über
@latest. Verwende für die Aktualisierungnpm install -g @anthropic-ai/claude-code@latestund nichtnpm update -g. - Überspringe optionale Abhängigkeiten nicht. Das eigentliche Programm wird als optionale Abhängigkeit installiert, also als Paket
@anthropic-ai/claude-code-*für deine Plattform. Mit dem Flag--omit=optionaloder mitoptional=falsein.npmrcendet die Installation unter macOS oder Linux mit der Meldungclaude native binary not installed.
Claude Code unter Windows: PowerShell, CMD, WSL und PATH
Windows verfügt über zwei unterschiedliche Installationsbefehle; die Auswahl hängt ausschließlich vom Terminal ab. Wenn die Zeile mit PS C:\Users\TwojaNazwa> beginnt, arbeitest du in PowerShell. Wenn du nur C:\Users\TwojaNazwa> ohne PS siehst, handelt es sich um die Eingabeaufforderung (CMD). Laut Dokumentation musst du das Terminal nicht als Administrator ausführen, auch wenn manche Anleitungen dies empfehlen.
Der häufigste Fehler ist, den Befehl in das falsche Terminal einzufügen. Eine in PowerShell eingefügte CMD-Zeile ergibt The token '&&' is not a valid statement separator. Eine in CMD eingefügte PowerShell-Zeile ergibt 'irm' is not recognized as an internal or external command. Unter dem polnischen Windows lautet dieselbe Meldung: „irm“ wird nicht als interner oder externer Befehl, ausführbares Programm oder Batchdatei erkannt. Umgekehrt endet eine aus macOS in PowerShell eingefügte Zeile curl … | bash mit dem Fehler A parameter cannot be found that matches parameter name 'fsSL' oder 'bash' is not recognized as the name of a cmdlet. In all diesen Fällen genügt es, die für dein Terminal vorgesehene Zeile zu verwenden.
Im Startmenü gibt es zwei Einträge: „Windows PowerShell“ und „Windows PowerShell (x86)“. Der zweite läuft als 32-Bit-Prozess und führt daher selbst auf einem 64-Bit-Computer zum Fehler Claude Code does not support 32-bit Windows. Öffne den Eintrag ohne den Zusatz (x86).
Git for Windows jest opcjonalny, ale zalecany. Gdy jest zainstalowany, Claude Code wykonuje polecenia przez dołączony do niego Git Bash, a bez niego przez PowerShell. Jeśli Git jest zainstalowany, ale Claude Code nie znajduje Git Bash, ustaw w bloku env pliku ~/.claude/settings.json zmienną CLAUDE_CODE_GIT_BASH_PATH ze ścieżką do bash.exe. Przykładowa ścieżka z dokumentacji to C:\Program Files\Git\bin\bash.exe.
| Variante | Was erforderlich ist | Sandbox | Wann auswählen |
|---|---|---|---|
| Windows nativ | Nichts; Git for Windows optional | Nicht unterstützt | Projekte und Tools laufen unter Windows |
| WSL 2 | WSL 2 aktiviert | Unterstützt | Du benötigst Linux-Tools oder eine isolierte Ausführung von Befehlen |
| WSL 1 | WSL 1 aktiviert | Nicht unterstützt | Wenn WSL 2 nicht verfügbar ist |
Wenn du WSL auswählst, führe die Zeile für macOS und Linux im WSL-Terminal aus und starte claude ebenfalls dort, nicht in PowerShell oder CMD.
Fehler bei der Ausführungsrichtlinie (npm in PowerShell)
Die Meldung npm.ps1 cannot be loaded because running scripts is disabled on this system bei der Installation oder Ausführung über npm bedeutet, dass die Ausführungsrichtlinien von PowerShell das von npm erzeugte Startskript .ps1 blockieren. Laut Dokumentation kannst du dem aktuellen Benutzer erlauben, lokale Skripte auszuführen (Befehl unten), npm.cmd und claude.cmd verwenden oder zum nativen PowerShell-Installer wechseln.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserDer Befehl „claude“ wird nach der Installation nicht erkannt
command not found: claude oder 'claude' is not recognized bedeutet, dass das Installationsverzeichnis nicht in PATH enthalten ist. Der native Installer legt das Programm unter macOS und Linux in ~/.local/bin/claude und unter Windows in %USERPROFILE%\.local\bin\claude.exe ab. Öffne zunächst ein neues Terminal. Wenn es unter Windows weiterhin nicht funktioniert, prüfe den Pfad und füge ihn in PowerShell wie in der Dokumentation beschrieben hinzu:
# 1. Sprawdź, czy katalog instalacji jest już w PATH
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Brak wyniku? Dopisz go do PATH użytkownika, zamknij i otwórz terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. W nowym terminalu
claude --versionAPI-Schlüssel statt Anmeldung (ohne Abonnement)
ANTHROPIC_BASE_URL ist eine integrierte Claude-Code-Variable. Laut der offiziellen Dokumentation überschreibt sie den API-Endpunkt, um Anfragen über einen Proxy oder ein Gateway zu leiten. Claude Code mit einem mit der Anthropic Messages API kompatiblen Dienst zu verbinden ist daher eine von Anthropic vorgesehene Konfiguration. Du benötigst weder Plugins noch ein modifiziertes Programm. Unter macOS und Linux fügst du die Variablen zur Konfigurationsdatei der Shell hinzu (~/.zshrc oder ~/.bashrc):
export ANTHROPIC_BASE_URL=https://api.kunavo.com # sama domena, bez /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-5Unter Windows kannst du die Konfiguration zunächst in einem PowerShell-Fenster prüfen:
# Działa tylko w tym oknie PowerShella – po zamknięciu znika
$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"
claudeDauerhaft trägst du die Variablen am besten in den Block env der Benutzereinstellungsdatei ~/.claude/settings.json ein (unter Windows %USERPROFILE%\.claude\settings.json). Laut Dokumentation gilt diese Datei für alle deine Projekte. Wenn die Datei bereits andere Einstellungen enthält, füge nur den Block env hinzu:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.kunavo.com",
"ANTHROPIC_AUTH_TOKEN": "sk-kn-...",
"ANTHROPIC_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
}
}In jeder dieser sechs Zeilen kann leicht ein Fehler passieren:
ANTHROPIC_BASE_URList nur die Domain. Claude Code hängt/v1/messagesselbst an. Mit/v1am Ende wird die Anfrage an/v1/v1/messagesgesendet und liefert 404.ANTHROPIC_AUTH_TOKEN, nichtANTHROPIC_API_KEY. Der Wert vonANTHROPIC_AUTH_TOKENwird mit dem PräfixBearerin den HeaderAuthorizationübernommen und funktioniert sofort.ANTHROPIC_API_KEYwird in den Headerx-api-keyübernommen und muss im interaktiven Modus einmal bestätigt werden. Wenn du dies ablehnst, wird der Schlüssel stillschweigend ignoriert. Du aktivierst ihn erneut über/config→ Use custom API key.ANTHROPIC_MODELwählt das Hauptmodell aus. Hier ist es Claude Sonnet 5 (claude-sonnet-5). Der Name muss genau dem Namen in der Kunavo-Modellliste entsprechen. Ältere Namen mit einem Datum am Ende erkennt Kunavo nicht.ANTHROPIC_DEFAULT_OPUS_MODELundANTHROPIC_DEFAULT_SONNET_MODELfixieren die Aliaseopusundsonnet. Według offiziellen Dokumentation zur Modellkonfiguration (sprawdzone 3. Oktober 2026) dla użytkowników API model domyślny i aliasopuswskazują Opus 5.5, a aliassonnetwskazuje Sonnet 5.5. Aliasy z czasem się zmieniają, a wersję przypina się pełną nazwą modelu albo zmiennymi takimi jak te dwie. Zapytanie o model, którego nie ma w Kunavo, zwraca 404. Aliasopusprzypinamy do Claude Opus 5.5 (claude-opus-5-5), bo kolejny Opus wydany przez Anthropic nie musi być od razu dostępny w Kunavo. Opus 5.5 wymaga Claude Code w wersji 2.1.280 lub nowszej, starszą wersję zaktualizujesz poleceniemclaude update. Sonnet 5.5 nie jest obecnie (stan na 3. Oktober 2026) dostępny w Kunavo, więc bez przypięcia aliasusonnetdoclaude-sonnet-5błąd 404 zwracają/model sonnet, faza wykonania w trybieopusplani subagenci ustawieni namodel: sonnet.ANTHROPIC_DEFAULT_HAIKU_MODELverarbeitet auch Hintergrundaufgaben. Laut Dokumentation wählt diese Variable das Modell für den Aliashaikuund für im Hintergrund ausgeführte Funktionen aus. Bei Kunavo kostet Claude Haiku 4.5 0,70 USD pro Million Eingabe-Token und 3,50 USD pro Million Ausgabe-Token. Das Hauptmodell Claude Sonnet 5 kostet 1,40 USD / 7,00 USD (Anthropic-Preisliste: 2,00 USD / 10,00 USD), während Claude Opus 5.5 2,80 USD / 14,00 USD kostet (Eingabe / Ausgabe, pro Million Token).
Klucza nein wpisuj do projektowego .claude/settings.json. Według Dokumentation zur Gateway-Anbindung ten plik trafia do repozytorium, a więc do każdego, kto je sklonuje. Pamiętaj też o kolejności pierwszeństwa. Gdy ta sama zmienna jest ustawiona i w powłoce, i w bloku env pliku ustawień, w większości sesji obowiązuje wartość z pliku ustawień. Osobna zasada dotyczy klucza model w pliku ustawień: zmienna ANTHROPIC_MODEL ma przed nim pierwszeństwo, a model działa tylko wtedy, gdy zmiennej nie ma. Jeśli zmiana w powłoce nie działa, najpierw sprawdź plik ustawień. W rozszerzeniu Claude Code dla VS Code zmienne ustawia się w claudeCode.environmentVariables, w ustawieniach użytkownika samego VS Code.
Erster Start und /status
Laut der Dokumentation zur Gateway-Anbindung (überprüft am 3. Oktober 2026) öffnet der Befehl claude mit gesetztem ANTHROPIC_AUTH_TOKEN sofort eine Sitzung ohne Anmeldebildschirm. Die Variable wirkt sofort und muss nicht wie ANTHROPIC_API_KEY bestätigt werden. Wenn du stattdessen den Anmeldebildschirm siehst, hat Claude Code den Schlüssel nicht gelesen.
Der Schlüssel muss dort stehen, wo Claude Code ihn vor der ersten Konfiguration liest, also in der Shell mit dem Befehl export gesetzt oder im Block env der Benutzereinstellungsdatei ~/.claude/settings.json. Im interaktiven Modus wird der Block env aus dem Projektverzeichnis .claude/settings.json oder .claude/settings.local.json erst nach dem Assistenten für den ersten Start und der Frage nach dem Vertrauen in den Ordner wirksam. Wenn der Schlüssel nur in den Projekteinstellungen steht, siehst du beim ersten Start trotzdem den Anmeldebildschirm.
Gib in der Sitzung /status ein und prüfe zwei Zeilen:
Anthropic base URLerscheint nur, wenn die Gateway-Adresse festgelegt ist. Sie solltehttps://api.kunavo.comanzeigen. Wenn diese Zeile fehlt, hatANTHROPIC_BASE_URLdie Sitzung nicht erreicht.Auth tokenmit dem NamenANTHROPIC_AUTH_TOKENbedeutet, dass ein API-Schlüssel und nicht eine gespeicherte claude.ai-Anmeldung verwendet wird. Wenn duLogin methodmit einem claude.ai-Konto siehst, hat die Variable nicht funktioniert.
Du kannst Adresse und Schlüssel auch vor dem Start von Claude Code mit der Methode aus der offiziellen Dokumentation prüfen. Dabei wird eine Anfrage mit 1 Ausgabe-Token gesendet, die einen symbolischen Betrag vom Guthaben abbucht. Der Befehl liest die Variablen aus der aktuellen Shell. Auch wenn der Schlüssel in einer Einstellungsdatei steht, musst du die Variablen daher zuerst mit export in diesem Terminal setzen. Eine mit {"id":"msg_ beginnende JSON-Antwort bedeutet, dass Adresse und Schlüssel funktionieren. Der Code 401 bedeutet, dass der Schlüssel abgelehnt wurde.
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": "."}]}'In PowerShell sieht dieselbe Prüfung so aus. Wenn alles funktioniert, siehst du in der Antwort ein Feld id, das mit msg_ beginnt:
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": "."}]}'Was mit einem API-Schlüssel anders funktioniert
- Remote Control und Spracheingabe sind nicht verfügbar. Laut Dokumentation erfordern sie eine claude.ai-Identität und funktionieren nicht, wenn
ANTHROPIC_AUTH_TOKENaktiv ist. Ab Version 2.1.196 wird Remote Control außerdem deaktiviert, wennANTHROPIC_BASE_URLauf einen anderen Host alsapi.anthropic.comverweist. /fastzeigt den Schnellmodus als deaktiviert an. Laut Dokumentation behandelt Claude Code den Fast Mode als deaktiviert, wenn nur ein Bearer-Token vorhanden ist, und sendet keine Anfrage zur Verfügbarkeit.- Die Suche nach MCP-Tools ist standardmäßig deaktiviert. Dies geschieht, wenn
ANTHROPIC_BASE_URLauf einen anderen Host als Anthropic verweist. - Die Zahlen in
/contextsind Schätzungen. Kunavo nie udostępnia endpointu/v1/messages/count_tokens. Według Dokumentation zur Gateway-Kompatibilität (sprawdzone 3. Oktober 2026) Claude Code liczy wtedy tokeny lokalnie na podstawie liczby znaków.
Die vollständige Beschreibung der Integration findest du in der Dokumentation zur Claude-Code-Integration (auf Englisch); die englische Version dieses Leitfadens steht im Artikel Install Claude Code.
BLIK-Zahlung: Guthabenaufladung und API-Schlüssel
Subskrypcje Claude kupowane przez stronę Anthropic można opłacić wyłącznie kartą kredytową lub debetową (FAQ zur Abrechnung von Claude, sprawdzone 3. Oktober 2026). BLIK-iem nie zapłacisz za Pro ani za Max. W Kunavo BLIK doładowuje przedpłacone saldo API, z którego Claude Code płaci za tokeny po ustawieniu klucza tak jak wyżej. Wszystkie kroki płatności opisuje poradnik wie man Claude mit BLIK bezahlt, a w skrócie wygląda to tak:
- Erstelle ein Kunavo-Konto per E-Mail oder Google-Konto. Bei der Registrierung musst du keine Karte angeben.
- Wähle im Tab Abrechnung (Billing) den Aufladebetrag aus. Das Minimum beträgt 10 USD, und es gibt keine monatliche Gebühr. Bei höheren Beträgen erhältst du einen Bonus: 100 USD → 110 USD na saldzie, 1000 USD → 1200 USD na saldzie, 5000 USD → 6250 USD na saldzie.
- Na stronie płatności Stripe kwota jest pokazana w złotych. Wybierz BLIK, wygeneruj w aplikacji bankowej sześciocyfrowy kod, wpisz go i potwierdź płatność w aplikacji. Według Stripe-Dokumentation (sprawdzone 3. Oktober 2026) kod BLIK jest ważny 2 minuty, a po rozpoczęciu płatności masz 60 sekund na jej zatwierdzenie.
- Erstelle im Tab API-Schlüssel einen Schlüssel, der mit
sk-kn-beginnt. Der Schlüssel wird nur einmal angezeigt. Speichere ihn daher sofort und trage ihn inANTHROPIC_AUTH_TOKENein.
Na stronie płatności w złotych oprócz BLIK-a są też karty (Visa, Mastercard), Apple Pay i Google Pay na obsługiwanych urządzeniach oraz Link. Nie ma natomiast Przelewy24, PayU, PayPal ani zwykłego przelewu bankowego. Ceny są ustalone w dolarach, a Stripe przelicza je na złote. Według Stripe-Dokumentation zu Adaptive Pricing (sprawdzone 3. Oktober 2026) kurs zawiera opłatę za przewalutowanie w wysokości 2–4%, którą ponosi kupujący. Płacąc kartą w dolarach, unikniesz tej opłaty, choć wtedy obowiązują kurs i opłaty Twojego banku, a BLIK działa tylko w złotych. Dokładną kwotę w złotych zobaczysz na stronie płatności przed potwierdzeniem.
BLIK funktioniert nur bei manueller Aufladung. Für die automatische Aufladung ist eine gespeicherte Karte oder Link erforderlich. Das Guthaben verfällt nicht, und für fehlgeschlagene Anfragen zahlst du nicht. Kunavo stellt keine VAT-Rechnungen aus; den Aufladeverlauf findest du im Tab Abrechnung (Billing). Denke daran: Es handelt sich um eine Aufladung des Kunavo-API-Guthabens und nicht um eine Zahlung für Claude Pro oder Max.
Wie viel kostet es (Beispielrechnung)
In Claude Code zahlst du für Token. Bei jeder Anfrage sendet Claude Code den gesamten Gesprächskontext erneut, aber der sich wiederholende Anfang des Kontexts kann zum Cache-Lesetarif abgerechnet werden. Unten findest du eine Beispielrechnung auf Tokenbasis. Dies ist weder eine Messung noch eine obere Kostengrenze. Alle Annahmen sind angegeben:
- jede Anfrage hat 40 000 Eingabe-Token, davon werden 36 000 (90 %) als Cache-Lesevorgang und die übrigen 4000 als Cache-Schreibvorgang abgerechnet;
- jede Anfrage gibt 1000 Ausgabe-Token zurück;
- eine Arbeitssitzung umfasst 50 solche Anfragen, ohne Aufrufe von Claude Haiku 4.5 im Hintergrund;
- Bei Kunavo kostet das Lesen aus dem Cache 10% des Eingabetarifs, das Schreiben in den Cache dagegen 1,25× des Eingabetarifs. Dies sind die Verhältnisse für Claude Sonnet 5; jedes Modell in der Übersicht wird nach seinen eigenen Verhältnissen berechnet.
| Modell | Eine Anfrage | 50 Anfragen | 50 Anfragen ohne einen einzigen Cache-Treffer |
|---|---|---|---|
| Claude Sonnet 5 | 0,019 USD | 0,95 USD | 3,15 USD |
| Claude Opus 5.5 | 0,033 USD | 1,65 USD | 6,30 USD |
Die tatsächlichen Kosten hängen von der Kontextlänge, der Anzahl der Cache-Treffer, der Antwortlänge und davon ab, ob du die Unterhaltung zwischen Aufgaben mit dem Befehl /clear löschst. Die Tarife aller Modelle findest du in der Preisliste. Deinen eigenen Verbrauch kannst du mit dem Claude-Tokenkostenrechner (auf Englisch) schätzen. Der Leitfaden Wie viel kostet Claude Code? beschreibt, wann ein Abonnement und wann die API günstiger ist.
Häufigste Fehler
| Meldung | Ursache und Lösung |
|---|---|
The token '&&' is not a valid statement separator | Die CMD-Zeile wurde in PowerShell eingefügt. Verwende irm … | iex. |
'irm' is not recognized as an internal or external command | Die PowerShell-Zeile wurde in CMD eingefügt. Verwende die Zeile mit install.cmd. |
A parameter cannot be found that matches parameter name 'fsSL', 'bash' is not recognized as the name of a cmdlet | Der Befehl für macOS und Linux wurde unter Windows ausgeführt. Verwende die PowerShell-Zeile. |
syntax error near unexpected token '<', 403 | Die Installer-Adresse hat eine HTML-Seite oder einen Fehlercode zurückgegeben. Prüfe VPN, Proxy und Firewall. Andere Installationsmethoden verbinden sich mit denselben Servern und umgehen das Problem daher nicht von selbst. |
command not found: claude, 'claude' is not recognized | Das Installationsverzeichnis ist nicht in PATH enthalten. Öffne ein neues Terminal und füge unter Windows den Pfad mit den oben angegebenen PowerShell-Befehlen hinzu. |
Warnung EBADENGINE | Node.js ist älter als 22. Die Installation wird trotzdem abgeschlossen, aber es ist sinnvoll, Node.js zu aktualisieren. |
claude native binary not installed (macOS, Linux) | npm hat optionale Abhängigkeiten (--omit=optional oder optional=false) oder Installationsskripte (--ignore-scripts) übersprungen. Entferne diese Einstellungen und installiere erneut. |
npm.ps1 cannot be loaded | Die PowerShell-Ausführungsrichtlinien blockieren das npm-Skript. Führe den Befehl Set-ExecutionPolicy aus oder verwende den nativen Installer. |
Claude Code does not support 32-bit Windows | PowerShell (x86) ist geöffnet. Öffne das normale „Windows PowerShell“. |
| Anmeldebildschirm trotz gesetztem Schlüssel | Claude Code hat den Schlüssel nicht gelesen. Trage die Variablen in die Shell oder in ~/.claude/settings.json ein, nicht nur in die Projekteinstellungen, und öffne ein neues Terminal. |
401 | Der Schlüssel wurde abgelehnt. Prüfe, ob der Schlüssel sk-kn- vollständig und ohne Leerzeichen kopiert wurde, nicht unter /app/keys gelöscht wurde und in ANTHROPIC_AUTH_TOKEN steht. |
404 | ANTHROPIC_BASE_URL endet mit /v1 oder das Modell steht nicht auf der Kunavo-Liste, beispielsweise weil die vier Variablen zur Fixierung der Modelle nicht gesetzt wurden. |
Einschränkungen
- Kunavo stellt keine VAT-Rechnungen aus.
- BLIK funktioniert nur bei manueller Aufladung. Die automatische Aufladung erfordert eine gespeicherte Karte oder Link.
- Dies ist eine nach Token abgerechnete API und kein Claude-Pro- oder-Max-Abonnement. Mit einem API-Schlüssel funktionieren weder Remote Control noch Spracheingabe, der Modus
/fastist deaktiviert und die Suche nach MCP-Tools ist standardmäßig deaktiviert. - Kunavo bietet Sonnet 5.5 derzeit (Stand 3. Oktober 2026) nicht an. Daher fixiert die obige Konfiguration den Alias
sonnetaufclaude-sonnet-5. Ohne fixierte Modelle können die Standardaliase 404 zurückgeben. Claude Opus 5.5, der dem Aliasopuszugeordnet ist, erfordert Claude Code in Version 2.1.280 oder neuer. - Die offizielle Claude-Code-Dokumentation und die Kunavo-Integrationsdokumentation sind nur auf Englisch verfügbar.
Häufig gestellte Fragen
Wie installiert man Claude Code?
Am einfachsten mit dem nativen Installer, den Anthropic in der Dokumentation als empfohlen bezeichnet. Führen Sie unter macOS, Linux und WSL curl -fsSL https://claude.ai/install.sh | bash aus. Unter Windows führen Sie in PowerShell irm https://claude.ai/install.ps1 | iex und in der Eingabeaufforderung (CMD) curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd aus. Öffnen Sie anschließend ein neues Terminalfenster und prüfen Sie die Installation mit dem Befehl claude --version. Die native Installation aktualisiert sich automatisch im Hintergrund.
Claude Code über npm: Welche Node.js-Version wird benötigt?
Laut der offiziellen Installationsdokumentation (geprüft am 3. Oktober 2026) erfordert das npm-Paket Node.js 22 oder neuer, nicht 18, wie ältere Anleitungen angeben. Bei einer älteren Node.js-Version gibt npm lediglich eine EBADENGINE-Warnung aus, und die Installation ist trotzdem erfolgreich, weil das Paket ein natives Programm herunterlädt, das zur Laufzeit nicht auf Node.js angewiesen ist. Installieren Sie mit npm install -g @anthropic-ai/claude-code ohne sudo und aktualisieren Sie mit npm install -g @anthropic-ai/claude-code@latest, nicht mit npm update -g.
Wie installiert man Claude Code unter Windows? Benötige ich WSL und Git?
Weder WSL noch Git sind erforderlich. Führen Sie den Installationsbefehl für PowerShell oder CMD ohne Administratorrechte aus. Git for Windows ist optional, aber empfehlenswert: Wenn es installiert ist, führt Claude Code Befehle über Git Bash aus, andernfalls über PowerShell. Wählen Sie WSL 2, wenn Sie Linux-Tools oder eine isolierte Befehlsausführung (Sandbox) benötigen; installieren und starten Sie claude dann im WSL-Terminal. Öffnen Sie nicht „Windows PowerShell (x86)“: Dabei handelt es sich um einen 32-Bit-Prozess, und Claude Code unterstützt 32-Bit-Windows nicht.
Kann ich Claude Code ohne Pro-/Max-Abonnement und ohne Anmeldung verwenden?
Ja. Die Anmeldung mit einem Claude-Konto erfordert einen Pro-, Max-, Team- oder Enterprise-Tarif oder ein Console-Konto; der kostenlose Claude.ai-Tarif umfasst Claude Code nicht. Statt einer Anmeldung können Sie die Variablen ANTHROPIC_BASE_URL=https://api.kunavo.com und ANTHROPIC_AUTH_TOKEN mit einem API-Key setzen. Claude Code startet dann ohne Anmeldebildschirm und rechnet die verwendeten Tokens mit dem Prepaid-Guthaben von Kunavo ab, ohne Abonnement. In diesem Modus funktionieren Remote Control und Sprachdiktat nicht, da sie eine claude.ai-Identität erfordern.
Wo gebe ich den API-Key für Claude Code ein, und muss ANTHROPIC_BASE_URL mit /v1 enden?
Ohne /v1. Claude Code hängt /v1/messages selbst an; eine Adresse mit /v1 am Ende leitet Requests daher an /v1/v1/messages weiter und endet mit einem 404-Fehler. Tragen Sie die Variablen in die Konfigurationsdatei der Shell (~/.zshrc, ~/.bashrc oder $PROFILE in PowerShell) oder in den env-Block der Benutzereinstellungsdatei ~/.claude/settings.json ein (unter Windows %USERPROFILE%\.claude\settings.json). Tragen Sie den Key niemals in die projektbezogene .claude/settings.json ein, da diese Datei in das Repository gelangt. Wenn dieselbe Variable sowohl in der Shell als auch in der Einstellungsdatei gesetzt ist, gilt in den meisten Sitzungen der Wert aus der Einstellungsdatei.
Warum ANTHROPIC_MODEL, ANTHROPIC_DEFAULT_OPUS_MODEL und ANTHROPIC_DEFAULT_SONNET_MODEL festlegen?
Ohne sie verwendet Claude Code Aliase, die sich mit neuen Anthropic-Modellen verschieben. Laut der offiziellen Dokumentation zur Modellkonfiguration (überprüft am 3. Oktober 2026) verweisen das Standardmodell und der Opus-Alias für API-Nutzer auf Opus 5.5, während der Sonnet-Alias auf Sonnet 5.5 verweist. Kunavo bietet Sonnet 5.5 derzeit (Stand 3. Oktober 2026) nicht an. Ohne die Fixierung des Sonnet-Alias liefern /model sonnet, die Ausführungsphase im opusplan-Modus und Subagenten mit model: sonnet daher 404. Auch der neue Opus muss in Kunavo nicht sofort verfügbar sein. Nach der Fixierung ist das Hauptmodell claude-sonnet-5, der Opus-Alias claude-opus-5-5 (Opus 5.5 erfordert Claude Code in Version 2.1.280 oder neuer; eine ältere Version aktualisierst du mit dem Befehl claude update), der Sonnet-Alias claude-sonnet-5 und der Haiku-Alias sowie Hintergrundaufgaben claude-haiku-4-5. Damit ist klar, welches Modell antwortet und nach welchem Tarif du bezahlst.
Wie prüfe ich, ob Claude Code einen API-Schlüssel und nicht ein claude.ai-Konto verwendet?
Gib in der Claude-Code-Sitzung /status ein. Die Zeile „Anthropic base URL“ sollte https://api.kunavo.com anzeigen, und die Zeile „Auth token“ sollte auf ANTHROPIC_AUTH_TOKEN verweisen. Wenn du stattdessen „Login method“ mit einem claude.ai-Konto siehst, wurden die Variablen nicht eingelesen. Beende die Sitzung, öffne ein neues Terminal und prüfe, wo sie eingetragen wurden.
Kann ich mit BLIK bezahlen? Und gibt es automatische Aufladung und eine VAT-Rechnung?
Ja, du kannst dein Kunavo-API-Guthaben mit BLIK aufladen. Die Stripe-Zahlungsseite zeigt den Betrag in Złoty an; neben BLIK stehen auch Visa- und Mastercard-Karten, Apple Pay, Google Pay und Link zur Verfügung. Die Mindestaufladung beträgt 10 USD, es gibt keine monatliche Gebühr und das Guthaben verfällt nicht. Der Stripe-Wechselkurs enthält eine Umtauschgebühr von 2–4 %. BLIK funktioniert nur bei manueller Aufladung, da die automatische Aufladung eine gespeicherte Karte oder Link erfordert. Kunavo stellt keine VAT-Rechnungen aus. Dies ist keine Zahlung für Claude Pro oder Max: Abonnements, die auf der Anthropic-Website gekauft werden, können ausschließlich per Karte bezahlt werden.