Pular para o conteúdo principal
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).

Configuração simples

Um arquivo de configuração no seu projeto

Compatível com OpenAI

Usa a API da Venice compatível com OpenAI

Flexibilidade de modelos

Troque por qualquer modelo de texto Venice suportado

​
Pré-requisitos

​
Configuração

1

Crie o caminho de configuração do projeto

A partir da raiz do seu projeto:
mkdir -p .codex
2

Crie .codex/config.toml

Crie o arquivo e cole a configuração abaixo:
#: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"
3

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

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.

​
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

Referência da API Venice

Documentação completa de endpoints e parâmetros

Modelos de texto Venice

IDs de modelos disponíveis