OpenRelay 使用教程

项目简介

OpenRelay 是一个本地 AI 配额聚合代理。一次启动，自动发现你机器上所有 AI 订阅
（Claude Desktop、Claude Code、Kiro、Windsurf、Antigravity、OpenCode、VS Code Copilot、OpenAI Codex），
再加上 24 家直连 API（Groq、Cerebras、SambaNova、Gemini、DeepSeek、Mistral、Cloudflare AI、HuggingFace 等），
一个端点 http://localhost:18765，通吃 32 家提供商。

它解决三个核心痛点：

• ✅ 订阅孤岛：Claude Pro 只能在 Claude Desktop 用？现在 Claude Code、Aider、Continue、Goose 都能用。
• ✅ 配额碎片：Groq 免费、Cerebras 免费、Gemini 免费——但每个工具都要单独配 Key？一次填完，处处可用。
• ✅ 额度断崖：Cursor 烧光了 500 次？Windsurf 额度归零？把多家配额合成一个虚拟模型，自动故障转移，AI 永不停机。

💡
GitHub 地址：
https://github.com/romgX/openrelay

许可证：MIT（框架部分） + 商业授权（Pro 模型组合功能）

核心亮点

下载安装

无需 Node.js / npm，直接下载可执行文件运行：

chmod +x openrelay-macos
xattr -d com.apple.quarantine openrelay-macos
./openrelay-macos

chmod +x openrelay-linux-x64
./openrelay-linux-x64

✅
启动后浏览器打开 http://localhost:18765，所有功能都在 Web 面板里管理，支持中英双语。

三步用起来

$env:ANTHROPIC_BASE_URL="http://localhost:18765"
$env:ANTHROPIC_API_KEY="unused"

export ANTHROPIC_BASE_URL=http://localhost:18765
export ANTHROPIC_API_KEY=unused

进阶玩法：模型组合 · AI 永不停机

这是 OpenRelay 的”杀手锏”。把多个 Provider 的免费配额合并成一个虚拟模型：

"fast-group" = Groq (Llama 90B) + Cerebras (Llama 70B) + SambaNova (Llama 405B)

Groq 用完自动切 Cerebras，再切 SambaNova——跨 Provider 轮询，零手动切换，AI 永远在线。

💼
注意：“模型组合 / 无限请求” 属于 Pro 商业功能，框架本身（代理、格式转换、配置）是 MIT 开源免费的。

安全说明

• 凭据不离开本机：所有 token、cookie、API Key 仅在本地内存使用，绝不上传。
• 直连 AI 后端：请求从你的机器直接发到 Provider，没有中转服务器。
• 不记录请求内容：消息内容从不被日志记录、缓存或持久化。
• 可审计：凭据处理代码（cookie.ts）完全开源可查。

常见问题

Q: macOS 提示”无法打开”或”已损坏”？

这是 Gatekeeper 对未签名程序的保护，执行 xattr -d com.apple.quarantine openrelay-macos 解除即可，不是病毒。

Q: Linux 上 Claude Desktop 配额用不了？

Claude Desktop 和 Antigravity 没有 Linux 版本，所以无法在 Linux 上读取它们的配额。其他六大 IDE Provider（Claude Code、Kiro、Windsurf、OpenCode、VS Code Copilot、OpenAI Codex）正常支持。

Q: 端口 18765 被占用怎么办？

关掉占用端口的程序，或在面板设置里改用其他端口，记得同步修改环境变量里的 BASE_URL。

Q: 想在 Aider 里专门用 Kiro 的免费 Sonnet？

把 URL 改成 http://localhost:18765/kiro 即可，OpenRelay 支持按 Provider 路径路由。

Q: 这工具会不会盗用我的 Claude Pro 账号？

不会。OpenRelay 只是把你本地已经登录的订阅 cookie / token 转发给同一个官方 API，所有凭据始终在你机器上，源码开源可审计。