让 CC Switch 的站点路由更清晰、更稳定、更容易调优。
读取本机 CC Switch 中已有的站点与真实请求统计，综合模型存活、首字延迟和倍率自动调整 P 顺序。
倍率变化或模型测活完成后重新计算排序，让后续请求使用当前策略下更合适的 Provider。
📦 下载最新版 · 🚀 快速开始 · 🐛 反馈问题 · ⭐ 给个 Star
引子： 同时使用多个中转站时，低倍率线路可能临时不可用，站点延迟和倍率也会变化。CC Switch 负责成熟的本地代理与请求期故障转移；CC Route 负责模型测活、倍率更新、延迟对比和 P 队列调序。
CC Route 是一个面向 CC Switch 用户的本地智能路由增强工具。它不会重新实现站点管理，也不要求用户重复填写 Base URL、API Key 或模型配置，而是直接同步 CC Switch 中已经配置好的站点和模型。
接入后，CC Switch 仍然负责添加站点、维护凭据、填写客户端配置和请求期故障转移；CC Route 只作为控制面读取真实请求统计、检测站点状态，并把 P1、P2、P3 全局顺序写回 CC Switch。它不转发模型流量，也不会接管客户端地址或凭据。
目前支持 Claude Code、Claude Desktop、Codex、Gemini CLI、Grok Build、OpenCode 和 OpenClaw。站点、模型和应用仍按 CC Switch 熟悉的方式分类，下载安装后即可在本机使用。
如果这个项目对你有帮助，欢迎在 GitHub 点一个 Star ⭐。
 智能排序偏好：直观调节价格与首字延迟的取舍 |
|
 站点路由：查看 P 顺序、倍率、模型状态并拖动排序 |
 模型健康：查看可用站点、存活率、TTFT 与近期状态 |
 自动倍率：定时读取可信倍率并参与价格与智能排序 |
 检测设置：调整并发、站点间隔和检测网络 |
| 功能 | 作用 |
|---|---|
| 智能路由 | CC Switch 请求失败时继续尝试下一站并负责恢复；CC Route 根据测活、延迟和倍率重新计算 P 顺序 |
| 自动倍率 | 按设定周期读取受支持站点的可信倍率；价格排序或已开启自动调整的智能排序会在倍率变化后自动重排，手动倍率始终优先 |
| 智能排序偏好 | 综合平滑 TTFT 与倍率，通过“每节省 0.1x 愿意多等待多少秒”调节速度和价格，得到更符合个人偏好的性价比顺序 |
| 模型测活 | 对选定站点与文本模型发起真实检测，展示可用站点数、近期成功率、TTFT 和历史状态，随时掌握模型存活情况 |
同时支持手动拖动、价格排序、延迟排序、站点级检测开关、测速模型覆盖和一键同步 CC Switch。
Claude / Codex / Gemini 等客户端
↓
CC Switch 原生本地代理
↓
P1 → P2 → P3 → 真实 Provider
CC Route 控制面：读取 CC Switch 配置、真实请求统计和检测结果，
仅写入 in_failover_queue / sort_index 来调整上面的全局顺序。
CC Route 将站点作为主要路由对象。每个应用拥有独立的站点顺序，相同站点也可以根据支持的模型和应用协议展示不同状态。
正常情况下请求由 CC Switch 原生代理优先送到 P1；P1 不可用时继续尝试 P2、P3，并由 CC Switch 自己负责后续恢复。CC Route 的后台检测只提供健康与延迟数据，自动排序时仅调整队列顺序，不实现第二套恢复控制器。
| 应用 | 当前接入能力 |
|---|---|
| 🟠 Claude Code | CC Switch 原生代理、Route 健康检测与队列调序 |
| 🟠 Claude Desktop | CC Switch 原生代理、健康检测与队列调序 |
| ◉ Codex | CC Switch 原生代理、模型目录同步与站点排序 |
| ✦ Gemini CLI | CC Switch 原生代理、检测与自动调序 |
| ◒ Grok Build | CC Switch 原生代理、健康检测与优先级管理 |
| ◼ OpenCode | CC Switch 原生代理、模型与站点状态管理 |
| 🐞 OpenClaw | CC Switch 原生代理、站点检测与队列调序 |
应用分类、图标和站点名称均会从本机 CC Switch 中同步。不同应用分别保存自己的检测设置和 P 顺序，互不混用。
- 安装并正常配置 CC Switch
- 打开 GitHub Releases，下载 Windows x64 或 macOS Apple Silicon（arm64，macOS 11+）安装包
- 启动 CC Route，在“设置”中连接本机 CC Switch
- 点击“同步 CC”，读取已有应用、站点和模型
- 在 Route 的“排序与检测”页设置站点倍率、统一对比模型和 P 顺序
- 在 CC Switch 中开启本地代理和自动故障转移，并确认真实 Provider 已加入队列
- 从 Route 调整一次 P1/P2，刷新 CC Switch 页面确认顺序后再发送真实请求
发行版已经内置桌面控制面；普通用户不需要安装 Go、Node.js、Rust，也不需要把客户端改指向 CC Route。
Windows 首次运行： 当前安装包未使用商业代码签名证书。Windows SmartScreen 可能显示“Windows 已保护你的电脑”，请核对下载来源为本项目 GitHub Releases 后，再选择“更多信息 → 仍要运行”。
macOS Apple Silicon 首次打开： 当前 Release 未做 Developer ID 签名和 Apple 公证。请只从本项目 GitHub Releases 下载并将
CC Route.app移入“应用程序”；若 Gatekeeper 阻止，可在“系统设置 → 隐私与安全性”确认来源后选择仍要打开。不要通过清除隔离属性绕过系统校验。
当前安装包：
CC-Route-0.3.4-win-x64-setup.exe
CC-Route-0.3.4-macOS-arm64.zip
🧑💻 源码启动与本地开发
源码开发需要 Node.js、pnpm、Rust 1.88 和对应系统的 Tauri 2 前置依赖。历史 Go 网关源码只保留作迁移参考，不进入桌面发行包，也不应作为质量或运行路径。
git clone https://github.com/tllovesxs/cc-switch-route.git
cd cc-switch-route
# 验证 Rust 路由内核
cargo test --workspace
# 启动 Tauri 桌面端
cd desktop
pnpm install
pnpm run devmacOS Apple Silicon：
git clone https://github.com/tllovesxs/cc-switch-route.git
cd cc-switch-route
cargo test --workspace
cd desktop
pnpm install
pnpm run dev🛠️ 质量检查与打包
# Rust 路由与桌面内核
cargo fmt --all -- --check
cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings
# React 前端
cd desktop
pnpm run typecheck
pnpm run test:unit
pnpm run build:renderer
# Tauri 桌面端
pnpm run build| 模块 | 技术 |
|---|---|
| 桌面框架 | Tauri 2 |
| 前端界面 | React、TypeScript、Vite、Framer Motion |
| 控制面内核 | Rust、Tokio、Axum、Reqwest |
| 桌面框架与桥接 | Rust、Tauri 2 |
| 本地数据 | SQLite |
| 请求代理 | CC Switch 原生本地代理 |
| 项目 | 地址 |
|---|---|
| GitHub | tllovesxs/cc-switch-route |
| Releases | 下载 CC Route |
| Issues | 反馈问题或提出建议 |
| 联系邮箱 | tl200599@163.com |
| 作者微信 | pressure_spring |
本项目采用 MIT License 开源。
项目的交互方式参考了 CC Switch 的使用习惯，并在兼容层中复用了其 MIT 许可下的应用图标，具体说明见 THIRD_PARTY_NOTICES.md。
CC Route：让站点切换少一点手动，让模型路由多一点安心。
如果这个项目对你有帮助，欢迎在 GitHub 点一个 Star ⭐