zyc123/Aiapi-doc
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

456

Browse Source
This commit is contained in:
zyc123 2026-05-14 16:41:13 +08:00
parent dcc8600664
commit e0355d6a7f
1 changed files with 113 additions and 104 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

203
tools/cc-switch.md
View File

@ -1,21 +1,28 @@
# CC-Switch 快速配置工具
**All-in-One AI CLI 管理器 - 桌面应用程序**
**All-in-One AI CLI 管理器 — 跨平台桌面应用**
## 🔗 相关链接
资源| 地址
---|---
GitHub 发布页| [cc-switch/releases](<https://github.com/farion1231/cc-switch/releases>)
CC-Switch 文档站| [ccswitch.lovable.app](<https://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 控制台 | <https://api.oneinai.com/console/token> |
## 🎯 工具介绍
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)
@ -23,140 +30,142 @@ CC-Switch 是一款跨平台桌面应用程序，统一管理 Claude Code、Code
### 🖥️ Windows 平台
#### 方法一：MSI 安装器（推荐）
**方法一：MSI 安装器（推荐）**
1. 访问项目发布页：<https://github.com/farion1231/cc-switch/releases>
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 平台
#### 推荐方式：Homebrew 安装
**推荐方式：Homebrew 安装**
bash
```bash
# 添加 tap 源
brew tap farion1231/ccswitch
# 安装 cc-switch
brew install --cask cc-switch
```
# 添加 tap 源
brew tap farion1231/ccswitch
**手动安装**
# 安装 cc-switch
brew install --cask cc-switch
1
2
3
4
5
#### 手动安装
1. 访问 [Releases 页面](<https://github.com/farion1231/cc-switch/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 平台
#### Debian/Ubuntu 系列（推荐）
**Debian / Ubuntu 系列（推荐）**
bash
```bash
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f # 修复依赖
```
**AppImage 通用版本**
sudo dpkg -i cc-switch_*.deb
sudo apt-get install -f # 修复依赖
```bash
chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImage
```
1
2
**Arch Linux（AUR）**
#### AppImage 通用版本
bash
chmod +x cc-switch_*.AppImage
./cc-switch_*.AppImage
1
2
#### Arch Linux（AUR）
bash
paru -S cc-switch-bin
# 或使用 yay
yay -S cc-switch-bin
1
2
3
```bash
paru -S cc-switch-bin
# 或使用 yay
yay -S cc-switch-bin
```
## 🚀 快速开始
### 第一步：初始化设置
打开 CC-Switch，进入「设置」页面，在「通用」标签下将「窗口行为」中的所有开关全部打开，确保自启动、Claude Code 插件集成、托盘最小化等功能正常生效。
打开 CC-Switch，进入「设置 → 通用」，将「窗口行为」中的所有开关全部启用，确保自启动、Claude Code 插件集成、托盘最小化等功能正常生效。
![CC-Switch 初始化设置界面](https://docs.ikuncode.cc/images/cc-switch-init-settings.png)
![CC-Switch 初始化设置界面](https://minio.oneinai.com/oneinai/images/docs/cc-switch/cc-switch02.png)
💡 推荐配置
> 💡 **推荐配置**
> 建议启用以下选项以获得最佳体验：
> - 开机自启
> - 静默启动
> - 应用到 Claude Code 插件
> - 跳过初次安装确认
> - 关闭时最小化到托盘
建议将「窗口行为」中的所有开关全部启用，以获得最佳使用体验：开机自启、静默启动、应用到 Claude Code 插件、跳过初次安装确认、关闭时最小化到托盘。
### 第二步：添加供应商配置
### 第二步：添加提供商配置
**1. 添加 Claude / Gemini 供应商**
1. 点击右上角的加号按钮来添加提供商(Claude/Gemini)
点击右上角的「+」按钮，进入添加面板。
![添加新供应商配置界面](https://docs.ikuncode.cc/images/cc-switch-add-provider.png)
![添加 Claude / Gemini 供应商](https://minio.oneinai.com/oneinai/images/docs/cc-switch/cc-switch03.png)
💡 Gemini 用户
> 💡 **Gemini 用户提示**
> 使用 Gemini CLI 时，请在 oneinai 平台创建 **Gemini 分组**的令牌，而非 Claude 分组。
如果使用的是 Gemini CLI，请在平台创建**对应的** 令牌，而非 Claude 分组。
**2. 添加 Codex 供应商**
2. 点击右上角的加号按钮来添加提供商(Codex)
切换到 Codex 标签后，同样点击右上角「+」按钮添加。
![添加新供应商配置界面](https://docs.ikuncode.cc/images/cc-switch-add-provider2.png)
![添加 Codex 供应商](https://minio.oneinai.com/oneinai/images/docs/cc-switch/cc-switch04.png)
3. 点击「保存」完成配置
**3. 保存配置**
⚠️ 重要提示
填写完成后点击「保存」即可。
不同的AI工具（Claude Code、Codex、Gemini CLI）需要不同的令牌组配置。 请在[监测站](<https://status.ikuncode.cc/>)中选择合适的分组创建令牌。
> ⚠️ **重要提示**
> 不同 AI 工具（Claude Code / Codex / Gemini CLI）需要使用**不同的令牌组**。请在[监测站](https://status.oneinai.com/)中确认模型状态后，再选择合适的分组创建令牌。
### 第三步：切换提供商
### 第三步：切换供应商
1. 在提供商列表中选择要使用的配置
2. 点击「启用」按钮
3. **或** 使用系统托盘图标进行即时切换
| 操作方式 | 步骤 |
| --- | --- |
| **应用内切换** | 在供应商列表中选择目标配置 → 点击「启用」 |
| **托盘快捷切换** | 右键点击托盘图标 → 选择对应工具的供应商 |
**系统托盘快速切换：**
> ℹ️ **生效说明**
> Claude Code 支持热重载，切换后立即生效；Codex 和 Gemini CLI 需要重启工具才能应用新配置。
* 右键点击系统托盘中的 CC-Switch 图标
* 从菜单中直接选择要切换的提供商
* 配置立即生效（Claude Code支持热重载，其它的可能需要重新启动）
### 第四步：开始使用
### 第四步：应用配置
切换完成后，启动对应的 AI 工具即可享受新配置。
切换配置后，关闭并重新启动对应的 AI 工具即可自动应用新配置。
## 📖 进阶使用
## 📖 完整文档
### 系统托盘菜单
更多详细配置和高级功能，请参阅 [CC-Switch 官方完整文档](<https://www.ccswitch.io/zh/docs?section=getting-started>)。
- 右键点击托盘图标可看到分类列表（Claude / Codex / Gemini）
- 直接点击对应分类下的供应商即可切换
- 无需打开主界面，提升日常切换效率
### API 速度测试
在供应商详情页可以一键测试 API 端点的连接速度，并以颜色直观展示质量等级，帮你快速选出最优节点。
### 配置备份与恢复
CC-Switch 会自动保留最近 10 个配置版本，意外修改后可一键回滚到任意历史版本。
## 📚 完整文档
更多高级功能与详细说明，请参阅 [CC-Switch 官方文档](https://www.ccswitch.io/zh/docs)。
## 🔗 项目资源
* **GitHub 仓库** ：<https://github.com/farion1231/cc-switch>
* **问题反馈** ：[GitHub Issues](<https://github.com/farion1231/cc-switch/issues>)
* **最新版本** ：[Releases 页面](<https://github.com/farion1231/cc-switch/releases>)
- **GitHub 仓库**：<https://github.com/farion1231/cc-switch>
- **问题反馈**：[GitHub Issues](https://github.com/farion1231/cc-switch/issues)
- **最新版本**：[Releases 页面](https://github.com/farion1231/cc-switch/releases)
🎉 开始使用！
---
现在您可以使用 CC-Switch 轻松管理多个 AI 编程工具的配置了。 享受高效的开发体验！
🎉 **开始使用！** 现在你可以用 CC-Switch 轻松管理多个 AI 编程工具的配置，享受高效的开发体验。