Claude Code e Codex collegati a HiAPI: una sola Key per scegliere il modello in base al task

In questi giorni è tornata virale una frase di Karpathy di inizio anno: the new default is that you are not writing the code directly 99% of the time, you are orchestrating agents who do and acting as oversight. Tradotto: il nuovo default è che il 99% delle volte non scrivi più codice di persona, ma orchestri gli agent che lavorano per te e fai solo supervisione. La frase viene dal post in cui ha proposto il concetto di agentic engineering, e nel podcast No Priors ha rincarato la dose: I don't think I've typed a line of code probably since December.

Virale o no, i dati dimostrano che non è uno slogan. Il fatturato annualizzato di Claude Code ha già superato i $2.5B (dati annunciati ufficialmente con la Series G di febbraio 2026, ARR non certificato), mentre GitHub Copilot aveva impiegato circa 3 anni per arrivare a $1B. Nel sondaggio JetBrains 2026 sull'ecosistema degli sviluppatori (oltre 15.000 intervistati), circa il 90% degli sviluppatori professionisti usa ogni settimana un agent di programmazione AI; l'adozione di Claude Code in ambito lavorativo è passata dal 18% al 39% (47% negli USA), mentre Codex è passato dal 3% al 16%.

E insieme ai vantaggi arrivano i problemi: gli agent aumentano, ma configurazione e fatturazione restano separate. Molti usano Claude Code e Codex contemporaneamente, ma i due strumenti richiedono key separate, ricariche separate e statistiche d'uso separate; per cambiare modello bisogna rifare tutta la procedura di richiesta. Questo articolo spiega come collegare entrambi gli strumenti con una sola HiAPI Key, e una volta collegati come scegliere e cambiare modello.

In sintesi

• Una Key per due strumenti: la API Key di HiAPI funziona sia con Claude Code che con Codex; saldo, utilizzo e fatturazione sono in un unico pannello
• Ognuno con il proprio modello più potente: Claude Code usa il protocollo Anthropic Messages (/v1/messages) con i modelli Claude di HiAPI; Codex usa la Responses API (/v1/responses) con i modelli della famiglia GPT-6.1
• Libertà entro due limiti invalicabili: Claude Code non supporta ufficialmente l'instradamento verso modelli non-Claude tramite alcun gateway, quindi l'approccio corretto è collegare ogni strumento alla propria famiglia di modelli, non far gestire tutto a un solo strumento
• Collegamento in 5 minuti: apri la pagina /connect/agents, scegli strumento + modello + sistema operativo e copia la configurazione generata; Claude Code e Codex supportano l'importazione con un clic tramite CC Switch
• Cambio modello con una sola modifica: in Claude Code si modifica il campo model in settings.json, in Codex la riga model in hiapi.config.toml; la Key non va cambiata

La soluzione di HiAPI: una Key, due strumenti

HiAPI è una piattaforma API che aggrega più famiglie di modelli ed espone esternamente alcuni protocolli standard. Per gli agent di programmazione, l'azienda ha realizzato una pagina di collegamento con un clic per 4 strumenti: /zh/connect/agents (versione inglese /en/connect/agents), che supporta Claude Code, Codex CLI, OpenCode e Hermes Agent.

La mappatura dei protocolli è il punto chiave per un collegamento corretto:

Strumento	Protocollo	Percorso endpoint	Modelli selezionabili su HiAPI
Claude Code	Anthropic Messages	/v1/messages	claude-opus-5-5, claude-sonnet-4-6, claude-opus-4-8, claude-opus-4-8@aws (4 in totale)
Codex CLI	Responses API	/v1/responses	gpt-6.1-sol, gpt-6.1-terra, gpt-6-astra, famiglia gpt-5.6, famiglia deepseek-v4 (9 in totale)
OpenCode / Hermes Agent	Chat Completions	/v1/chat/completions	Modelli testuali di tutte le famiglie, la copertura più ampia

In altre parole, Claude Code dà il meglio nei task agentici di codifica di lunga durata ed è abbinato ai modelli di punta della famiglia Claude; Codex dà il meglio nei carichi elevati ed è abbinato alla famiglia GPT-6.1. Una sola Key autentica entrambi, con fatturazione unificata.

Una precisazione doverosa: Anthropic non supporta ufficialmente l'instradamento di Claude Code verso modelli non-Claude tramite alcun gateway. Forzare modelli GPT dentro Claude Code rende instabili le chiamate agli strumenti e il comportamento dell'agent, senza alcuna garanzia ufficiale in caso di problemi. Quindi «una Key per cambiare modello in qualsiasi momento» significa precisamente: distribuire i task tra i due strumenti, ciascuno con il modello più potente per sé, non mescolare le famiglie dentro un singolo strumento.

Se usi solo Claude Code, puoi consultare la nostra guida precedente alla configurazione di un singolo strumento: «Collegare Claude Code a HiAPI: guida completa alla configurazione per risparmiare $100 al mese di abbonamento». Questo articolo si concentra sulla condivisione di una Key tra due strumenti e sulla strategia di cambio modello.

Metodo 1 (consigliato): configurazione generata dalla pagina /connect/agents

Il metodo più semplice: tutto a colpi di clic, senza scrivere manualmente alcuna configurazione:

1. Apri hiapi.ai/zh/connect/agents e clicca «Collega HiAPI al tuo Agent»
2. Scegli lo strumento: Claude Code o Codex CLI
3. Scegli il modello: ad esempio claude-opus-5-5 per Claude Code, gpt-6.1-sol per Codex
4. Scegli il sistema operativo: macOS / Windows / Linux; i percorsi nella configurazione cambiano di conseguenza
5. Copia la configurazione generata e incollala nel file corrispondente seguendo le istruzioni

Claude Code e Codex supportano l'importazione con un clic tramite CC Switch: nella pagina API Keys di HiAPI clicca importa; il browser avvia CC Switch e completa la scrittura della configurazione. Il link di importazione non contiene la tua chiave: la Key è salvata nelle variabili d'ambiente locali, quindi puoi stare tranquillo.

Verifica prima i requisiti di versione: Codex CLI richiede 0.134 o superiore, controlla con codex --version; per Claude Code usa claude --version per confermare che il numero di versione venga stampato correttamente.

Metodo 2: scrivere manualmente i file di configurazione

Anche la configurazione manuale non è complicata: due file, uno per strumento.

Claude Code: ~/.claude/settings.json

Nel blocco env di ~/.claude/settings.json (su Windows %USERPROFILE%\.claude\settings.json) inserisci:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.hiapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "la tua HiAPI API Key",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Spiegazione campo per campo:

• ANTHROPIC_BASE_URL punta a https://api.hiapi.ai, senza /v1: il client concatena da solo /v1/messages
• ANTHROPIC_AUTH_TOKEN contiene la tua HiAPI API Key, con autenticazione Bearer
• ANTHROPIC_MODEL e gli alias OPUS / SONNET puntano tutti al modello scelto su HiAPI (HiAPI non serve gli ID ufficiali dei modelli Claude, gli alias vengono reindirizzati)
• ANTHROPIC_DEFAULT_HAIKU_MODEL è fissato a claude-sonnet-4-6: è lo slot che Claude Code usa per le attività di background (compressione del contesto, generazione dei messaggi di commit e simili)
• CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 serve perché la nuova pipeline di testo rifiuta i campi sperimentali beta nelle richieste; disattivarli evita problemi

Codex: ~/.codex/hiapi.config.toml

Crea ~/.codex/hiapi.config.toml (su Windows %USERPROFILE%\.codex\hiapi.config.toml):

model_provider = "hiapi"
model = "gpt-6.1-sol"

[model_providers.hiapi]
name = "HiAPI"
base_url = "https://api.hiapi.ai/v1"
env_key = "HIAPI_API_KEY"
wire_api = "responses"

Poi imposta la variabile d'ambiente nella shell e avvia:

export HIAPI_API_KEY="la tua HiAPI API Key"
codex --profile hiapi

In Windows PowerShell il comando corrispondente è $env:HIAPI_API_KEY = "...". Nota che qui base_url include /v1, a differenza di Claude Code: non copiare e mescolare le due configurazioni. wire_api = "responses" dichiara l'uso del protocollo Responses, requisito obbligatorio di Codex.

Come scegliere il modello: Opus per i task complessi, GPT-6.1 per il volume

Una volta collegati entrambi gli strumenti, la scelta del modello diventa una questione di instradamento per task. Il nostro consiglio è diretto:

• Task ad alta difficoltà e lunga durata a claude-opus-5-5: refactoring multi-file, debug lunghissimi, task che richiedono di comprendere l'intero codebase. È il modello di punta sul lato Claude Code, con una finestra di contesto fino a 1M
• Carichi quotidiani ad alto volume a gpt-6.1-sol / gpt-6.1-terra: riscritture in batch, funzionalità su singolo file, generazione di script: task numerosi e non complessi, per cui conviene un modello economicamente più leggero, con una differenza evidente in fattura
• gpt-6-astra per scenari Responses più sensibili alla qualità: prezzo più alto, da attivare all'occorrenza

Prezzi di piattaforma dei modelli chiave ($/M token, aggiornati a 2026-10, fascia base):

Modello	Input	Output	Lettura cache	Contesto
claude-opus-5-5	$2.02	$10.08	$0.10	1M
claude-sonnet-4-6	$3.00	$15.00	$0.30	—
gpt-6.1-sol	$0.50	$2.50	$0.025	1.05M
gpt-6.1-terra	$0.25	$1.25	$0.0125	1.05M
gpt-6-astra	$2.50	$12.50	$0.25	1.05M (oltre 272K scatta la fascia di prezzo per testi lunghi)

Nota la colonna del prezzo di lettura cache: nelle sessioni agent una grande quantità di token deriva da hit in cache; la lettura cache di gpt-6.1-terra costa solo $0.0125/M, quindi nelle sessioni lunghe in cui si modifica ripetutamente lo stesso repository la fattura effettiva risulta molto più bassa di quanto stimato sul prezzo di input. Volume elevato e risparmio non sono alternativi.

Per approfondire l'orientamento delle capacità di Opus 5.5 e GPT-6.1 Sol, leggi «Claude Opus 5.5 contro GPT-6.1 Sol»; per l'entità e il contesto del recente taglio di prezzo di Terra, «Analisi del taglio di prezzo di GPT-6.1 Terra» contiene l'analisi completa. Per prezzi e parametri in tempo reale dei due modelli, fa fede la pagina di dettaglio del modello.

Quanto è facile cambiare modello

È il vantaggio più sottovalutato di questa soluzione. Per cambiare modello bastano due operazioni:

• Claude Code: modifica i valori di ANTHROPIC_MODEL / ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL in ~/.claude/settings.json (su HiAPI gli alias opus/sonnet puntano tutti lì: basta sostituirli con lo stesso nuovo ID modello); ha effetto riaprendo la sessione
• Codex: modifica la riga model = "..." in ~/.codex/hiapi.config.toml; ha effetto al successivo codex --profile hiapi

La Key non va toccata dall'inizio alla fine. Rispetto alla vecchia strada di «richiedere una key ufficiale separata per ogni strumento»: cambiare modello significava ripetere la richiesta, attendere l'approvazione, modificare la gestione delle chiavi; ora è questione di una riga di configurazione. Se hai usato l'importazione CC Switch, puoi anche riselezionare il modello nella pagina /connect/agents e cliccare di nuovo importa: tutto tramite interfaccia grafica.

Se vuoi collegare altri modelli, OpenCode e Hermes Agent usano il protocollo Chat Completions e offrono la copertura più ampia di modelli selezionabili, con lo stesso flusso della pagina. Se ti interessano i nuovi modelli multimodali e di tipo world model, dai un'occhiata anche a «Test pratico del world model Genie 4».

Domande frequenti

Claude Code può usare i modelli GPT tramite HiAPI?

No, e non è necessario. Anthropic non supporta ufficialmente l'instradamento di Claude Code verso modelli non-Claude tramite alcun gateway; forzarlo rende instabili le chiamate agli strumenti e il comportamento dell'agent, senza garanzie ufficiali. I modelli Claude selezionabili per Claude Code su HiAPI sono 4: claude-opus-5-5, claude-sonnet-4-6, claude-opus-4-8 e claude-opus-4-8@aws. Per usare i modelli della famiglia GPT-6.1, passa dal lato Codex, dove il protocollo Responses li supporta nativamente.

Una sola HiAPI Key può essere usata contemporaneamente da Claude Code e Codex?

Sì, è il cuore di questa soluzione. I due strumenti condividono la stessa Key, con modalità di autenticazione diverse (Claude Code usa ANTHROPIC_AUTH_TOKEN, Codex la variabile d'ambiente HIAPI_API_KEY), ma è sempre la stessa Key. Saldo, utilizzo e fatturazione si consultano nello stesso pannello, con statistiche raggruppate per strumento.

L'importazione con un clic tramite CC Switch è sicura?

Sì. Il link di importazione non contiene la chiave: la Key è salvata nelle variabili d'ambiente locali. Il flusso è: dopo aver generato la Key su HiAPI, vai nella pagina API Keys e clicca importa con CC Switch; il browser avvia CC Switch che scrive la configurazione. Se preferisci non fidarti del flusso grafico, scrivere manualmente settings.json e hiapi.config.toml è del tutto equivalente.

Ho configurato entrambi gli strumenti: come verifico che il collegamento funzioni?

Sul lato Claude Code esegui claude --version per confermare che il client funzioni, poi apri una sessione qualsiasi e invia una frase, quindi torna nel pannello HiAPI per verificare che l'utilizzo sia aumentato; sul lato Codex è richiesta la CLI 0.134+, avvia con codex --profile hiapi e invia un task, controllando poi la misurazione nel pannello. Per la prima volta consigliamo di eseguire un piccolo task per ciascuno strumento, verificando che addebito e ID modello siano corretti, prima di usare tutto a pieno regime.

Vale la pena collegare OpenCode e Hermes Agent?

Dipende dalle abitudini del tuo team. Questi due strumenti usano il protocollo Chat Completions e offrono il maggior numero di famiglie di modelli selezionabili: sono adatti a scenari in cui serve attraversare più famiglie di modelli da un unico client. Il flusso di configurazione è identico a quello di Claude Code / Codex, sempre dalla pagina /connect/agents.

Cambiare modello influisce sulle sessioni in corso?

La modifica vale per la configurazione delle nuove sessioni. Le sessioni già aperte usano il modello letto all'avvio: dopo aver cambiato la configurazione basta riaprire la sessione, mentre la cronologia delle sessioni non è interessata.

Conclusione chiave

Il ritorno virale della frase di Karpathy sul 99% dimostra che l'agentic engineering non è più un gioco per pionieri, ma il modo di lavorare predefinito. Con il modo di lavorare predefinito, sempre più persone useranno contemporaneamente Claude Code e Codex, e la frammentazione di configurazioni e fatturazione è un attrito reale. La soluzione di HiAPI è collegare due strumenti con una sola Key: Claude Code usa il protocollo Messages con i modelli di punta della famiglia Claude, Codex usa il protocollo Responses con la famiglia GPT-6.1, ognuno con il proprio modello più potente, con fatturazione unificata. Il collegamento passa dalla pagina /connect/agents, che genera la configurazione, più l'importazione CC Switch: si parte in 5 minuti; per cambiare modello basta una riga di configurazione, senza toccare la Key. Instradare per task (i problemi difficili a Opus 5.5, il volume a GPT-6.1 Sol/Terra) è oggi la soluzione ottimale per tenere sotto controllo contemporaneamente qualità e fattura.