Come installare Claude Code [Windows/Mac] — configurazione dell’API key senza abbonamento e pagamenti con JCB e Apple Pay

L'installazione di Claude Code consiste nell'eseguire una sola riga dell'installer nativo ufficiale. Per Mac, Linux e WSL usa install.sh; su Windows usa install.ps1 in PowerShell o install.cmd in CMD (npm è un'alternativa, ma richiede Node.js 22 o superiore). Di norma, dopo l'installazione si accede con un piano Pro, Max o simile; senza abbonamento, imposta ANTHROPIC_BASE_URL=https://api.kunavo.com (senza aggiungere /v1), ANTHROPIC_AUTH_TOKEN con la chiave API e le quattro variabili per fissare i modelli, così puoi avviare Claude Code senza effettuare il login. Verifica il funzionamento con /status. Il saldo API può essere ricaricato in anticipo a partire da $10 usando carte come JCB oppure Apple Pay, Google Pay e Link; la pagina di pagamento mostra gli importi in yen.

# 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

Le fonti primarie per l’installazione sono la documentazione ufficiale di Anthropic disponibile in giapponese (Configurazione, Risoluzione dei problemi di installazione, verificata il 3 ottobre 2026). Questa pagina non si limita a riproporne i contenuti: si concentra sulle discrepanze negli articoli esplicativi in giapponese (versione di Node.js, privilegi di amministratore e Git su Windows) e sugli argomenti non trattati dalla documentazione ufficiale: configurazione per usare una chiave API senza accedere e modalità di pagamento dal Giappone. Le informazioni su prezzi e metodi di pagamento sono aggiornate al 10 ottobre 2026. Il Giappone figura nell’elenco dei Paesi supportati da Anthropic sia per Claude.ai sia per l’API (verificato il 3 ottobre 2026).

Da decidere prima: accesso con abbonamento o utilizzo con chiave API

L'installazione è identica in entrambi i casi; la differenza emerge dopo il primo avvio. All'avvio Claude Code richiede l'autenticazione. Se sei indeciso, puoi decidere in base a questi 3 punti:

• Hai già un abbonamento Pro, Max, Team o Enterprise oppure un account Console: accedi direttamente e potrai usarlo. Non ti serve configurare la chiave API descritta in questa pagina. Il piano gratuito non include Claude Code.
• Non vuoi pagare una tariffa fissa mensile e il tuo utilizzo varia molto da un mese all’altro: fa al caso tuo l’API con chiave, per cui paghi solo i token utilizzati. Per riferimento, l’abbonamento Claude costa $20 al mese per Pro ($200 con pagamento annuale, pari a $17 al mese) e da $100 al mese per Max; i prezzi non includono le imposte (pagina dei prezzi di Claude, verificata il 3 ottobre 2026). Il costo di Claude Code stima il punto in cui una delle due opzioni diventa più conveniente.
• Vuoi usare Remote Control o l'input vocale: entrambi richiedono un account claude.ai e non sono disponibili con una chiave API. Scegli l'accesso.

Anche i metodi di pagamento sono diversi. Per gli abbonamenti sottoscritti sul sito di Anthropic si accettano solo carte di credito o di debito; se li sottoscrivi dall’app per iPhone o Android, il pagamento è gestito da App Store o Google Play (assistenza Anthropic, in inglese, verificata il 3 ottobre 2026). Il saldo API di Kunavo si ricarica con carte, incluse JCB, Apple Pay, Google Pay e Link (maggiori dettagli nella sezione sui pagamenti più avanti).

Controlli prima dell'installazione

I requisiti sono quelli della documentazione ufficiale (verificata il 3 ottobre 2026). La colonna a destra indica come verificarli sul tuo dispositivo.

Quale metodo utilizzare

La documentazione ufficiale indica l'installer nativo come metodo «consigliato». La differenza principale rispetto agli altri metodi riguarda gli aggiornamenti.

# Homebrew（既定では自動更新されない）
brew install --cask claude-code

# WinGet（Windows・既定では自動更新されない）
winget install Anthropic.ClaudeCode

Con qualsiasi metodo, al termine riapri il terminale e verifica. Le finestre aperte prima dell'installazione potrebbero non aver caricato il nuovo PATH. claude doctor mostra solo lo stato dell'installazione e della configurazione senza avviare una sessione, quindi è utile per isolare i problemi.

claude --version   # 2.1.211 (Claude Code) のようなバージョン番号が出れば OK
claude doctor      # セッションを開かずに、インストールと設定を診断する

Note per l'installazione con npm

Negli articoli esplicativi in giapponese si trova ancora spesso l’indicazione «Node.js 18 o successivo», ma il requisito della documentazione ufficiale è Node.js 22 o successivo (documentazione ufficiale, verificata il 3 ottobre 2026). Con una versione precedente di Node.js, npm mostra solo l’avviso EBADENGINE e non interrompe l’installazione; anche claude si avvia, ma è più sicuro aggiornare Node.js quando compare l’avviso. Se usi strumenti come nvm o Volta per gestire le versioni, controlla node -v nella shell in cui esegui l’installazione.

node -v                                    # v22 以上であること
npm install -g @anthropic-ai/claude-code   # sudo は付けない

# 更新は @latest で（npm update -g は使わない）
npm install -g @anthropic-ai/claude-code@latest

La documentazione ufficiale specifica di non usare sudo npm install -g. Inoltre, poiché il binario principale viene installato come dipendenza opzionale, se --omit=optional oppure optional=false di .npmrc esclude le dipendenze opzionali, su Mac e Linux l'avvio fallisce mostrando claude native binary not installed.

Aspetti importanti per l'installazione su Windows

Per prima cosa, due passaggi che si trovano spesso online non sono necessari. «Avvia PowerShell come amministratore» e «installa prima Git for Windows» non sono requisiti della documentazione ufficiale. Non servono privilegi di amministratore e Git for Windows è facoltativo; se non è installato, Claude Code esegue i comandi in PowerShell (Configurazione su Windows, verificata il 3 ottobre 2026).

Prima di incollare il comando, verifica solo due aspetti.

1. Stai usando PowerShell o CMD?Se il prompt è PS C:\Users\ユーザー名>, usa la riga irm per PowerShell; se è PS senza C:\Users\ユーザー名>, usa la riga install.cmd per CMD. Se li confondi, in PowerShell riceverai un errore perché && non viene riconosciuto come separatore, mentre in CMD riceverai un errore perché irm non viene riconosciuto (su Windows in giapponese, il messaggio può essere visualizzato in giapponese).
2. Non hai aperto «Windows PowerShell (x86)»?La versione (x86) visualizzata nel menu Start è un processo a 32 bit, quindi anche su un computer a 64 bit si interrompe con Claude Code does not support 32-bit Windows.

Su Windows ci sono 3 modi per eseguirlo. Se non sai quale scegliere, puoi iniziare con il metodo nativo.

Se hai installato Git for Windows ma Claude Code non riesce a trovare Git Bash, nel file delle impostazioni utente, in env, indica in CLAUDE_CODE_GIT_BASH_PATH il percorso di bash.exe.

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Quando claude non funziona nonostante l'installazione

'claude' is not recognized (su Mac/Linux command not found: claude) indica che la directory di installazione non è inclusa in PATH. Il percorso dell'installer nativo è %USERPROFILE%\.local\bin\claude.exe su Windows e ~/.local/bin/claude su Mac/Linux. Se non si risolve riaprendo il terminale, verifica e aggiungi il percorso da PowerShell seguendo la procedura nella documentazione ufficiale.

# 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

Se dopo l’installazione con npm compare npm.ps1 cannot be loaded because running scripts is disabled on this system (o claude.ps1 all’avvio), significa che i criteri di esecuzione di PowerShell bloccano lo script .ps1 di npm (documentazione ufficiale, verificata il 3 ottobre 2026). Puoi risolvere con il comando seguente, che consente l’esecuzione degli script locali solo per l’utente corrente. Se non vuoi modificare i criteri, usa npm.cmd e claude.cmd, oppure passa al programma di installazione nativo per PowerShell.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Configurazione per usare una chiave API senza effettuare l'accesso

Kunavo è un gateway API indipendente, non Anthropic, che offre accesso prepagato alle API di modelli come Claude. Claude Code include ufficialmente la variabile ANTHROPIC_BASE_URL per cambiare la destinazione delle richieste; la documentazione ufficiale ha anche una pagina intitolata «Connettere Claude Code a un gateway LLM». Non servono plugin né versioni modificate. Questa variabile cambia solo la destinazione: un’altra variabile determina quale modello risponde (Configurazione del modello, verificata il 3 ottobre 2026).

È necessario configurare i 6 elementi seguenti.

Su Mac/Linux, aggiungile al file di configurazione della shell (~/.zshrc o ~/.bashrc) e riapri il terminale.

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 una prova su Windows, esegui quanto segue nella finestra di PowerShell. Le impostazioni scompaiono quando chiudi la finestra.

# このウィンドウの中だけで有効（閉じると消える）
$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 non vuoi inserirle ogni volta, scrivile nel file delle impostazioni utente ~/.claude/settings.json (%USERPROFILE%\.claude\settings.json su Windows), nel blocco env. Si applicano a tutti i progetti e la sintassi è la stessa su Mac e Windows. Se il file contiene già altre impostazioni, aggiungi 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"
  }
}

Ci sono 3 aspetti importanti sulla posizione in cui inserirle.

• Non inserire la chiave in .claude/settings.json del progetto: non scriverla. Verrebbe inclusa nel repository e condivisa con chiunque lo cloni (documentazione ufficiale).
• Se la stessa variabile è presente sia nella shell sia nel file delle impostazioni, viene usato il valore del file. Se non cambia neppure dopo aver eseguito nuovamente export, controlla il file delle impostazioni.
• Per usarla con l'estensione VS Code, inserisci le stesse variabili in claudeCode.environmentVariables nelle impostazioni utente di VS Code.

Perché usare ANTHROPIC_AUTH_TOKEN

ANTHROPIC_AUTH_TOKEN viene inviato nell'header Authorization: Bearer ed è attivo appena viene configurato. ANTHROPIC_API_KEY, invece, viene inviato nell'header x-api-key e, nella modalità interattiva, alla prima esecuzione viene richiesta una volta l'autorizzazione a usarlo. Se rifiuti, la chiave viene ignorata senza ulteriori messaggi e non viene usata finché non la riattivi con /config Use custom API key. Kunavo accetta le chiavi inviate con entrambi gli header, quindi funziona anche con ANTHROPIC_API_KEY, ma ANTHROPIC_AUTH_TOKEN è più affidabile perché evita questo problema. Anche la documentazione ufficiale consiglia di usare ANTHROPIC_AUTH_TOKEN quando non viene specificato il tipo di chiave.

Perché fissare il modello (al 3 ottobre 2026)

Secondo la documentazione ufficiale (verificata il 3 ottobre 2026), quando usi una chiave API, il modello predefinito e l’alias opus indicano Opus 5.5, mentre l’alias sonnet indica Sonnet 5.5. La destinazione degli alias cambia con l’uscita di nuovi modelli, che però potrebbero non essere disponibili su Kunavo dal giorno del lancio. Infatti, al 3 ottobre 2026, Kunavo non offre Sonnet 5.5: se non fissi un modello e scegli /model sonnet, ricevi un errore 404. Lo stesso vale per la fase di esecuzione di opusplan e per i subagenti configurati con model: sonnet. Per questo, la configurazione sopra fissa anche l’alias sonnet tramite ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5. Anche l’alias opus è fissato su Claude Opus 5.5 tramite ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5, così da non avere problemi se in futuro passa al modello Opus successivo. Claude Opus 5.5 richiede Claude Code v2.1.280 o successivo; se hai una versione meno recente, aggiornala con claude update.

Fissare il modello aiuta anche a prevedere i costi. Se non specifichi nulla, il modello predefinito diventa Claude Opus 5.5 e il costo per token aumenta rispetto a quando usi Claude Sonnet 5 come modello principale. Le tariffe di Kunavo (per 1 milione di token, input / output) sono: Claude Haiku 4.5, $0,70 / $3,50; Claude Sonnet 5, $1,40 / $7,00(I prezzi Anthropic sono $2,00 / $10,00); Claude Opus 5.5, $2,80 / $14,00. Se non imposti ANTHROPIC_DEFAULT_HAIKU_MODEL, nelle sessioni avviate con ANTHROPIC_AUTH_TOKEN anche le attività in background, come i riepiloghi delle conversazioni per claude --resume, vengono eseguite con il modello principale (guida alla compatibilità del gateway, verificata il 3 ottobre 2026). La pagina dei prezzi di Anthropic ha spostato Sonnet 5, fissato qui come modello principale, nella sezione «Modelli legacy» (verificata il 3 ottobre 2026).

Verifica del funzionamento in 3 fasi

1. Prima dell'avvio, prova solo URL e chiave

È una richiesta con un solo token di output, come nella documentazione ufficiale (viene detratto un importo minimo dal saldo). Poiché legge le variabili della shell, se hai scritto la chiave solo nel file delle impostazioni, esegui export in questo terminale prima di procedere. Se vengono restituiti un JSON che inizia con {"id":"msg_ e il codice 200, URL e chiave sono corretti; con 401 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": "."}]}'

In PowerShell, la procedura è la seguente: se il valore restituito di id inizia con msg_, la verifica è riuscita.

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

2. Avvia claude e verifica che non venga visualizzata la schermata di accesso

Al primo avvio vengono visualizzati la procedura guidata iniziale e la richiesta di attendibilità della cartella, ma in seguito non viene richiesto l'accesso tramite browser. Se viene richiesto di accedere, la chiave non è stata ricevuta.

Una causa comune è aver scritto la chiave solo in .claude/settings.json o .claude/settings.local.json del progetto. Nelle sessioni interattive, env delle impostazioni del progetto viene caricato dopo il completamento della procedura guidata e della verifica di attendibilità della cartella, quindi al primo avvio la chiave viene considerata assente. Spostala in export della shell o in ~/.claude/settings.json dell'utente.

3. Controlla le 2 righe di /status

Nella sessione, esegui /status e controlla la scheda Status (documentazione ufficiale, verificata il 3 ottobre 2026).

• In Anthropic base URL deve comparire https://api.kunavo.com. Questa riga appare solo quando il gateway è configurato, quindi se la riga non esiste, ANTHROPIC_BASE_URL non è arrivato alla sessione.
• In Auth token deve comparire ANTHROPIC_AUTH_TOKEN. Se invece compare Login method dell'account claude.ai, significa che sta funzionando con l'accesso salvato.

Cosa cambia quando si usa una chiave API

• Remote Control e input vocale non sono disponibili.Entrambi presuppongono un ID claude.ai, quindi sono disabilitati mentre sono attive credenziali del gateway come ANTHROPIC_AUTH_TOKEN. Dalla versione v2.1.196, Remote Control viene disabilitato semplicemente perché ANTHROPIC_BASE_URL punta a un host diverso da Anthropic.
• Viene visualizzato che /fast è disabilitato.Quando l'autenticazione usa solo un bearer token, Claude Code lo considera disabilitato senza verificare se la modalità veloce sia disponibile e visualizza Fast mode has been disabled by your organization.
• I valori mostrati da /context sono approssimativi. Kunavo non offre /v1/messages/count_tokens, quindi Claude Code passa a una stima basata sul numero di caratteri (guida alla compatibilità del gateway, verificata il 3 ottobre 2026).

Le impostazioni dettagliate lato Kunavo sono disponibili nella documentazione sull'integrazione di Claude Code e nella documentazione di ANTHROPIC_BASE_URL (entrambe in inglese).

Pagamento del saldo API: JCB, Apple Pay, Google Pay, Link

Riassumiamo innanzitutto gli aspetti chiesti più spesso per i pagamenti dal Giappone.

La procedura prevede 4 passaggi. Per prima cosa, registrati su Kunavo (con un indirizzo email o un account Google. Durante la registrazione non vengono richiesti i dati della carta). Poi scegli l’importo della ricarica nella sezione Billing della dashboard. L’importo minimo è $10, non sono previsti canoni mensili e gli importi più elevati includono un bonus ($100 per un saldo di $110, $1.000 per un saldo di $1.200 e $5.000 per un saldo di $6.250). Nella schermata di pagamento di Stripe, scegli uno dei metodi indicati sopra e completa il pagamento. Infine, nella sezione API Keys, crea una chiave sk-kn- e inseriscila in ANTHROPIC_AUTH_TOKEN. La chiave viene mostrata una sola volta, al momento della creazione, quindi copiala subito.

Il saldo non ha scadenza e le richieste non riuscite non vengono addebitate. I metodi disponibili in Giappone per pagare un abbonamento Claude (inclusi i pagamenti tramite App Store/Google Play) sono riepilogati con le fonti in Metodi di pagamento di Claude.

Stima dei costi (calcolo indicativo)

Claude Code eseguito con una chiave API applica una tariffa a consumo per token. A ogni richiesta, Claude Code invia l'intero contesto della conversazione, ma la parte iniziale identica alla richiesta precedente può essere addebitata alla tariffa di lettura della cache. La tabella seguente è calcolata ipotizzando 40.000 token di input per richiesta (di cui 36.000 = 90% per la lettura della cache e i restanti 4.000 per la scrittura nella cache), 1.000 token di output e 50 richieste per un'attività. Non include le chiamate Claude Haiku 4.5 in background. Per Kunavo, nel caso di Claude Sonnet 5, la lettura costa 10% della tariffa di input e la scrittura costa 1,25 volte la tariffa di input (ogni modello nella tabella è calcolato con il relativo rapporto). Non rappresenta né valori misurati né un limite massimo.

L'importo effettivo varia in base alla lunghezza del contesto, all'efficacia della cache, alla lunghezza della risposta e al fatto che si esegua o meno /clear per ogni attività. Le tariffe di tutti i modelli sono disponibili nella pagina dei prezzi; per una stima basata sul proprio utilizzo, consultare il calcolatore dei costi dei token di Claude (in inglese); le tariffe API per modello sono disponibili in Prezzi dell'API Claude.

Errori comuni e relative soluzioni

Casi in cui questo metodo non è adatto

• È obbligatoria una fattura conforme per il rimborso spese.Il checkout Kunavo non emette né fatture né fatture conformi con numero di registrazione.
• Vuoi pagare presso un minimarket o con PayPay.Nessuno dei due è supportato, così come non lo sono i bonifici bancari o i pagamenti tramite operatore. La ricarica automatica è disponibile solo con una carta salvata o con Link.
• Vuoi usare Remote Control o l'input vocale.Non sono disponibili con una chiave API e anche /fast viene visualizzato come disabilitato. Accedi con un abbonamento.
• Vuoi usare Sonnet 5.5. Kunavo non lo offre al 3 ottobre 2026.
• Vuoi completare la configurazione usando solo documentazione in giapponese.La documentazione ufficiale del prodotto Claude Code è disponibile in giapponese, ma la documentazione sull'integrazione di Kunavo è solo in inglese.

Cosa fare dopo

Dopo aver verificato con /status, avvia claude nella directory del progetto su cui lavorerai e crea innanzitutto /init con CLAUDE.md. La guida all'uso di Claude Code spiega in ordine cosa scrivere in CLAUDE.md, come ridurre le finestre di conferma e come creare comandi personalizzati.

Domande frequenti