TokenGate
Documentación
● docs / cli / codex
Codex

Configurar Codex CLI

Codex CLI habla exclusivamente la Responses API — a diferencia de otras herramientas, no lee OPENAI_BASE_URL. Se configura por completo en ~/.codex/config.toml.

⚠️

Codex CLI ≥ 0.142.0 ignora las variables de entorno OPENAI_BASE_URL/OPENAI_API_KEY para el proveedor por defecto. Toda la configuración va en el archivo TOML — hacé una copia de tu config.toml actual antes de tocarlo.

Configuración paso a paso

  1. Hacé un backup de tu config actual

    Copiá ~/.codex/config.toml a otro lado antes de modificarlo.

  2. Ubicá el archivo

    ~/.codex/config.toml en Linux/Mac, o C:\Users\TU_USUARIO\.codex\config.toml en Windows.

  3. Agregá el proveedor TokenGate

    Con el slug del modelo que elegiste, reemplazando los placeholders.

# ~/.codex/config.toml
model = "<slug-del-modelo>"
model_provider = "tokengate"
model_reasoning_effort = "medium"

[model_providers.tokengate]
name = "TokenGate"
base_url = "https://tokengate.work/cli/v1"
env_key = "TOKENGATE_API_KEY"
wire_api = "responses"

[model_providers.tokengate.modelOverride]
model = "<slug-del-modelo>"

Estos requests llegan a POST /cli/v1/responses, que TokenGate traduce desde/hacia la Responses API nativa de OpenAI.

Correr Codex

El modelo ya queda fijado en el archivo TOML — no hace falta pasarlo por flag en cada corrida:

export TOKENGATE_API_KEY="tg_live_..."
codex

Específico de Codex

  • Tool use es obligatorio. Codex depende de herramientas para operar sobre tu proyecto — un modelo sin soporte de tools devuelve 400 tools_not_supported.
  • model_reasoning_effort acepta los mismos niveles que documenta cada modelo en /docs/modelos — ajustalo si tu modelo soporta razonamiento graduado.
  • El modelOverride dentro de [model_providers.tokengate] es lo que fuerza a Codex a usar siempre tu slug de TokenGate, incluso si internamente intenta pedir otro modelo.