Integrando Codex con modelos personalizados de CodingPlanX

Configura la CLI de OpenAI Codex utilizando tu Clave API de CodingPlanX.ai.

Guía de integración de Codex

CodingPlanX.ai admite no solo Claude Code, sino también la CLI de OpenAI Codex. Una vez que compras un plan, Claude Code y Codex comparten la misma cuota del plan, lo que te brinda la flexibilidad de elegir la herramienta que prefieras.

Instalar Codex CLI

npm install -g @openai/codex

Verifica la instalación:

codex --version

Última versión: v0.114.0 (2026-03-11), que incluye el sistema de Skills (Habilidades), el motor de Hooks y más.

Modelos disponibles

Puedes acceder a los siguientes modelos Codex/GPT a través de CodingPlanX.ai:

Todos los modelos comparten tu cuota del plan de CodingPlanX.ai con Claude Code.

Descripción general de la configuración

Codex CLI requiere dos archivos de configuración:

• ~/.codex/config.toml - Configuración del servicio
• ~/.codex/auth.json - Configuración de autenticación

---

Configuración para Windows

Paso 1: Crear directorio de configuración

mkdir %HOMEPATH%\.codex

Paso 2: Crear config.toml

Crea el archivo de configuración en ~/.codex/config.toml:

model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

Paso 3: Crear auth.json

Crea el archivo de autenticación en ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}

Reemplaza cr_xxxxxxxxxx con tu Clave API de CodingPlanX.ai.

Paso 4: Establecer variables de entorno (Opcional)

Si prefieres proporcionar tu clave a través de variables de entorno:

# Configuración temporal
$env:CRS_OAI_KEY = "cr_xxxxxxxxxx"

# Configuración permanente
[System.Environment]::SetEnvironmentVariable("CRS_OAI_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)

Luego establece OPENAI_API_KEY en null en tu auth.json.

---

Configuración para macOS

Paso 1: Crear directorio de configuración

mkdir -p ~/.codex

Paso 2: Crear config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

Paso 3: Crear auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

Reemplaza cr_xxxxxxxxxx con tu Clave API de CodingPlanX.ai.

Paso 4: Establecer variables de entorno (Opcional)

Si prefieres proporcionar tu clave a través de variables de entorno:

# Configuración temporal
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# Configuración permanente
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Luego establece OPENAI_API_KEY en null en tu auth.json.

---

Configuración para Linux

Paso 1: Crear directorio de configuración

mkdir -p ~/.codex

Paso 2: Crear config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

Paso 3: Crear auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

Reemplaza cr_xxxxxxxxxx con tu Clave API de CodingPlanX.ai.

Paso 4: Establecer variables de entorno (Opcional)

Si prefieres proporcionar tu clave a través de variables de entorno:

# Configuración temporal
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# Configuración permanente (Bash)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

# Configuración permanente (Zsh)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Luego establece OPENAI_API_KEY en null en tu auth.json.

---

Verificar configuración

Después de configurar, ejecuta la CLI de Codex para verificar:

codex

Indicadores de éxito

• Codex se inicia normalmente y se conecta al servicio.
• Puedes generar código y recibir respuestas de la IA.
• Las solicitudes de red se enrutan correctamente a través del proxy de CodingPlanX.ai.

Preguntas frecuentes / Resolución de problemas

Archivo de configuración no encontrado

Problema: Codex indica que no se puede encontrar el archivo de configuración.

Solución:

1. Verifica si la ruta de configuración es correcta.
2. Asegúrate de que exista el directorio ~/.codex/.
3. Verifica que tanto config.toml como auth.json estén presentes.

Autenticación de Clave API fallida

Problema: Variable de entorno no válida o clave API incorrecta.

Solución:

1. Verifica si la variable de entorno CRS_OAI_KEY está configurada correctamente.
2. Verifica el formato de tu clave API (comienza con cr_).
3. Asegúrate de que la clave no haya caducado verificando en la Consola.

Problemas de conexión de red

Problema: No se puede conectar a los servicios de CodingPlanX.ai.

Solución:

1. Verifica tu conexión a Internet.
2. Verifica que base_url esté configurada correctamente en https://api.codingplanx.ai.