Codex 配置教程
配置 Chat Completions 上游,通过本地路由连接 Codex 的 Responses 接口。
先安装 Codex,并创建 QuickRouter API Key。
推荐用 QuickRouter Switch 一键配置。已安装 CC-Switch 的用户也可选择备选方式。
使用 QuickRouter Switch 配置
还没安装?下载并安装 QuickRouter Switch。
- 添加供应商
打开 QuickRouter Switch,在左边选「Codex」,点「添加供应商」。
图 6 在 Codex 页面点击「添加供应商」。 - 填写 API Key
把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。
图 7 模型可换成自己实际要用的模型。填好 API Key,核对请求地址后点击「添加」。 - 开始路由
点右下角「添加」。回到列表,点「开始路由」,选中 QuickRouter 并确认。看到「路由中」后,重新打开 Codex。用桌面版就完全退出再打开,用编辑器插件就重开编辑器窗口。使用时保持 QuickRouter Switch 开着。
图 8 在 Codex 的路由确认框选 QuickRouter。
查看具体参数和更多操作
「API 请求地址」保留 https://api.quickrouter.ai/v1,「高级选项」里的上游格式保留「Chat Completions(需转换)」。模型列表预填 gpt-6.1-sol,可换成自己实际要用的模型。在「实际请求模型」填完整模型 ID,菜单显示名填同一个 ID,并确认当前 API Key 可调用该模型。
点击右下角「添加」。回到供应商列表,点「开始路由」,将「路由到」选为 QuickRouter,再确认「开始路由」。卡片显示「路由中」后,重新打开 Codex,并保持 QuickRouter Switch 运行。 桌面端要彻底退出,编辑器插件要重开编辑器窗口。
使用 CC-Switch 配置
还没安装?下载并安装 CC-Switch。
- 添加供应商
打开 CC Switch,在左侧选择Codex,点击添加供应商,选择自定义配置。
- 填写连接信息
- 名称填
QuickRouter,API Key 填自己的令牌,API 请求地址填https://api.quickrouter.ai/v1,完整 URL 关闭。 - 展开「高级选项」,上游格式选 Chat Completions(需开启路由)。生成配置中的
wire_api保持"responses"。

Codex:请求地址带 /v1,默认模型 gpt-6-sol,上游为 Chat Completions。 - 名称填
- 设置模型
- 在「默认模型」填当前令牌可用的模型 ID,例如
gpt-6-sol。
示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。
- 在「默认模型」填当前令牌可用的模型 ID,例如
- 保存供应商
在表单底部点击添加。返回 Codex 供应商列表后,确认出现
QuickRouter卡片。 - 启用并打开工具
本节使用路由模式。
在 Codex 页顶部打开路由,点击开始路由。在确认框的路由到里选择 QuickRouter,再点开始路由。如果路由已开启,在 QuickRouter 卡片上点击路由到此。
确认顶部显示路由生效中且目标是 QuickRouter。保持 CC Switch 运行。CLI 用户退出旧进程后重新运行
codex,桌面用户完全退出 Codex 后重新打开。要让第三方模型出现在/model列表里,先在 QuickRouter 供应商表单里填写模型映射并保存,再重启 Codex。在「路由」页点「开始路由」,在确认框选择 QuickRouter。 - 发送消息验证
在 Codex 新会话中使用上面配置的默认模型,发送「请只回复 OK」。看到回复后,在QuickRouter 使用日志按发送时间和令牌核对本次请求及实际模型。
查看配置细节与排错
核对生成配置:model_provider 与 [model_providers.xxx] 名称一致,模型为 gpt-6-sol。wire_api 始终保持 "responses"。

接管后 Codex 使用本地 /v1 地址,例如 http://127.0.0.1:15721/v1。PROXY_MANAGED 是路由管理的占位凭据,真实上游 Key 由 CC Switch 保存并注入。端口以本机设置为准。Codex 配置排错。
确认配置生效
打开 Codex 的新会话,选择刚配置的模型,发送「请只回复 OK」。在 QuickRouter 使用日志核对发送时间和实际请求模型。遇到 401 或 403 时,先检查令牌和模型权限。
查看原有安装、手动配置与排错
适用范围:CC-Switch 路由和 CLI 手动 Responses 二选一;原生配置速查见下方。
版本与验证:2026-09-28,macOS 26.3,Codex CLI 0.158.0-alpha.2.1,gpt-6-sol / Responses 真实文本调用通过。此次为只读、单轮、无工具请求;桌面版、VS Code 插件和代码修改未验证。
配置速查
| 配置项 | 填写内容 | 注意事项 |
|---|---|---|
| 配置文件 | ~/.codex/config.toml | Windows 位于用户目录下 .codex;保留已有无关配置。 |
| model_provider | quickrouter | 必须与 [model_providers.quickrouter] 完全一致。 |
| base_url | https://api.quickrouter.ai/v1 | 不是完整 /responses 请求地址。 |
| wire_api | responses | 不能因为服务商支持 Chat 就直接写 chat。 |
| env_key | QUICKROUTER_API_KEY | 这是环境变量名称,不是密钥本身。 |
还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key
为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。
先选一种配置方式
- 第一次配置:用 CC-Switch 路由。按图添加 QuickRouter 并开始路由。
- 习惯编辑配置文件:手动配置 Responses。适合令牌和模型支持原生 Responses 的用户。
方式一:用 CC-Switch 配置
- 创建 QuickRouter API Key,打开 CC-Switch 的 Codex 页面,点「添加供应商」。
- 名称填
QuickRouter,地址填https://api.quickrouter.ai/v1,粘贴自己的 API Key。上游格式选「Chat Completions(需开启路由)」,默认模型用令牌可用的 Chat 模型 ID。 - 保存后点「路由 → 开始路由」,选 QuickRouter 并确认。在新终端打开 Codex,发送「请只回复 OK,不要读取或修改任何文件。」,再到控制台使用日志核对。

查看 CC-Switch 的完整图文步骤 · QuickRouter Switch 一键配置
方式二:手动配置原生 Responses
进入 QuickRouter 控制台 → API 令牌 → 新建,选择支持目标模型及协议的分组,设置额度后复制令牌。已有令牌可继续使用;模型目录和权限不是同一回事。查看创建分组令牌的图文步骤。
合并到用户级 ~/.codex/config.toml;provider 键放在项目级配置会被忽略。env_key 是变量名,不能直接写令牌。
model_provider = "quickrouter"
model = "gpt-6-sol"
[model_providers.quickrouter]
name = "QuickRouter"
base_url = "https://api.quickrouter.ai/v1"
wire_api = "responses"
env_key = "QUICKROUTER_API_KEY"export QUICKROUTER_API_KEY="YOUR_QUICKROUTER_API_KEY"
codex --version
codex exec --skip-git-repo-check --sandbox read-only "Reply exactly QUICKROUTER_OK. Do not use tools."PowerShell 用 $env:QUICKROUTER_API_KEY = "YOUR_QUICKROUTER_API_KEY"。在同一终端启动;Dock 启动的桌面程序不一定继承这个变量。原生协议目标是 /v1/responses;只支持 Chat 的上游需另按 CC Switch 协议路由配置。
Codex 是 OpenAI 推出的 AI 编程助手。通过 QuickRouter API 接入,国内开发者可以快速使用 Codex 进行 AI 辅助编程。
强大的 OpenAI 代码助手安装指南
安装 Node.js
方法一:使用官方安装包(推荐)。访问 Node.js 官网,下载 LTS 版本 Windows Installer (.msi),运行安装程序,按默认设置完成安装。
node --version
npm --version

安装 Codex CLI
打开普通 PowerShell 或命令提示符,执行以下命令。
npm install -g @openai/codex

配置 QuickRouter API
Codex 需要使用专门的分组令牌,建议与 Claude Code 的令牌分开。
4.1 获取 Auth Token
访问 QuickRouter API 控制台,点击左侧菜单「令牌管理」-「添加令牌」,创建 Codex 专用分组令牌。
4.2 创建配置文件
在 C:\\Users\\当前登录用户\\.codex\\ 目录下先备份并合并 config.toml,再设置环境变量。
model_provider = "quickrouter"
model = "gpt-6-sol"
[model_providers.quickrouter]
name = "QuickRouter"
base_url = "https://api.quickrouter.ai/v1"
wire_api = "responses"
env_key = "QUICKROUTER_API_KEY"
$env:QUICKROUTER_API_KEY = "你的 QuickRouter API Key"

初始化项目并开始使用
mkdir my-codex-project
cd my-codex-project
codex
- 选择你的开发环境配置
- 根据提示确认权限
- 开始使用 Codex

安装 Node.js
使用 Homebrew 安装 Node.js。
brew install node
安装 Codex CLI
npm install -g @openai/codex
配置 QuickRouter API
Codex 需要使用专门的分组令牌,建议与 Claude Code 的令牌分开。
3.1 获取 Auth Token
访问 QuickRouter API 控制台,点击左侧菜单「令牌管理」-「添加令牌」,创建 Codex 专用分组令牌。
3.2 创建配置文件
在 ~/.codex/ 目录下先备份并合并 config.toml,再设置环境变量。
model_provider = "quickrouter"
model = "gpt-6-sol"
[model_providers.quickrouter]
name = "QuickRouter"
base_url = "https://api.quickrouter.ai/v1"
wire_api = "responses"
env_key = "QUICKROUTER_API_KEY"
export QUICKROUTER_API_KEY="你的 QuickRouter API Key"
初始化项目并开始使用
mkdir my-codex-project
cd my-codex-project
codex
- 选择你的开发环境配置
- 根据提示确认权限
- 开始使用 Codex
安装 Node.js
Ubuntu / Debian 用户使用以下命令安装:
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
安装 Codex CLI
npm install -g @openai/codex
配置 QuickRouter API
Codex 需要使用专门的分组令牌,建议与 Claude Code 的令牌分开。
3.1 获取 Auth Token
访问 QuickRouter API 控制台,点击左侧菜单「令牌管理」-「添加令牌」,创建 Codex 专用分组令牌。
3.2 创建配置文件
在 ~/.codex/ 目录下先备份并合并 config.toml,再设置环境变量。
model_provider = "quickrouter"
model = "gpt-6-sol"
[model_providers.quickrouter]
name = "QuickRouter"
base_url = "https://api.quickrouter.ai/v1"
wire_api = "responses"
env_key = "QUICKROUTER_API_KEY"
export QUICKROUTER_API_KEY="你的 QuickRouter API Key"
初始化项目并开始使用
mkdir my-codex-project
cd my-codex-project
codex
- 选择你的开发环境配置
- 根据提示确认权限
- 开始使用 Codex
VSCode 插件
在 VSCode 扩展商店中搜索并安装 Codex 即可使用。

常见问题
API Key 配置确认
- 按预算设置令牌额度上限
- 仅放行准备使用的模型
- 选择当前控制台中支持 Responses 与目标模型的分组;分组名称以实际页面为准。
合并配置时注意
将 gpt-6-sol 替换为实际可用模型。不要把 API Key 写入 env_key,也不要把配置示例覆盖到已有整份文件;保留原有项目、MCP 和权限设置。环境变量应在启动 Codex 的同一终端中设置,仅影响该终端及其子进程。
真实调用记录与验证范围
测试日期:2026-09-28(Asia/Shanghai);macOS 26.3。查看脱敏记录、软件版本和真实生成图片。一次文本成功仅证明本次请求,不代表其他模型、工具执行、多轮上下文或桌面版均已通过。
Codex CLI 0.158.0-alpha.2.1
provider: quickrouter
model: gpt-6-sol
{"type":"item.completed","item":{"type":"agent_message","text":"QUICKROUTER_OK"}}
{"type":"turn.completed","usage":{"input_tokens":20673,"cached_input_tokens":3840,"output_tokens":10}}本次通过命令行覆盖同名配置,使用 --ignore-user-config --ephemeral,保留用户原配置;日常使用按上方用户配置即可。
解析报错、provider 未找到、环境变量未生效:Codex 配置错误定位与复验。
在 T3 Code 中用 Codex?查看T3 Code 配置教程。
怎样确认配置已生效
- 执行 codex --version,记录版本并检查配置能否正常解析。
- 在启动 Codex 的同一终端设置 QUICKROUTER_API_KEY,选择令牌实际可用的 Responses 模型。
- 在测试项目启动 codex,先运行只读任务;控制台日志应出现对应模型请求。
接入失败时逐项检查
| 现象 | 检查与处理 |
|---|---|
| model provider custom not found | model_provider 的值必须对应 model_providers 下同名区块,不能只修改显示名称。 |
| Missing environment variable | env_key 填的是变量名;在启动进程的环境中设置该变量,重启 IDE 或终端。 |
| 404 / 不支持 responses | 检查最终请求是否为 /v1/responses,以及模型/分组是否支持;只有 Chat 的上游应改走经过确认的本地路由转换。 |
| 配置解析失败 | 检查 TOML 引号、区块和重复字段;先备份,再合并最小配置,不覆盖整份配置。 |
资料与下一步
遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。
