Come configurare Claude Code con l’API OmniaKey
Punta Claude Code all'endpoint nativo Anthropic di OmniaKey: due variabili di ambiente, modelli Claude che non vengono mai scambiati silenziosamente, fatturazione per token senza piano mensile.
In questa pagina
Claude Code parla esattamente un protocollo: Messaggi Anthropic API. Questo è previsto dalla progettazione, ed è per questo che puntandolo su OmniaKey accetta due variabili di ambiente e non cambia nient'altro: OmniaKey serve lo stesso protocollo in modo nativo. Ciò che ottieni è una chiave e un saldo condivisi tra tutti gli strumenti che utilizzi, fatturazione per token senza piano mensile e la garanzia che l'ID modello richiesto sia quello in esecuzione.
Installazione
Crea una chiave nella dashboard, imposta due variabili e avvia:
export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude
Lo streaming, l'uso dello strumento e il contesto lungo passano tutti invariati: Claude Code pensa ancora di parlare direttamente con Anthropic.
Non aggiungere /v1 all'URL di base. Claude Code aggiunge /v1/messages stesso, quindi https://api.omniakey.com/v1 si trasforma in /v1/v1/messages e restituisce 404. Utilizza l'host nudo.
Scegli un modello
Cambia modello all'interno della sessione con /model:
/model claude-sonnet-5
Gli ID Claude su OmniaKey includono claude-fable-5 (lavoro più duro e di lunga durata, contesto 1M), claude-opus-5 (lavoro complesso, 1M), claude-sonnet-5 (saldo giornaliero, 1M) e claude-haiku-4-5 (veloce, 200K). L'ID che passi è l'ID che viene eseguito: OmniaKey non lo scambia, quantizza o distilla mai silenziosamente. La guida alla selezione del modello Claude Code associa ciascuno a un'attività e al ruolo dell'agente secondario.
GPT e Gemini: un confine di protocollo, non un limite
Claude Code guida solo Claude. Questo è il protocollo Anthropic che parla, non OmniaKey: nessun gateway può far sì che Claude Code esegua GPT, Gemini o Grok senza rompere lo strumento. Per utilizzare queste famiglie in un agente, puntare uno strumento compatibile con OpenAI (Cursor, Cline, aiutante, Codex, OpenClaw) all'endpoint compatibile con OpenAI di OmniaKey — quello /v1 di seguito — dove solo il modello modifiche all'ID: gpt-5.5, gemini-3.1-pro-preview e grok-4.5 funzionano esattamente come un ID Claude.
OmniaKey espone tutte e tre le superfici da un unico tasto. Gli strumenti di codifica utilizzano /v1 compatibile con OpenAI; lo /v1beta nativo di Gemini è disponibile per lo Gemini SDK di Google. La guida agli agenti di codifica contiene la configurazione per strumento.
Perché la prevedibilità è importante in un agente
Un gateway che reindirizza silenziosamente a un "equivalente più economico" sotto carico è particolarmente pericoloso in un agente di codifica: uno strumento di formattazione del modello diverso chiama in modo diverso e ragiona in modo diverso sulla base di codice, quindi uno scambio a metà attività può corrompere una modifica di più file. Con OmniaKey, se un upstream non è disponibile, ricevi l'errore e scegli tu stesso un altro modello, mai una sostituzione alle tue spalle.
Stai ancora decidendo quale agente dovrebbe possedere quel flusso di lavoro? Leggi il confronto tra Claude Code e Codex prima di configurare uno degli strumenti.
Se la domanda sulla fatturazione viene prima, Claude Code API senza guida all'abbonamento separa l'abbonamento OAuth dall'accesso legittimo con pagamento in base al consumo API e spiega quale credenziale paga effettivamente per una richiesta.
Articoli correlati
Claude Code API senza abbonamento
Il terminale locale Claude Code può usare API billing invece di un piano mensile. Le chiamate restano a pagamento; cambiano autenticazione e fattura.
Guida ad Anthropic OSS Scanner
Scansioni gratuite per i progetti open source in grado di gestire le segnalazioni.
Recensione di Claude Haiku 5.5
Haiku 5.5 è il Claude veloce ed economico per i volumi elevati; tokenizer e adaptive thinking cambiano il modo corretto di migrare l’API.
Articoli recenti
- SKY-001 vs GPT-6 Astra: benchmark CAD, prezzo e accesso
- Grok Voice 3.0: cosa cambia, prezzi dell'API e come usarla
- Grok Imagine API: guida Python e 3 modelli provati fianco a fianco
- Recensione Kimi K3: l'abbiamo provato contro DeepSeek V4 Pro e V4.1 Flash
- DeepSeek V4.1 Flash 1017: cosa è cambiato e come va contro V4 Pro