ccflare is an open-source Claude API proxy designed to eliminate rate limit errors and provide deep visibility into API requests. It targets developers and researchers who utilize the Claude API and need to manage multiple accounts, track usage, and debug issues efficiently. The primary benefit is enabling uninterrupted, high-volume API interactions by intelligently distributing requests across various Claude accounts.

How It Works

ccflare acts as an intermediary, routing requests to available Claude API accounts based on intelligent load balancing strategies, including session-based context maintenance. This approach ensures that rate limits on individual accounts are bypassed by distributing traffic, thereby maximizing throughput and availability. It offers granular, request-level analytics, logging, and cost estimation, providing developers with comprehensive insights into their API usage and performance.

Quick Start & Requirements

• Install via bun install after cloning the repository.
• Run with bun run ccflare.
• Requires Bun >= 1.2.8 and Claude API accounts.
• Official documentation is available in the docs/ directory.

Highlighted Details

• Zero rate limit errors through automatic distribution across multiple accounts.
• Request-level analytics for latency, token usage, and cost tracking.
• Deep debugging with full request/response logging and error traces.
• Minimal <10ms overhead.

Maintenance & Community

The project is open-source with an MIT license, encouraging contributions. Details for contributing are available in CONTRIBUTING.md.

Licensing & Compatibility

Licensed under the MIT license, allowing for commercial use and integration with closed-source applications.

Limitations & Caveats

The project relies on the Bun runtime. While designed for production readiness with features like OAuth token refresh handling and automatic failover, users must ensure they have valid Claude API accounts to leverage its load balancing capabilities.