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.

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 claudeflare)
• 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/:

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

Screenshots

Requirements

• Bun >= 1.2.8
• Claude API accounts (Free, Pro, or Team)

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

MIT - See LICENSE for details