README
ccLoad
AI API gateway for Claude Code, Codex, Gemini, and OpenAI.
English | 简体中文
Smart routing | Automatic failover | Exponential cooldown | Multi-URL scheduling | Protocol transforms | Live monitoring | Cost control
ccLoad removes the operational mess of running multiple AI API upstreams. It keeps Claude Code, Codex, Gemini, and OpenAI-compatible clients on one stable gateway, then handles upstream selection, failover, cooldown, protocol conversion, request visibility, and cost limits in the service instead of in every client script.
🎯 What ccLoad Solves
Common failure modes when you run several AI API channels:
- Manual channel switching: Different keys, validity windows, quotas, and upstream URLs quickly become hard to manage.
- Rate limits and upstream failures:
429,502,504, expired keys, and overloaded providers should not stop the client workflow. - Opaque request status: Without live request visibility, long streaming requests become guesswork.
- HTTP 200 with error content: Some upstreams return a successful HTTP status while the response body is an actual error.
- Cost drift: Shared gateways need per-channel and per-token limits, not spreadsheet accounting after the bill arrives.
ccLoad handles those cases with: