README
¶
CC-Relay
Boost Claude Code by routing to multiple Anthropic-compatible providers
Why?
Claude Code connects to one provider at a time. But what if you want to:
🔑 Pool rate limits across multiple Anthropic API keys
💰 Save money by routing simple tasks to lighter models
🛡️ Never get stuck with automatic failover between providers
🏢 Use your company's Bedrock/Azure/Vertex alongside personal API keys
cc-relay makes all of this possible.
%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#6366f1', 'primaryTextColor': '#fff', 'primaryBorderColor': '#4f46e5', 'lineColor': '#94a3b8', 'secondaryColor': 'transparent', 'tertiaryColor': 'transparent', 'background': 'transparent', 'mainBkg': 'transparent', 'nodeBorder': '#4f46e5', 'clusterBkg': 'transparent', 'clusterBorder': 'transparent', 'titleColor': '#1e293b', 'edgeLabelBackground': 'transparent'}}}%%
flowchart LR
CC["👾 Claude Code"]
RELAY["⚡ CC-Relay"]
subgraph providers[" "]
direction TB
ANT["🤖 Anthropic"]
ZAI["🤖 Z.AI"]
OLL["🦙 Ollama"]
BED["🤖 AWS Bedrock"]
AZU["🤖 Azure Foundry"]
VTX["🤖 Vertex AI"]
end
CC --> RELAY
RELAY --> ANT
RELAY --> ZAI
RELAY --> OLL
RELAY --> BED
RELAY --> AZU
RELAY --> VTX
style CC fill:#1e1e2e,stroke:#6366f1,stroke-width:2px,color:#fff
style RELAY fill:#6366f1,stroke:#4f46e5,stroke-width:3px,color:#fff
style ANT fill:#ff6b35,stroke:#e55a2b,stroke-width:2px,color:#fff
style ZAI fill:#3b82f6,stroke:#2563eb,stroke-width:2px,color:#fff
style OLL fill:#22c55e,stroke:#16a34a,stroke-width:2px,color:#fff
style BED fill:#f59e0b,stroke:#d97706,stroke-width:2px,color:#fff
style AZU fill:#0ea5e9,stroke:#0284c7,stroke-width:2px,color:#fff
style VTX fill:#ef4444,stroke:#dc2626,stroke-width:2px,color:#fff
style providers fill:transparent,stroke:transparent
License
AGPL-3.0 - © 2026 Omar Alani
Contributing
Contributions welcome! Please open an issue before submitting PRs.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
cc-relay
command
Package main is the entry point for cc-relay.
|
Package main is the entry point for cc-relay. |
|
internal
|
|
|
auth
Package auth provides authentication mechanisms for cc-relay.
|
Package auth provides authentication mechanisms for cc-relay. |
|
cache
Package cache provides a unified caching interface for cc-relay.
|
Package cache provides a unified caching interface for cc-relay. |
|
config
Package config provides configuration loading and parsing for cc-relay.
|
Package config provides configuration loading and parsing for cc-relay. |
|
di
Package di provides dependency injection using samber/do v2.
|
Package di provides dependency injection using samber/do v2. |
|
health
Package health provides circuit breaker and health tracking for cc-relay providers.
|
Package health provides circuit breaker and health tracking for cc-relay providers. |
|
keypool
Package keypool provides key pooling and rate limit tracking for multi-key API management.
|
Package keypool provides key pooling and rate limit tracking for multi-key API management. |
|
providers
Package providers defines the interface for LLM backend providers.
|
Package providers defines the interface for LLM backend providers. |
|
proxy
Package proxy implements the HTTP proxy server for cc-relay.
|
Package proxy implements the HTTP proxy server for cc-relay. |
|
ratelimit
Package ratelimit provides rate limiting interfaces and implementations for cc-relay.
|
Package ratelimit provides rate limiting interfaces and implementations for cc-relay. |
|
router
Package router provides provider-level routing strategies for cc-relay.
|
Package router provides provider-level routing strategies for cc-relay. |
|
version
Package version provides version information for cc-relay.
|
Package version provides version information for cc-relay. |
Click to show internal directories.
Click to hide internal directories.