CLI

Codex CLI

O CLI da OpenAI, pela Responses API.

Escopo validado

Configuração, autenticação e chamadas OpenAI compatíveis indicadas neste guia.

Protocolo: OpenAI compatível. Modelo do exemplo: gpt-5.6-sol-medium.

Base URLhttps://avello.online/v1

Com /v1 no fim — esta ferramenta não anexa o caminho.

Instalar

npm install -g @openai/codex

Declare o provedor

# ~/.codex/config.toml
model          = "gpt-5.6-sol-medium"
model_provider = "avello"

[model_providers.avello]
name                 = "Avello"
base_url             = "https://avello.online/v1"
env_key              = "AVELLO_API_KEY"
requires_openai_auth = false
wire_api             = "responses"

Aqui o /v1 ENTRA. É a superfície OpenAI.

A chave fica no ambiente, nunca no config

# ~/.zshrc ou ~/.bashrc
export AVELLO_API_KEY="sua-chave-avello"

O config.toml costuma ir para o git. A chave, não.

Confirme

codex "responda apenas: ok"

O engano mais comum

Esquecer o /v1, ou deixar requires_openai_auth no padrão. Sem requires_openai_auth = false o Codex tenta o login da OpenAI e ignora a sua chave.