Skip to content

cc-switch.md

Latest commit

 

History

History
49 lines (38 loc) · 2.71 KB

cc-switch.md

File metadata and controls

49 lines (38 loc) · 2.71 KB
Raw

cc-switch 本地备份说明

用途：在多个后台 API / 多个 AI 编码工具之间一键切换。可选 · 进阶项，不影响主流程。 当官网打不开时，照本文也能完成安装。最新信息以官方为准。

一句话

cc-switch 是一个跨平台图形界面桌面 App（Tauri 2 + React + Rust），一站式管理多个 AI 编码工具——Claude Code、Claude Desktop、Codex、Gemini CLI、OpenCode 等。核心能力：一键切换服务商 / API 配置、统一管理 MCP、多套系统提示词预设、Skills 发现与安装、配置备份恢复、API 端点测速、本地代理网关与故障转移、用量看板，以及 ccswitch:// 深链。

什么时候需要它？

  • 只用一个固定 API → 本项目的 config-api 脚本就够了，不必装它。
  • 需要经常在多家 API / 多个工具间来回切 → cc-switch 的图形界面更省心。

安装

推荐用本项目一键脚本：

  • macOS / Linux： 
    bash <(curl -fsSL https://raw.githubusercontent.com/EricArcha/claude-code-oneclick/main/scripts/install-cc-switch.sh)
  • Windows（PowerShell）： 
    irm https://raw.githubusercontent.com/EricArcha/claude-code-oneclick/main/scripts/install-cc-switch.ps1 | iex

手动方式：

  • macOS：brew install --cask cc-switch，或从发布页下载 .dmg。
  • Windows 10+：从发布页下载 .msi 安装，或便携版 ZIP。
  • Arch Linux：paru -S cc-switch-bin。
  • 其他 Linux：发布页有 DEB / RPM / AppImage。

发布页：https://github.com/farion1231/cc-switch/releases

平台支持

Windows 10+、macOS 12+、主流 Linux（Ubuntu 22.04+ / Debian 11+ / Fedora 34+）。

官方链接

提示

安装后从「应用程序 / 启动台」（macOS）或「开始菜单」（Windows）打开，在图形界面里添加并切换你的多套 API 配置即可。

排错：自检显示「cc-switch 未安装」但其实装了？

cc-switch 安装后的程序名带空格、大写——不是 cc-switch：

  • macOS：/Applications/CC Switch.app（官方 Homebrew cask 产物）
  • Windows：%LocalAppData%\Programs\CC Switch（winget/MSI，user 域）

而且它是图形界面 App，可执行文件不会进 PATH，所以 cc-switch 命令查不到属正常。 若自检脚本仍误报「未安装」，多半是脚本用旧的写死名（cc-switch.app）匹配——升级到最新脚本即可（已改为大小写不敏感通配匹配）。这一项是「可选 · 进阶」，误报也不影响主流程。