Skip to main content

Codex

Usa los modelos de Alibaba Cloud Model Studio en Codex.

Inicio rápido

  1. 1

    Abre o crea el archivo de configuración

    • macOS / Linux: ~/.codex/config.toml
    • Windows: C:\Users\<username>\.codex\config.toml
  2. 2

    Configura el modelo

    • Token Plan
    • Pago por uso
    • Coding Plan
    Reemplaza OPENAI_API_KEY por tu clave de API de Token Plan:
    model_provider = "Token_Plan"
model = "auto"

[model_providers.Token_Plan]
name = "Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
    Al usar qwen4-max-preview, mantén wire_api = "responses". La advertencia Model metadata ... not found no afecta a las llamadas.
  3. 3

    Verifica

    Ejecuta el siguiente comando en el directorio de tu proyecto:
    codex exec "Hello"

Configuración de Chat Completions

Codex 0.94.0 y versiones posteriores solo admiten la API de Responses. Si usas Codex 0.93.0 o una versión anterior, o si tu modelo solo admite Chat Completions, usa la siguiente configuración. Para obtener la ruta del archivo de configuración, consulta Inicio rápido.
  • Token Plan
  • Pago por uso
  • Coding Plan
Reemplaza OPENAI_API_KEY por tu clave de API de Token Plan:
model_provider = "Token_Plan"
model = "auto"

[model_providers.Token_Plan]
name = "Token_Plan"
base_url = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

Usar CC Switch

CC Switch es una interfaz gráfica de escritorio de código abierto de la comunidad que permite cambiar entre claves de API o planes de facturación.

Agregar un proveedor

  1. 1
    En la barra de herramientas de CC Switch, selecciona el icono de Codex, haz clic en + para abrir Agregar proveedor, selecciona la pestaña de tu plan de facturación, completa la configuración y haz clic en Agregar.
    • Token Plan
    • Pago por uso
    • Coding Plan
    • Nombre del proveedor: Bailian-Token Plan
    • Clave de API: Obtener desde la consola
    • Endpoint: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
  2. 2
    Expande Opciones avanzadas e introduce un modelo de los modelos compatibles para tu plan, como qwen3.8-max.
  3. 3
    Haz clic en Habilitar junto al proveedor, luego vuelve a abrir la terminal y ejecuta codex para que la configuración surta efecto.

Códigos de error

Si encuentras errores durante la configuración, consulta la documentación de preguntas frecuentes de tu plan de facturación:

Preguntas frecuentes

La configuración de pago por uso no cambia: use la clave de API general de Model Studio y la Base URL. Después de comprar un plan de ahorro, se activa automáticamente y el uso elegible se descuenta automáticamente. Consulte Planes de ahorro.
Causa: Algunas herramientas de gestión de terceros (como CC-Switch) envían un chequeo de estado o una prueba de conexión al cambiar de proveedor. El formato de la prueba difiere del formato de solicitud que Codex usa realmente, por lo que la puerta de enlace de Model Studio puede devolver 400 Bad request y la herramienta informa "domestic models not supported". Este mensaje solo indica que la prueba falló; no significa que Model Studio no admita modelos de China (continental), ni afecta el uso real de Codex.Solución: Configura Codex directamente en ~/.codex/config.toml como se describe en Inicio rápido, sin depender del chequeo de estado de la herramienta de terceros. Después de la configuración, sigue la sección Verifica para iniciar Codex; una respuesta normal significa que los modelos de China (continental) funcionan.
Causa: Codex 0.94.0 y versiones posteriores ya no admiten wire_api = "chat". Según la versión, puedes ver uno de los siguientes errores:
  • wire_api = "chat" is no longer supported
  • unknown configuration field wire_api
Solución:
  • Error wire_api = "chat" is no longer supported: cambia wire_api a responses y verifica base_url.
  • Error unknown configuration field wire_api: elimina wire_api de la sección del proveedor correspondiente en ~/.codex/config.toml.
  • Para seguir usando Chat Completions, instala Codex 0.93.0 o una versión anterior (como 0.80.0).
Causa:
  • La clave de API pertenece a otro plan (las claves de Token Plan, Coding Plan y Pago por uso no son intercambiables).
  • La suscripción ha caducado.
  • La clave de API se copió incorrectamente (incompleta, con espacios adicionales o con errores tipográficos).
Solución:
  • Confirma que estás usando la clave de API del plan seleccionado.
  • Revisa la página de gestión del plan para comprobar si la suscripción ha caducado.
  • Vuelve a copiar la clave de API y asegúrate de que esté completa y sin espacios.
  • Si el error persiste, restablece la clave de API en la página de gestión del plan y configura la nueva clave.
Causa: base_url o wire_api en el archivo de configuración son incorrectos.Solución: Asegúrate de que base_url y wire_api coincidan con la configuración de tu plan. Consulta Inicio rápido.
Causa: La conexión de transmisión entre Codex y el servidor se cerró antes de que se completara la respuesta. Causas comunes:
  • El hilo de conversación es demasiado largo y la compactación del contexto falla.
  • La red es inestable y la conexión SSE o WebSocket se interrumpe.
  • El servidor está sobrecargado o la limitación de velocidad termina la conexión antes de tiempo.
Solución:
  • Inicia un nuevo hilo de conversación para evitar la acumulación excesiva de contexto.
  • Comprueba la estabilidad de la red. Desactiva la VPN o el proxy y vuelve a intentarlo.
  • Espera y vuelve a intentarlo. Codex tiene un mecanismo de reintento integrado que resuelve la mayoría de las fallas transitorias.
Causa: Un error 429 tiene dos causas comunes:
  • Límite de velocidad de solicitudes (429 Requests rate limit exceeded): demasiadas solicitudes en un período corto.
  • Cuota agotada (429 Allocated quota exceeded o Your token-plan quota has been exhausted): la cuota mensual de Token Plan está agotada.
Solución:
  • Límite de velocidad de solicitudes: espera un minuto y reduce la tasa de solicitudes.
  • Cuota agotada: espera al siguiente mes de suscripción, compra un paquete de uso (la cuota se deduce automáticamente del paquete después de agotar la cuota mensual) o actualiza el plan. La hora de restablecimiento del mensaje de error (por ejemplo, The quota will reset at HH:MM:SS UTC) está en UTC; suma 8 horas para convertirla a la hora de Singapur (CST).