mirror of
https://github.com/arch3rPro/1Panel-Appstore.git
synced 2026-05-11 20:21:38 +08:00
arch3rPro
73 lines
2.9 KiB
Markdown
73 lines
2.9 KiB
Markdown
# Claude Code Hub
|
|
|
|
Intelligent AI API Gateway and Management Platform for unified multi-provider access, elastic scheduling, and refined operations.
|
|
|
|
## Features
|
|
|
|
- 🤖 **Intelligent Load Balancing**: Weight + priority + group scheduling with built-in circuit breaker protection and up to 3 failover attempts
|
|
- 🧩 **Multi-Provider Management**: Support for Claude, Codex, Gemini CLI, OpenAI Compatible with custom model redirection and HTTP/HTTPS/SOCKS proxy
|
|
- 🛡️ **Rate Limiting & Concurrency Control**: Multi-dimensional limits including RPM, cost (5h/weekly/monthly), concurrent sessions with Redis Lua scripts for atomic operations
|
|
- 📘 **Auto-generated OpenAPI Documentation**: 39 REST endpoints with OpenAPI 3.1.0, Swagger + Scalar UI interfaces
|
|
- 📊 **Real-time Monitoring & Statistics**: Dashboard, active sessions, consumption leaderboard, decision chain records, proxy status tracking
|
|
- 💰 **Price Table Management**: Paginated queries with SQL optimization, search debouncing, LiteLLM sync support
|
|
- 🔁 **Session Management**: 5-minute context cache with decision chain recording for full audit trail
|
|
- 🔄 **OpenAI Compatible Endpoints**: Support for `/v1/chat/completions` with tool calling and reasoning field passthrough
|
|
|
|
## Usage
|
|
|
|
### Default Port
|
|
|
|
- Web UI: 23000
|
|
|
|
### Default Credentials
|
|
|
|
- Admin Token: Set the `ADMIN_TOKEN` environment variable during deployment (must be changed)
|
|
|
|
### Data Directory
|
|
|
|
Application data is stored in the `./data` directory:
|
|
|
|
- PostgreSQL data: `./data/postgres`
|
|
- Redis data: `./data/redis`
|
|
|
|
### Environment Variables
|
|
|
|
#### Required Configuration
|
|
|
|
- `ADMIN_TOKEN`: Admin login token (must be changed)
|
|
- `DB_USER`: Database username
|
|
- `DB_PASSWORD`: Database password
|
|
- `DB_NAME`: Database name
|
|
|
|
#### Optional Configuration
|
|
|
|
- `ENABLE_RATE_LIMIT`: Enable rate limiting (default: true)
|
|
- `SESSION_TTL`: Session TTL in seconds (default: 300)
|
|
- `AUTO_MIGRATE`: Auto-execute database migrations (default: true)
|
|
- `ENABLE_SECURE_COOKIES`: Enable secure cookies (default: false)
|
|
- **Important**: Keep as `false` if deploying with HTTP (not HTTPS)
|
|
- If deploying with HTTPS, it's recommended to set to `true` for better security
|
|
- When set to `true`, browsers will refuse to set cookies over HTTP connections, preventing login
|
|
|
|
### Access the Application
|
|
|
|
After successful deployment, access the application at:
|
|
|
|
- **Dashboard**: `http://localhost:23000` (login with `ADMIN_TOKEN`)
|
|
- **API Docs (Scalar UI)**: `http://localhost:23000/api/actions/scalar`
|
|
- **API Docs (Swagger UI)**: `http://localhost:23000/api/actions/docs`
|
|
|
|
## Links
|
|
|
|
- Website: https://github.com/ding113/claude-code-hub
|
|
- GitHub: https://github.com/ding113/claude-code-hub
|
|
- Documentation: https://github.com/ding113/claude-code-hub/blob/main/README.md
|
|
|
|
## Tech Stack
|
|
|
|
- **Framework**: Next.js 15 + Hono
|
|
- **Database**: PostgreSQL 18
|
|
- **Cache**: Redis 7
|
|
- **Runtime**: Node.js / Bun
|
|
- **Language**: TypeScript
|