如何快速搭建Claude中转服务:一站式AI订阅统一接入指南

【免费下载链接】claude-relay-service CRS-自建Claude Code镜像,一站式开源中转服务,让 Claude、OpenAI、Gemini、Droid 订阅统一接入,支持拼车共享,更高效分摊成本,原生工具无缝使用。 【免费下载链接】claude-relay-service 项目地址: https://gitcode.com/GitHub_Trending/cl/claude-relay-service

Claude Relay Service(CRS)是一款功能强大的自建Claude Code镜像服务,支持Claude、OpenAI、Gemini、Droid等多种AI服务的统一接入与拼车共享,帮助用户更高效地分摊订阅成本,同时保持原生工具的无缝使用体验。

为什么选择自建Claude中转服务?

在AI服务日益普及的今天,许多用户面临地区限制、隐私安全和成本分摊等问题。第三方镜像服务虽然便捷,但存在数据安全风险、性能不稳定和价格不透明等隐患。自建Claude中转服务则能有效解决这些痛点:

  • 数据安全:所有接口请求仅经过自己的服务器,直连官方API,确保对话内容隐私
  • 成本透明:精确记录token使用量,按官方价格计算费用,避免中间环节加价
  • 性能可控:私有部署确保服务稳定,避免高峰期拥堵问题
  • 多模型支持:不仅支持Claude,还可统一管理OpenAI、Gemini等多种AI服务账号

核心功能介绍

多账户与API管理

CRS提供全面的账户管理功能,支持添加多个Claude账户并自动轮换使用。管理员可以为每个用户分配独立的API Key,并设置精细化的使用限制:

  • 速率限制:控制每个时间窗口的请求次数和Token使用量
  • 并发限制:限制同时处理的请求数量
  • 模型限制:指定可访问的AI模型列表
  • 客户端限制:仅允许特定客户端(如ClaudeCode、Gemini-CLI)使用

智能路由与负载均衡

系统会根据账户状态自动切换可用账号,当某个账户出现问题时,会自动路由到其他可用账户,确保服务持续可用。同时支持设置账户优先级,实现负载均衡和成本优化。

详细的使用统计与监控

通过直观的Web管理界面,用户可以实时查看服务状态、账户使用情况和成本分析。所有操作都有详细日志记录,便于审计和问题排查。

快速部署指南

系统要求

部署CRS需要满足以下最低配置:

  • CPU:1核心
  • 内存:512MB(建议1GB)
  • 硬盘:30GB可用空间
  • 网络:能访问到Anthropic API(建议使用US地区服务器)
  • 软件:Node.js 18+、Redis 6+

一键脚本部署(推荐)

使用官方提供的管理脚本可以快速完成部署:

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

安装完成后,可以使用以下命令管理服务:

crs start     # 启动服务
crs stop      # 停止服务
crs restart   # 重启服务
crs status    # 查看状态
crs update    # 更新服务

Docker部署

如果偏好容器化部署,可以使用Docker Compose:

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

配置与使用

访问管理界面

部署完成后,通过浏览器访问 http://你的服务器IP:3000/web 即可打开管理界面。管理员账号信息会自动生成并保存在 data/init.json 文件中。

添加Claude账户

  1. 登录管理界面后,点击「Claude账户」标签
  2. 点击「添加账户」按钮
  3. 生成授权链接并完成Claude登录授权
  4. 复制Authorization Code并粘贴到页面完成添加

配置模型映射

CRS支持将不同AI模型进行映射,实现跨平台模型调用。例如,可以将Claude模型请求映射到Gemini模型:

Claude与Gemini模型映射配置界面

上图展示了如何将Claude的opus、sonnet和haiku模型分别映射到Gemini的不同模型版本,实现灵活的模型调用策略。

创建API Key

为每个用户创建独立的API Key:

  1. 点击「API Keys」标签
  2. 点击「创建新Key」
  3. 设置Key名称和使用限制
  4. 保存并记录生成的Key

客户端配置

以Claude Code为例,设置环境变量即可使用自建的中转服务:

export ANTHROPIC_BASE_URL="http://你的服务器IP:3000/api/"
export ANTHROPIC_AUTH_TOKEN="后台创建的API密钥"

对于Gemini CLI,可以这样配置:

CODE_ASSIST_ENDPOINT="http://你的服务器IP:3000/gemini"
GOOGLE_CLOUD_ACCESS_TOKEN="后台创建的API密钥"
GEMINI_MODEL="gemini-2.5-pro"

高级功能与最佳实践

反向代理配置

为提高安全性和性能,建议使用反向代理(如Caddy或Nginx)部署CRS:

Caddy配置示例

your-domain.com {
    reverse_proxy 127.0.0.1:3000 {
        flush_interval -1
        header_up X-Real-IP {remote_host}
        transport http {
            read_timeout 300s
            write_timeout 300s
        }
    }
    header {
        Strict-Transport-Security "max-age=31536000; includeSubDomains"
        X-Frame-Options "DENY"
    }
}

账户管理最佳实践

  • 定期检查:每周查看账户状态,及时处理异常
  • 合理分配:为不同用户分配独立API Key,便于用量分析
  • 安全措施:启用客户端限制,仅允许指定工具访问API

性能优化建议

  • 将CRS与CCR(claude-code-router)部署在同一服务器,减少网络延迟
  • 为每个用户创建独立的CRS API Key,便于使用统计和权限管理
  • 对于长时间运行的任务,适当增加API超时时间

常见问题解决

服务启动失败

检查Redis是否正常运行:

redis-cli ping

如果返回PONG,则Redis正常,否则需要启动Redis服务。

OAuth授权失败

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

API请求超时

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

总结

通过Claude Relay Service,用户可以轻松搭建属于自己的AI服务中转平台,实现多账户统一管理、成本分摊和隐私保护。无论是个人使用还是小团队共享,CRS都能提供稳定、安全且经济高效的AI服务访问方案。

项目的详细文档和最新更新可以通过查阅 docs/ 目录下的文件获取。如果在使用过程中遇到问题,欢迎提交Issue或参与社区讨论。

感谢选择Claude Relay Service,希望这款工具能为您的AI服务使用带来便利与价值!

【免费下载链接】claude-relay-service CRS-自建Claude Code镜像,一站式开源中转服务,让 Claude、OpenAI、Gemini、Droid 订阅统一接入,支持拼车共享,更高效分摊成本,原生工具无缝使用。 【免费下载链接】claude-relay-service 项目地址: https://gitcode.com/GitHub_Trending/cl/claude-relay-service

Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐