OpenRelay 完整教程:一个订阅驱动所有 AI 工具

你有 Claude Pro 订阅,但只能在 Claude Desktop 里用。你有 Kiro 的免费额度,但只能在 Kiro 里用。你有 Groq 的免费 API,但 Cursor 不支持。

OpenRelay 解决的就是这个问题 — 把你所有的 AI 配额聚合到一个本地代理,任何工具都能用。

核心能力

  • 聚合配额:32 个 Provider 的免费额度合并(Groq、Cerebras、SambaNova、Gemini、Kiro、NVIDIA NIM 等)
  • 自动 failover:一个用完自动切下一个,AI 永不断线
  • 一键接入 IDE:Cursor、Claude Code、Windsurf、Aider、VS Code Copilot
  • 自动发现:启动后自动扫描本机已有的 Claude Desktop、Kiro 等凭证
  • 本地运行:请求直连 Provider,不过第三方服务器

安装(1 分钟)

单文件可执行,不需要 Node.js 或 Python。

macOS (Apple Silicon)

curl -L -o openrelay https://github.com/platoba/openrelay/releases/latest/download/openrelay-macos-arm64

chmod +x openrelay && ./openrelay

Windows:从 Releases 下载 exe,双击运行。

Linux

curl -L -o openrelay https://github.com/platoba/openrelay/releases/latest/download/openrelay-linux-x64

chmod +x openrelay && ./openrelay

启动后浏览器打开 http://localhost:18765 — Web 管理面板。

配置免费 Provider

在 Web 面板中添加你的免费 API Key:

详细的各家免费额度对比,请看 yangmao.ai 厂商对比

模型组(Killer Feature)

把多个 Provider 合并成一个虚拟模型:

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

Groq 额度用完 → 自动切 Cerebras → 再切 SambaNova。在 Web 面板的"模型组"区块中配置。

接入开发工具

通用方式(环境变量)

export OPENAI_BASE_URL=http://localhost:18765

export OPENAI_API_KEY=unused

API_KEY 随便填,OpenRelay 在本地管理真实凭证。

指定 Provider(路径路由)

  • localhost:18765/kiro → Kiro 的免费 Claude Sonnet
  • localhost:18765/groq → Groq 免费推理
  • localhost:18765/gemini → Gemini 免费 100 万上下文
  • localhost:18765/nvidia → NVIDIA NIM 免费模型

接入 Claude Code

export ANTHROPIC_BASE_URL=http://localhost:18765/kiro

export ANTHROPIC_API_KEY=unused

claude

接入 Aider

export OPENAI_BASE_URL=http://localhost:18765/groq

export OPENAI_API_KEY=unused

aider --model openai/llama-3.3-70b

接入 Cursor

OpenRelay 通过 RPC 代理直接注入 Cursor,在 Web 面板的"IDE 代理"区块中一键开启。

推荐搭配

  • Claude Code → 走 Kiro(免费 Claude Sonnet,最匹配)
  • Aider → 走 Groq(免费,推理速度极快)
  • Goose → 走 Gemini(免费,100 万上下文)
  • OpenCode → 走 DeepSeek(最便宜的编程模型)
  • 日常对话 → 走 NVIDIA NIM(100+ 模型随便选)

注意事项

安全提醒:OpenRelay 是闭源二进制,会读取本机 AI 凭证。如果有顾虑,只手动输入 Key,不用自动发现。

商业授权:Open Core 模式。基础代理免费(MIT),模型组等高级功能可能需要商业授权。

替代方案:不想维护本地代理时,可以比较官方平台、开源网关和商业 API 网关。重点看隐私、日志、价格、模型覆盖和 fallback 能力,不要只看“一个 Key”是否省事。

常见问题

Q: 会被 Provider 封号吗?

不会。OpenRelay 纯本地运行,请求直连 Provider,和你手动调 API 没区别。

Q: 支持哪些 IDE?

Claude Code、Kiro、Windsurf、Cursor、VS Code Copilot、Aider、OpenCode、Goose、Continue 等。

---

更多免费 AI 工具和资源,请访问 yangmao.ai — 42 家 AI 厂商免费额度完整指南。