news 2026/9/11 20:00:39

工具篇-CC Switch 使用教程：一套界面管好所有 AI 编程 CLI 的供应商配置

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
工具篇-CC Switch 使用教程：一套界面管好所有 AI 编程 CLI 的供应商配置

适用读者：正在使用（或打算使用）Claude Code、Codex、Gemini CLI 等 AI 编程工具，并且需要在多个模型服务商 / API 之间切换的开发者。

阅读完你将学会：安装 CC Switch、清理环境变量冲突、把 {AI大模型} 一键接入 Claude Code、在多个供应商之间秒级切换，以及 MCP / Skills / 用量统计等进阶玩法。

一、CC Switch 是什么

在日常使用 AI 编程工具时，你大概率遇到过这些痛点：

  • 切换供应商麻烦：想从官方 API 切到第三方服务商，必须手动改配置文件，改完还要重启；
  • 配置格式混乱：Claude Code 用 JSON、Codex 用 TOML，各工具各一套，改错一个字符就罢工；
  • 用量是笔糊涂账：不知道今天调了多少次、花了多少钱；
  • 单点故障：唯一的供应商挂了，整个工作流就得中断。

CC Switch 是一款开源（MIT 协议）的跨平台桌面应用，专门解决上面这些问题。它基于 Tauri 2 + Rust + React 构建，轻量、原生、数据全部存储在本地。

核心功能

功能模块说明
供应商管理50+ 内置预设（主流大模型服务商、云厂商、社区中转），一键切换、托盘快捷切换、拖拽排序、导入导出
统一供应商一份配置同时同步到 Claude Code、Codex、Gemini CLI 等多个工具
本地代理与故障转移热切换、格式转换、自动故障转移、熔断器、健康监控
MCP 管理统一面板管理 MCP 服务器，跨多个工具双向同步
Prompts 管理Markdown 编辑器维护系统提示词，跨应用同步
Skills 管理从 GitHub 仓库或 ZIP 一键安装技能扩展
用量统计花费 / 请求数 / Token 追踪、趋势图表、请求日志、自定义模型单价
会话管理跨源浏览、搜索、恢复对话历史

支持的 AI 编程工具

工具说明
Claude Code终端 AI 编程 Agent（本教程的主角）
Claude DesktopClaude 桌面应用
CodexOpenAI 的代码生成 CLI
Gemini CLIGoogle 的 AI 命令行工具
OpenCode开源 AI 编程终端工具
OpenClaw开源 AI 助手（多供应商网关）
Grok Build / Hermes Agent其他受支持的 AI 编程工具

支持的平台

  • Windows10 及以上（x64）
  • macOS12 (Monterey) 及以上（Intel / Apple Silicon，已通过 Apple 公证）
  • Linux：Ubuntu 22.04+ / Debian 11+ / Fedora 34+ / Arch（x64 / ARM64）

官方渠道

资源链接
官方网站https://ccswitch.io
GitHub 仓库https://github.com/farion1231/cc-switch
版本下载https://github.com/farion1231/cc-switch/releases
用户手册https://github.com/farion1231/cc-switch/blob/main/docs/user-manual/zh/README.md
问题反馈https://github.com/farion1231/cc-switch/issues

⚠️安全提醒：请只从官网或 GitHub Releases 获取 CC Switch。任何要求付费、充值或索取登录凭据的"CC Switch"网站或客户端都不是官方渠道。

二、安装 CC Switch

macOS（推荐 Homebrew）

# 安装brewinstall--caskcc-switch# 后续升级brew upgrade--caskcc-switch

也可以从 Releases 下载.dmg（推荐）或.zip手动安装。macOS 版本已通过 Apple 代码签名和公证，可直接打开，无需额外操作。

Windows

  1. 前往 Releases 页面 下载CC-Switch-v{版本号}-Windows.msi；
  2. 双击运行，按提示完成安装。
    • 若双击无反应：右键安装包 →「属性」→「常规」→ 勾选「解除锁定」后再运行；
  3. 也可以下载便携版CC-Switch-v{版本号}-Windows-Portable.zip，解压后直接运行CC-Switch.exe。

Linux

# ArchLinux（AUR）paru-Scc-switch-bin# Debian / Ubuntu（下载 .deb 后）sudodpkg-iCC-Switch-v{版本号}-Linux-x86_64.deb# Fedora / RHEL（下载 .rpm 后）sudorpm-iCC-Switch-v{版本号}-Linux-x86_64.rpm# 通用 AppImagechmod+x CC-Switch-v{版本号}-Linux-x86_64.AppImage ./CC-Switch-v{版本号}-Linux-x86_64.AppImage

前置要求

CC Switch 管理的 CLI 工具需要 Node.js 18+ 环境。以 Claude Code 为例：

# Homebrew（macOS 推荐）brewinstallclaude-code# 或 npm 安装npminstall-g@anthropic-ai/claude-code# 国内网络较慢时使用镜像源npminstall-g@anthropic-ai/claude-code--registry=https://registry.npmmirror.com

验证安装

启动 CC Switch 后：应用窗口正常显示、系统托盘出现 CC Switch 图标，即安装成功。CC Switch 内置自动更新，也可以在「设置 → 关于」中手动检查。

三、开始前的准备：清理环境变量冲突

这一步非常关键，也是最容易踩的坑。

环境变量的优先级高于一切配置文件。如果你的 shell 配置文件（~/.zshrc、~/.bashrc等）里曾经导出过下面这类变量：

exportANTHROPIC_BASE_URL=...# Claude API 端点exportANTHROPIC_AUTH_TOKEN=...# API 密钥exportANTHROPIC_API_KEY=...

那么无论 CC Switch 里怎么切换供应商，Claude Code 都会优先读取环境变量，导致"配置了却不生效"。

处理方式（二选一）：

  1. 手动清理：编辑~/.zshrc/~/.bashrc，删除或注释掉相关的export语句，然后执行source ~/.zshrc重新加载；
  2. 让 CC Switch 帮你清理：CC Switch 会自动检测冲突，界面顶部出现黄色警告横幅时，点击「展开」→ 勾选冲突变量 →「删除选中」。删除前会自动备份到~/.cc-switch/env-backups/，可以放心操作。

四、实战：用 CC Switch 把 {AI大模型} 接入 Claude Code

下面以最典型的场景为例：让 Claude Code 使用兼容 Anthropic 协议的 {AI大模型} 服务。整个过程 5 步，2 分钟完成。

第 0 步：获取 API Key

登录你所使用的 {AI大模型} 服务商开放平台，在「用量 / 付费 / Token 计划」页面购买或领取额度，并创建 API Key，复制备用。

第 1 步：添加供应商配置

启动 CC Switch，点击主界面右上角的「+」按钮，在「预设」下拉框中选择你的大模型服务商（内置 50+ 预设，会自动填好端点地址），然后粘贴你的API Key。

💡 如果预设列表里没有你的服务商，选择「自定义」，手动填写名称、端点地址和密钥即可。

官方仓库中的添加供应商界面（英文 UI）供对照：

第 2 步：配置模型名称

在配置表单中，将所有模型名称统一改为{AI大模型}，然后点击右下角**「添加」**。

💡 部分服务商支持在模型名后加[1m]后缀（如{AI大模型}[1m]）以启用 1M 超长上下文，是否支持以服务商文档为准。

💡 可选优化：如果想让自动压缩阈值与 1M 上下文对齐，可以在~/.claude/settings.json的env中加入"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "1000000"。

第 3 步：启用配置

回到 CC Switch 首页，找到刚添加的供应商卡片，点击**「启用」**。

也可以右键系统托盘图标，直接点击供应商名称完成切换——这是日常使用中最快的方式。

第 4 步：跳过首次登录引导（新装 Claude Code 必看）

Claude Code 首次启动会进入官方登录引导。使用第三方供应商时可以跳过它，两种方式任选：

  • 方式 A（推荐）：CC Switch「设置 → 通用」→ 开启「跳过 Claude Code 初次安装确认」开关；
  • 方式 B（手动）：编辑~/.claude.json（Windows 在用户目录下），确保包含：
{"hasCompletedOnboarding":true}

第 5 步：启动并验证

进入你的工作目录，启动 Claude Code，选择信任此文件夹：

claude

在会话中依次执行两条命令验证：

命令预期结果
/statusBase URL 显示为服务商提供的 Anthropic 兼容端点（而非官方地址）
/model显示{AI大模型}

也可以直接问一句"你好，请简单介绍一下自己"，能正常回复即配置成功。

💡扩展思考：{AI大模型} 默认开启 Extended Thinking 深度思考模式，可通过/config调整，或用快捷键Option+T（macOS）/Alt+T（Windows/Linux）快速开关。

附：等价的手动配置（对照参考）

不使用 CC Switch 时，上述效果等价于手动编辑~/.claude/settings.json：

{"env":{"ANTHROPIC_BASE_URL":"https://<服务商 API 端点>/anthropic","ANTHROPIC_AUTH_TOKEN":"<你的 API Key>","ANTHROPIC_MODEL":"{AI大模型}","ANTHROPIC_DEFAULT_SONNET_MODEL":"{AI大模型}","ANTHROPIC_DEFAULT_OPUS_MODEL":"{AI大模型}","ANTHROPIC_DEFAULT_HAIKU_MODEL":"{AI大模型}"}}

对比一下就知道 CC Switch 的价值：这些配置它替你写了，而且切换供应商时还能一键换掉。

五、日常使用：切换、排序与生效方式

两种切换方式

  1. 主界面切换：点击供应商卡片上的「启用」按钮；
  2. 托盘切换：右键系统托盘图标，直接点击供应商名称，全程不用打开主窗口。

各工具的生效方式

切换供应商后，各 CLI 工具的生效方式不同：

应用生效方式
Claude Code✅ 即时生效（支持热重载，无需重启）
Gemini CLI✅ 即时生效（每次请求重新读取配置）
Codex需要关闭并重新打开终端
OpenCode / OpenClaw需要关闭并重新打开终端

其他常用操作

  • 拖拽排序：按使用频率把常用供应商拖到列表顶部；
  • 复制供应商：基于现有配置快速派生一份新配置（比如换一个 Key）；
  • 导入 / 导出：在多台机器之间同步供应商配置；
  • 恢复官方登录：添加「官方登录」预设并启用，重启 CLI 后走官方 OAuth 流程即可。

⚠️ 当前处于启用状态的供应商不可删除——这是 CC Switch 的"最小侵入"设计：所有写入都是可回滚的，即使卸载 CC Switch，CLI 工具依然按最后写入的配置正常工作。

六、进阶功能速览

  • 统一供应商（Universal Providers）：一份配置同时应用到 Claude Code、Codex、Gemini CLI，改一处全局生效；
  • MCP 管理：统一面板管理 MCP 服务器，可按应用开关同步，支持 Deep Link 一键导入；
  • Prompts：Markdown 编辑器维护提示词预设，一键同步到CLAUDE.md/AGENTS.md/GEMINI.md；
  • Skills：从 GitHub 仓库或 ZIP 包一键安装技能，支持 symlink 与文件复制两种方式；
  • 本地代理与故障转移：开启代理服务后支持自动故障转移、熔断器与健康监控，主供应商挂掉时自动切到备用，工作不中断；
  • 用量统计：按天 / 按模型查看花费、请求数、Token 趋势图表，支持自定义模型单价；
  • 云同步：配置可通过 Dropbox / OneDrive / iCloud / WebDAV 在多设备间同步。

数据都存在哪？

CC Switch 的所有数据集中在~/.cc-switch/目录：

~/.cc-switch/ ├── cc-switch.db # SQLite 数据库（供应商、MCP、Prompts 等） ├── settings.json # 设备级设置 ├── backups/ # 配置自动备份（保留 10 份） ├── skills/ # 已安装的技能 └── skill-backups/ # 技能备份（保留 20 份）

七、常见问题（FAQ）

Q1：切换供应商后不生效？
按顺序检查：① 是否有第三章提到的环境变量冲突；② 该工具是否需要重启终端（见第五章生效方式表）；③ 用/status确认当前实际加载的 Base URL。

Q2：预设列表里找不到我的服务商？
选择「自定义」手动填写端点和密钥。只要服务商兼容 Anthropic 协议就能用。

Q3：界面顶部出现黄色"环境变量冲突"警告？
说明系统环境变量会覆盖 CC Switch 的配置，点击横幅「展开」→ 勾选冲突变量 →「删除选中」（会先自动备份到~/.cc-switch/env-backups/）。

Q4：想回到官方订阅登录怎么办？
添加「官方登录」预设并启用，重启 CLI 后按官方 OAuth 流程重新登录即可。

Q5：卸载 CC Switch 会影响我的 CLI 工具吗？
不会。CC Switch 采用最小侵入设计，卸载后 Claude Code 等工具会继续使用最后写入的配置正常运行。

Q6：Linux 下 AppImage 黑屏或点击无效？
Wayland + NVIDIA 环境的已知问题，用环境变量切回原生 Wayland 启动：CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch.AppImage。

八、参考资料

  • CC Switch GitHub 仓库（含多语言用户手册：docs/user-manual/）
  • CC Switch 官方网站 与 官方文档
  • CC Switch Releases 下载页
  • 模型服务商平台文档《在 Claude Code 中使用大模型》之"使用 CC Switch"章节（本教程第四章实操流程的主要来源）
  • 本教程截图来自上述官方文档与仓库，仅作学习用途
版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/9/11 20:00:36

SQLite3 学习笔记：数据库基础、SQL 语句与 C 语言 API 详解

数据库 1 . 数据库文件与普通文件区别: 1&#xff09;普通文件对数据管理(增删改查)效率低 2&#xff09;数据库对数据管理效率高,使用方便 2. 常用数据库: 1.关系型数据库&#xff1a; 将复杂的数据结构简化为二维表格形式 大型:Oracle、DB2 中型:MySql、SQLServer 小型:Sqlit…

作者头像 李华
网站建设 2026/9/11 19:58:35

招聘数据可视化：Python爬虫与MapReduce全链路实践

简介&#xff1a;基于Python爬虫与MapReduce分析的招聘信息大数据可视化系统&#xff0c;是一份高分毕业设计整套资料&#xff0c;面向软件工程、计算机科学、人工智能等专业的学生&#xff0c;解决招聘信息采集、分布式分析及可视化展示的综合问题。资源内含完整系统源码、部署…

作者头像 李华
网站建设 2026/9/11 19:58:33

PCA异常检测完全指南：重构误差原理、代码实现与应用

简介&#xff1a;基于Python与PCA的异常检测算法设计实现资源&#xff0c;面向机器学习初学者和数据分析从业者&#xff0c;帮助理解利用主成分分析识别数据中异常模式的方法。内容覆盖PCA标准化、协方差矩阵、特征值分解、主成分选择与数据重构等核心步骤&#xff0c;并结合异…

作者头像 李华
网站建设 2026/9/11 19:57:38

降重改写到崩溃？2026年论文降重方法避坑指南

写论文最折磨人的阶段&#xff0c;往往不是写初稿&#xff0c;而是降重。对着标红的段落反复删改&#xff0c;改完一查还是飘红&#xff0c;这种挫败感经历过的人都知道。其实多数人降重效率低&#xff0c;不是不够努力&#xff0c;而是方法本身就有问题。 aicheck官网直达入口…

作者头像 李华
网站建设 2026/9/11 19:57:24

降重会不会影响质量？aicheck实测说真话

aicheck官网直达入口&#xff1a;https://aicheck.cc/ 论文查重率超标&#xff0c;是每个毕业生都绕不过去的坎。改到凌晨三点&#xff0c;把"然而"换成"但是"&#xff0c;把"因此"换成"所以"&#xff0c;重复率纹丝不动&#xff0c;…

作者头像 李华