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

# Codex CLI

> Usa OpenAI Codex CLI con modelos de Venice AI mediante un archivo local config.toml

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={"system"}
    mkdir -p .codex
    ```
  </Step>

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

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