Guida all’installazione di Claude Code: comandi di installazione per Windows e macOS, configurazione con API key senza accesso all’account, ricarica con Alipay e WeChat Pay

Per Claude Code è consigliato installare con il comando nativo ufficiale di Anthropic; npm è il percorso ufficiale alternativo e richiede Node.js 22 o superiore. È possibile usare Claude Code senza accedere a un account Claude: imposta ANTHROPIC_BASE_URL (solo il dominio, senza /v1), ANTHROPIC_AUTH_TOKEN e i quattro modelli fissi per passare a una chiave API con addebito a token. Il saldo API Kunavo può essere ricaricato con Alipay o WeChat Pay, con una ricarica minima di $10. Infine esegui /status in Claude Code per verificare la connessione.

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

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

:: Windows 命令提示符（CMD）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

I comandi e le variabili d’ambiente sono stati verificati il 3 ottobre 2026, in base alla documentazione ufficiale di installazione di Claude Code e alla documentazione ufficiale sulle variabili d’ambiente; prezzi e metodi di pagamento sono stati verificati il 10 ottobre 2026. Precisiamo un fatto: l’elenco dei paesi e delle regioni supportati da Anthropic (verificato il 3 ottobre 2026) non comprende la Cina continentale, Hong Kong e Macao; inoltre, tra i requisiti di sistema della documentazione di installazione di Claude Code compare la voce «Paese o regione in cui ci si trova: un paese supportato da Anthropic». Questa pagina tratta solo i metodi di installazione e configurazione descritti nella documentazione ufficiale e non fornisce metodi per aggirare le restrizioni regionali. Kunavo non ha eseguito test di connettività di rete nella Cina continentale. Spetta a te verificare se gli indirizzi di download, i registry npm e api.kunavo.com menzionati di seguito sono accessibili dalla tua rete.

Verifica prima dell'installazione

Metodo 1: installazione nativa ufficiale (consigliata)

La documentazione ufficiale indica l'installazione nativa come metodo consigliato. I tre comandi sono quelli all'inizio di questa pagina: per macOS, Linux e WSL usa la riga install.sh, per Windows PowerShell irm … | iex, per Windows CMD la riga install.cmd. L'installazione nativa si aggiorna automaticamente in background alla versione più recente; la documentazione ufficiale specifica inoltre che le installazioni tramite Homebrew e WinGet non si aggiornano automaticamente per impostazione predefinita.

Dopo l'installazione, apri una nuova finestra del terminale (le finestre già aperte non rilevano il nuovo PATH), quindi verifica:

claude --version   # 正常会打印版本号，后面跟着 (Claude Code)
claude doctor      # 只读的安装与设置诊断，不会开启会话

claude doctor non avvia una sessione: mostra solo lo stato dell'installazione e le informazioni diagnostiche dei file di configurazione, aiutando a distinguere un problema di installazione da un problema di configurazione.

In caso di errore durante il download

Se nel terminale compare syntax error near unexpected token '<' o curl: (22) The requested URL returned error: 403, secondo la documentazione ufficiale per la risoluzione dei problemi di installazione (verificata 3 ottobre 2026), significa che l’indirizzo di installazione ha restituito una pagina web o un codice di stato di errore, anziché lo script di installazione. Se la pagina restituita riporta App unavailable in region, la spiegazione ufficiale è che Claude Code non è disponibile nel paese o nella regione in cui ti trovi. Anche un errore 403 senza contenuto web può dipendere dal blocco del download da parte di un proxy aziendale o di un firewall; per gli errori 403 che si verificano comunque in una regione supportata, la procedura ufficiale consigliata è controllare prima la connessione di rete e poi valutare altri metodi di installazione.

Metodo 2: installazione npm (richiede Node.js 22 o superiore)

npm è ancora uno dei metodi di installazione elencati nella documentazione ufficiale. La documentazione specifica che il pacchetto npm richiede Node.js 22 o versioni successive; se la versione è più vecchia, npm stampa un avviso EBADENGINE ma l’installazione non fallisce e viene completata comunque, perché il pacchetto scarica un programma nativo che non dipende da Node.js in fase di esecuzione. Se non hai Node.js, installa la versione 22 o successiva dal sito ufficiale di Node.js.

node -v                                    # 需要 v22 或更高
npm install -g @anthropic-ai/claude-code   # 不要加 sudo

La documentazione ufficiale indica chiaramente di non usare sudo npm install -g, perché può causare problemi di autorizzazioni e rischi di sicurezza. Per aggiornare usa npm install -g @anthropic-ai/claude-code@latest, non npm update -g.

Quando il download dal registry predefinito fallisce o è molto lento: npmmirror

Se il download dal registry npm predefinito non riesce o è molto lento, si può usare npmmirror. La home page di npmmirror (verificata 3 ottobre 2026) lo descrive come «una mirror completa di npmjs.com», in sola lettura, che «cerca di sincronizzarsi in tempo reale con il servizio ufficiale», e riporta l’indirizzo del registry e i comandi di configurazione. La home page non specifica la frequenza di sincronizzazione.

# 只在这一次安装时使用 npmmirror
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 或者把 npmmirror 设为 npm 的默认源（之后所有 npm 安装都会走它）
npm config set registry https://registry.npmmirror.com

# 以后升级用 @latest，不要用 npm update -g
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com

L'installazione di Claude Code tramite mirror presenta due condizioni facili da trascurare, entrambe indicate nella documentazione ufficiale per la risoluzione dei problemi:

• Il mirror deve fornire contemporaneamente 8 pacchetti per piattaforma. Il pacchetto npm è solo un involucro; il programma vero viene scaricato come dipendenza opzionale sotto forma di pacchetti @anthropic-ai/claude-code-* per piattaforma. Se il mirror ne è privo, dopo l'installazione l'esecuzione di claude su macOS o Linux mostra claude native binary not installed (su Windows PowerShell o CMD segnala invece che il file non può essere eseguito). Il 3 ottobre 2026, verificando da una rete al di fuori della Cina continentale, Kunavo ha rilevato che il pacchetto principale su npmmirror e i pacchetti Windows x64, macOS ARM64 e Linux x64 coincidono con le versioni più recenti di npmjs; gli altri pacchetti (Windows ARM64, Mac Intel, Linux ARM64 e le due versioni musl) non sono stati verificati.
• Non saltare le dipendenze opzionali. Non aggiungere --omit=optional al comando di installazione e verifica che in .npmrc non sia impostato optional=false.

Sezione specifica per Windows

Windows dispone di due comandi di installazione diversi; cambia solo il terminale aperto. Il prompt con PS C:\Users\你的用户名> è PowerShell; quello senza PS e con solo C:\Users\你的用户名> è il Prompt dei comandi (CMD). La documentazione ufficiale specifica che l'installazione non richiede l'esecuzione come amministratore.

Un errore comune su Windows consiste nell'incollare il comando nel terminale sbagliato: eseguendo la riga CMD in PowerShell viene visualizzato The token '&&' is not a valid statement separator; eseguendo la riga PowerShell in CMD viene visualizzato 'irm' is not recognized as an internal or external command. In entrambi i casi, usa la riga corrispondente. Nel menu Start sono presenti «Windows PowerShell» e «Windows PowerShell (x86)»; quest'ultimo è un processo a 32 bit e mostra Claude Code does not support 32-bit Windows, quindi apri quello senza (x86).

Git for Windows è facoltativo: se installato, Claude Code usa Git Bash, incluso nel pacchetto, per eseguire i comandi; altrimenti usa gli strumenti di PowerShell. Se è installato ma Git Bash non viene trovato, nella sezione env di ~/.claude/settings.json imposta CLAUDE_CODE_GIT_BASH_PATH in modo che punti a bash.exe. Il percorso riportato nell’esempio ufficiale è C:\Program Files\Git\bin\bash.exe.

Se scegli WSL, esegui la riga per macOS/Linux nel terminale WSL e avvia claude anch'esso in WSL, non in PowerShell o CMD.

Errore della policy di esecuzione nel percorso npm

Quando installi o esegui npm in PowerShell e visualizzi npm.ps1 cannot be loaded because running scripts is disabled on this system, la policy di esecuzione di PowerShell ha bloccato lo script di avvio .ps1 generato da npm. La documentazione ufficiale offre tre soluzioni: consentire all'utente corrente di eseguire script locali (la riga seguente); usare npm.cmd e claude.cmd; oppure usare il comando di installazione nativo di PowerShell.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Dopo l'installazione viene indicato che claude non è stato trovato

La comparsa di command not found: claude o 'claude' is not recognized indica che la directory di installazione non è nel PATH. L'installazione nativa colloca il programma in ~/.local/bin/claude su macOS/Linux e in %USERPROFILE%\.local\bin\claude.exe su Windows. Prima apri un nuovo terminale e riprova; se su Windows il problema persiste, usa PowerShell secondo la documentazione ufficiale per verificare e aggiungere il PATH dell'utente:

# 1. 检查安装目录是否已在 PATH 里
$env:PATH -split ';' | Select-String '\.local\\bin'

# 2. 没有任何输出时，把它加进「用户」PATH，然后关掉终端重新打开
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# 3. 重新打开终端后确认
claude --version

Configurazione della chiave API: senza accedere a un account Claude

ANTHROPIC_BASE_URL è una variabile d'ambiente integrata in Claude Code; la documentazione ufficiale la descrive come un modo per sovrascrivere l'endpoint API e far passare le richieste tramite un proxy o un gateway. Indirizzare Claude Code a un endpoint che fornisce l'API Anthropic Messages è quindi una configurazione ufficialmente supportata, senza plugin o programmi modificati. Su macOS/Linux inseriscila nel file di configurazione della shell:

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # 只写到域名，不要加 /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

Per prima cosa, su Windows puoi provarla in una finestra PowerShell:

# 只对当前 PowerShell 窗口有效，关掉窗口就失效
$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 l'uso continuativo, è consigliabile inserirla nel campo env del file di configurazione a livello utente ~/.claude/settings.json (su Windows è %USERPROFILE%\.claude\settings.json). In questo modo ogni terminale e attività in background può leggerla; se il file contiene già altre impostazioni, integra 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"
  }
}

Ognuna di queste sei righe presenta un punto facile da configurare erroneamente:

• ANTHROPIC_BASE_URL deve contenere solo il dominio. Claude Code aggiunge automaticamente /v1/messages; se aggiungi anche /v1, diventa /v1/v1/messages e restituisce 404.
• Usa ANTHROPIC_AUTH_TOKEN, non ANTHROPIC_API_KEY. La documentazione ufficiale specifica che il valore di ANTHROPIC_AUTH_TOKEN viene inviato come intestazione Authorization e riceve automaticamente il prefisso Bearer; diventa effettivo immediatamente. ANTHROPIC_API_KEY invece richiede una conferma iniziale in modalità interattiva; se viene rifiutato, la chiave viene ignorata silenziosamente in seguito (riattivala in Use custom API key di /config).
• ANTHROPIC_MODEL determina il modello principale. Qui è fissato su Claude Sonnet 5 (claude-sonnet-5). Il nome del modello deve corrispondere esattamente all'elenco dei modelli Kunavo; i vecchi nomi con suffisso di data non vengono associati automaticamente.
• ANTHROPIC_DEFAULT_OPUS_MODEL determina l’alias opus. Secondo la documentazione ufficiale sulla configurazione dei modelli (verificata 3 ottobre 2026), il modello predefinito per gli utenti API e l’alias opus puntano all’ultima versione di Opus (attualmente Opus 5.5), mentre l’alias sonnet punta a Sonnet 5.5. Gli alias seguono le nuove versioni rilasciate da Anthropic. La documentazione ufficiale specifica che gli alias «si aggiornano nel tempo»; per fissare una versione, indicare il nome completo del modello o impostare una variabile come ANTHROPIC_DEFAULT_OPUS_MODEL. Kunavo al momento non offre Sonnet 5.5 e, quando Anthropic pubblicherà una nuova versione di Opus, Kunavo potrebbe non averla ancora resa disponibile; i modelli non disponibili restituiranno un errore 404. Per questo è necessario fissare il modello principale e gli alias opus e sonnet. Qui l’alias opus è fissato a Claude Opus 5.5 (claude-opus-5-5). È necessario Claude Code v2.1.280 o successivo; per aggiornare una versione precedente, eseguire prima claude update.
• ANTHROPIC_DEFAULT_SONNET_MODEL determina l'alias sonnet. La documentazione ufficiale specifica che questa variabile determina a quale modello punta l'alias sonnet e quale modello usa opusplan al di fuori della modalità di pianificazione (nella fase di esecuzione). Per impostazione predefinita, l'alias sonnet richiede Sonnet 5.5, che Kunavo attualmente non offre; se non imposti questa riga, le fasi di esecuzione di /model sonnet e opusplan e i subagenti che specificano model: sonnet restituiscono 404. Anche qui è fissato su Claude Sonnet 5 (claude-sonnet-5).
• ANTHROPIC_DEFAULT_HAIKU_MODEL determina l'alias haiku. L'alias haiku richiede un ID modello che Kunavo non offre: Haiku 5.5 dalla v2.1.293 in poi, e nelle versioni precedenti un ID Haiku 4.5 con suffisso di data. Se questa riga non è impostata, /model haiku e i subagenti configurati con model: haiku (compreso claude-code-guide, avviato da Claude Code stesso) restituiscono 404. Imposta qui claude-haiku-4-5.
• ANTHROPIC_DEFAULT_HAIKU_MODEL gestisce anche le attività in background. La documentazione ufficiale specifica che questa variabile determina l'alias haiku e viene usata anche dalle funzioni in background. In Kunavo Claude Haiku 4.5 costa per milione di token di input $0,70 e di output $3,50; il modello principale Claude Sonnet 5 costa $1,40 / $7,00(prezzo ufficiale Anthropic: $2,00 / $10,00); il modello Claude Opus 5.5 associato all'alias opus costa $2,80 / $14,00.

Non inserire la chiave nel .claude/settings.json del progetto: la documentazione ufficiale avverte che questo file viene sottoposto a commit e condiviso con chiunque cloni il repository. Tieni inoltre presente una regola di priorità: quando la stessa variabile è impostata nella shell e nel file settings, prevale il valore del file settings. Se una modifica alla variabile della shell non ha effetto, controlla prima il file settings.

Che cosa accade al primo avvio

Secondo la documentazione ufficiale sulla connessione ai gateway (verificata 3 ottobre 2026), dopo aver impostato ANTHROPIC_AUTH_TOKEN ed eseguito claude, si accede direttamente alla sessione: la pagina di accesso non viene visualizzata. Questa variabile ha effetto immediato, a differenza di ANTHROPIC_API_KEY, per la quale è prima necessaria una conferma. Se si apre una pagina di accesso, significa che Claude Code non ha letto le credenziali.

Le credenziali devono trovarsi in un punto che Claude Code legge prima della configurazione iniziale: export nella shell oppure env del file utente ~/.claude/settings.json. La documentazione ufficiale specifica che, in modalità interattiva, env di .claude/settings.json o .claude/settings.local.json nel progetto diventano effettivi solo dopo la procedura guidata iniziale e la richiesta di attendibilità della cartella; pertanto, se la chiave è nelle impostazioni a livello di progetto, al primo avvio verrà comunque mostrata la pagina di accesso.

Dopo essere entrato nella sessione, esegui /status e controlla due righe nella pagina Status:

• Anthropic base URL: appare solo quando è impostato l'indirizzo del gateway e dovrebbe mostrare https://api.kunavo.com. Se questa riga manca, significa che ANTHROPIC_BASE_URL non è stato trasmesso a questa sessione.
• Auth token: la presenza di ANTHROPIC_AUTH_TOKEN indica che stai usando una chiave API, non un accesso claude.ai salvato. Se visualizzi Login method insieme a un account claude.ai, la variabile non ha avuto effetto.

Per testare separatamente indirizzo e chiave prima di aprire Claude Code, puoi inviare, come nella documentazione ufficiale, una richiesta con un solo token di output (verrà detratta dal saldo una somma minima in base ai token utilizzati). Il comando legge le variabili della shell, quindi anche se hai inserito la chiave nel file settings devi prima eseguire export nel terminale corrente. Un JSON che inizia con {"id":"msg_ indica che indirizzo e chiave funzionano; 401 indica che la chiave non è stata riconosciuta.

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

Che cosa cambia usando una chiave API

• Remote Control e l'input vocale non sono disponibili. La documentazione ufficiale specifica che entrambe dipendono dall'identità claude.ai e non sono disponibili quando è impostato ANTHROPIC_AUTH_TOKEN; se ANTHROPIC_BASE_URL punta a un indirizzo non Anthropic, anche Remote Control viene disattivato.
• /fast mostra che la modalità fast è disattivata. La documentazione ufficiale specifica che, con un bearer token, Claude Code considera direttamente disattivata la modalità fast e non invia controlli di disponibilità.
• La ricerca degli strumenti MCP è disattivata per impostazione predefinita. La documentazione ufficiale specifica che, quando ANTHROPIC_BASE_URL punta a un indirizzo non Anthropic, la ricerca degli strumenti MCP è disattivata per impostazione predefinita.
• /context mostra una stima locale. Al momento Kunavo non fornisce /v1/messages/count_tokens. Secondo la documentazione ufficiale sulla compatibilità dei gateway (verificata 3 ottobre 2026), se il gateway non dispone di questo endpoint, Claude Code stima i token in base ai caratteri e il valore mostrato da /context è approssimativo.

Per le istruzioni complete di integrazione, consulta la documentazione di integrazione di Claude Code (in inglese).

Che cosa disattiva esattamente CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

Secondo la documentazione ufficiale sulle variabili d’ambiente (verificata 3 ottobre 2026), questa variabile disattiva il traffico di rete non essenziale di Claude Code. I contenuti elencati ufficialmente sono:

• Aggiornamenti automatici, telemetria e segnalazioni di errori;
• Il comando /feedback e il feedback redatto da Claude;
• Note di rilascio e controllo dei badge di stato PR/MR;
• Controlli di disponibilità come la modalità fast;
• Recupero dei flag delle funzionalità, quindi Remote Control e altre funzioni dipendenti dai flag non saranno disponibili;
• Riesecuzione in background dell'origine del plugin command (si tratta di un comando locale, non di traffico di rete, perché può attivare l'installazione di dipendenze).

Altri dettagli indicati ufficialmente: impostare 0 o false equivale comunque ad attivare la funzione; diversamente dalla maggior parte delle variabili di attivazione, solo rimuovendo la variabile si ripristina il comportamento. L'installazione automatica dal marketplace ufficiale dei plugin non rientra nel suo ambito; non influisce sulla scoperta dei modelli del gateway. La documentazione ufficiale del gateway aggiunge che non influisce sul controllo di sicurezza del dominio dello strumento WebFetch, che continua ad accedere a api.anthropic.com; per disattivarlo devi aggiungere skipWebFetchPreflight: true nelle impostazioni. La documentazione ufficiale non descrive questa variabile come un'impostazione legata ai controlli di rischio dell'account.

Kunavo non richiede questa variabile e non influisce sulle richieste del modello inviate a Kunavo. La documentazione ufficiale sulla connessione ai gateway (verificata 3 ottobre 2026) descrive una situazione in cui può essere utile attivarla: anche quando ANTHROPIC_BASE_URL punta al gateway, Claude Code continua a inviare richieste in background ad Anthropic, GitHub e altri servizi di terze parti, per esempio per controllare gli aggiornamenti di versione, inviare dati di telemetria e recuperare le note di rilascio. Se la rete consente l’accesso solo all’indirizzo del gateway, queste richieste falliscono e nei sistemi di monitoraggio del traffico in uscita possono apparire come connessioni bloccate. La procedura ufficiale consiste nell’impostare questa variabile insieme alla variabile del gateway.

Il costo dell'attivazione è che non ci saranno più aggiornamenti automatici; la documentazione ufficiale consiglia di predisporre un metodo alternativo per gli aggiornamenti. Per l'installazione npm, aggiorna manualmente con @latest (vedi l'ultima riga della sezione precedente su npmmirror).

# 可选：关闭 Claude Code 的非必要网络流量（会同时关闭自动更新）
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

# 想恢复时删掉这个变量；设成 0 或 false 仍然算开启
unset CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

Ricarica con Alipay o WeChat Pay e ottieni una chiave

Per gli abbonamenti web acquistati direttamente da Anthropic si accettano solo carte di credito o debito (FAQ sulla fatturazione dei piani a pagamento di Claude, verificata 3 ottobre 2026). Su Kunavo si può ricaricare tramite Alipay o WeChat Pay. Ecco una sintesi della procedura; i passaggi completi sono disponibili in Guida alla ricarica di Claude API con Alipay e WeChat Pay:

1. Registra un account Kunavo: puoi usare un indirizzo email o un account Google e non è necessario collegare una carta.
2. In Fatturazione scegli l'importo della ricarica; il minimo è $10 e non ci sono canoni mensili. Le ricariche più elevate includono un bonus: pagando $100, ricevi $110 di credito, pagando $1000, ricevi $1200 di credito e pagando $5000, ricevi $6250 di credito.
3. Nella pagina di pagamento Stripe seleziona Alipay o WeChat Pay e paga tramite codice QR. Aprendo la pagina dalla Cina continentale, gli importi vengono mostrati in RMB; fai riferimento ai numeri visualizzati nella pagina di pagamento.
4. Vai a /app/keys per creare una chiave che inizi con sk-kn- (viene mostrata una sola volta, quindi salvala subito) e inseriscila in ANTHROPIC_AUTH_TOKEN sopra.

Alipay e WeChat Pay consentono solo ricariche manuali; per la ricarica automatica è necessario collegare una carta bancaria o Link. Kunavo non emette fatture IVA cinesi; la cronologia delle ricariche è visibile nella pagina Billing.

Quanto costa indicativamente (calcolo illustrativo)

Claude Code addebita in base ai token; ogni richiesta reinvia l'intero contesto della conversazione e il prefisso identico alla richiesta precedente può essere fatturato come lettura dalla cache. Di seguito è riportato solo un calcolo illustrativo dei token, non una fattura reale né un limite di costo. Tutte le ipotesi sono elencate:

• A ogni richiesta, 40.000 token di input, di cui 36.000 (90%) fatturati come lettura dalla cache; i restanti 4.000 sono fatturati come scrittura nella cache;
• A ogni richiesta, 1.000 token di output;
• Durante un periodo di lavoro vengono inviate 50 richieste di questo tipo; non si considerano le chiamate in background di Claude Haiku 4.5;
• Prezzi Kunavo: la lettura dalla cache è pari a 10% del prezzo di input, mentre la scrittura nella cache è 1,25 volte il prezzo di input (rapporto di Claude Sonnet 5; nella tabella ogni modello viene calcolato secondo il proprio rapporto).

Il costo effettivo dipende dalla lunghezza del contesto, dalla percentuale di cache utilizzata, dalla lunghezza dell'output e dal fatto che tra un'attività e l'altra tu usi /clear per cancellare la conversazione. Per scegliere tra abbonamento Claude Code e API e stimare il costo mensile, consulta Prezzi di Claude Code; per i prezzi completi dei modelli, consulta Prezzi dell'API Claude e la pagina dei prezzi; per una stima basata sul tuo utilizzo, usa il calcolatore del costo dei token Claude (in inglese).

Confronto degli errori comuni

Limiti da conoscere

• Kunavo non emette fatture IVA cinesi.
• Alipay e WeChat Pay consentono solo ricariche manuali; per la ricarica automatica è necessario collegare una carta bancaria o Link.
• Questa è un'API con addebito a token, non un abbonamento Claude Pro/Max; usando una chiave API, Remote Control e l'input vocale non sono disponibili. Per scegliere tra le due opzioni, consulta Prezzi di Claude Code.
• Kunavo non ha effettuato test di connettività di rete nella Cina continentale. Devi verificare personalmente se gli indirizzi di installazione di claude.ai, i registry npm, npmmirror e api.kunavo.com sono accessibili dalla tua rete e con quale velocità.
• L'elenco dei Paesi e delle aree supportati da Anthropic (verificato il 3 ottobre 2026) non include Cina continentale, Hong Kong e Macao; la documentazione ufficiale per l'installazione di Claude Code include l'area geografica tra i requisiti di sistema.

Domande frequenti