Für die Installation von Claude Code genügt ein Befehl, der je nach Terminal unterschiedlich ist: die Zeile mit install.sh unter macOS, Linux und WSL, irm … | iex in PowerShell und die Zeile mit install.cmd in der Eingabeaufforderung. Dies ist die von Anthropic empfohlene Methode; npm bleibt möglich, erfordert aber Node.js 22 oder höher. Der kostenlose Claude-Tarif umfasst Claude Code nicht, daher benötigst du ein Pro-Abonnement oder höher oder einen API-Schlüssel. Hier folgst du dem zweiten Weg: ANTHROPIC_BASE_URL=https://api.kunavo.com (ohne /v1), den Schlüssel in ANTHROPIC_AUTH_TOKEN, vier Variablen zur Festlegung der Modelle und /status zur abschließenden Überprüfung. Das Guthaben wird mit Satispay in Euro ab $10 aufgeladen, und du zahlst nur für die verbrauchten Token.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows – Prompt dei comandi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdDa dove vengono questi comandi: la documentazione di Claude Code esiste anche in italiano e l'abbiamo riletta il 3. Oktober 2026, in particolare le pagine su Installation e LLM-Gateway. Prezzi e metodi di pagamento di Kunavo sono aggiornati al 3. Oktober 2026. Anthropic serve l'Italia sia su Claude.ai sia con l'API (unterstützte Länder, letto il 3. Oktober 2026).
Was benötigt wird
I requisiti della offizielle Dokumentation (letta il 3. Oktober 2026) sono bassi:
- macOS 13.0 oder höher; Windows 10 1809 oder höher oder Windows Server 2019 oder höher; Ubuntu 20.04+, Debian 10+ oder Alpine Linux 3.19+.
- Mindestens 4 GB RAM und ein x64- oder ARM64-Prozessor. 32-Bit-Windows wird nicht unterstützt.
- Eine Shell aus Bash, Zsh, PowerShell und CMD.
- Eine Verbindung aus einem von Anthropic unterstützten Land: Italien wird unterstützt.
- Node.js nur, wenn du npm wählst, in diesem Fall ab Version 22.
Welcher Befehl in welchem Terminal
| Wo du ihn ausführst | Woran du ihn erkennst | Einzufügende Zeile |
|---|---|---|
| macOS, Linux, WSL | Terminal, iTerm oder die WSL-Shell | curl … install.sh | bash |
| Windows PowerShell | Die Eingabeaufforderung beginnt mit PS C:\Users\nome> | irm … install.ps1 | iex |
| Windows, Eingabeaufforderung | Die Eingabeaufforderung besteht nur aus C:\Users\nome>, ohne PS | Die Zeile mit install.cmd |
Administratorrechte und WSL sind nicht erforderlich: Die offizielle Dokumentation sagt dies ausdrücklich, auch wenn mehrere Anleitungen im Internet das Gegenteil nahelegen. Nach der Installation aktualisiert sich Claude Code automatisch im Hintergrund. Wer einen Paketmanager bevorzugt, kann Homebrew oder WinGet verwenden; in diesem Fall muss er die Updates selbst starten:
# Homebrew – canale stable; non si aggiorna da solo
brew install --cask claude-code
# WinGet (Windows) – non si aggiorna da solo
winget install Anthropic.ClaudeCodeBevor du es ausprobierst, schließe das Terminal und öffne ein neues: Nur ein neues Fenster liest PATH erneut ein. Überprüfe es anschließend. claude doctor ist auch später nützlich, weil es Installation und Einstellungen prüft, ohne eine Sitzung zu öffnen, und sofort anzeigt, ob der Fehler bei der einen oder den anderen liegt.
claude --version # stampa la versione, ad esempio 2.1.284 (Claude Code)
claude doctor # diagnostica di installazione e impostazioni, senza aprire una sessioneDownload blockiert: 403 oder HTML-Seite statt des Skripts
Quando lo script non arriva, il terminale non lo dice in modo chiaro: bash si lamenta con syntax error near unexpected token '<' (sta cercando di eseguire una pagina web), oppure curl si ferma su curl: (22) The requested URL returned error: 403. La offizielle Seite zu Installationsproblemen (in inglese, letta il 3. Oktober 2026) distingue due casi. Se la pagina scaricata dice App unavailable in region, il server crede che ti colleghi da un paese escluso: dall'Italia capita quasi sempre per una VPN o un proxy che esce all'estero. Un 403 senza testo arriva più spesso da un proxy aziendale o da un firewall. Cambiare metodo di installazione non aiuta, perché Homebrew e WinGet scaricano dagli stessi server: prova da un'altra rete oppure chiedi all'IT di sbloccare quei domini.
Mit npm: Node.js 22, nicht 18
Se Node.js lo usi già tutti i giorni, npm sembra la scelta naturale. Funziona ed è tra i metodi documentati, con una condizione che molte guide in italiano non hanno aggiornato: ci vuole Node.js 22 o successivo. Con un Node più vecchio vedrai l'avviso EBADENGINE, però l'installazione arriva in fondo e claude parte lo stesso (offizielle Dokumentation, letta il 3. Oktober 2026). Le versioni aggiornate di Node sono su nodejs.org.
node -v # serve v22 o successiva
npm install -g @anthropic-ai/claude-code # senza sudo
# aggiornamento: @latest, non npm update -g
npm install -g @anthropic-ai/claude-code@latestDrei zu vermeidende Gewohnheiten:
sudovornpm install -g. Die Dokumentation rät davon ab – sowohl wegen ineinandergreifender Berechtigungen als auch aus Sicherheitsgründen.npm update -gzum Aktualisieren. Wiederhole stattdessen die Installation mit@latest, wie in der letzten Zeile oben.- Optionale Abhängigkeiten überspringen. Il binario di Claude Code arriva proprio come dipendenza facoltativa, un pacchetto
@anthropic-ai/claude-code-*per ogni piattaforma. Con--omit=optional, o conoptional=falsenel file.npmrc, non viene scaricato e su macOS o Linuxclauderispondeclaude native binary not installed(Installationsprobleme, in inglese, letta il 3. Oktober 2026).
Claude Code unter Windows: Wo es hakt
Su Windows Claude Code gira in modo nativo, e l'installazione in sé è la parte facile. I problemi nascono dall'ambiente. Il primo è il terminale: se incolli in PowerShell la riga per CMD, PowerShell protesta per il &&; se incolli in CMD la riga per PowerShell, CMD non sa cosa sia irm; e la riga curl … | bash del Mac in PowerShell non funziona proprio. Su un Windows in italiano alcuni di questi messaggi possono comparire tradotti. In ogni caso la soluzione è tornare alla tabella qui sopra e prendere la riga del terminale che hai davanti (i messaggi in inglese sono nella tabella degli errori in fondo; fonte: Dokumentation, letta il 3. Oktober 2026).
Achte auch auf das Startmenü: „Windows PowerShell (x86)“ öffnet einen 32-Bit-Prozess, und Claude Code beendet sich mit Claude Code does not support 32-bit Windows, selbst wenn der PC 64-Bit-fähig ist. Wähle den Eintrag ohne (x86).
Git for Windows non è obbligatorio. Se è installato, Claude Code esegue i comandi attraverso Git Bash; se manca, usa PowerShell. Quando Git c'è ma Claude Code non trova bash.exe, indicagli il percorso con CLAUDE_CODE_GIT_BASH_PATH nel blocco env di ~/.claude/settings.json, di solito C:\Program Files\Git\bin\bash.exe. E WSL? Serve solo in un caso preciso:
| Wo Claude Code ausgeführt wird | Voraussetzungen | Befehlssandbox | Sinnvoll, wenn … |
|---|---|---|---|
| Native Windows-Installation | Keine (Git for Windows optional) | Nein | das Projekt und seine Tools unter Windows liegen |
| WSL 2 | WSL 2 installiert | Ja | du mit Linux-Tools arbeitest oder Befehle isolieren möchtest |
| WSL 1 | WSL 1 installiert | Nein | WSL 2 auf deinem Rechner nicht verfügbar ist |
Mit WSL geschieht alles innerhalb von Linux: Die Zeile install.sh muss in der WSL-Shell ausgeführt werden, und von dort startest du claude.
„claude“ wurde nicht gefunden
Wenn das Terminal nach der Installation command not found: claude oder 'claude' is not recognized meldet, ist das Programm vorhanden, aber sein Ordner befindet sich nicht in PATH. Das native Installationsprogramm kopiert es unter macOS und Linux nach ~/.local/bin/claude und unter Windows nach %USERPROFILE%\.local\bin\claude.exe. Erster Versuch: ein neues Terminal. Wenn das unter Windows nicht genügt, sind dies die PowerShell-Befehle aus der Dokumentation, um den Ordner in PATH des Benutzers zu prüfen und hinzuzufügen:
# 1. Controlla se la cartella di installazione è già nel PATH
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Nessun risultato? Aggiungila al PATH utente, poi chiudi e riapri il terminale
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Nel nuovo terminale
claude --versionnpm.ps1 cannot be loaded in PowerShell
Betrifft nur Installationen mit npm: Die PowerShell-Ausführungsrichtlinien blockieren das von npm erstellte .ps1-Skript, und die vollständige Meldung enthält running scripts is disabled on this system. Die Dokumentation nennt drei Auswege: Dem aktuellen Benutzer mit dem folgenden Befehl die Ausführung lokaler Skripte erlauben, npm.cmd und claude.cmd anstelle der PowerShell-Skripte ausführen oder npm aufgeben und das native Installationsprogramm verwenden.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserOhne Abonnement: Claude-Konto oder API-Schlüssel
Installato non vuol dire pronto: al primo avvio Claude Code chiede di autenticarsi, e il piano gratuito di Claude.ai non basta (Dokumentation, letta il 3. Oktober 2026). Le due strade a confronto:
| Claude-Abonnement | Kunavo-API-Schlüssel | |
|---|---|---|
| Voraussetzung | Pro-, Max-, Team- oder Enterprise-Tarif oder ein Console-Konto sowie Login | Ein Schlüssel sk-kn-… in einer Umgebungsvariable, kein Login |
| Kosten | Pro $20 al mese, oppure $17 al mese con il pagamento annuale ($200 in anticipo); Max da $100 al mese; tasse escluse (Claude-Preise, letti il 3. Oktober 2026) | Nach Verbrauch, pro Token, aus einem vorausbezahlten Guthaben: Aufladung ab $10, keine Grundgebühr, kein Ablaufdatum |
| Zahlbar mit | Sul web solo carta di credito o di debito (Anthropic-Support); PayPal non è accettato (Anthropic-Support), entrambi letti il 3. Oktober 2026 | Satispay im Euro-Checkout, Visa- und Mastercard-Karten, Apple Pay, Google Pay, Link |
| Was fehlt | — | Remote Control und Spracheingabe; keine Rechnungen |
Esiste anche la chiave della Console di Anthropic, sempre a consumo. Lì però i crediti prepagati scadono dopo un anno e non si rimborsano (Anthropic-Support, letto il 3. Oktober 2026); si paga con carta, mentre il bonifico ACH è riservato agli account API con fatturazione mensile (Anthropic-Support). Il credito Kunavo non ha scadenza.
API-Schlüssel konfigurieren: sechs Variablen
Che Claude Code parli con un endpoint diverso da quello di Anthropic è previsto: la documentazione ufficiale ha una pagina, tradotta anche in italiano, su come mit einem LLM-Gateway verbinden. Nessun plugin, nessuna versione modificata. Bastano queste variabili:
| Variable | Wert | Wofür sie dient |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | Adresse des Dienstes. Nur die Domain: Claude Code fügt /v1/messages hinzu, und mit /v1 am Ende würde die Anfrage bei /v1/v1/messages landen, also mit 404 fehlschlagen. |
ANTHROPIC_AUTH_TOKEN | dein Schlüssel sk-kn-… | Wird als Authorization: Bearer übertragen und ist sofort ohne Bestätigung gültig. |
ANTHROPIC_MODEL | claude-sonnet-5 | Hauptmodell, hier Claude Sonnet 5. Der Name muss genau wie in der Kunavo-Liste geschrieben werden: Ältere Versionen mit dem Datum am Ende werden nicht erkannt. |
ANTHROPIC_DEFAULT_OPUS_MODEL | claude-opus-5-5 | Das Modell hinter dem Alias opus und hinter opusplan im Plan Mode, hier Claude Opus 5.5. Es erfordert Claude Code 2.1.280 oder höher: Starte bei einer älteren Version claude update. |
ANTHROPIC_DEFAULT_SONNET_MODEL | claude-sonnet-5 | Das Modell hinter dem Alias sonnet, hinter opusplan außerhalb des Plan Mode und hinter Subagents mit model: sonnet. Ohne diese Zeile fordert der Alias Sonnet 5.5 an, das Kunavo nicht anbietet. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 | Das Modell hinter dem Alias haiku und hinter den Funktionen, die Claude Code selbstständig im Hintergrund ausführt. |
Füge sie unter macOS und Linux am Ende von ~/.zshrc oder ~/.bashrc hinzu:
export ANTHROPIC_BASE_URL=https://api.kunavo.com # solo il dominio, senza /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 für einen schnellen Test, der so lange wie das PowerShell-Fenster gilt:
# Vale solo in questa finestra di PowerShell: chiusa la finestra, sparisce
$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"
claudeDamit du sie nicht jedes Mal neu festlegen musst, gehört der richtige Eintrag in den Block env von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json): Er gilt für alle deine Projekte. Wenn die Datei bereits weitere Einstellungen enthält, füge nur 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"
}
}AUTH_TOKEN oder API_KEY?
Kunavo legge la chiave da tutti e due gli header, Authorization: Bearer e x-api-key, quindi in teoria vanno bene entrambe le variabili. La differenza la fa Claude Code. Con ANTHROPIC_API_KEY, inviata come x-api-key, la sessione interattiva ti chiede una volta se approvare la chiave; se rispondi no, la ignora senza dire nulla finché non la riattivi da /config → Benutzerdefinierten API-Schlüssel verwenden. ANTHROPIC_AUTH_TOKEN non chiede niente, ed è anche la variabile che la Gateway-Dokumentation (letta il 3. Oktober 2026) suggerisce quando non sai quale scegliere.
Warum die Modelle festlegen
Senza variabili Claude Code ragiona per alias, e gli alias seguono le uscite di Anthropic. Oggi, secondo la Dokumentation zur Modellkonfiguration (letta il 3. Oktober 2026), per chi usa l'API opus corrisponde a Opus 5.5 e sonnet a Sonnet 5.5. Kunavo, al 3. Oktober 2026, non offre Sonnet 5.5: senza ANTHROPIC_DEFAULT_SONNET_MODEL, /model sonnet, la fase esecutiva di opusplan e i subagent con model: sonnet chiederebbero un modello che su Kunavo non c'è e tornerebbero 404. Con claude-sonnet-5 in quella variabile l'alias punta a Claude Sonnet 5, lo stesso modello di ANTHROPIC_MODEL. Quest'ultima decide invece il modello della sessione: senza, Claude Code partirebbe dal suo predefinito, oggi Opus 5.5. Opus 5.5 è disponibile, e fissare opus su claude-opus-5-5 serve a un'altra cosa: evitare che modello e tariffa cambino da un giorno all'altro quando l'alias passerà a un Opus successivo. Claude Opus 5.5 richiede Claude Code 2.1.280 o successivo; con una versione più vecchia, lancia prima claude update.
Die Kunavo-Tarife der drei Modelle in der Konfiguration pro Million Token (Input / Output): Claude Sonnet 5 $1,40 / $7,00 (Anthropic-Listenpreis: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; Claude Haiku 4.5 $0,70 / $3,50, das auch im Hintergrund arbeitet.
Wo der Schlüssel nicht hingehört und welche Einstellung Vorrang hat
Il .claude/settings.json dentro il progetto viene committato: una chiave scritta lì finisce nel repository e arriva a chiunque lo cloni (Gateway-Dokumentation). Se una variabile compare sia nella shell sia nel blocco env di un file di impostazioni, prevale il file: quando una modifica a ~/.zshrc sembra ignorata, il motivo è quasi sempre lì. Il campo model del file di impostazioni, invece, cede il passo ad ANTHROPIC_MODEL. Nell'estensione di Claude Code per VS Code le stesse variabili vanno in claudeCode.environmentVariables, nelle impostazioni utente di VS Code. L'app desktop di Claude resta fuori da tutto questo: non legge né ANTHROPIC_BASE_URL né settings.json (Gateway-Dokumentation, letta il 3. Oktober 2026).
Erster Start und Prüfung mit /status
Se la chiave è al suo posto, claude parte ohne Anmeldebildschirm: restano solo la configurazione iniziale e la domanda se ti fidi della cartella. Se invece compare il login, Claude Code non ha trovato la chiave. Il caso tipico è la chiave scritta solo nel .claude/settings.json o nel .claude/settings.local.json del progetto: in modalità interattiva quel blocco env entra in gioco solo dopo la configurazione iniziale e la conferma di fiducia (Gateway-Dokumentation, letta il 3. Oktober 2026), quindi al primo avvio non c'è ancora. Spostala nella shell o nel file utente. Un vecchio login Pro o Max non dà fastidio, perché la variabile ha la precedenza sull'accesso salvato; se vuoi cancellarlo, c'è /logout.
Gib innerhalb der Sitzung /status ein. Die beiden wichtigen Zeilen sind:
Anthropic base URL, das nur angezeigt wird, wenn ein Gateway eingerichtet ist: Es musshttps://api.kunavo.comlauten. Fehlt es, istANTHROPIC_BASE_URLnicht in der Sitzung angekommen.Auth tokenmit dem NamenANTHROPIC_AUTH_TOKEN: Du verwendest den Schlüssel. Wenn stattdessenLogin methodmit einem claude.ai-Konto angezeigt wird, wurde die Variable ignoriert.
Möchtest du noch vor dem Öffnen von Claude Code prüfen? Die Dokumentation schlägt eine minimale Anfrage mit 1 Output-Token vor, die nur einen vernachlässigbaren Betrag vom Guthaben abzieht. Der Befehl liest die Variablen der aktuellen Shell: Wenn der Schlüssel nur in settings.json steht, exportiere ihn vorher in diesem Terminal. Wenn ein JSON zurückkommt, das mit {"id":"msg_ beginnt, ist alles in Ordnung; 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 derselbe Test so aus, und die erfolgreiche Antwort enthält ein 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 du mit dem API-Schlüssel verlierst
- Remote Control und Spracheingabe. Sie erfordern eine claude.ai-Identität und funktionieren nicht mit
ANTHROPIC_AUTH_TOKENoderANTHROPIC_API_KEY; ab Version 2.1.196 wird Remote Control auch deaktiviert, wennANTHROPIC_BASE_URLauf einen Host zeigt, der nicht zu Anthropic gehört. - Der Modus
/fast. Mit ausschließlich dem Bearer-Token betrachtet Claude Code ihn als deaktiviert und versucht nicht einmal, ihn anzufordern. - Die Suche nach MCP-Tools beim Start. Con un
ANTHROPIC_BASE_URLpersonalizzato parte spenta (MCP-Dokumentation, in inglese, letta il 3. Oktober 2026). Si riaccende conENABLE_TOOL_SEARCH=truese il gateway inoltra i blocchitool_reference; con Kunavo non l'abbiamo provato. - Die Genauigkeit von
/context. Kunavo non espone/v1/messages/count_tokens, un endpoint facoltativo secondo la Gateway-Spezifikation (letta il 3. Oktober 2026); senza, Claude Code stima i token a partire dai caratteri.
Mehr dazu auf Englisch: die Dokumentation zur Integration mit Claude Code, die Seite zu Sonderfällen von ANTHROPIC_BASE_URL und die Anleitung Install Claude Code.
Mit Satispay bezahlen, ohne Kreditkarte
Prima una precisazione, perché è la domanda più frequente: Satispay non paga l'abbonamento Claude. Per Pro e Max comprati sul web Anthropic accetta solo carte di credito o di debito (Anthropic-Support) e non accetta PayPal (Anthropic-Support), entrambi letti il 3. Oktober 2026. Su Kunavo Satispay ricarica invece il credito API che Claude Code consuma con la chiave configurata sopra. Tutti i dettagli, compresi i costi per caricare la Disponibilità, sono nella guida Claude mit Satispay bezahlen. Per Claude Code la sequenza è questa:
- Registriere dich bei Kunavo mit deiner E-Mail-Adresse oder einem Google-Konto: Keine Karte erforderlich.
- Öffne Abrechnung und wähle den Aufladebetrag: mindestens $10, keine Grundgebühr. Oberhalb bestimmter Schwellen gibt es einen Bonus: $100 diventano $110, $1.000 diventano $1.200, $5.000 diventano $6.250 Guthaben.
- Nel checkout di Stripe, che mostra l'importo in euro, scegli Satispay. Si passa alla pagina di Satispay (Stripe-Dokumentation): numero di cellulare o QR code dall'app, poi conferma con Senden (Satispay-Support, letto il 3. Oktober 2026). Meglio avere già abbastanza Disponibilità prima di cominciare.
- Das Guthaben erscheint unter Abrechnung, sobald Stripe die Zahlung bestätigt. Wenn es nicht sofort angezeigt wird, aktualisiere die Seite, statt erneut zu bezahlen: Eine zweite Zahlung wird zum Guthaben addiert und ersetzt die erste nicht.
- Erzeuge unter API-Schlüssel den Schlüssel
sk-kn-…und kopiere ihn sofort nachANTHROPIC_AUTH_TOKEN: Er wird nur einmal angezeigt.
| Methode | Im Kunavo-Checkout in Euro |
|---|---|
| Satispay | Angeboten (siehe Hinweis unten) |
| Visa- und Mastercard-Karten | Ja, auch Debit- und Prepaidkarten, sofern sie für Onlinekäufe freigeschaltet sind |
| Apple Pay, Google Pay | Ja, auf kompatiblen Geräten |
| Link | Ja |
| Pay by Bank | No, non dall'Italia: Stripe lo offre solo a chi paga dal Regno Unito (in sterline), dall'Irlanda e dalla Finlandia; in Francia e Germania è in anteprima privata (Stripe, Pay by Bank, letto il 3. Oktober 2026) |
| PayPal, SEPA-Lastschrift | Nein |
| Klarna | Nein, auch nicht in Dollar: Stripe bietet es nur Personen an, die aus den Vereinigten Staaten bezahlen |
Kunavo fissa i prezzi in dollari e Stripe li converte in euro con una Wechselkursgebühr von 2–4 % a carico di chi paga (Stripe, Adaptive Pricing, letto il 3. Oktober 2026): sulla ricarica minima da $10 sono tra $0,20 e $0,40. In dollari la commissione sparisce, ma sparisce anche Satispay, che esiste solo nel checkout in euro; se il checkout ti appare in dollari, spesso c'entra una VPN. L'importo esatto in euro è quello che leggi nel checkout prima di confermare.
Con Satispay le ricariche si fanno a mano: la ricarica automatica di Kunavo addebita solo una carta salvata o Link. Chi ha la carta Satispay, una Mastercard di debito per i piani Plus, Metal e Velvet (Satispay-Support, letto il 3. Oktober 2026), può salvarla e usarla come qualsiasi carta. Il credito non scade e le richieste fallite non vengono addebitate. Kunavo non emette fatture, né con IVA né elettroniche via SDI; lo storico delle ricariche resta in Abrechnung.
Eine ehrliche Anmerkung: Satispay ist seit dem 3. Oktober 2026 im Kunavo-Checkout verfügbar, und Stripe bietet es bei Zahlungen in Euro an, aber bisher ist noch keine Aufladung darüber erfolgt. Wenn du es nicht findest, erfüllen Karte, Apple Pay, Google Pay und Link denselben Zweck.
Was eine Arbeitssitzung kostet
Mit dem API-Schlüssel entstehen die Kosten durch Token, und Claude Code sendet viele davon: Bei jedem Schritt wird der gesamte Kontext erneut übertragen. Der unveränderte Teil kann jedoch aus dem Cache zu einem deutlich niedrigeren Tarif gelesen werden. Hier ist ein bewusst konstruiertes Beispiel mit offengelegten Annahmen: Es ist keine Messung und keine Ausgabenobergrenze.
- 40.000 Input-Token pro Anfrage, davon 36.000 (90 %) aus dem Cache gelesen und 4.000 in den Cache geschrieben;
- 1.000 Output-Token pro Anfrage;
- 50 Anfragen in einer Sitzung, ohne Hintergrundaufrufe an Claude Haiku 4.5;
- Lesen aus dem Cache zum 10% des Input-Tarifs und Schreiben zum 1,25-Fachen des Input-Tarifs: Dies sind die Kunavo-Verhältnisse für Claude Sonnet 5, und jede Tabellenzeile verwendet die Werte ihres jeweiligen Modells.
| Modell | Eine Anfrage | 50 Anfragen | 50 Anfragen ohne Cache |
|---|---|---|---|
| Claude Sonnet 5 | $0,019 | $0,95 | $3,15 |
| Claude Opus 5.5 | $0,033 | $1,65 | $6,30 |
Lange Kontexte, wenige Cache-Lesevorgänge und ausführliche Antworten erhöhen die Rechnung; ein /clear zwischen den Aufgaben senkt sie. Ob sich das Abonnement oder die API mehr lohnt, findest du unter Was Claude Code kostet; die Tarife aller Claude-Modelle stehen unter Claude-API-Preise und auf der Preisseite. Um die Rechnung mit deinen eigenen Zahlen zu wiederholen, gibt es den Claude-Tokenkostenrechner (auf Englisch).
Fehler: Meldung, Ursache, Lösung
| Was du siehst | Was es bedeutet und was zu tun ist |
|---|---|
The token '&&' is not a valid statement separator | Die CMD-Zeile wurde in PowerShell ausgeführt. Verwende irm … | iex. |
'irm' is not recognized as an internal or external command | Die PowerShell-Zeile wurde in CMD ausgeführt. Verwende die mit install.cmd. |
A parameter cannot be found that matches parameter name 'fsSL', 'bash' is not recognized as the name of a cmdlet | Du hast unter Windows den Befehl für macOS und Linux eingefügt. Nimm die PowerShell-Zeile. |
syntax error near unexpected token '<', 403, App unavailable in region | Statt des Skripts ist eine HTML-Seite oder ein Fehler eingetroffen. Deaktiviere VPN oder Proxy oder probiere ein anderes Netzwerk: Homebrew und WinGet verwenden dieselben Server. |
command not found: claude, 'claude' is not recognized | Der Programmordner befindet sich nicht in PATH. Neues Terminal; unter Windows die PowerShell-Befehle aus dem Abschnitt zu PATH. |
Warnung EBADENGINE | Node.js ist älter als Version 22. Die Installation ist erfolgreich, aber aktualisiere Node.js sobald möglich. |
claude native binary not installed (macOS, Linux) | npm hat optionale Abhängigkeiten (--omit=optional, optional=false) oder Installationsskripte (--ignore-scripts) übersprungen. Entferne die Option und installiere erneut. |
npm.ps1 cannot be loaded | Die PowerShell-Ausführungsrichtlinie blockiert das npm-Skript. Set-ExecutionPolicy für den aktuellen Benutzer oder das native Installationsprogramm verwenden. |
Claude Code does not support 32-bit Windows | Du befindest dich in „Windows PowerShell (x86)“. Öffne den Eintrag ohne (x86). |
| Der Login erscheint, obwohl du den Schlüssel eingerichtet hast | Der Schlüssel wurde nicht gelesen. Hinterlege ihn in der Shell oder in ~/.claude/settings.json, nicht nur in den Projekteinstellungen, und öffne das Terminal erneut. |
401 | Schlüssel abgelehnt. Überprüfe, dass sk-kn-… vollständig und ohne Leerzeichen kopiert wurde, noch unter /app/keys aktiv ist und sich in ANTHROPIC_AUTH_TOKEN befindet. |
404 | ANTHROPIC_BASE_URL endet mit /v1, oder das angeforderte Modell gehört nicht zu den von Kunavo angebotenen Modellen – typischerweise, weil die Variablen zur Festlegung der Modelle fehlen. |
| Satispay ist im Checkout nicht verfügbar | Der Checkout ist in Dollar, häufig wegen eines VPNs oder Proxys im Ausland. Deaktiviere diese und öffne den Checkout erneut über Abrechnung. |
Was diese Konfiguration nicht tut
- Sie aktiviert kein Claude-Pro- oder Max-Abonnement: Das Kunavo-Guthaben bezahlt die API und Claude Code mit Schlüssel, nicht claude.ai oder die Claude-App.
- Sie erstellt keine Rechnungen: weder mit Mehrwertsteuer noch elektronisch über SDI.
- Sie lädt nicht automatisch mit Satispay auf: Die automatische Aufladung erfordert eine gespeicherte Karte oder Link.
- Sie funktioniert ohne die Modellvariablen nicht, solange Kunavo Sonnet 5.5 nicht anbietet (Stand 3. Oktober 2026): Der Alias
sonnetwürde einen 404-Fehler liefern, ebenso/model sonnet, die Ausführungsphase vonopusplanund Subagents mitmodel: sonnet. - Es gibt keine Kunavo-Dokumentation auf Italienisch: Die Integrationsanleitung und die Seite zu Guthaben und Zahlungen sind auf Englisch, während Anthropics Anleitung zu Claude Code übersetzt ist.
Für den allgemeinen Überblick für Personen, die in Italien mit Claude entwickeln, gibt es die Anleitung zur Claude-API in Italien. So beginnst du: Erstelle ein Konto, lade $10 mit Satispay auf, setze die sechs Variablen und prüfe mit /status.
Häufig gestellte Fragen
Wie installiert man Claude Code unter Windows, Mac und Linux?
Mit einem einzigen Befehl, der vom Terminal abhängt. Unter macOS, Linux und in WSL: curl -fsSL https://claude.ai/install.sh | bash. In Windows PowerShell: irm https://claude.ai/install.ps1 | iex. In der Eingabeaufforderung (CMD): curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Dies ist der native Installer und die von der Anthropic-Dokumentation empfohlene Methode; er aktualisiert sich automatisch. Öffne anschließend ein neues Terminal und gib claude --version ein. Homebrew und WinGet funktionieren ebenfalls, aber für die Aktualisierungen bist du selbst verantwortlich.
Benötigt man für die Installation von Claude Code unter Windows WSL oder Administratorrechte?
Keines von beidem. Claude Code läuft ab Windows 10 1809 nativ, und laut offizieller Dokumentation ist kein Administrator-Terminal erforderlich. WSL 2 ist nur sinnvoll, wenn du mit Linux-Tools arbeitest oder die Befehls-Sandbox nutzen möchtest, die unter nativem Windows und WSL 1 fehlt. Git for Windows ist optional: Wenn es vorhanden ist, verwendet Claude Code Git Bash, andernfalls PowerShell. Vermeide „Windows PowerShell (x86)“: Es ist 32-Bit, und Claude Code startet nicht.
Claude Code mit npm: Benötigt man Node 18 oder Node 22?
Node.js 22 oder neuer (offizielle Installationsdokumentation, gelesen am 3. Oktober 2026); die in einigen Anleitungen genannte Version 18 ist eine veraltete Anforderung. Mit einer älteren Node-Version erscheint die Warnung EBADENGINE, die Installation wird jedoch abgeschlossen und claude funktioniert. Befehl: npm install -g @anthropic-ai/claude-code, ohne sudo; zum Aktualisieren die Installation mit @latest wiederholen, statt npm update -g zu verwenden. Wenn du den nativen Installer verwendest, brauchst du Node.js überhaupt nicht.
Ist Claude Code kostenlos? Kann man es ohne Abonnement verwenden?
Kostenlos nicht: Der kostenlose Claude.ai-Plan umfasst Claude Code nicht, und die Anmeldung erfordert Pro, Max, Team, Enterprise oder ein Console-Konto. Ohne Abonnement kannst du es jedoch mit einem API-Schlüssel verwenden: Setze ANTHROPIC_BASE_URL=https://api.kunavo.com und ANTHROPIC_AUTH_TOKEN. Claude Code überspringt die Anmeldung, und die Token werden von einem vorausbezahlten Kunavo-Guthaben abgezogen. Keine monatliche Gebühr, Mindestaufladung $10. Du verzichtest auf Remote Control und Spracheingabe, die ein claude.ai-Konto erfordern.
Wo gibt man den API-Schlüssel in Claude Code ein?
In einer Umgebungsvariable, nicht in einem Menü. Am bequemsten ist der env-Block von ~/.claude/settings.json (unter Windows %USERPROFILE%\.claude\settings.json), der für alle Projekte gilt; alternativ ~/.zshrc, ~/.bashrc oder das PowerShell-Profil. Verwende ANTHROPIC_AUTH_TOKEN: Kunavo akzeptiert auch ANTHROPIC_API_KEY, aber mit diesem Schlüssel fordert Claude Code eine Genehmigung an und ignoriert ihn, wenn du sie ablehnst, bis du ihn unter /config wieder aktivierst. Schreibe ihn niemals in die .claude/settings.json des Projekts, da diese im Repository landet.
Wie kann ich feststellen, ob Claude Code den API-Schlüssel und nicht mein Konto verwendet?
Öffne eine Sitzung und gib /status ein. Es müssen die Zeile „Anthropic base URL“ mit https://api.kunavo.com und die Zeile „Auth token“ mit ANTHROPIC_AUTH_TOKEN erscheinen. Wenn du „Login method“ mit einem claude.ai-Konto siehst, ist die Variable nicht in der Sitzung angekommen: Schließe das Terminal, öffne ein neues und überprüfe, wo du sie eingetragen hast. Ein früherer Pro- oder Max-Login stört nicht, weil die Variable Vorrang hat; wenn du ihn entfernen möchtest, verwende /logout.
Warum gibt Claude Code mit ANTHROPIC_BASE_URL einen 404-Fehler zurück?
Normalerweise gibt es dafür zwei Gründe. Der erste ist die Adresse mit /v1 am Ende: Claude Code fügt bereits /v1/messages hinzu, sodass die Anfrage bei /v1/v1/messages landet. Schreibe nur https://api.kunavo.com. Der zweite ist das Modell: Ohne Variablen verwendet Claude Code Aliase, und für API-Nutzer verweist der Alias sonnet heute auf Sonnet 5.5 (Modelldokumentation, abgerufen am 3. Oktober 2026), das Kunavo nicht anbietet: /model sonnet, die Ausführungsphase von opusplan und Subagents mit model: sonnet würden mit 404 fehlschlagen. 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 geht jede Anfrage an ein verfügbares Modell zu einem dir bekannten Preis. Opus 5.5 erfordert Claude Code 2.1.280 oder höher: Starte bei einer älteren Version claude update.
Kann man Claude Code mit Satispay bezahlen? Und mit PayPal?
Satispay ja, aber für API-Guthaben, nicht für das Abonnement. Bei Kunavo erscheint Satispay im Stripe-Checkout in Euro und lädt das Guthaben auf, von dem Claude Code die Token abbucht; mindestens $10, mit einer Wechselkursgebühr von 2–4 %, die die zahlende Person trägt. Aufladungen mit Satispay erfolgen manuell: Die automatische Aufladung von Kunavo funktioniert nur mit einer gespeicherten Karte (auch die Satispay-Karte, eine Mastercard-Debitkarte der Plus-, Metal- und Velvet-Tarife, ist möglich) oder mit Link. PayPal nein, weder bei Kunavo noch bei Anthropic, das für Pro und Max im Web nur Kredit- oder Debitkarten akzeptiert. Kunavo stellt keine Rechnungen aus, weder mit Mehrwertsteuer noch elektronisch über SDI.