---

使用本项目前请仔细阅读：

🚨 服务条款风险: 使用本项目可能违反Anthropic的服务条款。请在使用前仔细阅读Anthropic的用户协议，使用本项目的一切风险由用户自行承担。

📖 免责声明: 本项目仅供技术学习和研究使用，作者不对因使用本项目导致的账户封禁、服务中断或其他损失承担任何责任。

与三五个好友一起拼车使用 Claude Code 账号, 同时也可以作为多个 "车主" 为不同的用户提供服务.

支持任意符合 Claude Code API规范的账号池, 如: GLM4.5 Qwen3-Code等, 甚至一些国内的中转镜像站的 Claude Code 专属分组均可, 这样就能实现在账号限流的时候智能切换.

同时提供了完整的使用统计和成本计算 (与实际会有略微差异), 让你清楚了解每个账号的使用情况和费用支出, 以及为每个Api Key设置每日限额.

• ✅ 支持添加 Claude 官方账号 (需Pro及以上订阅版本)
• ✅ 支持添加任意 Claude Code 的镜像接口 (官方镜像站/智谱/通义千问等)
• ✅ 支持任意符合 OpenAI API 格式的接口

后端服务

• 多账号池统一管理，智能负载均衡
• 支持Claude官方API和Claude Console双平台
• 基于权重和优先级的智能调度算法
• 完整的Token使用统计和成本计算
• 分层架构设计（Controller-Service-Model）
• 完整中间件链（Auth、CORS、限流、日志等）
• 账号请求异常自动禁用, 定时检测自动恢复
• API Key支持每日限额和可用模型配置

前端界面

• Vue 3 + TypeScript + TDesign组件库
• 实时数据统计和可视化图表
• 完整的权限管理和用户系统
• 单独的API KEY的用量查询 (/stats/api-key?api_key=sk-xxx)

后端分层结构

├── controller/     # HTTP请求处理、参数验证、响应格式化  
├── service/        # 核心业务逻辑、账号调度、使用统计
├── model/          # 数据模型定义、GORM操作
├── middleware/     # 认证、限流、日志、CORS
├── relay/          # Claude API中转层
├── common/         # 工具函数、成本计算、JWT处理
└── router/         # 路由配置

前端项目结构

web/
├── src/
│   ├── pages/      # 业务页面组件
│   ├── components/ # 公共组件
│   ├── api/        # API请求封装
│   ├── store/      # Pinia状态管理
│   ├── router/     # Vue Router路由
│   └── utils/      # 工具函数
├── package.json    # 依赖配置
└── vite.config.ts  # Vite配置

• Go 1.21+
• Node.js 18.18.0+ (前端开发)
• MySQL 5.7+
• Redis

• Apifox在线文档 涵盖了大部分接口

• Controller层: 请求处理、参数验证、响应格式化
• Service层: 业务逻辑、账号调度、统计计算
• Model层: 数据模型、数据库操作、CRUD接口
• Middleware层: 认证、限流、CORS、日志记录
• Scheduled层: 处理账号状态检测、自动恢复异常账号

1. 优先级排序: 数字越小优先级越高
2. 权重选择: 同优先级中按权重比例选择
3. 状态过滤: 仅选择正常状态的账号
4. 故障转移: 自动跳过异常账号

1. 后端: Go 1.21+, Gin, GORM, Redis
2. 前端: Vue 3.5+, TypeScript, TDesign, Vite 6+
3. 数据库: MySQL 5.7+, Redis

• 分层原则: Controller → Service → Model
• 错误处理: 使用 common.SysLog() 和 common.SysError()
• 用户信息获取: 使用 user := c.MustGet("user").(*model.User)
• 依赖管理: 添加新依赖后运行 go mod tidy

• 组件样式: 必须声明 <style scoped>
• API请求: 统一使用 @/utils/request 封装的axios
• 代码检查: 提交前自动运行lint检查
• 文档参考: TDesign Vue3文档

核心数据表

• users - 用户账户和角色权限
• accounts - Claude账号池和使用统计
• api_keys - API密钥管理和使用监控
• groups - 分组管理和权限控制
• logs - 模型请求日志记录数据
• api_logs - API请求日志和统计数据

一键部署全套服务

# 启动MySQL + Redis + 应用
docker-compose -f docker-compose-all.yml up -d

# 查看服务状态
docker-compose -f docker-compose-all.yml ps

# 访问地址
echo "应用地址: http://localhost:10081"
echo "默认管理员: admin / admin123"

使用现有数据库

# 复制并编辑环境变量
cp .env.example .env

# 启动应用
docker-compose up -d

可以在 Releases 页面直接下载最新的二进制文件, 或者按照下面方式自行编译构建。

构建多平台版本

# 使用Makefile构建
make build

# 查看构建产物
ls out/

生产环境启动

将 .env.example 文件复制为 .env 文件，并根据实际情况修改配置。

然后放置在与 claude-code-relay 二进制文件同一目录下。

# 设置必需环境变量
export SESSION_SECRET=$(openssl rand -base64 32)
export JWT_SECRET=$(openssl rand -base64 32)
export SALT=$(openssl rand -base64 16)
...

# 配置数据库
export MYSQL_HOST=your-host
export MYSQL_USER=your-user
export MYSQL_PASSWORD=your-password
...

# 启动服务 (v0.1.10及以上版本前端文件已打包进二进制, 直接打开服务域名即可访问首页)
./-relay

在ClaudeCode中使用此服务非常简单，只需将 Claude Code 的请求地址换成此服务地址和秘钥即可。以下是具体步骤：

# 在ClaudeCode中配置API请求地址 (建议开启https)
export ANTHROPIC_BASE_URL=https://your-server-domain/

# 在ClaudeCode中配置API密钥
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

另一种方法, 创建并配置 Settings 文件： 在 ~/.claude/settings.json 文件并配置您的 API 密钥:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "https://your-server-domain/",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":1

  },
  "permissions": {
    "allow": [],
    "deny": []
  },
  "apiKeyHelper": "echo 'your-api-key-here'"
}

更加详细的方法, 进入到后台页面, 点击右上角 帮助文档 或者直接访问页面 /help/index 地址, 有更加详细的使用教程.

Q: 如何重置管理员密码？
A: 删除数据库中的admin用户记录，重启服务会自动重新创建默认管理员。

Q: 支持哪些Claude模型？
A: 支持所有Claude模型，包括Claude-3.5系列，成本计算会自动适配不同模型。

Q: 如何查看账号使用统计？
A: 通过前端管理界面或API接口查看详细的使用统计和成本分析。

Q: 无法正常访问Claude官方服务？
A: Claude等国外模型服务商禁用国内IP访问, 自行使用代理解决 (建议使用高质量的代理IP)。

• 灵感来源: claude-relay-service
• 本项目 90% 代码均由 Claude Code 开发完成, 感谢Anthropic提供强大的AI能力支持.

---

MIT License - 欢迎贡献代码和提交Issue！