CC Hub is a TypeScript-based API proxy platform that aggregates Claude/OpenAI-compatible endpoints with load balancing, multi-supplier management, and real-time monitoring. It emphasizes Docker/Compose deployment and Kubernetes support, with a focus on enterprise-like governance and analytics.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
CC Hub is a modern API proxy platform that routes Claude/OpenAI-compatible requests across multiple providers, offering intelligent load balancing, user management, usage statistics, and price management. It targets teams needing multi-supplier access, observability, and configurable governance.
How it works
The project uses Next.js 16 + Hono + PostgreSQL + Redis to proxy Claude/OpenAI-compatible APIs, perform session management, rate limiting, provider selection, and request forwarding. Core components include a ProxyAuthenticator for API key validation, SessionManager with Redis-backed 5-minute caching, RateLimitService with Lua scripts for atomic metrics, and ProviderResolver for multi-supplier routing with up to 3 retries.
The forwarder preserves upstream end formats and supports model redirection. Documentation endpoints are auto-generated via OpenAPI 3.1.0 for REST actions.
Getting started
- Environment requirements: Docker and Docker Compose; Node.js ≥ 22.15 (optional for local development); Bun ≥ 1.3 (optional).
- Quick start script: see deployment script that installs Docker, configures files, and starts services. Commands shown in README include:
curl -fsSL https://raw.githubusercontent.com/ding113/claude-code-hub/main/scripts/deploy.sh -o deploy.sh
chmod +x deploy.sh
./deploy.sh
wget https://raw.githubusercontent.com/ding113/claude-code-hub/main/scripts/deploy.sh
chmod +x deploy.sh
./deploy.sh
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/ding113/claude-code-hub/main/scripts/deploy.ps1" -OutFile "deploy.ps1"
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
.\deploy.ps1
- Three-step Docker Compose setup:
git clone https://github.com/ding113/claude-code-hub.git
cd claude-code-hub
cp .env.example .env
# modify ADMIN_TOKEN in .env
ADMIN_TOKEN=your-secure-token-here
docker compose up -d
- Access points after startup:
http://localhost:23000
http://localhost:23000/api/actions/scalar
http://localhost:23000/api/actions/docs
- Customization references:
.envsettings include DSN, REDIS_URL, and various feature toggles.
Recent releases
- v0.9.2 Release 0.9.2 (2026-08-04): Docker tags v0.9.2 and latest; included fix for OpenAI Compatible streaming gate, along with other updates.
docker pull ghcr.io/ding113/claude-code-hub:v0.9.2
docker pull ghcr.io/ding113/claude-code-hub:latest
- v0.9.1 Release 0.9.1 (2026-08-03): Docker tags v0.9.1 and latest; include various bug fixes.
docker pull ghcr.io/ding113/claude-code-hub:v0.9.1
docker pull ghcr.io/ding113/claude-code-hub:latest
- v0.9.0 Release 0.9.0 (2026-08-03): Docker tags v0.9.0 and latest.
docker pull ghcr.io/ding113/claude-code-hub:v0.9.0
docker pull ghcr.io/ding113/claude-code-hub:latest
- v0.8.10 Release 0.8.10 (2026-07-06): Docker tags v0.8.10 and latest.
docker pull ghcr.io/ding113/claude-code-hub:v0.8.10
docker pull ghcr.io/ding113/claude-code-hub:latest
- v0.8.9 Release 0.8.9 (2026-07-06): Docker tags v0.8.9 and latest.
docker pull ghcr.io/ding113/claude-code-hub:v0.8.9
docker pull ghcr.io/ding113/claude-code-hub:latest
Traction
- Stars: 3290; Forks: 380; Open issues: 32
Caveats
- License: MIT
- Created: 2025-10-20; Last push: 2026-08-04
- Notes: The README indicates ongoing refactoring and an upcoming CC Hub Plus rebranding under AGPL; production usage should consider potential API changes during this phase.