如何快速搭建Claude中转服务:一站式AI订阅统一接入指南
Claude Relay Service(CRS)是一款功能强大的自建Claude Code镜像服务,支持Claude、OpenAI、Gemini、Droid等多种AI服务的统一接入与拼车共享,帮助用户更高效地分摊订阅成本,同时保持原生工具的无缝使用体验。## 为什么选择自建Claude中转服务?在AI服务日益普及的今天,许多用户面临地区限制、隐私安全和成本分摊等问题。第三方镜像服务虽然便
如何快速搭建Claude中转服务:一站式AI订阅统一接入指南
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账户
- 登录管理界面后,点击「Claude账户」标签
- 点击「添加账户」按钮
- 生成授权链接并完成Claude登录授权
- 复制Authorization Code并粘贴到页面完成添加
配置模型映射
CRS支持将不同AI模型进行映射,实现跨平台模型调用。例如,可以将Claude模型请求映射到Gemini模型:
上图展示了如何将Claude的opus、sonnet和haiku模型分别映射到Gemini的不同模型版本,实现灵活的模型调用策略。
创建API Key
为每个用户创建独立的API Key:
- 点击「API Keys」标签
- 点击「创建新Key」
- 设置Key名称和使用限制
- 保存并记录生成的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服务使用带来便利与价值!
更多推荐




所有评论(0)