Herramientas de código

Codex CLI

Configura OpenAI Codex CLI para usar la API de TokenLab

Deja que mi agente configure esto

Copia esta tarea en un agente que ya se esté ejecutando en tu equipo:

Read this guide and help me connect Codex CLI to TokenLab:
https://tokenlab.sh/docs/es/integrations/codex-cli
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.

Descripción general

Codex CLI puede conectarse a TokenLab a través de /v1/responses. El modelo seleccionado debe incluir openai_responses en tokenlab.accepted_request_formats; las funciones pueden variar según el modelo.

La compactación remota utiliza POST /v1/responses/compact. Codex envía el modelo de la sesión actual en body.model, por lo que ese modelo también debe admitir Responses. No configures /v1/compact.

Requisitos del sistema

Consulta la guía de instalación oficial de la CLI para macOS, Linux o Windows. Windows nativo y WSL son entornos independientes; sigue la guía de Windows. El comando npm que aparece a continuación es una opción de instalación, no un requisito para los binarios nativos.

Instalación

npm install -g @openai/codex@0.163.0

Verifica la instalación:

codex --version

Configuración

Paso 1: Configurar la API key

Usa las instrucciones de terminal del Inicio rápido para macOS, Linux, WSL o Windows PowerShell para configurar TOKENLAB_API_KEY sin guardar la clave en el historial de comandos. Inicia Codex desde esa terminal. Para un uso persistente, utiliza tu gestor de secretos local; no añadas una clave en texto plano a tu perfil de shell.

Paso 2: Configurar tokenlab.config.toml

Usa un archivo tokenlab.config.toml independiente en tu CODEX_HOME activo (normalmente ~/.codex) con Codex 0.163.0 (probado el 18-10-2026). Créalo solo si el nombre no está en uso, o realiza una copia de seguridad antes de editar un perfil de TokenLab existente. El perfil siguiente se carga explícitamente con codex --profile tokenlab; deja intactos el config.toml predeterminado, auth.json, las cuentas y las políticas de permisos. No uses una tabla heredada [profiles.tokenlab]. Inicia sin el perfil para volver a tu configuración habitual. Consulta la configuración oficial de perfiles.

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

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

Este modo WebSocket es un puente de Responses sobre WebSocket para clientes de 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 OpenAI Realtime API y no acepta session.update, conversation.item.*, input_audio_buffer.*, audio binario ni envoltorios anidados de Realtime response.create.response.

Crea el archivo de configuración elegido si no existe. Después de editarlo, inicia una nueva sesión con el comando correspondiente a continuación.

La versión actual de Codex utiliza wire_api = "responses". No configures chat/completions. Mantén requires_openai_auth sin definir o en false para este proveedor personalizado, de modo que se utilice env_key.

Las solicitudes de Responses no se convierten a Chat Completions. Los campos opcionales y futuros dependen del modelo seleccionado.

Uso básico

Iniciar el modo interactivo:

codex --profile tokenlab

Comando directo:

codex --profile tokenlab "Fix the bug in main.py line 42"

Especificar modelo:

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

Elegir un modelo

Utiliza un modelo que actualmente liste openai_responses en tokenlab.accepted_request_formats. Compara candidatos en tus propias tareas de programación y consulta los precios actuales en la página de Modelos.

Comandos interactivos

ComandoDescripción
/helpMuestra la ayuda
/exit o Ctrl+CSalir
/clearLimpia la conversación
/statusMuestra el modelo activo, los permisos y el uso de tokens
/model <name>Cambia de modelo

Verificar la configuración

Comprueba si la variable de entorno está configurada sin imprimir su valor. Esta comprobación no valida la clave:

if [ -n "${TOKENLAB_API_KEY:-}" ]; then
  printf '%s\n' 'TOKENLAB_API_KEY is set'
else
  printf '%s\n' 'TOKENLAB_API_KEY is not set'
fi

Inicia Codex y ejecuta /status para verificar el modelo activo y los permisos. Si utilizas un perfil, inicia ese mismo perfil. Consulta el comando de estado oficial.

Cuando estés listo para realizar una solicitud real, ejecuta el siguiente comando. Esto utilizará tu saldo de TokenLab. Comprueba la respuesta y el registro correspondiente en Solicitudes; una comprobación del entorno o un inicio correcto por sí solos no demuestran que la solicitud se haya realizado con éxito.

codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."

Casos de uso comunes

Revisión de código:

git diff | codex --profile tokenlab "Review these code changes"

Generar mensajes de commit:

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

Corregir errores:

codex --profile tokenlab "Fix the TypeScript errors in src/components/"

Explicar código:

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

Generar imágenes y vídeo en el mismo agente

Codex también puede crear imágenes y vídeos cortos con el servidor MCP de TokenLab. Cada generación se paga desde el mismo saldo de TokenLab. Ejecuta esto en la terminal donde esté configurada TOKENLAB_API_KEY:

codex mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=core \
  --env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.48

El comando añade el servidor a tu config.toml base. Codex también carga ese archivo bajo el perfil tokenlab.config.toml, por lo que las herramientas funcionan con o sin --profile tokenlab. Ejecuta codex mcp list y comprueba que tokenlab aparezca en la lista. Luego prueba:

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video devuelve un ID de tarea. El agente llama a get_task_status hasta que el vídeo esté listo.

Solución de problemas

En esta página