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. 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.
Terminalnpm install -g @openai/codex2. Obtén una clave
Crea una clave en la página Claves API de la consola de AICodeWith.
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. 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
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 = falsemodel 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.
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.
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
| Error | Causa común | Solución |
|---|---|---|
| 401 Unauthorized | La clave de auth.json es incorrecta o tiene espacios adicionales, o todavía hay una OPENAI_API_KEY antigua en las variables de entorno | Vuelve a copiar la clave, revisa las variables de entorno y reinicia Codex |
| 429 Too Many Requests | La concurrencia o la tasa de solicitudes es demasiado alta, o tu saldo/límite de gasto es insuficiente | Reduce 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 agotado | base_url es incorrecto o un proxy local está interfiriendo | Comprueba 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.