<div align="center">

Claude Code Hub

🚀 智能 AI API 代理中转服务平台

专为需要统一管理多个 AI 服务提供商的团队和企业设计

功能特性 • 快速部署 • 使用指南 • 路线图 • 常见问题

</div>

---

✨ 功能特性

核心能力

• 🔄 统一代理 - 一个 API 接口管理所有 AI 服务提供商（OpenAI、Claude、Gemini 等）
• ⚖️ 智能负载 - 基于权重的智能分发 + 自动故障转移 + 会话保持
• 👥 多租户 - 完整的用户体系，细粒度权限控制和配额管理
• 🔑 密钥管理 - API Key 生成、轮换、过期管理
• 📊 实时监控 - 请求统计、成本追踪、性能分析、可视化报表
• 🎨 现代 UI - 基于 Shadcn UI 的响应式管理面板，深色模式
• 🚀 生产就绪 - Docker 一键部署、自动数据库迁移、健康检查

界面预览

<div align="center">

实时统计面板 - 请求量、成本、用户活跃度一目了然

供应商管理 - 配置上游服务、权重分配、流量限制

</div>

🚀 快速部署

前置要求

• Docker 和 Docker Compose
• ⏱️ 仅需 2 分钟即可启动完整服务

一键部署

使用 docker-compose.yaml 启动

<details> <summary><b>📄 点击展开 docker-compose.yaml 配置文件</b></summary>

services:
  postgres:
    image: postgres:18
    container_name: claude-code-hub-db
    restart: unless-stopped
    ports:
      - "35432:5432"
    environment:
      POSTGRES_USER: ${DB_USER:-postgres}
      POSTGRES_PASSWORD: ${DB_PASSWORD:-postgres}
      POSTGRES_DB: ${DB_NAME:-claude_code_hub}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${DB_USER:-postgres} -d ${DB_NAME:-claude_code_hub}"]
      interval: 5s
      timeout: 5s
      retries: 10
      start_period: 10s

  app:
    image: zsio/claude-code-hub:latest
    container_name: claude-code-hub-app
    depends_on:
      postgres:
        condition: service_healthy
    env_file:
      - ./.env
    environment:
      NODE_ENV: production
      PORT: 23000
      DSN: postgresql://${DB_USER:-postgres}:${DB_PASSWORD:-postgres}@postgres:5432/${DB_NAME:-claude_code_hub}
    ports:
      - "23000:23000"
    restart: unless-stopped

volumes:
  postgres_data:
    driver: local

</details>

启动服务

# 启动所有服务（后台运行）
docker compose up -d

# 查看启动日志
docker compose logs -f

验证部署

检查服务状态

docker compose ps

确保两个容器都是 healthy 或 running 状态

环境变量配置

在项目根目录创建 .env 文件：

# 管理员登录令牌（必须修改为强密码）
ADMIN_TOKEN=!!!change-me-to-a-strong-password!!!

# 数据库配置（可选，已有默认值）
DB_USER=postgres
DB_PASSWORD=!!!change-me!!!
DB_NAME=claude_code_hub

<details> <summary><b>📝 完整环境变量配置说明</b></summary>

| 变量名 | 必需 | 默认值 | 说明 | |--------|------|--------|------| | ADMIN_TOKEN | ✅ | change-me | 管理员登录令牌，必须修改为强密码 | | DB_USER | ❌ | postgres | 数据库用户名 | | DB_PASSWORD | ❌ | postgres | 数据库密码（生产环境建议修改） | | DB_NAME | ❌ | claude_code_hub | 数据库名称 | | AUTO_MIGRATE | ❌ | true | 启动时自动执行数据库迁移...