Início rápido do Codex

Este guia conecta Codex a Modelflare e executa sua primeira solicitação. Use a Opção A para configuração automatizada. Use a Opção B para instalar Codex primeiro e, em seguida, crie você mesmo cada arquivo necessário.

1. Crie uma chave de API

Faça login no console Modelflare, abra Chaves de API e crie uma chave que possa acessar gpt-5.6-sol. Escolha qualquer grupo não padrão disponível que liste o modelo; não há um único grupo obrigatório.

Mantenha a chave pronta. Você pode usar o instalador ou configurar os mesmos arquivos manualmente.

2. Escolha um método de configuração

Opção A: execute o instalador

macOS ou Linux

Execute este comando como seu usuário normal:

curl -fsSL https://modelflare.dev/install/codex.sh | sh

Quando você já estiver conectado como root em um VPS ou contêiner, use:

curl -fsSL https://modelflare.dev/install/codex.sh | MODELFLARE_ALLOW_ROOT=1 sh

Não adicione sudo em um computador pessoal normal. O script instala ou atualiza Codex, faz backup dos arquivos existentes, solicita sua chave de API Modelflare e grava a configuração do provedor em ~/.codex.

Windows PowerShell

Abra PowerShell como usuário normal do Windows e execute:

irm https://modelflare.dev/install/codex.ps1 | iex

O instalador solicita um idioma e sua chave de API Modelflare, verifica o acesso ao gpt-5.6-sol e faz backup dos arquivos existentes antes de alterá-los. Quando terminar, continue em Verificar a conexão.

Opção B: crie você mesmo cada arquivo Codex

Use esta opção quando não desejar executar o script de configuração Modelflare. Siga as etapas na ordem e use o bloco de comando do seu sistema operacional em cada etapa.

A opção B cria dois arquivos no diretório .codex de nível de usuário: config.toml e modelflare_api_key.

Etapa 1: instalar Codex CLI

Windows PowerShell

irm https://chatgpt.com/codex/install.ps1 | iex
codex --version

Linux

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

macOS

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

Etapa 2: crie e insira o diretório .codex

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
Set-Location "$HOME\.codex"

Linux

mkdir -p ~/.codex
cd ~/.codex

macOS

mkdir -p ~/.codex
cd ~/.codex

Etapa 3: criar config.toml

Windows PowerShell

$config = @'
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true

[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"

[model_providers.modelflare.auth]
command = "powershell.exe"
args = ["-NoProfile", "-NonInteractive", "-Command", "Get-Content -LiteralPath (Join-Path (Join-Path $HOME '.codex') 'modelflare_api_key') -Raw"]
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "config.toml"),
  $config,
  $utf8NoBom
)

Linux

cat > config.toml << 'EOF'
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true

[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"

[model_providers.modelflare.auth]
command = "sh"
args = ["-lc", "cat ~/.codex/modelflare_api_key"]
EOF
chmod 600 config.toml

macOS

cat > config.toml << 'EOF'
model_provider = "modelflare"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
model_supports_reasoning_summaries = true

[model_providers.modelflare]
name = "Modelflare"
base_url = "https://modelflare.dev/v1"
wire_api = "responses"

[model_providers.modelflare.auth]
command = "sh"
args = ["-lc", "cat ~/.codex/modelflare_api_key"]
EOF
chmod 600 config.toml

Etapa 4: criar modelflare_api_key

Antes de executar o comando em seu sistema, substitua YOUR_MODELFLARE_API_KEY pela chave de API completa que você criou no console Modelflare. O arquivo deve conter apenas a chave em si – não mantenha o espaço reservado nem adicione aspas, crases ou espaços.

Windows PowerShell

$apiKey = @'
YOUR_MODELFLARE_API_KEY
'@
$apiKey = $apiKey.Trim()
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "modelflare_api_key"),
  $apiKey,
  $utf8NoBom
)
$apiKey = $null

Linux

cat > modelflare_api_key << 'EOF'
YOUR_MODELFLARE_API_KEY
EOF
chmod 600 modelflare_api_key

macOS

cat > modelflare_api_key << 'EOF'
YOUR_MODELFLARE_API_KEY
EOF
chmod 600 modelflare_api_key

Etapa 5: iniciar Codex

Windows PowerShell

Set-Location $HOME
New-Item -ItemType Directory -Force "my-codex-project" | Out-Null
Set-Location "my-codex-project"
codex --model gpt-5.6-sol

Linux

cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol

macOS

cd ~
mkdir -p my-codex-project
cd my-codex-project
codex --model gpt-5.6-sol

3. Verifique a conexão

Se você usou o instalador, feche completamente qualquer CLI, IDE ou sessão de desktop Codex que já estava aberta. Abra um novo terminal, entre no diretório do projeto e execute:

codex --model gpt-5.6-sol

Então pergunte ao Codex:

Responda com uma frase confirmando o modelo ativo e o provedor.

Uma resposta normal significa que a configuração foi concluída.

Problemas comuns

Sintoma	O que fazer
401	Copie novamente a chave API e confirme se ela não foi excluída ou desativada.
model_not_found	Edite a chave API e escolha um grupo que possa acessar gpt-5.6-sol.
O login ChatGPT aparece	Encerre totalmente cada sessão Codex e reabra a CLI.
codex não foi encontrado	Abra um novo terminal. No Windows, experimente codex.cmd.