MCPcopy Index your code
hub / github.com/Buywatermelon/claude-relay-monorepo

github.com/Buywatermelon/claude-relay-monorepo @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
401 symbols 808 edges 96 files 147 documented · 37% updated 10mo ago★ 2384 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Claude Relay

🚀 现代化的 Claude API 代理服务,支持官方和第三方 LLM 供应商智能路由,基于 Cloudflare Workers 全球部署。

✨ 核心特性

  • 🔐 智能代理 - 官方 Claude + 第三方 LLM(魔搭 Qwen、智谱 AI、Google Gemini)
  • 🌐 全球部署 - Cloudflare Workers 边缘网络,超低延迟
  • 💻 可视化管理 - 现代化 Web 界面,一站式管理所有配置
  • 🔑 企业级密钥池 - 智能轮换、故障恢复、实时监控
  • 🚀 一键部署 - GitHub Actions 自动化部署,零配置启动

🎬 功能演示

1️⃣ Claude 账号管理

通过 OAuth 认证管理多个 Claude 账号,支持 Token 自动刷新

Claude 账号管理

2️⃣ 添加供应商

轻松添加第三方 AI 模型供应商(Google AI Studio、魔搭等)

添加供应商

3️⃣ 供应商管理

管理所有第三方模型供应商,支持编辑、删除、密钥池管理

供应商列表

4️⃣ Key Pool 管理

企业级密钥池管理:批量导入、状态监控、智能轮换

密钥池管理

5️⃣ 添加路由配置

配置请求路由策略,设置模型映射关系

路由配置

6️⃣ 查看路由详情

查看供应商的路由配置详情,支持多模型管理

供应商详情

7️⃣ 模型选择

灵活切换官方 Claude 和第三方模型,实现智能路由

模型选择

🚀 快速开始

Deploy to Cloudflare Workers

1️⃣ Fork 仓库 → 2️⃣ 配置 Secrets → 3️⃣ 一键部署

只需 3 步,5 分钟完成部署! 👉 详细部署指南

立即使用

管理中心: https://your-domain.workers.dev/admin

API 端点: https://your-domain.workers.dev/v1/messages

Claude Code 配置:

{
  "env": {
    "ANTHROPIC_API_KEY": "any",
    "ANTHROPIC_BASE_URL": "https://your-domain.workers.dev"
  }
}

💡 主要功能

功能 说明
🤖 Claude 账号管理 OAuth 认证、Token 自动刷新
⚡ 供应商管理 第三方 LLM 集成、模型切换
🔐 Key Pool 管理 密钥池、智能轮换、故障恢复
🎯 统一代理 Claude API 兼容、智能路由

📚 文档

🤝 贡献

欢迎 Issue 和 PR!

📄 开源协议

MIT License


觉得有用?请给个星标支持一下!

Extension points exported contracts — how you extend this code

Engine (Interface)
(no doc) [5 implementers]
packages/backend/src/services/proxy/engines/types.ts
AppError (Interface)
(no doc)
packages/frontend/composables/useErrorHandler.ts
ApiKey (Interface)
(no doc)
shared/types/key-pool.ts
Transformer (Interface)
(no doc) [4 implementers]
packages/backend/src/services/proxy/transformers/base-transformer.ts
ApiErrorResponse (Interface)
(no doc)
packages/frontend/composables/useErrorHandler.ts
KeyPoolConfig (Interface)
(no doc)
shared/types/key-pool.ts
Bindings (Interface)
(no doc)
packages/backend/src/types/env.ts
KeyPoolData (Interface)
(no doc)
shared/types/key-pool.ts

Core symbols most depended-on inside this repo

get
called by 39
packages/backend/src/utils/local-kv-storage.ts
get
called by 26
packages/backend/src/services/proxy/transformers/transformer-registry.ts
createSuccessResponse
called by 19
packages/backend/src/utils/response.ts
createSSEEvent
called by 17
packages/backend/src/services/proxy/transformers/claude-to-gemini.ts
put
called by 16
packages/backend/src/utils/local-kv-storage.ts
createTestRequest
called by 15
packages/backend/test/helpers.ts
showNotification
called by 11
packages/frontend/composables/useClaudeAccounts.ts
getOrCreatePool
called by 11
packages/backend/src/services/key-pool/key-pool-manager.ts

Shape

Method 198
Function 94
Class 63
Interface 46

Languages

TypeScript96%
Python4%

Modules by API surface

packages/backend/src/services/proxy/transformers/claude-to-gemini.ts22 symbols
packages/backend/src/services/proxy/engines/optimized-token-estimator.ts22 symbols
packages/backend/src/services/proxy/transformers/claude-to-openai.ts21 symbols
packages/backend/src/utils/errors.ts18 symbols
packages/backend/src/services/key-pool/base-key-pool.ts17 symbols
packages/backend/src/services/key-pool/key-pool-manager.ts15 symbols
packages/backend/src/services/admin/claude-accounts.ts14 symbols
packages/frontend/composables/useRouteConfigs.ts12 symbols
packages/frontend/composables/useClaudeAccounts.ts12 symbols
packages/backend/src/services/admin/key-pool.ts12 symbols
packages/frontend/composables/useProviders.ts11 symbols
packages/backend/src/utils/local-kv-storage.ts11 symbols

For agents

$ claude mcp add claude-relay-monorepo \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact