开源 · LGPL-3.0 · Go + Vue

把订阅变成 可分发 API

Sub2API 是一站式开源 AI 网关:统一接入 Claude、OpenAI、Gemini、Grok 等订阅与账号, 支持拼车共享、精确计费、智能调度,让 Claude Code / Codex 等原生工具无缝使用。

35k+GitHub Stars
7k+Forks
Go高性能后端
PG+Redis生产级依赖
# Docker Compose 快速启动
mkdir -p sub2api-deploy && cd sub2api-deploy
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash
docker compose up -d

# 访问管理台
open http://localhost:8080

# Claude Code 示例
export ANTHROPIC_BASE_URL=http://localhost:8080
export ANTHROPIC_AUTH_TOKEN=sk-your-key

核心能力

面向订阅配额分发与编程工具接入,而不只是简单 API 转发。

🔗

多账号统一接入

支持 OAuth / API Key 等多类型上游账号,集中管理 Claude、OpenAI、Gemini、Grok 等资源。

🔑

API Key 分发

为用户生成可管理的 Key,做鉴权、分组与权限控制,方便团队或拼车场景使用。

📊

Token 级计费

精确追踪用量与成本,支持并发控制、速率限制与运营看板。

⚖️

智能调度

智能选号、粘性会话、负载均衡,提升稳定性和账号利用率。

💳

内置支付

支持易支付、支付宝、微信、Stripe 等,用户可自助充值(按官方文档配置)。

🧰

原生工具友好

面向 Claude Code、Codex、Gemini CLI 等场景,尽量保持原生协议与接入方式。

和 New API 有何不同

两者都能做网关,但定位不同。选对工具,少走弯路。

维度 Sub2API New API
定位 订阅配额分发 / 拼车 通用 LLM 聚合中转
上游重点 订阅账号、OAuth、粘性会话 多厂商 API Key 渠道
典型场景 Claude Code / Codex 团队 多模型 API 计费站
技术栈 Go + Vue + PostgreSQL + Redis Go + Web + SQLite/MySQL/PG
许可证 LGPL-3.0 AGPL-3.0
⚠️ 使用前请阅读上游服务条款与当地法规。项目 README 明确提示可能存在 ToS 风险,且作者声明无商业授权。 本页仅为项目介绍落地页,不提供公共注册中转服务。

三步上线你的实例

官方不提供公共注册,需要你自己部署。推荐 Docker Compose。

1

准备环境

Linux / macOS,安装 Docker 与 Docker Compose。生产建议准备域名与 HTTPS 反代。

2

一键部署

运行官方 docker-deploy 脚本,自动生成密钥与 compose 配置,启动 PostgreSQL、Redis 与主服务。

3

配置接入

打开 :8080 完成初始化,添加上游账号,生成 API Key,把工具的 Base URL 指到你的实例。

# 脚本安装(Linux)
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash
sudo systemctl start sub2api

# 或 Docker Compose
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash
docker compose up -d

把 Sub2API 跑在你自己的服务器上

开源、可自托管、可二次定制。从 GitHub 开始,30 分钟内部署出可用网关。