RepoDaily · 2026-08-23 · AI model / Agent framework

Sub2API 开源解析:用 Go 把 Claude、OpenAI、Gemini、Grok 订阅拼车成一个 API

#17 AI model / Agent framework Go +264 Wei-Shaw/sub2api 打开仓库

用 Go 自建的中转网关:把 Claude、OpenAI、Gemini、Grok 订阅汇成一个 API、拼车分摊成本——而 README 自己警告这种用法可能违反上游服务条款。

项目类型AI model / Agent framework
最适合已经付费持有 Claude、OpenAI、Gemini 或 Grok 订阅的小团体,想把额度池化到一个自建 API 后面,并继续无缝使用 Claude Code、Codex 等原生工具。
风险等级高——README 自己声明使用可能违反 Anthropic 等上游服务商条款
评估时间半天:准备 PostgreSQL 15+ 与 Redis 7+,构建 Docker 镜像,接入一个原生客户端

核心问题: 你能否接受上游服务条款与封号风险,换取一个自建统一入口背后的共享订阅额度?

87/100

RepoDaily 采用评分

RepoDaily 将该项目的采用分评为 87/100(强):分数来自文章来源、安装路径、生产风险、差异化、许可证清晰度以及 AI/Agent 适配度。

基于 RepoDaily 来源和采用说明的方向性评分,不是基准测试。风险: 高
100证据质量

包含 5 个来源、覆盖 4 类来源;如有 RepoDaily 独有模块,会进一步提高证据分。

100可安装/可试用性

检测到 5 个工作流步骤、4 个下一步动作,以及 3 个命令/安装信号。

51维护可信度

趋势热度为 +264 stars;如内容中有 release、issue 或维护信号,会提高维护可信度。

74生产准备度

采纳风险标记为 high,并包含 4 条安全说明与 4 条跳过条件。

100差异化

3 个机会视角、4 个替代方案,以及 3 个类型化模块支撑差异化判断。

82许可证清晰度

文章中包含许可证来源或许可证表述。

100Agent / AI 适配度

文章正文和元数据中检测到 7 个 AI/Agent 相关信号。

项目概览

Sub2API 自我定位为「AI API Gateway Platform for Subscription Quota Distribution」(面向订阅额度分发的 AI API 网关平台)。仓库描述写得很直白:让 Claude、OpenAI、Gemini、Grok 订阅统一接入,支持拼车共享、更高效分摊成本,原生工具无缝使用。后端是 Go(README 徽章锁定 Go 1.26.5),管理前端是 Vue 3.4+。它瞄准的痛点非常具体:按人头买的 AI 订阅,轻度用户额度闲置,重度用户中途撞上限额。

2026-08-23 当天,该仓库在日榜排名第 17,统计窗口内获得 264 颗星,README 还嵌入了 Trendshift 徽章(仓库编号 21823)。话题标签——2api、cc2api、antigravity2api、crs、crs2、claude-code、codex、gemini——几乎逐一对应各类编码助手的「订阅转 API」工具链。受众画像由此清晰:已经在 Claude Code 和 Codex 里干活的开发者,想把自己付费的订阅变成一个可控的 API 端点。

工程质量不马虎。除了 Go/Vue/PostgreSQL/Redis 徽章,Dockerfile 是标准三阶段构建:node:24-alpine 上用 corepack 激活 pnpm@9(注释写明「与 CI 一致、保证可复现」)编译前端;golang:1.26.6-alpine 上以 CGO_ENABLED=0 交叉编译后端;最终镜像落在 alpine:3.21。前端产物通过 embed 构建标签嵌入 internal/web/dist,一个进程同时提供 API 与管理界面。版本工程也有章法:VERSION 构建参数 > 精确 git tag > cmd/server/VERSION,由 scripts/resolve-version.sh 解析。

真正让这个仓库显得特别的是治理部分的坦率。README 开篇就是「Important Notice」:使用本项目的行为可能违反 Anthropic 及其他上游服务商的服务条款;项目仅供技术学习与研究;开发者从未授权任何商业运营;封号、服务中断、数据丢失等一切后果由用户自行承担。代码采用 GNU LGPL-3.0 授权。扎实的构建工程与直白的法律警告,这两件事一起构成了判断该项目的全部前提。

解决什么问题

  • 按人头订阅导致轻度用户额度闲置,重度用户任务中途撞上限额。
  • Claude Code、Codex 这类原生客户端绑定具体账号,共享只能靠手工传凭证。
  • 商业中转服务对用户已用订阅付费过的模型能力再次收费。
  • 小团体缺少一个自建的中间层,既计量共享额度,又不必把凭证交给第三方。

工作原理

  1. 自部署平台:Go 1.26.5 后端 + 内嵌 Vue 3.4+ 管理前端,外部依赖 PostgreSQL 15+ 与 Redis 7+(README 徽章)。
  2. 在网关中登记上游订阅账号(Claude、OpenAI、Gemini、Grok),由网关对外提供统一 API 接入面。
  3. 成员通过签发的 API 访问共享额度池(拼车模式),订阅成本由群体分摊。
  4. 把 Claude Code、Codex 等原生工具指向网关,成员无需各自登录账号,即描述中的「原生工具无缝使用」。
  5. 管理员使用内置的合规界面:Dockerfile 显示 LegalDocumentView.vue 在构建期导入 docs/legal/*.md,把法律文档编译进管理端。

产品演示与界面预览

Sub2API README 合作伙伴区展示的 Nagora 标志
Nagora 合作伙伴 Logo — README 在 assets/partners/logos/ 下放置了 Nagora 等合作伙伴标志,与赞助区同属一个目录,展示项目周边的商业服务。 README.md image
Sub2API README 合作伙伴区展示的 Qiniu AI 标志
Qiniu AI 合作伙伴 Logo — Qiniu AI 等合作伙伴标志说明围绕这个自建网关聚集了一批商业中转与云服务。 README.md image

架构解读:三阶段 Dockerfile 说明了什么

第一阶段跑在 node:24-alpine,通过 corepack 激活 pnpm@9,注释明确「与 CI 一致、保证构建可复现」。依赖从 frontend/package.json 与 frontend/pnpm-lock.yaml 以 --frozen-lockfile 安装后构建 Vue 应用。一个耐人寻味的细节:Dockerfile 注释指出 LegalDocumentView.vue——即管理端合规门(admin-compliance gate)——在构建期以 ?raw 方式导入 docs/legal/*.md,因此 docs/legal 目录必须与 frontend/ 并列放在镜像里。法律文本是被编译进去的产物,不是事后补的文档。

第二阶段在 golang:1.26.6-alpine 上运行 Go 工具链,先复制 backend/go.mod 与 backend/go.sum 以利用层缓存,再用 CGO_ENABLED=0 交叉编译(GOOS/GOARCH 取自 buildx),以 -tags embed 构建并用 -ldflags="-s -w" 裁剪,前端产物复制进 internal/web/dist。第三阶段落在 alpine:3.21。文件还声明了默认构建参数 GOPROXY=https://goproxy.cn 与 GOSUMDB=sum.golang.google.cn——便于中国大陆网络下的可复现构建——以及数据库侧的 POSTGRES_IMAGE=postgres:18-alpine。

部署须知:你需要自备的技术栈

  • 后端 Go 1.26.5、前端 Vue 3.4+,以 README 徽章为准。
  • PostgreSQL 15+ 与 Redis 7+ 是必须的外部服务,不随项目打包。
  • Docker 是官方打包路径(「Docker Ready」徽章;多阶段 Dockerfile 位于仓库根目录)。
  • 前端嵌入 Go 二进制(internal/web/dist,embed 标签),无需单独的静态文件服务器。
  • 版本号优先级明确:VERSION 构建参数 > 精确 git tag > cmd/server/VERSION,由 scripts/resolve-version.sh 解析。
  • 默认 GOPROXY(goproxy.cn)与 GOSUMDB(sum.golang.google.cn)构建参数偏向中国大陆网络的稳定构建。

维护与法律风险解读

  • README 的 Important Notice 点名 Anthropic 及其他上游服务商:使用本项目可能违反其服务条款。
  • 开发者声明从未授权任何基于本项目的商业运营,相关纠纷与损失由运营者自担。
  • 免责声明明确覆盖封号、服务中断、数据丢失,全部由用户承担。
  • LGPL-3.0 第 4 条允许按自选条款发布组合作品,但须显著声明使用了本库、随附许可证副本,并保留对本库部分的修改与反向工程权利。
  • 版本解析机制(构建参数 > git tag > cmd/server/VERSION)表明存在 CI 驱动的发布流程,而非随意打包。

谁适合关注

适合关注

  • 已为 Claude、OpenAI、Gemini 或 Grok 订阅付费、想池化额度分摊一张账单的小团体。
  • 习惯用 Docker 自建、能运维 Go + PostgreSQL 15+ + Redis 7+ 的自托管用户。
  • 希望用单一端点替代每人一套账号登录的 Claude Code、Codex 用户。
  • 研究网关设计的人:README 定位为技术学习与研究用途,采用 LGPL-3.0 授权。

可以先跳过

  • 上游服务商条款禁止账号或 API 共享的人——README 自己就标了可能违反 Anthropic 等条款。
  • 商业运营者:开发者明确声明未授权任何基于本项目的商业行为。
  • 需要供应商兜底的团队——免责声明对封号、中断、数据损失概不负责。
  • 不愿自己运维 PostgreSQL 与 Redis 实例的人。

风险与注意事项

高

项目自己的文档就是最强的风险声明:警告使用可能违反 Anthropic 等上游条款、概不承担责任、且未授权任何商业运营。

  • README 的 Important Notice 原文写明使用本项目「可能违反 Anthropic 及其他上游服务商的服务条款」。
  • 免责声明把封号、服务中断、数据丢失的全部后果划给用户。
  • 开发者声明从未授权任何基于本项目的商业运营。
  • 拼车模式放大爆炸半径:一个上游封号可能同时切断整个群体的访问。
  • 源码包中没有安全审计或漏洞披露政策文档,把真实凭证交给网关前请自行完成审查。
  • 网关必然存储多家上游订阅凭证,PostgreSQL 15+ 与 Redis 7+ 实例的加固因此变得关键。
  • 构建产物是 CGO_ENABLED=0 的静态二进制,最终镜像为最小化的 alpine:3.21,相比完整系统镜像缩小了运行面。
  • 管理端合规门(LegalDocumentView.vue)把 docs/legal/*.md 渲染进管理界面,法律文档对运营者可见而非埋在仓库里。

替代方案比较

方案适用场景代价
LiteLLM (Proxy)
想用一个 OpenAI 格式端点统一多家供应商、管理密钥与预算,但不需要订阅池化时。开源自托管;按上游用量付费。
one-api
想要一个久经考验的自托管中转管理面板,管理令牌式账号时。开源自托管;按上游用量付费。
OpenRouter
偏好托管的模型目录、按 token 计费、完全不自建时。按 token 付费;无需自托管。
赞助中转服务(CCTK.AI、OpenModel、ETok.ai)
想要兼容 Claude Code 与 Codex 的托管中转,即 README 赞助区宣传的那类服务时。付费套餐;README 内含返利注册链接。

这个趋势说明了什么

小团队的额度拼车

三到十人的团队若各自购买 Claude、OpenAI、Gemini、Grok 席位,可以合并为池化访问,让重度用户吸收闲置额度。

先读服务商用户协议——README 把条款风险全部划给用户——再只用一个订阅跑通网关,之后才邀请成员。

订阅开支合并

网关让池化后的用量落在技术栈本来就要求的 PostgreSQL 15+ 数据库里,一张共享账单变得可审计。

用一个订阅跑两周试点,把按人头开的发票与网关记录的池化用量做对比。

合规优先的内部中转

由于 LegalDocumentView.vue 把 docs/legal/*.md 编译进管理界面,法务审查可以随构建一起发布,而不是散落在 wiki 里。

让法务审阅 docs/legal 目录与上游条款,确认后再启用任何共享账号,并把签署记录写进同一批文档。

下一步建议

在 Docker 里跑一个单订阅试点

用一个「丢了也不心疼」的账号先验证技术栈与风险承受度,再让群体依赖它。

  1. 先读 README 的 Important Notice 与你的服务商用户协议;项目声明一切后果由用户承担。
  2. 按 README 徽章准备 PostgreSQL 15+ 与 Redis 7+,再构建 Docker 镜像——多阶段 Dockerfile 产出一个 CGO_ENABLED=0 二进制,前端已嵌入 internal/web/dist。
  3. 登记一个损失可承受的订阅账号;免责声明点名封号属于用户自担后果。
  4. 把 Claude Code 这类原生客户端指向网关,跑两周并记录用量,之后才邀请更多成员。

RepoDaily 判断

技术上可信、态度上罕见地坦诚:三阶段 Docker 构建、三语文档、LGPL-3.0 授权,包着一个 README 自己都承认可能违反上游条款的用途。只有读过条款并接受封号风险才应采用;否则把它当作自建网关工程的参考实现更合适。

信息来源