Skip to main content

​
Deje que mi agente configure esto

Copie esta tarea en un agente que ya se esté ejecutando en su equipo:

​
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 ajuste preestablecido de TokenLab se lanzó y verificó de extremo a extremo en 2.72.0. La versión 2.73.0 mantiene esa integración y añade enrutamiento específico por modelo para Responses y Anthropic Messages. Las rutas listadas a continuación se han verificado con TokenLab mediante texto en streaming y ciclos completos de llamada a función/resultado. Codex envía solicitudes Responses al proxy local de OpenCodex. Luego, OpenCodex envía la solicitud del modelo seleccionado a TokenLab. Una solicitud Responses en la conexión local no significa que el modelo sea llamado a través de la API Responses de TokenLab. La Base URL del ajuste preestablecido es https://api.tokenlab.sh/v1. Manténgala sin cambios: OpenCodex construye por sí mismo la URL correspondiente de Messages o Responses. Los modelos fuera de los valores predeterminados de Responses listados y del enrutamiento de Claude utilizan el adaptador Chat del ajuste preestablecido. TokenLab admite la API nativa de Gemini para los modelos que la declaran, pero el ajuste preestablecido de TokenLab en OpenCodex 2.73.0 llama a Gemini a través de Chat Completions. No cambie todo el proveedor a Responses o Gemini; eso también cambiaría las solicitudes para los modelos que no aceptan ese formato.

​
Instalar o actualizar

Utilice Node.js 18 o posterior para la instalación mediante npm:
Codex también debe estar instalado. OpenCodex proporciona instrucciones de instalación e instrucciones de conexión de Codex. Windows nativo y WSL tienen configuraciones independientes; ejecute la configuración y Codex en el mismo entorno.

​
Añadir TokenLab

Cree una clave en TokenLab API Keys. Para la configuración en terminal, siga el Inicio rápido para establecer TOKENLAB_API_KEY sin incluir su valor en el historial de comandos. Inicie OpenCodex desde esa terminal; un servicio en segundo plano necesita la variable en su propio entorno de inicio. Para una instalación limpia de OpenCodex, ejecute ocx init, seleccione TokenLab e introduzca la clave localmente o utilice la referencia literal de variable de entorno ${TOKENLAB_API_KEY}. Revise las opciones de conexión con Codex y de inicio automático del asistente antes de aplicarlas. Para una instalación existente, añada el ajuste preestablecido sin reemplazar otros proveedores:
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, edite ese proveedor en el panel de control en lugar de sobrescribirlo con --force. También puede elegir TokenLab en la lista 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. Inicie el proxy si aún no se está ejecutando, luego abra su panel de control:
En la página del proveedor, verifique la Base URL y los modelos detectados. El ajuste preestablecido detecta GET /v1/models?category=chat y conserva los modelos con capacidad tool-use. Se excluyen imágenes, video, audio, embeddings y modelos de decisión. La detección con una clave refleja los permisos de modelos y la directiva de entrega de dicha clave. Ejecute ocx sync para conectar Codex y actualizar su catálogo de modelos, luego inicie una nueva sesión de Codex. Esto cambia la conexión de proxy y el catálogo de Codex; revise la configuración existente de proveedores personalizados y guarde una copia de seguridad antes de sincronizar. No requiere reemplazar su cuenta ni su directiva de permisos.

​
Seleccionar un modelo y verificar una solicitud

Elija la entrada tokenlab/<model-id> en el selector de modelos de Codex, o selecciónela para una única ejecución de la CLI:
OpenCodex utiliza tokenlab/ para seleccionar el proveedor; el ID de modelo enviado a TokenLab es gpt-6.1-sol. Elija un ID exacto disponible actualmente desde Models. Para una pequeña comprobación de conexión, envíe:
Esta solicitud utiliza su saldo de TokenLab. Compruebe la respuesta y el modelo correspondiente, la hora y el estado en Requests. La detección de proveedores y un inicio exitoso por sí solos no verifican el acceso a la inferencia. El streaming y el function calling funcionan en las rutas de la tabla. La entrada de imágenes y los controles de thinking dependen del modelo seleccionado: compruebe sus capacidades y utilice únicamente las opciones de esfuerzo que OpenCodex ofrece para ese modelo. Las solicitudes con entrada de imágenes y thinking se verificaron en modelos representativos para las rutas Responses y Messages; la entrada de imágenes en Gemini se verificó en su ruta Chat. Un modelo que admita thinking no necesariamente expone el texto de thinking ni admite todos los niveles de esfuerzo.

​
Mantener un modelo de Responses en Chat Completions

Para utilizar la ruta Chat con uno de los modelos Responses listados, combine una entrada modelAdapters en el objeto existente providers.tokenlab dentro de la configuración de OpenCodex. Este ejemplo mantiene gpt-6-astra en Chat para Codex:
Este es un ejemplo de campo de proveedor, no un reemplazo de la configuración completa. Conserve otras anulaciones de modelos, credenciales y proveedores; luego reinicie el proxy y abra una nueva sesión de Codex. Eliminar únicamente la entrada de este modelo restaura su valor predeterminado de Responses. El enrutamiento de Messages de Claude está vinculado al endpoint canónico de TokenLab. La anulación a Chat anterior se aplica a los valores predeterminados de Responses; no cambia Claude a Chat. Para un cliente nativo de Chat, los modelos Responses listados ya utilizan Chat sin esta anulación. Consulte el enrutamiento de proveedores de OpenCodex.

​
Directiva de entrega y otras herramientas de TokenLab

El ajuste preestablecido no fuerza un encabezado X-TokenLab-Delivery-Policy. TokenLab utiliza el valor predeterminado de la directiva de entrega de su API key. Elegir Chat, Responses o Messages es independiente de elegir una directiva de entrega; consulte la configuración del proveedor TokenLab. Añada el servidor MCP de TokenLab para obtener otras herramientas de API, o TokenLab Skills para ver las instrucciones de integración. Estos no modifican el proveedor del modelo principal ni el formato de API. JEV Auto en OpenCodex 2.73.0 utiliza el backend de decisiones de TypeSafe. No ofrece TokenLab como dicho backend. Llamar a la API System One de TokenLab a través de MCP es una operación independiente; no introduzca una clave de TokenLab en el campo de credenciales de TypeSafe.

​
Solución de problemas y restauración de su configuración

  • TokenLab no aparece en el selector: compruebe ocx --version; esta guía está orientada a la versión 2.73.0. Actualice el catálogo con ocx sync e inicie una nueva sesión de Codex.
  • 401 o credenciales faltantes: verifique 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 encuentra en ejecución.
  • El modelo no aparece: verifique el ID exacto, los permisos de su clave y la disponibilidad actual. Los modelos que no son de chat y los modelos de chat sin capacidad tool-use no están incluidos en este ajuste preestablecido.
  • Solicitud no admitida o endpoint incorrecto: compare el modelo seleccionado con la tabla de enrutamiento e inspeccione las anulaciones de adaptadores guardadas. El formato requerido es tokenlab.accepted_request_formats en los detalles del modelo; la lista de modelos no reemplaza ese campo de detalle. Claude y Gemini no deben enviarse a Responses simplemente porque Codex use Responses de forma local.
  • Fallo en herramientas o entrada de imágenes: conserve el error original y el Request ID. Verifique las capacidades del modelo y la ruta activa de OpenCodex antes de modificar la configuración; no elimine el historial de conversación ni los resultados de herramientas para ocultar un error.
Para dejar de enrutar Codex a través del proxy, utilice ocx stop; OpenCodex detiene el proxy y restaura la conexión nativa de Codex. ocx restore restaura la conexión nativa manteniendo el proxy en ejecución para otros clientes. Revise la referencia de la CLI de OpenCodex antes de modificar una instalación compartida con otros clientes.