Codex · Relay

Relay de Codex: accede a la API de Codex desde China

Codex CLI, la extensión de VS Code y la aplicación de escritorio admiten proveedores de modelos personalizados. Apunta base_url a AICodeWith, coloca tu clave en auth.json y podrás usar Codex directamente desde redes en China. Se factura por token con cargo a tu saldo de prepago, sin necesidad de un plan de ChatGPT.

Última comprobación

Cómo funciona el relay de Codex

De forma predeterminada, Codex usa el inicio de sesión con una cuenta de ChatGPT o una clave API de OpenAI. También te permite declarar un model_provider en config.toml: Codex envía las solicitudes al base_url de ese proveedor y se autentica con la clave de auth.json. El relay proporciona una interfaz compatible, por lo que no es necesario modificar Codex.

Este enfoque se factura por uso de la API y no pasa por ningún plan de pago de ChatGPT.

Pasos de configuración (CLI, VS Code, escritorio)

  1. 1. Instala Codex

    Instala @openai/codex desde la línea de comandos con npm; para la extensión de VS Code y la aplicación de escritorio, consulta la página de descarga.

    Terminal
    npm install -g @openai/codex
  2. 2. Obtén una clave

    Crea una clave en la página Claves API de la consola de AICodeWith.

  3. 3. Escribe auth.json

    Coloca la clave en ~/.codex/auth.json (en Windows: %USERPROFILE%\.codex\auth.json).

    ~/.codex/auth.json
    {
      "OPENAI_API_KEY": "你的_API_KEY"
    }
  4. 4. Escribe config.toml y reinicia

    Escribe config.toml con el ejemplo de la siguiente sección y luego reinicia el terminal, VS Code o la aplicación de escritorio. Los tres leen el mismo directorio ~/.codex.

Descarga de Codex (CLI / escritorio / VS Code)Referencia de auth.json

Ejemplo de config.toml

~/.codex/config.toml
model_provider = "codex"
model = "gpt-5.6-sol"

[model_providers.codex]
name = "codex"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
requires_openai_auth = true
supports_websockets = false

model se puede cambiar por cualquier otro modelo compatible con Codex que aparezca en la página de modelos. Guarda el archivo y vuelve a abrir Codex para que el cambio surta efecto.

Referencia completa de config.toml

Precios y facturación

Los tokens de entrada y salida se descuentan de tu saldo de prepago según el uso real, y el uso por solicitud es visible en la consola. El saldo es válido durante 12 meses y no se restablece cada mes. Los precios en tiempo real por modelo aparecen en la página de modelos.

Modelos y precios de OpenAIRecargar y planes

Cómo elegir un proveedor de relay

  • Que el relay admita la API responses que requiere Codex (wire_api = "responses"); los relays que no la admitan devolverán un error de inmediato.
  • Que la facturación sea transparente: ¿puedes ver el uso de tokens por solicitud y establecer un límite de gasto en cada clave?
  • Que se mantenga estable en horas punta y que puedas cambiar entre varios canales.
  • Que exista una política de reembolso clara. AICodeWith: el saldo no utilizado se puede reembolsar en un plazo de 90 días, menos una comisión de tramitación del 10%. Consulta la política de reembolso para más detalles.

Errores comunes

ErrorCausa comúnSolución
401 UnauthorizedLa clave de auth.json es incorrecta o tiene espacios adicionales, o todavía hay una OPENAI_API_KEY antigua en las variables de entornoVuelve a copiar la clave, revisa las variables de entorno y reinicia Codex
429 Too Many RequestsLa concurrencia o la tasa de solicitudes es demasiado alta, o tu saldo/límite de gasto es insuficienteReduce la concurrencia, vuelve a intentarlo más tarde y comprueba el saldo y el límite de gasto de la clave
Tiempo de conexión agotadobase_url es incorrecto o un proxy local está interfiriendoComprueba base_url, desactiva el proxy temporalmente y vuelve a intentarlo

Solución de problemas 401 de CodexSolución de problemas 429 de Codex

FAQ

¿Cómo uso un relay de Codex?

Crea una clave en la consola, colócala en ~/.codex/auth.json, configura el base_url de model_provider en ~/.codex/config.toml con AICodeWith y reinicia Codex.

¿Puedo usar una clave que no sea la de una cuenta de ChatGPT?

Sí. Codex admite proveedores de modelos personalizados; puedes usar en su lugar una clave API de relay, sin necesidad de una cuenta de ChatGPT ni de un plan de pago.

¿Qué modelos son compatibles?

Admite los modelos de la serie GPT que puede usar Codex. Para ver la lista exacta y los precios en tiempo real, consulta la página de modelos de OpenAI; cambia mediante el campo model de config.toml.

¿Qué hago si recibo 401 / 429?

401 suele significar que la clave es incorrecta o que queda una variable de entorno antigua; vuelve a copiar la clave y reinicia. 429 significa demasiada concurrencia o un saldo/límite insuficiente; reduce la concurrencia y comprueba tu saldo.

¿Cómo compro saldo?

Después de registrarte, recarga o compra un plan de prepago en la página de recarga con métodos de pago locales de China. Se te factura según el uso y el saldo es válido durante 12 meses sin restablecimiento mensual.

¿Listo para probarlo?

El cobro es por token desde un saldo prepago. Se aplican límites de velocidad y concurrencia, y puedes establecer topes de gasto diarios, mensuales o totales en cada clave de API.

Relacionado

AICodeWith es un servicio API independiente de terceros y no está afiliado a Anthropic ni a OpenAI. Claude, Claude Code, Codex y nombres similares pertenecen a sus respectivos propietarios. Los precios están sujetos a los datos en tiempo real de la página de modelos; se aplican límites de velocidad y concurrencia; los reembolsos están sujetos a una comisión de tramitación del 10%. Consulta la política de reembolso para más detalles.