核心问题: 你能否接受上游服务条款与封号风险,换取一个自建统一入口背后的共享订阅额度?
RepoDaily 采用评分
RepoDaily 将该项目的采用分评为 87/100(强):分数来自文章来源、安装路径、生产风险、差异化、许可证清晰度以及 AI/Agent 适配度。
包含 5 个来源、覆盖 4 类来源;如有 RepoDaily 独有模块,会进一步提高证据分。
检测到 5 个工作流步骤、4 个下一步动作,以及 3 个命令/安装信号。
趋势热度为 +264 stars;如内容中有 release、issue 或维护信号,会提高维护可信度。
采纳风险标记为 high,并包含 4 条安全说明与 4 条跳过条件。
3 个机会视角、4 个替代方案,以及 3 个类型化模块支撑差异化判断。
文章中包含许可证来源或许可证表述。
文章正文和元数据中检测到 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 授权。扎实的构建工程与直白的法律警告,这两件事一起构成了判断该项目的全部前提。
为什么现在变热
- 统计窗口内 264 颗星、2026-08-23 日榜第 17 名,README 内嵌 Trendshift 徽章(仓库编号 21823)。
- 直击订阅成本:把 Claude、OpenAI、Gemini、Grok 额度池化,一群人分摊一张账单,而不是各买各的席位。
- 话题标签 cc2api、antigravity2api、crs、crs2、codex、claude-code 把它锚定在围绕具体编码工具的「订阅转 API」细分赛道。
- 三语文档——README.md、README_CN.md、README_JA.md——覆盖中文与日文读者。
- 赞助位(CCTK.AI、OpenModel、ETok.ai)说明商业中转服务愿意付费触达这个项目的受众。
解决什么问题
- 按人头订阅导致轻度用户额度闲置,重度用户任务中途撞上限额。
- Claude Code、Codex 这类原生客户端绑定具体账号,共享只能靠手工传凭证。
- 商业中转服务对用户已用订阅付费过的模型能力再次收费。
- 小团体缺少一个自建的中间层,既计量共享额度,又不必把凭证交给第三方。
工作原理
- 自部署平台:Go 1.26.5 后端 + 内嵌 Vue 3.4+ 管理前端,外部依赖 PostgreSQL 15+ 与 Redis 7+(README 徽章)。
- 在网关中登记上游订阅账号(Claude、OpenAI、Gemini、Grok),由网关对外提供统一 API 接入面。
- 成员通过签发的 API 访问共享额度池(拼车模式),订阅成本由群体分摊。
- 把 Claude Code、Codex 等原生工具指向网关,成员无需各自登录账号,即描述中的「原生工具无缝使用」。
- 管理员使用内置的合规界面:Dockerfile 显示 LegalDocumentView.vue 在构建期导入 docs/legal/*.md,把法律文档编译进管理端。
产品演示与界面预览


架构解读:三阶段 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 目录与上游条款,确认后再启用任何共享账号,并把签署记录写进同一批文档。
RepoDaily 判断
技术上可信、态度上罕见地坦诚:三阶段 Docker 构建、三语文档、LGPL-3.0 授权,包着一个 README 自己都承认可能违反上游条款的用途。只有读过条款并接受封号风险才应采用;否则把它当作自建网关工程的参考实现更合适。