Codex 中转介绍

⚙️ CC-Switch 一键配置

用 CC-Switch 图形化工具 5 分钟完成 Codex 中转配置,无需手改文件。
强烈推荐新手使用。CC-Switch 是完全免费开源的桌面工具,能在多个 Provider(OpenAI 官方 / 各家中转)之间一键切换,无需手动编辑 config.tomlauth.json

⚠️ 只用官方渠道下载(务必阅读)

CC-Switch 是 完全免费开源 的桌面应用,作者不向用户收取任何费用。近期有多个冒牌网站伪装成 CC-Switch 收钱、套取账号,已有用户被骗。只通过以下官方渠道获取
渠道唯一官方地址
官方网站ccswitch.io
源代码github.com/farion1231/cc-switch
下载GitHub Releases
作者@farion1231
举报冒牌GitHub Issues
任何向你收费、要充值、要登录密码的「CC Switch」网站或客户端都是假的。 已经被骗的请立即停止支付并提交 Issue。

适合谁

  • ✅ 不想碰命令行和配置文件的开发者
  • ✅ 同时用多个 Codex Provider,需要快速切换
  • ✅ 不同项目用不同模型 / 不同 Key
  • ✅ 想统一管理 Claude Code / Codex / Gemini / OpenCode / OpenClaw / Hermes / Claude Desktop 全家桶

下载安装

最新版本:CC-Switch v3.15.0(发布于 2026-05-16)

下载文件大小适合
CC-Switch-v3.15.0-Windows.msi12.3 MB推荐,标准 MSI 安装包
CC-Switch-v3.15.0-Windows-Portable.zip12.0 MB免安装版(解压即用)

双击 .msi 安装即可,默认安装到 C:\Users\你\AppData\Local\Programs\cc-switch\

支持 Windows 10+

v3.15.0 新特性速览

Claude Desktop 一级管理面板

Claude Desktop 现在和 Claude Code / Codex 同等地位,可通过内置代理网关切换第三方供应商,并自带 44 个预设供应商

反向代理大幅加固

P0-P3 修补路由 / 生命周期 / 重试 / 失败回退;非 Anthropic 后端 HTTPS 连接池复用;缓存命中率优化;支持 IPv6 监听

Role-based 模型映射

Claude Code 改用 sonnet / opus / haiku 角色映射,并新增 supports1m 长上下文标志,替代旧的 [1M] 后缀

Codex OAuth 实时模型发现

ChatGPT Codex 供应商不再依赖硬编码模型清单,实时从 ChatGPT 后端拉取最新模型列表

添加 Nexoraivision Provider

CC-Switch 顶部有多个工具 Tab(Claude Code / Codex / Gemini / OpenCode / OpenClaw / Hermes / Claude Desktop),每个 Tab 是独立的 Provider 列表 + 独立配置文件。本文是 Codex Tab 流程,Claude Code 看 /claude-code/cc-switch。⚠️ v3.15.0 起 Claude Code 和 Claude Desktop 是两个独立 Tab,别选错。
配置前先备份:CC-Switch 会自动覆写 ~/.codex/config.toml~/.codex/auth.json(Windows 对应 %USERPROFILE%\.codex\)。如果你之前手动配过或同时管理多个供应商,强烈建议先备份这两个文件
# macOS / Linux
cp ~/.codex/config.toml ~/.codex/config.toml.bak
cp ~/.codex/auth.json ~/.codex/auth.json.bak

# Windows PowerShell
Copy-Item $env:USERPROFILE\.codex\config.toml $env:USERPROFILE\.codex\config.toml.bak
Copy-Item $env:USERPROFILE\.codex\auth.json $env:USERPROFILE\.codex\auth.json.bak
CC-Switch 也会在每次切换前自动备份~/.codex/backups/(带时间戳),可以从那恢复。

启动 CC-Switch

打开后看到主界面。切到顶部 Codex Tab(默认可能在 Claude)。Codex Tab 下管理的是 Codex CLI 用的 Provider 列表。

新增 Provider

点击右上角橙色 + 按钮,进入「添加新供应商」页面。顶部应该自动定位到 Codex 供应商 Tab。

填写信息

如果预设供应商里没有 Nexoraivision,选最左边的 「自定义配置」,然后填:

字段填什么
供应商名称Nexoraivision(自己起名)
备注可选
API Key控制台 复制
请求地址https://nexor.nexoraivision.com

具体字段以 CC-Switch 实际界面为准。Codex Tab 可能额外提供:默认模型选择、推理强度、wire_api 等选项,按需勾选即可。最终生成的 config.toml 内容见 手动配置

提交

点页面右下角 + 添加 按钮保存到列表。

启用

回到主界面,在新加的 Provider 行右侧点 ▶ 启用。CC-Switch 自动写入:

  • ~/.codex/config.toml(或 Windows 的 %userprofile%\.codex\config.toml
  • ~/.codex/auth.json

验证

codex --version
codex "hi"

能正常返回即配置成功。

在多个 Provider 间切换

如果你同时配了多个 Provider(比如官方 OpenAI + Nexoraivision + 另一家中转):

  • 主界面 Provider 列表里点哪个就用哪个
  • 切换会自动覆盖 config.tomlauth.json
  • 不影响当前正在运行的 Codex 会话;下次新建会话时生效

高级功能

自动备份

CC-Switch 在每次切换前会备份当前配置到 ~/.codex/backups/,文件名带时间戳。误操作可以从这里恢复。

导入 / 导出

设置 → 导入/导出

  • 导出:把所有 Provider 配置打包成 JSON(不含 API Key)
  • 导入:从同事/团队那拿一个模板快速搭建

命令行集成

CC-Switch 也提供 CLI:

cc-switch list                  # 列出所有 provider
cc-switch use nexoraivision     # 切换到指定 provider
cc-switch current               # 查看当前激活的 provider

配置 Key 不显示?

CC-Switch 出于安全考虑只在创建时让你看一次完整 Key,之后只显示末 4 位。

如果忘了 Key,**直接回到 控制台**生成新的,再在 CC-Switch 编辑同一个 Provider 替换 Key 即可。

常见问题

不想用 CC-Switch?看 手动配置指南 自己写 config.toml。