Wei-Shaw/claude-relay-service

What it solves

Claude Relay Service provides a self-hosted API gateway for Claude, allowing users to bypass regional restrictions, avoid reliance on third-party mirror sites, and share the costs of a Claude Code Max subscription among multiple people while maintaining privacy and data security.

How it works

The service acts as a relay between the user and the Anthropic API. It allows administrators to add multiple Claude accounts via OAuth authorization and manage them in a pool. The system then distributes requests across these accounts, providing custom API keys for individual users to track usage and control access.

Who it’s for

• Privacy-conscious users who do not want third-party mirrors to log their conversations.
• Groups of friends looking to split the cost of a high-tier Claude subscription.
• Users in restricted regions who cannot access Claude services directly.
• Technical users capable of deploying and maintaining their own server (Node.js and Redis).

Highlights

• Multi-account Management: Supports adding multiple accounts with automatic rotation and intelligent switching if an account fails.
• Granular Access Control: Create independent API keys with limits on rate, concurrency, specific models, and allowed clients (e.g., Claude Code, Gemini CLI).
• ** uma Monitoring Dashboard**: A web interface to track token usage, cost analysis, and account health.
• Broad Compatibility: Provides multiple API endpoints to integrate with tools like Claude Code, Gemini CLI, Codex, Droid CLI, and Cherry Studio.
• Performance Optimization: Includes connection pooling and caching to reduce latency.