news 2026/9/1 13:55:01

如何快速上手CC-Switch CLI：macOS、Linux、Windows三种安装方式详解

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
如何快速上手CC-Switch CLI：macOS、Linux、Windows三种安装方式详解

如何快速上手CC-Switch CLI：macOS、Linux、Windows三种安装方式详解

【免费下载链接】cc-switch-cli⭐️ A cross-platform CLI All-in-One assistant tool for Claude Code, Codex & Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/cc/cc-switch-cli

CC-Switch CLI 是一款跨平台的 AI 命令行管理工具，专为 Claude Code、Codex 和 Gemini CLI 等 AI 编程助手设计，支持一键切换供应商、同步配置和追踪用量。本文面向新手，详解 macOS、Linux、Windows 三种安装方式，并附上安装验证与常用命令速查，帮助你 5 分钟内完成 CC-Switch CLI 的完整部署。

CC-Switch CLI 是什么？

简单来说，它是一个所有 AI CLI 的统一控制台：

  • 🔌供应商管理：在多个 API 供应商之间一键切换，无需手动改配置文件
  • 🛠️MCP 服务器管理：跨 Claude、Codex、Gemini 统一管理模型上下文协议服务器
  • 💬提示词管理：维护CLAUDE.md、AGENTS.md、GEMINI.md等系统提示词预设
  • 📊用量概览：按应用和模型展示 30 天的 token / cost 明细
  • ⚙️配置备份：自动轮换备份、导入导出、WebDAV 云端同步

它同时提供两种使用方式：全屏交互式 TUI（推荐新手）和脚本化命令行（适合自动化）。项目采用 Rust 编写、MIT 协议开源，核心源码位于 src-tauri/ 目录。

三种安装方式总览

系统推荐方式耗时
macOSHomebrew 或安装脚本约 1 分钟
Linux官方一键安装脚本约 1 分钟
Windows手动下载 zip 包约 2 分钟

💡 所有方式最终都安装出同一个cc-switch可执行文件，功能完全一致。

一、macOS 安装 CC-Switch

方式 A：Homebrew 一键安装（最省心）

如果你已经在使用 Homebrew，一条命令即可完成安装和后续升级：

brew install cc-switch-cli # 安装 brew upgrade cc-switch-cli # 后续升级

⚠️ 注意：通过 Homebrew 安装后，请避免使用 CC-Switch 内置的cc-switch update自更新功能，以免干扰 Homebrew 的升级机制。

方式 B：官方安装脚本

官方提供了一键安装脚本 install.sh，它会自动检测你的芯片架构（Apple Silicon / Intel 通用二进制），完成下载、安装和 PATH 检查：

  1. 从项目 Releases 页面下载最新版的install.sh
  2. 在终端执行bash install.sh

脚本默认安装到~/.local/bin，并会：

  • 自动清除 macOS 的 Gatekeeper 隔离属性（解决"无法验证开发者"提示）
  • 检测~/.local/bin是否在你的 PATH 中，若不在会打印应添加到~/.zshrc的导出语句
  • 提示你运行cc-switch completions install --activate安装 Shell 自动补全

方式 C：手动下载（离线环境适用）

  1. 下载cc-switch-cli-darwin-universal.tar.gz（Universal Binary，同时支持 Apple Silicon 和 Intel）
  2. 解压后为cc-switch添加执行权限：chmod +x cc-switch
  3. 移动到 PATH 目录：sudo mv cc-switch /usr/local/bin/
  4. 如提示"无法验证开发者"，执行：xattr -cr /usr/local/bin/cc-switch

二、Linux 快速安装步骤

一键脚本安装

macOS 的安装脚本同样适用于 Linux（x64 与 ARM64）。脚本的 install.sh 中内置了完整的平台检测逻辑：

  • x64 / AMD64：自动选用静态 musl 构建（cc-switch-cli-linux-x64-musl），无需依赖 glibc 版本
  • ARM64：适用树莓派或 ARM 服务器
  • 特殊需求可设置CC_SWITCH_LINUX_LIBC=glibc改用 glibc 构建

下载install.sh后执行bash install.sh即可，其余行为与 macOS 一致。

手动安装（x64 为例）

# 下载解压（ARM64 设备请把文件名中的 x64 换成 arm64） tar -xzf cc-switch-cli-linux-x64-musl.tar.gz chmod +x cc-switch sudo mv cc-switch /usr/local/bin/

三、Windows 手动安装 CC-Switch 方法

Windows 暂不支持一键脚本，手动安装只需 3 步：

  1. 从项目 Releases 页面下载cc-switch-cli-windows-x64.zip
  2. 解压后将cc-switch.exe移动到 PATH 目录，例如：
move cc-switch.exe C:\Windows\System32\
  1. 打开新的终端窗口，运行cc-switch --version验证即可

⚠️ 平台差异提示：CC-Switch 的守护进程托管代理依赖 Unix 域 socket，仅在 macOS 和 Linux 上可用。Windows 上如需本地代理，可改用前台模式cc-switch proxy serve --takeover claude；proxy show与proxy config则在所有平台均可用。

四、从源码构建 CC-Switch

如果你是开发者或想尝鲜最新功能，可以从源码构建。前提条件：Rust 1.85+（项目通过 src-tauri/rust-toolchain.toml 锁定工具链版本）：

git clone https://gitcode.com/gh_mirrors/cc/cc-switch-cli cd cc-switch-cli/src-tauri cargo build --release sudo cp target/release/cc-switch /usr/local/bin/ # Windows: copy 到 System32

构建产物位于./target/release/cc-switch。依赖与模块定义见 src-tauri/Cargo.toml。

验证安装并首次运行

第一步：检查版本

cc-switch --version

能正常输出版本号，说明 PATH 配置成功。

第二步：启动交互式 TUI

直接输入命令即可进入全屏界面：

cc-switch

首页（TUI）信息量很足，一眼掌握全局：

  • 顶部 Tab：claude/codex/gemini快速切换目标应用
  • Connection Details：当前供应商、API 地址、MCP 服务器激活状态
  • WebDAV 同步：同步状态与最近同步时间
  • 本地环境检查：Claude、Codex、Gemini、OpenCode 等 CLI 是否已安装及版本
  • 底部状态栏：当前可用的快捷键（?可随时调出帮助）

第三步：切换你的第一个供应商

进入「供应商」菜单，列表展示所有供应商及 API 地址，按方向键选择后按s即可完成切换：

顶部快捷键提示一目了然：Enter查看详情、s切换、a新增、e编辑、d删除、t测速。

新手必会的 5 个常用命令

命令作用
cc-switch provider list列出所有供应商
cc-switch provider switch <id>切换供应商
cc-switch use <id>切换供应商（快捷命令）
cc-switch sessions list --all查看历史会话
cc-switch update更新到最新版本

在供应商管理中，你可以对任意供应商执行编辑、复制、测速等操作，界面如下：

管理多个应用时，使用全局--app参数指定目标：

cc-switch --app codex provider list # 管理 Codex 供应商 cc-switch --app gemini prompts list # 列出 Gemini 提示词

常见问题排查

❓ 提示cc-switch: command not found

安装目录（默认~/.local/bin）不在 PATH 中。在~/.zshrc或~/.bashrc末尾添加：

export PATH="$HOME/.local/bin:$PATH"

然后重启终端。

❓ 切换供应商后配置没生效

多半是环境变量冲突（如系统中已设置ANTHROPIC_API_KEY）。运行cc-switch env check检查冲突，按提示删除对应变量后重启终端。另外请确保目标 CLI（如claude）至少运行过一次，否则 CC-Switch 出于安全考虑会跳过写入实时配置文件。

❓ 配置需要备份或迁移到新机器

TUI 的「配置」菜单内置备份、恢复、导入/导出功能，还支持 WebDAV 云端同步：

更多问题可在 README_ZH.md 的 FAQ 章节查阅，版本演进记录见 docs/CHANGELOG.md。

小结

  • macOS：优先brew install cc-switch-cli，其次官方安装脚本
  • Linux：一键脚本自动适配 x64 / ARM64
  • Windows：下载 zip 并放入 PATH 目录
  • 安装完成后运行cc-switch --version验证，再运行cc-switch进入 TUI 开始管理你的 Claude Code、Codex 与 Gemini CLI 供应商

装好 CC-Switch CLI 后，切换供应商、同步配置、追踪用量全部在一条命令内完成——从此告别手改配置文件。

【免费下载链接】cc-switch-cli⭐️ A cross-platform CLI All-in-One assistant tool for Claude Code, Codex & Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/cc/cc-switch-cli

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/9/1 13:54:32

大模型对比选型：别只看榜单，要跑通评估与工程化适配

GLM-5.3 Flash、Claude Opus 4.6、腾讯 Hy4&#xff0c;这三个名字放在一起时&#xff0c;很多人第一反应是&#xff1a;到底哪个更强&#xff1f;我见过不少团队在模型选型时&#xff0c;直接把几张排行榜截图丢进群里&#xff0c;第二天就拍板换了模型。这种做法的风险&#…

作者头像 李华
网站建设 2026/9/1 13:54:27

淘天数据岗秋招笔试全解析：SQL、统计与业务分析

九月的第三个周六晚上&#xff0c;我提交了淘天集团数据岗的秋招笔试&#xff0c;时长120分钟&#xff0c;题量不算大&#xff0c;但交卷那一刻脑子里嗡嗡的。回看整个准备周期&#xff0c;从一份看似普通的数据岗笔试邀请函&#xff0c;到真正坐在摄像头前答题&#xff0c;这中…

作者头像 李华
网站建设 2026/9/1 13:53:02

PolarDB-X 向量一体化客户案例：3 个企业如何用 PolarDB-X 构建高效 RAG 系统

构建 RAG&#xff08;检索增强生成&#xff09;系统时&#xff0c;向量数据的存储和检索方案选型直接影响系统的性能和运维成本。阿里云瑶池数据库旗下的 PolarDB-X 凭借内置向量引擎和关系型向量一体化存储能力&#xff0c;已成功帮助众多企业落地 RAG 系统。本文通过 3 个真实…

作者头像 李华
网站建设 2026/9/1 13:52:37

新开斗罗魔改服务器怎么判断？从原创玩法到长期留存

很多玩家看到“全新魔改神域斗罗服务器、全新开服、超多原创玩法”这类宣传时&#xff0c;第一反应是兴奋&#xff0c;第二反应是警惕。兴奋是因为新开服往往意味着相对公平的起点、热闹的出生点、密集的活动和大量愿意尝试新环境的玩家&#xff1b;警惕则是因为市面上有太多服…

作者头像 李华
网站建设 2026/9/1 13:50:18

系统“帅不过三秒”现象解析：冷启动、峰值压力与稳定性排查指南

“肺雾正男帅不过三秒”这类表达&#xff0c;在技术人之间早就不是单纯的网络梗。它描述的是一个非常熟悉的场面&#xff1a;某个服务或者某场演示&#xff0c;开场时响应很快、页面正常、数据正确&#xff0c;看起来一切都很优雅&#xff0c;但三秒钟之后&#xff0c;接口开始…

作者头像 李华
网站建设 2026/9/1 13:50:15

导航工程实习全流程解析：GNSS控制网与RTK放样实战

简介&#xff1a;武汉大学测绘学院19级导航工程第三学期专业实习的完整资料包&#xff0c;面向测绘、卫星导航相关专业学生&#xff0c;也适合需要学习卫星导航数据质量分析的开发者。实习内容围绕卫星导航接收机观测数据展开&#xff0c;配套C#语言自编程序可实现数据利用率统…

作者头像 李华