Per usare Claude Code senza acquistare un piano Pro/Max, devi fare tre cose: installarlo con il comando native ufficiale (una riga per ogni tipo di terminale, subito sotto), impostare ANTHROPIC_BASE_URL=https://api.kunavo.com (senza /v1) insieme a ANTHROPIC_AUTH_TOKEN e alle quattro variabili per fissare i modelli, quindi digitare /status per verificare che Claude Code stia funzionando con la chiave. Il costo dei token viene detratto dal saldo prepagato, che puoi ricaricare a partire da 10 USD con una carta Visa/Mastercard o Link; MoMo, ZaloPay e VNPay non sono disponibili. Per l’installazione tramite npm, il computer deve avere Node.js 22 o una versione successiva.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash# Windows PowerShell
irm https://claude.ai/install.ps1 | iex:: Windows Command Prompt (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdI comandi di installazione e i nomi delle variabili in questa guida provengono dalla documentazione ufficiale di Claude Code, incluse la pagina di installazione e la lista delle variabili d'ambiente, ricontrollate il 3 ottobre 2026. Anthropic non ha ancora una versione vietnamita di queste pagine (il percorso /docs/vi/setup restituiva un errore 404 lo stesso giorno), quindi i messaggi di errore nella guida sono lasciati in inglese per facilitarne la ricerca. Prezzi e metodi di pagamento di Kunavo verificati il 10 ottobre 2026.
Scegli il comando di installazione in base al terminale aperto
Tutti i metodi di installazione producono lo stesso programma claude; la differenza sta in chi si occupa degli aggiornamenti. La documentazione ufficiale presenta il metodo nativo nella scheda “Native Install (Recommended)”, ed è anche l’unico metodo che si aggiorna automaticamente alla nuova versione senza che tu debba fare nulla.
| Ti trovi in | Usa il comando | Aggiornamento |
|---|---|---|
| macOS, Linux o terminale WSL | install.sh (prima riga sopra) | Automatico, in background |
Windows PowerShell, prompt nella forma PS C:\Users\TenBan> | irm https://claude.ai/install.ps1 | iex | Automatico, in background |
Windows CMD, prompt nella forma C:\Users\TenBan> (senza PS) | Riga con install.cmd | Automatico, in background |
| Hai già dimestichezza con Homebrew o WinGet | brew install --cask claude-code, winget install Anthropic.ClaudeCode | Per impostazione predefinita non si aggiorna automaticamente; esegui l’aggiornamento tramite lo stesso gestore di pacchetti |
| È necessario passare da npm | npm install -g @anthropic-ai/claude-code, richiede Node.js 22+ | Esegui di nuovo con @latest |
# Homebrew (macOS, Linux) – mặc định không tự cập nhật
brew install --cask claude-code
# WinGet (Windows) – mặc định không tự cập nhật
winget install Anthropic.ClaudeCodeIl computer deve soddisfare i seguenti requisiti (secondo la pagina di installazione, verificata il 3 ottobre 2026):
- Sistema operativo: macOS 13.0 o successivo; Windows 10 versione 1809 o successiva oppure Windows Server 2019 o successivo; Ubuntu 20.04+, Debian 10+ o Alpine Linux 3.19+.
- Almeno 4 GB di RAM, CPU x64 o ARM64. Windows a 32 bit non è supportato.
- La shell deve essere Bash, Zsh, PowerShell o CMD e deve essere disponibile una connessione Internet.
- Node.js è necessario solo per l’installazione tramite npm e deve essere almeno la versione 22.
Dopo l’installazione, non digitare subito claude nella vecchia finestra: quella finestra non ha ancora rilevato il nuovo PATH. Apri un altro terminale ed esegui:
claude --version # in ra số phiên bản, kèm chữ (Claude Code)
claude doctor # chẩn đoán cài đặt và file cấu hình, không mở phiên làm việcSe claude --version stampa un numero di versione, l’installazione è completata; tutti gli eventuali problemi successivi riguardano la configurazione. claude doctor è utile quando non sai con certezza dove si trovi l’errore, perché controlla sia l’installazione sia i file delle impostazioni senza aprire alcuna sessione di lavoro.
Windows: cinque errori frequenti
- Hai incollato la riga di comando sbagliata. Se PowerShell riceve una riga destinata a CMD, mostrerà
The token '&&' is not a valid statement separator; se CMD riceve una riga destinata a PowerShell, mostrerà'irm' is not recognized as an internal or external command. Guarda il prompt: se contienePS, usa la rigairm; altrimenti usa la rigainstall.cmd. - Hai aperto «Windows PowerShell (x86)» per errore. Questa voce del menu Start è un processo a 32 bit, quindi riconoscerà
Claude Code does not support 32-bit Windowsanche su un computer a 64 bit. Scegli la voce senza la dicitura (x86). - Eseguire con i privilegi di amministratore è superfluo. La documentazione non lo richiede e la versione native viene installata nella cartella dell’utente:
%USERPROFILE%\.local\bin\claude.exe. - Digitando
claudecompare «not recognized». La cartella indicata sopra non è ancora inclusa inPATH. Prova prima con un terminale nuovo; se l’errore persiste, usa il frammento PowerShell qui sotto per controllare e aggiungere il percorso. Su macOS/Linux, l’errore equivalente ècommand not found: claudee il programma si trova in~/.local/bin/claude. - npm mostra
npm.ps1 cannot be loaded because running scripts is disabled on this system. La Execution policy di PowerShell sta bloccando lo script.ps1creato da npm. La documentazione indica tre soluzioni: consentire all’utente corrente di eseguire script locali con il comandoSet-ExecutionPolicyqui sotto, richiamarenpm.cmdeclaude.cmdal posto della versione.ps1, oppure abbandonare npm e usare il comando native.
# 1. Kiểm tra thư mục cài đặt đã có trong PATH chưa
$env:PATH -split ';' | Select-String '\.local\\bin'
# 2. Không có kết quả nào? Thêm vào PATH của người dùng, rồi đóng và mở lại terminal
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
# 3. Trong terminal mới
claude --versionSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserWindows nativo o WSL? Se il progetto si trova su Windows, l'esecuzione nativa è sufficiente. In questo caso Git for Windows è facoltativo: se è installato, Claude Code esegue i comandi tramite Git Bash; altrimenti usa PowerShell. Se Git è già installato ma Claude Code non trova Git Bash, impostare CLAUDE_CODE_GIT_BASH_PATH nel blocco env di ~/.claude/settings.json, indicando il percorso di bash.exe (la documentazione riporta come esempio C:\Program Files\Git\bin\bash.exe). Scegliere WSL 2 se servono strumenti Linux o si desidera eseguire i comandi in una sandbox, poiché la sandbox è disponibile solo in WSL 2; non è disponibile né nell'ambiente Windows nativo né in WSL 1. WSL 1 è un'alternativa solo quando non è possibile attivare WSL 2 sul computer. Se si sceglie WSL, installare con il comando install.sh ed eseguire claude interamente nel terminale WSL.
Installazione tramite npm: requisiti e tre avvertenze
npm è una scelta sensata se si gestiscono già gli strumenti da riga di comando con Node o se la rete aziendale consente di scaricare pacchetti solo tramite il registry npm. Il requisito è Node.js 22 o versione successiva; il requisito Node 18 indicato in molti vecchi articoli non è più valido. Le versioni precedenti di Node non impediscono l'installazione: npm mostra solo un avviso EBADENGINE, perché il programma effettivamente eseguito è un'applicazione nativa scaricata dal pacchetto npm, che non dipende da Node. Se il computer non ha Node, scaricare la versione 22 o successiva da nodejs.org.
node -v # cần v22 trở lên
npm install -g @anthropic-ai/claude-code # không dùng sudo
# nâng cấp bằng @latest, không dùng npm update -g
npm install -g @anthropic-ai/claude-code@latest- Non usare
sudo npm install -g: la documentazione avverte che questo metodo causa problemi di autorizzazioni e costituisce un rischio per la sicurezza. - Aggiorna con
npm install -g @anthropic-ai/claude-code@latest;npm update -gnon è il metodo indicato dalla documentazione. - Il programma native proviene da una dipendenza opzionale (il pacchetto
@anthropic-ai/claude-code-*corrispondente alla tua piattaforma). Il flag--omit=optional, la rigaoptional=falsein.npmrco--ignore-scriptsne impediscono l’installazione e su macOS/Linux viene visualizzatoclaude native binary not installed.
Serve una VPN? Errori durante il download dello script di installazione
No. Il Vietnam è incluso nell'elenco dei Paesi supportati da Anthropic sia per Claude.ai sia per l'API (verificato il 3 ottobre 2026). Il problema è più spesso la VPN: secondo la pagina per la risoluzione dei problemi di installazione (consultata il 3 ottobre 2026), se l'indirizzo di installazione restituisce App unavailable in region, Claude Code non è disponibile nel luogo da cui risulta provenire la connessione. Se compare questo messaggio mentre ci si trova in Vietnam, disattivare la VPN o il proxy impostato su un altro Paese e riprovare.
Gli altri due errori hanno la stessa causa: syntax error near unexpected token '<' o curl: (22) The requested URL returned error: 403 indicano che, invece dello script, hai ricevuto una pagina HTML o un codice di errore. Una rete aziendale con proxy o firewall che blocca il download dei file è il primo sospettato. Non passare subito a Homebrew, WinGet o npm: la documentazione consiglia di controllare prima la connessione di rete, perché anche i metodi di installazione alternativi scaricano dallo stesso server. Prova un’altra rete oppure chiedi al reparto IT di rimuovere il blocco.
Configurazione della chiave API: eseguire Claude Code senza un piano Pro/Max
Claude Code esegue l’autenticazione in uno dei due modi seguenti. La tabella sotto offre un confronto rapido; il resto dell’articolo segue la colonna di destra.
| Accesso con un account Claude | Chiave API di Kunavo | |
|---|---|---|
| Requisiti | Piano Pro, Max, Team, Enterprise o account Console. Il piano gratuito Claude.ai non include Claude Code. | Una chiave sk-kn-… impostata in una variabile d’ambiente. Nessun piano da acquistare e nessun accesso richiesto. |
| Prezzo | Prezzi mensili: Pro costa 20 USD al mese (17 USD al mese con pagamento annuale, cioè 200 USD in un'unica soluzione); Max parte da 100 USD al mese, tasse escluse (claude.com/pricing, consultato il 3 ottobre 2026). | In base ai token effettivamente utilizzati, detratti dal saldo prepagato a partire da 10 USD. Nessun costo mensile, il saldo non scade e le richieste con errore non vengono addebitate. |
| Pagamento con | Per gli acquisti sul sito di Anthropic sono accettate solo carte di credito o di debito (FAQ sui pagamenti di Claude, consultate il 3 ottobre 2026). | Carta Visa, Mastercard, Link; Apple Pay o Google Pay se disponibili sul dispositivo. MoMo, ZaloPay e VNPay non sono disponibili. |
| Cosa manca | — | Remote Control e dettatura vocale. Nessuna fattura IVA. |
Indirizzare Claude Code verso un servizio diverso da Anthropic non è un trucco: la documentazione ufficiale descrive ANTHROPIC_BASE_URL come la variabile usata per sovrascrivere l’endpoint API quando si passa attraverso un proxy o un gateway. Kunavo utilizza il protocollo Anthropic Messages API corretto, quindi puoi usare Claude Code originale, senza plugin né patch. Servono esattamente sei variabili:
| Variabile | Valore | A cosa serve, dove si sbaglia |
|---|---|---|
ANTHROPIC_BASE_URL | https://api.kunavo.com | Solo il dominio. Claude Code aggiunge automaticamente /v1/messages; se aggiungi anche /v1, la richiesta diventa /v1/v1/messages e restituisce 404. |
ANTHROPIC_AUTH_TOKEN | Chiave sk-kn-… | Viene inviata nell’header Authorization: Bearer, è efficace immediatamente e non richiede una fase di conferma. |
ANTHROPIC_MODEL | claude-sonnet-5 | Modello principale (Claude Sonnet 5). Il nome deve corrispondere carattere per carattere all’elenco di Kunavo; i nomi precedenti con suffisso di data non vengono convertiti automaticamente. |
ANTHROPIC_DEFAULT_OPUS_MODEL | claude-opus-5-5 | Fissa l’alias opus (e opusplan quando sei in plan mode) su Claude Opus 5.5, così non seguirà automaticamente la versione più recente di Opus. È necessaria Claude Code v2.1.280 o successiva; con una versione precedente esegui claude update. |
ANTHROPIC_DEFAULT_SONNET_MODEL | claude-sonnet-5 | Per impostazione predefinita, l’alias sonnet punta a Sonnet 5.5, un modello che Kunavo non fornisce. Se non lo fissi, /model sonnet, la fase di esecuzione di opusplan e il subagent impostato su model: sonnet restituiscono tutti 404. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | claude-haiku-4-5 | L’alias haiku e tutte le attività in background di Claude Code utilizzano questo modello. Se non viene fissato, questo alias richiede un ID che Kunavo non offre (Haiku 5.5 dalla v2.1.293), quindi /model haiku e i subagenti impostati su model: haiku restituiscono 404. |
Dove impostare le variabili
Il modo più semplice per un uso a lungo termine è il blocco env nel file delle impostazioni dell’utente, ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Questo file si applica a tutti i progetti; se contiene già altre impostazioni, aggiungi soltanto 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"
}
}Se preferisci inserirle nella shell, aggiungile a ~/.zshrc o ~/.bashrc. Su Windows, il secondo frammento qui sotto (le righe $env:) è adatto per una prova rapida, ma le variabili scompaiono non appena chiudi la finestra di PowerShell.
export ANTHROPIC_BASE_URL=https://api.kunavo.com # chỉ tên miền, không thêm /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# Chỉ có hiệu lực trong cửa sổ PowerShell này, đóng cửa sổ là mất
$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"
claudeTre cose da sapere prima di incontrare problemi:
- Non inserire la chiave nel file
.claude/settings.jsondel progetto. La documentazione sulla connessione al gateway ricorda che questo file viene incluso nei commit ed è accessibile a chiunque cloni il repository. - Il file delle impostazioni ha la precedenza sulla shell. Se una variabile è presente in entrambi i luoghi, viene utilizzato il valore del blocco
envnel file delle impostazioni. Se la modifichi nella shell ma non noti alcun cambiamento, controlla prima il file delle impostazioni. - La prima esecuzione richiede la chiave a livello utente. In modalità interattiva, il blocco
envin.claude/settings.jsono.claude/settings.local.jsondel progetto diventa effettivo solo dopo la procedura guidata iniziale e la domanda relativa all’attendibilità della cartella. Se la chiave si trova solo lì, al primo avvio verrà comunque visualizzata la schermata di accesso.
ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY e il problema dell’«errore 403»
Kunavo legge la chiave sia in Authorization: Bearer sia in x-api-key, quindi entrambe le variabili consentono la connessione. La differenza riguarda Claude Code. Secondo la documentazione sulle variabili d'ambiente (consultata il 3 ottobre 2026), ANTHROPIC_AUTH_TOKEN viene inserito nell'intestazione Authorization con il prefisso Bearer ed è subito attivo. ANTHROPIC_API_KEY viene inserito nell'intestazione X-Api-Key; in modalità interattiva, Claude Code chiede una volta se si desidera usare questa chiave al posto dell'abbonamento. Se si risponde «no», la chiave viene ignorata e la domanda non viene ripetuta; per attivarla di nuovo, aprire /config e selezionare Use custom API key. In questa guida si usa ANTHROPIC_AUTH_TOKEN solo per evitare quella richiesta di conferma.
Alcune guide in vietnamita affermano che ANTHROPIC_API_KEY fa sì che Claude Code ignori ANTHROPIC_BASE_URL, chiami direttamente api.anthropic.com e riceva un 403. Né la documentazione delle variabili d’ambiente né la documentazione sulla connessione al gateway (consultata il 3 ottobre 2026) affermano questo: le due variabili sono due modi per fornire la chiave allo stesso gateway in ANTHROPIC_BASE_URL. Se dopo aver cambiato variabile ricevi davvero un 403, controlla di nuovo l’URL di base e la chiave invece di continuare a cambiare il nome della variabile.
Perché fissare i modelli e quanto costa ciascun modello
Gli alias di Claude Code cambiano nel tempo. Secondo la documentazione sulla configurazione dei modelli (consultata il 3 ottobre 2026), per gli utenti API il modello predefinito e l’alias opus puntano a Opus 5.5, mentre l’alias sonnet punta a Sonnet 5.5; la documentazione dice anche che gli alias «vengono aggiornati nel tempo» e consiglia di usare il nome completo o le variabili ANTHROPIC_DEFAULT_*_MODEL quando è necessario fissare un modello. Al 3 ottobre 2026, Kunavo offre Opus 5.5 ma non Sonnet 5.5. Se si salta il passaggio di fissaggio: la sessione predefinita usa Opus 5.5, più costoso di Claude Sonnet 5; /model sonnet, la fase di esecuzione di opusplan e i subagent impostati su model: sonnet restituiscono 404; inoltre, la prossima volta che l’alias opus passerà a una nuova versione di Opus, quella versione potrebbe non essere ancora disponibile su Kunavo. Per questo la configurazione qui sopra fissa l’alias sonnet su claude-sonnet-5 tramite ANTHROPIC_DEFAULT_SONNET_MODEL e l’alias opus su Opus 5.5 (claude-opus-5-5). Opus 5.5 richiede Claude Code v2.1.280 o versioni successive; con una versione precedente, esegui claude update.
Prezzi su Kunavo, calcolati per ogni milione di token (input / output): Claude Sonnet 5 1,40 USD / 7,00 USD (listino Anthropic: 2,00 USD / 10,00 USD); Claude Opus 5.5 2,80 USD / 14,00 USD; Claude Haiku 4.5 0,70 USD / 3,50 USD.
Verifica con /status
Quando ANTHROPIC_AUTH_TOKEN è stato rilevato, il comando claude apre direttamente la sessione, senza schermata di accesso (secondo la documentazione sulla connessione al gateway, verificata il 3 ottobre 2026); la prima volta restano comunque alcuni passaggi di configurazione, come la domanda relativa all’attendibilità della cartella. Se compare la schermata di accesso, significa che la chiave non è stata rilevata. Nella sessione, digita /status e cerca:
Anthropic base URL:https://api.kunavo.com. Questa riga compare solo quando è presente un indirizzo gateway; la sua assenza significa cheANTHROPIC_BASE_URLnon è entrato nella sessione.Auth token:ANTHROPIC_AUTH_TOKEN. Se in quel punto compareLogin methodinsieme a un account claude.ai, la sessione sta ancora utilizzando l’accesso salvato.
Per assicurarti che la chiave e l’indirizzo siano corretti prima di aprire Claude Code, invia una richiesta di prova che chieda esattamente 1 token di output (il costo è minimo e viene detratto dal saldo). Il comando legge le variabili dalla shell corrente; quindi, se la chiave si trova solo nel file delle impostazioni, esegui prima export in questo terminale. Un risultato che inizia con {"id":"msg_ indica che tutto funziona; 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": "."}]}'La versione PowerShell dello stesso test; in caso di successo, il campo id del risultato 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 si perde usando una chiave API
- Remote Control e la dettatura vocale richiedono un’identità claude.ai, quindi non funzionano quando
ANTHROPIC_AUTH_TOKENè attivo. Remote Control viene inoltre disattivato quandoANTHROPIC_BASE_URLpunta a un server diverso daapi.anthropic.com. /fastmostraFast mode has been disabled by your organization: secondo la documentazione sulla connessione al gateway, il controllo della modalità fast richiede l’accesso a claude.ai o una chiave API di Anthropic; con un bearer token, quindi, Claude Code considera la funzione disattivata e non interroga il server.- MCP tool search è disattivato per impostazione predefinita quando il base URL non appartiene ad Anthropic.
- I dati in
/contextsono stime: Kunavo non dispone dell’endpoint/v1/messages/count_tokense, secondo la documentazione sul protocollo del gateway (consultata il 3 ottobre 2026), quando questo endpoint non è disponibile Claude Code calcola i token in base al numero di caratteri.
I dettagli dell’integrazione sono disponibili nella documentazione dell’integrazione di Claude Code (in inglese); l’articolo corrispondente in inglese è Install Claude Code.
Ricaricare il saldo dal Vietnam: carte o Link, nessun portafoglio elettronico locale
Per essere chiari fin dall’inizio: Kunavo non accetta MoMo, ZaloPay, VNPay né bonifici bancari. Le carte ATM locali che funzionano solo sulla rete Napas non sono utilizzabili, perché non sono carte Visa o Mastercard. La pagina di pagamento Stripe di Kunavo offre agli acquirenti in Vietnam le seguenti opzioni:
- Carta Visa o Mastercard, sia di credito sia di debito internazionale.
- Link, il portafoglio di Stripe, salva i metodi di pagamento per rendere più rapidi i pagamenti successivi (documentazione di Link, consultata il 3 ottobre 2026).
- Apple Pay o Google Pay, disponibili solo sui dispositivi e nei browser in cui è stato configurato un portafoglio, perché pagano con le carte salvate al suo interno. Apple Pay è disponibile in Vietnam dall’08/08/2023 e può essere usato per gli acquisti online (Apple Newsroom Vietnam, consultata il 3 ottobre 2026).
Anche Anthropic applica una regola simile: i piani Claude acquistati sul web accettano solo carte di credito o di debito (FAQ sui pagamenti di Claude, consultata il 3 ottobre 2026), quindi i portafogli elettronici vietnamiti non possono pagare direttamente lì; i piani acquistati nell’app iOS o Android usano invece i metodi di pagamento dell’App Store o di Google Play. La differenza è che il denaro aggiunto a Kunavo diventa saldo API e Claude Code lo consuma token per token dopo che hai configurato la chiave come sopra.
Pagare in VND o USD
Kunavo indica i prezzi in USD. Poiché il Vietnam è tra i mercati coperti da Stripe Adaptive Pricing (consultato il 3 ottobre 2026), la pagina di pagamento può mostrare l’importo convertito in VND; l’importo esatto è sempre visibile prima di confermare. Il tasso di cambio applicato da Stripe include una commissione di conversione del 2–4%, a carico dell’acquirente. Scegliendo di pagare in USD, questa commissione non si applica, ma la banca che ha emesso la carta potrebbe applicare il proprio tasso di cambio e le proprie commissioni.
Pagare in VND non è necessariamente più conveniente: alcune banche applicano commissioni quando una carta paga in VND un esercente registrato all’estero. Per esempio, Techcombank applica una «commissione per transazioni in valuta nazionale all’estero» pari all’1,1% dell’importo della transazione (IVA inclusa) per le carte di debito Visa, a partire dal 13/08/2023 (FAQ di Techcombank, consultate il 3 ottobre 2026). È solo un esempio relativo a una banca e Kunavo non ha verificato se la banca classifichi le proprie transazioni in questa categoria; consulta il tariffario della tua carta prima di scegliere VND o USD.
Di solito una carta viene rifiutata perché i pagamenti online o internazionali non sono stati abilitati nell’app bancaria. Abilitali e riprova, oppure passa a Link o ad Apple Pay/Google Pay con una carta supportata da quel portafoglio.
Dalla registrazione alla chiave
- Registrati a Kunavo con un indirizzo email o un account Google; in questa fase non viene richiesta alcuna carta.
- Apri Billing e scegli l’importo della ricarica (il minimo è 10 USD). Gli importi più elevati includono un’aggiunta: una ricarica di 100 USD accredita 110 USD sul saldo; una ricarica di 1.000 USD accredita 1.200 USD sul saldo; una ricarica di 5.000 USD accredita 6.250 USD sul saldo.
- Nella pagina Stripe, scegli una carta, Link o un portafoglio disponibile sul dispositivo, controlla l’importo e conferma.
- Vai su API Keys e crea una chiave
sk-kn-…. La chiave viene mostrata una sola volta, quindi copiala subito inANTHROPIC_AUTH_TOKEN.
Per ricaricare automaticamente quando il saldo scende sotto una determinata soglia, devi usare una carta salvata o Link. Il saldo non ha scadenza e le richieste con errore non vengono addebitate. Kunavo non emette fatture IVA, nemmeno fatture elettroniche secondo la normativa vietnamita; la cronologia delle ricariche è disponibile in Billing. Questo saldo può essere utilizzato solo per l’API di Kunavo e non per pagare Claude Pro, Claude Max o ChatGPT Plus.
Quanto costa all’incirca una sessione di coding?
A ogni richiesta Claude Code invia nuovamente l’intero contesto della conversazione, quindi il costo dipende molto dalla cache: il contesto ripetuto viene addebitato al prezzo di lettura della cache, molto più conveniente. La tabella seguente è un calcolo teorico basato sulle ipotesi indicate; non rappresenta una misurazione reale né un limite massimo:
- per ogni richiesta, 40.000 token di input: 36.000 token (90%) letti dalla cache, 4.000 token scritti nella cache;
- ogni richiesta contiene 1.000 token di output;
- una sessione di 50 richieste, senza contare le richieste Claude Haiku 4.5 eseguite in background;
- con Claude Sonnet 5 su Kunavo, la lettura della cache costa 10% del prezzo di input e la scrittura della cache costa 1,25 volte il prezzo di input; ogni modello nella tabella utilizza la propria tariffa.
| Modello | Una richiesta | 50 richieste | 50 richieste, senza alcun riscontro nella cache |
|---|---|---|---|
| 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 |
L’ultima colonna mostra quanto sia importante la cache. Un contesto lungo, una risposta lunga o dimenticare /clear tra due attività diverse fanno aumentare il valore. Il confronto tra abbonamento e API e la stima mensile sono disponibili nell’articolo Quanto costa Claude Code; per i prezzi dei singoli modelli, consulta la tabella dei prezzi dell’API Claude o la pagina dei prezzi; per inserire i tuoi dati, usa lo strumento di calcolo dei costi dei token Claude (in inglese).
Diagnosi in base al messaggio
| Quando | Cosa vedi | Soluzione |
|---|---|---|
| Installazione | The token '&&' is not a valid statement separator | Sei in PowerShell e hai incollato una riga per CMD. Usa irm … | iex. |
| Installazione | 'irm' is not recognized as an internal or external command | Sei in CMD e hai incollato una riga per PowerShell. Usa la riga install.cmd. |
| Installazione | syntax error near unexpected token '<', 403, App unavailable in region | Hai ricevuto una pagina HTML invece dello script. Disattiva la VPN/il proxy che instrada verso un altro Paese e prova prima un’altra rete, prima di cambiare metodo di installazione (gli altri metodi scaricano dallo stesso server). |
| Installazione | Claude Code does not support 32-bit Windows | Hai aperto PowerShell (x86). Apri il normale «Windows PowerShell». |
| Installazione (npm) | Avviso EBADENGINE | Node.js è precedente alla versione 22. L’installazione viene comunque completata, ma è consigliabile aggiornare Node. |
| Installazione (npm) | claude native binary not installed | Manca una dipendenza opzionale a causa di --omit=optional, optional=false o --ignore-scripts. Rimuovi tale configurazione e reinstalla. |
| Installazione (npm) | npm.ps1 cannot be loaded | La Execution policy blocca lo script. Esegui Set-ExecutionPolicy indicato sopra, usa npm.cmd oppure passa al comando native. |
| Dopo l’installazione | command not found: claude, 'claude' is not recognized | La cartella di installazione non è presente in PATH. Apri un terminale nuovo; su Windows esegui anche il frammento PowerShell per aggiungere PATH. |
| Configurazione | Continua a comparire la schermata di accesso | La chiave non è stata rilevata. Impostala nella shell o nel file ~/.claude/settings.json dell’utente, non soltanto nella configurazione del progetto; quindi apri un terminale nuovo. |
| Configurazione | 401 | Chiave rifiutata: è stata copiata in modo incompleto, contiene spazi aggiuntivi, è stata eliminata da /app/keys oppure è stata inserita nella variabile sbagliata. |
| Configurazione | 404 | Il Base URL contiene /v1 in più oppure il modello non è disponibile su Kunavo (di solito perché l’alias sonnet non è stato fissato e punta a Sonnet 5.5). |
| Ricarica del saldo | Carta rifiutata | Abilita i pagamenti online e internazionali nell’app bancaria; le carte che funzionano solo su Napas non sono utilizzabili. In alternativa, prova Link, Apple Pay o Google Pay. |
Prima di ricaricare il saldo
- Sono disponibili solo carte Visa/Mastercard, Link e portafogli che utilizzano una carta; niente MoMo, ZaloPay, VNPay o bonifici.
- La ricarica automatica funziona solo con una carta salvata o Link. Kunavo non emette fatture IVA.
- Questa è un’API con pagamento a consumo per token, non un piano Claude Pro/Max: Remote Control e la dettatura vocale non sono disponibili,
/fastindica che è disattivato e MCP tool search è disattivato per impostazione predefinita. - Alla data del 3 ottobre 2026, Kunavo non dispone di Sonnet 5.5, quindi l’alias
sonnetnon fissato restituisce 404. - La documentazione di Claude Code e la documentazione dell’integrazione di Kunavo sono attualmente disponibili solo in inglese.
Domande frequenti
Claude Code è gratuito? Che cosa significa «Claude Code non richiede un piano»?
Scaricare e installare Claude Code non costa nulla, ma per ottenere risposte serve una delle due opzioni: accedere con un piano Claude a pagamento (Pro, Max, Team, Enterprise) o con un account Console, oppure utilizzare una chiave API. Il piano gratuito Claude.ai non include Claude Code. «Non richiede un piano» indica la seconda modalità: impostando ANTHROPIC_BASE_URL=https://api.kunavo.com e ANTHROPIC_AUTH_TOKEN, Claude Code ignora la procedura di accesso e addebita il costo in base ai token effettivamente utilizzati dal saldo Kunavo prepagato, con un minimo di 10 USD, senza costi mensili.
Qual è il comando per installare Claude Code su Windows? È necessario installare WSL o eseguirlo con i privilegi di amministratore?
Apri PowerShell (il prompt inizia con PS) ed esegui irm https://claude.ai/install.ps1 | iex; se ti trovi in CMD, usa curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Non servono i privilegi di amministratore e WSL o Git non sono obbligatori. Se Git for Windows è installato, Claude Code esegue i comandi tramite Git Bash; altrimenti tramite PowerShell. WSL 2 vale la pena installarlo solo se ti servono strumenti Linux o vuoi eseguire i comandi in una sandbox. Ricorda di aprire «Windows PowerShell», non la voce con «(x86)», perché Claude Code non funziona su Windows a 32 bit.
Quale versione di Node.js serve per installare Claude Code con npm?
Node.js 22 o versione successiva, secondo la documentazione ufficiale di installazione letta il 3 ottobre 2026. Molti articoli meno recenti riportano ancora Node 18, ma quel numero è ormai obsoleto. Una versione precedente di Node fa solo sì che npm mostri l’avviso EBADENGINE; l’installazione viene comunque completata, perché il pacchetto npm scarica in realtà un programma nativo che funziona senza Node. Il comando di installazione è npm install -g @anthropic-ai/claude-code (senza sudo); per passare alla versione più recente, eseguilo nuovamente con @latest invece di usare npm update -g. Se non hai un motivo specifico per usare npm, il comando nativo è più semplice.
Dove inserisco la chiave API per Claude Code? ANTHROPIC_BASE_URL deve includere /v1?
La posizione più persistente è il blocco env nel file ~/.claude/settings.json dell’utente (Windows: %USERPROFILE%\.claude\settings.json), applicato a tutti i progetti; puoi anche usare export in ~/.zshrc, ~/.bashrc o $PROFILE di PowerShell. Il Base URL è solo https://api.kunavo.com, senza /v1, perché Claude Code aggiunge automaticamente /v1/messages; /v1 aggiuntivo diventerebbe /v1/v1/messages e restituirebbe 404. Non inserire la chiave nel file .claude/settings.json del progetto: il file si trova nel repository e viene incluso a ogni clone.
Alcuni articoli affermano che usare ANTHROPIC_API_KEY causa un 403. È corretto?
Non secondo la documentazione ufficiale. Sia ANTHROPIC_API_KEY sia ANTHROPIC_AUTH_TOKEN vengono inviati all’indirizzo specificato in ANTHROPIC_BASE_URL; differiscono per l’header (X-Api-Key rispetto a Authorization: Bearer) e perché ANTHROPIC_API_KEY richiede una tua approvazione una tantum in modalità interattiva. Kunavo legge la chiave in entrambi gli header. Questa guida consiglia ANTHROPIC_AUTH_TOKEN solo perché può essere utilizzato immediatamente. Se rifiuti accidentalmente alla richiesta, la chiave viene ignorata senza essere richiesta nuovamente; vai in /config, nella voce Use custom API key, per riattivarla.
Quale modello utilizza Claude Code se ANTHROPIC_MODEL non è impostata?
Utilizza gli alias, che cambiano gradualmente nel tempo. La documentazione sulla configurazione dei modelli (letta il 3 ottobre 2026) indica che, per gli utenti API, il modello predefinito e l’alias opus sono attualmente Opus 5.5, mentre l’alias sonnet è Sonnet 5.5. Kunavo offre Opus 5.5 ma non Sonnet 5.5, quindi una sessione non fissata utilizzerà Opus 5.5 a un prezzo superiore Claude Sonnet 5; /model sonnet, la fase di esecuzione di opusplan e i subagenti impostati su model: sonnet restituiscono tutti 404. Impostando ANTHROPIC_MODEL=claude-sonnet-5, ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5 e ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5, saprai con certezza quale modello addebita ogni richiesta. Fissare l’alias opus su Opus 5.5 richiede Claude Code v2.1.280 o versione successiva; con una versione precedente, esegui claude update.
Che cosa deve mostrare /status per indicare che si sta utilizzando una chiave API?
Due righe: «Anthropic base URL» è https://api.kunavo.com e «Auth token» indica ANTHROPIC_AUTH_TOKEN. Se invece compare «Login method» con un account claude.ai, la sessione sta ancora utilizzando il precedente accesso; esci, apri un nuovo terminale e verifica dove è stata impostata la variabile. Puoi provare la chiave prima ancora di aprire Claude Code con un comando curl inviato a /v1/messages con max_tokens impostato su 1: se restituisce un JSON che inizia con {"id":"msg_ è tutto corretto; 401 indica che la chiave è stata rifiutata.
In Vietnam serve una VPN per installare o usare Claude Code?
No. Il Vietnam è incluso nell’elenco dei Paesi supportati da Anthropic sia per Claude.ai sia per l’API (verificato il 3 ottobre 2026). Al contrario, se la VPN instrada la connessione verso un Paese non supportato, l’indirizzo di installazione potrebbe restituire la pagina «App unavailable in region» invece dello script. Se compare questo errore mentre ti trovi in Vietnam, disattiva la VPN o il proxy e ripeti il comando di installazione.
È possibile aggiungere fondi con MoMo, ZaloPay o VNPay? Viene emessa una fattura IVA?
Nessuna delle due. La pagina di pagamento Stripe di Kunavo consente agli acquirenti in Vietnam di scegliere Visa, Mastercard o Link, oltre ad Apple Pay o Google Pay se già configurati sul dispositivo; MoMo, ZaloPay, VNPay e il bonifico bancario non sono disponibili. L’importo può essere visualizzato in VND; in tal caso, il tasso di cambio di Stripe include già la commissione di conversione del 2–4% a carico dell’acquirente. Se scegli di pagare in USD, tale commissione non si applica, ma la tua banca potrebbe applicare un proprio tasso di cambio e commissioni. Il deposito minimo è di 10 USD, il saldo non scade e la ricarica automatica funziona solo con una carta salvata o con Link. Kunavo non emette fatture IVA, nemmeno fatture elettroniche.