Saltar al contenido
Recursos para desarrolladores
Recursos para desarrolladores

Codex App

Usa RunAPI como proveedor de modelos en Codex App, elige un modelo compatible con Responses y verifica la conexión.

Ver Markdown

Descripción general

Codex está disponible en la aplicación de escritorio ChatGPT para Windows y macOS. Esta guía dirige la Codex App local al endpoint de Responses compatible con OpenAI de RunAPI, selecciona un modelo de RunAPI y verifica la conexión.

Esto cambia el proveedor de modelos utilizado para generar respuestas y código. No añade herramientas de RunAPI. Hosted MCP es una integración independiente con sus propios requisitos de cliente y autenticación.

Antes de comenzar

Estos pasos configuran los clientes Codex locales que leen tu configuración de nivel de usuario. No configuran tareas en la nube de Codex alojado.

Guardar la Clave de API

Es posible que las aplicaciones de escritorio no hereden las variables de entorno de su shell. Cree o edite ~/.codex/.env y agregue la clave en su propia línea:

DOTENV 
export RUNAPI_API_KEY=YOUR_RUNAPI_API_KEY

Mantenga este archivo fuera de sus repositorios. En macOS y Linux, restrínjaló a su cuenta de usuario:

SHELL 
chmod 600 ~/.codex/.env

Configurar RunAPI

Abra el ~/.codex/config.toml a nivel de usuario. Combine los siguientes valores en el archivo existente; no reemplace configuraciones no relacionadas ni agregue una segunda copia de una clave de nivel superior existente:

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"

La configuración del proveedor y de la autenticación debe ser a nivel de usuario. Codex ignora model_provider y model_providers en el archivo .codex/config.toml del proyecto. El archivo TOML almacena únicamente el nombre de la variable de entorno; la Clave de API permanece en ~/.codex/.env.

La base_url es la raíz de la API, no una URL de operación. Con wire_api = "responses", Codex envía POST /v1/responses. Consulta la configuración personalizada de proveedor de modelos de OpenAI para conocer el contrato del proveedor.

Elegir un modelo

Reemplace YOUR_RUNAPI_MODEL_ID con el identificador exacto copiado del Catálogo de modelos. Seleccione un modelo que exponga la API de Responses; el soporte exclusivo de Chat Completions no es suficiente para esta configuración.

Cuando cambies model, reinicia completamente la aplicación e inicia una nueva tarea. Una tarea existente puede conservar el modelo y el proveedor con los que se inició.

Reiniciar y verificar

  1. Cierre por completo la aplicación de escritorio de ChatGPT y vuelva a abrirla.
  2. Abra Codex e inicie una nueva tarea en un repositorio.
  3. Envíe un mensaje breve como Describe this repository in one sentence.
  4. Confirme que Codex devuelve una respuesta normal y que RunAPI registra una solicitud POST /v1/responses para el modelo seleccionado.

La primera verificación debe ser breve para que los errores de configuración sean fáciles de distinguir del comportamiento específico de la tarea.

Agregar herramientas de RunAPI

El proveedor de modelos anterior enruta la inferencia de Codex a través de RunAPI. MCP es independiente: puede permitir que los clientes compatibles llamen a las herramientas de RunAPI para el descubrimiento de modelos, la información de cuenta y los flujos de trabajo de tareas compatibles.

La guía de Hosted MCP documenta los requisitos de cliente y autenticación compatibles actualmente. La autenticación de Hosted MCP específica de Codex no ha sido verificada, por lo que esta página no proporciona pasos de configuración de MCP para Codex. No reemplaces la configuración del proveedor de modelos con una entrada de servidor MCP; las dos integraciones tienen propósitos distintos.

Solución de problemas

  • Codex sigue usando el proveedor anterior: confirma que el archivo es ~/.codex/config.toml, elimina las claves model o model_provider duplicadas, reinicia completamente la aplicación e inicia una nueva tarea.
  • RUNAPI_API_KEY no está presente: confirma que la clave está en ~/.codex/.env y no solo en un perfil de terminal, luego reinicia la aplicación.
  • La autenticación falla: crea o rota una clave estándar a través de la Guía de autenticación. No pegues la clave en config.toml ni en los registros de soporte.
  • La solicitud devuelve 404: establece base_url en https://runapi.ai/v1, no en https://runapi.ai/v1/responses.
  • El modelo no está disponible o rechaza un campo: copia el identificador exacto de nuevo y confirma que el modelo admite la API de respuestas y la capacidad solicitada.
  • Codex selecciona un modelo diferente: verifica si hay una anulación de model en los archivos .codex/config.toml de proyectos de confianza. La configuración del proyecto puede seleccionar un modelo aunque no puede reemplazar el proveedor a nivel de usuario.
  • La CLI funciona pero la aplicación falla: verifica ~/.codex/.env y luego reinicia completamente la aplicación. Las aplicaciones GUI pueden no leer las variables exportadas únicamente por tu shell.
  • Una tarea en la nube no usa RunAPI: esta configuración local se aplica a los clientes Codex locales; las tareas en la nube alojadas no leen archivos de tu computadora.

Eliminar RunAPI

  1. Elimina los valores model, model_provider y [model_providers.runapi] de RunAPI en ~/.codex/config.toml, o restaura los valores del proveedor que usabas anteriormente.
  2. Elimina RUNAPI_API_KEY de ~/.codex/.env si ninguna otra herramienta local lo utiliza.
  3. Reinicia la aplicación completamente e inicia una nueva tarea.
  4. Revoca la clave dedicada en RunAPI cuando ya no sea necesaria.

Próximos pasos

Usa el Inicio rápido de la API LLM para el comportamiento compartido del protocolo y la Referencia de la API de Responses para los campos exactos de solicitud y respuesta. Continúa con el Catálogo de Modelos, la Guía de Autenticación o el MCP Hospedado según sea necesario.