Codex CLI

Visión general

Tipo: Herramienta de programaciónRuta principal: OpenAI Responses (ruta opcional avanzada)Confianza de soporte: Compatible con límites de modelo/ruta

OpenAI Codex es una herramienta de línea de comandos (CLI) de código abierto que actúa como un agente de codificación ligero, capaz de leer, modificar y ejecutar código en el terminal. Está construida sobre modelos GPT y optimizada para la generación de código. Para TokenLab, Codex CLI puede usar /v1/responses, pero debes considerarlo como una ruta de compatibilidad avanzada. Algunas características exclusivas de Responses no están garantizadas en todos los modelos y rutas enrutadas. La compactación remota de Codex CLI es compatible en POST /v1/responses/compact. Codex envía el model de la sesión actual en body.model para /compact y auto-compactación, así que el modelo que quieras usar para compactar debe estar disponible en la ruta Responses. No configures /v1/compact.

Requisitos del sistema

OS: macOS, Linux (soporte oficial), Windows vía WSL
Node.js: Versión 18+
npm: Versión 10.x.x o superior

Instalación

npm install -g @openai/codex

Verificar la instalación:

codex --version

Configuración

Paso 1: Establecer la clave de API

Temporal (sesión actual):

export OPENAI_API_KEY="sk-your-tokenlab-key"

Configuración permanente: Añade a ~/.bashrc, ~/.zshrc, o ~/.bash_profile:

export OPENAI_API_KEY="sk-your-tokenlab-key"

Luego recarga:

source ~/.zshrc  # or source ~/.bashrc

Paso 2: Configurar config.toml

Edita ~/.codex/config.toml:

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_context_window = 258000
model_auto_compact_token_limit = 232200
sandbox_mode = "danger-full-access"
approval_policy = "never"

personality = "friendly"
service_tier = "fast"

[model_providers.tokenlab]
env_key = "OPENAI_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

[features]
fast_mode = true

Este modo WebSocket es un puente Responses-over-WebSocket para clientes Codex. Solo acepta eventos oficiales response.create; stream es implícito y background y response.cancel no están disponibles en este transporte. No es la API OpenAI Realtime y no acepta session.update, conversation.item.*, input_audio_buffer.*, audio binario ni sobres Realtime anidados response.create.response.

Si el archivo de configuración no existe, ejecuta codex una vez para generarlo y luego edita el archivo. Reinicia Codex completamente después de cambiar config.toml para que se recarguen los nuevos ajustes del proveedor.

Codex está desaprobando el soporte de chat/completions para proveedores personalizados. Mantén wire_api = "responses" para TokenLab a menos que estés utilizando intencionalmente una ruta de compatibilidad más antigua.

TokenLab reenvía los campos Responses desconocidos con el mejor esfuerzo sin degradar silenciosamente la solicitud a Chat Completions. El upstream seleccionado decide si admite el campo o la combinación.

Uso básico

Iniciar modo interactivo:

codex

Comando directo:

codex "Fix the bug in main.py line 42"

Especificar modelo:

codex -m gpt-5.6-sol "Build a REST API server"

Modelos recomendados

Modelo	Mejor para
`gpt-5.6-sol`	Mejor opción predeterminada para codificación y razonamiento
`gpt-5-mini`	Alternativa más rápida y económica para flujos de trabajo de codificación
`claude-sonnet-4-6`	Revisión de código, documentación
`deepseek-r1`	Diseño de algoritmos, razonamiento

Comandos interactivos

Comando	Descripción
`/help`	Mostrar ayuda
`/exit` or `Ctrl+C`	Salir
`/clear`	Borrar conversación
`/config`	Ver configuración
`/model <name>`	Cambiar modelo
`/tokens`	Ver uso de tokens

Verificar configuración

# Check environment variable
echo $OPENAI_API_KEY

# Test API connection
codex "Hello, Codex!"

# View configuration
cat ~/.codex/config.toml

Casos de uso comunes

Revisión de código:

git diff | codex "Review these code changes"

Generar mensajes de commit:

git diff --staged | codex "Generate a commit message for these changes"

Corregir errores:

codex "Fix the TypeScript errors in src/components/"

Explicar código:

cat main.py | codex "Explain what this code does"

Solución de problemas

Error de conexión

Verifica que base_url en config.toml sea exactamente https://api.tokenlab.sh/v1
Comprueba la conectividad de red
Asegúrate de que no haya interferencia de proxy

Autenticación fallida

Verifica que env_key = "OPENAI_API_KEY" esté presente en ~/.codex/config.toml
Verifica que la variable de entorno OPENAI_API_KEY esté configurada
Comprueba que la clave comience con sk-
Asegúrate de que la clave esté activa en el panel de TokenLab

Modelo no encontrado

Revisa que el nombre del modelo coincida exactamente
Verifica la disponibilidad del modelo en tokenlab.sh/en/models

Campo nativo de Responses rechazado

Algunos campos solo están disponibles en /v1/responses cuando TokenLab puede garantizar ese comportamiento para el modelo y la ruta seleccionados
Si ves unsupported_request_field, elimina ese campo o cambia a un flujo de trabajo que no dependa de él

/compact o auto-compactación falla

Codex CLI llama a POST /v1/responses/compact, no a /v1/compact
La solicitud de compactación usa el model de la sesión actual, por lo que ese modelo debe estar disponible en la ruta Responses
Mantén wire_api = "responses" y base_url = "https://api.tokenlab.sh/v1"

Matriz de compatibilidad

Herramientas de código

SDKs nativos

Frameworks y plataformas

Apps de chat

Visión general

Requisitos del sistema

Instalación

Configuración

Paso 1: Establecer la clave de API

Paso 2: Configurar config.toml

Uso básico

Modelos recomendados

Comandos interactivos

Verificar configuración

Casos de uso comunes

Solución de problemas

​Visión general

​Requisitos del sistema

​Instalación

​Configuración

​Paso 1: Establecer la clave de API

​Paso 2: Configurar config.toml

​Uso básico

​Modelos recomendados

​Comandos interactivos

​Verificar configuración

​Casos de uso comunes

​Solución de problemas

Visión general

Requisitos del sistema

Instalación

Configuración

Paso 1: Establecer la clave de API

Paso 2: Configurar config.toml

Uso básico

Modelos recomendados

Comandos interactivos

Verificar configuración

Casos de uso comunes

Solución de problemas