Codex

O Codex CLI pode conectar ao 4096bytes por meio de um Provider compatível com OpenAI. Você precisa gravar o config.toml e o auth.json gerados pelo painel no diretório de configuração do Codex. Prefira copiar a configuração pela janela Use key do painel. Ela mostra o caminho correto para o seu sistema e inclui a API Key atual automaticamente.

Pré-requisitos

Você concluiu Criar conta.
Você concluiu Obter API Key.
O Codex CLI está instalado e codex --version funciona.
A janela Use key está aberta para a API Key que você quer usar.

A API Key em auth.json fica salva localmente em texto simples. Não envie ~/.codex/auth.json, capturas de tela ou saída do terminal para repositórios ou conversas.

Instalar

Se o Codex CLI não estiver instalado, consulte as instruções mais recentes no repositório OpenAI Codex no GitHub. macOS ou Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Se você usa npm para CLIs globais:

npm install -g @openai/codex

Depois da instalação, reabra o terminal e verifique:

codex --version

Copiar configuração do painel

Abrir API Keys

Abra o painel e vá para API Keys.

Escolher Codex CLI

Encontre a chave que será usada no Codex, clique em Use key e escolha Codex CLI.

Escolher o sistema

Selecione macOS / Linux ou Windows. O painel mostra os caminhos dos arquivos de configuração.

Copiar configuração

Copie os trechos de config.toml e auth.json. Coloque config.toml no início do arquivo para evitar que configurações antigas sobrescrevam a nova.

macOS ou Linux

Gravar `config.toml`

Abra ou crie ~/.codex/config.toml e coloque este bloco no início.

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.4096bytes.com"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

Use os valores de model e review_model exibidos no painel. Se o painel mostrar outro nome de modelo, use esse valor.

Gravar `auth.json`

Abra ou crie ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "YOUR_4096BYTES_API_KEY"
}

Substitua YOUR_4096BYTES_API_KEY pela API Key criada no painel.

Iniciar Codex

Salve os dois arquivos, reabra o terminal e execute:

codex

Você também pode começar com um prompt de baixo risco:

codex "Descreva em uma frase a finalidade do diretório atual. Não modifique arquivos."

Windows

Gravar `config.toml`

Abra ou crie:

%USERPROFILE%\.codex\config.toml

Coloque este bloco no início.

model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.4096bytes.com"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

Se você executa Codex dentro do WSL, configure ~/.codex/config.toml dentro do WSL, não no diretório de usuário do Windows.

Gravar `auth.json`

Abra ou crie:

%USERPROFILE%\.codex\auth.json

Escreva:

{
  "OPENAI_API_KEY": "YOUR_4096BYTES_API_KEY"
}

Se você executa Codex no WSL, grave ~/.codex/auth.json dentro do WSL.

Iniciar Codex

Salve os dois arquivos, reabra o PowerShell ou Windows Terminal e execute:

codex

Você também pode testar com:

codex "Descreva em uma frase a finalidade do diretório atual. Não modifique arquivos."

Campos

Campo	Significado
`model_provider`	Define qual Provider o Codex deve usar. Aqui precisa corresponder a `[model_providers.OpenAI]`.
`model`	Nome do modelo padrão. Copie o valor exibido no painel.
`review_model`	Modelo usado pelo Codex Review. Geralmente igual a `model`.
`base_url`	Endereço da API do 4096bytes. Use `https://api.4096bytes.com`.
`wire_api`	Usa a rota Responses API. Defina como `responses`.
`requires_openai_auth`	Faz o Codex ler `OPENAI_API_KEY` de `auth.json`.
`OPENAI_API_KEY`	API Key do 4096bytes criada no painel.

Problemas comuns

Codex ainda usa o modelo ou endereço antigo

Coloque a nova configuração no início de config.toml. Salve, feche o terminal e execute codex novamente.

Codex mostra falha de autenticação

Verifique se auth.json é JSON válido. Confirme que a API Key não tem caracteres faltando, quebras de linha ou espaços extras.

Codex não encontra o modelo

model e review_model devem corresponder exatamente ao nome exibido no painel. Não copie nomes de capturas de outros usuários.

Configuração no Windows não entra em vigor

Confirme onde o Codex está rodando. Se ele roda no WSL, configure ~/.codex/ do WSL, não %USERPROFILE%\.codex\.

O arquivo já tem outros Providers

Você pode mantê-los, mas confirme que model_provider = "OpenAI" aponta para o bloco [model_providers.OpenAI] do 4096bytes.

Início rápido

Clientes

SDKs

Pré-requisitos

Instalar

Copiar configuração do painel

macOS ou Linux

Gravar `config.toml`

Gravar `auth.json`

Iniciar Codex

Windows

Gravar `config.toml`

Gravar `auth.json`

Iniciar Codex

Campos

Problemas comuns

​Pré-requisitos

​Instalar

​Copiar configuração do painel

​macOS ou Linux

​Gravar config.toml

​Gravar auth.json

​Iniciar Codex

​Windows

​Gravar config.toml

​Gravar auth.json

​Iniciar Codex

​Campos

​Problemas comuns

Pré-requisitos

Instalar

Copiar configuração do painel

macOS ou Linux

Gravar `config.toml`

Gravar `auth.json`

Iniciar Codex

Windows

Gravar `config.toml`

Gravar `auth.json`

Iniciar Codex

Campos

Problemas comuns