OpenAI Codex 客户端接入指南（使用代理 API）
本文介绍如何在 OpenAI Codex 客户端（CLI / Desktop App）中接入第三方代理 API，替换默认的 OpenAI 官方接口。
注意事项
Codex 的 Base URL 和 Claude Code 不一样：Claude Code 通常填写 https://api.muteki.site，而 Codex 的自定义 OpenAI provider 通常填写 https://api.muteki.site/v1。如果少了 /v1，Codex 可能会请求到错误路径。
准备工作
1. 获取 API 密钥
在代理平台的 API 密钥 页面创建并复制一个 sk- 开头的密钥。
2. 选择 Codex 客户端
- Codex CLI：适合 Linux / macOS 终端、WSL2 等命令行环境
- Codex Desktop App：适合 Windows / macOS 桌面端，图形化操作更直观
3. 确认模型名
推荐新手先用 gpt-5.6，其他可用模型详见代理平台的可用模型列表。
方式一：CC Switch 一键配置（推荐新手）
CC Switch 可以自动帮你完成配置，无需手动编辑文件。
- 打开 CC Switch 配置教程，按提示完成工具安装和基础配置
- 保存配置后，完全退出并重新打开 Codex CLI 或 Codex Desktop App
方式二：手动修改配置文件
配置文件位置
| 环境 | 配置文件路径 |
|---|---|
| Linux / macOS / WSL2 | ~/.codex/config.toml |
| Windows PowerShell | %USERPROFILE%\.codex\config.toml |
重要：
openai_base_url属于 provider 相关配置，项目级.codex/config.toml会忽略它。务必写到用户级配置文件中。
配置内容
编辑 ~/.codex/config.toml，添加以下内容：
model = "gpt-5.6"
model_reasoning_effort = "high"
openai_base_url = "https://api.muteki.site/v1"
这会保留 Codex 内置的 openai provider，只把 API Base URL 改为你自己的代理地址。
Windows / macOS Desktop App 配置
桌面端无需手动编辑配置文件。在 Codex Desktop App 设置中直接填入：
- API Key：
sk-开头的密钥 - Base URL：
https://api.muteki.site/v1 - 默认模型：
gpt-5.6
多 Profile 配置（进阶）
Codex 0.134.0 及更新版本中，旧写法
[profiles.profile-name]和顶层profile = "profile-name"已不再支持。
如需多套配置，为每个 profile 单独创建一个同级 TOML 文件，例如 ~/.codex/MaruCode.config.toml：
# ~/.codex/MaruCode.config.toml
model = "gpt-5.6"
model_reasoning_effort = "high"
openai_base_url = "https://api.muteki.site/v1"
启动时指定 profile：
codex --profile MaruCode
测试验证
配置完成后，进入一个测试目录运行 Codex：
mkdir codex-test && cd codex-test
codex
进入 Codex 后发送测试消息：
你好，请用一句话说明你当前使用的模型配置。
如果能正常回复，说明接入成功。
常见问题
提示没有 API Key
重新运行 codex，在弹出的图形化页面或交互式输入框中填写 sk- 开头的密钥。只要用户级 config.toml 里的 openai_base_url 已指向代理，Codex CLI 同样可以通过此方式完成 API Key 配置。
提示 404 或接口不存在
优先检查 Base URL。Codex 这里要用 https://api.muteki.site/v1，不要只填根地址（缺少 /v1）。
提示模型不可用
回到可用模型列表复制正确的模型名，最稳妥的测试模型是 gpt-5.6。
配置文件报 TOML 错误
通常是重复写了同一个顶层键，或者少了引号。只保留一份 model、model_reasoning_effort 和 openai_base_url 等顶层配置，并确保字符串都用英文双引号包住。
给新手的建议
如果只是想快速使用，优先走 CC Switch；如果需要精确控制模型、Base URL 或多套 profile 文件，再手动改 config.toml。两种方式本质上都是让 Codex 指向你的 OpenAI 兼容代理接口。