1. 项目定位与用途
CC Switch 定位为 AI 编程助手的统一管理平台，是一款开源的跨平台桌面应用程序。其核心用途是通过图形化界面集中管理多个 AI 命令行工具（如 Claude Code、Codex、Gemini CLI 等），让用户无需在终端中手动切换和配置，即可快速选择并启动所需的助手服务，从而优化开发工作流。
项目档案应用项目
CC Switch 官方项目 - 跨平台 AI 编程助手统一管理器 | 安装、使用与技术详解
CC Switch 是一款开源跨平台桌面工具，用于集中管理 Claude Code、Codex、Gemini CLI 等多种 AI 编程助手。本页面提供项目完整介绍、核心功能、安装步骤、使用指南、技术架构及常见问题，帮助开发者快速上手并提升多 AI 工具协作效率。
AI 总结
CC Switch 是一款基于 Tauri 的跨平台桌面应用，统一管理 Claude Code、Codex、Gemini CLI 等多种 AI 编程助手，通过图形化界面简化 API 密钥、代理配置与工具切换，提升开发者效率。
中文项目介绍
CC Switch 是一款专为开发者设计的跨平台桌面应用程序，采用 Tauri 框架构建，提供统一的图形化界面来管理 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 等多种 AI 编程助手工具。
它解决了在不同 AI 工具间手动切换、分别管理 API 密钥和配置参数的繁琐问题，将多工具管理集中化，避免重复的配置操作和命令行记忆负担。
适用于需要频繁使用多种 AI 编程助手的开发者、开发团队，以及希望简化配置流程、避免命令行操作、追求高效工作流的用户。
项目基于 React + Vite 前端架构，支持通用提供商自定义端点与模型，内置 OAuth 设备码认证流程（用于 Copilot/Codex）和深度链接导入机制，提供独立的代理配置面板，整体设计注重模块化与开发者体验。
详细信息与使用说明
2. 解决的问题
项目主要解决多 AI 工具管理分散的痛点：开发者通常需要在不同助手间切换，各自维护独立的 API 密钥、模型名称、端点 URL 等配置，过程繁琐易错。CC Switch 将这些配置聚合于一处，提供统一的切换器与配置表单，消除重复操作，降低使用门槛，提高工具切换效率。
3. 适用场景
适用场景包括：个人开发者同时使用多种 AI 编程助手进行代码生成、审查或调试；团队需要标准化工具配置并共享设置；用户希望避免记忆各工具的 CLI 命令与参数；需要在不熟悉命令行的环境下快速启用 AI 辅助；以及需要通过代理网络访问 AI 服务的环境。
4. 安装方式
从当前仓库信息可见，安装需先确保系统已安装 Node.js 和 pnpm 包管理器。克隆仓库后，在项目根目录执行 `pnpm install` 安装依赖。开发环境运行 `pnpm tauri dev` 启动应用，生产构建执行 `pnpm tauri build` 生成桌面安装包。具体平台安装包也可在 GitHub Releases 页面下载。
5. 使用方式
启动应用后，用户可在界面中添加所需的 AI 服务提供商（如 Claude、Gemini 等），为每个提供商填写 API 密钥、基础 URL、模型名称等参数。通过顶部或侧边的切换器选择当前激活的 CLI 工具，应用将调用对应配置。此外，内置的代理设置面板允许用户配置 HTTP/HTTPS 代理以满足网络访问需求。
6. 补充说明与实现特点
项目采用 Tauri 2 + React + Vite 技术栈，前端使用 CodeMirror 提供代码编辑与高亮，TailwindCSS 负责样式。核心 API 模块化设计，分离提供商、设置、认证、配置和深度链接等功能。表单状态由自定义 Hooks 管理，支持通用提供商自定义端点与模型。认证模块实现 OAuth 设备码流程用于 GitHub Copilot 与 Codex，深度链接模块支持配置的导入导出与跨设备同步。
思维导图
CC Switch 项目结构
核心功能模块
提供商管理
工具切换器
认证系统
配置管理
技术架构
Tauri 桌面框架
React 前端
Vite 构建工具
TypeScript 类型系统
配置与网络
通用提供商预设
代理设置面板
深度链接导入
OAuth 设备码登录
开发与构建
pnpm 工作流
Vite 配置别名
多语言文档
单元测试
常见问题
CC Switch 支持哪些 AI 编程助手？
根据项目描述，CC Switch 支持 Claude Code、Codex、Gemini CLI、OpenCode 和 OpenClaw 等主流 AI 命令行编程助手，并可通过通用提供商配置扩展其他兼容 OpenAI 格式的服务。
如何安装和运行 CC Switch？
安装需先安装 Node.js 和 pnpm。克隆仓库后运行 `pnpm install` 安装依赖，开发模式执行 `pnpm tauri dev`，构建桌面包执行 `pnpm tauri build`。预编译的安装包也可在 GitHub Releases 页面下载。
CC Switch 是否免费且开源？
是，项目采用 MIT 许可证开源，代码托管于 GitHub，可免费用于个人及商业目的。
如何配置 API 密钥和模型？
在应用界面中点击添加提供商，选择对应服务类型，填写 API 密钥、基础 URL（如非默认）和模型名称等信息即可保存。通用提供商支持自定义端点与模型参数。
是否支持代理网络配置？
支持。应用内置代理设置面板，用户可配置 HTTP/HTTPS 代理地址，以满足通过代理访问 AI 服务或特定网络环境的需求。