Usar Codex con CometAPI

Usa esta guía para ejecutar Codex con CometAPI como proveedor de modelos. Referencias oficiales:

Requisitos previos

Requisito	Detalles
SO	macOS, Linux, PowerShell nativo de Windows o Windows con WSL
Git	Se recomienda 2.23+
Codex	Instala la aplicación Codex o Codex CLI desde el inicio rápido de Codex
Clave de API de CometAPI	Obtén una desde el panel de CometAPI
Model ID	Usa un model ID de la página de modelos

Elige una ruta de configuración

Ofrecemos dos opciones para ayudarte a configurar Codex rápidamente.

Opción 1: Configurar Codex manualmente (recomendado)

Edita directamente el archivo ~/.codex/config.toml a nivel de usuario. Esta es la ruta más fiable, especialmente para usuarios de Windows y WSL.

Opción 2: Configurar mediante script

Ejecuta el script de configuración como atajo. Escribe la misma configuración del proveedor y almacena la clave de API de CometAPI para Codex.

Configurar Codex manualmente

Codex lee los valores predeterminados personales del proveedor desde el archivo ~/.codex/config.toml a nivel de usuario. Configura el proveedor CometAPI allí, no en un archivo .codex/config.toml del proyecto. Codex ignora la configuración de provider y provider-auth en los archivos de configuración del proyecto. La configuración recomendada usa un proveedor con nombre cometapi y autenticación respaldada por comandos. Esto mantiene CometAPI separado del proveedor OpenAI integrado, no requiere herencia de variables de entorno del shell y no reemplaza ~/.codex/auth.json.

macOS / Linux / WSL
Windows PowerShell

Guarda tu clave de API de CometAPI en un archivo de clave local:

mkdir -p "$HOME/.codex"
printf "%s\n" "$COMETAPI_KEY" > "$HOME/.codex/cometapi_key"
chmod 600 "$HOME/.codex/cometapi_key"

Agrega esta configuración a ~/.codex/config.toml:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "sh"
args = ["-c", "cat \"$HOME/.codex/cometapi_key\""]

Guarda tu clave de API de CometAPI en el directorio de inicio de Codex en Windows:

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Content -NoNewline -Path "$HOME\.codex\cometapi_key" -Value $env:COMETAPI_KEY

Agrega esta configuración a $HOME\.codex\config.toml:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"

[model_providers.cometapi.auth]
command = "powershell.exe"
args = [
  "-NoProfile",
  "-Command",
  "$p=Join-Path $HOME '.codex/cometapi_key'; (Get-Content -Raw $p).Trim()",
]

Codex nativo de Windows usa $HOME\.codex, normalmente C:\Users\<user>\.codex. WSL usa ~/.codex de la distribución Linux. Edita el directorio que coincida con el entorno donde se ejecuta el agente de Codex.

Usar autenticación con variable de entorno

Si prefieres mantener la clave de API de CometAPI en una variable de entorno, usa env_key en lugar del bloque [model_providers.cometapi.auth]. Usa esta configuración del proveedor solo cuando COMETAPI_KEY esté disponible en el entorno que inicia Codex:

model_provider = "cometapi"
model = "your-model-id"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
wire_api = "responses"
env_key = "COMETAPI_KEY"

No combines env_key con [model_providers.cometapi.auth]. Codex admite un método de autenticación por proveedor personalizado.

Ejecuta el script de configuración

El script de configuración es opcional. Escribe la misma configuración del proveedor cometapi en ~/.codex/config.toml, guarda tu clave API de CometAPI en ~/.codex/cometapi_key, crea copias de seguridad antes de modificar archivos y verifica la configuración con codex exec cuando la CLI de Codex está disponible. Para macOS, Linux o WSL, ejecuta el instalador interactivo:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh)"

Para una configuración no interactiva, pasa la clave API explícitamente:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY"

Para PowerShell nativo de Windows, ejecuta el instalador interactivo:

powershell -c "irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1' | iex"

Para una configuración no interactiva en Windows, pasa la clave API explícitamente:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY"

De forma predeterminada, el script no reemplaza ~/.codex/auth.json y no elimina un inicio de sesión de ChatGPT. Usa --force-auth-json o -ForceAuthJson solo si quieres que el script gestione el inicio de sesión con clave API de Codex mediante auth.json.

Elige o cambia un model ID

Usa un model ID de la página de modelos. En la configuración manual, cambia el valor de model en ~/.codex/config.toml. Para macOS, Linux o WSL, pasa --model cuando ejecutes el script de configuración:

curl -fsSL https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.sh | sh -s -- --key "$COMETAPI_KEY" --model your-model-id

Para PowerShell nativo de Windows, pasa -Model cuando ejecutes el script de configuración:

powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/cometapi-dev/integrations/main/codex/setup.ps1'))) -Key $env:COMETAPI_KEY -Model 'your-model-id'"

El script usa CODEX_HOME cuando está definido. De lo contrario, escribe en el ~/.codex del entorno actual.

Verifica la configuración

Para verificar la configuración con la CLI de Codex, ejecuta este comando de solo lectura desde cualquier proyecto local:

codex exec --ephemeral --skip-git-repo-check --sandbox read-only --color never "Reply exactly with: COMETAPI_CODEX_OK"

Si la CLI de Codex no está disponible en PATH, abre la app de Codex y envía un prompt breve desde un proyecto local.

Solución de problemas

Codex sigue usando el proveedor predeterminado de OpenAI

Confirma que model_provider = "cometapi" esté en el archivo ~/.codex/config.toml a nivel de usuario.

La clave de API cambió

Actualiza ~/.codex/cometapi_key, o vuelve a ejecutar el script de configuración con el valor actualizado de $COMETAPI_KEY.

El script de PowerShell falla durante las comprobaciones previas

Usa los pasos manuales de PowerShell nativo de Windows y luego ejecuta el comando de verificación.

La configuración de shell con tubería no solicita ninguna clave de API

Usa --key "$COMETAPI_KEY", configura COMETAPI_KEY, o ejecuta el comando interactivo sh -c "$(curl ...)".

La conexión agota el tiempo de espera o usa la URL base incorrecta

Confirma que base_url sea https://api.cometapi.com/v1 en ~/.codex/config.toml.

No se encuentra el modelo

Consulta la página de modelos para ver los model IDs disponibles.

La configuración de Windows afecta al entorno incorrecto

Edita $HOME\.codex para el modo nativo de Windows, o edita ~/.codex dentro de WSL para el modo de agente WSL.

El inicio de sesión de ChatGPT cambió

No uses --force-auth-json ni -ForceAuthJson a menos que quieras el modo de inicio de sesión con clave de API.

Resumen general

Agentes de codificación de IA

Agentes de IA

Clientes de chat de IA

Traducción e idioma

Plataformas de automatización

Observabilidad y evaluación

Frameworks de IA

Requisitos previos

Elige una ruta de configuración

Opción 1: Configurar Codex manualmente (recomendado)

Opción 2: Configurar mediante script

Configurar Codex manualmente

Usar autenticación con variable de entorno

Ejecuta el script de configuración

Elige o cambia un model ID

Verifica la configuración

Solución de problemas

​Requisitos previos

​Elige una ruta de configuración

Opción 1: Configurar Codex manualmente (recomendado)

Opción 2: Configurar mediante script

​Configurar Codex manualmente

​Usar autenticación con variable de entorno

​Ejecuta el script de configuración

​Elige o cambia un model ID

​Verifica la configuración

​Solución de problemas

Requisitos previos

Elige una ruta de configuración

Configurar Codex manualmente

Usar autenticación con variable de entorno

Ejecuta el script de configuración

Elige o cambia un model ID

Verifica la configuración

Solución de problemas