Documentación / API de Codex

Codex CLI: configuración de la clave de API y de un proveedor personalizado

Usa esta guía para conectar tu trabajo local en Codex CLI a AI Prime Tech. Necesitas una cuenta del gateway, una clave activa en el grupo de Codex correspondiente y un modelo disponible para esa clave. Empieza por la descripción general de la API de Codex si todavía estás eligiendo un tipo de acceso.

1. Comprueba la clave y el grupo

Crea una clave en el panel. El acceso prepago a GPT utiliza el grupo Codex grupo. Si se ofrece acceso a Codex por tiempo limitado, usa el grupo y las condiciones indicados para ese plan; el acceso a Claude es independiente. Confirma la lista de modelos de la clave que vayas a usar.

Configura la clave en la terminal actual. Sustituye el marcador de posición localmente; no incluyas la clave en un commit de un repositorio.

PowerShell

$env:AIPRIMETECH_API_KEY = "YOUR_GATEWAY_KEY"

bash o zsh

export AIPRIMETECH_API_KEY="YOUR_GATEWAY_KEY"

Si una terminal o un editor iniciado antes de configurar su entorno no puede ver la variable, reinícialo. Estos ejemplos la configuran para el proceso actual y sus procesos secundarios.

2. Configura el proveedor

Integra esto en tu archivo de configuración de usuario ~/.codex/config.toml. En Windows, la ruta equivalente es %USERPROFILE%\.codex\config.toml. Las credenciales del proveedor deben estar en la configuración de usuario, no en el archivo del repositorio .codex/config.toml.

model_provider = "aiprimetech"
model = "gpt-6.1-sol"

[model_providers.aiprimetech]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIMETECH_API_KEY"
wire_api = "responses"
supports_websockets = false

Usa un ID de proveedor como aiprimetech y mantén model_provider en correspondencia con su tabla. La versión actual de Codex utiliza el protocolo Responses. La URL base es la raíz del gateway /v1 ; Codex añade la ruta de la solicitud. Esta configuración utiliza el transporte HTTP/SSE.

3. Verifica la conexión

Ejecuta codex doctor para inspeccionar la configuración de tu CLI. Inicia codexy luego usa /status para confirmar el proveedor y el modelo. Pide una respuesta breve antes de permitir una tarea más amplia en el repositorio. Comprueba que la solicitud aparezca en tu página de uso de AI Prime Tech.

Puedes consultar la lista de modelos de la clave independientemente de Codex:

Invoke-RestMethod -Uri "https://aiprimetech.io/v1/models" -Headers @{Authorization="Bearer $env:AIPRIMETECH_API_KEY"}

curl --fail-with-body https://aiprimetech.io/v1/models \
  -H "Authorization: Bearer $AIPRIMETECH_API_KEY"

Si el catálogo devuelto incluye tu modelo pero la solicitud falla, comprueba el error concreto y la disponibilidad actual del grupo. Que un ID aparezca en la lista no significa que la prueba de inferencia haya sido satisfactoria.

Mantén un perfil de CLI opcional

Para seleccionar este proveedor solo en determinadas sesiones de CLI, coloca la configuración anterior en ~/.codex/aiprimetech.config.toml y ejecuta:

codex --profile aiprimetech

En Codex 0.134.0 y versiones posteriores, los perfiles de CLI utilizan archivos separados. Los ejemplos antiguos de [profiles.aiprimetech] no corresponden al formato actual de perfiles. La extensión del IDE utiliza la configuración de usuario; verifica su proveedor activo después de reiniciarla en lugar de asumir que el cambio de perfil de CLI también se ha aplicado allí.

Elige un modelo

Usa gpt-6.1-sol como punto de partida para programar, gpt-6-astra para tareas exigentes, o gpt-6-luna para trabajo específico. gpt-6-sol es un ID independiente para los flujos de trabajo existentes de Sol. Consulta los detalles del modelo y cómo compararlos.

Resolución de problemas

Síntoma Comprueba
Falta la variable de entorno Configura AIPRIMETECH_API_KEY en el proceso que inicia Codex.
Error de autenticación 401 Confirma que la clave esté activa, se haya copiado por completo y haya sido emitida por esta pasarela.
403 o modelo no disponible Confirma el grupo de la clave, el acceso del plan y el ID exacto del modelo.
404 o una respuesta HTML Usa https://aiprimetech.io/v1; elimina el duplicado de /v1 o un elemento añadido de /responses.
wire_api rechazado Usa responses; los antiguos chat ejemplos de proveedores están obsoletos.
Error de saldo, plan o límite de solicitudes Lee el error, revisa tu cuenta y reduce el trabajo simultáneo antes de volver a intentarlo.
La conexión se interrumpe durante la respuesta Prueba con una solicitud breve, comprueba la conectividad de la red o del proxy y guarda el ID de la solicitud para el equipo de soporte.

Claude y las funciones alojadas de Codex

Para usar Claude mediante la traducción de Responses de la pasarela, sigue Claude con Codex con una clave compatible del grupo Claude. El ejemplo de GPT anterior es para el acceso del grupo Codex.

El acceso a la pasarela no otorga derechos de uso del espacio de trabajo de ChatGPT ni acceso a Codex en la nube. Consulta la comparación de métodos de inicio de sesión para conocer los límites del producto.

Referencias