Come installare Claude Code: comandi ufficiali per Windows, macOS e Linux, chiave API senza abbonamento, controllo con /status e pagamento con carta o Link

In breve: installa Claude Code con un solo comando ufficiale (scegli sotto la riga per macOS/Linux, PowerShell o CMD), quindi collegalo a una chiave API invece di effettuare l’accesso. Servono solo sei variabili: ANTHROPIC_BASE_URL=https://api.kunavo.com (senza /v1), ANTHROPIC_AUTH_TOKEN contenente la chiave e quattro variabili che fissano il modello. Verifica il risultato con /status. Non serve un abbonamento Pro o Max; paghi i token dal saldo prepagato a partire da $10, ricaricabile con carta (Visa, Mastercard ecc.) o Link. QRIS, GoPay, OVO e DANA non sono disponibili.

# 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.cmd

Abbiamo verificato tutti i comandi e i nomi delle variabili nella 3 ottobre 2026 della documentazione ufficiale di Claude Code. La documentazione è disponibile anche in indonesiano, compresa la pagina di installazione e la pagina sulla connessione al gateway LLM, così puoi fare un confronto autonomamente. Prezzi e metodi di pagamento di Kunavo verificati il 10 ottobre 2026.

Sei passaggi da zero all’esecuzione di Claude Code

1. Assicurati che il laptop soddisfi i requisiti e scegli: accesso all’account Claude o chiave API.
2. Esegui l’installer nativo adatto al tuo terminale.
3. Apri un nuovo terminale, verifica claude --version e correggi PATH se necessario.
4. Configura la chiave API e fissa il modello.
5. Apri la prima sessione e verifica con /status che venga utilizzata la tua chiave.
6. Ricarica il saldo con carta o Link, quindi inizia a lavorare.

Passaggio 1: verifica i requisiti, quindi scegli accesso o chiave API

Dopo l’installazione, Claude Code deve sapere chi paga. La prima opzione è accedere con un account Claude, che richiede un piano Pro, Max, Team, Enterprise o un account Console; il piano gratuito Claude.ai non include Claude Code. Secondo la pagina dei prezzi di Claude (verificata il 3 ottobre 2026), Pro costa 20 $ al mese, oppure 17 $ al mese con pagamento annuale (200 $ in anticipo), Max parte da 100 $ al mese e tutti i prezzi sono al netto delle imposte. Per gli abbonamenti acquistati sul web, Anthropic accetta solo carte di credito o di debito; quelli acquistati tramite l’app iOS o Android si pagano con l’App Store o Google Play (FAQ sulla fatturazione di Claude, verificata il 3 ottobre 2026). La procedura di accesso è illustrata nella pagina ufficiale sull’autenticazione.

La seconda opzione, descritta in dettaglio in questa guida, è la chiave API: senza abbonamento e senza schermata di accesso. Paghi per i token effettivamente utilizzati, quindi nei mesi con poco utilizzo anche il costo diminuisce. Mancano solo due funzioni legate all’account claude.ai: Remote Control e la dettatura vocale; l’elenco completo delle differenze si trova al passaggio 5.

È la prima volta che apri un terminale? Anthropic mette a disposizione una guida al terminale in indonesiano per principianti.

Passaggio 2: esegui l’installer

macOS, Linux e WSL

Incolla nel Terminale la riga install.sh all’inizio della pagina, premi Invio e attendi il completamento. Lo script viene prelevato direttamente da claude.ai, installa il programma in ~/.local/bin/claude e da quel momento Claude Code si aggiorna automaticamente in background. Nella documentazione ufficiale questo metodo è contrassegnato come “Consigliato”.

Windows: identifica prima il tuo terminale

Molti tutorial meno recenti indicano di aprire PowerShell con “Run as Administrator” e installare prima WSL. Nessuna delle due operazioni è necessaria: la documentazione ufficiale in indonesiano dichiara che l’installazione su Windows avviene da un terminale normale senza privilegi di amministratore, mentre WSL è solo un’opzione. A determinare quale comando usare è l’aspetto del prompt:

• Il prompt PS C:\Users\NamaAnda> indica PowerShell. Usa la riga irm … | iex.
• Il prompt C:\Users\NamaAnda> senza PS indica il Prompt dei comandi (CMD). Usa la riga install.cmd.
• Nel menu Start, seleziona “Windows PowerShell”, non “Windows PowerShell (x86)”. La versione x86 funziona a 32 bit e termina con Claude Code does not support 32-bit Windows, anche se il laptop è a 64 bit.

Un comando destinato al terminale sbagliato è immediatamente riconoscibile dal messaggio, ad esempio The token '&&' is not a valid statement separator (riga CMD in PowerShell) o 'irm' is not recognized as an internal or external command (riga PowerShell in CMD). In Windows in italiano il messaggio può apparire tradotto. L’elenco completo si trova nella tabella degli errori qui sotto.

Git non è obbligatorio. Se è installato Git for Windows, lo strumento Bash di Claude Code usa Git Bash; altrimenti, i comandi vengono eseguiti tramite PowerShell. Se Git è già installato ma Git Bash non viene trovato, inserisci CLAUDE_CODE_GIT_BASH_PATH nel blocco env di ~/.claude/settings.json indicando il percorso di bash.exe, per esempio C:\Program Files\Git\bin\bash.exe. Quando conviene usare WSL:

Scegli WSL? Esegui la riga install.sh all’interno del terminale WSL e apri sempre claude dallo stesso terminale WSL.

Alternative: Homebrew, WinGet o npm

Anche Homebrew e WinGet sono ufficiali, ma secondo la documentazione entrambi non si aggiornano automaticamente per impostazione predefinita. Devi aggiornarli manualmente:

# macOS lewat Homebrew (tidak update otomatis; perbarui dengan brew upgrade)
brew install --cask claude-code

# Windows lewat WinGet (tidak update otomatis; perbarui dengan winget upgrade)
winget install Anthropic.ClaudeCode

npm è ancora documentato, a condizione di avere Node.js 22 o versioni successive (scaricalo da nodejs.org). Con le versioni precedenti di Node.js, npm mostra solo un avviso EBADENGINE e continua l’installazione, perché in realtà questo pacchetto scarica un programma nativo che non dipende da Node.js durante l’esecuzione.

node -v                                    # harus v22 ke atas
npm install -g @anthropic-ai/claude-code   # jangan pakai sudo

# memperbarui ke versi terbaru
npm install -g @anthropic-ai/claude-code@latest

Tre pratiche che compromettono l’installazione tramite npm: usare sudo npm install -g (la documentazione lo indica come fonte di problemi di autorizzazioni e rischi per la sicurezza), aggiornare con npm update -g invece di @latest e disattivare le dipendenze facoltative tramite --omit=optional o optional=false in .npmrc. Quest’ultima impostazione impedisce di scaricare il pacchetto @anthropic-ai/claude-code-* per la tua piattaforma, quindi su macOS o Linux claude restituisce claude native binary not installed.

In PowerShell, npm a volte si blocca su npm.ps1 cannot be loaded because running scripts is disabled on this system. Si tratta dell’execution policy che blocca gli script .ps1. La documentazione indica tre soluzioni: consentire gli script locali per il tuo utente con il comando seguente, chiamare npm.cmd e claude.cmd, oppure abbandonare npm e usare l’installer nativo.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Un’ultima avvertenza: ignora gli installer .exe di terze parti presenti nei tutorial, soprattutto quelli che richiedono privilegi di amministratore. I comandi ufficiali sopra sono sufficienti.

Passaggio 3: verifica che Claude Code sia installato

Chiudi il terminale in cui hai installato il programma e aprine uno nuovo. La vecchia finestra utilizza ancora il PATH precedente all’installazione, quindi lì claude spesso non viene ancora riconosciuto. Nel nuovo terminale:

claude --version   # muncul nomor versi = instalasi berhasil
claude doctor      # cek instalasi dan file pengaturan tanpa membuka sesi

claude doctor è utile per distinguere due tipi di problemi: se il report è pulito ma Claude Code continua a non connettersi, la causa è nella configurazione (passaggio 4), non nell’installazione.

Vedi ancora command not found: claude o 'claude' is not recognized? La cartella di installazione non è ancora inclusa in PATH. Su macOS e Linux la cartella è ~/.local/bin, su Windows %USERPROFILE%\.local\bin. Per Windows, la documentazione fornisce il seguente comando PowerShell:

# Ada hasilnya? Berarti PATH sudah benar, cukup buka terminal baru.
$env:PATH -split ';' | Select-String '\.local\\bin'

# Tidak ada hasil? Tambahkan folder instalasi ke PATH user:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

# Tutup PowerShell, buka lagi, lalu:
claude --version

Se il download non riesce fin dall’inizio, controlla il messaggio. Secondo la pagina di risoluzione dei problemi di installazione (verificata il 3 ottobre 2026), syntax error near unexpected token '<' o curl: (22) The requested URL returned error: 403 indicano che è stata scaricata una pagina HTML o un codice di errore, non uno script. Il messaggio App unavailable in region indica che la connessione sembra provenire da un paese non supportato; poiché l’Indonesia è supportata, i principali sospettati sono una VPN o un proxy. Anche un 403 senza contenuto è spesso causato dal proxy dell’ufficio o dal firewall dell’università. Homebrew, WinGet e npm scaricano dallo stesso host, quindi prova un’altra rete o chiedi all’amministratore di rete di consentire l’accesso prima di cambiare metodo.

Passaggio 4: configura la chiave API senza abbonamento

Claude Code dispone della variabile integrata ANTHROPIC_BASE_URL per inviare richieste a un gateway diverso da Anthropic, e la documentazione ufficiale ha una pagina dedicata a questo caso. Si tratta quindi di una configurazione supportata, non di una modifica o di un plugin. Recupera prima la chiave sk-kn-… (per l’elenco e la ricarica del saldo, consulta il passaggio 6), quindi scegli uno dei luoghi in cui salvarla.

macOS e Linux: aggiungi queste sei righe alla fine di ~/.zshrc (Zsh, predefinito su macOS) o ~/.bashrc, salva e apri un nuovo terminale.

export ANTHROPIC_BASE_URL=https://api.kunavo.com   # domain saja, tanpa /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

Windows, per una prova iniziale: valorizza le variabili in una finestra PowerShell e avvia subito claude.

# Untuk uji coba: hanya berlaku sampai jendela PowerShell ini ditutup
$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

Tutti i sistemi operativi, in modo permanente: inseriscile nel blocco env del file delle impostazioni utente ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json). Si applicano a tutti i progetti. Se il file contiene già altre impostazioni, inserisci solo il blocco env senza sovrascriverle.

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

Aspetti da considerare sulle sei variabili precedenti:

Perché fissare il modello? Secondo la documentazione sulla configurazione dei modelli (verificata il 3 ottobre 2026), per gli utenti API il modello predefinito punta attualmente a Opus 5.5 e l’alias opus punta anch’esso a Opus 5.5, mentre l’alias sonnet punta a Sonnet 5.5. Gli alias cambiano a ogni nuova versione. Al 3 ottobre 2026, Sonnet 5.5 non è ancora disponibile su Kunavo e il modello successivo potrebbe non essere disponibile subito; le richieste a un modello non disponibile ricevono un 404. Per questo il blocco qui sopra fissa anche l’alias sonnet tramite ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5: senza questa impostazione, /model sonnet, la fase di esecuzione di opusplan e i sottoagenti con il modello sonnet terminano con un 404. L’alias opus è fissato su Claude Opus 5.5 (claude-opus-5-5), che richiede Claude Code v2.1.280 o versioni successive; se la tua versione è precedente, esegui claude update.

Tariffe Kunavo per 1 milione di token (input / output): Claude Sonnet 5 $1,40 / $7,00 (prezzi di listino Anthropic: $2,00 / $10,00), Claude Opus 5.5 $2,80 / $14,00 e Claude Haiku 4.5 $0,70 / $3,50.

Altre due insidie. Primo, non inserire mai la chiave nel .claude/settings.json del progetto: secondo la documentazione del gateway, quel file viene sottoposto a commit e clonato da chiunque scarichi il repository. Secondo, se la stessa variabile è presente sia nella shell sia nel blocco env del file delle impostazioni, in genere prevale il valore del file delle impostazioni; quindi, se una modifica in ~/.zshrc sembra non avere effetto, controlla il file delle impostazioni. Chi usa l’estensione VS Code inserisce la stessa variabile in claudeCode.environmentVariables nelle impostazioni utente di VS Code.

Passaggio 5: apri la prima sessione e verifica /status

Entra nella cartella del progetto e digita claude. Se la chiave è stata rilevata, la sessione si apre subito senza schermata di accesso. La schermata di accesso indica che la chiave non è stata ricevuta. La causa più comune è che la chiave si trovi solo in .claude/settings.json o nel progetto .claude/settings.local.json. In modalità interattiva, il blocco env del file di progetto viene letto solo dopo la procedura guidata iniziale e la domanda se la cartella è attendibile; perciò al primo avvio Claude Code continua a richiedere l’accesso. Sposta la chiave nella shell o in ~/.claude/settings.json.

Dopo l’apertura della sessione, digita /status. La configurazione è corretta se:

• è presente una riga Anthropic base URL contenente https://api.kunavo.com (questa riga compare solo se il gateway è configurato; la sua assenza significa che ANTHROPIC_BASE_URL non è stata rilevata), e
• è presente una riga Auth token che indica ANTHROPIC_AUTH_TOKEN. Se viene mostrato Login method con un account claude.ai, Claude Code sta ancora utilizzando il vecchio accesso.

Vuoi verificare la chiave prima di aprire Claude Code? La documentazione ufficiale utilizza una richiesta che richiede solo 1 token di output, quindi il saldo consumato è minimo. Il comando legge le variabili dalla shell attiva; se la chiave è salvata in un file delle impostazioni, esegui prima export in questo terminale. Un risultato che inizia con {"id":"msg_ indica che è tutto a posto, mentre 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 per PowerShell; ha esito positivo se il campo id nella risposta 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": "."}]}'

Alcuni aspetti funzionano diversamente quando Claude Code usa una chiave API e un gateway:

Passaggio 6: ricarica il saldo con carta o Link (senza QRIS, GoPay, OVO, DANA)

Su Kunavo paghi un saldo API prepagato, non un abbonamento. È questo saldo che Claude Code detrae per token dopo la configurazione della chiave. La procedura è:

1. Crea un account Kunavo usando un’e-mail o un account Google. La registrazione non richiede una carta.
2. Apri Billing e scegli l’importo. Minimo $10, senza costi mensili. Gli importi maggiori possono includere un bonus sul saldo: paga $100 → saldo $110, paga $1.000 → saldo $1.200 e paga $5.000 → saldo $6.250.
3. Al checkout di Stripe puoi pagare con carta (Visa, Mastercard ecc.), Link oppure Apple Pay/Google Pay, se il dispositivo e il browser sono già configurati per usarli. Link salva i dati di pagamento, così la ricarica successiva richiede solo pochi clic.
4. Apri API Keys e crea una chiave. La chiave che inizia con sk-kn- viene mostrata una sola volta, quindi copiala immediatamente in ANTHROPIC_AUTH_TOKEN.

QRIS, GoPay, OVO, DANA, ShopeePay, account virtuali e bonifici bancari non sono disponibili. Senza una carta abilitata alle transazioni online internazionali, al momento non puoi ricaricare il saldo su Kunavo. Sono incluse anche le carte di debito con il logo Visa o Mastercard; se vengono rifiutate, di solito le transazioni online o internazionali non sono state abilitate nell’app della banca e la decisione finale spetta alla banca emittente.

I prezzi di Kunavo sono in USD. Se al checkout compare l’importo in rupie, il tasso di cambio è stabilito da Stripe e include una commissione di conversione del 2–4% a carico dell’acquirente (documentazione di Stripe Adaptive Pricing, verificata il 3 ottobre 2026). Scegliere di pagare in USD evita questa commissione, anche se restano applicabili il tasso di cambio e le commissioni della tua banca.

Il saldo non scade mai e le richieste non riuscite non lo riducono. La ricarica automatica funziona solo con una carta salvata o con Link. Kunavo non rilascia alcun documento fiscale. Il saldo non può inoltre essere utilizzato per pagare Claude Pro o Max. I dettagli delle tariffe di tutti i modelli Claude e le modalità di pagamento dall’Indonesia sono disponibili in prezzi dell’API Claude; il confronto tra abbonamento e chiave API specifico per Claude Code è disponibile in prezzi di Claude Code.

Quanto si spende indicativamente?

Ogni richiesta di Claude Code reinvia il contesto della conversazione, ma la parte iniziale identica da una richiesta all’altra viene tariffata come lettura della cache, molto più economica. I calcoli seguenti sono pura aritmetica dei token basata sulle ipotesi indicate, non risultati misurati né limiti massimi:

• una richiesta = 40.000 token di input; 36.000 (90%) vengono letti dalla cache, i restanti 4.000 vengono scritti nella cache;
• una richiesta produce 1.000 token di output;
• una sessione = 50 richieste, escluse le chiamate Claude Haiku 4.5 in background;
• tariffa di lettura della cache 10% e di scrittura della cache 1,25× la tariffa di input (proporzione Claude Sonnet 5 su Kunavo; ogni modello nella tabella utilizza la propria proporzione).

I tuoi valori reali variano in base alla lunghezza del contesto, alla frequenza di utilizzo della cache, alla lunghezza delle risposte e al fatto che la conversazione venga cancellata con /clear quando passi a un’altra attività. Secondo la documentazione sui costi di Anthropic, i processi in background di Claude Code costano generalmente meno di 0,04 $ per sessione (verificato il 3 ottobre 2026). Le tariffe complete sono nella pagina dei prezzi; per stimare il tuo modello di utilizzo puoi usare anche il calcolatore dei costi dei token Claude (in inglese).

Come usare Claude Code ogni giorno

cd ~/proyek-saya   # Claude Code bekerja di folder tempat ia dijalankan
claude              # mulai sesi
claude -c           # lanjutkan percakapan terakhir di folder ini

• Fai richieste in linguaggio naturale, ad esempio “spiega la struttura di questo progetto” o “correggi l’errore nella pagina di accesso”. Claude Code legge i file e chiede l’autorizzazione prima di modificarli o eseguire operazioni.
• Usa /clear quando cambi attività: la cronologia precedente non viene più inviata, quindi diminuiscono i token per richiesta.
• Usa /model per cambiare modello. Con i pin del passaggio 4, opus = claude-opus-5-5, sonnet = claude-sonnet-5 e haiku = claude-haiku-4-5.
• Usa /status per controllare gateway e chiave; /usage per stimare i costi (con i prezzi di listino, consulta la tabella al passaggio 5).

Messaggi di errore e relativo significato

Limitazioni

• Paga solo con carta, Link o Apple Pay/Google Pay. Non sono disponibili QRIS, GoPay, OVO, DANA, ShopeePay, account virtuali o bonifici bancari; la ricarica automatica è disponibile solo con una carta salvata o con Link.
• Kunavo non rilascia alcun documento fiscale.
• Questa è un’API a pagamento per token, non un abbonamento Claude Pro o Max. Con una chiave API, Remote Control e la dettatura vocale non sono disponibili, /fast è disabilitato e la ricerca degli strumenti MCP è disattivata per impostazione predefinita.
• Al 3 ottobre 2026 Sonnet 5.5 non è ancora disponibile su Kunavo; senza fissare il modello, l’alias predefinito può terminare con un 404.
• La documentazione di Claude Code è disponibile in indonesiano, ma la documentazione sull’integrazione Kunavo e la versione inglese di questa guida (Install Claude Code) non sono ancora disponibili in indonesiano.

Domande frequenti