CC Switch 使用教程#

下载与安装#

步骤 1：下载软件#

说明

前往 Github Release 页面下载最新的安装包：https://github.com/farion1231/cc-switch/releases Windows 用户推荐下载 .msi 格式的安装包，以支持自动更新功能。

步骤 2：安装软件#

说明

运行下载的安装包进行安装。如果 Windows 弹出“Windows 已保护你的电脑”的 SmartScreen 拦截提示，请点击左侧的“更多信息”，然后点击右下角的“仍要运行”即可正常安装。

通用配置步骤#

步骤 1：进入设置面板#

说明

首次打开软件后，点击左上角的“齿轮”图标，进入 CC Switch 的全局设置页面。

步骤 2：开启插件接管#

说明

在设置页面的“通用”选项卡中，找到并开启“应用到 XXX 插件”（例如应用到 Claude Code 插件）开关，这样当你在 CC Switch 切换供应商时，对应的终端工具配置才会生效。你可以顺便开启“开机自启”。

步骤 3：添加供应商#

INFO

回到软件主界面，点击右上角的 “+” 加号图标，新建一个 API 供应商配置。

步骤 4：填写 API 信息#

INFO

如果你只打算在某个单独的应用中使用（比如只用在 Claude Code），那么直接在弹出的供应商编辑窗口中填写。

供应商名称： GrapeX （可自定义）

官网链接： https://api.pioktofont.icu （选填）

API Key： 填入你在控制台获取的令牌

API 请求地址： https://api.pioktofont.icu/v1 （注意：因为图中使用的是兼容 OpenAI 格式，所以填带 /v1 的地址）

模型名称： 例如 claude-opus-4-5-20251101

claude-2
claude-2.0
claude-2.1
claude-3-haiku-20240307
claude-3-5-haiku-20241022
claude-haiku-4-5-20251001
claude-3-sonnet-20240229
claude-3-5-sonnet-20240620
claude-3-5-sonnet-20241022
claude-3-7-sonnet-20250219
claude-sonnet-4-20250514
claude-sonnet-4-5-20250929
claude-sonnet-4-20250514-thinking
claude-3-7-sonnet-20250219-thinking
claude-sonnet-4-5-20250929-thinking
claude-sonnet-4-6
claude-opus-4-20250514
claude-opus-4-1-20250805
claude-opus-4-5-20251101
claude-opus-4-6
claude-opus-4-20250514-thinking
claude-opus-4-1-20250805-thinking
claude-opus-4-5-20251101-thinking

步骤 5：使用统一供应商 (推荐)#

INFO

由于 CC Switch v3.9.0 引入了 统一供应商（Universal Provider） 功能，如果你想一次配置就能在 Claude Code、Codex 和 Gemini CLI 之间无缝切换共享，强烈建议添加“统一供应商”。

INFO

5.

往下滚动，你可以勾选你想把这个配置同步应用到哪些 CLI 工具（Claude Code、Codex、Gemini CLI 等）。

INFO

6.

最后在底部为不同的工具指定默认的模型。比如为 Gemini 映射 gemini-3-pro-preview 模型。全部填完后点击右下角的 “添加” 即可！

注意事项#