Codex 快速開始

本指南將 Codex 連接到 Modelflare 並執行其第一個請求。使用選項 A 進行自動設定。首先使用選項 B 安裝 Codex，然後自行建立每個所需的檔案。

1. 建立 API 金鑰

登入Modelflare控制台，開啟API Keys，建立可以存取gpt-5.6-sol的金鑰。選擇列出模型的任何可用的非預設組；沒有單一的必需組。

準備好鑰匙。您可以使用安裝程式或手動設定相同的檔案。

2. 選擇設定方法

選項 A：執行安裝程序

macOS 或 Linux

以普通使用者身分執行此命令：

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

當您已在 VPS 或容器上以 root 身分登入時，請使用：

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

請勿在一般個人電腦上新增 sudo。腳本會安裝或更新 Codex、備份現有檔案、詢問您的 Modelflare API 金鑰，並在 ~/.codex 下寫入提供者設定。

Windows PowerShell

以一般 Windows 使用者身分開啟 PowerShell 並執行：

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

安裝程式會要求您選擇語言並輸入 Modelflare API 金鑰，驗證是否可存取 gpt-5.6-sol，並在變更前備份現有檔案。完成後，繼續驗證連線。

選項 B：自行建立每個 Codex 檔案

當您不想執行 Modelflare 安裝腳本時，請使用此選項。按順序執行步驟，並在每個步驟中使用適合您的作業系統的命令區塊。

選項 B 在使用者等級 .codex 目錄下建立兩個檔案：config.toml 和 modelflare_api_key。

第 1 步：安裝 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

第 2 步：建立並進入 .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

第 3 步：建立 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

第 4 步：建立 modelflare_api_key

在為您的系統執行命令之前，請將 YOUR_MODELFLARE_API_KEY 替換為您在 Modelflare 控制台中建立的完整 API 金鑰。檔案必須僅包含金鑰本身 - 不要保留佔位符或添加引號、反引號或空格。

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

第 5 步：啟動 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. 驗證連線

如果您使用了安裝程序，請完全關閉任何已開啟的 Codex CLI、IDE 或桌面工作階段。開啟一個新終端，進入專案目錄，然後執行：

codex --model gpt-5.6-sol

然後問Codex：

用一句話回覆，確認目前使用中的模型和提供者。

正常響應表示設定已完成。

常見問題

症狀	該怎麼辦
401	重新複製 API 金鑰並確認其未被刪除或停用。
model_not_found	編輯API金鑰並選擇可以存取gpt-5.6-sol的群組。
出現ChatGPT登入	完全退出每個 Codex 會話並重新開啟 CLI。
未找到codex	開啟新終端機。在 Windows 上，試試 codex.cmd。