Documentation
Documentation
Welcome to the CC-Relay documentation! This guide will help you set up, configure, and use CC-Relay as a multi-provider proxy for Claude Code and other LLM clients.
What is CC-Relay?
CC-Relay is a high-performance HTTP proxy written in Go that sits between LLM clients (like Claude Code) and LLM providers. It provides:
- Multi-provider support: Anthropic and Z.AI (with more providers planned)
- Anthropic API compatible: Drop-in replacement for direct API access
- SSE streaming: Full support for streaming responses
- Multiple authentication methods: API key and Bearer token support
- Claude Code integration: Easy setup with built-in configuration command
Current Status
CC-Relay is in active development. Currently implemented features:
| Feature | Status |
|---|---|
| HTTP Proxy Server | Implemented |
| Anthropic Provider | Implemented |
| Z.AI Provider | Implemented |
| SSE Streaming | Implemented |
| API Key Authentication | Implemented |
| Bearer Token (Subscription) Auth | Implemented |
| Claude Code Configuration | Implemented |
| Multiple API Keys | Implemented |
| Debug Logging | Implemented |
Planned features:
- Routing strategies (round-robin, failover, cost-based)
- Rate limiting per API key
- Circuit breaker and health tracking
- gRPC management API
- TUI dashboard
- Additional providers (Ollama, Bedrock, Azure, Vertex)
Quick Start
# Install
go install github.com/omarluq/cc-relay@latest
# Initialize config
cc-relay config init
# Set your API key
export ANTHROPIC_API_KEY="your-key-here"
# Start the proxy
cc-relay serve
# Configure Claude Code (in another terminal)
cc-relay config cc initQuick Navigation
- Getting Started - Installation and first run
- Configuration - Provider setup and options
- Architecture - System design and components
- API Reference - HTTP endpoints and examples