Installazione di Claude Code: procedura dettagliata per Windows, macOS e Linux, chiave API senza abbonamento e pagamento con carta

In breve: Claude Code si installa con una singola riga adatta al tuo terminale. Su macOS, Linux e WSL esegui install.sh, in Windows PowerShell irm … | iex e nel Prompt dei comandi (CMD) install.cmd; tutte e tre sono riportate qui sotto. Questo metodo non richiede Node.js; se vuoi installarlo con npm, è necessario Node.js 22 o superiore. Dopo l'installazione hai due opzioni: accedere con un account Claude (Pro, Max, Team, Enterprise o Console; il piano gratuito non include Claude Code) oppure usare una chiave API senza acquistare un abbonamento. Con il metodo della chiave, definisci ANTHROPIC_BASE_URL=https://api.kunavo.com (senza aggiungere /v1 alla fine), ANTHROPIC_AUTH_TOKEN e le quattro variabili che fissano i modelli; nella sessione /status mostra se la chiave è attiva. Vengono addebitati solo i token consumati. Puoi ricaricare il saldo con una carta Visa o Mastercard, Apple Pay, Google Pay oppure Link, per un minimo di 10 USD; non sono disponibili pagamenti rateali né Papara.

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

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

:: Windows – Komut İstemi (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Abbiamo tratto queste righe e i nomi delle variabili riportati di seguito dalla documentazione di Claude Code su installazione e connessione al gateway in data 3 ottobre 2026. Anthropic non pubblica questa documentazione in turco; per questo riportiamo i messaggi di errore nella loro versione originale inglese. Abbiamo verificato per l’ultima volta i prezzi e i metodi di pagamento di Kunavo il 10 ottobre 2026. Non serve cercare una VPN o un proxy estero: la pagina di Anthropic sui paesi supportati include la Turchia sia per Claude.ai sia per l’API (verificata il 3 ottobre 2026).

Quale riga usare in quale terminale?

La maggior parte di chi incontra problemi durante l'installazione sbaglia terminale, non comando. La tabella seguente associa il tuo ambiente alla riga corretta. Se usi Windows, nella sezione successiva spieghiamo come riconoscere il terminale.

Requisiti di sistema

Requisiti indicati nella documentazione ufficiale di installazione (alla data del 3 ottobre 2026):

• Sistema operativo: macOS 13.0 o versione successiva; Windows 10 versione 1809 e successive oppure Windows Server 2019 e successive; su Linux, Ubuntu 20.04, Debian 10 e Alpine Linux 3.19 o versioni successive.
• Hardware: almeno 4 GB di RAM e un processore x64 o ARM64. Windows a 32 bit non è supportato.
• Shell: Bash, Zsh, PowerShell o CMD.
• Node.js: non necessario per il programma di installazione nativo; solo per il metodo npm, versione 22 o superiore.
• Account: se effettui l'accesso, Pro, Max, Team, Enterprise o Console. Con una chiave API non sono necessari né abbonamento né accesso.

Alcune spiegazioni in turco disponibili online copiano una versione precedente di questo elenco: alcune indicano ancora Node.js 18 per npm e Ubuntu 18.04 o CentOS 7 per Linux. La documentazione attuale indica Node.js 22 e Ubuntu 20.04 come versioni minime. Anche l'avviso secondo cui “ogni passaggio fallisce senza un proxy fisso con uscita dagli Stati Uniti” non vale per la Turchia; al contrario, una VPN configurata apertamente può causare un errore regionale (consulta gli errori di download nella sezione su macOS e Linux).

Installazione di Claude Code su Windows

Su Windows non hai bisogno dei privilegi di amministratore, di WSL o di Git. La documentazione ufficiale non richiede l'apertura del terminale come amministratore; puoi saltare il passaggio “esegui PowerShell come amministratore” presente in alcuni video in turco. L'unica cosa da sapere è in quale terminale ti trovi:

• Se il prompt inizia con PS C:\Users\KullaniciAdi> come PS, sei in PowerShell: usa la riga irm … | iex.
• Se non compare PS all'inizio e vedi solo C:\Users\KullaniciAdi>, sei nel Prompt dei comandi: usa la riga install.cmd.
• Non aprire la voce “Windows PowerShell (x86)” dal menu Start. Essendo un processo a 32 bit, genera l'errore Claude Code does not support 32-bit Windows anche su un computer a 64 bit; scegli “Windows PowerShell” senza il suffisso.

Incollare la riga nella finestra sbagliata è una delle principali cause degli errori su Windows e i messaggi non lo dicono chiaramente. La riga del CMD incollata in PowerShell restituisce The token '&&' is not a valid statement separator. La riga di PowerShell incollata nel CMD mostra, in Windows in turco, “‘irm’ iç ya da dış komut, çalıştırılabilir program ya da toplu iş dosyası olarak tanınmıyor.” (su un sistema in inglese: 'irm' is not recognized as an internal or external command). Se provi la riga curl … | bash di macOS in PowerShell, visualizzerai A parameter cannot be found that matches parameter name 'fsSL' oppure 'bash' is not recognized as the name of a cmdlet; su un sistema in turco questi messaggi potrebbero comparire in turco. In tutti e tre i casi la soluzione è la stessa: usa la riga destinata al terminale in cui ti trovi.

Git for Windows e WSL sono necessari?

Entrambi sono facoltativi. Se Git for Windows è installato, Claude Code esegue i comandi della shell in Git Bash, incluso con Git; altrimenti passa allo strumento PowerShell. La documentazione consiglia Git, ma non lo richiede. Se Git è installato ma Git Bash non viene trovato, nel blocco CLAUDE_CODE_GIT_BASH_PATH del file ~/.claude/settings.json impostate la variabile env sul percorso completo del file bash.exe (esempio riportato nella documentazione: C:\Program Files\Git\bin\bash.exe).

Ci sono due motivi per scegliere WSL: aver bisogno degli strumenti Linux oppure voler eseguire i comandi in un ambiente isolato (sandbox). L'installazione nativa su Windows non dispone di una sandbox:

Se rimanete in WSL, eseguite installazione e utilizzo nel terminale WSL: la riga macOS/Linux funziona lì e anche claude viene avviato da lì.

Impossibile trovare il comando “claude”

Se al termine dell'installazione vedete 'claude' is not recognized (su macOS e Linux command not found: claude), molto probabilmente state lavorando in una finestra aperta prima dell'installazione: il programma di installazione aggiorna la variabile PATH, ma il vecchio terminale non lo rileva. Chiudete e riaprite prima il terminale. Su Windows il programma si trova in %USERPROFILE%\.local\bin\claude.exe, mentre su macOS e Linux in ~/.local/bin/claude. Se su Windows anche una nuova finestra non risolve il problema, aggiungete la cartella alla variabile utente PATH usando i comandi del documento:

# 1. Kurulum klasörü PATH içinde mi?
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. Sonuç yoksa kullanıcı PATH'ine ekleyin, terminali kapatıp yeniden açın
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. Yeni terminalde
claude --version

Impossibile caricare npm.ps1

Questo messaggio compare solo nel percorso npm: npm scrive un avviatore .ps1 per PowerShell e i criteri di esecuzione degli script del sistema lo bloccano. Il documento indica tre soluzioni: eseguire i comandi con i nomi npm.cmd e claude.cmd, passare al programma di installazione nativo in PowerShell oppure consentire gli script locali solo per il proprio utente:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Installazione su macOS e Linux

La riga install.sh riportata sopra si trova nella scheda “Native Install (Recommended)” della documentazione ufficiale e funziona allo stesso modo anche in WSL. Con questo metodo Claude Code scarica autonomamente le nuove versioni in background. Se preferite usare un gestore di pacchetti, Homebrew e WinGet sono anch'essi opzioni ufficiali; tuttavia, secondo il documento, queste installazioni non si aggiornano automaticamente per impostazione predefinita: dovrete ottenere la nuova versione tramite il gestore di pacchetti:

# Homebrew – stable kanalı; varsayılan olarak kendini güncellemez
brew install --cask claude-code

# WinGet (Windows) – varsayılan olarak kendini güncellemez
winget install Anthropic.ClaudeCode

Se invece dello script ricevete HTML o un 403

Il messaggio syntax error near unexpected token '<' indica che a bash è stata restituita una pagina HTML invece di uno script; curl: (22) The requested URL returned error: 403 indica che il server ha rifiutato il download. La documentazione sulla risoluzione dei problemi di installazione (verificata il 3 ottobre 2026) attribuisce entrambi i casi al fatto che l’indirizzo del programma di installazione non restituisce uno script. Se sulla pagina compare App unavailable in region, secondo la documentazione la richiesta sembra provenire da un paese in cui Claude Code non è disponibile. Poiché la Turchia è nell’elenco, se ricevete questo messaggio dalla Turchia è probabile che il vostro traffico esca da un altro paese tramite una VPN o un proxy; disattivatelo e riprovate. Un 403 senza contenuto di solito proviene da un proxy aziendale o da un firewall: provate da un’altra rete oppure chiedete al team IT di autorizzare questo indirizzo.

Installazione con npm: Node.js 22 obbligatorio

Il metodo npm non è stato rimosso ed è ancora descritto nella documentazione ufficiale, ma il pacchetto ora richiede Node.js 22 o versione successiva. Se node -v indica una versione precedente, npm non interrompe l’installazione, ma stampa solo un avviso EBADENGINE. In ogni caso, la soluzione migliore è aggiornare Node.js alla versione 22 o successiva da nodejs.org.

node -v                                    # v22 veya üstü olmalı
npm install -g @anthropic-ai/claude-code   # sudo kullanmadan

# güncelleme: npm update -g değil, @latest
npm install -g @anthropic-ai/claude-code@latest

In questo percorso, tre pratiche causano problemi:

• Installare con sudo. Il documento avverte dei problemi di autorizzazione e dei rischi per la sicurezza di sudo npm install -g.
• Aggiornare con npm update -g. Il comando corretto è npm install -g @anthropic-ai/claude-code@latest.
• Disattivare le dipendenze facoltative. Il file eseguibile principale arriva come dipendenza facoltativa tramite un pacchetto @anthropic-ai/claude-code-* specifico per la piattaforma. Il flag --omit=optional o optional=false in .npmrc evita questo pacchetto: l'installazione termina senza errori, ma su macOS e Linux l'avvio di claude restituisce claude native binary not installed.

L'installazione ha funzionato?

Qualunque percorso abbiate scelto, aprite un nuovo terminale ed eseguite questi due comandi:

claude --version   # sürüm numarasını yazar, ör. 2.1.211 (Claude Code)
claude doctor      # oturum açmadan kurulum ve ayar teşhisi

Se claude --version stampa un numero di versione, il programma è installato correttamente. claude doctor invece elenca lo stato dell'installazione e i problemi nei file di configurazione senza effettuare l'accesso; se qualcosa va storto nel passaggio successivo, vi permette di distinguere se il problema riguarda l'installazione o la configurazione.

Senza abbonamento: configurare una chiave API per Claude Code

Al primo avvio, claude richiede l'autenticazione. Se avete un piano Claude, effettuate l'accesso e continuate; se non avete un piano o preferite pagare in base all'utilizzo invece di una tariffa mensile fissa, eseguite Claude Code con una chiave API. Ecco la differenza tra i due percorsi:

L'uso della chiave segue una configurazione prevista da Anthropic: ANTHROPIC_BASE_URL è la variabile integrata di Claude Code e la documentazione ufficiale del gateway descrive l'esecuzione di Claude Code dietro un proxy o un gateway tramite questa variabile. Non dovete installare plugin, patch o client modificati. Su macOS e Linux aggiungete le sei righe al file della shell (~/.zshrc o ~/.bashrc):

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # yalnızca alan adı, /v1 yok
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

Prima di rendere permanenti le impostazioni su Windows, provatele in una singola sessione PowerShell; quando la finestra si chiude, anche le variabili scompaiono:

# Yalnızca bu PowerShell penceresinde geçerli – pencereyi kapatınca kaybolur
$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

Se volete che siano valide in ogni terminale, scrivete gli stessi valori nel blocco env del file delle impostazioni utente. Secondo il documento, questo file si applica a tutti i vostri progetti; su Windows si trova in %USERPROFILE%\.claude\settings.json. %APPDATA%\Claude\settings.json, presente in alcuni riepiloghi generati dall'IA, non è il percorso della documentazione ufficiale. Se il file esiste già, aggiungete soltanto il blocco env senza cancellarne il contenuto:

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

Le sei variabili e gli aspetti da considerare

ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY? La chiave Kunavo accetta entrambe le intestazioni: Authorization: Bearer e x-api-key. La differenza riguarda il comportamento di Claude Code. ANTHROPIC_AUTH_TOKEN viene inviato nell'intestazione Bearer e funziona senza porre domande. ANTHROPIC_API_KEY viene invece inviato nell'intestazione x-api-key e, in modalità interattiva, richiede la vostra conferma al primo utilizzo; se rispondete “no”, la chiave viene ignorata senza avviso. Per riattivarla dovete trovare /config → Use custom API key. In questa guida usiamo ANTHROPIC_AUTH_TOKEN proprio per questo motivo.

Perché fissare i modelli? Secondo la documentazione sulla configurazione dei modelli (verificata il 3 ottobre 2026), Claude Code connesso all’API, se non viene configurato nulla, usa Opus 5.5 come modello predefinito e per l’alias opus, e Sonnet 5.5 per l’alias sonnet; quando Anthropic rilascia un nuovo modello, questi alias vengono aggiornati. Al 3 ottobre 2026, Kunavo non offre Sonnet 5.5, quindi una richiesta sonnet non fissata a un modello restituisce un errore 404. Claude Opus 5.5 funziona su Kunavo, ma la sua tariffa ($2,80 / $14,00) è più alta di quella di Claude Sonnet 5 ($1,40 / $7,00); se non fissate il modello, potreste usare inconsapevolmente un modello più costoso. Per questo nel blocco qui sopra è presente la riga ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5: /model sonnet, la fase di esecuzione di opusplan e i subagenti configurati con model: sonnet useranno Claude Sonnet 5 invece di Sonnet 5.5. Fissiamo l’alias opus al modello Claude Opus 5.5 (claude-opus-5-5); questo modello richiede Claude Code v2.1.280 o versione successiva. Se usate una versione precedente, eseguite claude update.

Le tariffe Kunavo (input / output, per 1 milione di token): Claude Sonnet 5 $1,40 / $7,00 (tariffa Anthropic: $2,00 / $10,00); Claude Opus 5.5 $2,80 / $14,00; Claude Haiku 4.5, che gestisce le attività in background, $0,70 / $3,50.

Dove non scrivere la chiave e quale valore ha la precedenza?

Il file .claude/settings.json del progetto non è il posto giusto per la chiave: la documentazione sul gateway ricorda che questo file viene inserito nel repository, quindi la chiave sarebbe condivisa con chiunque lo cloni. Se la stessa variabile è definita sia nella shell sia nel blocco env del file delle impostazioni, nella maggior parte dei casi prevale il valore presente nel file delle impostazioni; se una modifica nella shell non ha effetto, controllate prima lì. La chiave model nel file delle impostazioni fa eccezione a questa regola: la variabile ANTHROPIC_MODEL ha la precedenza, mentre model viene usato solo se la variabile non è impostata. Nell’estensione VS Code, le variabili si inseriscono nel campo claudeCode.environmentVariables delle impostazioni utente di VS Code.

Primo avvio e controllo /status

Se le variabili si trovano nel posto giusto, il comando claude apre la sessione senza mostrare la schermata di accesso; la documentazione del gateway (verifica: 3 ottobre 2026) descrive questo comportamento quando ANTHROPIC_AUTH_TOKEN è impostato. Se compare la schermata di accesso, Claude Code non ha rilevato la chiave. Una causa comune è che la chiave si trovi solo nelle impostazioni del progetto: in modalità interattiva, il blocco env nel file .claude/settings.json o .claude/settings.local.json del progetto viene letto dopo il wizard di primo avvio e la richiesta di fiducia nella cartella. La chiave deve trovarsi in un punto letto prima del wizard: export nella shell, ~/.claude/settings.json a livello utente oppure nelle impostazioni gestite (managed settings).

Dopo aver effettuato l'accesso, digitate /status. Due righe forniscono informazioni sufficienti:

• Anthropic base URL: compare solo se è stato definito un indirizzo personalizzato e deve riportare https://api.kunavo.com. Se la riga è assente, ANTHROPIC_BASE_URL non ha raggiunto la sessione.
• Auth token: se accanto compare il nome ANTHROPIC_AUTH_TOKEN, le richieste vengono inviate con la chiave API. Se invece compare una riga Login method che indica il vostro account claude.ai, Claude Code sta ancora usando l'accesso salvato; uscite, aprite un nuovo terminale e controllate dove avete scritto le variabili.

Testare senza avviare Claude Code

Potete testare l'indirizzo e la chiave anche indipendentemente da Claude Code. Il metodo della documentazione ufficiale consiste nell'inviare una richiesta con un solo token di output; dal saldo viene detratto un importo molto piccolo. Il comando legge le variabili dalla shell corrente; se la chiave si trova solo nel file delle impostazioni, eseguite prima export in questo terminale. Se la risposta inizia con {"id":"msg_, indirizzo e chiave sono corretti; 401 indica che la chiave è stata rifiutata.

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

Di seguito è riportato l'equivalente per PowerShell; se ha esito positivo, la risposta contiene un campo id che inizia con msg_:

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

Cosa cambia con una chiave API?

• Remote Control e dettatura vocale non sono disponibili. Secondo il documento, entrambi richiedono un'identità claude.ai e non funzionano quando è attivo ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN o un apiKeyHelper. A partire dalla v2.1.196, Remote Control è disattivato anche quando ANTHROPIC_BASE_URL indica un server diverso da Anthropic.
• /fast appare disattivato. Secondo il documento, quando è definito solo un bearer token Claude Code non chiede lo stato della modalità rapida (fast mode) e la considera disattivata.
• La ricerca di strumenti MCP è disattivata per impostazione predefinita. La documentazione MCP (verificata il 3 ottobre 2026) include una configurazione senza l’impostazione specifica ANTHROPIC_BASE_URL, in cui non viene usata la ricerca degli strumenti.
• I numeri di /context sono stime. Kunavo non offre l’endpoint /v1/messages/count_tokens; in questo caso Claude Code stima l’utilizzo del contesto dal numero di caratteri, secondo la documentazione sulla compatibilità dei gateway (verificata il 3 ottobre 2026).

I dettagli tecnici dell'integrazione sono disponibili nella documentazione inglese sull'integrazione di Claude Code; la versione inglese di questa guida è Install Claude Code.

Pagare dalla Turchia: carta, Apple Pay, Google Pay, Link

Qui non pagate un abbonamento, ma un saldo API prepagato che Claude Code consuma in base ai token utilizzati. Pro e Max acquistati sul sito di Anthropic si possono pagare solo con carta di credito o di debito (FAQ sui piani a pagamento di Claude, verificata il 3 ottobre 2026). La ricarica su Kunavo non sostituisce né paga questi piani. Passaggi:

1. Registratevi su Kunavo. È sufficiente un indirizzo e-mail o un account Google; durante la registrazione non vengono richiesti i dati della carta.
2. Nella pagina Billing, scegliete l'importo. Il minimo è 10 USD; non ci sono abbonamenti né tariffe mensili. Per importi elevati viene aggiunto un bonus: Saldo di 100 USD per chi ricarica 110 USD, Saldo di 1.000 USD per chi ricarica 1.200 USD e Saldo di 5.000 USD per chi ricarica 6.250 USD.
3. Si apre la pagina di pagamento Stripe. Scegliete una carta (Visa, Mastercard), Apple Pay, Google Pay o Link; Apple Pay e Google Pay vengono elencati solo sui dispositivi e nei browser che li supportano.
4. Poi, nella pagina API Keys, generate una chiave che inizi con sk-kn-. La chiave viene mostrata una sola volta: copiatela e inseritela subito nel valore ANTHROPIC_AUTH_TOKEN.

L'importo viene mostrato in lire turche o in dollari?

I prezzi di Kunavo sono in dollari; Stripe decide quale valuta mostrare nella pagina di pagamento e l’importo può essere visualizzato anche in lire turche. La documentazione di Stripe su Adaptive Pricing (verificata il 3 ottobre 2026) include la Turchia tra i mercati supportati e indica che, in questa conversione, al tasso di cambio viene aggiunta una commissione del 2–4% a carico dell’acquirente. Se scegliete di pagare in dollari, non viene applicata questa commissione; in tal caso, la banca della vostra carta applicherà il proprio tasso di cambio e l’eventuale commissione per le transazioni estere. Qualunque sia la valuta, prima di confermare il pagamento vedrete l’importo esatto nella pagina di pagamento.

Pagamento rateale, Papara, bonifico e Troy

• Non è possibile pagare a rate: il pagamento viene addebitato in un’unica soluzione. Anche le spese effettuate con carte turche su siti esteri non possono essere suddivise in rate in un secondo momento (enuygunfinans.com, verificato il 3 ottobre 2026).
• Non sono disponibili Papara, bonifico/EFT e PayPal. Queste opzioni non compaiono nella pagina di pagamento.
• Troy: Troy non compare nella pagina di Stripe sui circuiti di carte supportati (verificata il 3 ottobre 2026). Pagate con una carta che riporti il logo Visa o Mastercard.
• Non vengono emesse fatture. Kunavo non emette alcuna fattura, inclusa la e-Arşiv; il riepilogo delle ricariche è disponibile nella pagina Billing.

Se la carta viene rifiutata, controllate prima l'app mobile della vostra banca: la carta deve essere abilitata agli acquisti online e alle operazioni internazionali. Il caricamento automatico può essere configurato solo con una carta salvata o Link. Il saldo non ha una data di scadenza e le richieste non riuscite non vengono addebitate. Le tariffe di tutti i modelli sono riportate nella guida Prezzi dell'API Claude.

Quanto costa una sessione di lavoro?

Nel percorso con la chiave, il costo dipende interamente dal numero di token. Claude Code invia da capo il contesto della conversazione a ogni richiesta; quando la parte iniziale invariata del contesto viene letta dalla cache, viene invece applicata una tariffa molto più bassa. La tabella seguente non è una misurazione, ma un calcolo basato su ipotesi esplicite; non va letta come un limite superiore. Ipotesi:

• 40.000 token di input per richiesta; di questi, 36.000 (%90) vengono letti dalla cache, mentre i restanti 4.000 vengono scritti nella cache;
• 1.000 token di output per richiesta;
• 50 richieste nella sessione; le Claude Haiku 4.5 chiamate in background non sono incluse nel calcolo;
• Per Claude Sonnet 5, la lettura dalla cache costa %10 della tariffa di input, mentre la scrittura nella cache costa 1,25 volte tanto. Ogni modello nella tabella è stato calcolato con le proprie tariffe.

L’importo effettivo dipende dalla lunghezza del contesto, dai risultati della cache, dalla lunghezza delle risposte e dal fatto che cancelliate o meno la conversazione quando cambiate argomento. La documentazione ufficiale sui costi (verificata il 3 ottobre 2026) aggiunge due dettagli: Claude Code consuma una piccola quantità di token in background anche quando non scrivete, in genere meno di 0,04 dollari per sessione; per una chiave API, la durata predefinita della cache è di cinque minuti, quindi il primo messaggio dopo un intervallo più lungo non trova una corrispondenza nella cache e l’intero contesto viene elaborato di nuovo. Quando cambiate argomento, /clear; nelle sessioni lunghe, /compact riduce questo costo.

Tutte le tariffe sono disponibili nella pagina dei prezzi. Potete stimare il vostro utilizzo con il calcolatore dei costi dei token di Claude (in inglese). La guida Prezzo di Claude Code tratta la questione se sia più conveniente un abbonamento o l'API.

Messaggi di errore e soluzioni

Limitazioni da conoscere

• Kunavo non emette fatture; non è disponibile nemmeno la e-Arşiv.
• Il pagamento è unico: niente rate, Papara o bonifico/EFT. Per il caricamento automatico è necessaria una carta salvata o Link.
• Non si tratta di un abbonamento Claude Pro o Max, ma di un'API a pagamento per token. Nel percorso con la chiave, Remote Control e la dettatura vocale non funzionano, /fast appare disattivato e la ricerca degli strumenti MCP è disattivata per impostazione predefinita.
• Kunavo non offre Sonnet 5.5 al 3 ottobre 2026; se i modelli non vengono fissati, l'alias sonnet restituisce 404.
• La documentazione ufficiale di Claude Code e la documentazione sull'integrazione Kunavo sono disponibili solo in inglese (verifica: 3 ottobre 2026).

Domande frequenti