Arch1Panel/apps/claude-code-hub/README.md

# Claude Code Hub

智能 AI API 代理中转服务平台，面向团队的多供应商统一接入、弹性调度与精细化运营中心。

## 功能特点

- 🤖 **智能负载均衡**：权重 + 优先级 + 分组调度，内置熔断保护与最多 3 次故障转移，保障请求稳定
- 🧩 **多供应商管理**：同时接入 Claude、Codex、Gemini CLI、OpenAI Compatible，自定义模型重定向与 HTTP/HTTPS/SOCKS 代理
- 🛡️ **限流与并发控制**：RPM、金额（5 小时/周/月）、并发 Session 多维限制，Redis Lua 脚本确保原子性与 Fail-Open 降级
- 📘 **自动化 OpenAPI 文档**：39 个 REST 端点由 Server Actions 自动生成 OpenAPI 3.1.0，Swagger + Scalar UI 双界面即刻试用
- 📊 **实时监控与统计**：仪表盘、活跃 Session、消耗排行榜、决策链记录、代理状态追踪，秒级掌控运行态势
- 💰 **价格表管理**：分页查询 + SQL 优化，支持搜索防抖、LiteLLM 同步，千级模型也能快速检索
- 🔁 **Session 管理**：5 分钟上下文缓存，记录决策链，避免频繁切换供应商并保留全链路审计
- 🔄 **OpenAI 兼容端点**：支持 `/v1/chat/completions`（OpenAI 兼容格式），工具调用与 reasoning 字段透传

## 使用说明

### 默认端口

- Web 界面: 23000

### 默认账号密码

- 管理员令牌: 请在部署时设置 `ADMIN_TOKEN` 环境变量（必须修改）

### 数据目录

应用数据存储在 `./data` 目录：

- PostgreSQL 数据: `./data/postgres`
- Redis 数据: `./data/redis`

### 环境变量说明

#### 必需配置

- `ADMIN_TOKEN`: 管理员登录令牌（必须修改）
- `DB_USER`: 数据库用户名
- `DB_PASSWORD`: 数据库密码
- `DB_NAME`: 数据库名称

#### 可选配置

- `ENABLE_RATE_LIMIT`: 是否启用限流（默认：true）
- `SESSION_TTL`: 会话过期时间，单位秒（默认：300）
- `AUTO_MIGRATE`: 是否自动执行数据库迁移（默认：true）
- `ENABLE_SECURE_COOKIES`: 是否启用安全 Cookie（默认：false）
  - **重要**：如果使用 HTTP 部署（非 HTTPS），请保持为 `false`
  - 如果使用 HTTPS 部署，建议设置为 `true` 以提高安全性
  - 设置为 `true` 时，浏览器将拒绝在 HTTP 连接下设置 Cookie，导致无法登录

### 访问应用

部署成功后，可以通过以下地址访问：

- **管理后台**：`http://localhost:23000`（使用 `ADMIN_TOKEN` 登录）
- **API 文档（Scalar UI）**：`http://localhost:23000/api/actions/scalar`
- **API 文档（Swagger UI）**：`http://localhost:23000/api/actions/docs`

## 相关链接

- 官方网站: https://github.com/ding113/claude-code-hub
- GitHub: https://github.com/ding113/claude-code-hub
- 文档: https://github.com/ding113/claude-code-hub/blob/main/README.md

## 技术栈

- **框架**: Next.js 15 + Hono
- **数据库**: PostgreSQL 18
- **缓存**: Redis 7
- **运行时**: Node.js / Bun
- **语言**: TypeScript