Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
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.4"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
fast_mode = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
sandbox_mode = "danger-full-access"
approval_policy = "never"

disable_response_storage = false
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]
responses_websockets = true
responses_websockets_v2 = true
Este modo WebSocket es un puente Responses-over-WebSocket para clientes Codex. Acepta response.create y response.cancel; 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.
Si una solicitud usa campos exclusivos de Responses que no son compatibles con el modelo o la ruta seleccionada, TokenLab devuelve un error explícito en lugar de degradar silenciosamente la solicitud.

​
Uso básico

Iniciar modo interactivo: 
codex
Comando directo: 
codex "Fix the bug in main.py line 42"
Especificar modelo: 
codex -m gpt-5.4 "Build a REST API server"

​
Modelos recomendados

ModeloMejor para
gpt-5.4Mejor opción predeterminada para codificación y razonamiento
gpt-5-miniAlternativa más rápida y económica para flujos de trabajo de codificación
claude-sonnet-4-6Revisión de código, documentación
deepseek-r1Diseño de algoritmos, razonamiento

​
Comandos interactivos

ComandoDescripción
/helpMostrar ayuda
/exit or Ctrl+CSalir
/clearBorrar conversación
/configVer configuración
/model <name>Cambiar modelo
/tokensVer 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

  • 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
  • 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
  • Revisa que el nombre del modelo coincida exactamente
  • Verifica la disponibilidad del modelo en tokenlab.sh/en/models
  • 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
  • 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"