本文为转载内容,保留原帖观点与结构;如有侵权请联系我处理。
大家好!
继 v4.0.0 CLI 版本发布后,收到了很多朋友的反馈和建议。经过一天(bushi)的超强度开发迭代,v4.1.0 正式发布!这个版本主要聚焦在交互式操作体验的完善和命令行功能的增强,让大家在服务器上管理 Claude/Codex/Gemini 配置更加得心应手。

本次更新亮点

交互式 Provider 管理 – 终于可以在 TUI 里添加和编辑了!
之前很多朋友反馈:“为什么交互模式只能切换 Provider,不能添加和编辑?”
听到了!v4.1.0 完整实现了交互式 Provider 添加和编辑功能:
| 添加 Provider | 编辑 Provider |
|---|---|
新增功能:
-
完整的添加流程:Name、API Key、Base URL、Model 一步步引导填写
-
原地编辑:选中 Provider 后直接编辑,当前值自动预填
再也不用在交互模式和命令行(配置文件)之间来回切换了!

端口测试 – 切换前先检查连通性
你是不是遇到过这种情况:切换到新的 Provider,结果发现 API 端点根本连不上?
v4.1.0 新增端口测试功能,在切换前帮你检查:
cc-switch provider speedtest <id>
或者也可以在交互模式激情测速 ❤️
功能特性:
-
连通性检查:测试 Base URL 和端口是否可达
-
延迟测量:显示 API 端点的响应时间
让配置切换更加可靠和可预测。

Prompts 管理增强 – 更灵活的控制

环境变量冲突检测 – 解决 “为什么切换不生效” 的痛点
很多朋友遇到过:切换了 Provider,但 API Key 还是旧的。原因是系统环境变量覆盖了配置文件。
v4.1.0 新增 env 命令帮你快速定位问题:
# 检查当前 App 的环境变量冲突
cc-switch env check --app claude
# 列出所有相关环境变量
cc-switch env list --app claude
输出示例:
⚠️ 发现 2 个环境变量冲突:
- ANTHROPIC_API_KEY (会覆盖配置文件中的 API Key)
- ANTHROPIC_BASE_URL (会覆盖配置文件中的 Base URL)
建议:手动删除这些环境变量,或在 shell 配置文件中注释掉
从此不再困惑:“为什么我切换了 Provider 还是用的旧 Key?”

i18n 多语言支持优化
v4.1.0 大幅扩展了中英文翻译覆盖率:
-
新增 ~400 行 i18n 字符串:覆盖所有新功能
-
交互模式全面汉化:所有菜单、提示、错误信息都有中文
-
一键切换语言:进入
⚙️ 设置菜单即可切换 -
持久化保存:语言选择自动保存到
~/.cc-switch/settings.json
中英文用户都能获得流畅的使用体验。

代码架构重构 – 为长期维护打基础
v4.1.0 对交互模式进行了模块化重构(~1,254 行代码重组)

快速升级
方法 1:下载预编译二进制(推荐)
# macOS (Universal Binary)
curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-v4.1.0-darwin-universal.tar.gz
tar -xzf cc-switch-cli-v4.1.0-darwin-universal.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/
# Linux x64
curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-v4.1.0-linux-x64-musl.tar.gz
tar -xzf cc-switch-cli-v4.1.0-linux-x64-musl.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/
# Linux ARM64 (树莓派/ARM 服务器)
curl -LO https://github.com/saladday/cc-switch-cli/releases/latest/download/cc-switch-cli-v4.1.0-linux-arm64-musl.tar.gz
tar -xzf cc-switch-cli-v4.1.0-linux-arm64-musl.tar.gz
chmod +x cc-switch
sudo mv cc-switch /usr/local/bin/
方法 2:从源码构建
git clone https://github.com/saladday/cc-switch-cli.git
cd cc-switch-cli/src-tauri
cargo build --release
sudo cp target/release/cc-switch /usr/local/bin/

下一步计划
根据大家的反馈,v4.2.0 计划重点:
-
MCP 交互式添加/编辑:像 Provider 一样在 TUI 中操作
-
Prompts 交互式创建/编辑:不用手动编辑配置文件
-
Skills 功能实现:技能市场、安装/卸载(目前仅占位)

相关链接
-
完整文档:cc-switch-cli/README.md at main · SaladDay/cc-switch-cli · GitHub
-
更新日志:cc-switch-cli/CHANGELOG.md at main · SaladDay/cc-switch-cli · GitHub
-
原项目:https://github.com/farion1231/cc-switch(感谢 @farion1231 的优秀架构)

致谢
核心业务逻辑依然 100% 复用自原版 CC-Switch,感谢原作者 Jason Young 的开源贡献!
如果你觉得这个工具有用,欢迎:
-
分享给朋友:让更多人知道这个工具
-
提供反馈:帮助我们做得更好
让 CLI 也能拥有 GUI 级别的交互体验! 




