SaladDay/cc-switch-cli
开发工具跨平台命令行与终端界面工具,统一管理七款 AI 编程助手的供应商、MCP、提示词、技能和会话。
项目介绍
CC-Switch CLI 用 Rust 编写,把 Claude Code、Codex、Gemini、OpenCode、Hermes、OpenClaw 和 Pi 七款 AI 编程助手的配置集中到一个命令行工具和全屏终端界面里。你可以登记多个 API 供应商并一键切换、同步 MCP 服务器、管理系统提示词预设和社区技能、浏览已保存的会话、统计 token 与费用,而不必逐个手改各工具的设置文件。它是 CC-Switch 图形版项目的 CLI 分支,WebDAV 同步与上游保持兼容。
内置的本地代理可以接管 Claude Code、Codex 和 Gemini 的请求,适配 OpenAI Responses / Chat Completions 供应商,也能让 Codex 使用兼容 Anthropic Messages 的端点。对同时在多个终端里使用不同账号或中转服务的开发者比较实用。
快速使用
macOS 或 Linux 上执行发布页提供的安装脚本,默认安装到 ~/.local/bin:
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash
macOS 也可以用 brew install cc-switch-cli。Windows 用户从 Releases 下载 x64 压缩包,解压后把 cc-switch.exe 放入 PATH。
不带参数运行即进入 TUI:
cc-switch
在界面中添加供应商、设为当前并确认生效。脚本方式的核心命令:
cc-switch provider list # 列出供应商
cc-switch provider switch <id> # 切换全局供应商
cc-switch use <id> # 切换的快捷写法
cc-switch --app codex provider list # 操作其他应用
如果切换后配置没有生效,先确认目标 CLI 已初始化过(配置目录存在),再用 cc-switch env check --app claude 检查环境变量冲突。
使用约束
托管代理守护进程依赖 Unix domain socket 监管器,仅在 macOS 和 Linux 可用;Windows 上 proxy enable、proxy disable 和 daemon 子命令不可用,只能用前台模式 cc-switch proxy serve --takeover claude,而 proxy show 和 proxy config 在所有平台可用。从源码构建需要 Rust 1.85+,并在 src-tauri 目录下编译。
默认状态保存在 ~/.cc-switch/cc-switch.db(SQLite),技能源文件在 ~/.cc-switch/skills/,备份自动轮换保留 10 份。设置 CC_SWITCH_CONFIG_DIR 可以更换配置根目录,但已有数据不会自动迁移。实时同步会跳过尚未初始化的应用;ANTHROPIC_API_KEY 等环境变量会覆盖工具写入的配置。共享 Codex 会话仅支持 macOS/Linux,且依赖固定的启动目录。自动补全只覆盖 bash 和 zsh。项目采用 MIT 许可证。
HotRepo 点评
2026-11-18 该项目位列 Rust 日榜第 2,当天新增 18 颗星,在同周期的 Rust 项目里属于曝光度较高的一类。作为一个分支项目,它覆盖供应商切换、MCP 同步、提示词、技能、会话和代理,功能面相当宽,这也带来使用前提:代理路径分平台,多数功能要求目标 CLI 先初始化。README 的赞助商部分列出了多家付费 API 中转服务,这不改变工具本身的定位,但这些属于第三方服务,使用时应按各自条款对待。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- yynxxxxx/Codex-X面向 Codex 桌面端/CLI 用户的可视化配置管理工具,统一管理提示词、供应商、会话、Skills 与 MCP。
- chenhg5/cc-connect把本地 AI 编程代理接到聊天平台,让你在任意设备上指挥代理干活。
- farion1231/cc-switch用桌面应用为多种 AI 编程 CLI 一键切换 API 供应商,并集中管理 MCP、技能、提示词与会话。
- zhukunpenglinyutong/jetbrains-cc-gui一个 JetBrains IDE 插件,为 Claude Code、Codex 等 AI 编程 CLI 提供可视化聊天界面。
- google-gemini/gemini-api-cli让已有编码 Agent 或脚本通过命令行调用 Gemini 模型、生成媒体、分析文件并运行托管 Agent 的 Go CLI。