GitHub Explorer

Claude Relay Service (CRS) 深度分析报告

GitHub: https://github.com/Wei-Shaw/claude-relay-service

一句话总结

中文社区最成功的 Claude Code 自建中转/拼车方案,围绕「多账号管理 + 拼车共享 + 成本分摊」构建了完整运营工具链,8.5 个月 10,670 Stars,Docker 拉取 128K+。

值得关注的理由

  • 细分领域事实标准:在 Claude Code 中转/拼车赛道中功能最全面(7+ 提供商、额度卡、倍率计费、Web 管理面板),竞品均不具备完整的「拼车即服务」能力
  • 增长稳健:8.5 个月从 0 到 10.7K Stars,日均 ~50 新 Star,Fork 1,606(比率 15%),Docker 128K+ pulls
  • 已有演进路线:作者同时开发了 CRS 2.0(sub2api,Go 重写,10.4K Stars),说明产品思维成熟

项目画像

维度数据
GitHubhttps://github.com/Wei-Shaw/claude-relay-service
Star / Fork10,670 / 1,606
代码行数158,886(JavaScript 53%, Vue 28%)
项目年龄8.5 个月(2025-07-14 创建)
开发阶段稳定维护期(v1.1.297,297 个版本,正向 CRS 2.0 迁移)
贡献模式核心 3-4 人 + 30 位社区贡献者(Wei-Shaw 占 60%)
热度定位大众热门(10K+ stars,中文社区主导)
质量评级代码[良好] 文档[良好] 测试[中低]

作者视角:为什么存在这个项目

创始人/作者背景

Wei-Shaw(Wesley Liddick),大学生开发者。在 CRS 之前无高影响力项目,CRS 是其「一飞冲天」之作。仅凭这一个项目获得 10.7K Stars,并在此基础上用 Go 重写了 CRS 2.0(sub2api,同样达到 10.4K Stars),同时运营商业化拼车平台 pincc.ai。从零到万星项目 + 商业化平台,这是一个大学生创业者的典型成长路径。

问题判断

Claude Code 订阅费 200 美元/月,中国大陆无法直接访问。三个痛点叠加形成了巨大需求缺口:

  1. 地区限制:需代理中转
  2. 隐私顾虑:第三方镜像站可窥视对话内容
  3. 成本压力:3-5 人拼车可将人均成本降至 40-70 美元

中国用户群体庞大,且已有 VPN 合租、ChatGPT 拼车的既有习惯,Claude Code 的订阅制恰好适配共享经济逻辑。

解法哲学

「让复杂的事情看起来简单」:

  • 用户侧:输入一个 API Key 即可使用,体验等同官方
  • 运维侧:一键脚本部署,Docker Compose 全家桶
  • 管理侧:全功能 Web 管理面板,无需命令行操作

战略意图

CRS 1.0(Node.js)→ sub2api / CRS 2.0(Go 重写)→ pincc.ai(商业化拼车平台,0.8 元 = 1 美金额度)。开源版负责获客和建立信任,付费平台负责变现。README 已在顶部推荐迁移到 sub2api,CRS 1.0 正式进入维护模式。

核心价值提炼

创新之处

  1. 额度卡系统(QuotaCardService)(新颖度 4/5 | 实用性 5/5 | 可迁移性 4/5) 独创的「充值卡」机制:管理员生成带额度/时间的卡号(CC_XXXX_XXXX_XXXX 格式),用户核销后自动更新 API Key 的费用限额或有效期。让拼车费用分摊变得像「买点卡」一样简单。

  2. 服务倍率计费(ServiceRatesService)(新颖度 3/5 | 实用性 5/5 | 可迁移性 4/5) 以 Claude 为基准倍率 1.0,不同上游提供商设置不同消费倍率(如 Gemini 0.5x、GPT-4o 0.8x)。解决了多提供商混合计费的痛点。

  3. 工具名随机化反检测(新颖度 4/5 | 实用性 3/5 | 可迁移性 2/5) _transformToolNamesInRequestBody 将工具名进行 PascalCase 转换 + 随机后缀处理,响应中逆向恢复。这是一种对抗 Anthropic 检测共享使用的技术手段。

  4. 基于 Prompt Cache 的粘性会话(新颖度 3/5 | 实用性 5/5 | 可迁移性 4/5) 利用 Claude 的 cache_control: {"type": "ephemeral"} 和 metadata.user_id 生成会话哈希,确保同一对话命中同一上游账户,最大化利用 Anthropic Prompt Cache 降低成本。

  5. 优先级加权 LRU 调度(新颖度 3/5 | 实用性 5/5 | 可迁移性 5/5) 三级排序:优先级数值(低优先)→ 最后使用时间(早优先,轮转效果)→ 创建时间。配合强制绑定、专属账户、分组、粘性会话的四层调度链,形成完整的多账号负载均衡策略。

可复用的模式与技巧

  1. Redis 全存储 + 数据迁移:启动时自动检测版本差异执行迁移,无需 ORM 的轻量 Schema 演进方案
  2. 统一调度器抽象:强制绑定 → 专属账户 → 分组 → 粘性会话 → 共享池的调度链,通用多上游负载均衡模型
  3. 并发排队 + P90 健康检查:指数退避轮询 + P90 等待时间作为快速失败依据,分布式限流方案
  4. 多格式 API 桥接:OpenAI ↔ Claude ↔ Gemini 的格式转换层,通用 AI API 网关模式
  5. AES-256-CBC 加密 + LRU 缓存:敏感数据加密存储,解密结果缓存,平衡安全性和性能

关键设计决策

  1. Redis 全存储(无传统数据库):账户用 Hash、统计用 Sorted Set、计费用 Stream、并发控制用 Lua 脚本。权衡:内存占用可控(几十个账户),但缺乏关系查询能力,通过索引和反向索引弥补。这也是最终选择 Go + PostgreSQL 重写的原因之一。

  2. 多层 API 兼容层:OpenAI → Claude、Gemini → OpenAI、Anthropic → Gemini 等多向格式转换。用户可用任何主流 AI CLI 通过 CRS 访问任何上游提供商。

  3. 客户端指纹验证:对 Claude Code / Gemini CLI / Codex CLI 的请求特征验证(User-Agent、系统提示词特征、路径白名单),防止非目标客户端滥用 API Key。

竞品格局与定位

竞品对比矩阵

维度CRSsub2api (CRS 2.0)1rgs/proxyfuergaosi233/proxymeridian
Stars10.7K10.4K3.4K2.3K590
多账号管理完整完整(Go)无无无
拼车/计费额度卡+倍率完整无无无
Web 管理面板Vue 3 SPA有无无无
多提供商7+类似仅 Claude仅 Claude仅 Claude
API 互转OpenAI↔Claude↔Gemini有模型转换轻量代理无

差异化护城河

  • 运营工具链完整性:竞品都是「代理转发」,CRS 是「拼车即服务」——多账号调度、额度卡、倍率计费、Web 面板、客户端限制,完整的运营闭环
  • 多提供商覆盖:7+ 上游提供商 + 多向格式互转,竞品仅支持 Claude
  • 社区规模:30+ 贡献者、128K Docker pulls、Telegram 频道,已形成用户社区

竞争风险

  • TOS 违规是根本性风险:封号问题(#587、#1048)是项目最大痛点,Anthropic 可以随时收紧检测
  • 被自己的 CRS 2.0 取代:README 已推荐迁移到 sub2api,CRS 1.0 进入维护模式
  • 安全漏洞前科:v1.1.248 以下有管理员认证绕过漏洞,代码安全审计不够充分

生态定位

中文 AI 开发者社区的「拼车基础设施」。填补了 Claude Code 在中国大陆的可用性空白,同时解决了高订阅费的成本痛点。但其存在本质上依赖于对平台 TOS 的灰色使用,长期可持续性取决于 Anthropic 的政策走向。

套利机会分析

  • 信息差: 低。项目在中文社区已有极高知名度(10.7K Stars,主要用户为中文开发者),几乎不存在信息差
  • 技术借鉴: (1) 统一调度器的四层调度链(强制绑定→专属→分组→粘性→共享)可用于任何多上游负载均衡场景;(2) Redis 全存储 + 启动时迁移是中小型项目的可选架构;(3) 多格式 API 桥接层可用于 AI API 网关;(4) 额度卡系统可用于任何共享经济场景的费用分摊
  • 生态位: Claude Code 中文社区的「拼车标准方案」
  • 趋势判断: CRS 1.0 已进入日落期(推荐迁移到 Go 版 CRS 2.0)。但灰色地带项目的长期风险始终存在——Anthropic 的政策变化可能一夜之间摧毁整个生态

风险与不足

  1. TOS 违规的根本性风险:项目 README 明确声明可能违反 Anthropic 服务条款。封号是用户最大痛点(#587 的 35 条评论、#1048 的 21 条评论)
  2. 安全漏洞前科:v1.1.248 以下有管理员认证绕过漏洞,featureFlags.js 中余额脚本功能有 RCE 风险(默认禁用)
  3. 正在被 CRS 2.0 取代:README 顶部已推荐迁移到 sub2api,当前仓库进入维护模式
  4. redis.js 过载:5,281 行的单文件涵盖数据访问、统计聚合、数据迁移,承担了过多职责
  5. 测试覆盖不足:10 个测试文件,缺少中继服务和调度器的单元测试——这是处理真实金钱流转的系统,测试不足是显著风险
  6. Node.js 单线程瓶颈:高并发场景下性能受限,这也是 Go 重写的直接动因
  7. 灰色商业化风险:pincc.ai 提供付费拼车服务,在法律和平台政策层面风险更大

行动建议

  • 如果你要用它: 建议直接使用 CRS 2.0(sub2api)而非 CRS 1.0。注意 TOS 风险——Anthropic 可能检测并封禁共享账户。确保升级到 v1.1.249+ 以修复安全漏洞
  • 如果你要学它: 重点关注 src/services/scheduler/unifiedClaudeScheduler.js(多账号调度算法)、src/middleware/auth.js(并发排队 + 健康检查)、src/models/redis.js(Redis 全存储架构)、src/services/relay/claudeRelayService.js(中继转发 + 工具名随机化)
  • 如果你要 fork 它: (1) 拆分 redis.js(数据访问/统计/迁移分离);(2) 补充调度器和中继服务的单元测试;(3) 考虑 Go 重写已有现成参考(sub2api)

知识入口

资源链接
DeepWikideepwiki.com/Wei-Shaw/claude-relay-service
官方文档pincc.ai
演示站demo.pincc.ai
CRS 2.0github.com/Wei-Shaw/sub2api
Docker Hubweishaw/claude-relay-service
Telegramt.me/claude_relay_service
Zread.ai未收录
关联论文无

相关报告