Wei-Shaw / claude-relay-service

Claude Relay Service > [!CAUTION] > **安全更新通知**：v1.1.248 及以下版本存在严重的管理员认证绕过漏洞，攻击者可未授权访问管理面板。 > > **请立即更新到 v1.1.249+ 版本**，或迁移到新一代项目 **CRS 2.0 (sub2api)** **🔐 自行搭建Claude API中转服务，支持多账户管理** English • 快速开始 • 演示站点 • 公告频道 --- 💎 Claude/Codex 拼车服务推荐 | 平台 | 服务 | 介绍 | |:---|:---|:---| | **pincc.ai** | ✅ Claude Code ✅ Codex CLI | 提供稳定的 Codex CLI 拼车服务 **全新上线 2API 渠道**：接入CC的效果媲美官方 Anthropic Console 账号，暂不支持 PDF 识别功能 💰 单价：0.8元=1美金额度 | --- ⚠️ 重要提醒 **使用本项目前请仔细阅读：** 🚨 **服务条款风险**: 使用本项目可能违反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订阅**: 看你怎么分摊了 • **其他**: 域名（可选） --- 🚀 脚本部署（推荐） 推荐使用管理脚本进行一键部署，简单快捷，自动处理所有依赖和配置。 快速安装 脚本功能 • ✅ **一键安装**: 自动检测系统环境，安装 Node.js 18+、Redis 等依赖 • ✅ **交互式配置**: 友好的配置向导，设置端口、Redis 连接等 • ✅ **自动启动**: 安装完成后自动启动服务并显示访问地址 • ✅ **便捷管理**: 通过 命令随时管理服务状态 管理命令 安装示例 系统要求 • 支持系统: Ubuntu/Debian、CentOS/RedHat、Arch Linux、macOS • 自动安装 Node.js 18+ 和 Redis • Redis 使用系统默认位置，数据独立于应用 --- 📦 手动部署 第一步：环境准备 **Ubuntu/Debian用户：** **CentOS/RHEL用户：** 第二步：下载和配置 第三步：配置文件设置 **编辑 文件：** **编辑 文件：** 第四步：安装前端依赖并构建 第五步：启动服务 --- 🐳 Docker 部署 Docker compose 第一步：下载构建docker-compose.yml文件的脚本并执行 第二步：启动 Docker Compose 配置 docker-compose.yml 已包含： • ✅ 自动初始化管理员账号 • ✅ 数据持久化（logs和data目录自动挂载） • ✅ Redis数据库 • ✅ 健康检查 • ✅ 自动重启 环境变量说明 必填项 • : JWT密钥，至少32个字符 • : 加密密钥，必须是32个字符 可选项 • : 管理员用户名（不设置则自动生成） • : 管理员密码（不设置则自动生成） • : 日志级别（默认：info） • 更多配置项请参考 文件 管理员凭据获取方式 • **查看容器日志** • **查看挂载的文件** • **使用环境变量预设** --- 🎮 开始使用 • 打开管理界面 浏览器访问： 管理员账号： • 自动生成：查看 data/init.json • 环境变量预设：通过 ADMIN_USERNAME 和 ADMIN_PASSWORD 设置 • Docker 部署：查看容器日志 • 添加Claude账户 这一步比较关键，需要OAuth授权： • 点击「Claude账户」标签 • 如果你担心多个账号共用1个IP怕被封禁，可以选择设置静态代理IP（可选） • 点击「添加账户」 • 点击「生成授权链接」，会打开一个新页面 • 在新页面完成Claude登录和授权 • 复制返回的Authorization Code • 粘贴到页面完成添加 **注意**: 如果你在国内，这一步可能需要科学上网。 2.1 临时暂停（503/5xx）与账号级 TTL 覆盖 系统会在上游异常时临时暂停账号路由，默认由全局配置控制（见 ）： • • • • • 在管理后台编辑 **Claude 官方 OAuth 账号** 时，可做账号级覆盖： • ：该账号不再因 503/5xx 进入临时暂停 • ：留空=跟随全局， =关闭该账号 503 冷却 • ：留空=跟随全局， =关闭该账号 5xx 冷却 优先级从高到低： • 账号级“禁用临时冷却” • 账号级 503/5xx 冷却秒数 • 代码调用时传入的自定义 TTL（若有） • 全局环境变量默认值 账户列表会显示“不可路由原因”，包含错误类型、HTTP 状态码、内部冷却总时长、剩余时间和预计恢复时间；点击 可清除异常状态并恢复参与路由。 • 创建API Key 给每个使用者分配一个Key： • 点击「API Keys」标签 • 点击「创建新Key」 • 给Key起个名字，比如「张三的Key」 • 设置使用限制（可选）： • **速率限制**: 限制每个时间窗口的请求次数和Token使用量 • **并发限制**: 限制同时处理的请求数 • **模型限制**: 限制可访问的模型列表 • **客户端限制**: 限制只允许特定客户端使用（如ClaudeCode、Gemini-CLI等） • 保存，记下生成的Key • 开始使用 Claude Code 和 Gemini CLI 现在你可以用自己的服务替换官方API了： **Claude Code 设置环境变量：** **使用标准 Claude 账号池** 默认使用标准 Claude 账号池： **使用 Antigravity 账户池** 适用于通过 Antigravity 渠道使用 Claude 模型（如 等）。 **VSCode Claude 插件配置：** 如果使用 VSCode 的 Claude 插件，需要在 文件中配置： 如果该文件不存在，请手动创建。Windows 用户路径为 。 > 💡 **IntelliJ IDEA 用户推荐**：Claude Code Plus - 将 Claude Code 直接集成到 IDE，支持代码理解、文件读写、命令执行。插件市场搜索 即可安装。 **Gemini CLI 设置环境变量：** **方式一（推荐）：通过 Gemini Assist API 方式访问** > **认证**：只能选 进行认证，如果跳 Google请删除 后再尝试启动 。 > **注意**：gemini-cli 控制台会提示 ，但使用不受任何影响。 **方式二：通过 Gemini API 方式访问** > **认证**：只能选 进行认证，如果提示 请直接留空按回车。如果一打开就跳 Google请删除 后再尝试启动 。 > 💡 **进阶用法**：想在 Claude Code 中直接使用 Gemini 3 模型？请参考 Claude Code 调用 Gemini 3 模型指南 **使用 Claude Code：** **使用 Gemini CLI：** **Codex 配置：** 在 文件**开头**添加以下配置： 在 文件中配置API密钥为 null： > ⚠️ 在通过 Nginx 反向代理 CRS 服务并使用 Codex CLI 时，需要在 http 块中添加 underscores_in_headers on;。因为 Nginx 默认会移除带下划线的请求头（如 session_id），一旦该头被丢弃，多账号环境下的粘性会话功能将失效。 **Droid CLI 配置：** Droid CLI 读取 。可以在该文件中添加自定义模型以指向本服务的新端点： > 💡 将示例中的 替换为你的服务域名或公网地址，并写入后台生成的 API 密钥（cr_ 开头）。 • 第三方工具API接入 本服务支持多种API端点格式，方便接入不同的第三方工具（如Cherry Studio等）。 Cherry Studio 接入示例 Cherry Studio支持多种AI服务的接入，下面是不同账号类型的详细配置： **1. Claude账号接入：** 配置步骤： • 供应商类型选择"Anthropic" • API地址填入： • API Key填入：后台创建的API密钥（cr_开头） **2. Gemini账号接入：** 配置步骤： • 供应商类型选择"Gemini" • API地址填入： • API Key填入：后台创建的API密钥（cr_开头） **3. Codex接入：** 配置步骤： • 供应商类型选择"Openai-Response" • API地址填入： • API Key填入：后台创建的API密钥（cr_开头） • **重要**：Codex只支持Openai-Response标准 **Cherry Studio 地址格式重要说明：** • ✅ **推荐格式**： （不加结尾 ，让 Cherry Studio 自动加上 v1） • ✅ **等效格式**： （手动指定 v1 并加结尾 ） • 💡 **说明**：这两种格式在 Cherry Studio 中是完全等效的 • ❌ **错误格式**： （单独的 结尾会被 Cherry Studio 忽略 v1 版本） 其他第三方工具接入 **接入要点：** • 所有账号类型都使用相同的API密钥（在后台统一创建） • 根据不同的路由前缀自动识别账号类型 • - 使用Claude账号池 • - 使用Antigravity账号池（推荐用于Claude Code） • - 使用Droid类型Claude账号池（只建议api调用或Droid Cli中使用） • - 使用Gemini账号池 • - 使用Codex账号（只支持Openai-Response格式） • - 使用Droid类型OpenAI兼容账号池（只建议api调用或Droid Cli中使用） • 支持所有标准API端点（messages、models等） **重要说明：** • 确保在后台已添加对应类型的账号（Claude/Gemini/Codex） • API密钥可以通用，系统会根据路由自动选择账号类型 • 建议为不同用户创建不同的API密钥便于使用统计 --- 🔧 日常维护 服务管理 监控使用情况 • **Web界面**: - 查看使用统计 • **健康检查**: - 确认服务正常 • **日志文件**: 目录下的各种日志文件 升级指南 当有新版本发布时，按照以下步骤升级服务： **注意事项：** • 升级前建议备份重要配置文件（.env, config/config.js） • 查看更新日志了解是否有破坏性变更 • 如果有数据库结构变更，会自动迁移 --- 🔒 客户端限制…