Codex 配置教程

配置 Chat Completions 上游,通过本地路由连接 Codex 的 Responses 接口。

先安装 Codex,并创建 QuickRouter API Key。

推荐用 QuickRouter Switch 一键配置。已安装 CC-Switch 的用户也可选择备选方式。

使用 QuickRouter Switch 配置

还没安装?下载并安装 QuickRouter Switch。

  1. 添加供应商

    打开 QuickRouter Switch,在左边选「Codex」,点「添加供应商」。

    在 Codex 页面点击「添加供应商」。
    图 6 在 Codex 页面点击「添加供应商」。
  2. 填写 API Key

    把自己的 API Key 粘贴到同名输入框。地址和接口格式已经填好。模型可换成自己实际要用、当前 Key 能调用的模型。

    模型可换成自己实际要用的模型。填好 API Key,核对请求地址后点击「添加」。
    图 7 模型可换成自己实际要用的模型。填好 API Key,核对请求地址后点击「添加」。
  3. 开始路由

    点右下角「添加」。回到列表,点「开始路由」,选中 QuickRouter 并确认。看到「路由中」后,重新打开 Codex。用桌面版就完全退出再打开,用编辑器插件就重开编辑器窗口。使用时保持 QuickRouter Switch 开着。

    在 Codex 的路由确认框选 QuickRouter。
    图 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。

Codex CLI 手动配置 Responses。

查看 Codex 专题:配置、排错和可复跑案例

  1. 添加供应商

    打开 CC Switch,在左侧选择Codex,点击添加供应商,选择自定义配置。

  2. 填写连接信息
    • 名称填 QuickRouter,API Key 填自己的令牌,API 请求地址填 https://api.quickrouter.ai/v1,完整 URL 关闭。
    • 展开「高级选项」,上游格式选 Chat Completions(需开启路由)。生成配置中的 wire_api 保持 "responses"。
    Codex 的 QuickRouter Chat 上游配置
    Codex:请求地址带 /v1,默认模型 gpt-6-sol,上游为 Chat Completions。
  3. 设置模型
    • 在「默认模型」填当前令牌可用的模型 ID,例如 gpt-6-sol。

    示例模型可以换成自己实际要用的模型,使用 模型价格页中的完整模型 ID,并确认 API Key 有权限。

  4. 保存供应商

    在表单底部点击添加。返回 Codex 供应商列表后,确认出现 QuickRouter 卡片。

  5. 启用并打开工具

    本节使用路由模式。

    在 Codex 页顶部打开路由,点击开始路由。在确认框的路由到里选择 QuickRouter,再点开始路由。如果路由已开启,在 QuickRouter 卡片上点击路由到此。

    确认顶部显示路由生效中且目标是 QuickRouter。保持 CC Switch 运行。CLI 用户退出旧进程后重新运行 codex,桌面用户完全退出 Codex 后重新打开。要让第三方模型出现在 /model 列表里,先在 QuickRouter 供应商表单里填写模型映射并保存,再重启 Codex。

    Codex 的 CC Switch 供应商界面截图
    在「路由」页点「开始路由」,在确认框选择 QuickRouter。
  6. 发送消息验证

    在 Codex 新会话中使用上面配置的默认模型,发送「请只回复 OK」。看到回复后,在QuickRouter 使用日志按发送时间和令牌核对本次请求及实际模型。

查看配置细节与排错

核对生成配置:model_provider 与 [model_providers.xxx] 名称一致,模型为 gpt-6-sol。wire_api 始终保持 "responses"。

Codex 的生成配置与 responses wire_api
Codex 下游保持 Responses,Chat 上游转换由本地路由完成。

接管后 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.tomlWindows 位于用户目录下 .codex;保留已有无关配置。
model_providerquickrouter必须与 [model_providers.quickrouter] 完全一致。
base_urlhttps://api.quickrouter.ai/v1不是完整 /responses 请求地址。
wire_apiresponses不能因为服务商支持 Chat 就直接写 chat。
env_keyQUICKROUTER_API_KEY这是环境变量名称,不是密钥本身。

还没有 API Key?注册获取免费体验额度 · 已注册:进入控制台创建 API Key

为此工具单独创建令牌,并设置合理额度和模型权限。截图中的模型仅作示例,以账号当前可用模型为准;不要公开密钥或上传含密钥的配置文件。

先选一种配置方式

Codex 两条路线:CC-Switch Chat 上游路由和原生 Responses 直连
按你使用的接入方式选一条即可。

方式一:用 CC-Switch 配置

  1. 创建 QuickRouter API Key,打开 CC-Switch 的 Codex 页面,点「添加供应商」。
  2. 名称填 QuickRouter,地址填 https://api.quickrouter.ai/v1,粘贴自己的 API Key。上游格式选「Chat Completions(需开启路由)」,默认模型用令牌可用的 Chat 模型 ID。
  3. 保存后点「路由 → 开始路由」,选 QuickRouter 并确认。在新终端打开 Codex,发送「请只回复 OK,不要读取或修改任何文件。」,再到控制台使用日志核对。
CC-Switch 的 Codex 配置界面,红框标记地址、API Key 和上游格式
CC-Switch 的 Codex 真实配置界面。

查看 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 辅助编程。

Codex 安装步骤

强大的 OpenAI 代码助手安装指南

1 环境准备→ 2 安装配置→ 3 开始编程
1

安装 Git Bash

如需使用 Git Bash,可先安装 Git for Windows。访问 Git 官网下载 并按默认选项安装。

Git Bash 安装

2

安装 Node.js

方法一:使用官方安装包(推荐)。访问 Node.js 官网,下载 LTS 版本 Windows Installer (.msi),运行安装程序,按默认设置完成安装。

terminal
node --version
npm --version

Node.js 安装

3

安装 Codex CLI

打开普通 PowerShell 或命令提示符,执行以下命令。

terminal
npm install -g @openai/codex

Codex 安装

4

配置 QuickRouter API

Codex 需要使用专门的分组令牌,建议与 Claude Code 的令牌分开。

4.1 获取 Auth Token

访问 QuickRouter API 控制台,点击左侧菜单「令牌管理」-「添加令牌」,创建 Codex 专用分组令牌。

4.2 创建配置文件

在 C:\\Users\\当前登录用户\\.codex\\ 目录下先备份并合并 config.toml,再设置环境变量。

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"
环境变量(在启动 Codex 的终端设置)
$env:QUICKROUTER_API_KEY = "你的 QuickRouter API Key"

配置文件

5

初始化项目并开始使用

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

启动 Codex

1

安装 Node.js

使用 Homebrew 安装 Node.js。

terminal
brew install node
2

安装 Codex CLI

terminal
npm install -g @openai/codex
3

配置 QuickRouter API

Codex 需要使用专门的分组令牌,建议与 Claude Code 的令牌分开。

3.1 获取 Auth Token

访问 QuickRouter API 控制台,点击左侧菜单「令牌管理」-「添加令牌」,创建 Codex 专用分组令牌。

3.2 创建配置文件

在 ~/.codex/ 目录下先备份并合并 config.toml,再设置环境变量。

~/.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"
环境变量(在启动 Codex 的终端设置)
export QUICKROUTER_API_KEY="你的 QuickRouter API Key"
4

初始化项目并开始使用

terminal
mkdir my-codex-project
cd my-codex-project
terminal
codex
  • 选择你的开发环境配置
  • 根据提示确认权限
  • 开始使用 Codex
1

安装 Node.js

Ubuntu / Debian 用户使用以下命令安装:

terminal
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs
2

安装 Codex CLI

terminal
npm install -g @openai/codex
3

配置 QuickRouter API

Codex 需要使用专门的分组令牌,建议与 Claude Code 的令牌分开。

3.1 获取 Auth Token

访问 QuickRouter API 控制台,点击左侧菜单「令牌管理」-「添加令牌」,创建 Codex 专用分组令牌。

3.2 创建配置文件

在 ~/.codex/ 目录下先备份并合并 config.toml,再设置环境变量。

~/.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"
环境变量(在启动 Codex 的终端设置)
export QUICKROUTER_API_KEY="你的 QuickRouter API Key"
4

初始化项目并开始使用

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

VSCode 插件

在 VSCode 扩展商店中搜索并安装 Codex 即可使用。

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 配置教程。

怎样确认配置已生效

  1. 执行 codex --version,记录版本并检查配置能否正常解析。
  2. 在启动 Codex 的同一终端设置 QUICKROUTER_API_KEY,选择令牌实际可用的 Responses 模型。
  3. 在测试项目启动 codex,先运行只读任务;控制台日志应出现对应模型请求。

接入失败时逐项检查

现象检查与处理
model provider custom not foundmodel_provider 的值必须对应 model_providers 下同名区块,不能只修改显示名称。
Missing environment variableenv_key 填的是变量名;在启动进程的环境中设置该变量,重启 IDE 或终端。
404 / 不支持 responses检查最终请求是否为 /v1/responses,以及模型/分组是否支持;只有 Chat 的上游应改走经过确认的本地路由转换。
配置解析失败检查 TOML 引号、区块和重复字段;先备份,再合并最小配置,不覆盖整份配置。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID,联系支持时先隐藏 API Key。

在线客服