Codex 快速开始

在 Windows、macOS 或 Linux 上安装 Codex，连接 Modelflare API 密钥，并验证 Responses API 请求。

这篇文档只解决一件事：让 Codex 通过 Modelflare 成功发送第一条请求。想最快完成就用方式 A；想自己逐项创建配置，就按方式 B 的每一步分别执行当前操作系统的命令。

第一步：创建 API Key

先保留好这个 Key。你可以使用一键脚本，也可以手动创建同样的配置文件。

第二步：选择配置方式

方式 A：运行一键脚本

macOS 或 Linux

普通电脑请使用当前用户直接执行，不要加 sudo：

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

如果你本来就是用 root 登录 VPS、云服务器或容器，请使用：

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

脚本会安装或更新 Codex、备份现有配置、让你粘贴 Modelflare API Key，并把 provider 配置写入 ~/.codex。

Windows PowerShell

用普通 Windows 用户打开 PowerShell，执行：

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

安装器会让你选择语言并粘贴 Modelflare API Key，随后验证 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

如果安装失败，请改用下面的命令：

npm install -g @openai/codex@latest --registry=https://registry.npmmirror.com

第 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 Key。文件中只能保留 Key 本身，不要保留占位文字，也不要添加引号、反引号或空格。

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

第三步：验证连接

如果使用了一键脚本，请先完全退出已经打开的 Codex CLI、IDE 或桌面应用，再打开新终端，进入项目目录并执行：

codex --model gpt-5.6-sol

进入 Codex 后输入：

请用一句话确认当前使用的模型和 provider。

能够正常回复，就说明配置完成。

常见问题

现象	处理方法
401	重新复制 API Key，并确认 Key 没有被删除或禁用。
model_not_found	编辑 API Key，选择一个可以访问 gpt-5.6-sol 的分组。
仍然出现 ChatGPT 登录	完全退出所有 Codex 进程后重新打开。
找不到 codex 命令	重新打开终端；Windows 可以尝试运行 codex.cmd。