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.

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.3-codex"
disable_response_storage = true
suppress_unstable_features_warning = true
preferred_auth_method = "apikey"
personality = "pragmatic"

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

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

Etapa 4: Configurar variáveis de ambiente

Adicione ao ~/.bashrc ou ~/.zshrc:

export OPENAI_API_KEY="your API Key"
export OPENAI_BASE_URL="https://api.icodeeasy.cc"

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

Salve o arquivo e execute source ~/.bashrc ou source ~/.zshrc.

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.3-codex"
disable_response_storage = true
suppress_unstable_features_warning = true
preferred_auth_method = "apikey"
personality = "pragmatic"

[model_providers.icodeeasy]
name = "icodeeasy"
base_url = "https://api.icodeeasy.cc"
env_key = "OPENAI_API_KEY"
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.

Etapa 4: Configurar a API Key no PowerShell

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "your API Key", "User")

Abra uma nova janela do PowerShell depois de configurar.

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 o Codex inicia pela linha de comando. A extensão do VSCode usa o mesmo arquivo .codex/config.toml e as mesmas variáveis de ambiente do sistema.

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

Se a extensão do VSCode pedir uma API Key, copie da página API Keys e cole.