sub2api
SHA-256开源的 AI API 中转网关,把 Claude、OpenAI、Gemini、Grok 等订阅统一转成标准 API,支持拼车共享,按份分摊成本。
把多家 AI 订阅拼车共享,统一转成 API 给工具用,省钱又省事。
核心功能
- 多订阅统一接入:Claude / OpenAI / Gemini / Grok 订阅一键接入,统一输出为 OpenAI 兼容 API
- 拼车共享机制:支持多用户共享一份订阅,按配额分摊成本,大幅降低人均费用
- 原生工具兼容:Claude Code、Codex、Gemini CLI 等主流 AI 编程工具开箱即用
- 自托管部署:基于 Docker 一键部署,数据自主可控,支持 PostgreSQL + Redis 生产级架构
- Web 管理面板:基于 Vue 3 的可视化面板,成员管理、配额分配、用量统计一目了然
避坑指南
- •使用本项目可能违反 Anthropic 等上游服务商的服务条款,存在封号风险,后果由用户自行承担
- •仅限技术学习和研究用途,请遵守当地法律法规,禁止任何形式的商业运营
- •项目开发者从未授权任何个人或组织进行商业运营,谨防打着 sub2api 旗号的收费服务
- •部署时请务必先仔细阅读 README 中的免责声明,确认理解后再使用
适用场景
- 团队协作:团队内多人共享一份 Claude 订阅,统一走内部 API 网关,成本透明、按量分配
- 个人开发者:把多平台订阅统一成一个 API Key,在不同 AI 编程工具间无缝切换
详细介绍
Sub2API 是一款开源 AI API 网关平台,将 Claude、OpenAI、Gemini、Grok 等主流 AI 订阅统一接入到一个 API 入口。它的核心创新是订阅配额分配与拼车共享机制:多人共享一份官方订阅,大幅降低人均使用成本。与 One API 等侧重 Token 计费和密钥管理的传统中转项目不同,Sub2API 原生支持 OAuth 订阅连接,特别适合团队拼车共享官方订阅。它无缝兼容 Claude Code、Codex、Gemini CLI 等主流编码工具,同时提供托管站点和 Docker 自托管两种部署方式。技术栈基于 Go 1.26、Vue 3、PostgreSQL 15+ 和 Redis 7+,开箱即用。
标签
快速上手
安装软件
双击下载的安装程序,按提示完成安装
使用 Docker Compose 部署:创建 docker-compose.yml,配置 PostgreSQL 和 Redis 连接信息
获取官方订阅的 OAuth Token:在 Claude / OpenAI / Gemini 官方平台登录并授权
在管理面板中添加订阅并设置拼车配额,生成自己的 API Key
- 使用 Docker Compose 部署:创建 docker-compose.yml,配置 PostgreSQL 和 Redis 连接信息
- 获取官方订阅的 OAuth Token:在 Claude / OpenAI / Gemini 官方平台登录并授权
- 在管理面板中添加订阅并设置拼车配额,生成自己的 API Key
已提供 SHA-256 校验码,下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
ae6b2e7ae30d784e7d7cbda119bcbc0b70f8e9334570f958bb255dad453adc17该校验码提取自 GitHub Release 页面,下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
在 Docker 环境中执行 docker compose down 停止并移除容器;如需彻底清理数据,使用 docker volume rm 删除相关数据卷。若为源码部署,直接删除源码目录及对应的 PostgreSQL 数据库和 Redis 数据即可。
无额外依赖
下载后即可直接使用,无需安装其他运行环境