Codex 桌面版是 2026 年推出的独立 AI 编程智能体客户端,支持 Windows 10+、macOS 12+、Linux 全平台,同年正式开放第三方模型接入能力。只要服务商兼容 OpenAI Responses API 格式,就可以直接作为 Codex 的推理后端。
对于国内无法直接使用官方账号的开发者,目前主流实操方案:安装 CC Switch 统一管理 API 配置,搭配兼容 Responses API 的第三方平台生成 API‑Key,绕过账号登录限制,完整解锁 Codex 桌面版代码审查、智能补全、多步骤复杂任务执行全部能力。 本文以 New.bi 为实例,完整拆解从安装、CC Switch 配置到 API‑Key 导入的全流程。
Codex 桌面版是什么
Codex 是 OpenAI 面向软件工程打造的 AI 编程智能体,核心能力覆盖四大场景:
- 代码审查:直接解析未提交代码 diff,输出可落地的修改建议
- 多步骤任务:自然语言描述需求,自动拆解任务完成跨文件开发
- 项目上下文感知:读取本地仓库结构,生成贴合项目编码规范的代码
- 多模型兼容 :内置
gpt‑5.4、gpt‑5.4‑mini,通过 Responses API 支持第三方推理后端接入
根据 OpenAI 官方博客(2026 年 6 月),Codex 桌面版开放 Responses API 接入之后,国内 MiniMax、阿里云百炼、百度千帆、火山方舟等均已完成适配;接入方式由账号登录改为标准 API Key 鉴权,大幅降低国内开发者使用门槛。
前期准备
操作前,请确认以下工具准备就绪:
表格
| 工具 | 用途 | 获取渠道 |
|---|---|---|
| Codex 桌面客户端 | AI 编程核心主体工具 | OpenAI 官网 chatgpt.com/codex |
| CC Switch v3.17.0 | API 配置统一管理器,一键切换模型服务商 | CC Switch 官方网站 |
| API Key | 接口身份凭证 | 第三方 API 平台 New.bi |
运行 Codex。
登录时选择API KEY登录。
输入在API API密令管理 中创建的Codex专用的API KEY。
Codex使用的API KEY选择 New.bi-GPT分组 或 Codex专属 。
当前Codex登录进入后还不能使用,继续完成CC Switch配置
二、CC Switch 配置
方式二:
运行 CC Switch。
选中 Codex,点击右上角的+号增加供应商。

选择自定义配置

下拉设置供应商信息
设置 供应商名称
官网链接设置为 https://api.new.bi
API KEY设置为在API API密令管理 中创建的Codex专用的API KEY。
请求地址设置为 https://api.new.bi/v1
模型名称设置选择的模型名称,可以使用的模型可以在 Codex可用模型 链接中查看,正常只支持gpt的模型。推荐使用gpt-5.6-sol。


设置完信息后点击右下角添加完成供应商设置。
最后回到Codex选项下选中刚设置的API供应商点击启用。

如需要使用非GPT系列模型,比如Claude,可参考下图进行配置

方式二:
第一步:获取 New.bi 的 API 密钥
其他兼容 Responses‑API 的中转平台操作逻辑一致
- 登录 New.bi 控制台,打开左侧菜单 【API 密钥】
- 点击右上角 【+ 创建密钥】
- 设置密钥名称,例如
codex‑use,分组选择code‑plan/Mini4.(可选)设置调用额度上限,填 0 代表不限制用量 - 点击创建,复制生成以
sk‑开头完整密钥字符串保存备用
New.bi API 端点地址:
https://api.new.bi
第二步:下载并安装 CC Switch
CC Switch 基于 Tauri2(Rust 后端 + React 前端)开发,MIT 协议完全开源,可统一管理 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五款主流 AI 编程客户端的 API 配置。
安装步骤
- 进入 CC Switch 官网跳转 GitHub 发布下载页
- 在 Assets 资源列表,根据操作系统下载对应安装包
可以参考 CC Switch Windows系统安装教程 - New.bi
| 系统 | 推荐安装包 |
|---|---|
| macOS(Apple Silicon) | CC‑Switch‑v3.17.0‑macOS.dmg |
| macOS(Intel) | CC‑Switch‑v3.17.0‑macOS.dmg |
| Windows 10+ | CC‑Switch‑v3.17.0‑x64.exe |
| Linux arm64 | CC‑Switch‑v3.17.0‑Linux‑arm64.AppImage |
| Linux x86_64 | CC‑Switch‑v3.17.0‑Linux‑x86_64.AppImage |
- 正常流程完成安装,首次启动跟随引导完成初始化设置。
第三步:New.bi API 配置导入 CC Switch
New.bi 控制台支持一键导入 CC Switch 配置,无需手动编辑 JSON 配置文件
- 返回 New.bi 控制台的 【API 密钥】 页面
- 在密钥列表,找到刚刚新建的密钥,点击右侧 【导入 CCS】
- 在弹窗核对配置信息,保证参数正确:
- 应用类型:
Codex - 供应商名称:
New.bi - API 端点:
https://api.new.bi - 模型:
gpt‑5.6-sol
- 应用类型:
- 确认无误点击【导入


导入成功后,CC Switch 供应商列表会出现New.bi,右侧可直接查看余额、调用用量统计。
第四步:CC Switch 启用 New.bi 供应商
- 打开 CC Switch,顶部工具栏选择 OpenAI 系 GPT 图标
- 在供应商列表定位
New.bi - 打开右侧启用开关

✅至此 CC Switch 配置完成,Codex 后续全部请求都会路由至 New.bi 接口服务。
第五步:安装 Codex 桌面客户端
- 访问 OpenAI 官方地址 chatgpt.com/codex,下载适配本机系统的安装包
- 完成安装并启动 Codex
- 在登录页面,务必选择 「使用其他方式登录」,不要选择账号登录,避免 ChatGPT 账号校验拦截。
第六步:API Key 完成 Codex 登录鉴权
- 回到 New.bi 控制台【API 密钥】,复制完整 sk‑密钥
- Codex 登录页粘贴 API Key
- BaseURL 填写:
https://api.new.bi - 点击确认,客户端自动校验密钥有效性完成初始化
左下角状态栏展示当前使用模型名称,即代表第三方后端接入成功。
✨接入后可用全部能力
配置成功之后,Codex 全部功能均可正常调用:
- 代码审查 :终端执行
codex review --uncommitted,读取仓库未提交 diff 输出评审意见 - 智能任务模式 :直接自然语言输入需求,例如:
为当前项目Python函数补充单元测试,自动分步完成开发 - 多语言支持:JavaScript、Python、Go、Rust、Java 等主流编程语言均可稳定运行
- 快速切换模型服务商 :CC Switch 直接切换,无需重启 Codex 客户端
社区实测(2026 年 7 月掘金 Codex 第三方接入专题):兼容 Responses API 的第三方后端,代码补全响应延迟与官方登录版本接近,任务完成成功率差距控制在 5% 以内。注:该数据仅供参考,正式基准建议查阅 OpenAI 官方测试报告。
❓常见问题解答
Q:CC Switch 和直接在 Codex 填写 API Key 有什么区别?
CC Switch 核心价值是多工具统一管理。一套 API 配置同时支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 多款工具。切换服务商仅需要一次开关操作,不用逐个修改每款工具配置文件。适合同时使用多款 AI 编程工具的开发者。
Q:提示 model not supported 模型不支持怎么办?
大概率密钥分组没有开放该模型权限。新建密钥优先选择 Dedicated Pool 分组,该分组模型限制更少;也可在 New.bi 控制台【可用渠道】查看真实可用模型 ID,在 CC Switch 修改模型名称与服务商对齐。
Q:Codex 桌面版和 Codex CLI 区别?
两者核心能力一致,交互形式不同:
- 桌面版:图形界面,适合不熟悉命令行的开发者
- CLI 版:
npm install -g @openai/codex,适配终端原生工作流
两者都支持第三方 API Key 接入后端
Q:CC Switch 收费吗?
CC Switch 为 MIT 开源项目,软件本体完全免费。API 调用产生费用全部由 New.bi 这类模型服务商收取,与 CC Switch 无关。
📝总结
Codex 桌面版在 2026 开放 Responses API 第三方接入之后,CC Switch + New.bi API‑Key 已经成为国内开发者高性价比使用方案。 整套流程三个关键节点:
- 在 New.bi 控制台生成合法 API 密钥
- 通过 CC Switch 完成 API 配置统一托管
- Codex 客户端选择 API‑Key 方式完成登录鉴权
根据 CC Switch 官方文档(截至 2026‑07),工具已适配十余家 API 服务商一键导入,生态持续更新。本文基于 CC Switch v3.17.0 + Codex 桌面版 2026‑07 发行版,建议关注项目更新日志获取最新配置方式。