Saltar al contenido principal
Usa esta guía para ejecutar Codex CLI con CometAPI como proveedor de modelos. Referencias oficiales:
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

RequisitoDetalles
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), o Windows 11 mediante WSL2
Node.js22+ (se recomienda LTS)
GitSe recomienda 2.23+
Clave de CometAPIObté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.
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"

​
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íntomaSolución
API key auth is missing a keyAsegúrate de que ~/.codex/auth.json contenga "OPENAI_API_KEY": "sk-..."
Aparece inesperadamente el prompt de inicio de sesiónElimina el archivo obsoleto ~/.codex/auth.json y vuelve a crearlo con tu clave de CometAPI
Modelo no encontradoConsulta la página de Modelos para ver los modelos disponibles actualmente
Tiempo de espera de conexión agotadoConfirma que openai_base_url o base_url sea https://api.cometapi.com/v1 en config.toml
Problemas en WindowsCodex requiere WSL2 en Windows — CMD/PowerShell nativo no es compatible