本文介绍如何使用 CC Switch 快速配置第三方 API，把原本需要手动修改 JSON、TOML、.env 的步骤，改成在网页中导入、在 CC Switch 中切换 Provider。
一般第三方中转都支持 CC Switch 导入或提供 API Key / Base URL / 模型名的服务商，也可以参考同样思路配置。

更新时间：2026-05-24

---

1. 简介

Claude Code、Codex、Gemini CLI、OpenCode 这类 AI 编程工具，本质上都需要几类配置：

• API Key
• Base URL
• 模型名
• Provider 类型
• 是否走本地代理或格式转换

如果只用一个官方账号，手动配置一次通常就够了。但如果经常在官方 API、第三方中转、公司网关之间切换，手动改配置文件就会变得麻烦：路径不一样、格式不一样、字段名不一样，改错以后还要回忆原来的配置。

CC Switch 的作用就是把这件事可视化：把不同服务商配置成 Provider，需要切换时直接点选 Provider。对于第三方 API 场景，它最实用的价值是：

场景	手动配置	使用 CC Switch
新增第三方 API	手写 Key、Base URL、模型名	网页导入或表单添加
切换服务商	修改配置文件或环境变量	切换 Provider
配置出错回退	依赖备份或记忆	切回原 Provider
多工具管理	Claude Code、Codex 分开维护	在一个桌面应用里管理

本文重点不是介绍 CC Switch 的全部功能，而是解决一个具体问题：如何快速把第三方 API 导入 CC Switch，并让 Claude Code / Codex 等工具直接使用。

---

2. 下载和安装 CC Switch

CC Switch 官方 GitHub 下载地址：

https://github.com/farion1231/cc-switch/releases/latest

截至 2026-05-24，GitHub Releases 最新正式版本为 v3.15.0，发布日期是 2026-05-16。下载前仍建议打开 Releases 页面确认最新版本。

进入 Releases 页面后，往下找到 Assets 区域，根据系统选择安装包：

系统	推荐文件	说明
Windows	CC-Switch-...-Windows.msi	推荐，正常安装，适合大多数用户
Windows	CC-Switch-...-Windows-Portable.zip	便携版，解压后运行
macOS	CC-Switch-...-macOS.dmg	推荐，拖到 Applications
Linux Debian/Ubuntu	CC-Switch-...-Linux-x86_64.deb	使用 apt install 或 dpkg -i
Linux Fedora/RHEL	CC-Switch-...-Linux-x86_64.rpm	使用 dnf install 或 rpm -i
Linux 其他发行版	.AppImage	添加执行权限后运行

Windows 用户要注意：GitHub Releases 页面默认可能不会把所有安装包完整展开。如果没有看到 Windows 安装包，需要先展开 Assets，或者点击“Show all assets / 展开全部资源”一类入口，Windows 的 .msi 和便携版压缩包才会显示出来。

macOS 用户也可以通过 Homebrew 安装：

brew install --cask cc-switch

更新：

brew upgrade --cask cc-switch

Linux AppImage 用户可以这样运行：

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

安装完成后，建议先打开一次 CC Switch，确认系统可以正常唤起应用。后面从网页导入配置时，浏览器会请求打开 CC Switch，如果系统没有正确关联应用，导入流程可能无法继续。

---

3. 在网站中一键导入第三方 API

下面以 https://codex.tokenshop.pro 为例说明。这个站点是一个面向 Codex / Claude Code 的中转控制台，适合已经有第三方 API 使用需求、又不想手动拼配置文件的用户。它的优势是把密钥、模型信息和 CC Switch 导入入口放在同一套流程里，配置起来比较省步骤。
站点支持gpt和claude，gpt最低0.12元/刀，cluade最低0.2元/刀
如果使用其他服务商，基本也都提供 CC Switch 导入链接，或提供 API Key、Base URL 和模型名，也可以参考类似流程。

3.1 登录控制台并找到密钥入口

打开：

https://codex.tokenshop.pro

登录后进入密钥相关页面，在密钥操作区域选择导入 CC Switch 的入口。

这里的导入入口通常会生成一段 ccswitch:// 形式的 Deep Link。它的作用是把当前站点里的 Provider 配置传给本机 CC Switch，省掉手动复制 Key、Base URL 和模型名的步骤。

3.2 浏览器弹窗选择允许

点击导入后，浏览器会弹出提示，询问是否允许打开 CC Switch。选择允许。

如果没有弹窗，通常有几种可能：

• CC Switch 尚未安装。
• CC Switch 没有被系统正确注册为可打开 ccswitch:// 链接的应用。
• 浏览器拦截了外部应用唤起。
• 当前系统权限限制了外部应用打开。

可以先手动打开 CC Switch，再回到网页重新点击导入。

3.3 在 CC Switch 中确认导入

浏览器允许打开 CC Switch 后，CC Switch 会显示导入确认界面。确认 Provider 名称、模型和目标工具无误后，点击导入即可。

导入完成后，CC Switch 会把这套第三方 API 配置保存成一个 Provider。后续需要使用时，在对应工具面板中切换到这个 Provider 即可。

建议导入后先检查三项信息：

项目	检查重点
Provider 名称	是否能看出服务商和用途
Base URL	是否来自当前控制台
Model	是否是账号可用的模型

如果站点提供了多个模型或多个套餐，建议给 Provider 起一个更清楚的名字，例如：

codex-tokenshop-main
claude-tokenshop-sonnet
codex-tokenshop-test

---

4. 导入后如何在 CC Switch 中使用

导入 Provider 后，可以按下面的流程使用：

1. 打开 CC Switch。
2. 选择要配置的工具，例如 Codex 或 Claude Code。
3. 找到刚才从网页导入的 Provider。
4. 将它切换为当前 Active Provider。
5. 重启对应 CLI、终端或 APP。
6. 在测试项目里发送一条低成本请求验证连接。

测试提示词可以保持简单：

请只回复当前模型名称和一句“连接正常”，不要修改任何文件。

切换后是否需要重启，和具体工具有关：

工具	切换后是否通常要重启
Claude Code	通常支持热切换，异常时建议重启终端
Codex	建议重启 Codex CLI / Codex APP 或至少开启新会话
Gemini CLI	建议重启终端或 CLI
OpenCode / OpenClaw	建议重启对应工具
Claude Desktop	需要重启 Claude Desktop

如果使用 Codex APP，建议切换 Provider 后新建一个线程验证。旧线程可能保留之前的会话状态，排查时容易混淆。

---

5. 手动添加 Provider 的备用方法

如果网页导入失败，也可以在 CC Switch 中手动添加 Provider。只要服务商后台提供下面三项信息，就可以配置：

• API Key
• Base URL
• 模型名

在对应工具面板中选择 Add Provider / 添加供应商，然后填写：

字段	说明
Provider Name	自定义名称，方便识别
API Key	第三方 API 后台复制的 Key
Base URL / Endpoint	第三方 API 后台给出的接口地址
Model	第三方 API 后台给出的模型名
Format / API Type	按服务商说明选择 OpenAI / Anthropic / Gemini 等
Model Mapping	需要角色映射时再启用

示例：

Provider Name: codex-thirdparty-test
Base URL: https://api.example.com/v1
API Key: sk-xxxxxxxx
Model: 第三方 API 后台显示的模型名
API Type: 按服务商文档选择

注意：

• api.example.com 和 sk-xxxxxxxx 只是占位符。
• Base URL 以服务商后台为准，不建议自行补充或删除 /v1。
• 模型名建议直接复制，避免大小写、短横线或版本号错误。
• API Key 不要写入项目仓库、截图或公开文章。

---

6. 建议先保留原配置

第一次使用 CC Switch 时，建议先导入本机原有配置，再导入第三方 API。这样即使第三方 API 配置失败，也可以快速切回原来的 Provider。

可以按这个顺序操作：

1. 打开 CC Switch。
2. 选择需要管理的工具，例如 Codex 或 Claude Code。
3. 如果识别到已有配置，先执行 Import Existing / 导入已有配置。
4. 将原配置命名为 codex-current、claude-official-main 这类容易识别的名称。
5. 保留这个 Provider，不要删除。
6. 再开始导入第三方 API Provider。

推荐命名规则：

工具-服务商-用途

例如：

codex-tokenshop-main
codex-official-main
claude-company-gateway
claude-tokenshop-sonnet

清晰命名可以降低误切 Provider 的概率。

---

7. 常见问题

7.1 点击导入后没有反应

优先检查：

• CC Switch 是否已经安装。
• CC Switch 是否已经打开过一次。
• 浏览器是否拦截外部应用唤起。
• 系统是否允许浏览器打开外部应用。
• 当前导入链接是否完整。

可以先手动打开 CC Switch，再回到网页重新点击导入。

7.2 导入成功，但工具还是走旧服务商

常见原因：

• CC Switch 中没有切换到新 Provider。
• 工具仍在旧终端会话中运行。
• Codex APP 或 Claude Desktop 没有重启。
• 当前工具面板选错，例如切到了 Claude Desktop，但实际使用的是 Claude Code。

推荐处理流程：

1. 在 CC Switch 中重新选择目标 Provider。
2. 关闭当前 CLI / APP。
3. 新开终端或重启 APP。
4. 用测试项目重新验证。

7.3 401 / Unauthorized

一般是认证问题，检查：

• API Key 是否复制完整。
• Key 是否过期、被删除或余额不足。
• Provider 类型是否选择错误。
• 当前账号是否有目标模型权限。

7.4 404 / model not found

一般是接口地址或模型名问题，检查：

• Base URL 是否多了或少了 /v1。
• 模型名是否完全复制服务商后台显示值。
• 当前 Provider 类型是否选错。
• 当前服务商是否支持填写的模型。

7.5 请求长时间无响应

按顺序排查：

1. 服务商后台是否可访问。
2. 当前网络是否能访问 Base URL。
3. 账号余额是否正常。
4. 模型是否可用。
5. 是否启用了 Local Routing。
6. CC Switch 日志中是否有上游错误。

---

8. Local Routing 什么时候需要

如果只是普通第三方 API，能直连就优先直连。Local Routing 更适合下面这些场景：

场景	是否考虑 Local Routing
服务商格式和工具不完全兼容	可以考虑
需要 Anthropic 和 OpenAI 格式互转	可以考虑
需要多个 Provider 自动故障转移	可以考虑
普通 API Key + Base URL 直连可用	暂不启用
暂时不清楚它解决什么问题	暂不启用

开启 Local Routing 后，CC Switch 需要保持运行。关闭 CC Switch 后，走代理模式的工具可能会立刻不可用。

---

9. 使用建议

为了避免配置混乱，建议按下面的方式使用 CC Switch：

• 保留一个原本可用的官方 Provider，作为回退选项。
• 第三方 API Provider 单独命名，名称里写清楚服务商和用途。
• 先在测试项目里验证连接，再用于正式项目。
• 不要把 API Key 写进项目文件、截图或公开文章。
• 不确定 Local Routing、MCP、Skills 等功能用途时，先不要急着启用。

如果同时使用多个 AI 编程工具，可以统一使用类似下面的命名方式：

codex-tokenshop-main
codex-official-main
claude-tokenshop-sonnet
claude-company-gateway

这样后续切换 Provider 时更容易判断当前走的是哪个服务商。

---

10. 参考链接

• CC Switch 官方网站：https://ccswitch.io
• CC Switch GitHub 仓库：https://github.com/farion1231/cc-switch
• CC Switch Releases：https://github.com/farion1231/cc-switch/releases