mirror of https://github.com/farion1231/cc-switch.git synced 2026-04-22 17:11:04 +08:00

Files

Dex Miller 0fcb1b01e2 docs: add user manual documentation (#979 )

* docs: add user manual documentation

Add comprehensive user manual covering getting started, provider management,
extensions (MCP/prompts/skills), proxy configuration, and FAQ sections.
Includes screenshots and a README index.

* fix(docs): align user manual with v3.10.3 codebase

- Add OpenCode as 4th supported app throughout all docs
- Fix proxy default port 15762 → 15721
- Update Claude presets (9 → 26), Codex (3 → 10), Gemini (3 → 7)
- Add OpenCode presets (25 entries)
- Fix timeout defaults and ranges (stream first byte 60s/90s, etc.)
- Fix circuit breaker defaults with per-app values (Claude vs general)
- Fix Skills support: all 4 apps, not just Claude/Codex
- Remove non-existent Gemini authMode field
- Fix prompt deletion behavior: enabled prompts cannot be deleted
- Remove non-existent Legacy deeplink protocol, use V1 only
- Fix DB table names (usage_logs → proxy_request_logs) and add missing tables
- Fix migration version v3.8.0 → v3.7.0
- Add missing V1 deeplink parameters (config, configFormat, etc.)
- Update doc version v3.9.1 → v3.10.3
- Add claude-opus-4-1 to pricing table
- Fix recovery wait time range 10-300 → 0-300

---------

Co-authored-by: Jason <farion1231@gmail.com>

2026-02-09 15:01:15 +08:00

2.2 KiB

Raw Blame History

1.1 软件介绍

什么是 CC Switch

CC Switch 是一款跨平台桌面应用，专为使用 AI 编程工具的开发者设计。它帮助你统一管理 Claude Code、Codex、Gemini CLI、OpenCode 四大 AI 编程工具的配置。

解决什么问题

在日常开发中，你可能会遇到这些痛点：

多供应商切换麻烦：使用不同的 API 供应商（官方、中转服务商），需要手动修改配置文件
配置分散难管理：Claude、Codex、Gemini、OpenCode 各有独立的配置文件，格式不同
无法监控用量：不知道 API 调用了多少次，花了多少钱
服务不稳定：单一供应商出问题时，整个工作流中断

CC Switch 通过统一的界面解决这些问题。

核心功能

供应商管理

一键切换多个 API 供应商配置
支持预设模板，快速添加常用供应商
统一供应商功能，跨应用共享配置
用量查询与余额显示
端点速度测试

扩展功能

MCP 服务器：管理 Model Context Protocol 服务器，扩展 AI 能力
Prompts：管理系统提示词预设，快速切换不同场景
Skills：安装和管理技能扩展

代理与高可用

本地代理服务，记录请求日志和用量统计
自动故障转移，主供应商失败时自动切换备用
熔断器机制，防止频繁重试失败的供应商
详细的 Token 用量追踪与成本估算

支持的应用

应用	说明
Claude Code	Anthropic 官方的 AI 编程助手
Codex	OpenAI 的代码生成工具
Gemini CLI	Google 的 AI 命令行工具
OpenCode	开源 AI 编程终端工具

支持的平台

Windows 10 及以上
macOS 10.15 (Catalina) 及以上
Linux Ubuntu 22.04+ / Debian 11+ / Fedora 34+

技术架构

CC Switch 使用现代化的技术栈构建：

前端：React 18 + TypeScript + Tailwind CSS
后端：Tauri 2 + Rust
数据存储：SQLite（供应商、MCP、Prompts）+ JSON（设备设置）

这种架构确保了：

跨平台一致的体验
原生级别的性能
安全的本地数据存储

2.2 KiB Raw Blame History Unescape Escape