cc-switch 是什么？和 ccswitch 是一个东西吗？

是同一个工具。cc-switch（GitHub 仓库名 farion1231/cc-switch，部分搜索结果也写成 ccswitch）是给 Claude Code 用的开源可视化供应商切换工具，自动写入 ~/.claude/settings.json，免手动改环境变量或 JSON 文件，支持 macOS / Windows / Linux。

cc-switch 怎么安装到 Claude Code？

三种方式：macOS 用 brew install --cask cc-switch；Windows 从 GitHub Releases 下 .msi 安装；Linux 下 .deb / .rpm 或 AppImage。装完打开 cc-switch GUI 添加供应商即可，不需要在 Claude Code 里另外配置。

cc-switch 怎么切换 GPT、Claude、DeepSeek 模型？

在 cc-switch 里给每个模型加一个供应商（Provider），填好 API Key 和请求地址。切换时回到供应商列表，点目标供应商旁边的「使用」按钮即可。cc-switch 自动改 ~/.claude/settings.json，Claude Code 下次启动用新供应商。

cc-switch 接入 OfoxAI 的请求地址是什么？

https://api.ofox.ai/anthropic，末尾不要加斜杠。API 格式选「Anthropic Messages（原生）」，认证字段保持默认 ANTHROPIC_AUTH_TOKEN。模型配置留空走默认 Claude 模型，或填具体型号锁定。

VSCode 里怎么用 cc-switch？

cc-switch 改的是 ~/.claude/settings.json 全局配置，VSCode 内置终端继承同一份配置，无需另外集成。在 VSCode 终端跑 claude 命令即可，要切换供应商就回 cc-switch GUI 点一下，不用重启 VSCode。

cc-switch 提示「会话已过期」怎么办？

通常是 API Key 失效或被禁用。回到 cc-switch 检查当前供应商的 Key 是否过期，重新生成贴回去即可。如果是 OfoxAI，去 app.ofox.ai 的 API Keys 页生成新 Key 替换。

cc-switch 和手动改 settings.json 有什么区别？

手动改要在 ~/.claude/settings.json 里维护一串 baseURL / auth token / model 字段，多个供应商之间切换得来回剪切粘贴，容易把 JSON 改坏。cc-switch 把这些封进 GUI，所有供应商存在本地，点一下切换，零出错。

May 15, 2026

cc-switchclaude-codeai-codingtool-setup

cc-switch 配置 Claude Code 完全指南：安装、切换 GPT/Claude/DeepSeek、VSCode 集成（2026）

TL;DR — cc-switch（部分搜索写成 ccswitch）是 GitHub 上 farion1231 维护的开源 GUI 工具，专门给 Claude Code 做模型供应商可视化切换：装完软件、填好 Key、点「使用」按钮，就完成了原本要手改 ~/.claude/settings.json 的全部工作。OfoxAI 接入只要把请求地址填 https://api.ofox.ai/anthropic，API 格式选「Anthropic Messages 原生」，3 分钟跑通。

Claude Code 自身只能跑 Anthropic 官方 API，但通过 ANTHROPIC_BASE_URL 改向其他 Anthropic 兼容网关（OfoxAI、DeepSeek 反代、自建代理）已经是国内开发者的标准操作。手动改环境变量或 settings.json 容易出错，要在多个供应商间切换更是噩梦。cc-switch 把这件事变成了点一下按钮的体力活。

什么是 cc-switch

cc-switch（GitHub：farion1231/cc-switch，搜索引擎里也常写成 ccswitch）是一个独立的桌面应用，定位很专一：管理 Claude Code 的供应商配置。

它干的事情其实很朴素——读写 ~/.claude/settings.json。但因为 Claude Code 的配置格式有点繁琐（要嵌套填 baseURL、authToken、model 等字段），手改一旦出错就连不上 API，cc-switch 把这套逻辑封进了 GUI：

每个「供应商」是一组完整的 baseURL + API Key + 模型 + 选项
切换供应商时，cc-switch 把当前选中的写进 settings.json，其他暂存
支持隐藏 AI 署名、Teammates 模式等附加选项
配置存在本地，多个 Key 互不污染

它不是 npm 包，不需要 cc-switch claude code install 这种命令——它是一个独立 GUI 程序，装好就能用。

为什么要用 cc-switch（vs 手改 settings.json）

直接对比一下两种方式：

维度	手改 settings.json	cc-switch
上手成本	需要看清 JSON 结构、字段名、嵌套关系	装好 GUI，照着图填表
切换 Provider	手剪手贴 baseURL / Key / model	点一下「使用」按钮
多 Key 管理	自己开 txt 存，担心写错位置	GUI 列表里全存着
JSON 坏掉风险	漏个逗号 Claude Code 直接不连	GUI 写入，永远合法
Windows / WSL 一致	路径差异要小心	GUI 抹平差异

如果你只用一个供应商，手改也行。如果你日常要在 OfoxAI、DeepSeek 反代、Anthropic 官方账号之间切，cc-switch 几乎是唯一不疯的办法。

cc-switch 安装

macOS

最快的路径是 Homebrew Cask：

brew install --cask cc-switch

或者去 GitHub Releases 下载 .dmg 双击安装。系统要求 macOS 12+。

Windows

去 Releases 页下载 .msi 安装程序，双击下一步即可。系统要求 Windows 10 / 11。

Linux

按发行版选包：

# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb

# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm

# 通用 AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage

Ubuntu 22.04+ / Debian 11+ / Fedora 34+ 测试通过。

cc-switch 配置 Claude Code 接入 OfoxAI

打开 cc-switch，进入供应商管理页，点右上角 + 添加供应商。

填入下列字段（OfoxAI 接 Claude Code 的官方推荐参数）：

配置项	值	说明
❶ 供应商名称	`ofoxai-claude`	自定义，方便识别
❷ 官网链接	`https://ofox.ai`	供应商官网
❸ API Key	你的 OfoxAI API Key	在 app.ofox.ai 生成
❹ 请求地址	`https://api.ofox.ai/anthropic`	末尾不要加斜杠
❺ API 格式	`Anthropic Messages (原生)`	保持默认
❻ 认证字段	`ANTHROPIC_AUTH_TOKEN`	保持默认
❼ 模型配置	留空	走默认 Claude 模型
❽ 选项	勾选「隐藏 AI 署名」「Teammates 模式」	按需
❾ 写入通用配置	✅	写入全局，所有项目生效

点「+ 添加」保存，回到供应商列表，选中 ofoxai-claude 点使用，看到「切换成功」提示就完成了。cc-switch 自动写入 ~/.claude/settings.json，不需要再手动碰任何文件。

启动验证：

cd your-project
claude

首次启动按 Esc 跳过登录。看到顶部状态栏出现 API Usage Billing 字样即接入成功。也可以在 Claude Code 终端里跑 /status 看 Anthropic base URL 是否为 https://api.ofox.ai/anthropic。

cc-switch 怎么切换模型供应商（GPT / Claude / DeepSeek）

加多个供应商，切换就是一键的事。常见的几种组合：

1. 切到 Anthropic 官方账号

名称：anthropic-official
请求地址：https://api.anthropic.com
API 格式：Anthropic Messages (原生)
API Key：sk-ant-xxx

这是最直接的连接，国内访问需要稳定网络。

2. 切到 DeepSeek（走 Anthropic 兼容端点）

DeepSeek 官方提供 Anthropic 兼容接口：

名称：deepseek-claude-mode
请求地址：https://api.deepseek.com/anthropic
API 格式：Anthropic Messages (原生)
API Key：你的 DeepSeek Key
模型配置：deepseek-chat 或 deepseek-coder

cc-switch 切到这个供应商后，Claude Code 命令行就在调用 DeepSeek 了，从用户视角完全无感。

3. 通过 OfoxAI 聚合切 GPT / Claude / Gemini

https://api.ofox.ai/anthropic 是 Anthropic 协议端点，但 OfoxAI 在网关层会把请求路由到不同底层模型。「模型配置」里填具体模型名（如 openai/gpt-5.5、google/gemini-3.1-pro）就能让 Claude Code 跑非 Claude 的模型。

实际操作里最常见的玩法是：默认走 OfoxAI 跑 Claude Sonnet 4.6，遇到长文本任务临时切到 Gemini 3.1 Pro 利用大上下文，跑预算敏感任务换 DeepSeek。这套切换在 cc-switch 里就是点按钮。

VSCode 里用 cc-switch

很多人搜「vscode claude code cc switch」担心要装额外插件——不需要。

cc-switch 改的是 ~/.claude/settings.json 这份全局配置。VSCode 内置终端继承 shell 环境，跑 claude 命令时用的是同一份 settings。所以：

在 VSCode 任意终端窗口运行 claude
想切供应商，切到 cc-switch GUI 点一下「使用」
回到 VSCode 终端，不需要重启 VSCode，新会话自动用新供应商

如果你常用的 Cursor、Windsurf、Zed 等编辑器内置终端，行为完全一样。cc-switch 是后台层的配置管理，不依赖任何具体编辑器。

常见错误排查

「会话已过期」/ Authentication error

最常见的原因是 API Key 失效（被撤销、超过额度、写错）。处理：

回 cc-switch 检查当前供应商显示的 Key 是否完整（部分长 Key 粘贴时被截）
如果是 OfoxAI，去 app.ofox.ai/manage/api-keys 看 Key 状态，过期就生成新 Key 粘回去
重启一次 Claude Code（不用重启 cc-switch）

连接超时

请求地址写错是最常见的：

✅ https://api.ofox.ai/anthropic
❌ https://api.ofox.ai/anthropic/（末尾多了斜杠）
❌ https://api.ofox.ai/v1（这是 OpenAI 协议端点，给 Claude Code 用要 anthropic 后缀）

也可能是本地网络。在 Claude Code 里跑 /status 看实际请求 URL，对照检查。

流式响应卡顿

OfoxAI 内置全球加速，多半是本地网络问题。在终端跑 curl https://api.ofox.ai/anthropic/v1/messages 测延迟，找一下网络瓶颈在哪。

切换后还是用旧供应商

cc-switch 写入 settings.json 是即时的，但 Claude Code 已经启动的会话不会重读配置。关掉当前 claude 进程重新跑一次就行了，不需要重启系统或 cc-switch。

小结

cc-switch 不复杂——它就是个把 Claude Code 配置 GUI 化的小工具，但它解决了一个真实痛点：在不同 Anthropic 兼容供应商之间无痛切换。

接入流程归纳成一句话：装 cc-switch → 加供应商填好请求地址和 Key → 点「使用」。OfoxAI 用 https://api.ofox.ai/anthropic 一个地址覆盖 Claude 全系，再加上 GPT / Gemini / DeepSeek 路由能力，配合 cc-switch 基本是 Claude Code 用户最省心的国内接入方案。

如果你还想了解 Claude Code 本身的配置细节、不用 cc-switch 时怎么手改 settings.json，可以看 Claude Code 接入 OfoxAI 完整配置教程。如果你同时也在用 Codex CLI，想知道两边怎么搭配，Codex CLI 切换模型与接入第三方 API 完全指南把 OpenAI 这一边讲透了。