Claude Relay Service

[!CAUTION] 安全更新通知：v1.1.248 及以下版本存在严重的管理员认证绕过漏洞，攻击者可未授权访问管理面板。

请立即更新到 v1.1.249+ 版本，或迁移到新一代项目 CRS 2.0 (sub2api)

🔐 自行搭建Claude API中转服务，支持多账户管理

English • 快速开始 • 演示站点 • 公告频道

---

⚠️ 重要提醒

使用本项目前请仔细阅读：

🚨 服务条款风险: 使用本项目可能违反Anthropic的服务条款。请在使用前仔细阅读Anthropic的用户协议，使用本项目的一切风险由用户自行承担。

📖 免责声明: 本项目仅供技术学习和研究使用，作者不对因使用本项目导致的账户封禁、服务中断或其他损失承担任何责任。

🤔 这个项目适合你吗？

• 🌍 地区限制: 所在地区无法直接访问Claude Code服务？
• 🔒 隐私担忧: 担心第三方镜像服务会记录或泄露你的对话内容？
• 👥 成本分摊: 想和朋友一起分摊Claude Code Max订阅费用？
• ⚡ 稳定性: 第三方镜像站经常故障不稳定，影响效率 ？

如果有以上困惑，那这个项目可能适合你。

适合的场景

✅ 找朋友拼车: 三五好友一起分摊Claude Code Max订阅
✅ 隐私敏感: 不想让第三方镜像看到你的对话内容
✅ 技术折腾: 有基本的技术基础，愿意自己搭建和维护
✅ 稳定需求: 需要长期稳定的Claude访问，不想受制于镜像站
✅ 地区受限: 无法直接访问Claude官方服务

---

💭 为什么要自己搭？

现有镜像站可能的问题

• 🕵️ 隐私风险: 你的对话内容都被人家看得一清二楚，商业机密什么的就别想了
• 🐌 性能不稳: 用的人多了就慢，高峰期经常卡死
• 💰 价格不透明: 不知道实际成本

自建的好处

• 🔐 数据安全: 所有接口请求都只经过你自己的服务器，直连Anthropic API
• ⚡ 性能可控: 就你们几个人用，Max 200刀套餐基本上可以爽用Opus
• 💰 成本透明: 用了多少token一目了然，按官方价格换算了具体费用
• 📊 监控完整: 使用情况、成本分析、性能监控全都有

---

🚀 核心功能

基础功能

• ✅ 多账户管理: 可以添加多个Claude账户自动轮换
• ✅ 自定义API Key: 给每个人分配独立的Key
• ✅ 使用统计: 详细记录每个人用了多少token

高级功能

• 🔄 智能切换: 账户出问题自动换下一个
• 🚀 性能优化: 连接池、缓存，减少延迟
• 📊 监控面板: Web界面查看所有数据
• 🛡️ 安全控制: 访问限制、速率控制、客户端限制
• 🌐 代理支持: 支持HTTP/SOCKS5代理

---

📋 部署要求

硬件要求（最低配置）

• CPU: 1核心就够了
• 内存: 512MB（建议1GB）
• 硬盘: 30GB可用空间
• 网络: 能访问到Anthropic API（建议使用US地区的机器）
• 建议: 2核4G的基本够了，网络尽量选回国线路快一点的（为了提高速度，建议不要开代理或者设置服务器的IP直连）
• 经验: 阿里云、腾讯云的海外主机经测试会被Cloudflare拦截，无法直接访问claude api

软件要求

• Node.js 18或更高版本
• Redis 6或更高版本
• 操作系统: 建议Linux

费用估算

• 服务器: 轻量云服务器，一个月30-60块
• Claude订阅: 看你怎么分摊了
• 其他: 域名（可选）

---

🚀 脚本部署（推荐）

推荐使用管理脚本进行一键部署，简单快捷，自动处理所有依赖和配置。

快速安装

curl -fsSL https://pincc.ai/manage.sh -o manage.sh && chmod +x manage.sh && ./manage.sh install

脚本功能

• ✅ 一键安装: 自动检测系统环境，安装 Node.js 18+、Redis 等依赖
• ✅ 交互式配置: 友好的配置向导，设置端口、Redis 连接等
• ✅ 自动启动: 安装完成后自动启动服务并显示访问地址
• ✅ 便捷管理: 通过 crs 命令随时管理服务状态

管理命令

crs install   # 安装服务
crs start     # 启动服务
crs stop      # 停止服务
crs restart   # 重启服务
crs status    # 查看状态
crs update    # 更新服务
crs uninstall # 卸载服务

安装示例

$ crs install

# 会依次询问：
安装目录 (默认: ~/claude-relay-service):
服务端口 (默认: 3000): 8080
Redis 地址 (默认: localhost):
Redis 端口 (默认: 6379):
Redis 密码 (默认: 无密码):

# 安装完成后自动启动并显示：
服务已成功安装并启动！

访问地址：
  本地 Web: http://localhost:8080/web
  公网 Web: http://YOUR_IP:8080/web

管理员账号信息已保存到: data/init.json

系统要求

• 支持系统: Ubuntu/Debian、CentOS/RedHat、Arch Linux、macOS
• 自动安装 Node.js 18+ 和 Redis
• Redis 使用系统默认位置，数据独立于应用

---

📦 手动部署

第一步：环境准备

Ubuntu/Debian用户：

# 安装Node.js
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 安装Redis
sudo apt update
sudo apt install redis-server
sudo systemctl start redis-server

CentOS/RHEL用户：

# 安装Node.js
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs

# 安装Redis
sudo yum install redis
sudo systemctl start redis

第二步：下载和配置

# 下载项目
git clone https://github.com/Wei-Shaw//claude-relay-service.git
cd claude-relay-service

# 安装依赖
npm install