如何利用开源工具自建一个 Claude Relay Service,实现一个 Claude Max(或 Pro)账号的多用户共享,尤其适用于 Claude Code 的场景。这不仅能帮助团队或朋友们分摊订阅成本,还能规避账号封禁风险,并提升隐私保护。
Claude AI 作为强大的代码生成工具,其 API 访问往往受地域限制或账号使用率限制。如果有一个 Claude Max 账号,想让多个用户(例如团队成员)通过 Claude Code 等客户端工具使用它,直接共享账号容易导致封号。解决方案是通过中继服务(如 claude-relay-service)来代理请求,支持多 API Key 分发。同时,在服务器(如腾讯云)部署时,可能需要代理工具(如 Clash)来绕过网络限制,确保服务能正常访问 Anthropic API。
了解 Claude Relay Service 的核心流程
claude-relay-service 是一个自建的 Claude API 镜像服务,支持多账户管理、自定义 API Key 生成,并兼容 OpenAI 格式、Gemini-cli 和 Codex-cli。它能有效规避封号,通过 OAuth 集成快速添加账号池,并提供使用统计和监控。
核心特点
- 多账户管理:支持添加多个 Claude 账号,自动轮换使用。如果一个账号失效(如 token 过期或被封),服务会智能切换。
- 自定义 API Key:管理员可以生成多个 API Key,分发给不同用户。每 Key 可设置使用限制(如速率、并发、模型访问权限),便于共享。
- 性能与安全:内置连接池、缓存、代理支持(HTTP/SOCKS5),以及速率限制、访问控制。还提供 Web 界面监控 token 使用情况,并支持 Webhook 通知(如企业微信警报)。
- 兼容性:API 兼容 OpenAI 格式,便于集成现有工具。
添加 Claude 账号和创建 API Key 的流程
- 添加账号:通过 OAuth 授权添加 Claude 账号(推荐使用静态代理 IP 以避免 IP 相关封禁)。服务会存储账号信息,支持多账号池。
- 生成 API Key:在 Web 界面(默认 http://your-ip:3000/web)登录管理员账号,创建新 Key。配置选项包括:速率限制、并发数、允许模型、客户端限制等。
- 使用:用户在 Claude Code 等工具中配置服务 API 端点(如 http://your-server:3000/v1)和生成的 Key,即可访问 Claude 服务。
部署依赖
- 硬件:至少 1 核 CPU、512MB 内存(推荐 1GB)、30GB 磁盘;网络需能访问 Anthropic API(建议直接网上购买稳定的服务,网上不少教程)。
- 软件:Node.js 18+、Redis 6+。
- 可选:域名用于 HTTPS(通过 Caddy 反代)。
接下来,我们先处理服务器的代理环境,因为腾讯云服务器可能需要 Clash 来稳定访问外部 API。
安装 Clash 以支持订阅代理
由于 Claude API 有地域限制,在腾讯云服务器部署中继服务时,需要一个可靠的代理工具。Clash(或其变体 Mihomo)是一个优秀的开源代理客户端,支持订阅形式配置节点。这里我们使用 clash-for-linux-install 脚本,一键安装 Clash 环境,支持订阅更新和系统代理控制。