Codex (CLI de OpenAI)

Ejecuta las tareas locales nuevas de Codex a través de la API Responses en streaming de OneProvider.

Agente de programación Codex: CLI y app de escritorio

Qué funciona

Admite respuestas en streaming, llamadas a funciones, herramientas locales como apply_patch y contabilidad de consumo. Esto cambia las tareas locales nuevas de la CLI, el escritorio y el IDE; no cambia los chats en la nube de Codex.

Limitación del cliente

Reinicia Codex y crea una tarea local nueva después de cambiar el proveedor. Las tareas existentes conservan el modelo y el proveedor con los que empezaron.

Configuración

1. Instala o verifica Codex

   Si codex --version ya muestra una versión, continúa. Si no, instala la CLI actual.

   npm install --global @openai/codex
   codex --version

2. Deja disponible una clave dedicada

   Crea una clave de OneProvider dedicada y expórtala en la misma sesión de terminal desde la que inicias Codex.

   export ONEPROVIDER_API_KEY="sk-your-key-here"

3. Añade el proveedor personalizado

   Abre ~/.codex/config.toml (escritorio: Settings → Configuration → Open config.toml, es decir, Ajustes → Configuración → Abrir config.toml) y añade el proveedor de OneProvider.

   model_provider = "oneprovider"
   model = "gpt-6.1-sol"
   [model_providers.oneprovider]
   name = "OneProvider"
   base_url = "https://api.oneprovider.dev/v1"
   env_key = "ONEPROVIDER_API_KEY"
   wire_api = "responses"

4. Reinicia y prueba una tarea local nueva

   Quienes usan la CLI deben ejecutar una prueba de solo lectura. En el escritorio hay que cerrar la app por completo, volver a abrirla y empezar una tarea local nueva.

   codex

Verifica la conexión

Confirma la solicitud en tu Dashboard

La solicitud completada debe mostrar el modelo seleccionado, /v1/responses, el consumo de tokens y el importe cobrado.

Datos de conexión

Protocolo

responses

Endpoint

https://api.oneprovider.dev/v1

Seguridad de la clave

Usa una clave dedicada con alcance limitado. En macOS, una app de escritorio abierta desde el Dock puede no heredar las variables de entorno de la terminal; usa la autenticación del Llavero (Keychain) respaldada por comando de Codex en lugar de poner el secreto en config.toml.

Qué modelo elegir

Define model en el mismo config.toml, debajo de model_provider. gpt-6.1-sol es el nivel de gama alta para tareas de agente difíciles, gpt-6.1-terra es la opción equilibrada por defecto para el trabajo diario y gpt-5.6-luna es el nivel económico para tareas rápidas y de gran volumen. Codex usa la API Responses, así que elige ID de GPT en la página de modelos ; las tarifas están en la página de precios .

Errores frecuentes y soluciones

401 o “missing credentials”

Codex no ve ONEPROVIDER_API_KEY. Expórtala en la terminal que inicia Codex. En macOS, una app de escritorio abierta desde el Dock no la hereda: usa la autenticación del Llavero (Keychain) respaldada por comando.

404

base_url debe ser https://api.oneprovider.dev/v1 con /v1, y wire_api debe ser "responses".

Codex sigue usando el modelo o el proveedor anteriores

Las tareas existentes conservan el proveedor con el que empezaron. Reinicia Codex y crea una tarea local nueva.

“You've hit your usage limit” o Codex me pide iniciar sesión en ChatGPT

Ese es el límite de una suscripción de ChatGPT: la solicitud fue a ChatGPT, así que el proveedor de OneProvider no está activo. Pon model_provider = "oneprovider" al principio de config.toml, encima de cualquier [tabla] (sin comillas tipográficas), cierra Codex por completo y empieza una tarea local nueva. Luego cierra la sesión de ChatGPT con codex logout (app de escritorio: en sus ajustes) e inicia codex en la terminal donde esté exportada ONEPROVIDER_API_KEY: con el proveedor activo funciona solo con la clave. Prueba rápida: codex -c model_provider=oneprovider. wire_api solo acepta "responses".

429 “Insufficient balance”

Se agotó el saldo o el límite de la clave. Recarga el saldo; reintentar no ayuda.

Preguntas frecuentes

¿Esto cambia los chats en la nube de Codex?

No, solo las tareas locales nuevas de la CLI, el escritorio y el IDE.

¿Necesito una cuenta de OpenAI?

No, la clave de OneProvider la sustituye en las tareas locales.

¿Puedo usar modelos Claude en Codex?

Codex usa la API Responses con ID de GPT. Para Claude usa Claude Code .

¿Dónde compruebo el costo?

En la página Consumo del Dashboard: cada solicitud muestra el modelo, /v1/responses y el importe cobrado.

Respuestas rápidas

¿Qué base URL uso?

Claude Code y los SDK de Anthropic usan https://api.oneprovider.dev. Los SDK de OpenAI y los clientes compatibles con OpenAI usan https://api.oneprovider.dev/v1. Una misma clave funciona con ambas; la lista de modelos está en la página de modelos y las tarifas, en la página de precios .

¿Cómo me autentico?

Envía la clave sk-… tal cual en x-api-key o en Authorization: Bearer: en uno de los dos, nunca en ambos. Guarda la clave en una variable de entorno, no en un archivo que se suba al repositorio. Más sobre la autenticación .

¿Dónde obtengo una clave?

Abre tu panel en el bot de Telegram @oneprovider_robot o en app.oneprovider.dev, recarga el saldo y pulsa “Emitir una clave”. Cada clave puede tener su propio límite de gasto. Panel y claves de API .

¿Qué significan 401, 404 y 429?

401: falta la clave, está mal escrita o se envió en un encabezado equivocado; pega la clave completa, sin comillas ni espacios. 404: casi siempre es una base URL incorrecta, por ejemplo con /v1 ausente o duplicado. 429 con “Insufficient balance”: se agotó el saldo del panel o el límite de gasto de la clave, así que recarga en lugar de reintentar; cualquier otro 429 es un límite de frecuencia, así que espera según Retry-After. Detalles: códigos de error y solución de problemas .

¿Por qué se cortan o se reinician los streams?

Las VPN y los proxies VLESS suelen almacenar SSE en búfer o romper la negociación de HTTP/2. OneProvider no tiene restricciones regionales y no almacena los streams en búfer: desactiva el proxy y reintenta.

¿Dónde pregunto si esto no basta?

Escribe a @Oneproviderhelpbot en Telegram o abre “Soporte” en el panel web, con el código de estado HTTP y el mensaje de error exacto. Cómo funciona el soporte .