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 模型组合功能）

✨ 核心亮点

🔍

自动发现订阅

扫描 8 大 IDE 订阅 + 24 家 API，零手工配置

🆓

海量免费配额

Groq 14400 req/天、Cerebras 1M token/天、Gemini 1M 上下文

🖱️

一键切换工具

Web 面板点开关，Claude Code/Aider/Goose 全部生效

🔌

IDE 无缝接入

Cursor/Windsurf/VS Code Copilot/Antigravity 全支持

♾️

永不停机

多家配额合并虚拟模型，自动跨厂商故障转移

🛡️

本地安全

凭据只在内存，请求直连，不上传不日志

📦 下载安装

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

Windows 用户

从 Releases 页面下载 openrelay-windows-x64.exe，双击运行即可。

macOS 用户（Intel / Apple Silicon 通用）

下载 openrelay-macos，终端执行：

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

xattr 命令用于解除 Gatekeeper 限制，否则会提示"无法打开"。

Linux 用户（x64）

下载 openrelay-linux-x64，终端执行：

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

Linux 仅支持 Claude Code、Kiro、Windsurf、OpenCode、VS Code Copilot、OpenAI Codex 这些 IDE Provider。

✅

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

🚀 三步用起来

打开面板，看自动发现的 Provider

启动 OpenRelay 后访问 http://localhost:18765，进入 Provider 面板，本机所有 AI 订阅会自动列出来——Claude Desktop、Kiro、Windsurf、Codex 等都不需要手填 Key。

需要直连 API（Groq、Gemini、DeepSeek 等）时，在对应卡片输入一次 API Key，所有工具立刻可用。

给 CLI 工具一键路由（Work 面板）

进入 Work 面板，给每个 CLI 工具选一个 Provider，点开关：

Claude Code → 走 Kiro（免费 Claude Sonnet）
Aider → 走 Groq（免费、极速推理）
Goose → 走 Gemini API（免费 100 万上下文）
OpenCode → 走 DeepSeek（最便宜的编程模型）

重开终端，全部生效。再不用编辑 .zshrc。

如果想手动接入任意工具，只需设置环境变量：

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

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

给 IDE 接入外部配额（IDE 面板）

Cursor 烧光 500 次？Windsurf 额度用完？在 IDE 面板 启动对应代理：

Cursor → RPC 代理（ConnectRPC + HTTP/2），用任意 Provider 替换
Windsurf → RPC 代理，替换内置模型
VS Code Copilot → Ollama BYOK 桥接，任意模型当 Copilot 后端
Antigravity → Gemini REST 代理

IDE 完全无感，照常写代码。

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

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

                Custom Group
                "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，所有凭据始终在你机器上，源码开源可审计。