DESKTOP / CODEX

Codex Desktop

Configure Codex Desktop to use Mengbi Router for personal coding tasks.

!

This page is the preview integration contract for individual Mengbi Router users. Examples will remain compatible when the production gateway opens.

01 /

Codex Desktop:照着做即可

如果你的目标是让 Codex Desktop 使用 Mengbi Router,只需要完成下面四步。我们不要求安装额外的 Mengbi 客户端。

开始前准备

先准备好 Codex Desktop、个人 API Key,以及一个当前可用的模型 ID。第一次接入建议使用 gpt-5.6-sol;之后可以在模型目录中切换。

  • 从官方 OpenAI 渠道安装 Codex Desktop。
  • 在 Mengbi 个人控制台创建 API Key。
  • 打开模型目录,确认要使用的模型 ID。

Note不要把 API Key 发给任何人,也不要粘贴到浏览器开发者工具或公开仓库。

第 1 步:写入 Codex 配置(macOS / Linux)

打开终端,完整复制下面一段命令并回车。它会创建 Codex 配置目录和配置文件。

终端bash
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "mengbi"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.mengbi]
name = "Mengbi Router"
base_url = "https://router-api.mengbi-ai.net/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF

第 1 步:写入 Codex 配置(Windows)

打开 PowerShell,完整复制下面一段命令并回车。

PowerShellpowershell
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "mengbi"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.mengbi]
name = "Mengbi Router"
base_url = "https://router-api.mengbi-ai.net/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8

第 2 步:设置个人 API Key

把下面命令中的 sk-mengbi-xxxxxx 替换为你在个人控制台创建的 Key,再复制到对应终端执行。

macOSbash
echo 'export OPENAI_API_KEY="sk-mengbi-xxxxxx"' >> ~/.zshrc
source ~/.zshrc
Linuxbash
echo 'export OPENAI_API_KEY="sk-mengbi-xxxxxx"' >> ~/.bashrc
source ~/.bashrc
Windowspowershell
[Environment]::SetEnvironmentVariable(
  "OPENAI_API_KEY",
  "sk-mengbi-xxxxxx",
  "User"
)

NoteWindows 设置完成后需要完全退出 Codex Desktop,再重新打开;macOS / Linux 需要在执行 source 后重新启动 Codex。

第 3 步:重启并验证

关闭已经打开的 Codex Desktop,再重新打开。创建一个对话或任务,选择配置中的模型,然后发送一个简单请求,例如“请介绍当前项目结构”。

  • 能正常返回回答:接入完成。
  • 提示找不到模型:回到模型目录,复制准确的模型 ID,修改 config.toml 的 model 值。
  • 提示未配置 Key:确认环境变量设置到了当前用户,并完全重启了 Codex Desktop。

切换模型

只需要修改 ~/.codex/config.toml(Windows 对应 $HOME\.codex\config.toml)里的 model 值,然后重启 Codex Desktop。

配置项toml
model = "gpt-5.6-sol"
# 例如:model = "gpt-5.6-sol"