MORPH
SIGN IN SIGN UP
Wei-Shaw / claude-relay-service UNCLAIMED

CRS-自建Claude Code镜像，一站式开源中转服务，让 Claude、OpenAI、Gemini、Droid 订阅统一接入，支持拼车共享，更高效分摊成本，原生工具无缝使用。

0 0 1 JavaScript
Normal View History Raw
first commit
2025-07-14 18:14:13 +08:00
# Claude Relay Service
<div align="center">
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
[![Redis](https://img.shields.io/badge/Redis-6+-red.svg)](https://redis.io/)
[![Docker](https://img.shields.io/badge/Docker-Ready-blue.svg)](https://www.docker.com/)
update README
2025-07-14 18:30:37 +08:00
**🔐 自行搭建Claude API中转服务，支持多账户管理**
first commit
2025-07-14 18:14:13 +08:00
add preview
2025-07-15 09:57:37 +08:00
[English](#english) • [中文文档](#中文文档) • [📸 界面预览](docs/preview.md)
first commit
2025-07-14 18:14:13 +08:00
</div>
---
## ⚠️ 重要提醒
**使用本项目前请仔细阅读：**
🚨 **服务条款风险**: 使用本项目可能违反Anthropic的服务条款。请在使用前仔细阅读Anthropic的用户协议，使用本项目的一切风险由用户自行承担。
📖 **免责声明**: 本项目仅供技术学习和研究使用，作者不对因使用本项目导致的账户封禁、服务中断或其他损失承担任何责任。
---
update readme
2025-07-15 11:06:54 +08:00
> 💡 **感谢 [@vista8](https://x.com/vista8) 的推荐！**
update readme
2025-07-15 11:03:09 +08:00
>
> 如果你对Vibe coding感兴趣，推荐关注：
update readme
2025-07-15 11:09:43 +08:00
>
update readme
2025-07-15 11:03:09 +08:00
> - 🐦 **X**: [@vista8](https://x.com/vista8) - 分享前沿技术动态
> - 📱 **公众号**: 向阳乔木推荐看
---
first commit
2025-07-14 18:14:13 +08:00
## 🤔 这个项目适合你吗？
- 🌍 **地区限制**: 所在地区无法直接访问Claude Code服务？
- 🔒 **隐私担忧**: 担心第三方镜像服务会记录或泄露你的对话内容？
- 👥 **成本分摊**: 想和朋友一起分摊Claude Code Max订阅费用？
- ⚡ **稳定性**: 第三方镜像站经常故障不稳定，影响效率 ？
如果有以上困惑，那这个项目可能适合你。
### 适合的场景
✅ **找朋友拼车**: 三五好友一起分摊Claude Code Max订阅，Opus爽用
✅ **隐私敏感**: 不想让第三方镜像看到你的对话内容
update README
2025-07-14 18:45:30 +08:00
✅ **技术折腾**: 有基本的技术基础，愿意自己搭建和维护
first commit
2025-07-14 18:14:13 +08:00
✅ **稳定需求**: 需要长期稳定的Claude访问，不想受制于镜像站
✅ **地区受限**: 无法直接访问Claude官方服务
### 不适合的场景
❌ **纯小白**: 完全不懂技术，连服务器都不会买
update README
2025-07-14 18:30:37 +08:00
❌ **偶尔使用**: 一个月用不了几次，没必要折腾
❌ **注册问题**: 无法自行注册Claude账号
❌ **支付问题**: 没有支付渠道订阅Claude Code
first commit
2025-07-14 18:14:13 +08:00
update README
2025-07-14 18:58:26 +08:00
**如果你只是普通用户，对隐私要求不高，随便玩玩、想快速体验 Claude，那选个你熟知的镜像站会更合适。**
first commit
2025-07-14 18:14:13 +08:00
---
## 💭 为什么要自己搭？
### 现有镜像站可能的问题
- 🕵️ **隐私风险**: 你的对话内容都被人家看得一清二楚，商业机密什么的就别想了
- 🐌 **性能不稳**: 用的人多了就慢，高峰期经常卡死
- 💰 **价格不透明**: 不知道实际成本
### 自建的好处
- 🔐 **数据安全**: 所有接口请求都只经过你自己的服务器，直连Anthropic API
- ⚡ **性能可控**: 就你们几个人用，Max 200刀套餐基本上可以爽用Opus
- 💰 **成本透明**: 用了多少token一目了然，按官方价格换算了具体费用
- 📊 **监控完整**: 使用情况、成本分析、性能监控全都有
---
## 🚀 核心功能
add preview
2025-07-15 09:57:37 +08:00
> 📸 **[点击查看界面预览](docs/preview.md)** - 查看Web管理界面的详细截图
first commit
2025-07-14 18:14:13 +08:00
### 基础功能
- ✅ **多账户管理**: 可以添加多个Claude账户自动轮换
- ✅ **自定义API Key**: 给每个人分配独立的Key
- ✅ **使用统计**: 详细记录每个人用了多少token
### 高级功能
- 🔄 **智能切换**: 账户出问题自动换下一个
- 🚀 **性能优化**: 连接池、缓存，减少延迟
- 📊 **监控面板**: Web界面查看所有数据
- 🛡️ **安全控制**: 访问限制、速率控制
- 🌐 **代理支持**: 支持HTTP/SOCKS5代理
---
## 📋 部署要求
### 硬件要求（最低配置）
- **CPU**: 1核心就够了
- **内存**: 512MB（建议1GB）
- **硬盘**: 30GB可用空间
- **网络**: 能访问到Anthropic API（建议使用US地区的机器）
- **建议**: 2核4G的基本够了，网络尽量选回国线路快一点的（为了提高速度，建议不要开代理或者设置服务器的IP直连）
### 软件要求
- **Node.js** 18或更高版本
- **Redis** 6或更高版本
- **操作系统**: 建议Linux
### 费用估算
update README
2025-07-14 18:30:37 +08:00
- **服务器**: 轻量云服务器，一个月30-60块
first commit
2025-07-14 18:14:13 +08:00
- **Claude订阅**: 看你怎么分摊了
update README
2025-07-14 18:30:37 +08:00
- **其他**: 域名（可选）
first commit
2025-07-14 18:14:13 +08:00
---
update README
2025-07-14 18:45:30 +08:00
## 📦 手动部署
first commit
2025-07-14 18:14:13 +08:00
### 第一步：环境准备
**Ubuntu/Debian用户：**
```bash
# 安装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用户：**
```bash
# 安装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
```
### 第二步：下载和配置
```bash
# 下载项目
update readme
2025-07-15 22:25:09 +08:00
git clone https://github.com/Wei-Shaw/claude-relay-service.git
first commit
2025-07-14 18:14:13 +08:00
cd claude-relay-service
# 安装依赖
npm install
# 复制配置文件（重要！）
cp config/config.example.js config/config.js
cp .env.example .env
```
### 第三步：配置文件设置
**编辑 `.env` 文件：**
```bash
# 这两个密钥随便生成，但要记住
JWT_SECRET=你的超级秘密密钥
ENCRYPTION_KEY=32位的加密密钥随便写
# Redis配置
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
```
**编辑 `config/config.js` 文件：**
```javascript
module.exports = {
server: {
port: 3000, // 服务端口，可以改
host: '0.0.0.0' // 不用改
},
redis: {
host: '127.0.0.1', // Redis地址
port: 6379 // Redis端口
},
// 其他配置保持默认就行
}
```
### 第四步：启动服务
```bash
# 初始化
update README
2025-07-14 18:35:33 +08:00
npm run setup # 会随机生成后台账号密码信息，存储在 data/Init.json
first commit
2025-07-14 18:14:13 +08:00
# 启动服务
npm run service:start:daemon # 后台运行（推荐）
# 查看状态
npm run service:status
```
---
## 🎮 开始使用
### 1. 打开管理界面
浏览器访问：`http://你的服务器IP:3000/web`
update README
2025-07-14 18:34:32 +08:00
默认管理员账号：data/Init.json 中寻找
first commit
2025-07-14 18:14:13 +08:00
### 2. 添加Claude账户
这一步比较关键，需要OAuth授权：
1. 点击「Claude账户」标签
update README
2025-07-14 18:45:30 +08:00
2. 如果你担心多个账号共用1个IP怕被封禁，可以选择设置静态代理IP（可选）
first commit
2025-07-14 18:14:13 +08:00
3. 点击「添加账户」
4. 点击「生成授权链接」，会打开一个新页面
5. 在新页面完成Claude登录和授权
6. 复制返回的Authorization Code
7. 粘贴到页面完成添加
**注意**: 如果你在国内，这一步可能需要科学上网。
### 3. 创建API Key
给每个使用者分配一个Key：
1. 点击「API Keys」标签
2. 点击「创建新Key」
3. 给Key起个名字，比如「张三的Key」
4. 设置使用限制（可选）
5. 保存，记下生成的Key
feat: 支持手动添加 Claude 账户 Access Token - 添加 OAuth 和手动输入两种账户添加方式 - 支持直接输入 Access Token 和 Refresh Token - 新增账户编辑功能，可更新 Token 和代理设置 - 优化 Token 刷新失败时的回退机制 - 改进用户体验，支持手动维护长期有效的 Token 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-15 19:28:14 +08:00
### 4. 开始使用Claude code
first commit
2025-07-14 18:14:13 +08:00
现在你可以用自己的服务替换官方API了：
feat: 支持手动添加 Claude 账户 Access Token - 添加 OAuth 和手动输入两种账户添加方式 - 支持直接输入 Access Token 和 Refresh Token - 新增账户编辑功能，可更新 Token 和代理设置 - 优化 Token 刷新失败时的回退机制 - 改进用户体验，支持手动维护长期有效的 Token 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-15 19:28:14 +08:00
**设置环境变量：**
first commit
2025-07-14 18:14:13 +08:00
```bash
feat: 支持手动添加 Claude 账户 Access Token - 添加 OAuth 和手动输入两种账户添加方式 - 支持直接输入 Access Token 和 Refresh Token - 新增账户编辑功能，可更新 Token 和代理设置 - 优化 Token 刷新失败时的回退机制 - 改进用户体验，支持手动维护长期有效的 Token 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-15 19:28:14 +08:00
export ANTHROPIC_BASE_URL="http://127.0.0.1:3000/api/" # 根据实际填写你服务器的ip地址或者域名
export ANTHROPIC_AUTH_TOKEN="后台创建的API密钥"
first commit
2025-07-14 18:14:13 +08:00
```
---
## 🔧 日常维护
### 服务管理
```bash
# 查看服务状态
npm run service:status
# 查看日志
npm run service:logs
# 重启服务
npm run service:restart:daemon
# 停止服务
npm run service:stop
```
### 监控使用情况
- **Web界面**: `http://你的域名:3000/web` - 查看使用统计
- **健康检查**: `http://你的域名:3000/health` - 确认服务正常
- **日志文件**: `logs/` 目录下的各种日志文件
### 常见问题处理
**Redis连不上？**
```bash
# 检查Redis是否启动
redis-cli ping
# 应该返回 PONG
```
**OAuth授权失败？**
- 检查代理设置是否正确
- 确保能正常访问 claude.ai
- 清除浏览器缓存重试
**API请求失败？**
- 检查API Key是否正确
- 查看日志文件找错误信息
- 确认Claude账户状态正常
---
update README
2025-07-14 18:30:37 +08:00
## 🛠️ 进阶
first commit
2025-07-14 18:14:13 +08:00
update README
2025-07-14 18:30:37 +08:00
### 生产环境部署建议（重要！）
first commit
2025-07-14 18:14:13 +08:00
update README
2025-07-14 18:30:37 +08:00
**强烈建议使用nginx反向代理 + SSL证书**
update README
2025-07-14 18:46:58 +08:00
建议使用nginx反向代理并配置SSL证书：（以下为Nginx示例，如不想折腾可以选择安装面板进行操作，比如宝塔、1panel等）
update README
2025-07-14 18:30:37 +08:00
**1. 安装nginx和获取SSL证书**
```bash
# Ubuntu/Debian
sudo apt install nginx certbot python3-certbot-nginx
# 获取免费SSL证书（以Let's Encrypt为例）
sudo certbot --nginx -d your-domain.com
first commit
2025-07-14 18:14:13 +08:00
```
update README
2025-07-14 18:30:37 +08:00
**2. nginx配置示例**
创建 `/etc/nginx/sites-available/claude-relay` 配置文件：
```nginx
server {
listen 80;
server_name your-domain.com;
return 301 https://$server_name$request_uri;
}
first commit
2025-07-14 18:14:13 +08:00
update README
2025-07-14 18:30:37 +08:00
server {
listen 443 ssl http2;
server_name your-domain.com;
# SSL配置
ssl_certificate /etc/letsencrypt/live/your-domain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/your-domain.com/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers HIGH:!aNULL:!MD5;
# 安全头
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Frame-Options DENY;
add_header X-Content-Type-Options nosniff;
# 反向代理配置
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_cache_bypass $http_upgrade;
# 超时设置
proxy_connect_timeout 60s;
proxy_send_timeout 60s;
proxy_read_timeout 60s;
}
}
```
first commit
2025-07-14 18:14:13 +08:00
update README
2025-07-14 18:30:37 +08:00
**3. 启用配置**
first commit
2025-07-14 18:14:13 +08:00
```bash
update README
2025-07-14 18:30:37 +08:00
# 启用站点
sudo ln -s /etc/nginx/sites-available/claude-relay /etc/nginx/sites-enabled/
# 测试配置
sudo nginx -t
first commit
2025-07-14 18:14:13 +08:00
update README
2025-07-14 18:30:37 +08:00
# 重启nginx
sudo systemctl restart nginx
```
first commit
2025-07-14 18:14:13 +08:00
update README
2025-07-14 18:30:37 +08:00
**4. 更新服务配置**
first commit
2025-07-14 18:14:13 +08:00
update README
2025-07-14 18:30:37 +08:00
修改你的服务配置，让它只监听本地：
```javascript
// config/config.js
module.exports = {
server: {
port: 3000,
host: '127.0.0.1' // 只监听本地，通过nginx代理
}
// ... 其他配置
}
first commit
2025-07-14 18:14:13 +08:00
```
update README
2025-07-14 18:30:37 +08:00
**5. 使用HTTPS API**
first commit
2025-07-14 18:14:13 +08:00
update README
2025-07-14 18:30:37 +08:00
配置完成后，你的API地址变为：
```bash
curl https://your-domain.com/api/v1/messages \
-H "x-api-key: cr_your-key" \
-H "content-type: application/json" \
-d '{"model":"claude-3-sonnet-20240229","messages":[{"role":"user","content":"你好"}]}'
```
**安全优势：**
- 🔒 **数据加密**: 所有API请求都通过HTTPS加密传输
- 🛡️ **隐藏端口**: 不直接暴露服务端口，降低攻击面
- 🚀 **更好性能**: nginx的静态文件服务和缓存能力
- 📊 **访问日志**: nginx提供详细的访问日志和监控
first commit
2025-07-14 18:14:13 +08:00
---
## 💡 使用建议
### 账户管理
- **定期检查**: 每周看看账户状态，及时处理异常
update README
2025-07-14 18:30:37 +08:00
- **合理分配**: 可以给不同的人分配不同的apikey，可以根据不同的apikey来分析用量
first commit
2025-07-14 18:14:13 +08:00
### 安全建议
update README
2025-07-14 18:30:37 +08:00
- **使用HTTPS**: 强烈建议配置nginx反向代理和SSL证书，确保数据传输安全
first commit
2025-07-14 18:14:13 +08:00
- **定期备份**: 重要配置和数据要备份
- **监控日志**: 定期查看异常日志
- **更新密钥**: 定期更换JWT和加密密钥
update README
2025-07-14 18:30:37 +08:00
- **防火墙设置**: 只开放必要的端口（80, 443），隐藏直接服务端口
first commit
2025-07-14 18:14:13 +08:00
---
## 🆘 遇到问题怎么办？
### 自助排查
1. **查看日志**: `logs/` 目录下的日志文件
2. **检查配置**: 确认配置文件设置正确
3. **测试连通性**: 用 curl 测试API是否正常
4. **重启服务**: 有时候重启一下就好了
### 寻求帮助
- **GitHub Issues**: 提交详细的错误信息
- **查看文档**: 仔细阅读错误信息和文档
- **社区讨论**: 看看其他人是否遇到类似问题
---
## 📄 许可证
本项目采用 [MIT许可证](LICENSE)。
---
<div align="center">
**⭐ 觉得有用的话给个Star呗，这是对作者最大的鼓励！**
**🤝 有问题欢迎提Issue，有改进建议欢迎PR**
</div>
Reference in New Issue Copy Permalink