Codex CLI

Configura OpenAI Codex CLI con CometAPI: establece openai_base_url o un proveedor personalizado en config.toml, guarda tu clave de API en auth.json y empieza a programar con un modelo actual.

Usa esta guía para ejecutar Codex CLI con CometAPI como proveedor de modelos.

Referencias oficiales:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

La disponibilidad de modelos cambia con frecuencia. Los ejemplos a continuación usan your-model-id — sustitúyelo por un ID de modelo actual adecuado para programación desde la página de Modelos de CometAPI.

​

Requisitos previos

Requisito	Detalles
OS	macOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), o Windows 11 mediante WSL2
Node.js	22+ (se recomienda LTS)
Git	Se recomienda 2.23+
Clave de CometAPI	Obtén una en el Panel de CometAPI (empieza con sk-)

​

Instalar Codex CLI

npm i -g @openai/codex

O mediante Homebrew:

brew install --cask codex

Verifica la instalación:

codex --version

​

Configurar CometAPI

Hay dos formas de apuntar Codex a CometAPI. Elige la que mejor se adapte a tu flujo de trabajo.

Simple: openai_base_url

La opción más sencilla: redirigir el proveedor OpenAI integrado a CometAPI con una sola línea. No necesitas definir un proveedor personalizado.

Crea ~/.codex/config.toml:

model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

Proveedor con nombre

Define un proveedor cometapi con nombre. Es útil cuando quieres cambiar entre varios proveedores usando --profile o model_provider.

Crea ~/.codex/config.toml:

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

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

env_key le indica a Codex qué variable de entorno contiene tu clave de API. Codex lee el valor de OPENAI_API_KEY en tiempo de ejecución — esta no es tu clave real.

​

Guarda tu clave de API

Crea ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}

Sustituye sk-your-cometapi-key por tu clave real de CometAPI.

Este archivo es obligatorio. Sin una entrada válida de OPENAI_API_KEY en auth.json, Codex finaliza con API key auth is missing a key.

​

Iniciar Codex

cd your-project
codex

En el primer inicio, Codex te pedirá que elijas un tema y confirmes la configuración de seguridad.

​

Sobrescribir el modelo por sesión

Cambia a un modelo diferente para una sola ejecución sin editar config.toml:

codex --model your-model-id

​

Alternativa: variable de entorno

En lugar de auth.json, exporta la clave directamente:

export OPENAI_API_KEY="sk-your-cometapi-key"
codex

Esto establece la clave solo para la sesión actual de terminal. Para que persista, añade la línea export a ~/.zshrc o ~/.bashrc.

​

Solución de problemas

Síntoma	Solución
API key auth is missing a key	Asegúrate de que ~/.codex/auth.json contenga "OPENAI_API_KEY": "sk-..."
Aparece inesperadamente el prompt de inicio de sesión	Elimina el archivo obsoleto ~/.codex/auth.json y vuelve a crearlo con tu clave de CometAPI
Modelo no encontrado	Consulta la página de Modelos para ver los modelos disponibles actualmente
Tiempo de espera de conexión agotado	Confirma que openai_base_url o base_url sea https://api.cometapi.com/v1 en config.toml
Problemas en Windows	Codex requiere WSL2 en Windows — CMD/PowerShell nativo no es compatible