Codex

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

1. Crie uma chave API

Faça login no console Modelflare, abra API Keys 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

Ainda não está confortável com o terminal? Comece com o guia interativo de primeira execução. É apenas um ensaio visual e não altera o seu computador.

macOS ou Linux

Execute este comando como seu usuário normal:

bash

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

Quando você já estiver logado como root em um VPS ou container, use:

bash

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 o Codex, faz backup dos arquivos existentes, solicita sua chave de API Modelflare e grava a configuração do provedor em ~/.codex.

Windows PowerShell

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

PowerShell

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

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

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

Use esta opção quando não quiser executar o script de configuração do 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 de nível de usuário .codex: config.toml e auth.json.

Etapa 1: instalar Codex CLI

Windows PowerShell

PowerShell

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

Linux

bash

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

macOS

bash

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

Passo 2: crie e entre no diretório .codex

Windows PowerShell

PowerShell

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

Linux

bash

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

macOS

bash

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

Etapa 3: criar config.toml

Windows PowerShell

PowerShell

$config = @'
cli_auth_credentials_store = "file"
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"
requires_openai_auth = true
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "config.toml"),
  $config,
  $utf8NoBom
)

Linux

bash

cat > config.toml << 'EOF'
cli_auth_credentials_store = "file"
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"
requires_openai_auth = true
EOF
chmod 600 config.toml

macOS

bash

cat > config.toml << 'EOF'
cli_auth_credentials_store = "file"
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"
requires_openai_auth = true
EOF
chmod 600 config.toml

Etapa 4: criar auth.json

Substitua YOUR_MODELFLARE_API_KEY no objeto JSON pela chave de API completa que você criou no console Modelflare. Este arquivo deve permanecer JSON válido e usar o campo OPENAI_API_KEY; não inclua um bloco de comandos do provedor auth. As versões atuais do Codex exigem requires_openai_auth = true para este caminho de chave de API.

Windows PowerShell

PowerShell

$authJson = @'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "auth.json"),
  $authJson,
  $utf8NoBom
)

Linux

bash

cat > auth.json << 'EOF'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
EOF
chmod 600 auth.json

macOS

bash

cat > auth.json << 'EOF'
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "YOUR_MODELFLARE_API_KEY"
}
EOF
chmod 600 auth.json

Etapa 5: iniciar o Codex

Windows PowerShell

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

bash

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

macOS

bash

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 do Codex, IDE ou sessão de desktop que já estava aberta. Abra um novo terminal, entre no diretório do projeto e execute:

bash

codex --model gpt-5.6-sol

Depois de terminar a configuração, você também pode baixar o aplicativo Codex.

Então pergunte ao Codex:

Text

Reply with one sentence confirming the active model and provider.

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 do ChatGPT aparece	Saia totalmente de todas as sessões do Codex e reabra a CLI.
codex não encontrado	Abra um novo terminal. No Windows, tente codex.cmd.