Skip to content
/ Wei-Shaw-claude-relay-service Public
forked from Wei-Shaw/claude-relay-service

自建Claude Code镜像，支持Claude Code、Gemini CLI、Codex CLI，支持Claude Console接入。集成OAuth认 证、多账号池切换、自定义API密钥、OpenAI兼容格式、代理支持和智能防封机制。

pincc.ai

License

MIT license
0 stars 759 forks Branches Tags Activity
Star

BlockPILabs/Wei-Shaw-claude-relay-service

BranchesTags
 
 

Repository files navigation

Claude Relay Service

License: MIT Node.js Redis Docker Docker Build Docker Pulls

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

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

⭐ 如果觉得有用，点个Star支持一下吧！

开源不易，你的Star是我持续更新的动力 🚀
欢迎加入 Telegram 公告频道 获取最新动态

⚠️ 重要提醒

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

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

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

🤔 这个项目适合你吗？

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

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

💡 Claude Code 拼车服务 目前有两个稳定的 Claude Code Max 20X 200刀 拼车渠道：

  1. PinCC - 项目官方运营的拼车服务：https://pincc.ai/
  2. CToK - 社区认可的合作伙伴服务：https://ctok.ai/

适合的场景

✅ 找朋友拼车: 三五好友一起分摊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

# 复制配置文件（重要！）
cp config/config.example.js config/config.js
cp .env.example .env

第三步：配置文件设置

编辑 .env 文件：

# 这两个密钥随便生成，但要记住
JWT_SECRET=你的超级秘密密钥
ENCRYPTION_KEY=32位的加密密钥随便写

# Redis配置
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=

编辑 config/config.js 文件：

module.exports = {
  server: {
    port: 3000, // 服务端口，可以改
    host: '0.0.0.0' // 不用改
  },
  redis: {
    host: '127.0.0.1', // Redis地址
    port: 6379 // Redis端口
  }
  // 其他配置保持默认就行
}

第四步：安装前端依赖并构建

# 安装前端依赖
npm run install:web

# 构建前端（生成 dist 目录）
npm run build:web

第五步：启动服务

# 初始化
npm run setup # 会随机生成后台账号密码信息，存储在 data/init.json
# 或者通过环境变量预设管理员凭据：
# export ADMIN_USERNAME=cr_admin_custom
# export ADMIN_PASSWORD=your-secure-password

# 启动服务
npm run service:start:daemon   # 后台运行

# 查看状态
npm run service:status

🐳 Docker 部署

Docker compose

第一步：下载构建docker-compose.yml文件的脚本并执行

curl -fsSL https://pincc.ai/crs-compose.sh -o crs-compose.sh && chmod +x crs-compose.sh && ./crs-compose.sh

第二步：启动

docker-compose up -d

Docker Compose 配置

docker-compose.yml 已包含：

  • ✅ 自动初始化管理员账号
  • ✅ 数据持久化（logs和data目录自动挂载）
  • ✅ Redis数据库
  • ✅ 健康检查
  • ✅ 自动重启

环境变量说明

必填项

  • JWT_SECRET: JWT密钥，至少32个字符
  • ENCRYPTION_KEY: 加密密钥，必须是32个字符

可选项

  • ADMIN_USERNAME: 管理员用户名（不设置则自动生成）
  • ADMIN_PASSWORD: 管理员密码（不设置则自动生成）
  • LOG_LEVEL: 日志级别（默认：info）
  • 更多配置项请参考 .env.example 文件

管理员凭据获取方式

  1. 查看容器日志

    docker logs claude-relay-service

  2. 查看挂载的文件

    cat ./data/init.json

  3. 使用环境变量预设

    # 在 .env 文件中设置
ADMIN_USERNAME=cr_admin_custom
ADMIN_PASSWORD=your-secure-password

🎮 开始使用

1. 打开管理界面

浏览器访问：http://你的服务器IP:3000/web

管理员账号：

  • 自动生成：查看 data/init.json
  • 环境变量预设：通过 ADMIN_USERNAME 和 ADMIN_PASSWORD 设置
  • Docker 部署：查看容器日志 docker logs claude-relay-service

2. 添加Claude账户

这一步比较关键，需要OAuth授权：

  1. 点击「Claude账户」标签
  2. 如果你担心多个账号共用1个IP怕被封禁，可以选择设置静态代理IP（可选）
  3. 点击「添加账户」
  4. 点击「生成授权链接」，会打开一个新页面
  5. 在新页面完成Claude登录和授权
  6. 复制返回的Authorization Code
  7. 粘贴到页面完成添加

注意: 如果你在国内，这一步可能需要科学上网。

3. 创建API Key

给每个使用者分配一个Key：

  1. 点击「API Keys」标签
  2. 点击「创建新Key」
  3. 给Key起个名字，比如「张三的Key」
  4. 设置使用限制（可选）：
    • 速率限制: 限制每个时间窗口的请求次数和Token使用量
    • 并发限制: 限制同时处理的请求数
    • 模型限制: 限制可访问的模型列表
    • 客户端限制: 限制只允许特定客户端使用（如ClaudeCode、Gemini-CLI等）
  5. 保存，记下生成的Key

4. 开始使用 Claude Code 和 Gemini CLI

现在你可以用自己的服务替换官方API了：

Claude Code 设置环境变量：

export ANTHROPIC_BASE_URL="http://127.0.0.1:3000/api/" # 根据实际填写你服务器的ip地址或者域名
export ANTHROPIC_AUTH_TOKEN="后台创建的API密钥"

Gemini CLI 设置环境变量：

export CODE_ASSIST_ENDPOINT="http://127.0.0.1:3000/gemini" # 根据实际填写你服务器的ip地址或者域名
export GOOGLE_CLOUD_ACCESS_TOKEN="后台创建的API密钥"  # 使用相同的API密钥即可
export GOOGLE_GENAI_USE_GCA="true"

使用 Claude Code：

claude

使用 Gemini CLI：

gemini  # 或其他 Gemini CLI 命令

Codex 配置：

在 ~/.codex/config.toml 文件中添加以下配置：

model_provider = "crs"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "http://127.0.0.1:3000/openai"  # 根据实际填写你服务器的ip地址或者域名
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

在 ~/.codex/auth.json 文件中配置API密钥为 null：

{
    "OPENAI_API_KEY": null  
}

环境变量设置：

export CRS_OAI_KEY="后台创建的API密钥"

5. 第三方工具API接入

本服务支持多种API端点格式，方便接入不同的第三方工具（如Cherry Studio等）。

Cherry Studio 接入示例

Cherry Studio支持多种AI服务的接入，下面是不同账号类型的详细配置：

1. Claude账号接入：

# API地址
http://你的服务器:3000/claude/

# 模型ID示例
claude-sonnet-4-20250514  # Claude Sonnet 4
claude-opus-4-20250514     # Claude Opus 4

配置步骤：

  • 供应商类型选择"Anthropic"
  • API地址填入：http://你的服务器:3000/claude/
  • API Key填入：后台创建的API密钥（cr_开头）

2. Gemini账号接入：

# API地址
http://你的服务器:3000/gemini/

# 模型ID示例
gemini-2.5-pro             # Gemini 2.5 Pro

配置步骤：

  • 供应商类型选择"Gemini"
  • API地址填入：http://你的服务器:3000/gemini/
  • API Key填入：后台创建的API密钥（cr_开头）

3. Codex接入：

# API地址
http://你的服务器:3000/openai/

# 模型ID（固定）
gpt-5                      # Codex使用固定模型ID

配置步骤：

  • 供应商类型选择"Openai-Response"
  • API地址填入：http://你的服务器:3000/openai/
  • API Key填入：后台创建的API密钥（cr_开头）
  • 重要：Codex只支持Openai-Response标准

其他第三方工具接入

接入要点：

  • 所有账号类型都使用相同的API密钥（在后台统一创建）
  • 根据不同的路由前缀自动识别账号类型
  • /claude/ - 使用Claude账号池
  • /gemini/ - 使用Gemini账号池
  • /openai/ - 使用Codex账号（只支持Openai-Response格式）
  • 支持所有标准API端点（messages、models等）

重要说明：

  • 确保在后台已添加对应类型的账号（Claude/Gemini/Codex）
  • API密钥可以通用，系统会根据路由自动选择账号类型
  • 建议为不同用户创建不同的API密钥便于使用统计

🔧 日常维护

服务管理

# 查看服务状态
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/ 目录下的各种日志文件

升级指南

当有新版本发布时，按照以下步骤升级服务：

# 1. 进入项目目录
cd claude-relay-service

# 2. 拉取最新代码
git pull origin main

# 如果遇到 package-lock.json 冲突，使用远程版本
git checkout --theirs package-lock.json
git add package-lock.json

# 3. 安装新的依赖（如果有）
npm install

# 4. 安装并构建前端
npm run install:web
npm run build:web

# 5. 重启服务
npm run service:restart:daemon

# 6. 检查服务状态
npm run service:status

注意事项：

  • 升级前建议备份重要配置文件（.env, config/config.js）
  • 查看更新日志了解是否有破坏性变更
  • 如果有数据库结构变更，会自动迁移

🔒 客户端限制功能

功能说明

客户端限制功能允许你控制每个API Key可以被哪些客户端使用，通过User-Agent识别客户端，提高API的安全性。

使用方法

  1. 在创建或编辑API Key时启用客户端限制：

    • 勾选"启用客户端限制"
    • 选择允许的客户端（支持多选）

  2. 预定义客户端：

    • ClaudeCode: 官方Claude CLI（匹配 claude-cli/x.x.x (external, cli) 格式）
    • Gemini-CLI: Gemini命令行工具（匹配 GeminiCLI/vx.x.x (platform; arch) 格式）

  3. 调试和诊断：

    • 系统会在日志中记录所有请求的User-Agent
    • 客户端验证失败时会返回403错误并记录详细信息
    • 通过日志可以查看实际的User-Agent格式，方便配置自定义客户端

自定义客户端配置

如需添加自定义客户端，可以修改 config/config.js 文件：

clientRestrictions: {
  predefinedClients: [
    // ... 现有客户端配置
    {
      id: 'my_custom_client',
      name: 'My Custom Client',
      description: '我的自定义客户端',
      userAgentPattern: /^MyClient\/[\d\.]+/i
    }
  ]
}

日志示例

认证成功时的日志：

🔓 Authenticated request from key: 测试Key (key-id) in 5ms
   User-Agent: "claude-cli/1.0.58 (external, cli)"

客户端限制检查日志：

🔍 Checking client restriction for key: key-id (测试Key)
   User-Agent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64)"
   Allowed clients: claude_code, gemini_cli
🚫 Client restriction failed for key: key-id (测试Key) from 127.0.0.1, User-Agent: Mozilla/5.0...

常见问题处理

Redis连不上？

# 检查Redis是否启动
redis-cli ping

# 应该返回 PONG

OAuth授权失败？

  • 检查代理设置是否正确
  • 确保能正常访问 claude.ai
  • 清除浏览器缓存重试

API请求失败？

  • 检查API Key是否正确
  • 查看日志文件找错误信息
  • 确认Claude账户状态正常

🛠️ 进阶

生产环境部署建议（重要！）

强烈建议使用Caddy反向代理（自动HTTPS）

建议使用Caddy作为反向代理，它会自动申请和更新SSL证书，配置更简单：

1. 安装Caddy

# Ubuntu/Debian
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

# CentOS/RHEL/Fedora
sudo yum install yum-plugin-copr
sudo yum copr enable @caddy/caddy
sudo yum install caddy

2. Caddy配置（超简单！）

编辑 /etc/caddy/Caddyfile：

your-domain.com {
    # 反向代理到本地服务
    reverse_proxy 127.0.0.1:3000 {
        # 支持流式响应（SSE）
        flush_interval -1

        # 传递真实IP
        header_up X-Real-IP {remote_host}
        header_up X-Forwarded-For {remote_host}
        header_up X-Forwarded-Proto {scheme}

        # 超时设置（适合长连接）
        transport http {
            read_timeout 300s
            write_timeout 300s
            dial_timeout 30s
        }
    }

    # 安全头部
    header {
        Strict-Transport-Security "max-age=31536000; includeSubDomains"
        X-Frame-Options "DENY"
        X-Content-Type-Options "nosniff"
        -Server
    }
}

3. 启动Caddy

# 测试配置
sudo caddy validate --config /etc/caddy/Caddyfile

# 启动服务
sudo systemctl start caddy
sudo systemctl enable caddy

# 查看状态
sudo systemctl status caddy

4. 更新服务配置

修改你的服务配置，让它只监听本地：

// config/config.js
module.exports = {
  server: {
    port: 3000,
    host: '127.0.0.1' // 只监听本地，通过nginx代理
  }
  // ... 其他配置
}

Caddy优势：

  • 🔒 自动HTTPS: 自动申请和续期Let's Encrypt证书，零配置
  • 🛡️ 安全默认: 默认启用现代安全协议和加密套件
  • 🚀 流式支持: 原生支持SSE/WebSocket等流式传输
  • 📊 简单配置: 配置文件极其简洁，易于维护
  • ⚡ HTTP/2: 默认启用HTTP/2，提升传输性能

💡 使用建议

账户管理

  • 定期检查: 每周看看账户状态，及时处理异常
  • 合理分配: 可以给不同的人分配不同的apikey，可以根据不同的apikey来分析用量

安全建议

  • 使用HTTPS: 强烈建议使用Caddy反向代理（自动HTTPS），确保数据传输安全
  • 定期备份: 重要配置和数据要备份
  • 监控日志: 定期查看异常日志
  • 更新密钥: 定期更换JWT和加密密钥
  • 防火墙设置: 只开放必要的端口（80, 443），隐藏直接服务端口

🆘 遇到问题怎么办？

自助排查

  1. 查看日志: logs/ 目录下的日志文件
  2. 检查配置: 确认配置文件设置正确
  3. 测试连通性: 用 curl 测试API是否正常
  4. 重启服务: 有时候重启一下就好了

寻求帮助

  • GitHub Issues: 提交详细的错误信息
  • 查看文档: 仔细阅读错误信息和文档
  • 社区讨论: 看看其他人是否遇到类似问题

📄 许可证

本项目采用 MIT许可证。

⭐ 觉得有用的话给个Star呗，这是对作者最大的鼓励！

🤝 有问题欢迎提Issue，有改进建议欢迎PR

About

自建Claude Code镜像，支持Claude Code、Gemini CLI、Codex CLI，支持Claude Console接入。集成OAuth认 证、多账号池切换、自定义API密钥、OpenAI兼容格式、代理支持和智能防封机制。

pincc.ai

Resources

Readme

License

MIT license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

50 tags

Packages

No packages published

Languages

  • JavaScript 58.8%
  • Vue 37.4%
  • Shell 2.5%
  • CSS 1.0%
  • Makefile 0.2%
  • Dockerfile 0.1%