掌握跨平台桌面助手：高效管理AI服务的全方位指南

跨平台桌面助手是一款集Claude Code、Codex和Gemini CLI于一体的全能工具，能帮助用户轻松管理和切换各类AI服务提供商，实现高效的AI服务管理体验。无论是开发者还是普通用户，都能通过它便捷地配置、切换和使用不同的AI服务。

功能概览：跨平台桌面助手的核心价值

跨平台桌面助手作为一款强大的AI服务管理工具，具备以下核心功能：

• 多平台支持：兼容Windows 10/11、macOS 10.15+及Linux（Ubuntu 20.04+）系统，满足不同用户的使用需求。
• 多AI服务集成：整合了Claude Code、Codex和Gemini等主流AI服务，无需在多个应用间切换。
• 便捷的提供商管理：可轻松添加、编辑、删除和切换AI服务提供商，让服务管理一目了然。
• 实用的代理功能：内置代理设置，提升部分AI服务的访问稳定性，保障使用体验。

安装指南：三步完成初始设置

准备工作：确认环境要求

在安装跨平台桌面助手前，请确保你的系统满足以下条件：

• 操作系统：Windows 10/11、macOS 10.15+或Linux（Ubuntu 20.04+）
• 网络连接：稳定的互联网连接（用于下载安装包和更新）
• 存储空间：至少200MB可用空间

方法一：开发者推荐 - Git Clone安装

如果你熟悉命令行操作，可通过以下步骤克隆并安装：

git clone https://gitcode.com/GitHub_Trending/cc/cc-switch
cd cc-switch
pnpm install
pnpm dev

方法二：普通用户推荐 - 预编译版本安装

访问项目发布页面，下载对应操作系统的最新版本安装包，然后按照常规软件安装步骤进行安装即可。

核心功能操作：轻松上手AI服务管理

认识主界面：了解功能布局

成功安装并启动跨平台桌面助手后，你将看到其主界面，主要包含以下元素：

• 顶部导航栏：用于切换不同的AI服务（Claude、Codex、Gemini）
• 中间区域：展示已配置的AI服务提供商列表
• 右侧功能按钮：提供添加新提供商、进入设置等功能

添加AI服务提供商：四步完成配置

步骤1：打开添加提供商窗口

点击主界面右上角的"+"按钮，打开添加提供商窗口。

步骤2：选择预设提供商

在弹出的窗口中，从预设的提供商列表（如Claude Official、DeepSeek、Qwen Coder等）中选择所需的提供商，系统会自动填充基本信息。

步骤3：填写API密钥

对于大多数提供商，只需填写API密钥。API密钥通常可在提供商的官方网站上获取。

步骤4：保存配置

填写完成后，点击"添加"按钮保存配置，新添加的提供商将出现在主界面的列表中。

管理与切换提供商：高效使用AI服务

切换当前使用的提供商

在主界面中，点击提供商卡片即可将其设为当前使用的提供商，当前使用的提供商会有明显标识。

编辑提供商配置

在提供商卡片右侧，找到编辑按钮（铅笔图标），点击后可修改提供商的配置信息，包括API密钥、名称和备注等。

删除提供商

若不再需要某个提供商，点击删除按钮（垃圾桶图标）即可将其从列表中移除。

高级配置：优化你的使用体验

代理设置：提升访问稳定性

跨平台桌面助手提供了代理功能，可帮助你更稳定地访问某些AI服务。点击主界面顶部的"Proxy"开关启用代理功能，具体配置可在设置中进行调整。

查看官方文档：获取更多配置指导

如需了解更多高级配置选项，可参考官方文档：docs/user-manual/1-getting-started/1.5-settings.md。

使用技巧：高效切换AI服务的技巧

• 快速切换服务：通过顶部导航栏可快速在Claude、Codex、Gemini等AI服务间切换，满足不同场景的使用需求。
• 合理管理提供商：根据使用频率和需求，对提供商进行排序和分组，提高管理效率。
• 定期备份配置：建议定期备份提供商配置，避免因意外情况导致配置丢失，可在设置中的备份功能进行操作。

常见问题解决与官方资源

常见问题解决

在使用过程中遇到问题，可查看FAQ部分：docs/user-manual/5-faq/5.2-questions.md，获取常见问题的解决方案。

官方资源链接

• 项目源码：GitHub_Trending/cc/cc-switch
• 发布页面：可在项目源码页面获取最新的预编译版本下载链接
• 帮助文档：docs/user-manual

通过本指南，你已掌握跨平台桌面助手的基本使用方法。开始享受高效管理和切换AI服务的便捷体验吧！ 🚀