**claude-balancer**

ccflare 🛡️

**Track Every Request. Go Low-Level. Never Hit Rate Limits Again.**

The ultimate Claude API proxy with intelligent load balancing across multiple accounts. Full visibility into every request, response, and rate limit.

https://github.com/user-attachments/assets/c859872f-ca5e-4f8b-b6a0-7cc7461fe62a

Why ccflare?

• 🚀 Zero Rate Limit Errors - Automatically distribute requests across multiple accounts
• 📊 Request-Level Analytics - Track latency, token usage, and costs in real-time
• 🔍 Deep Debugging - Full request/response logging and error traces
• ⚡ <10ms Overhead - Minimal performance impact on your API calls
• 💸 Free & Open Source - Run it yourself, modify it, own your infrastructure

Quick Start

# Clone and install
git clone https://github.com/snipeship/ccflare
cd ccflare
bun install

# Start ccflare (TUI + Server)
bun run ccflare

# Configure Claude SDK
export ANTHROPIC_BASE_URL=http://localhost:8080

Features

🎯 Intelligent Load Balancing

• Session-based - Maintain conversation context (5hr sessions)

📈 Real-Time Analytics

• Token usage tracking per request
• Response time monitoring
• Rate limit detection and warnings
• Cost estimation and budgeting

🛠️ Developer Tools

• Interactive TUI (bun run ccflare)
• Web dashboard (http://localhost:8080/dashboard)
• CLI for account management
• REST API for automation

🔒 Production Ready

• Automatic failover between accounts
• OAuth token refresh handling
• SQLite database for persistence
• Configurable retry logic

Documentation

Full documentation available in [`docs/`](docs/):

• Getting Started
• Architecture
• API Reference
• Configuration
• Load Balancing Strategies

Screenshots

Real-time Dashboard
Request Logs



Analytics & Usage Tracking

Requirements

...