本文永久链接 – https://tonybai.com/2026/07/02/cc-switch-cli-opensource

大家好，我是Tony Bai。

在 AI 辅助编码的浪潮中，Claude Code 凭借其强大的上下文理解和系统级操作能力，迅速成为了许多程序员不可或缺的生产力伙伴。

然而，在使用 Claude Code 的过程中，我们不可避免地会遇到一个非常现实的问题：如何平衡模型性能与使用成本？

在处理高难度架构重构时，我们可能需要最顶级的模型（如 Sonnet 或 Opus）；而在进行简单的代码补全或写单元测试时，如果一直烧顶级模型的 Token，这笔账单往往会让人感到肉疼。因此，根据不同的任务需求，灵活切换不同的大模型 Provider（供应商/提供商）及其对应的 API Token，成为了高阶玩家的必修课。

目前，社区中解决这一痛点的头部工具是 github.com/farion1231/cc-switch。它通过一个优雅的 GUI（图形用户界面），让用户可以方便地管理多个配置文件。

但这对我来说，还不够完美。

作为一名重度“命令行控（CLI-holic）”，我的开发环境几乎完全在云端的远程 Linux 服务器、Docker 容器或是 DevContainers 中。在纯终端（Terminal）的 SSH 连接下，GUI 工具英雄无用武之地。每次想要切换 Claude Code 的背后模型，我都要手动去编辑底层的 JSON 配置文件，极其繁琐且容易出错。

我相信，肯定有许多开发者面临着与我相同的困境。为了彻底解决远程环境下的 Provider 切换痛点，我在 AI 的帮助下，使用 Go 语言开发并开源了一款轻量、原生的命令行工具——cc-switch-cli。

今天，我将向大家正式介绍这款专为命令行和远程开发而生的工具利器，也希望这款工具能够给大家带去帮助！

cc-switch-cli 的核心理念是：用 Unix 的哲学，解决 AI 时代的配置难题。

相比于手动改配置或使用 GUI 工具，它为你带来了以下不可替代的体验：

1. 纯终端原生体验：无需任何桌面环境依赖。无论你是在 tmux 会话中，还是在远程跳板机上，都能流畅使用。
2. 丰富的预设模板（Presets）：内置了包括 DeepSeek、智谱 GLM、通义千问(qwen)等国内主流高性价比模型的预设。你只需要提供 API Key，无需手动查找各种模型的环境变量映射名。
3. 极度安全与无损：在执行配置切换时，它采用了原子级写入（Atomic Write），并且会自动为你保留历史配置文件的备份。同时，像 DISABLE_TELEMETRY、已授权的 permissions 列表等非 AI 相关的基础配置（Common Fragment），在切换过程中会得到完美保留。
4. 面向扩展的设计：工具底层采用了适配器（Adapter）模式，目前第一版默认支持 Claude Code。但其架构天然支持未来扩展到 Codex、OpenCode 或 Google 刚发布的 Antigravity CLI 等其他 AI Coding Agent工具。

极简上手：三步实现模型自由

第一步：安装工具

我为 cc-switch-cli 提供了最顺滑的一键安装脚本。在你的远程服务器终端中，只需执行：

curl -fsSL https://raw.githubusercontent.com/bigwhite/cc-switch-cli/main/install.sh | sh

如果你是一位 Go 开发者，也可以直接使用 go install 快速安装：

go install github.com/bigwhite/cc-switch-cli@latest

第二步：添加你的 AI 供应商

假设我们想配置高性价比的 DeepSeek 作为日常使用的模型。得益于 cc-switch-cli 内置的 Preset（预设）系统，你完全不需要去记繁琐的 base-url 或者是环境变量，只需执行：

# 使用内置的 deepseek 预设，创建一个名为 my-ds 的配置
cc-switch-cli add --preset deepseek --name my-ds --api-key sk-your-key

想要查看当前工具支持哪些预设大模型？跑一下这个命令：

cc-switch-cli preset list

目前已经内置了智谱 (zhipu-glm)、DeepSeek (deepseek)、通义千问 (qwen-dashscope) 等多层级模型的自动映射方案。也欢迎大家提PR贡献其他Provider厂商的内置模板。

第三步：一键切换！

配置添加好后，查看当前的供应商列表：

$cc-switch-cli list
  zhipu-glm             https://open.bigmodel.cn/api/anthropic
  zhipu-glm-5.2         https://open.bigmodel.cn/api/anthropic
  zhipu-glm-4.7         https://open.bigmodel.cn/api/anthropic
  deepseek              https://api.deepseek.com/anthropic
  deepseek-v4-pro       https://api.deepseek.com/anthropic
  deepseek-v4-flash     https://api.deepseek.com/anthropic
  qwen-dashscope        https://dashscope.aliyuncs.com/apps/anthropic
  qwen3.7-max           https://dashscope.aliyuncs.com/apps/anthropic
  qwen3.6-flash         https://dashscope.aliyuncs.com/apps/anthropic

你会看到一个清晰的列表。现在，见证奇迹的时刻，将 Claude Code 的后端引擎无缝切换为我们刚才添加的 DeepSeek：

就这么简单！底层配置文件 ~/.claude/settings.json 已经被安全更新。你现在可以直接运行 claude 命令，它已经开始使用你配置的新大模型 API 工作了。

高阶玩法：它比你想象的更强大

对于极客用户，cc-switch-cli 同样提供了足够的折腾空间。

1. 灵活的底层变量覆盖

如果内置的预设没有涵盖你想要的某个特定模型版本（比如刚出的新模型），你可以使用 --env 标志在添加或编辑时直接覆盖底层映射：

# 修改已有的 my-glm 配置，强制将其 Opus 级别模型映射为最新版
cc-switch-cli edit my-glm --env ANTHROPIC_DEFAULT_OPUS_MODEL=glm-5.3 // 假设未来发布了glm 5.3版本，截至发稿，glm最新版为5.2。

2. 强大的备份与诊断系统

不用担心误操作毁掉你的配置。每次你执行 use 切换时，工具都会在 ~/.cc-switch-cli/backups/ 目录下自动留下一份带时间戳的完整备份。

# 列出所有历史备份
cc-switch-cli backup list

# 一键回滚到指定的安全状态
cc-switch-cli backup restore <timestamp>

如果 Claude Code 的行为变得怪异，只需运行 cc-switch-cli doctor，它会帮你一键体检当前的配置健康状态。

3. 适合脚本自动化的 JSON 输出

如果你想把这个工具集成到自己的 dotfiles、CI/CD 或是 tmux status bar 中，只需加上 --json 标志，所有的命令都会返回极其干净的 JSON 格式数据，方便 jq 等工具进行解析。

小结：开源，让工具更趁手

cc-switch-cli 的诞生，离不开 cc-switch GUI 版本作者（farion1231）带来的灵感启发。作为开源生态的受益者，我用 Go 语言补齐了它在 CLI 和远程协作场景下缺失的一块重要拼图。

开源地址：👉 https://github.com/bigwhite/cc-switch-cli/

无论你是在使用廉价模型处理海量日志分析，还是在关键时刻切回最强模型攻坚核心代码架构，我希望 cc-switch-cli 能让你的远程开发体验变得更加如丝般顺滑。

如果你在使用中遇到任何问题，或者希望添加更多默认的 Provider 预设，非常欢迎在 GitHub 上给我提 Issue 或是 PR。

如果这个小工具真的解决了你的痛点，为你省下了宝贵的开发时间和 API 账单，不妨在 GitHub 上给它点个 ⭐️ Star，或者在项目主页请我喝杯咖啡 ☕️（支持微信/支付宝哦）！ 你的支持是我持续开源的最大动力。

祝大家 AI Coding 愉快！

还在为“复制粘贴喂AI”而烦恼？我的新专栏 《AI原生开发工作流实战》 将带你：

• 告别低效，重塑开发范式
• 驾驭AI Agent(Claude Code)，实现工作流自动化
• 从“AI使用者”进化为规范驱动开发的“工作流指挥家”

扫描下方二维码，开启你的AI原生开发之旅。

原「Gopher部落」已重装升级为「Go & AI 精进营」知识星球，快来加入星球，开启你的技术跃迁之旅吧！

我们致力于打造一个高品质的 Go 语言深度学习 与 AI 应用探索 平台。在这里，你将获得：

• 体系化 Go 核心进阶内容: 深入「Go原理课」、「Go进阶课」、「Go避坑课」等独家深度专栏，夯实你的 Go 内功。
• 前沿 Go+AI 实战赋能: 紧跟时代步伐，学习「Go+AI应用实战」、「Agent开发实战课」、「Agentic软件工程课」、「Claude Code开发工作流实战课」、「OpenClaw实战分享」等，掌握 AI 时代新技能。
• 星主 Tony Bai 亲自答疑: 遇到难题？星主第一时间为你深度解析，扫清学习障碍。
• 高活跃 Gopher 交流圈: 与众多优秀 Gopher 分享心得、讨论技术，碰撞思想火花。
• 独家资源与内容首发: 技术文章、课程更新、精选资源，第一时间触达。

衷心希望「Go & AI 精进营」能成为你学习、进步、交流的港湾。让我们在此相聚，享受技术精进的快乐！欢迎你的加入！

商务合作方式：撰稿、出书、培训、在线课程、合伙创业、咨询、广告合作。如有需求，请扫描下方公众号二维码，与我私信联系。