TeamoRouter 接入 Codex 桌面版
Codex 桌面版（Codex Desktop）是 OpenAI 官方推出的桌面端 AI 编程助手，支持 macOS 和 Windows。本章为安装教程。如果您已安装 Codex 桌面版，在其中接入 TeamoRouter 请参考下一章。
一、下载并安装 Codex 桌面版
根据你的系统选择对应的安装包下载：
- macOS（Apple Silicon，M 系列芯片）：Codex.dmg
- macOS（Intel 芯片）：Codex-latest-x64.dmg
- Windows：Microsoft Store 安装
下载后双击安装包，按提示完成安装。Linux 用户暂时只能使用 CLI 版本（参考 TeamoRouter 接入 Codex CLI）。
二、配置模型
方法一 通过 cc-switch 接入 Codex 桌面端
推荐通过 cc-switch 接入 Codex 桌面端，cc-switch 是一款为 codex 等 agent 快速接入 api 平台的软件。（安装有时需要网络代理）
访问 CC Switch Releases 下载对应平台安装包：
- macOS：
.dmg/.zip - Windows：
.msi安装版 / Portable.zip绿色版 - Linux：
.deb/.rpm/.AppImage
首次打开如被 macOS Gatekeeper 拦截，到「系统设置 → 隐私与安全性」点 「仍要打开」。
滑到底部选择您的电脑系统版本下载
- 打开 CC Switch，主界面顶部切到 Codex tab。
- 点击右上角 「添加供应商」，弹出 「添加新供应商」 对话框。
- 填入基础字段：
- 「供应商名称」：
TeamoRouter - 「官网链接」（可选）：
https://teamorouter.com - 「API Key」：粘贴你在 TeamoRouter 控制台 创建的 key
- 「API 请求地址」：
https://api.teamorouter.com/v1 - 「模型名称」：保持默认
gpt-5.4，或通过获取模型列表来使用 TeamoRouter 上其它模型。 - 「API 格式」：保持默认
OpenAI Responses API (原生)。
- 点击底部 「+ 添加」 保存。
方法二 修改系统配置文件接入
若安装 cc-switch 失败，可通过修改系统配置文件接入。
macOS / Linux 用户
打开终端，把下面整段粘进去回车：
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "teamorouter"
model = "gpt-5.4"
model_reasoning_effort = "high"
[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF
Windows 用户
打开 PowerShell（开始菜单搜「PowerShell」），把下面整段粘进去回车：
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "teamorouter"
model = "gpt-5.4"
model_reasoning_effort = "high"
[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8
设置 API Key
把下面命令里的 <你的-TeamoRouter-key> 替换成你自己创建的 API Key，API Key 在 TeamoRouter 控制台 获取。然后粘到终端执行。
macOS 用户
echo 'export OPENAI_API_KEY="你的-TeamoRouter-key"' >> ~/.zshrc
source ~/.zshrc
Linux 用户
echo 'export OPENAI_API_KEY="你的-TeamoRouter-key"' >> ~/.bashrc
source ~/.bashrc
Windows 用户
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的-TeamoRouter-key", "User")
Windows 用户：执行完上面命令后，关闭 Codex 桌面版重新打开一次才能读到新的环境变量。
三、启动 Codex 桌面版
打开 Codex 桌面版应用，如果之前已经打开过，请关闭后重新打开。