为什么要自建中转

先说几个我踩过的雷，省得你再走一遍：

  • Claude Code Max 订阅转 API：有封号风险，概率不算低。不过合理使用的话也能撑住，我自己的号两个月没出事。
  • 第三方反向代理中转 Claude、Gemini：基本秒封，别试了。我之前靠这个赚了一波，结果一下子被封了 20 多个号，血亏。
  • OpenAI 中转 Key：目前用 GPT-5.4 比较稳定，其他模型看情况。

自建的好处很直接——账号是你自己的，调用频率你自己控，不用担心别人滥用导致连坐封号。对于一人公司或者小团队来说，这就是最划算的方案。

部署前准备

开始之前就三样东西：

  1. 一台 Linux 服务器：2 核 4G 起步就够。线路推荐带 CN2 GIA 的，国内访问延迟低、速度快。我之前试过 AWS，太卡了，不推荐。
  2. 一个域名（可选但强烈建议有）：加了域名和 SSL 证书，稳定性更好，封号概率也能再降一档。
  3. 你的 Claude / OpenAI / Gemini 订阅账号。

就这些，其他的都不用操心。

用 Claude Code 部署 Claude 的中转服务

这是整个流程里最有意思的部分——让 AI 自己部署自己的中转服务。

打开 Claude Code，把下面这些信息告诉它：

  • Sub2API 的 GitHub 仓库地址
  • 你服务器的 IP 地址
  • 你的 pem 密钥文件

然后就让它干活。它会自动连接服务器、拉取镜像、安装依赖、配置数据库和 Redis，全程大概 10 分钟。如果你有域名，顺便告诉它，Nginx 或 Caddy 配置加上 HTTPS 证书也一并搞定，全自动。

不想用 Claude Code 也行，终端一行命令搞定：

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

装完之后浏览器访问你的域名或者 服务器IP:8080，直接进入 Web 管理面板。

后台配置三步走

面板界面很清爽，核心就三个操作：

添加上游账号：进入「账号管理」，点添加。Claude 和 OpenAI 都支持 OAuth 授权，按提示走一遍就行，非常简单。添加成功后状态显示「正常」就 OK。

生成 API Key：进入「API Key 管理」，点创建。这里可以精细控制——额度限制防超支、速率限制防滥用（起步建议设低点，别一上来就开高并发）、过期时间到期自动失效。生成后把 Key 复制出来。

配置到你的工具里：拿到 Key 之后，Claude Code、Opencode 或者任何支持自定义 API 地址的工具都能直接用。面板里有配置到 CLI 的文档，复制粘贴就行。配好之后跟直连体验没区别。

适合什么人用

这个项目最初就是朋友之间拼车 Claude 用的，后来才开源出来。对于独立开发者和小团队来说，它解决的是一个很实际的问题：怎么用最低成本、最稳定地调用各家大模型的 API。整个流程——买服务器、一键部署、加订阅账号、生成 Key——前后十来分钟，省下的是每个月共享 Key 的费用和封号的焦虑。

项目完全开源，MIT 协议。如果你正在被封号问题困扰，或者想给自己的 AI 工作流搭一个稳定的底座，值得花十分钟试一下。记得部署完之后先给自己的账号充值，不然服务跑不起来。