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

# Codex CLI

> Use o Codex CLI da OpenAI com modelos Venice AI por meio de um arquivo local config.toml

Este guia mostra como executar o Codex CLI da OpenAI com a Venice usando os caminhos de configuração oficiais do Codex: `~/.codex/config.toml` (nível de usuário) ou `.codex/config.toml` (nível de projeto).

<CardGroup cols={3}>
  <Card title="Configuração simples" icon="gear">
    Um arquivo de configuração no seu projeto
  </Card>

  <Card title="Compatível com OpenAI" icon="plug">
    Usa a API da Venice compatível com OpenAI
  </Card>

  <Card title="Flexibilidade de modelos" icon="microchip">
    Troque por qualquer modelo de texto Venice suportado
  </Card>
</CardGroup>

***

## Pré-requisitos

* Uma chave de API Venice em [venice.ai/settings/api](https://venice.ai/settings/api)
* Codex CLI instalado e funcionando na sua máquina

***

## Configuração

<Steps>
  <Step title="Crie o caminho de configuração do projeto">
    A partir da raiz do seu projeto:

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

  <Step title="Crie .codex/config.toml">
    Crie o arquivo e cole a configuração abaixo:

    ```toml theme={"dark"}
    #:schema https://developers.openai.com/codex/config-schema.json

    model = "openai-gpt-54" # use qualquer modelo 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="Substitua os dois placeholders">
    Atualize:

    * `model` com o ID do modelo Venice que você deseja usar
    * `experimental_bearer_token` com sua chave de API Venice real

    Você pode navegar pelos IDs de modelo disponíveis no [catálogo de modelos de texto](/models/text).
  </Step>

  <Step title="Execute o Codex CLI normalmente">
    Inicie o Codex CLI no mesmo projeto. Ele carregará `.codex/config.toml` (para projetos confiáveis) e roteará as requisições pela Venice.
  </Step>
</Steps>

***

## Localizações oficiais de configuração do Codex

* **Padrões do usuário**: `~/.codex/config.toml`
* **Sobrescritas do projeto**: `.codex/config.toml` (carregado apenas para projetos confiáveis)

Se você quiser que as configurações da Venice se apliquem em todos os lugares, coloque a mesma configuração em `~/.codex/config.toml`.

***

## Precedência de configuração (do mais alto ao mais baixo)

1. Flags de CLI e sobrescritas `--config`
2. Valores de perfil (`--profile <name>`)
3. Camadas de configuração do projeto (`.codex/config.toml`, vence o diretório mais próximo)
4. Configuração do usuário (`~/.codex/config.toml`)
5. Configuração do sistema (`/etc/codex/config.toml`, Unix)
6. Padrões integrados

***

## Observações

* Mantenha sua chave de API privada e nunca faça commit de chaves reais no git.
* O Codex ignora a configuração `.codex/` do projeto quando um projeto está marcado como não confiável.
* Se você trocar de modelo, atualize apenas o campo `model`.
* A configuração `wire_api = "responses"` é obrigatória para esta configuração de provedor.

***

## Recursos

<CardGroup cols={2}>
  <Card title="Referência da API Venice" icon="book" href="/api-reference/api-spec">
    Documentação completa de endpoints e parâmetros
  </Card>

  <Card title="Modelos de texto Venice" icon="list" href="/models/text">
    IDs de modelos disponíveis
  </Card>
</CardGroup>