Saltar al contenido principal
Esta guía muestra cómo ejecutar OpenAI Codex CLI con Venice usando las rutas oficiales de configuración de Codex: ~/.codex/config.toml (a nivel de usuario) o .codex/config.toml (a nivel de proyecto).

Configuración simple

Un único archivo de configuración en tu proyecto

Compatible con OpenAI

Usa la API compatible con OpenAI de Venice

Flexibilidad de modelos

Cambia a cualquier modelo de texto compatible de Venice

​
Requisitos previos

​
Configuración

1

Crea la ruta de configuración del proyecto

Desde la raíz de tu proyecto:
mkdir -p .codex
2

Crea .codex/config.toml

Crea el archivo y pega la siguiente configuración:
#:schema https://developers.openai.com/codex/config-schema.json

model = "openai-gpt-54" # usa cualquier modelo de Venice
model_provider = "venice"
model_reasoning_effort = "high"
personality = "pragmatic"
sandbox_mode = "workspace-write"

[model_providers.venice]
name = "Venice"
base_url = "https://api.venice.ai/api/v1/"
experimental_bearer_token = "YOUR VENICE API KEY"
wire_api = "responses"
3

Sustituye los dos marcadores

Actualiza:
  • model con el ID del modelo de Venice que quieras usar
  • experimental_bearer_token con tu API key real de Venice
Puedes consultar los IDs de modelo disponibles en el catálogo de modelos de texto.
4

Ejecuta Codex CLI normalmente

Inicia Codex CLI desde el mismo proyecto. Cargará .codex/config.toml (para proyectos de confianza) y enrutará las solicitudes a través de Venice.

​
Ubicaciones oficiales de configuración de Codex

  • Valores predeterminados del usuario: ~/.codex/config.toml
  • Overrides del proyecto: .codex/config.toml (cargado solo para proyectos de confianza)
Si quieres que la configuración de Venice se aplique en todas partes, pon la misma configuración en ~/.codex/config.toml.

​
Precedencia de configuración (la más alta primero)

  1. Flags de CLI y overrides con --config
  2. Valores de perfil (--profile <name>)
  3. Capas de configuración del proyecto (.codex/config.toml, gana el directorio más cercano)
  4. Configuración del usuario (~/.codex/config.toml)
  5. Configuración del sistema (/etc/codex/config.toml, Unix)
  6. Valores predeterminados integrados

​
Notas

  • Mantén tu API key privada y nunca subas claves reales a git.
  • Codex ignora la configuración .codex/ del proyecto cuando un proyecto está marcado como no confiable.
  • Si cambias de modelo, solo actualiza el campo model.
  • El ajuste wire_api = "responses" es obligatorio para esta configuración de proveedor.

​
Recursos

Referencia de la API de Venice

Documentación completa de endpoints y parámetros

Modelos de texto de Venice

IDs de modelo disponibles