Configuración de Codex CLI

Aprende a configurar Codex CLI para usar la API de Aiberm. Esta guía cubre la instalación y la configuración en Windows, macOS y Linux.

¿Qué es Codex CLI?

Codex CLI es la interfaz de línea de comandos de OpenAI diseñada para tareas de terminal relacionadas con código. Prioriza una salida lista para ingeniería, con cambios de código más claros y accionables que las herramientas de chat generales. Al configurarla para usar Aiberm, puedes acceder a varios modelos de IA a través de un endpoint rentable.

Requisitos previos

Antes de empezar, asegúrate de tener:

• Una cuenta de Aiberm (Regístrate aquí)
• Una clave de API de Aiberm (Obtén tu clave)
• Node.js v20 o superior con npm

Instalación

Instala Codex CLI de forma global con npm:

npm install -g @openai/codex

Verificar la instalación:

codex --version

Esto debería mostrar el número de versión.

Configuración

Codex CLI usa un archivo config.toml para la configuración. La ubicación del directorio de configuración varía según el sistema operativo:

• Windows: %userprofile%\.codex
• macOS/Linux: ~/.codex

Método 1: Configuración manual

Ve al directorio de configuración y crea o edita config.toml:

macOS/Linux:

mkdir -p ~/.codex
nano ~/.codex/config.toml

Windows:

mkdir $env:USERPROFILE\.codex -Force
notepad $env:USERPROFILE\.codex\config.toml

Agrega la siguiente configuración:

model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false

Importante: Sustituye sk-your-aiberm-api-key por tu clave de API real de Aiberm. La clave se guarda como texto sin cifrar en config.toml. No subas este archivo a Git ni lo compartas con otras personas.

Método 2: Configuración con un solo comando

macOS/Linux:

mkdir -p ~/.codex && cat > ~/.codex/config.toml << 'EOF'
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
EOF

Windows PowerShell:

$configPath = "$env:USERPROFILE\.codex"
New-Item -ItemType Directory -Force -Path $configPath | Out-Null
@"
model = "gpt-5.6-sol"
model_provider = "aiberm"
model_reasoning_effort = "xhigh"

[model_providers.aiberm]
name = "Aiberm API"
base_url = "https://aiberm.com/v1"
experimental_bearer_token = "sk-your-aiberm-api-key"
wire_api = "responses"
supports_websockets = false
"@ | Out-File -FilePath "$configPath\config.toml" -Encoding utf8

Importante: Sustituye sk-your-aiberm-api-key en la configuración por tu clave de API real de Aiberm. La clave se guarda como texto sin cifrar en config.toml. No subas este archivo a Git ni lo compartas con otras personas.

Verificar la configuración

Comprobar la instalación de Node.js:

node -v
npm -v

Verificar la instalación de Codex CLI:

codex --version

Probar la conexión a la API:

codex "Hi"

Si está configurado correctamente, Codex CLI debería responder usando la API de Aiberm.

Solución de problemas

Error 401 Unauthorized

• Verifica que tu clave de API sea correcta: Consola → API Keys
• Asegúrate de que experimental_bearer_token contenga tu clave de API real de Aiberm y que no se haya guardado el marcador de posición

Error 403 Forbidden

• Revisa la validez de tu clave de API
• Verifica el saldo de tu cuenta en https://aiberm.com/console
• Asegúrate de que tu clave de API tenga acceso al modelo solicitado

Errores de red

• Verifica tu conexión a internet
• Comprueba si puedes acceder a https://aiberm.com en el navegador
• Asegúrate de que el firewall permita conexiones HTTPS salientes
• Confirma que el base_url en config.toml sea correcto: https://aiberm.com/v1

La configuración no surte efecto

• Reinicia tu terminal después de editar config.toml
• Valida el formato de la sintaxis TOML (sin espacios extra, comillas correctas)
• Comprueba que la ubicación del archivo de configuración sea la correcta para tu sistema operativo
• Asegúrate de que el archivo se haya guardado como config.toml (no config.toml.txt)

No se encuentra el comando Codex

macOS/Linux:

# Check if npm global bin is in PATH
npm config get prefix

# If needed, add to PATH in ~/.zshrc or ~/.bashrc:
export PATH="$(npm config get prefix)/bin:$PATH"

Windows:

• Verifica que la ruta global de npm esté en el PATH del sistema
• Reinicia la terminal después de la instalación de npm