Codex CLI

Dejar que mi agente lo configureCopy Anchor Link

Copia esta tarea en un agente que ya funcione en tu ordenador:

Lee esta guía y ayúdame a conectar Codex CLI con TokenLab:
https://tokenlab.sh/docs/es/integrations/codex-cli
Comprueba primero mi versión instalada y la configuración activa.
Conserva las cuentas, los proveedores, los permisos y los demás ajustes existentes.
Haz una copia de seguridad de los archivos locales y muestra los cambios propuestos.
Las claves API necesarias las introduciré localmente; nunca las pidas, muestres ni pegues en el chat.
Comprueba primero que la configuración se carga correctamente.
Explica por separado el coste de cualquier prueba con peticiones de pago antes de ejecutarla.

Visión generalCopy Anchor Link

Codex CLI se conecta a TokenLab mediante /v1/responses. El modelo elegido debe incluir openai_responses en tokenlab.accepted_request_formats; las funciones pueden variar según el modelo.

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 sistemaCopy Anchor Link

Sigue la guía CLI oficial para macOS, Linux o Windows. Windows nativo y WSL son entornos distintos; consulta la guía Windows. npm es una opción, no un requisito de los binarios nativos.

InstalaciónCopy Anchor Link

npm install -g @openai/codex@0.149.0

Verificar la instalación:

codex --version

ConfiguraciónCopy Anchor Link

Paso 1: Establecer la clave de APICopy Anchor Link

Sigue los pasos de terminal de inicio rápido para macOS, Linux, WSL o Windows PowerShell y define TOKENLAB_API_KEY sin dejar la clave en el historial. Inicia Codex desde esa terminal. Para uso persistente, utiliza un gestor local de secretos; no añadas la clave en texto plano al perfil del shell.

Paso 2: Configurar tokenlab.config.tomlCopy Anchor Link

Con Codex 0.149.0, usa un archivo tokenlab.config.toml independiente dentro del CODEX_HOME activo (normalmente ~/.codex). Créalo solo si el nombre está libre o respalda el perfil TokenLab existente antes de editarlo. codex --profile tokenlab lo carga explícitamente sin cambiar config.toml, auth.json, cuentas ni permisos. No uses la tabla antigua [profiles.tokenlab]. Inicia sin ese 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 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.

Codex actual usa wire_api = "responses", no chat/completions. Omite requires_openai_auth o usa false para que el proveedor utilice env_key.

Uso básicoCopy Anchor Link

Iniciar 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 modeloCopy Anchor Link

Elige un modelo cuyo tokenlab.accepted_request_formats incluya actualmente openai_responses. Compara modelos con tus tareas y consulta precios en la página de modelos.

Comandos interactivosCopy Anchor Link

Verificar configuraciónCopy Anchor Link

Comprueba solo si la variable de entorno está definida, 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 comprobar el modelo activo y los permisos. Si usas un perfil, inicia ese mismo perfil. Consulta el comando oficial de estado.

Cuando quieras enviar una solicitud real, ejecuta el siguiente comando. Utiliza tu saldo de TokenLab. Comprueba la respuesta y su registro en Solicitudes. Una variable definida o un inicio correcto no demuestra por sí solo que una solicitud haya finalizado correctamente.

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

Casos de uso comunesCopy Anchor Link

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"

Solución de problemasCopy Anchor Link