Claude Relay Service

简体中文

English

简体中文

English

Appearance

Claude Relay Service 常见问题 ​

🚀 部署和安装 ​

Q1: 系统要求是什么？ ​

最低配置：

  • CPU: 1核心
  • 内存: 512MB（推荐 1GB）
  • 硬盘: 30GB 可用空间
  • 操作系统: Ubuntu/Debian、CentOS/RedHat、Arch Linux、macOS
  • 网络: 能访问到 Anthropic API（建议 US 地区机器）

Q2: 如何快速部署？ ​

推荐使用一键脚本：

bash
curl -fsSL https://raw.githubusercontent.com/Wei-Shaw/claude-relay-service/main/scripts/manage.sh -o manage.sh
chmod +x manage.sh
./manage.sh install

Q3: Docker 部署和脚本部署有什么区别？ ​

  • 脚本部署: 自动检测系统环境，安装所有依赖，更适合生产环境
  • Docker 部署: 容器化运行，环境隔离更好，适合开发测试
  • 两种方式功能完全相同，选择你更熟悉的即可

Q4: 阿里云/腾讯云可以部署吗？ ​

不建议使用阿里云、腾讯云的海外主机，经测试会被 Cloudflare 拦截，无法直接访问 Claude API。建议使用其他云服务商的 US 地区机器。

🔧 配置和使用 ​

Q5: 如何添加 Claude 账户？ ​

  1. 登录 Web 管理界面 http://your-server:3000/web
  2. 点击「Claude账户」标签
  3. 点击「添加账户」
  4. 完成 OAuth 授权流程
  5. 系统会自动轮换使用多个账户

Q6: 如何创建 API Key？ ​

  1. 在 Web 管理界面点击「API Keys」标签
  2. 点击「创建新Key」
  3. 设置名称和使用限制（可选）
  4. 保存并记录生成的 Key

Q7: 如何配置 Claude Code 使用中转服务？ ​

设置环境变量：

bash
export ANTHROPIC_BASE_URL="http://your-server:3000/api/"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

Q8: 支持哪些客户端？ ​

支持所有兼容 Anthropic API 的客户端：

  • Claude Code 官方 CLI
  • Gemini CLI
  • Cherry Studio
  • 其他第三方 AI 工具

Q9: 如何设置客户端限制？ ​

在创建 API Key 时：

  1. 勾选"启用客户端限制"
  2. 选择允许的客户端类型
  3. 系统会通过 User-Agent 验证客户端

🛠️ 故障排除 ​

Q10: 服务无法启动怎么办？ ​

  1. 检查端口是否被占用：netstat -tlnp | grep 3000
  2. 检查 Redis 是否正常：redis-cli ping
  3. 查看服务日志：npm run service:logs
  4. 检查配置文件是否正确

Q11: OAuth 授权失败？ ​

  • 确保服务器能访问 claude.ai
  • 检查代理设置
  • 清除浏览器缓存重试
  • 如果在国内，可能需要科学上网

Q12: API 请求失败怎么办？ ​

  1. 检查服务器状态：http://your-server:3000/health
  2. 查看服务器日志：npm run service:logs
  3. 确认 Claude 账户状态正常
  4. 检查 API Key 是否正确
  5. 重启服务：npm run service:restart:daemon

Q13: Redis 连接失败？ ​

bash
# 检查 Redis 状态
redis-cli ping  # 应该返回 PONG

# 检查 Redis 服务
sudo systemctl status redis-server  # Ubuntu/Debian
sudo systemctl status redis         # CentOS/RHEL

Q14: 如何查看使用统计？ ​

在 Web 管理界面可以看到：

  • 各账户使用情况
  • API 调用次数和频率
  • Token 消耗统计
  • 成本分析报告

🔐 安全和维护 ​

Q15: 如何确保数据安全？ ​

  • 所有 API 请求只经过你自己的服务器
  • 直连 Anthropic API，无第三方介入
  • 建议使用 HTTPS（Caddy 自动配置）
  • 定期更新服务到最新版本

Q16: 如何升级服务？ ​

bash
cd claude-relay-service
git pull origin main
npm install
npm run install:web
npm run build:web
npm run service:restart:daemon

Q17: 如何备份重要数据？ ​

需要备份的文件：

  • 配置文件：.env, config/config.js
  • 数据文件：data/ 目录
  • 日志文件：logs/ 目录（可选）

Q18: 忘记管理员密码怎么办？ ​

  1. 查看 data/init.json 文件
  2. 或者重新生成：npm run setup
  3. Docker 部署可查看容器日志：docker logs claude-relay-service

🌐 生产环境 ​

Q19: 如何配置域名和 HTTPS？ ​

推荐使用 Caddy：

bash
# 安装 Caddy
sudo apt install caddy

# 配置 /etc/caddy/Caddyfile
your-domain.com {
    reverse_proxy 127.0.0.1:3000
}

# 启动 Caddy
sudo systemctl start caddy

Q20: 如何监控服务状态？ ​

  • 健康检查：http://your-domain:3000/health
  • 服务状态：npm run service:status
  • 查看日志：npm run service:logs
  • Web 管理界面监控面板

Q21: 服务器重启后如何自动启动？ ​

脚本部署会自动配置开机启动。手动部署需要：

bash
# 添加到系统服务
sudo npm run service:install
sudo systemctl enable claude-relay-service

📊 性能优化 ​

Q22: 如何提高服务性能？ ​

  1. 增加服务器配置（推荐 2核4G）
  2. 使用 SSD 硬盘
  3. 选择网络延迟低的机器
  4. 配置连接池和缓存
  5. 使用 CDN 加速（可选）

Q23: 可以同时支持多少用户？ ​

取决于：

  • 服务器配置
  • Claude 账户数量
  • 用户使用频率
  • 一般 2核4G 配置可支持 10-50 个轻度用户

Q24: 添加账号提示交换授权码？ ​

  • Openai账号提示此问题大部分是IP问题导致，尝试更换代理IP或机器
  • Claude账号状态码提示为403，大概率是被cloudflare拦截，尝试更换代理IP或者机器

Q25: 使用过程遇到的一些错误？ ​

📞 获取帮助 ​

Q26: 遇到问题如何获取支持？ ​

  1. 查看日志: logs/ 目录下的详细日志
  2. GitHub Issues: 提交详细的错误信息
  3. 社群交流: 加入用户交流群
  4. 文档查阅: 仔细阅读部署指南

还有其他问题？ ​

如果以上问题没有解决您的困惑，欢迎：

提示: 部署前请仔细阅读 部署指南，大部分问题都可以通过正确的部署步骤避免。