本文永久链接 – 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？
cc-switch-cli 的核心理念是：用 Unix 的哲学，解决 AI 时代的配置难题。
相比于手动改配置或使用 GUI 工具，它为你带来了以下不可替代的体验：
- 纯终端原生体验：无需任何桌面环境依赖。无论你是在 tmux 会话中，还是在远程跳板机上，都能流畅使用。
- 丰富的预设模板（Presets）：内置了包括 DeepSeek、智谱 GLM、通义千问(qwen)等国内主流高性价比模型的预设。你只需要提供 API Key，无需手动查找各种模型的环境变量映射名。
- 极度安全与无损：在执行配置切换时，它采用了原子级写入（Atomic Write），并且会自动为你保留历史配置文件的备份。同时，像
DISABLE_TELEMETRY、已授权的permissions列表等非 AI 相关的基础配置（Common Fragment），在切换过程中会得到完美保留。 - 面向扩展的设计：工具底层采用了适配器（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：
cc-switch-cli use my-ds
就这么简单！底层配置文件 ~/.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 精进营」能成为你学习、进步、交流的港湾。让我们在此相聚，享受技术精进的快乐！欢迎你的加入！
商务合作方式：撰稿、出书、培训、在线课程、合伙创业、咨询、广告合作。如有需求，请扫描下方公众号二维码，与我私信联系。
