--- title: Codex App | RunAPI description: Usa RunAPI como proveedor de modelos en Codex App, elige un modelo compatible con Responses y verifica la conexión. url: https://runapi.ai/es/docs/resources/tool-integrations/codex-app.md canonical: https://runapi.ai/es/docs/resources/tool-integrations/codex-app locale: es --- > Versión HTML: https://runapi.ai/es/docs/resources/tool-integrations/codex-app > Índice del sitio para agentes: https://runapi.ai/llms.txt # Codex App ## 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](https://runapi.ai/es/docs/resources/mcp/hosted.md) es una integración independiente con sus propios requisitos de cliente y autenticación. ## Antes de comenzar * Instale la versión actual de la [aplicación de escritorio de ChatGPT][1], inicie sesión y abra Codex al menos una vez. * Cree una Clave de API de RunAPI estándar exclusiva siguiendo la [Guía de Autenticación](https://runapi.ai/es/docs/guides/authentication.md). No confirme la clave en un repositorio. * Desde el [Catálogo de modelos](https://runapi.ai/es/models), copie el identificador exacto de un modelo que sea compatible con la Responses API. [1]: https://developers.openai.com/codex/app 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][1] de OpenAI para conocer el contrato del proveedor. [1]: https://developers.openai.com/codex/config-advanced#custom-model-providers ## Elegir un modelo Reemplace `YOUR_RUNAPI_MODEL_ID` con el identificador exacto copiado del [Catálogo de modelos](https://runapi.ai/es/models). 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](https://runapi.ai/es/docs/resources/mcp/hosted.md) 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](https://runapi.ai/es/docs/guides/authentication.md). 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](https://runapi.ai/es/docs/guides/llm-api/quickstart.md) para el comportamiento compartido del protocolo y la [Referencia de la API de Responses](https://runapi.ai/es/docs/api/openai/responses.md) para los campos exactos de solicitud y respuesta. Continúa con el [Catálogo de Modelos](https://runapi.ai/es/models), la [Guía de Autenticación](https://runapi.ai/es/docs/guides/authentication.md) o el [MCP Hospedado](https://runapi.ai/es/docs/resources/mcp/hosted.md) según sea necesario. --- ## Más de RunAPI - [Inicio](https://runapi.ai/es/.md) - [Catálogo de modelos](https://runapi.ai/es/models.md) - [Precios](https://runapi.ai/es/pricing.md) - [Proveedores](https://runapi.ai/es/models) - [Documentación](https://runapi.ai/es/docs/guides) - [SDKs](https://runapi.ai/es/sdk.md) - [CLI](https://runapi.ai/es/cli.md) - [Servidor MCP](https://runapi.ai/es/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/es/claude-code-vs-cursor.md) - [Configuración de Cursor API](https://runapi.ai/es/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/es/openrouter-alternative.md) - [Enterprise](https://runapi.ai/es/contact.md) - [Contacto](https://runapi.ai/es/contact.md) - [Términos](https://runapi.ai/es/terms.md) - [Privacidad](https://runapi.ai/es/privacy.md) - [Índice del sitio para agentes](https://runapi.ai/llms.txt) Contacto: contact@runapi.ai ## Datos estructurados ```json [ { "@context": "https://schema.org", "inLanguage": "es", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/es", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/es/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/es", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/esicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "es", "@type": "TechArticle", "headline": "Codex App", "description": "Usa RunAPI como proveedor de modelos en Codex App, elige un modelo compatible con Responses y verifica la conexión.", "url": "https://runapi.ai/es/docs/resources/tool-integrations/codex-app", "mainEntityOfPage": "https://runapi.ai/es/docs/resources/tool-integrations/codex-app" } ] ```