Naar inhoud springen
Developer Resources
Developer Resources

Codex App

Gebruik RunAPI als de modelprovider in Codex App, kies een Responses-compatibel model en verifieer de verbinding.

Markdown bekijken

Overzicht

Codex is beschikbaar in de ChatGPT-desktopapp voor Windows en macOS. Deze handleiding richt de lokale Codex App op het OpenAI-compatibele Responses-eindpunt van RunAPI, selecteert een RunAPI-model en verifieert de verbinding.

Dit wijzigt de modelprovider die wordt gebruikt om antwoorden en code te genereren. Het voegt geen RunAPI-tools toe. Hosted MCP is een afzonderlijke integratie met eigen client- en authenticatievereisten.

Voordat u begint

  • Installeer de huidige ChatGPT-desktopapp, meld u aan en open Codex ten minste één keer.
  • Maak een toegewijd standaard RunAPI API-sleutel aan door de Authenticatiehandleiding te volgen. Leg de sleutel niet vast in een repository.
  • Kopieer de exacte identificator van een model dat de Responses API ondersteunt uit de Modelcatalogus.

Deze stappen configureren lokale Codex-clients die uw gebruikersniveauconfiguratie lezen. Ze configureren geen gehoste Codex-cloudtaken.

De API-sleutel opslaan

Desktop-apps erven mogelijk geen omgevingsvariabelen van uw shell. Maak ~/.codex/.env aan of bewerk het en voeg de sleutel op een aparte regel toe:

DOTENV 
export RUNAPI_API_KEY=YOUR_RUNAPI_API_KEY

Bewaar dit bestand buiten uw repositories. Beperk het op macOS en Linux tot uw gebruikersaccount:

SHELL 
chmod 600 ~/.codex/.env

RunAPI configureren

Open het ~/.codex/config.toml op gebruikersniveau. Voeg de volgende waarden samen in het bestaande bestand; vervang geen niet-gerelateerde instellingen en voeg geen tweede kopie van een bestaande sleutel op het hoogste niveau toe:

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"

Provider- en authenticatie-instellingen moeten op gebruikersniveau zijn. Codex negeert model_provider en model_providers in het .codex/config.toml van een project. Het TOML-bestand slaat alleen de naam van de omgevingsvariabele op; de API-sleutel blijft in ~/.codex/.env.

De base_url is de API-root, niet een bewerkings-URL. Met wire_api = "responses" verzendt Codex POST /v1/responses. Zie de aangepaste modelproviderconfiguratie van OpenAI voor het providercontract.

Een model kiezen

Vervang YOUR_RUNAPI_MODEL_ID door de exacte identificatie gekopieerd uit de Modelcatalogus. Selecteer een model dat de Responses API beschikbaar stelt; ondersteuning voor alleen Chat Completions is niet voldoende voor deze configuratie.

Wanneer u model wijzigt, start de app volledig opnieuw op en begin een nieuwe taak. Een bestaande taak kan het model en de provider behouden waarmee deze is gestart.

Opnieuw opstarten en verifiëren

  1. Sluit de ChatGPT-desktopapp volledig af en open deze opnieuw.
  2. Open Codex en start een nieuwe taak in een repository.
  3. Stuur een korte prompt zoals Describe this repository in one sentence.
  4. Controleer of Codex een normale respons geeft en of RunAPI een POST /v1/responses-verzoek voor het geselecteerde model registreert.

De eerste verificatie moet kort zijn, zodat configuratiefouten gemakkelijk te onderscheiden zijn van taakspecifiek gedrag.

RunAPI-tools toevoegen

De bovenstaande modelprovider routeert Codex-inferentie via RunAPI. MCP is afzonderlijk: het kan ondersteunde clients in staat stellen RunAPI-tools aan te roepen voor modeldetectie, accountinformatie en ondersteunde taakworkflows.

De Hosted MCP-handleiding documenteert de momenteel ondersteunde client- en authenticatievereisten. Codex-specifieke Hosted MCP-authenticatie is niet geverifieerd, dus deze pagina bevat geen Codex MCP-installatiestappen. Vervang de modelproviderconfiguratie niet door een MCP-serververmelding; de twee integraties dienen verschillende doeleinden.

Probleemoplossing

  • Codex gebruikt nog steeds de vorige provider: controleer of het bestand ~/.codex/config.toml is, verwijder dubbele model- of model_provider-sleutels, herstart de applicatie volledig en start een nieuwe taak.
  • RUNAPI_API_KEY ontbreekt: controleer of de sleutel in ~/.codex/.env staat en niet alleen in een terminalprofiel, start de applicatie daarna opnieuw.
  • Authenticatie mislukt: maak een standaardsleutel aan of roteer deze via de Authenticatiehandleiding. Plak de sleutel niet in config.toml of in supportlogboeken.
  • Het verzoek geeft 404 terug: stel base_url in op https://runapi.ai/v1, niet op https://runapi.ai/v1/responses.
  • Het model is niet beschikbaar of weigert een veld: kopieer de exacte identificator opnieuw en controleer of het model de Responses API en de gevraagde mogelijkheid ondersteunt.
  • Codex selecteert een ander model: controleer vertrouwde project-bestanden .codex/config.toml op een model-overschrijving. Projectconfiguratie kan een model selecteren, maar kan de provider op gebruikersniveau niet vervangen.
  • De CLI werkt maar de applicatie niet: controleer ~/.codex/.env en herstart de applicatie volledig. GUI-applicaties lezen mogelijk geen variabelen die alleen door uw shell zijn geëxporteerd.
  • Een cloudtaak gebruikt geen RunAPI: deze lokale configuratie is van toepassing op lokale Codex-clients; gehoste cloudtaken lezen geen bestanden van uw computer.

RunAPI verwijderen

  1. Verwijder de RunAPI-waarden model, model_provider en [model_providers.runapi] uit ~/.codex/config.toml, of herstel de providerwaarden die u eerder gebruikte.
  2. Verwijder RUNAPI_API_KEY uit ~/.codex/.env als geen enkel ander lokaal hulpmiddel er gebruik van maakt.
  3. Start de app volledig opnieuw en begin een nieuwe taak.
  4. Trek de toegewezen sleutel in RunAPI in wanneer deze niet meer nodig is.

Volgende stappen

Gebruik de LLM API Snelstart voor gedeeld protocolgedrag en de Responses API- referentie voor exacte verzoek- en antwoordvelden. Ga verder met de Modelcatalogus, de Authenticatiehandleiding, of Hosted MCP indien nodig.