cc-router

Name: cc-router
Author: finch-xu

Verified

把零散的 Token Plan、Coding Plan、大模型 API 额度聚合成一个虚拟 Plan，一键接入 Claude Code、Claude Desktop App、OpenClaw、OpenCode 等工具 —— 省钱！省 Token！完全本地运行！ Bundle your scattered Token Plan, Coding Plan, and LLM API quotas into a single virtual Plan, and plug it into Claude Code, Claude Desktop App, OpenClaw, OpenCode, and more.

174stars

13forks

Rust

Installation

# Add to your Claude Code skills
git clone https://github.com/finch-xu/cc-router

Getting Started

Guides for using ai agents skills like cc-router.

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T15:50:15.826Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is cc-router?

cc-router is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by finch-xu. 把零散的 Token Plan、Coding Plan、大模型 API 额度聚合成一个虚拟 Plan，一键接入 Claude Code、Claude Desktop App、OpenClaw、OpenCode 等工具 —— 省钱！省 Token！完全本地运行！ Bundle your scattered Token Plan, Coding Plan, and LLM API quotas into a single virtual Plan, and plug it into Claude Code, Claude Desktop App, OpenClaw, OpenCode, and more. It has 174 GitHub stars.

Is cc-router safe to use?

Yes. cc-router passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install cc-router?

Clone the repository with "git clone https://github.com/finch-xu/cc-router" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is cc-router written in?

cc-router is primarily written in Rust. It is open-source under finch-xu on GitHub, so you can review or fork the full source.

Are there alternatives to cc-router?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh cc-router against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

ai llm-wiki-karpathy

把零散的 Token Plan、Coding Plan、大模型 API 额度聚合成一个虚拟 Plan，一键接入 Claude Code、Claude Desktop App、OpenClaw、OpenCode、Codex 等工具 —— 省钱！省 Token！完全本地运行！

注意⚠️ 本工具仅限于自动切换订阅套餐，请求体几乎完全透传，不涉及逆向、不涉及破解等操作。用户需自行遵守每个编程套餐的使用规则。此工具只能用于 Claude Code 等编程工具，切勿用于其他用途。

各家 provider 的 ToS 不一定明确允许"订阅 Key 接第三方代理 + 多虚拟模型混调度"的用法，尤其是 Coding Plan / Token Plan 这类 per-seat 订阅，可能触发风控。因使用本工具导致账号被限速、被封禁、订阅被取消的，作者不承担任何责任。

本软件按 As-Is 提供，不对任何因使用造成的直接或间接损失负责，包括但不限于额度异常消耗、数据丢失、业务中断。

功能亮点：

19 家 provider 一站调度 —— 内置 DeepSeek、Qwen、Kimi、MiMo、MiniMax、GLM、Claude、Gemini 等 Token Plan / Coding Plan / API 额度,opus / sonnet / haiku 三槽位任意搭配,顺序或轮询自动切换
任意自定义端点 —— 内置厂商不够时,把任何 Anthropic Messages 兼容或 Gemini generateContent 兼容或 OpenAI Responses 兼容的 API 直接配进来,与内置订阅同等调度
用量小票 —— token 消费快照一键导出 PNG / PDF / HTML,黑白 / 彩色双模式,默认不显示价格只展示用量,扫底部二维码即跳仓库
三语完整翻译 —— 简体中文 / English / 日本語,可跟随系统或在设置页手动切换
虚拟模型多别名 —— opus / sonnet / haiku 三个槽位各识别多种命名,以 opus 为例,model-opus / claude-opus-4-7 / anthropic/model-opus / anthropic/claude-opus-4-7 都路由到同一虚拟模型,工具用什么命名都不挑
本地 HTTPS —— 一键生成自签 CA 与服务器证书,让只支持 HTTPS 的客户端也能接入 cc-router,详见配置教程
接入 Claude Desktop App —— 借助本地 HTTPS 与虚拟模型别名,Anthropic 官方桌面端可直接走 cc-router 聚合的多家订阅,详见配置教程
双协议 API 入口 —— Anthropic /v1/messages 与 OpenAI /v1/responses 两套端点并行,Claude Code / Codex 等 Anthropic 与 OpenAI 生态的客户端都能一键接入

接入指南

下方的 AI Agent / Coding Agent 工具都支持接入cc-router并使用你的所有大模型plan。

支持的编程套餐和API

id	名称	Token Plan	API	兼容性
`anthropic`	Anthropic 官方 API（仅按量付费，不含 Plan）	❌	✅	verified
`openai_codex`	OpenAI Codex (ChatGPT Plus/Pro 订阅) 有封号风险，不推荐使用	✅	❌	tested
`kiro`	Kiro IDE (AWS) 免费 Claude 订阅额度，灰色地带有封号风险，不推荐使用	✅	❌	tested
`google_ai_studio`	Google AI Studio (Gemini) 按量付费 + 免费 quota	❌	✅	verified
`zhipu`	智谱 GLM（按量付费/中国订阅）	✅	✅	verified
`deepseek`	DeepSeek（按量付费）	❌	✅	verified
`moonshot`	Moonshot Kimi（按量付费/中国订阅/国际订阅）	✅	✅	untested
`minimax`	MiniMax（按量付费/中国订阅/国际订阅）	✅	✅	verified
`xiaomi`	小米 MiMo（按量付费/中国订阅/国际订阅）	✅	✅	verified
`alibaba`	阿里云百炼（Token Plan 团队版 + 按量付费 2 地域 + 停售的 Coding Plan）	✅	✅	verified
`volcengine`	字节跳动火山方舟（Coding Plan 订阅 + Agent Plan 订阅 + 按量付费）	✅	✅	untested
`openrouter`	OpenRouter 聚合平台（500+ 模型路由）	❌	✅	untested
`tencent`	腾讯云大模型（Token Plan 订阅 + TokenHub 按量付费境内/境外）	✅	✅	untested
`aiberm`	Aiberm（按量付费 API，模型按 token group 动态返回）	❌	✅	untested
`whatai`	神马中转 API（按量付费，OpenAI/Anthropic 双协议中转，仅用 Anthropic 路径）	❌	✅	untested
`ollama`	Ollama 本地推理（仅 localhost:11434，含云端模型 tag 如 `glm-4.7:cloud`）	❌	✅	partial
`fireworks`	Fireworks AI（按量付费/国际订阅Fire Pass）	✅	✅	verified
`stepfun`	阶跃星辰（按量付费/中国订阅/国际订阅）	✅	✅	untested
`baidu`	百度千帆（按量付费/中国订阅）	✅	✅	untested
`modelscope`	魔搭 ModelScope（按量付费）	❌	✅	partial
`ucloud`	优云智算 UCloud Modelverse（Coding Plan 订阅 + 按量付费 API 国内/海外）	✅	✅	untested
`openai`	OpenAI 官方 API（按量付费，含 GPT-5 / o3 / 4.1 等 reasoning 模型，自动翻译 Anthropic thinking ↔ OpenAI reasoning）	❌	✅	untested
`自定义`	自定义任意Anthropic协议API	✅	✅	verified
`自定义 (Gemini 兼容)`	接入任意 Gemini generateContent 兼容端点（中转站等），messages_path 用 `{model}` 占位符	❌	✅	tested
`自定义 (OpenAI Responses 兼容)`	接入任意 OpenAI `/v1/responses` 兼容端点（one-api / new-api 等中转站），自动协议翻译	❌	✅	tested
`自定义 (OpenAI Chat Completions 兼容)`	接入任意 OpenAI `/v1/chat/completions` 兼容端点（DeepSeek / Together / Groq / Ollama / one-api / new-api 等中转站），自动协议翻译，DeepSeek R1 等模型的 reasoning_content 暴露为 Claude Code thinking 块	❌	✅	tested

Token Plan 列包含各厂商的套餐订阅形态（Token Plan / Coding Plan / Agent Plan 等）；API 列指按量付费的 Anthropic Messages 兼容端点。

社区可 PR 补充。

技术栈

Tauri 2
Tailwind 4
React 19

安装使用

在release里下载客户端并安装。
配置多厂商的大模型，配置虚拟模型对应的真实模型和调度模式。
配置到Claude Code中使用。

在 Claude Code 中使用

设置 页会动态显示完整的 env snippet；默认端口被占用时自动 +1 递增。

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:23456",
    "ANTHROPIC_AUTH_TOKEN": "your token, show in this app settings",
    "API_TIMEOUT_MS": "3000000",
    "ANTHROPIC_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "model-opus",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "model-sonnet",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "model-haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL": "model-opus",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

当OPUS_MODEL支持1m上下文的时候，可以设置为model-opus[1m]以获得Claude code工具的完整上下文支持。

也兼容 LiteLLM 风格的 anthropic/ 前缀：anthropic/model-opus / anthropic/model-sonnet / anthropic/model-haiku 等同于无前缀写法，方便接入需要带 provider 前缀才能识别 Anthropic 协议的工具。

虚拟模型和别名：

虚拟模型	别名
`model-opus`	`anthropic/model-opus` `anthropic/claude-opus-4-7` `claude-opus-4-7` `gpt-5.5` `openai/gpt-5.5`
`model-sonnet`	`anthropic/model-sonnet` `anthropic/claude-sonnet-4-6` `claude-sonnet-4-6` `gpt-5.4` `openai/gpt-5.4`
`model-haiku`	`anthropic/model-haiku` `anthropic/claude-haiku-4-5` `claude-haiku-4-5` `gpt-5.4-mini` `openai/gpt-5.4-mini`

常见问题&使用场景

没有 cc-router 时：AI Agent（Claude Code / OpenCode 等）一次只能接一家厂商，小额度订阅在关键时刻断流，得手动切配置——体验糟糕。

接上 cc-router 后：Agent → cc-router → 厂商 A + B + C，自动负载均衡、自动故障转移，三家订阅当一家用。

收益：

省钱 —— 不必买昂贵的大额 Coding Plan，两个小额度拼起来就够用
不断流 —— 限流 / 失败自动切换，Agent 无感
混搭顶配 —— GLM-5.1、DeepSeek-V4-Pro、MiniMax-2.7、MiMo-V2.5-Pro 同时上桌，也能掺 Claude Opus、GPT-5.5 这类原生 API
用量统一 —— 所有订阅 token 消费一屏看完，可一键导出小票

Claude Code 按任务难度分三档：opus 做规划、sonnet 写代码、haiku 跑工具调用。

cc-router 把这三档抽象成 model-opus / model-sonnet / model-haiku 三个虚拟槽位，每个槽位绑一组真实模型 + 调度模式：

model-opus → DeepSeek-V4-Pro + GLM-5.1（轮询）
model-sonnet → MiniMax-M2.7 + MiMo-V2.5-Pro（轮询）
model-haiku → GLM-4-Flash

CC 请求来了就按映射转发，不用再频繁改 ~/.claude/settings.json。

举例：订阅 A = GLM-5 / MiniMax-2.7 / DeepSeek-Flash，订阅 B = DeepSeek-V4-Pro / MiniMax-2.7 / GLM-5。

稳妥派：把两边的同档模型一起绑进对应槽位，效果一致、容灾好
激进派：把两边各自的顶配模型都塞进 model-opus 轮询，交叉使用大概率 1 + 1 ≥ 2

顺序 —— 用完 A 再切 B。命中缓存好、能榨干小额度订阅，推荐给两个小额 GLM Coding Plan 这类场景
轮询 —— 两家均衡分担。但跨账号的缓存是独立的，会多吃额度，换来的是真正的负载均衡

开发

依赖：Node.js ≥ 20（推荐 pnpm），Rust ≥ 1.77，Xcode CLT（macOS）。

pnpm install
pnpm tauri dev      # 启动开发模式（同时运行前端 + Rust 后端 + 代理）

首次启动 app 会进入 onboarding：

添加一个订阅（选厂商 → 选接入点 → 填 API Key → 自动抓取模型列表）
一键把订阅绑定到三个虚拟模型
复制 Claude Code 环境变量配置，粘到你的 ~/.claude/settings.json

添加新provider

如果你使用Claude Code，我提供了一个SKILL，可以执行new-provider并附加provider的官方文档或接口地址等信息，能够自动创建provider的配置。

打包

pnpm tauri build

产出：src-tauri/target/release/bundle/ 下对应平台的安装包。

图标

Provider 品牌 logo 来自 @lobehub/icons（MIT）。各品牌商标归原所有者所有。

证书

MIT