From e0355d6a7f244fb46312420f5f382455f3c517ae Mon Sep 17 00:00:00 2001 From: zyc123 <2594064239@qq.com> Date: Thu, 14 May 2026 16:41:13 +0800 Subject: [PATCH] 456 --- tools/cc-switch.md | 217 +++++++++++++++++++++++---------------------- 1 file changed, 113 insertions(+), 104 deletions(-) diff --git a/tools/cc-switch.md b/tools/cc-switch.md index 5ba3138..853e4d5 100644 --- a/tools/cc-switch.md +++ b/tools/cc-switch.md @@ -1,162 +1,171 @@ -# CC-Switch 快速配置工具 +# CC-Switch 快速配置工具 -**All-in-One AI CLI 管理器 - 桌面应用程序** +**All-in-One AI CLI 管理器 — 跨平台桌面应用** -## 🔗 相关链接 +## 🔗 相关链接 -资源| 地址 ----|--- -GitHub 发布页| [cc-switch/releases]() -CC-Switch 文档站| [ccswitch.lovable.app]() - -## 🎯 工具介绍 +| 资源 | 地址 | +| --- | --- | +| GitHub 发布页 | [cc-switch/releases](https://github.com/farion1231/cc-switch/releases) | +| CC-Switch 文档站 | [ccswitch.io](https://www.ccswitch.io/zh/docs) | +| oneinai 控制台 | | -CC-Switch 是一款跨平台桌面应用程序，统一管理 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具。通过直观的图形界面，实现配置切换、MCP 服务器管理、系统提示和 Claude Skills 管理。 +## 🎯 工具介绍 -💡 核心功能 +CC-Switch 是一款跨平台桌面应用，统一管理 **Claude Code**、**Codex** 和 **Gemini CLI** 三大 AI 编程工具。通过直观的图形界面，让你在多个供应商配置之间一键切换，并集中管理 MCP 服务器、系统提示和 Claude Skills。 -• 一键切换不同 AI 工具的提供商配置 • API 端点速度测试与质量指示器 • 多预设系统提示管理 • MCP 服务器统一架构管理 • Claude Skills 发现与安装系统 • 配置备份/恢复（自动保留最近10个） • 深度链接协议支持（`ccswitch://`） • 环境变量冲突检测 +> 💡 **核心功能** +> - 一键切换不同 AI 工具的供应商配置 +> - API 端点速度测试与质量指示器 +> - 多预设系统提示管理 +> - MCP 服务器统一架构管理 +> - Claude Skills 发现与安装系统 +> - 配置自动备份与恢复（保留最近 10 个） +> - 深度链接协议支持（`ccswitch://`） +> - 环境变量冲突检测 ![CC-Switch 软件界面](https://minio.oneinai.com/oneinai/images/docs/cc-switch/cc-switch01.png) -## 📦 安装方法 +## 📦 安装方法 -### 🖥️ Windows 平台 +### 🖥️ Windows 平台 -#### 方法一：MSI 安装器（推荐） +**方法一：MSI 安装器（推荐）** - 1. 访问项目发布页： - 2. 下载最新版本的 `.msi` 安装器 - 3. 运行安装器，按照向导完成安装 - 4. 安装完成后从开始菜单启动 CC-Switch +1. 访问 [Releases 页面](https://github.com/farion1231/cc-switch/releases) +2. 下载最新版本的 `.msi` 安装器 +3. 运行安装器，按向导完成安装 +4. 从开始菜单启动 CC-Switch -#### 方法二：便携版（无需安装） +**方法二：便携版（免安装）** - 1. 下载 `.zip` 便携版压缩包 - 2. 解压到任意目录 - 3. 运行 `cc-switch.exe` 即可使用 +1. 下载 `.zip` 便携版压缩包 +2. 解压到任意目录 +3. 双击 `cc-switch.exe` 即可使用 -### 🍏 macOS 平台 +### 🍏 macOS 平台 -#### 推荐方式：Homebrew 安装 +**推荐方式：Homebrew 安装** -bash - - - # 添加 tap 源 - brew tap farion1231/ccswitch - - # 安装 cc-switch - brew install --cask cc-switch +```bash +# 添加 tap 源 +brew tap farion1231/ccswitch -1 -2 -3 -4 -5 +# 安装 cc-switch +brew install --cask cc-switch +``` -#### 手动安装 +**手动安装** - 1. 访问 [Releases 页面]() - 2. 下载 `.dmg` 安装包 - 3. 打开 DMG 文件，将 CC-Switch 拖入应用程序文件夹 - 4. 从启动台或应用程序文件夹启动 +1. 访问 [Releases 页面](https://github.com/farion1231/cc-switch/releases) +2. 下载 `.dmg` 安装包 +3. 打开 DMG，将 CC-Switch 拖入「应用程序」文件夹 +4. 从启动台或「应用程序」启动 -### 🐧 Linux 平台 +### 🐧 Linux 平台 -#### Debian/Ubuntu 系列（推荐） +**Debian / Ubuntu 系列（推荐）** -bash - - - sudo dpkg -i cc-switch_*.deb - sudo apt-get install -f # 修复依赖 +```bash +sudo dpkg -i cc-switch_*.deb +sudo apt-get install -f # 修复依赖 +``` -1 -2 +**AppImage 通用版本** -#### AppImage 通用版本 +```bash +chmod +x cc-switch_*.AppImage +./cc-switch_*.AppImage +``` -bash - - - chmod +x cc-switch_*.AppImage - ./cc-switch_*.AppImage +**Arch Linux（AUR）** -1 -2 +```bash +paru -S cc-switch-bin +# 或使用 yay +yay -S cc-switch-bin +``` -#### Arch Linux（AUR） +## 🚀 快速开始 -bash - - - paru -S cc-switch-bin - # 或使用 yay - yay -S cc-switch-bin +### 第一步：初始化设置 -1 -2 -3 +打开 CC-Switch，进入「设置 → 通用」，将「窗口行为」中的所有开关全部启用，确保自启动、Claude Code 插件集成、托盘最小化等功能正常生效。 -## 🚀 快速开始 +![CC-Switch 初始化设置界面](https://minio.oneinai.com/oneinai/images/docs/cc-switch/cc-switch02.png) -### 第一步：初始化设置 +> 💡 **推荐配置** +> 建议启用以下选项以获得最佳体验： +> - 开机自启 +> - 静默启动 +> - 应用到 Claude Code 插件 +> - 跳过初次安装确认 +> - 关闭时最小化到托盘 -打开 CC-Switch，进入「设置」页面，在「通用」标签下将「窗口行为」中的所有开关全部打开，确保自启动、Claude Code 插件集成、托盘最小化等功能正常生效。 +### 第二步：添加供应商配置 -![CC-Switch 初始化设置界面](https://docs.ikuncode.cc/images/cc-switch-init-settings.png) +**1. 添加 Claude / Gemini 供应商** -💡 推荐配置 +点击右上角的「+」按钮，进入添加面板。 -建议将「窗口行为」中的所有开关全部启用，以获得最佳使用体验：开机自启、静默启动、应用到 Claude Code 插件、跳过初次安装确认、关闭时最小化到托盘。 +![添加 Claude / Gemini 供应商](https://minio.oneinai.com/oneinai/images/docs/cc-switch/cc-switch03.png) -### 第二步：添加提供商配置 +> 💡 **Gemini 用户提示** +> 使用 Gemini CLI 时，请在 oneinai 平台创建 **Gemini 分组**的令牌，而非 Claude 分组。 - 1. 点击右上角的加号按钮来添加提供商(Claude/Gemini) +**2. 添加 Codex 供应商** -![添加新供应商配置界面](https://docs.ikuncode.cc/images/cc-switch-add-provider.png) +切换到 Codex 标签后，同样点击右上角「+」按钮添加。 -💡 Gemini 用户 +![添加 Codex 供应商](https://minio.oneinai.com/oneinai/images/docs/cc-switch/cc-switch04.png) -如果使用的是 Gemini CLI，请在平台创建**对应的** 令牌，而非 Claude 分组。 +**3. 保存配置** - 2. 点击右上角的加号按钮来添加提供商(Codex) +填写完成后点击「保存」即可。 -![添加新供应商配置界面](https://docs.ikuncode.cc/images/cc-switch-add-provider2.png) +> ⚠️ **重要提示** +> 不同 AI 工具（Claude Code / Codex / Gemini CLI）需要使用**不同的令牌组**。请在[监测站](https://status.oneinai.com/)中确认模型状态后，再选择合适的分组创建令牌。 - 3. 点击「保存」完成配置 +### 第三步：切换供应商 -⚠️ 重要提示 +| 操作方式 | 步骤 | +| --- | --- | +| **应用内切换** | 在供应商列表中选择目标配置 → 点击「启用」 | +| **托盘快捷切换** | 右键点击托盘图标 → 选择对应工具的供应商 | -不同的AI工具（Claude Code、Codex、Gemini CLI）需要不同的令牌组配置。 请在[监测站]()中选择合适的分组创建令牌。 +> ℹ️ **生效说明** +> Claude Code 支持热重载，切换后立即生效；Codex 和 Gemini CLI 需要重启工具才能应用新配置。 -### 第三步：切换提供商 +### 第四步：开始使用 - 1. 在提供商列表中选择要使用的配置 - 2. 点击「启用」按钮 - 3. **或** 使用系统托盘图标进行即时切换 +切换完成后，启动对应的 AI 工具即可享受新配置。 -**系统托盘快速切换：** +## 📖 进阶使用 - * 右键点击系统托盘中的 CC-Switch 图标 - * 从菜单中直接选择要切换的提供商 - * 配置立即生效（Claude Code支持热重载，其它的可能需要重新启动） +### 系统托盘菜单 -### 第四步：应用配置 +- 右键点击托盘图标可看到分类列表（Claude / Codex / Gemini） +- 直接点击对应分类下的供应商即可切换 +- 无需打开主界面，提升日常切换效率 -切换配置后，关闭并重新启动对应的 AI 工具即可自动应用新配置。 +### API 速度测试 -## 📖 完整文档 +在供应商详情页可以一键测试 API 端点的连接速度，并以颜色直观展示质量等级，帮你快速选出最优节点。 -更多详细配置和高级功能，请参阅 [CC-Switch 官方完整文档]()。 +### 配置备份与恢复 -## 🔗 项目资源 +CC-Switch 会自动保留最近 10 个配置版本，意外修改后可一键回滚到任意历史版本。 - * **GitHub 仓库** ： - * **问题反馈** ：[GitHub Issues]() - * **最新版本** ：[Releases 页面]() +## 📚 完整文档 -🎉 开始使用！ +更多高级功能与详细说明，请参阅 [CC-Switch 官方文档](https://www.ccswitch.io/zh/docs)。 -现在您可以使用 CC-Switch 轻松管理多个 AI 编程工具的配置了。 享受高效的开发体验！ +## 🔗 项目资源 + +- **GitHub 仓库**： +- **问题反馈**：[GitHub Issues](https://github.com/farion1231/cc-switch/issues) +- **最新版本**：[Releases 页面](https://github.com/farion1231/cc-switch/releases) + +--- + +🎉 **开始使用！** 现在你可以用 CC-Switch 轻松管理多个 AI 编程工具的配置，享受高效的开发体验。