如何快速上手CC-Switch CLImacOS、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-cliCC-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方式 AHomebrew 一键安装最省心如果你已经在使用 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 检查从项目 Releases 页面下载最新版的install.sh在终端执行bash install.sh脚本默认安装到~/.local/bin并会自动清除 macOS 的 Gatekeeper 隔离属性解决无法验证开发者提示检测~/.local/bin是否在你的 PATH 中若不在会打印应添加到~/.zshrc的导出语句提示你运行cc-switch completions install --activate安装 Shell 自动补全方式 C手动下载离线环境适用下载cc-switch-cli-darwin-universal.tar.gzUniversal Binary同时支持 Apple Silicon 和 Intel解压后为cc-switch添加执行权限chmod x cc-switch移动到 PATH 目录sudo mv cc-switch /usr/local/bin/如提示无法验证开发者执行xattr -cr /usr/local/bin/cc-switch二、Linux 快速安装步骤一键脚本安装macOS 的安装脚本同样适用于 Linuxx64 与 ARM64。脚本的 install.sh 中内置了完整的平台检测逻辑x64 / AMD64自动选用静态 musl 构建cc-switch-cli-linux-x64-musl无需依赖 glibc 版本ARM64适用树莓派或 ARM 服务器特殊需求可设置CC_SWITCH_LINUX_LIBCglibc改用 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 步从项目 Releases 页面下载cc-switch-cli-windows-x64.zip解压后将cc-switch.exe移动到 PATH 目录例如move cc-switch.exe C:\Windows\System32\打开新的终端窗口运行cc-switch --version验证即可⚠️ 平台差异提示CC-Switch 的守护进程托管代理依赖 Unix 域 socket仅在 macOS 和 Linux 上可用。Windows 上如需本地代理可改用前台模式cc-switch proxy serve --takeover claudeproxy 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信息量很足一眼掌握全局顶部 Tabclaude/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 / ARM64Windows下载 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），仅供参考 如何快速上手CC-Switch CLI：macOS、Linux、Windows三种安装方式详解
如何快速上手CC-Switch CLImacOS、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-cliCC-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方式 AHomebrew 一键安装最省心如果你已经在使用 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 检查从项目 Releases 页面下载最新版的install.sh在终端执行bash install.sh脚本默认安装到~/.local/bin并会自动清除 macOS 的 Gatekeeper 隔离属性解决无法验证开发者提示检测~/.local/bin是否在你的 PATH 中若不在会打印应添加到~/.zshrc的导出语句提示你运行cc-switch completions install --activate安装 Shell 自动补全方式 C手动下载离线环境适用下载cc-switch-cli-darwin-universal.tar.gzUniversal Binary同时支持 Apple Silicon 和 Intel解压后为cc-switch添加执行权限chmod x cc-switch移动到 PATH 目录sudo mv cc-switch /usr/local/bin/如提示无法验证开发者执行xattr -cr /usr/local/bin/cc-switch二、Linux 快速安装步骤一键脚本安装macOS 的安装脚本同样适用于 Linuxx64 与 ARM64。脚本的 install.sh 中内置了完整的平台检测逻辑x64 / AMD64自动选用静态 musl 构建cc-switch-cli-linux-x64-musl无需依赖 glibc 版本ARM64适用树莓派或 ARM 服务器特殊需求可设置CC_SWITCH_LINUX_LIBCglibc改用 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 步从项目 Releases 页面下载cc-switch-cli-windows-x64.zip解压后将cc-switch.exe移动到 PATH 目录例如move cc-switch.exe C:\Windows\System32\打开新的终端窗口运行cc-switch --version验证即可⚠️ 平台差异提示CC-Switch 的守护进程托管代理依赖 Unix 域 socket仅在 macOS 和 Linux 上可用。Windows 上如需本地代理可改用前台模式cc-switch proxy serve --takeover claudeproxy 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信息量很足一眼掌握全局顶部 Tabclaude/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 / ARM64Windows下载 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），仅供参考