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

1

Abrir API Keys

Abra o painel e vá para API Keys.
2

Escolher Codex CLI

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

Escolher o sistema

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

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.
Copiar configuração

​
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

CampoSignificado
model_providerDefine qual Provider o Codex deve usar. Aqui precisa corresponder a [model_providers.OpenAI].
modelNome do modelo padrão. Copie o valor exibido no painel.
review_modelModelo usado pelo Codex Review. Geralmente igual a model.
base_urlEndereço da API do 4096bytes. Use https://api.4096bytes.com.
wire_apiUsa a rota Responses API. Defina como responses.
requires_openai_authFaz o Codex ler OPENAI_API_KEY de auth.json.
OPENAI_API_KEYAPI Key do 4096bytes criada no painel.

​
Problemas comuns

Coloque a nova configuração no início de config.toml. Salve, feche o terminal e execute codex novamente.
Verifique se auth.json é JSON válido. Confirme que a API Key não tem caracteres faltando, quebras de linha ou espaços extras.
model e review_model devem corresponder exatamente ao nome exibido no painel. Não copie nomes de capturas de outros usuários.
Confirme onde o Codex está rodando. Se ele roda no WSL, configure ~/.codex/ do WSL, não %USERPROFILE%\.codex\.
Você pode mantê-los, mas confirme que model_provider = "OpenAI" aponta para o bloco [model_providers.OpenAI] do 4096bytes.