Configuração do Codex

Codex é o assistente de programação da OpenAI.

Conclua primeiro a seção de configuração do ambiente e confirme que Node.js e npm estão instalados.

Após a instalação, consulte o guia avançado do config.toml do Codex para modelos, provedores, permissões, sessões e uso de tokens.

Linux / MacOS

Etapa 1: Instalar o Codex

npm install -g @openai/codex@latest

Etapa 2: Criar a pasta de configuração

Crie uma pasta .codex dentro do seu diretório de usuário.

mkdir -p ~/.codex

Etapa 3: Criar config.toml

Crie config.toml dentro de .codex e cole:

model_provider = "icodeeasy"
model = "gpt-5.6-sol"
cli_auth_credentials_store = "file"
suppress_unstable_features_warning = true
personality = "pragmatic"

[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
wire_api = "responses"
requires_openai_auth = true

Se api.icodeeasy.cc estiver lento na sua rede, altere base_url para https://jp.icodeeasy.cc ou https://sg.icodeeasy.cc.

Etapa 4: Entrar e gerar auth.json

Copie a API Key em API Keys e execute os comandos abaixo. Cole a chave e pressione Enter. A entrada fica oculta e a chave não é salva nos arquivos de inicialização do shell:

read -s OPENAI_API_KEY
printf '\n'
printf '%s' "$OPENAI_API_KEY" | codex login --with-api-key
unset OPENAI_API_KEY
codex login status

O Codex grava a credencial em ~/.codex/auth.json. Não crie nem edite esse arquivo manualmente: config.toml controla o modelo e o Provider, enquanto auth.json armazena apenas as credenciais de login. Restrinja os dois arquivos ao seu usuário:

chmod 600 ~/.codex/config.toml ~/.codex/auth.json

Etapa 5: Iniciar o Codex

cd your-project-folder
codex

Windows

Etapa 1: Instalar o Codex

npm install -g @openai/codex@latest

Etapa 2: Criar a pasta de configuração

Veja seu diretório de usuário:

echo $env:USERPROFILE

Crie a pasta .codex:

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

Etapa 3: Criar config.toml

Crie config.toml dentro de .codex e cole:

model_provider = "icodeeasy"
model = "gpt-5.6-sol"
cli_auth_credentials_store = "file"
suppress_unstable_features_warning = true
personality = "pragmatic"

[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
wire_api = "responses"
requires_openai_auth = true

[features]
elevated_windows_sandbox = true

Se api.icodeeasy.cc estiver lento na sua rede, altere base_url para https://jp.icodeeasy.cc ou https://sg.icodeeasy.cc.

Etapa 4: Entrar e gerar auth.json

Copie a API Key em API Keys e execute:

$secureKey = Read-Host "API Key" -AsSecureString
$plainKey = [System.Net.NetworkCredential]::new("", $secureKey).Password
$plainKey | codex login --with-api-key
$plainKey = $null
codex login status

O Codex grava a credencial em $env:USERPROFILE\.codex\auth.json. Não edite o arquivo manualmente nem configure uma variável de usuário permanente OPENAI_API_KEY.

Etapa 5: Iniciar o Codex

Abra uma nova janela do PowerShell, entre no diretório do projeto e inicie:

cd your-project-folder
codex

VSCode

Conclua primeiro a configuração do Codex CLI e confirme que codex login status funciona. A extensão do VSCode reutiliza o mesmo config.toml e o cache de login do Codex.

Etapa 1: Instalar o Codex Extension

Procure e instale Codex no marketplace de extensões do VSCode.

Etapa 2: Abrir o arquivo de configuração

A extensão Codex do VSCode reutiliza .codex/config.toml no seu diretório de usuário. Crie a pasta .codex e o config.toml seguindo os passos de Linux / MacOS ou Windows acima.

Etapa 3: Configurar a API Key

Normalmente não é necessário inserir a API Key novamente. Se a extensão continuar pedindo login, execute codex login status no terminal integrado do VSCode e depois Developer: Reload Window.