⚙️ CC-Switch 一键配置
config.toml 和 auth.json。⚠️ 只用官方渠道下载(务必阅读)
| 渠道 | 唯一官方地址 |
|---|---|
| 官方网站 | ccswitch.io |
| 源代码 | github.com/farion1231/cc-switch |
| 下载 | GitHub Releases |
| 作者 | @farion1231 |
| 举报冒牌 | GitHub Issues |
适合谁
- ✅ 不想碰命令行和配置文件的开发者
- ✅ 同时用多个 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.msi | 12.3 MB | 推荐,标准 MSI 安装包 |
CC-Switch-v3.15.0-Windows-Portable.zip | 12.0 MB | 免安装版(解压即用) |
双击 .msi 安装即可,默认安装到 C:\Users\你\AppData\Local\Programs\cc-switch\。
支持 Windows 10+。
| 下载文件 | 大小 | 适合 |
|---|---|---|
CC-Switch-v3.15.0-macOS.dmg | 25.6 MB | 推荐,标准 DMG 安装 |
CC-Switch-v3.15.0-macOS.zip | 25.6 MB | ZIP 解压版 |
CC-Switch-v3.15.0-macOS.tar.gz | 26.2 MB | tar 包(CI / 脚本用) |
下载 .dmg 双击,拖图标到 Applications 文件夹即可。
- 法一:右键点击 App → 选「打开」 → 弹窗里点「打开」(推荐)
- 法二:
系统设置 → 隐私与安全性滚到底点「仍要打开」
支持 x86_64 和 arm64 两个架构,4 种包格式:
| 发行版 | 推荐包 | 安装命令 |
|---|---|---|
| Ubuntu / Debian / Mint / Pop!_OS | .deb | sudo dpkg -i CC-Switch-*.deb 或 sudo apt install ./CC-Switch-*.deb |
| Fedora / RHEL / CentOS / Rocky Linux | .rpm | sudo rpm -i CC-Switch-*.rpm 或 sudo dnf install ./CC-Switch-*.rpm |
| openSUSE | .rpm | sudo zypper install ./CC-Switch-*.rpm |
| Arch / Manjaro | .AppImage | 加执行权限直接跑,或用 AUR |
| 其他 / 不确定 | .AppImage | chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage |
arm64 用户下载 CC-Switch-v3.15.0-Linux-arm64.*,x86_64 用户下载 CC-Switch-v3.15.0-Linux-x86_64.*。
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
~/.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
~/.codex/backups/(带时间戳),可以从那恢复。启动 CC-Switch
打开后看到主界面。切到顶部 Codex Tab(默认可能在 Claude)。Codex Tab 下管理的是 Codex CLI 用的 Provider 列表。

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

填写信息
如果预设供应商里没有 Nexoraivision,选最左边的 「自定义配置」,然后填:
| 字段 | 填什么 |
|---|---|
| 供应商名称 | Nexoraivision(自己起名) |
| 备注 | 可选 |
| API Key | 从 控制台 复制 |
| 请求地址 | https://nexor.nexoraivision.com |

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.toml和auth.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 即可。
常见问题
Windows:通常缺少 Visual C++ Redistributable 运行库。
下载安装:https://aka.ms/vs/17/release/vc_redist.x64.exe
macOS:首次打开因 Gatekeeper 阻拦:
- 法一(推荐):右键 App → 选「打开」→ 弹窗里再点「打开」
- 法二:
系统设置 → 隐私与安全性滚到底点「仍要打开」
Linux:AppImage 没加执行权限:
chmod +x CC-Switch-*.AppImage
4 步排查清单:
- CLI 真的装了吗? 跑
codex --version看版本号能否输出 - Key 分组对吗? Codex 必须用
Codex 分组的 Key(其他分组没权限) - 点了「启用」吗? CC-Switch 主界面对应 Provider 状态应该是「使用中」
- 终端重开了吗? 旧终端的环境变量是缓存的,关掉所有终端窗口重开
仍不行就手动核对配置文件:
# 看 base_url 是不是 https://nexor.nexoraivision.com
cat ~/.codex/config.toml
# 看 OPENAI_API_KEY 是不是真的 sk-...
cat ~/.codex/auth.json
Windows 路径:%USERPROFILE%\.codex\config.toml 和 %USERPROFILE%\.codex\auth.json。
最常见原因:令牌分组错了。
- 用 Codex CLI → 必须 用 Codex 分组 的 Key
- 用 Claude Code → 必须用 Claude 系列分组的 Key
- 用 Gemini → 必须用 Gemini 分组的 Key
不同分组的令牌只能调用对应工具的模型,跨用会报 model not found。控制台 → 「API 密钥」检查 Key 的分组是否正确。
- 关闭并重开所有终端窗口(环境变量是进程级缓存)
- 检查是否有 shell 配置(
.bashrc/.zshrc)手动export OPENAI_API_KEY=...覆盖了 auth.json - 直接
cat ~/.codex/config.toml看 CC-Switch 是不是真的写了 - 看
~/.codex/backups/里是不是有备份记录
CC-Switch 是全局切换。项目级隔离用环境变量:
# 项目 A 用 nexoraivision
cd projectA
export OPENAI_API_KEY="sk-xxx-nexor"
export CODEX_CONFIG=~/.codex/configs/nexor.toml
codex
是。任何手改在下次 CC-Switch 应用时都会被覆盖。如果你想长期手改,在 CC-Switch 的「设置 → 跳过托管」勾选对应字段。
v3.15 把 Claude Code 和 Claude Desktop 拆成了两个独立 Tab。如果你之前的配置默认显示在「Claude」Tab 里,升级后应该出现在新的「Claude Code」Tab。
顶部应用切换器选「Claude Code」即可看到。
