cc-switch-cli

一条命令切换 Claude Code、Codex、Gemini 的配置与供应商

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 5318

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类编程开发

开发团队SaladDay

所属国家

官网地址

GitHubhttps://github.com/SaladDay/cc-switch-cli

定价模式free

价格说明开源免费，需自行部署

访问状态

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型

GitHub 星标★ 5318

30天Star增速

HF 下载量

上线时间2025-11-23 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-16

浏览次数0

项目介绍

cc-switch-cli 是一个用 Rust 编写的跨平台命令行工具，定位为 Claude Code、Codex 与 Gemini CLI 的一站式助手。它解决的核心问题是：当开发者同时使用多个 AI 编程 CLI 时，需要在不同工具、不同配置、不同 API 供应商之间反复手动切换，配置分散且容易出错。该工具把这些 AI 编程助手的配置集中管理，支持在多个供应商/端点之间快速切换，让用户无需手动编辑配置文件即可切换模型来源与账号。作为 All-in-One 助手，它把常用操作收敛到单一 CLI 入口，减少环境切换成本，适合频繁在 Claude Code、Codex、Gemini CLI 之间来回使用的开发者。Rust 实现带来单一二进制、跨平台、启动快的特点，5318 星标说明其在 AI 编程工具链社区已有一定认可度。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

macOS 或 Linux（一键安装脚本适用于这两个平台）
Windows 用户需按 README 的手动安装方式获取可执行文件
可选：已安装 Homebrew 时可用 brew 安装
默认安装目录为 ~/.local/bin，需保证该目录在 PATH 中

安装与启动步骤

1一键安装(mac/Linux)

用官方脚本把 cc-switch 安装到 ~/.local/bin；安装前可设置 CC_SWITCH_INSTALL_DIR 更换目标目录。
```
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash
```
2Homebrew 安装

已使用 Homebrew 的机器可直接用 brew 安装 cc-switch-cli，后续升级也用 Homebrew。
```
brew install cc-switch-cli
```
3Windows 手动安装

README 说明 Windows 用户使用 Manual Installation 方式，下载后运行可执行文件；具体下载步骤请查阅 README 手动安装章节。
4检查本地 CLI 工具

用 env tools 子命令确认 cc-switch 能识别本机已安装的 AI 编程 CLI。
```
cc-switch env tools
```
5启动 TUI 界面

直接运行 cc-switch 进入全屏交互界面，可切换供应商、管理账号、查看会话与代理状态。
```
cc-switch
```
6列出并切换供应商

先用 provider list 查看已有供应商 id，再用 use 快捷切换；列表未创建供应商时需在 TUI 中先添加。
```
cc-switch provider list
cc-switch use 
```
7查看配置路径

用 config path 确认配置文件实际位置，便于后续备份或手动检查配置。
```
cc-switch config path
```

关键配置

配置项	必填	说明	示例
`CC_SWITCH_INSTALL_DIR`	否	改变安装脚本的目标安装目录	`/your/path/bin`
`CC_SWITCH_FORCE`	否	目标已存在时强制覆盖安装	`1`
`CC_SWITCH_LINUX_LIBC`	否	Linux 下显式选择 glibc 构建	`glibc`
`CC_SWITCH_CONFIG_DIR`	否	指定 CC-Switch 配置根目录，替代 ~/.cc-switch	`/your/path/.cc-switch`

如何确认成功

执行 cc-switch 能进入 TUI 主界面，或 cc-switch env tools / cc-switch config path 正常输出结果，即安装成功。

常见问题

Q：Homebrew 安装后如何升级？

A：使用 brew upgrade cc-switch-cli 升级，不要用内置更新功能，否则会破坏 Homebrew 自身的升级机制。

Q：安装脚本把程序装到哪里？

A：默认安装到 ~/.local/bin，可通过环境变量 CC_SWITCH_INSTALL_DIR 修改目标目录。

Q：目标目录已存在文件怎么办？

A：TTY 下安装脚本会提示确认；非交互式 shell 会拒绝覆盖，除非设置 CC_SWITCH_FORCE=1。

Q：Linux 上需要 glibc 版本怎么办？

A：自动模式默认使用 static musl 构建且不会回退到 glibc，如需 glibc 构建可设置 CC_SWITCH_LINUX_LIBC=glibc。

Q：Windows 怎么安装？

A：README 指引 Windows 用户走 Manual Installation 手动安装流程，而不是使用 mac/Linux 的一键脚本。

注意事项

默认配置根目录为 ~/.cc-switch，内含数据库、settings.json、skills、backups 等。
设置 CC_SWITCH_CONFIG_DIR 后，原 ~/.cc-switch 下的旧数据不会自动迁移。
该工具会读写各 AI CLI 的实际配置文件（如 ~/.claude、~/.codex、~/.gemini 等），操作前建议先备份。
WebDAV 同步功能与上游 CC-Switch 项目完全兼容。

核心亮点

用 Rust 写成，单二进制跨平台，无需 Node/Python 运行时，启动和切换速度快
把 Claude Code、Codex、Gemini CLI 三个工具的配置集中管理，减少手动改配置文件
面向多供应商切换场景，适合需要频繁更换 API 端点或账号的开发者

不足之处

依赖 Claude Code、Codex、Gemini CLI 等外部工具，上游接口或配置格式变动可能影响可用性
功能集中在配置切换，深度定制与自动化能力有限，文档/社区待观察

适用场景

同时使用 Claude Code 和 Codex，需要按任务快速切换不同 AI 编程助手
在多个 API 供应商或账号之间切换，避免手动编辑各工具的配置文件
团队统一管理 AI 编程 CLI 的配置，降低成员环境搭建成本

替代项目

aider、open-interpreter

上一篇：tmux-assistant-resurrect

下一篇：Waza