Herramientas de código
OpenCodex
Conecta Codex a TokenLab a través de OpenCodex con enrutamiento de API específico para cada modelo
Deja que mi agente configure esto
Copia esta tarea a un agente que ya se esté ejecutando en tu computadora:
Read https://tokenlab.sh/docs/es/integrations/opencodex and help me connect OpenCodex to TokenLab.
Check my installed OpenCodex and Codex versions, active configuration, and running proxy first.
Preserve existing accounts, providers, models, and permissions. Back up files before changing them.
Have me enter the API key locally; never ask for, print, or paste it in chat.
Use the TokenLab preset and the selected model's documented API format.
Check configuration loading first. Explain the cost before running a small real request.
Match the reply with its TokenLab request record.Cómo funciona la conexión
OpenCodex es un proxy local entre Codex y las API de modelos. Esta guía utiliza OpenCodex 2.73.0 y Codex CLI 0.149.0.
La integración de Chat Completions del preset de TokenLab fue lanzada y verificada de extremo a extremo en la versión 2.72.0. La versión 2.73.0 mantiene esa integración y añade enrutamiento para Responses y Anthropic Messages específico para cada modelo. Las rutas listadas a continuación han sido verificadas con TokenLab mediante texto en streaming y ciclos de ida y vuelta de llamadas a funciones/resultados.
Codex envía solicitudes de Responses al proxy local de OpenCodex. OpenCodex luego envía la solicitud del modelo seleccionado a TokenLab. Una solicitud de Responses en la conexión local no significa que el modelo sea llamado a través de la API de Responses de TokenLab.
| Modelos seleccionados en Codex | OpenCodex → TokenLab |
|---|---|
gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, grok-4.7, deepseek-v4.1-flash, deepseek-v4-pro, kimi-k3, glm-5.3 | Responses: POST /v1/responses |
claude-opus-5, claude-opus-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-fable-5, claude-fable-5-1 | Anthropic Messages: POST /v1/messages |
gemini-3.8-flash | Chat Completions: POST /v1/chat/completions |
La URL base del preset es https://api.tokenlab.sh/v1. Mantenla sin cambios: OpenCodex construye la URL de Messages o Responses correspondiente por sí mismo. Los modelos fuera de los valores predeterminados de Responses y el enrutamiento de Claude utilizan el adaptador de Chat del preset.
TokenLab admite la API nativa de Gemini para los modelos que la declaran, pero el preset de TokenLab para OpenCodex 2.73.0 llama a Gemini a través de Chat Completions. No cambies todo el proveedor a Responses o Gemini; eso también cambiaría las solicitudes para modelos que no aceptan ese formato.
Instalar o actualizar
Usa Node.js 18 o posterior para la instalación mediante npm:
npm install -g @bitkyc08/opencodex@2.73.0
ocx --version
codex --versionCodex también debe estar instalado. OpenCodex proporciona instrucciones de instalación y de conexión con Codex. Windows nativo y WSL tienen configuraciones separadas; ejecuta la configuración y Codex en el mismo entorno.
Añadir TokenLab
Crea una clave en TokenLab API Keys. Para la configuración en terminal, sigue el Inicio rápido para establecer TOKENLAB_API_KEY sin poner su valor en el historial de comandos. Inicia OpenCodex desde esa terminal; un servicio en segundo plano necesita la variable en su propio entorno de ejecución.
Para una instalación nueva de OpenCodex, ejecuta ocx init, selecciona TokenLab e introduce la clave localmente o utiliza la referencia literal de entorno ${TOKENLAB_API_KEY}. Revisa las opciones de conexión a Codex y de inicio automático del asistente antes de aplicarlas.
Para una instalación existente, añade el preset sin reemplazar otros proveedores:
ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}'Las comillas simples guardan una referencia a la variable de entorno, no el valor de la clave. Este comando también funciona en PowerShell. Si tokenlab ya existe, edita ese proveedor en el panel de control en lugar de sobrescribirlo con --force.
También puedes elegir TokenLab en la lista de Add provider del panel de control e introducir la clave allí. OpenCodex guarda su configuración en $OPENCODEX_HOME/config.json, normalmente ~/.opencodex/config.json.
Inicia el proxy si aún no se está ejecutando, luego abre su panel de control:
ocx start
ocx status
ocx guiEn la página del proveedor, verifica la URL base y los modelos descubiertos. El preset descubre GET /v1/models?category=chat y mantiene los modelos con capacidad de tool-use. Las imágenes, video, audio, embeddings y modelos de decisión están excluidos. El descubrimiento con una clave refleja los permisos de modelo y la política de entrega de esa clave.
Ejecuta ocx sync para conectar Codex y actualizar su catálogo de modelos, luego inicia una nueva sesión de Codex. Esto cambia la conexión de proxy y el catálogo de Codex; revisa la configuración de proveedores personalizados existentes y mantén una copia de seguridad antes de sincronizar. No requiere reemplazar tu cuenta o política de permisos.
Seleccionar un modelo y verificar una solicitud
Elige la entrada tokenlab/<model-id> en el selector de modelos de Codex, o selecciónalo para un lanzamiento único desde la CLI:
codex -m "tokenlab/gpt-6.1-sol"OpenCodex utiliza tokenlab/ para seleccionar el proveedor; el ID de modelo enviado a TokenLab es gpt-6.1-sol. Elige un ID exacto disponible actualmente desde Models.
Para una pequeña verificación de conexión, envía:
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.Esta solicitud utiliza tu saldo de TokenLab. Verifica la respuesta y su modelo, hora y estado correspondientes en Requests. El descubrimiento del proveedor y el inicio exitoso por sí solos no verifican el acceso a la inferencia.
El streaming y la llamada a funciones funcionan en las rutas de la tabla. La entrada de imágenes y los controles de pensamiento dependen del modelo seleccionado: verifica sus capacidades y utiliza solo las opciones de esfuerzo que OpenCodex ofrece para ese modelo. La entrada de imágenes y las solicitudes de pensamiento se verificaron en modelos representativos para las rutas de Responses y Messages; la entrada de imágenes de Gemini se verificó en su ruta de Chat. Un modelo que admite pensamiento no necesariamente expone texto de pensamiento ni admite todos los niveles de esfuerzo.
Mantener un modelo de Responses en Chat Completions
Para usar la ruta de Chat para uno de los modelos de Responses listados, fusiona una entrada modelAdapters en el objeto existente providers.tokenlab en la configuración de OpenCodex. Este ejemplo mantiene gpt-6-astra en Chat para Codex:
{
"modelAdapters": {
"gpt-6-astra": "openai-chat"
}
}Este es un ejemplo de campo de proveedor, no un reemplazo para la configuración completa. Conserva otras anulaciones de modelos, credenciales y proveedores, luego reinicia el proxy y abre una nueva sesión de Codex. Eliminar solo esta entrada de modelo restaura su valor predeterminado de Responses.
El enrutamiento de Messages de Claude está vinculado al endpoint canónico de TokenLab. La anulación de Chat anterior se aplica a los valores predeterminados de Responses; no cambia a Claude a Chat. Para un cliente nativo de Chat, los modelos de Responses listados ya utilizan Chat sin esta anulación. Consulta OpenCodex provider routing.
Política de entrega y otras herramientas de TokenLab
El preset no fuerza un encabezado X-TokenLab-Delivery-Policy. TokenLab utiliza la política de entrega predeterminada de tu clave API. Elegir Chat, Responses o Messages es independiente de elegir una política de entrega; consulta TokenLab provider settings.
Los TokenLab Skills añaden instrucciones de integración. No cambian el proveedor ni el formato de API del modelo principal.
JEV Auto en OpenCodex 2.73.0 utiliza el backend de decisión de TypeSafe. No ofrece a TokenLab como ese backend. Llamar a la System One API de TokenLab a través de MCP es una operación separada; no pongas una clave de TokenLab en el campo de credenciales de TypeSafe.
Generar imágenes y video en el mismo agente
Codex también puede crear imágenes y videos cortos con el servidor MCP de TokenLab. Cada generación se paga con el mismo saldo de TokenLab. OpenCodex solo enruta las solicitudes de modelos, y Codex mismo inicia los servidores MCP. Añade el servidor a Codex en la terminal donde está configurado 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.48MCP no cambia el proveedor ni el formato de API del modelo principal. Ejecuta codex mcp list y verifica que tokenlab aparezca en la lista. Luego intenta en una nueva sesión de Codex:
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 video esté listo.
Solución de problemas y restauración de tu configuración
- TokenLab no aparece en el selector: verifica
ocx --version; esta guía apunta a la versión 2.73.0. Actualiza el catálogo conocx synce inicia una nueva sesión de Codex. - 401 o credenciales faltantes: verifica que la clave esté activa y disponible para el proceso que ejecuta OpenCodex. Una variable de entorno en una terminal diferente no actualiza un servicio que ya se está ejecutando.
- Falta un modelo: verifica el ID exacto, los permisos de tu clave y la disponibilidad actual. Los modelos que no son de chat y los modelos de chat sin
tool-useno están incluidos en este preset. - Solicitud no admitida o endpoint incorrecto: compara el modelo seleccionado con la tabla de enrutamiento e inspecciona las anulaciones de adaptadores guardadas. El formato requerido es
tokenlab.accepted_request_formatsen model details; la lista de modelos no sustituye a ese campo de detalle. Claude y Gemini no deben enviarse a Responses simplemente porque Codex utiliza Responses localmente. - Las herramientas o la entrada de imágenes fallan: conserva el error original y el ID de solicitud. Verifica las capacidades del modelo y la ruta activa de OpenCodex antes de cambiar la configuración; no elimines el historial de la conversación ni los resultados de las herramientas para ocultar un error.
Para dejar de enrutar Codex a través del proxy, utiliza ocx stop; OpenCodex detiene el proxy y restaura la conexión nativa de Codex. ocx restore restaura la conexión nativa mientras mantiene el proxy ejecutándose para otros clientes. Revisa la referencia de la CLI de OpenCodex antes de cambiar una instalación compartida por otros clientes.