CC-Switch 配置教程：Claude Code / Codex 供应商切换
更新于 2026-10-19 · 阅读约 6 分钟 · 适用系统：Windows / macOS / Linux
CC-Switch 是一个开源工具，用来集中管理多个 API 供应商、API Key、请求地址和本地代理。如果你同时用 Claude Code 和 Codex、或者有多个 Key 要切换，用它管理比每个客户端单独改配置干净得多。本文讲从安装到接入 FoxHub 的完整流程。
第一步：下载安装
CC-Switch 官方下载入口在 GitHub Releases，按自己的系统选择安装包：
Windows
下载 .msi 安装包，适合 Windows 电脑。
macOS
下载 macOS 包；首次打开如被拦截，在系统设置里允许。
Linux
按系统架构选择对应包，不确定时看 Releases 说明。
第二步：一键导入 FoxHub（推荐）
- 登录 FoxHub，进入「API 密钥」页面。
- 点击对应密钥的「导入到 CCS」按钮。
- 选择 Claude、Codex 或 Gemini 以及要使用的模型。
- 确认后会自动打开 CC-Switch 并完成导入，保存启用即可。
如果提示「CC-Switch 未安装或协议处理程序未注册」：先安装并启动 CC-Switch；仍无法打开时，用下面的手动配置。
第三步：手动配置（备用）
Claude 栏（用于 Claude Code）
- 打开 CC-Switch，选择顶部第一个 Claude 图标。
- 点击右上角加号，添加一个 Claude 供应商。
- 供应商名称随意填写；API Key 填 FoxHub 生成的 Anthropic 兼容分组令牌。
- 请求地址填
https://foxhub.cn，API 格式选择 Anthropic Messages（原生）。
- 保存后启用。
- 请求地址
- https://foxhub.cn（不带 /v1）
- API 格式
- Anthropic Messages
Codex 栏（用于 Codex / OpenAI 客户端）
- 切换到 Codex / OpenAI 页面，点击右上角加号。
- 预设供应商保持「自定义配置」。
- API Key 填 FoxHub 生成的 OpenAI 兼容分组令牌。
- API 请求地址填
https://foxhub.cn/v1，模型名填后台显示的模型名（不确定可点「获取模型列表」）。
- 保存后启用，点击测试按钮看到「运行正常」即成功。
- Base URL
- https://foxhub.cn/v1（带 /v1）
- API 格式
- OpenAI 兼容
切换 Key 的正确姿势：先关闭所有 Claude Code 进程，再重新打开 Claude Code，新配置才会生效。不同客户端建议创建不同 API Key，方便排查问题和分别统计用量。
常见问题
Claude 和 Codex 的地址到底怎么填？
记住一句话：Claude 不带 /v1，Codex 带 /v1。Claude 填 https://foxhub.cn，Codex 填 https://foxhub.cn/v1。地址写错是最常见的 404 原因。
渠道类型选错会怎样？
Claude Code 选 Anthropic 类型、GPT / Codex 选 OpenAI 类型。选错会导致请求无法被正确处理，报 400 或 401。
FoxHub 有哪些分组和模型可选？
共 9 个分组，覆盖 GPT（gpt-6.1-sol）、Claude（claude-sonnet-5）、Gemini（gemini-3.8-flash）、Grok（grok-4.5）、DeepSeek（deepseek-v4.1-flash）、GLM（glm-5.3）、Kimi（kimi-k3），完整价格见
价格总览。
测试按钮提示失败怎么排查？
依次检查：API 地址是否填对、API Key 是否完整（无多余空格换行）、模型名称是否与后台一致、账号余额是否充足、渠道类型是否选对。
下一步
按客户端继续看细化教程，或直接进控制台创建密钥。