--- title: Codex App | RunAPI description: Usa RunAPI come provider del modello in Codex App, scegli un modello compatibile con Responses e verifica la connessione. url: https://runapi.ai/it/docs/resources/tool-integrations/codex-app.md canonical: https://runapi.ai/it/docs/resources/tool-integrations/codex-app locale: it --- > Versione HTML: https://runapi.ai/it/docs/resources/tool-integrations/codex-app > Indice del sito per gli agenti: https://runapi.ai/llms.txt # Codex App ## 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](https://runapi.ai/it/docs/resources/mcp/hosted.md) è un'integrazione separata con i propri requisiti client e di autenticazione. ## Prima di iniziare * Installa l'attuale [app desktop ChatGPT][1], accedi e apri Codex almeno una volta. * Crea una Chiave API RunAPI standard dedicata seguendo la [Guida introduttiva all'Autenticazione](https://runapi.ai/it/docs/guides/authentication.md). Non eseguire il commit della chiave in un repository. * Dal [Catalogo modelli](https://runapi.ai/it/models), copia l'identificatore esatto di un modello che supporta la Responses API. [1]: https://developers.openai.com/codex/app 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][1] di OpenAI per il contratto del provider. [1]: https://developers.openai.com/codex/config-advanced#custom-model-providers ## Scegli un modello Sostituisci `YOUR_RUNAPI_MODEL_ID` con l'identificatore esatto copiato dal [Catalogo modelli](https://runapi.ai/it/models). 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](https://runapi.ai/it/docs/resources/mcp/hosted.md) 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](https://runapi.ai/it/docs/guides/authentication.md). 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](https://runapi.ai/it/docs/guides/llm-api/quickstart.md) per il comportamento condiviso del protocollo e il [Riferimento API Responses](https://runapi.ai/it/docs/api/openai/responses.md) per i campi esatti di richiesta e risposta. Continua con il [Catalogo Modelli](https://runapi.ai/it/models), la [Guida all'Autenticazione](https://runapi.ai/it/docs/guides/authentication.md) o [Hosted MCP](https://runapi.ai/it/docs/resources/mcp/hosted.md) secondo necessità. --- ## Altre risorse di RunAPI - [Home](https://runapi.ai/it/.md) - [Catalogo dei modelli](https://runapi.ai/it/models.md) - [Prezzi](https://runapi.ai/it/pricing.md) - [Fornitori](https://runapi.ai/it/models) - [Documentazione](https://runapi.ai/it/docs/guides) - [SDK](https://runapi.ai/it/sdk.md) - [CLI](https://runapi.ai/it/cli.md) - [MCP Server](https://runapi.ai/it/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/it/claude-code-vs-cursor.md) - [Configurazione Cursor API](https://runapi.ai/it/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/it/openrouter-alternative.md) - [Enterprise](https://runapi.ai/it/contact.md) - [Contatti](https://runapi.ai/it/contact.md) - [Termini](https://runapi.ai/it/terms.md) - [Privacy](https://runapi.ai/it/privacy.md) - [Indice del sito per gli agenti](https://runapi.ai/llms.txt) Contatti: contact@runapi.ai ## Dati strutturati ```json [ { "@context": "https://schema.org", "inLanguage": "it", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/it", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/it/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/it", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/iticon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "it", "@type": "TechArticle", "headline": "Codex App", "description": "Usa RunAPI come provider del modello in Codex App, scegli un modello compatibile con Responses e verifica la connessione.", "url": "https://runapi.ai/it/docs/resources/tool-integrations/codex-app", "mainEntityOfPage": "https://runapi.ai/it/docs/resources/tool-integrations/codex-app" } ] ```