Usare HiAPI con Claude Code: guida completa alla configurazione per risparmiare $100 di abbonamento al mese

Claude Code è lo strumento da terminale per la programmazione prodotto da Anthropic, con capacità di comprensione e refactoring del codice ai primi posti tra strumenti simili. Ma ha una barriera che fa esitare molti: per usare Claude Code devi pagare l'abbonamento Max da $200/mese, oppure $100/mese con un uso limitato. Per chi non scrive codice tutto il giorno, questa tariffa mensile fissa è difficile da giustificare.

La buona notizia è che Claude Code supporta BYOK (Bring Your Own Key): bastano due variabili d'ambiente per collegare API di terze parti. Questo articolo spiega come usare i modelli Claude di HiAPI per alimentare Claude Code, trasformando la tariffa mensile fissa in pagamento a consumo.

Perché gli utenti di Claude Code cercano tutti una API Key di terze parti

La struttura della tariffa mensile dell'abbonamento Max è sfavorevole per due categorie di persone:

Utenti leggeri e medi. Usano Claude Code solo un'ora o due al giorno, e il consumo di token è ben lontano dal giustificare il valore di Max. Pagare $100/mese equivale a spendere $3 al giorno per una quota che magari ne usi solo $0,5.

Utenti già abituati a usare le API. Molti hanno già un proprio flusso di gestione delle API Key, e l'abbonamento diventa un ulteriore onere gestionale. Preferiscono "una sola Key per tutti gli strumenti", senza acquistare un abbonamento separato per Claude Code.

Il vantaggio del pagamento a consumo è evidente: paghi per quanto usi, se non usi non spendi. La parte risparmiata dalla tariffa mensile può essere investita in altri modelli o strumenti.

Come funziona il meccanismo BYOK di Claude Code

All'avvio Claude Code legge due variabili d'ambiente (l'endpoint Anthropic Messages di HiAPI implementa già il tool calling, le risposte in streaming e l'extended thinking, ma la combinazione end-to-end Claude Code + HiAPI non è ancora stata testata: dopo la configurazione si consiglia di verificare prima con un compito semplice):

• ANTHROPIC_BASE_URL: l'indirizzo dell'endpoint API. Per impostazione predefinita punta a quello ufficiale di Anthropic; cambiandolo con l'indirizzo di un provider di terze parti si passa a un endpoint personalizzato.
• ANTHROPIC_API_KEY: la Key di autenticazione. La API Key generata da un provider di terze parti, di solito in un formato che inizia con sk-.

Il principio non è complicato: tutte le richieste di Claude Code passano dal protocollo Anthropic Messages API. Basta che l'endpoint personalizzato implementi questo protocollo e Claude Code funziona normalmente. L'endpoint /v1/messages di HiAPI supporta completamente l'Anthropic Messages API, inclusi tool calling, risposte in streaming ed extended thinking.

La configurazione consiste nello scrivere queste due variabili nell'ambiente del terminale e avviare poi come al solito il comando claude. Più avanti trovi i passaggi completi di configurazione.

Perché scegliere HiAPI per collegare Claude Code

HiAPI offre attualmente 4 modelli Claude (prezzi aggiornati a ottobre 2026), che coprono diversi scenari e budget:

Modello	Input $/M	Output $/M	Contesto
claude-opus-5-5	$2.02	$10.08	1M
claude-opus-4-8	$2.29	$11.47	200K
claude-sonnet-4-6	$3.00	$15.00	200K
claude-opus-4-8@aws	$5.74	$28.70	1M

I punti salienti:

Opus 5.5 è il punto di forza principale. Input $2.02/M, output $10.08/M, circa l'87% in meno rispetto al prezzo tipico dei modelli di livello Opus ($15/$75). Gestire compiti di refactoring complessi con capacità di livello Opus costa molto meno del previsto.

Il prezzo di Sonnet 4.6 è allineato a quello ufficiale. Il prezzo di $3/$15 non comporta sovrapprezzi negli scenari di programmazione quotidiana: usi quello che usavi prima.

I 4 modelli hanno ruoli distinti. Non è "usa il più economico", ma scegliere il modello in base alla complessità del compito: la sezione successiva spiega come scegliere.

Inoltre, questi modelli Claude di HiAPI supportano sia il protocollo Anthropic Messages sia quello OpenAI Chat. Claude Code usa il protocollo Messages, ma anche altri strumenti che supportano le interfacce compatibili con OpenAI (come Cursor, Codex CLI) possono collegarsi: una sola Key copre più ambienti di programmazione.

Passaggi di configurazione (5 minuti)

1. Ottenere la API Key di HiAPI

Accedi a HiAPI, entra nella pagina "API Key" della console e crea una nuova Key. Il formato della Key inizia con sk-: dopo la creazione copiala e salvala subito.

Se non hai un account, registrati prima e completa la configurazione di base.

2. Impostare le variabili d'ambiente

Esegui nel terminale:

export ANTHROPIC_BASE_URL=https://api.hiapi.ai
export ANTHROPIC_API_KEY=sk-<la tua HiAPI Key>

Sostituisci <la tua HiAPI Key> con la Key ottenuta nel passaggio precedente.

Si consiglia di scrivere queste due righe nel file di configurazione della shell (~/.zshrc o ~/.bashrc), così non devi reinserirle ogni volta che apri il terminale:

echo 'export ANTHROPIC_BASE_URL=https://api.hiapi.ai' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY=sk-<la tua HiAPI Key>' >> ~/.zshrc
source ~/.zshrc

3. Avviare Claude Code

claude

All'avvio Claude Code legge automaticamente queste due variabili d'ambiente e invia le richieste a HiAPI. Se tutto funziona, puoi usare Claude Code come al solito: l'unica differenza è che il backend è HiAPI.

4. Verifica

Dopo l'avvio inserisci un compito semplice come test, ad esempio "elenca i file nella directory corrente", e verifica che la risposta sia normale e l'output in streaming fluido. In caso di problemi, controlla che le variabili d'ambiente siano impostate correttamente:

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

Come scegliere il modello: Sonnet vs Opus

L'errore più comune dei principianti è "se c'è Opus, uso Opus". In realtà scegliere il modello in base al compito è più importante che sceglierlo in base al prezzo. Ecco alcuni consigli per scenario:

Programmazione quotidiana → claude-sonnet-4-6. Scrivere codice, correggere bug, aggiungere funzionalità, capire la struttura del progetto. La velocità di risposta di Sonnet è sufficientemente rapida e le capacità coprono la stragrande maggioranza delle esigenze di programmazione quotidiana. Il prezzo è allineato a quello ufficiale, ma poiché non c'è la soglia dei $100/mese, la spesa effettiva è molto inferiore.

Refactoring complessi / modifiche multi-file → claude-opus-5-5. Riorganizzazioni architetturali che coinvolgono più file, compiti che richiedono una comprensione profonda della logica del codice. Opus 5.5 è il più capace, costa solo $2.02/$10.08 ed è attualmente l'opzione Opus con il miglior rapporto qualità-prezzo. Il contesto da 1M è sufficiente anche per progetti di grandi dimensioni.

Compiti complessi generici → claude-opus-4-8. Si colloca tra Sonnet e Opus 5.5. Anche il prezzo di $2.29/$11.47 è accessibile. Adatto come "versione potenziata predefinita" quando non vuoi perderti nella scelta del modello.

Serve un contesto da 1M ma non puoi usare Opus 5.5 → claude-opus-4-8@aws. È la versione con contesto esteso di Opus 4.8, con un prezzo più alto ($5.74/$28.70), adatta all'analisi globale di codebase molto grandi. Negli scenari normali è preferibile Opus 5.5.

In sintesi: Sonnet per l'uso quotidiano, passa a Opus 5.5 per i compiti complessi. Calcolando la spesa giornaliera, un uso moderato costa circa $1-3 al giorno, molto più flessibile di un abbonamento da $100/mese.

Sui costi: la quantità di token consumati da Claude Code a ogni conversazione varia molto. Una semplice domanda e risposta consuma qualche centinaio di token, un refactoring complesso può superarne diecimila. Si consiglia di valutare se conviene rispetto all'abbonamento in base all'utilizzo reale di una settimana, senza guardare solo il listino prezzi. La console di HiAPI offre statistiche di utilizzo per monitorare facilmente il consumo effettivo.

FAQ

Claude Code può davvero usare una API Key di terze parti?

Sì. Anthropic fornisce ufficialmente in Claude Code la variabile d'ambiente ANTHROPIC_BASE_URL, proprio per supportare endpoint personalizzati. Non è un crack né un uso non ufficiale.

Dopo la configurazione, mancano funzionalità in Claude Code?

Le funzionalità principali (lettura e scrittura del codice, esecuzione nel terminale, tool calling, conversazione) passano tutte dal protocollo Anthropic Messages API e non sono influenzate. L'endpoint di HiAPI implementa completamente tale protocollo. Se riscontri comportamenti anomali, controlla prima se la API Key è valida e se le variabili d'ambiente sono corrette.

Cosa fare se dopo la configurazione Claude Code dà errori?

Il problema più comune è che le variabili d'ambiente non hanno effetto. Verifica che nella sessione corrente del terminale echo $ANTHROPIC_BASE_URL produca un output. Se usi l'applicazione desktop di Claude Code invece della versione da terminale, le variabili d'ambiente funzionano in modo diverso: devi consultare il metodo di configurazione delle variabili d'ambiente per la piattaforma corrispondente di Claude Code.

Quanto si risparmia al mese?

Supponendo di usare Claude Code per programmare 2-3 ore al giorno, con il prezzo di Sonnet 4.6 il consumo giornaliero di token è di circa $1-3, per una spesa mensile di circa $30-90. Rispetto all'abbonamento Max da $100/mese, gli utenti leggeri e medi risparmiano il 40-70%.

Per gli utenti intensivi (programmazione a tempo pieno, molti refactoring) serve una verifica pratica: $100/mese è la linea di demarcazione; se la spesa effettiva delle API supera questa cifra, l'abbonamento Max conviene. Si consiglia di collegare prima la Key di terze parti per una settimana, confrontare il costo effettivo dei token con il prezzo dell'abbonamento Max e poi decidere.

Gli altri modelli su HiAPI (GPT, DeepSeek, ecc.) possono essere usati con Claude Code?

No. Claude Code è uno strumento di Anthropic e può usare solo i modelli della serie Claude. Però i modelli non Claude di HiAPI possono essere usati in altri strumenti di programmazione che supportano interfacce compatibili con OpenAI (come Codex CLI, Cursor, ecc.): la stessa Key copre più strumenti.

Ci sono limiti di frequenza usando i modelli Claude di HiAPI?

HiAPI applica limiti di frequenza alle API Key; i valori specifici sono indicati nella console. Negli scenari di programmazione normali non si raggiungono i limiti. Se usi in modo continuativo e intenso per lunghi periodi, controlla prima nella console i limiti attuali.

---

Scegliendo HiAPI per collegare Claude Code, il cambiamento più grande non è il risparmio in sé, ma il fatto che non devi più pagare una tariffa mensile separata per uno strumento. Una sola Key gestisce Claude Code e anche altri ambienti di programmazione, tornando alla semplice logica del pagamento a consumo.

Vedi i dettagli del modello Claude Sonnet 4.6 · Vedi i dettagli del modello Claude Opus 5.5