Installare Claude Code: comandi per Windows, macOS e Linux, chiave API senza abbonamento e pagamento senza PayPal

In breve: installi Claude Code con una sola riga nel terminale, senza Node.js e senza privilegi di amministratore. La riga dipende solo dalla finestra: curl -fsSL https://claude.ai/install.sh | bash su macOS, Linux e WSL, irm https://claude.ai/install.ps1 | iex in Windows PowerShell, la terza riga sotto nel prompt dei comandi (CMD). Se non hai un abbonamento Claude, collega poi Claude Code a Kunavo tramite chiave API: ANTHROPIC_BASE_URL=https://api.kunavo.com (senza /v1), ANTHROPIC_AUTH_TOKEN e quattro variabili del modello. Verifica che funzioni con /status. Paghi per token tramite un saldo a partire da $10, ricaricabile con carta di debito o di credito (anche Visa Debit e Debit Mastercard), Apple Pay, Google Pay, Link o, in Austria, EPS. PayPal e l’addebito diretto SEPA non sono supportati.

# 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 mantiene la documentazione di Claude Code interamente in tedesco, perciò questa guida rimanda alle pagine in tedesco. I comandi riportati sopra sono stati confrontati con Configurare Claude Code il 3 ottobre 2026, mentre le variabili sono state confrontate con l’elenco delle variabili d’ambiente. I prezzi e i metodi di pagamento di Kunavo sono aggiornati al 10 ottobre 2026. La Germania, l’Austria e la Svizzera figurano nell’elenco dei paesi di Anthropic sia per Claude.ai sia per l’API (aggiornato al 3 ottobre 2026). È disponibile una versione inglese all’indirizzo Install Claude Code.

Panoramica della procedura

1. Installazione: esegui la riga appropriata qui sopra, quindi apri una nuova finestra del terminale.
2. Verifica: claude --version restituisce un numero di versione.
3. Scelta: accedi con un abbonamento Claude oppure usa una chiave API (confronto più avanti).
4. Con una chiave API: ricarica il saldo, crea la chiave e imposta sei variabili d’ambiente.
5. Controllo: nella sessione inserisci /status.

Prerequisiti: cosa vale oggi

Alcune guide in tedesco descrivono una versione precedente di Claude Code. La tabella confronta le indicazioni più diffuse con quelle richieste dalla pagina ufficiale di configurazione al 3 ottobre 2026.

Installazione su macOS, Linux e WSL

Nel terminale, inserisci la riga con install.sh. Nella documentazione ufficiale questo metodo si trova nella scheda “Native Installation (Recommended)”. Lo script deposita l’eseguibile di avvio in ~/.local/bin/claude e, successivamente, l’installazione si aggiorna automaticamente in background. In WSL vale la stessa riga, eseguita nel terminale WSL.

Installare Claude Code su Windows

Su Windows, la riga che funziona dipende dalla finestra aperta; basta dare un’occhiata al prompt: PS C:\Users\Name> indica PowerShell, mentre C:\Users\Name> senza PS indica il prompt dei comandi (CMD). Secondo la pagina di configurazione, nessuna delle due opzioni richiede i privilegi di amministratore. Il programma di installazione salva claude.exe in %USERPROFILE%\.local\bin.

Se confondi le finestre, riceverai un messaggio in inglese o, su Windows in lingua tedesca, eventualmente in tedesco. La riga CMD in PowerShell termina con The token '&&' is not a valid statement separator, mentre la riga PowerShell in CMD termina con 'irm' is not recognized as an internal or external command. In entrambi i casi significa la stessa cosa: finestra sbagliata, quindi usa l’altra riga.

Nel menu Start, evitate la voce «Windows PowerShell (x86)». Secondo la pagina di risoluzione dei problemi, avvia un processo a 32 bit e il programma di installazione si interrompe con Claude Code does not support 32-bit Windows anche su un PC a 64 bit. Se in questa finestra [Environment]::Is64BitOperatingSystem restituisce True, Windows è a posto: basta aprire «Windows PowerShell», senza la dicitura aggiuntiva.

Non è necessario installare Git per Windows. Se è installato, Claude Code esegue i comandi della shell in Git Bash; altrimenti usa PowerShell. Se Claude Code non trova una Git Bash installata, inserite il percorso di bash.exe come CLAUDE_CODE_GIT_BASH_PATH nel blocco env di ~/.claude/settings.json; con un’installazione standard, il percorso è C:\Program Files\Git\bin\bash.exe.

La scelta tra installazione nativa e WSL dipende da dove si trovano i tuoi progetti:

Con WSL, installa e avvia claude nel terminale WSL, non in PowerShell o CMD.

Alternative: Homebrew, WinGet e npm

Se preferisci gestire il software tramite un gestore di pacchetti, puoi farlo, con una limitazione: secondo la documentazione, le installazioni tramite Homebrew e WinGet non si aggiornano automaticamente, quindi devi eseguire regolarmente upgrade. Homebrew offre due Cask. claude-code segue il canale stabile, che arriva con circa una settimana di ritardo e salta le versioni con regressioni importanti; claude-code@latest riceve subito ogni versione.

# 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

Tramite npm

npm rimane un metodo descritto ufficialmente. Il prerequisito è Node.js 22 o successivo. Il pacchetto npm scarica lo stesso binario nativo dell’installer e non necessita affatto di Node.js durante l’esecuzione. Per questo l’installazione con una versione precedente di Node.js non si interrompe: npm mostra solo l’avviso EBADENGINE. Se non hai ancora Node.js, l’installer nativo è la strada più breve.

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

Tre regole dalla pagina di configurazione: non usate sudo npm install -g, perché crea problemi di autorizzazioni e rischi per la sicurezza. Aggiornate con @latest, perché npm update -g rimane nell’intervallo di versioni originale. Inoltre, non disattivate le dipendenze facoltative: il binario viene installato come dipendenza facoltativa specifica della piattaforma; con --omit=optional o optional=false in .npmrc, non è presente, e claude restituisce Error: claude native binary not installed. su macOS e Linux.

Verificare l’installazione

A questo scopo, apri una nuova finestra del terminale. Una finestra già aperta prima dell’installazione non conosce ancora il PATH aggiornato e quindi non trova claude.

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

claude doctor è lo strumento da usare quando qualcosa non funziona. Non avvia una sessione, ma elenca lo stato dell’installazione, gli errori nei file di configurazione e gli avvisi con suggerimenti per la soluzione. In questo modo puoi capire se il problema riguarda l’installazione o la configurazione.

Quando l’installazione presenta problemi

Il download restituisce HTML o un 403

Se l’output inizia con syntax error near unexpected token '<' o curl restituisce un errore 403, secondo la pagina di risoluzione dei problemi (aggiornata al 3 ottobre 2026), al posto dello script è stata restituita una pagina web o uno stato di errore. Se la pagina riporta App unavailable in region, Anthropic considera la connessione proveniente da un paese non supportato. Se vi trovate in Germania, Austria o Svizzera, potrebbe trattarsi di un’uscita VPN o proxy all’estero. Un 403 senza testo può avere la stessa causa oppure dipendere dal firewall aziendale. La documentazione consiglia di verificare prima la connessione di rete, poiché gli altri metodi di installazione contattano gli stessi server. In questo caso, provare un’altra rete o chiedere al team IT di autorizzare l’accesso è più utile che usare un altro programma di installazione.

“claude” non viene trovato

command not found: claude su macOS e Linux, oppure un claude non riconosciuto su Windows, significa che la cartella di installazione non è presente nel PATH. Di solito basta aprire una nuova finestra. Se su macOS o Linux non basta, aggiungi ~/.local/bin a ~/.zshrc o ~/.bashrc. Su Windows controlla e aggiungi la cartella come indicato dalla procedura di risoluzione dei problemi:

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

Questo riguarda solo la variante npm. Il messaggio npm.ps1 cannot be loaded because running scripts is disabled on this system indica che la policy di esecuzione blocca lo script di avvio di npm. Puoi eseguire npm.cmd e claude.cmd, che non sono interessati dalla policy, passare all’installer nativo oppure consentire gli script locali per il tuo account:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Abbonamento o chiave API?

Al primo avvio, Claude Code chiede chi paga. Potete accedere con un account Claude oppure fornire una chiave API tramite una variabile d’ambiente. Se è impostata una chiave, secondo la guida al gateway ha la precedenza: l’accesso salvato resta inutilizzato e viene ripreso quando rimuovete la variabile. Non è necessario reinstallare per passare da un metodo all’altro.

Il Guide al prezzo di Claude Code mostra da quale livello Pro o Max diventa più conveniente rispetto alla chiave.

Configurare una chiave API (senza abbonamento)

Indirizzare Claude Code verso un endpoint diverso non è un trucco. ANTHROPIC_BASE_URL è presente nell’elenco delle variabili di Anthropic ed è pensata proprio per instradare le richieste tramite un proxy o un gateway. Non serve alcun plugin né una versione modificata di Claude Code.

1. Registrati su Kunavo tramite indirizzo e-mail o account Google.
2. In Billing, ricarica almeno $10 (metodi di pagamento nella sezione sui pagamenti).
3. In API-Keys, genera una chiave. Inizia con sk-kn- ed è visibile una sola volta, quindi copiala immediatamente.
4. Imposta le variabili come mostrato sotto.

Se inseriti in ~/.zshrc o ~/.bashrc, i valori valgono per ogni nuovo terminale su macOS, Linux e 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, le assegnazioni $env: valgono solo per la finestra aperta, utile per una prima prova:

# 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

Per un uso continuativo, inserite i valori nel blocco env di ~/.claude/settings.json (su Windows, %USERPROFILE%\.claude\settings.json). Secondo la guida al gateway (aggiornata al 3 ottobre 2026), questo file vale per tutti i vostri progetti. Se esiste già, aggiungete solo il blocco env:

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

L’estensione VS Code legge le variabili da claudeCode.environmentVariables nelle impostazioni utente di VS Code (comando 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" }
  ]
}

Cosa fa ogni variabile

Perché impostare un modello iniziale fisso? Secondo la documentazione sulla configurazione dei modelli (aggiornata al 3 ottobre 2026), Opus 5.5 è il modello predefinito per gli utenti API e gli alias vengono aggiornati nel tempo per puntare a nuove versioni. Kunavo offre Opus 5.5; quindi, qui, avviare senza variabili del modello significa usare Opus 5.5, che costa il doppio per token rispetto a Claude Sonnet 5. Con nomi di modello fissi, sapete quale modello risponde e a quale tariffa. Il blocco per Opus mantiene l’alias opus su Claude Opus 5.5 (claude-opus-5-5), anche se in seguito Anthropic lo sposta a una versione più recente di Opus. Su Kunavo, Opus 5.5 costa per token meno di Claude Opus 5 ($2,80 / $14,00 rispetto a $3,50 / $17,50 per 1 milione di token di input/output) e richiede Claude Code dalla versione 2.1.280; un’installazione meno recente può essere aggiornata con claude update. Il blocco per Sonnet è necessario: per gli utenti API l’alias sonnet punta a Sonnet 5.5, che Kunavo non offre, e senza ANTHROPIC_DEFAULT_SONNET_MODEL /model sonnet, la fase di esecuzione di opusplan e i subagenti configurati con model: sonnet restituiscono un errore 404. Claude Haiku 4.5 mantiene bassi i costi delle attività in background, mentre con /model potete cambiare modello in qualsiasi momento durante la sessione.

Due cose sulla posizione. La chiave non va mai inserita nel .claude/settings.json di un progetto, perché secondo la guida al gateway questo file viene sottoposto a commit e finisce nelle mani di chiunque cloni il repository. Inoltre, se un export della shell e un blocco env impostano la stessa variabile, prevale il file di configurazione. Quindi, se modifichi una variabile nella shell e non succede nulla, probabilmente il vecchio valore è ancora presente in un settings.json.

I modelli a confronto, i prezzi Kunavo dal catalogo e i prezzi di listino di Anthropic secondo claude.com/de/pricing (aggiornato al 3 ottobre 2026), tutti per 1 milione di token:

Tutti i modelli e le tariffe Claude sono disponibili nella guida ai prezzi dell’API Claude e nella pagina dei prezzi.

Primo avvio: verifica con /status

Vai alla cartella del progetto e avvia claude. Con ANTHROPIC_AUTH_TOKEN impostato, si accede direttamente alla sessione, senza schermata di accesso. Se compare comunque, Claude Code non ha trovato una chiave. Secondo la guida del gateway, il motivo più comune è che la chiave sia presente solo nel file .claude/settings.json o .claude/settings.local.json del progetto. Claude Code legge questi blocchi env in una sessione interattiva solo dopo la procedura guidata di configurazione e la domanda se consideri attendibile la cartella. Perciò inserisci la chiave nella shell (export) oppure in ~/.claude/settings.json.

Nella sessione, /status mostra nella scheda Status da dove Claude Code ricava indirizzo e credenziali. Due righe sono essenziali:

Puoi testare la connessione anche senza Claude Code, utilizzando la richiesta della guida al gateway (qui il modello è impostato su claude-sonnet-5). Richiede esattamente un token di output e quindi costa solo una somma minima. I comandi leggono le variabili della shell; se i tuoi valori sono presenti solo in settings.json, esportali anche per il test.

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

Se viene restituito JSON che inizia con {"id":"msg_, oppure in PowerShell un oggetto con una id che inizia con msg_, indirizzo e chiave sono corretti. Un 401 indica che la chiave è stata rifiutata.

Cosa cambia con una chiave API

La maggior parte delle cose rimane invariata: modifica del codice, strumenti, subagent, server MCP, hook e prompt caching funzionano come prima. Devi conoscere quattro differenze:

• Remote Control e dettatura vocale non sono disponibili. Secondo la guida al gateway, entrambe richiedono un’identità claude.ai e sono bloccate finché ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY è attivo. Remote Control è inoltre bloccato dalla versione 2.1.196 quando ANTHROPIC_BASE_URL punta a un host esterno ad Anthropic.
• /fast segnala che la modalità Fast non è disponibile. Con un solo token Bearer, Claude Code la considera disattivata e non invia nemmeno il controllo di disponibilità.
• La ricerca degli strumenti MCP è disattivata. Secondo la documentazione MCP (aggiornata al 3 ottobre 2026), Claude Code la disattiva quando ANTHROPIC_BASE_URL punta a un servizio di terze parti; con ENABLE_TOOL_SEARCH è possibile riattivarla esplicitamente.
• /context mostra valori stimati. Kunavo non offre /v1/messages/count_tokens. Senza questo endpoint, secondo la guida alla compatibilità del gateway (aggiornata al 3 ottobre 2026), Claude Code conta i caratteri.

Maggiori informazioni sull’integrazione sono disponibili nella guida all’integrazione di Claude Code (in inglese).

Pagare senza PayPal e SEPA

Una precisazione: Kunavo non vende abbonamenti Claude, ma credito per accedere alle API, da cui Claude Code detrae ogni token. Per i piani Pro e Max di Anthropic: sul web si può pagare solo con carta di credito o debito; nelle app l'addebito viene effettuato tramite App Store o Google Play (FAQ sulla fatturazione). Secondo l'articolo di assistenza sulle carte rifiutate, Anthropic non accetta PayPal né Venmo (entrambe le informazioni aggiornate al 3 ottobre 2026).

Kunavo consente di ricaricare il saldo tramite il checkout Stripe. I prezzi sono in dollari statunitensi; chi paga dalla Germania o dall'Austria vede l'importo in euro. Secondo la documentazione Stripe sui prezzi adattivi (aggiornata al 3 ottobre 2026), il tasso di conversione include una commissione del 2–4%, a carico dell'acquirente. Selezionando i dollari statunitensi nel checkout, la commissione non si applica; in tal caso, la banca effettua la conversione al proprio tasso e può addebitare commissioni proprie. Il checkout offre:

Secondo Stripe, EPS è un metodo di pagamento austriaco supportato da tutte le banche austriache. Verrai reindirizzato alla pagina della tua banca, dove potrai confermare il pagamento; funziona solo pagando in euro. Chi paga dalla Svizzera può usare una carta, Apple Pay, Google Pay o Link.

girocard: Una carta che supporta solo girocard (in precedenza EC-Karte) non viene accettata nel checkout Kunavo, perché Stripe non include girocard tra i circuiti di carte supportati (aggiornato al 3 ottobre 2026). Se sulla carta è presente anche il logo Visa o Mastercard, il pagamento viene elaborato tramite quel circuito, anche con Apple Pay e Google Pay.

Non disponibile: PayPal, addebito diretto SEPA, bonifico manuale (pagamento anticipato), giropay e Sofort. Klarna è offerto dal checkout solo agli acquirenti negli Stati Uniti; chi passa ai dollari statunitensi da fuori dagli Stati Uniti non vede comunque Klarna.

1. Crea un account; durante la registrazione Kunavo non richiede alcuna carta.
2. In Billing, scegli un livello di ricarica a partire da $10. I livelli più elevati offrono credito bonus: $100 diventano $110, $1.000 diventano $1.200 e $5.000 diventano $6.250.
3. Nel checkout di Stripe, scegli il metodo di pagamento. L’importo in euro viene mostrato prima della conferma; con EPS confermi nell’online banking.
4. In API-Keys, crea una chiave e impostala come ANTHROPIC_AUTH_TOKEN.

Il saldo è prepagato: nessun canone mensile, nessuna scadenza e le richieste non riuscite non vengono addebitate. Il ricaricamento automatico è possibile solo con una carta o Link salvati; con Apple Pay, Google Pay ed EPS ricarichi manualmente. Kunavo non emette fatture con IVA esposta; le tue ricariche sono visibili in Billing. Maggiori informazioni sui metodi di pagamento e sulle carte rifiutate: Pagare Claude senza carta di credito.

Quanto costa una sessione: esempio di calcolo

Con una chiave API paghi i token e Claude Code invia a ogni passaggio l’intero contesto precedente. Tuttavia, questo contesto non viene pagato per intero ogni volta: il modello legge dal cache la parte iniziale invariata, a una tariffa di lettura del cache più bassa. La tabella calcola un modello ipotetico; non è né una misurazione né un limite massimo. Ipotesi:

• 40.000 token di input per richiesta, di cui 36.000 (90%) letti dal cache e 4.000 scritti nuovamente nel cache;
• 1.000 token di output per richiesta;
• 50 richieste di questo tipo per sessione di lavoro, senza contare le chiamate in background;
• La lettura del cache costa, per Claude Sonnet 5, 10 % della tariffa di input, mentre la scrittura nel cache costa 1,25 volte tanto; ogni modello nella tabella è calcolato con i propri fattori.

Il costo effettivo dipende dalla lunghezza del contesto, dai riscontri del cache e dalla lunghezza della risposta, nonché dal fatto che tu ricominci da capo con /clear tra due attività. Per i tuoi numeri puoi usare il calcolatore dei costi dei token Claude (in inglese); il confronto con Pro e Max è calcolato nella guida al prezzo di Claude Code.

Messaggi di errore e relativo significato

Limiti di questo metodo

• Paghi per token, non una somma forfettaria. Chi usa Claude Code per molte ore ogni giorno spesso risparmia con Pro o Max. Con un utilizzo variabile paghi solo ciò che consumi, e un mese senza utilizzo non costa nulla.
• Senza un account claude.ai non sono disponibili Remote Control e la dettatura vocale; /fast è considerato disattivato e la ricerca degli strumenti per MCP è disattivata per impostazione predefinita.
• Sonnet 5.5 attualmente non è disponibile su Kunavo; per questo /model sonnet, opusplan e i subagent Sonnet richiedono il pin Sonnet riportato negli esempi sopra.
• Apple Pay, Google Pay ed EPS servono solo per le ricariche manuali; automaticamente è possibile ricaricare solo con una carta o Link. Gli importi in euro includono la commissione di conversione di Stripe.
• Kunavo non emette fatture con IVA esposta.
• La documentazione di Claude Code di Anthropic è disponibile in tedesco, mentre la guida all’integrazione di Kunavo è disponibile solo in inglese.

Domande frequenti