1. 项目定位与用途
CC-Switch CLI 是 CC-Switch 的 CLI 分支，是一个跨平台的命令行管理工具，旨在为 Claude Code、Codex、Gemini、OpenCode 和 OpenClaw 等 AI 提供者提供统一的配置管理界面。它通过 Tauri 框架提供终端用户界面（TUI），支持在 Windows、macOS 和 Linux 上运行，实现一站式管理 MCP 服务器、skills、prompts、本地代理路由以及环境检查等功能。
项目档案命令行工具
CC-Switch CLI：跨平台 AI 提供者配置管理工具（Claude Code/Codex/Gemini）| 安装与使用完整指南
SaladDay/cc-switch-cli：CC-Switch CLI 是一个用 Rust 编写的跨平台命令行工具，用于统一管理 Claude Code、Codex、Gemini 等 AI本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
CC-Switch CLI 是一个用 Rust 编写的跨平台命令行工具，用于统一管理 Claude Code、Codex、Gemini 等 AI 提供者的配置，并提供 MCP 服务器、skills、prompts 等一站式管理功能。
中文项目介绍
CC-Switch CLI 是一个用 Rust 编写的跨平台命令行工具，作为 CC-Switch 的 CLI 分支，它专注于为 Claude Code、Codex、Gemini、OpenCode 和 OpenClaw 等 AI 提供者提供统一的配置管理方案。项目解决了 AI 工具配置分散、难以同步的问题，让开发者可以在不同提供者间快速切换，同时集中管理 MCP 服务器、skills、prompts、本地代理路由和环境检查。
针对 Codex MCP 配置在 TOML 与 JSON 转换时容易丢失注释和格式的问题，项目引入了 Raw TOML 存储方案，通过原始文本存储保持配置保真度，并与 Claude/Gemini 的结构化存储架构分离。
适用场景包括：多 AI 提供者环境下的开发工作流、MCP 服务器扩展管理、团队配置同步（通过 WebDAV）、以及需要精细控制环境变量和工具权限的 OpenClaw 用户。
技术层面，项目采用 Tauri 框架构建，提供基于 ratatui 的 TUI 界面，并正在进行后端重构，引入 commands/services/infrastructure/domain 分层架构以降低耦合，统一错误处理，并优化并发性能。所有功能均通过集成测试驱动开发，确保稳定性。
详细信息与使用说明
2. 解决的问题
项目主要解决以下问题：1）多个 AI 提供者配置分散，切换繁琐；2）MCP 服务器管理缺乏统一入口；3）Codex MCP 配置在 TOML↔JSON 转换过程中丢失注释、格式和特殊类型，导致数据损坏；4）配置在多设备间难以同步。通过统一管理界面、Raw TOML 存储方案和 WebDAV 同步，有效缓解了这些问题。
3. 适用场景
CC-Switch CLI 适用于：1）开发者需要在不同 AI 后端（如 Claude、Codex、Gemini）间快速切换以比较输出或利用各自优势；2）需要添加和管理 MCP 服务器以扩展 AI 能力（如网络抓取、文件操作）；3）组织和共享 prompts 与 skills 库以提高工作效率；4）配置本地代理路由以自定义 API 端点或使用 relay 服务；5）检查和修复运行环境问题；6）在多台开发机器间通过 WebDAV 保持配置一致。
4. 安装方式
项目提供跨平台安装支持：1）可从 GitHub Releases 页面下载对应操作系统（Windows/macOS/Linux）的预编译二进制文件；2）仓库中包含 install.sh 安装脚本，可自动化安装流程；3）具体安装命令或步骤在仓库中未明确给出，但通常涉及赋予执行权限并运行脚本或直接解压二进制文件。建议查看仓库中的安装文档或脚本获取详细步骤。
5. 使用方式
使用 CC-Switch CLI 主要通过命令行启动工具，随后进入基于 ratatui 的 TUI 界面进行操作：1）在首页查看当前提供者状态和快捷操作；2）通过提供者切换功能在不同 AI 后端间切换，支持多窗口独立配置；3）使用 MCP 管理功能添加、编辑、删除 MCP 服务器，支持导入导出；4）管理 prompts 和 skills 库，包括分类、搜索和应用；5）配置本地代理路由、环境变量等高级设置；6）利用 WebDAV 同步配置到云端。所有操作均通过键盘导航和表单完成，具体快捷键在 TUI 内有提示。
6. 补充说明或实现特点
项目当前正在进行多项技术改进：1）后端重构：采用分层架构（commands/services/infrastructure/domain）拆分巨型文件，统一错误处理（AppError），并使用 RwLock 优化并发；2）Codex MCP Raw TOML 改造：在 config.json 中新增 codexMcp.rawToml 字段存储原始 TOML，避免序列化损失，UI 与存储解耦；3）上游对齐：分阶段与原始 cc-switch 项目对齐数据结构和 Skills 系统，已完成 Phase 1 正确性修复（如 Gemini MCP 导入、upsert 清理、provider 写入合并）；4）OpenClaw 交互规范：定义了环境变量、Workspace、工具权限、Agents 等路由的交互规则，确保体验一致。所有变更均通过集成测试验证，保持向后兼容。
思维导图
CC-Switch CLI
核心功能
Provider 配置管理
MCP 服务器管理
配置存储 (JSON/Raw TOML)
TUI 交互界面
技术架构
Tauri + Rust 后端
分层设计 (commands/services/infrastructure/domain)
统一错误处理 (AppError)
并发优化 (RwLock)
开发状态
后端重构进行中
Codex Raw TOML 改造
上游 cc-switch 对齐
OpenClaw 交互规范
常见问题
CC-Switch CLI 支持哪些 AI 提供者？
支持 Claude Code、Codex、Gemini、OpenCode 和 OpenClaw 五种提供者。
如何安装 CC-Switch CLI？
可从 GitHub Releases 页面下载预编译二进制文件，或使用仓库中的 install.sh 脚本进行自动化安装。具体步骤请参考仓库文档。
是否支持配置同步？
是的，项目支持通过 WebDAV 协议在多设备间同步配置，且与上游 cc-switch 项目的 WebDAV 同步功能完全兼容。
Codex MCP 配置如何避免数据丢失？
采用 Raw TOML 存储方案，将 Codex MCP 配置以原始文本形式存储在 config.json 的 codexMcp.rawToml 字段中，避免 TOML 与 JSON 转换导致的注释、格式和特殊值类型丢失。
项目当前开发状态如何？
项目正在进行后端重构（采用分层架构）和 Codex MCP 存储改造，已完成 Phase 1 的正确性对齐（修复 Gemini MCP 导入、MCP upsert 清理、Gemini provider 写入合并），并持续与上游 cc-switch 同步新功能。