> ## Documentation Index
> Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex CLI

> Apunta la CLI de OpenAI Codex a los modelos de Venice con un archivo local config.toml para que las solicitudes del agente de programación pasen por la API privada y compatible con OpenAI de Venice.

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).

<CardGroup cols={3}>
  <Card title="Configuración simple" icon="gear">
    Un único archivo de configuración en tu proyecto
  </Card>

  <Card title="Compatible con OpenAI" icon="plug">
    Usa la API compatible con OpenAI de Venice
  </Card>

  <Card title="Flexibilidad de modelos" icon="microchip">
    Cambia a cualquier modelo de texto compatible de Venice
  </Card>
</CardGroup>

***

## Requisitos previos

* Una API key de Venice desde [venice.ai/settings/api](https://venice.ai/settings/api)
* Codex CLI instalado y funcionando en tu máquina

***

## Configuración

<Steps>
  <Step title="Crea la ruta de configuración del proyecto">
    Desde la raíz de tu proyecto:

    ```bash theme={null}
    mkdir -p .codex
    ```
  </Step>

  <Step title="Crea .codex/config.toml">
    Crea el archivo y pega la siguiente configuración:

    ```toml theme={null}
    #: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"
    ```
  </Step>

  <Step title="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](/models/text).
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

## 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

<CardGroup cols={2}>
  <Card title="Referencia de la API de Venice" icon="book" href="/api-reference/api-spec">
    Documentación completa de endpoints y parámetros
  </Card>

  <Card title="Modelos de texto de Venice" icon="list" href="/models/text">
    IDs de modelo disponibles
  </Card>
</CardGroup>