Codex (CLI di OpenAI)

Esegui le nuove attività locali di Codex tramite la Responses API in streaming di OneProvider.

CLI e app desktop dell'agente di programmazione Codex

Cosa funziona

Supporta le risposte in streaming, le chiamate di funzione, gli strumenti locali come apply_patch e il conteggio del consumo. Questo cambia le nuove attività locali di CLI, desktop e IDE; non cambia le chat cloud di Codex.

Limite del client

Dopo aver cambiato il provider, riavvia Codex e crea una nuova attività locale. Le attività esistenti mantengono il modello e il provider con cui sono partite.

Configurazione

1. Installa o verifica Codex

   Se codex --version stampa già una versione, vai avanti. Altrimenti installa la CLI più recente.

   npm install --global @openai/codex
   codex --version

2. Rendi disponibile una chiave dedicata

   Crea una chiave OneProvider dedicata ed esportala nella stessa sessione del terminale da cui avvii Codex.

   export ONEPROVIDER_API_KEY="sk-your-key-here"

3. Aggiungi il provider personalizzato

   Apri ~/.codex/config.toml (desktop: Settings → Configuration → Open config.toml, cioè Impostazioni → Configurazione → Apri config.toml) e aggiungi il provider OneProvider.

   model_provider = "oneprovider"
   model = "gpt-6.1-sol"
   [model_providers.oneprovider]
   name = "OneProvider"
   base_url = "https://api.oneprovider.dev/v1"
   env_key = "ONEPROVIDER_API_KEY"
   wire_api = "responses"

4. Riavvia e prova una nuova attività locale

   Chi usa la CLI deve eseguire una prova di sola lettura. Chi usa il desktop deve chiudere completamente l'app, riaprirla e avviare una nuova attività locale.

   codex

Verifica la connessione

Controlla la richiesta nella tua Dashboard

La richiesta completata dovrebbe mostrare il modello selezionato, /v1/responses, il consumo di token e l'importo addebitato.

Dati di connessione

Protocollo

responses

Endpoint

https://api.oneprovider.dev/v1

Sicurezza della chiave

Usa una chiave dedicata con ambito limitato. Su macOS un'app desktop aperta dal Dock può non ereditare le variabili d'ambiente del terminale; usa l'autenticazione tramite Keychain basata su comando di Codex invece di mettere il segreto in config.toml.

Quale modello scegliere

Imposta model nello stesso config.toml, sotto model_provider. gpt-6.1-sol è il livello di punta per attività agentiche difficili, gpt-6.1-terra è la scelta predefinita bilanciata per il lavoro di ogni giorno, e gpt-5.6-luna è il livello economico per volumi alti e attività rapide. Codex usa la Responses API, quindi scegli gli ID GPT dalla pagina dei modelli ; le tariffe sono nella pagina dei prezzi .

Errori comuni e soluzioni

401 o «missing credentials»

ONEPROVIDER_API_KEY non è visibile a Codex. Esportala nel terminale da cui avvii Codex. Un'app desktop aperta dal Dock su macOS non la eredita: usa l'autenticazione tramite Keychain basata su comando.

404

base_url deve essere https://api.oneprovider.dev/v1 con /v1, e wire_api deve essere "responses".

Codex usa ancora il vecchio modello o provider

Le attività esistenti mantengono il provider con cui sono partite. Riavvia Codex e crea una nuova attività locale.

«You've hit your usage limit» oppure Codex mi chiede di accedere a ChatGPT

È il limite di un abbonamento ChatGPT: la richiesta è andata a ChatGPT, quindi il provider OneProvider non è attivo. Metti model_provider = "oneprovider" in cima a config.toml, sopra qualsiasi [table] (senza virgolette «intelligenti»), chiudi Codex completamente e avvia una nuova attività locale. Poi esci da ChatGPT con codex logout (nell'app desktop: nelle sue impostazioni) e avvia codex nel terminale in cui è esportata ONEPROVIDER_API_KEY: con il provider attivo funziona con la sola chiave. Prova rapida: codex -c model_provider=oneprovider. wire_api accetta solo "responses".

429 «Insufficient balance»

Il saldo o il limite della chiave è esaurito. Ricarica; riprovare non serve.

FAQ

Questo cambia le chat cloud di Codex?

No, solo le nuove attività locali di CLI, desktop e IDE.

Mi serve un account OpenAI?

No, per le attività locali la chiave di OneProvider lo sostituisce.

Posso usare i modelli Claude in Codex?

Codex usa la Responses API con ID GPT. Per Claude usa Claude Code .

Dove controllo il costo?

Nella pagina «Consumo» della Dashboard: ogni richiesta mostra il modello, /v1/responses e l'importo addebitato.

Risposte rapide

Quale base URL devo usare?

Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .

Come mi autentico?

Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .

Dove ottengo una chiave?

Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .

Cosa significano 401, 404 e 429?

401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .

Perché gli stream si interrompono o si resettano?

VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.

Dove chiedo se non basta?

Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .