Vai al contenuto
Risorse per sviluppatori
Risorse per sviluppatori

Codex App

Usa RunAPI come provider del modello in Codex App, scegli un modello compatibile con Responses e verifica la connessione.

Visualizza Markdown

Panoramica

Codex è disponibile nell’app desktop ChatGPT per Windows e macOS. Questa guida indirizza la Codex App locale verso l’endpoint Responses compatibile con OpenAI di RunAPI, seleziona un modello RunAPI e verifica la connessione.

Questo modifica il provider del modello utilizzato per generare risposte e codice. Non aggiunge strumenti RunAPI. Hosted MCP è un’integrazione separata con i propri requisiti client e di autenticazione.

Prima di iniziare

Questi passaggi configurano i client Codex locali che leggono la configurazione a livello utente. Non configurano le attività cloud Codex ospitate.

Salva la Chiave API

Le app desktop potrebbero non ereditare le variabili d’ambiente dalla shell. Crea o modifica ~/.codex/.env e aggiungi la chiave su una riga separata:

DOTENV 
export RUNAPI_API_KEY=YOUR_RUNAPI_API_KEY

Mantieni questo file fuori dai tuoi repository. Su macOS e Linux, limitalo al tuo account utente:

SHELL 
chmod 600 ~/.codex/.env

Configura RunAPI

Apri il file ~/.codex/config.toml a livello utente. Unisci i seguenti valori nel file esistente; non sostituire le impostazioni non correlate né aggiungere una seconda copia di una chiave di primo livello esistente:

TOML 
model = "YOUR_RUNAPI_MODEL_ID"
model_provider = "runapi"

[model_providers.runapi]
name = "RunAPI"
base_url = "https://runapi.ai/v1"
env_key = "RUNAPI_API_KEY"
wire_api = "responses"

Le impostazioni del provider e di Autenticazione devono essere a livello utente. Codex ignora model_provider e model_providers nel file .codex/config.toml di un progetto. Il file TOML memorizza solo il nome della variabile d’ambiente; la Chiave API rimane in ~/.codex/.env.

Il base_url è la radice dell’API, non un URL di operazione. Con wire_api = "responses", Codex invia POST /v1/responses. Consulta la configurazione del provider di modelli personalizzato di OpenAI per il contratto del provider.

Scegli un modello

Sostituisci YOUR_RUNAPI_MODEL_ID con l’identificatore esatto copiato dal Catalogo modelli. Seleziona un modello che espone le Responses API; il solo supporto per Chat Completions non è sufficiente per questa configurazione.

Quando cambi model, riavvia completamente l’app e avvia un nuovo task. Un task esistente potrebbe mantenere il modello e il provider con cui è stato avviato.

Riavvia e verifica

  1. Chiudi completamente l’app desktop ChatGPT e riaprila.
  2. Apri Codex e avvia un nuovo task in un repository.
  3. Invia un breve prompt come Describe this repository in one sentence.
  4. Verifica che Codex restituisca una risposta normale e che RunAPI registri una richiesta POST /v1/responses per il modello selezionato.

La prima verifica dovrebbe essere breve in modo che gli errori di configurazione siano facili da distinguere dal comportamento specifico dell’attività.

Aggiungi strumenti RunAPI

Il provider del modello sopra instrada l’inferenza di Codex tramite RunAPI. MCP è separato: può consentire ai client supportati di chiamare gli strumenti RunAPI per il rilevamento dei modelli, le informazioni sull’account e i flussi di lavoro delle attività supportati.

La guida Hosted MCP documenta i requisiti client e di autenticazione attualmente supportati. L’autenticazione Hosted MCP specifica per Codex non è stata verificata, pertanto questa pagina non fornisce i passaggi di configurazione MCP per Codex. Non sostituire la configurazione del provider del modello con una voce del server MCP; le due integrazioni servono scopi diversi.

Risoluzione dei problemi

  • Codex continua a usare il provider precedente: conferma che il file sia ~/.codex/config.toml, rimuovi le chiavi model o model_provider duplicate, riavvia completamente l’app e avvia una nuova attività.
  • RUNAPI_API_KEY è mancante: conferma che la chiave sia in ~/.codex/.env, non solo in un profilo di terminale, quindi riavvia l’app.
  • L’autenticazione non riesce: crea o ruota una chiave standard tramite la Authentication Guide. Non incollare la chiave in config.toml o nei log di supporto.
  • La richiesta restituisce 404: imposta base_url su https://runapi.ai/v1, non su https://runapi.ai/v1/responses.
  • Il modello non è disponibile o rifiuta un campo: copia di nuovo l’identificatore esatto e verifica che il modello supporti le Responses API e la funzionalità richiesta.
  • Codex seleziona un modello diverso: controlla i file .codex/config.toml dei progetti attendibili per un override di model. La configurazione del progetto può selezionare un modello anche se non può sostituire il provider a livello utente.
  • La CLI funziona ma l’app non funziona: controlla ~/.codex/.env, quindi riavvia completamente l’app. Le applicazioni GUI potrebbero non leggere le variabili esportate solo dalla shell.
  • Un’attività cloud non usa RunAPI: questa configurazione locale si applica ai client Codex locali; le attività cloud ospitate non leggono i file dal tuo computer.

Rimuovi RunAPI

  1. Rimuovi i valori model, model_provider e [model_providers.runapi] di RunAPI da ~/.codex/config.toml, oppure ripristina i valori del provider usati in precedenza.
  2. Rimuovi RUNAPI_API_KEY da ~/.codex/.env se nessun altro strumento locale la utilizza.
  3. Riavvia completamente l’app e avvia una nuova attività.
  4. Revoca la chiave dedicata in RunAPI quando non è più necessaria.

Passaggi successivi

Usa la Guida introduttiva all’LLM API per il comportamento condiviso del protocollo e il Riferimento API Responses per i campi esatti di richiesta e risposta. Continua con il Catalogo Modelli, la Guida all’Autenticazione o Hosted MCP secondo necessità.