Codex 客户端

下载 Codex

如果您已安装 Codex 客户端，可跳过。

1. 根据你的系统选择对应的安装包下载：

• macOS（Apple Silicon，M 系列芯片）：Codex.dmg

• macOS（Intel 芯片）：Codex-latest-x64.dmg

• Windows：Microsoft Store 安装

2. 下载后双击安装包，按提示完成安装。Linux 用户暂时只能使用 CLI 版本。

命令配置 使用方式

macOS / Linux 用户

打开终端，把下面整段粘进去回车：

mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "chuanglanrouter"
model = "deepseek-v4-flash"
model_reasoning_effort = "high"
[model_providers.chuanglanrouter]
name = "ChuangLanRouter"
base_url = "https://router.253.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF

• 设置 API Key

macOS 用户

echo 'export OPENAI_API_KEY="你的秘钥"' >> ~/.zshrc
source ~/.zshrc

Linux 用户

echo 'export OPENAI_API_KEY="你的秘钥"' >> ~/.bashrc
source ~/.bashrc

• 打开Codex桌面版应用，如果之前已经打开过。请关闭后重新打开。

Windows 用户

打开 PowerShell（开始菜单搜「PowerShell」），把下面整段粘进去回车：

New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "chuanglanrouter"
model = "deepseek-v4-flash"
model_reasoning_effort = "high"

[model_providers.chuanglanrouter]
name = "ChuangLanRouter"
base_url = "https://router.253.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8

• 设置 API Key

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的秘钥", "User")

• 打开Codex桌面版应用，如果之前已经打开过。请关闭后重新打开。

Codex++ 使用方式

Codex++ 是面向 Codex App 的外部增强 launcher 和管理工具。根据项目 README，它不修改 Codex App 原始安装文件，而是通过外部 launcher 启动 Codex，并使用 Chromium DevTools Protocol 注入增强脚本。

它更适合这些情况：

• 你主要使用 Codex 桌面 App。

• 你希望通过图形界面维护 Base URL 和 Key。

• 你希望切换回官方 ChatGPT 登录态时，不完全靠手写配置。

• 你能接受第三方 launcher 带来的兼容性和维护风险。

流程步骤

1. 打开 Codex++ Releases，下载与你系统匹配的安装包。

会有 「Codex++ 管理工具」和 「Codex++ app」两个安装包。

2. 安装后打开 Codex++ 管理工具。

首次打开如果出现这个错误：

不要慌，先打开「系统设置」-「隐私与安全性」，点击「仍要打开」：

打开后就会进入到这个管理界面：

同样的方式，安装刚才安装包中的 Codex++ app。然后把两个都往Applications移动就可以了，你就可以看到管理工具检测全绿了。

确认已经检测到 ChatGPT 登录状态。

3. 添加中转配置，填写 https://router.253.com/v1 和 Key。

选择「供应商配置」-添加供应商配置。填写自己的供应商的配置，并填写模型相关信息，注意 接入方式要选「纯API」的方式：

模型列表可以选择从上游获取，如果你配置的是中转站，这里就可以用很多不同的模型了：

保存后可以测试联通情况，没问题，直接选择使用：

3. 从 Codex++ 入口启动 Codex，而不是从原版 Codex 入口启动。注意一定要杀掉原来的Codex

重新启动后，你就能看到现在 Codex已经完全使用了我们自定义的模型供应商，并可以选择更多的模型。