自建 Claude Code 镜像服务，打造高可控、安全稳定的 AI 助手_claude relay service

🌟 项目简介

claude-relay-service 是由开源开发者 @Wei-Shaw 构建的一个 Claude Code 中继服务（Relay Service），本质上是一个轻量级反向代理服务，支持通过本地或服务器自建服务，实现对 Claude Code 的稳定、安全调用。

适用于 Claude.ai / Claude Code / Claude API，兼容 OpenAI 接口协议，开箱即用！

---

🧩 项目核心特性

✅ 1. 多账户自动切换，规避封号风险

• 支持配置多个 Claude 账号（邮箱 + 密码 或 OAuth）
• 请求时自动调度账号轮换，分摊流量，有效规避封号问题
• 内置 token 管理池，支持自动刷新和失效检测

🔐 2. 自定义 API 密钥，隐私数据完全可控

• 每个用户可生成自己的 API Key
• 统一走本地中转服务，无需直接暴露 Claude 官方账号
• 敏感数据不会发送到第三方平台，极大提升隐私安全性

⚙️ 3. OAuth 集成：添加账号像登录 GitHub 一样简单

• 支持通过 OAuth 登录添加 Claude 账号（无需暴露明文密码）
• 账号接入后会自动加入中继账号池，支持轮换调用
• 方便团队或多人账号集中管理

🌐 4. 兼容 OpenAI API 接口，轻松替换 ChatGPT

• 接口协议兼容 OpenAI Chat API，无缝接入市面上大多数 AI 工具
• 可搭配 OpenCat、Chatbox 等客户端直接使用 Claude
• 也可接入现有后端服务，实现与 Claude 的融合

---

🛠️ 部署步骤概览

1. 克隆仓库

git clone https://github.com/Wei-Shaw/claude-relay-service.gitcd claude-relay-service

1. 配置环境变量 .env

cp .env.example .env# 编辑 .env 文件，配置数据库、管理员账户信息等

1. 构建并运行服务（支持 Docker Compose）

docker-compose up -d

1. 访问控制台

访问 http://localhost:3000 即可进入管理后台
添加 Claude 账号，生成 API Key，开始使用！

---

🔧 使用场景举例

场景 描述 🚀 搭建自己的 Claude Code API 服务 使用自定义 key 向服务发起请求，后端由多个 Claude 账号轮转调用 🛡️ 私有化部署，确保数据隐私 本地部署，无需走第三方平台，数据可控 👨‍👩‍👧‍👦 团队账号池集中管理 支持多个开发者使用同一个 Relay 服务，通过 key 管理调用权限 🧠 ChatGPT 替代方案 对接 OpenAI 兼容客户端，如 OpenCat、Chatbox、NextChat 等

---

📷 控制台预览图

项目自带现代化的 Web 控制台界面，支持账号添加、Token 监控、API 密钥生成等功能。

---

🔮 总结：为什么推荐你用它？

• Claude Code 使用变得更“自如”，不再担心封号、登录异常
• 数据掌握在自己手中，符合合规要求和隐私诉求
• 快速部署、简单配置，适合个人开发者和小型团队使用
• 与现有工具兼容好，不需要改变使用习惯

---

🔗 项目地址

👉 GitHub 地址：https://github.com/Wei-Shaw/claude-relay-service