别再手改环境变量了:OpenRelay 一键配置 Claude Code、Aider、Goose 全攻略
【免费下载链接】openrelay几百个免费 AI 模型配额,一键接入本地项目。| Hundreds of free AI model quotas, one-click access to local projects.项目地址: https://gitcode.com/gh_mirrors/openrel/openrelay
如果你用 Claude Code、Aider 或 Goose 这类 AI 编程工具,一定遇到过"改个模型就要手翻环境变量"的挫败感。OpenRelay 是一个本地 AI 配额聚合代理:自动发现你机器上的几百个免费 AI 模型配额(Claude、Kiro、Groq、Gemini 等),聚合成一个本地端点,并在 Web 面板里一键完成 Claude Code、Aider、Goose 的配置,不用再手动编辑.zshrc。
为什么你还在手改环境变量?
我们手里的 AI 配额往往被"锁死"在各自的工具里:
- Claude Pro订阅只能在 Claude Desktop 用,终端工具用不上
- Kiro 的免费额度只在 Kiro IDE 里生效
- Groq又快又免费,但每个工具都要单独配一遍
- Cursor 的 500 次用完了,只能干等着
传统解法是在每个工具里手写ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY,改一次重启一次终端,还容易配错。OpenRelay 的思路是把这道"配额孤岛"打破:自动发现 45 个 AI 来源,统一暴露给你——
| 接口格式 | 端点 | 适合的工具 |
|---|---|---|
| Anthropic 格式 | http://localhost:18765 | Claude Code、Goose |
| OpenAI 格式 | http://localhost:18765/v1/chat/completions | Aider、Continue |
5 分钟安装:无需 Node 环境
OpenRelay 是一个独立可执行文件,开箱即用,不需要npm install:
- Windows:下载最新的
openrelay-windows-x64.exe,双击运行 - macOS / Linux:下载对应平台的可执行文件,终端执行
chmod +x后运行
启动后浏览器打开http://localhost:18765,所有操作都在 Web 面板完成,支持中英双语。
一键配置 Claude Code、Aider、Goose:3 步完成
面板 3 步操作,告别手改环境文件
打开Work标签页,每个 CLI 工具都是一张配置卡片:
- 选择应用—— Claude Code、Aider、Goose、OpenCode、VS Code (Continue) 等
- 选择 Provider 和模型—— 例如 Claude Code 走 Kiro、Aider 走 Groq、Goose 走 Gemini API
- 打开开关—— OpenRelay 自动写好该工具的配置文件,重新打开终端即生效
对比一下"以前"的配置方式:
# 旧方式:每个工具手动设环境变量,改个模型再改一遍 export ANTHROPIC_BASE_URL=http://localhost:18765 export ANTHROPIC_API_KEY=unused现在只需点一下开关,OpenRelay 会直接为每个工具生成对应的配置文件,之后换 Provider 也是面板里拨一下即可。
每个工具怎么选 Provider?
| 工具 | 推荐路由 | 理由 |
|---|---|---|
| Claude Code | Kiro / Claude Desktop | Anthropic 协议直连,吃满账户配额 |
| Aider | Groq | 低延迟推理,补码响应快 |
| Goose | Gemini API | 百万 token 大上下文,适合大型仓库 |
| OpenCode | DeepSeek | 性价比最高的编程模型之一 |
免费额度用完怎么办?模型组自动故障转移
免费配额最现实的问题是:用到一半就限流。在Custom标签页(Pro 功能)里,可以把多个 Provider 的配额组合成一个虚拟模型:
"fast-group" = Groq (Llama 90B) + Cerebras (Llama 70B) + SambaNova (Llama 405B)Groq 额度用完 → 自动切 Cerebras → 再自动切 SambaNova。Aider、Goose 等工具完全无感知,调的还是同一个模型名,不用中途停下来换 Provider。
进阶:Cursor、Windsurf 也能"借配额"
Cursor 或 Windsurf 额度烧完了?别停下编码。打开面板IDE标签页,为对应 IDE 选一个任意 Provider,点击启动:
- Cursor / Windsurf:RPC 代理,把内置模型替换成 Kiro、Groq 等任意配额
- VS Code Copilot:Ollama BYOK 桥接,任何模型都能当后端
IDE 不会察觉模型已经换源,写代码的节奏完全不打断。
安全疑虑:凭据真的安全吗?
很多人的第一反应是:它会读我的登录态,会不会泄露 API Key?OpenRelay 的设计原则很直接:
- 📍凭据留在本机—— Token / Cookie 只在本机读取,仅用于连接原供应商
- 📡直连 AI 后端—— 请求从你的机器直接发给 Provider,官方服务器不在请求链路上
- 🤫默认不记录聊天内容—— 日志只有元数据(Provider、模型、状态码)
- 🔍代码可审计—— 凭据处理核心代码 src/cookie.ts 公开可查
更多细节见 PRIVACY.md 与 DISCLAIMER.md。
常见问题:配好了为什么没生效?
Q:开了开关,工具还是连不上原来的地址?A:绝大多数情况是没重开终端——配置文件和新环境变量只对新会话生效。
Q:报connection refused?A:OpenRelay 没在运行,先启动程序再打开面板即可。
Q:会不会导致封号?A:不会。OpenRelay 纯本地运行,请求由你的机器直连 Provider,和手动调 API 没有任何区别。
完整排查清单见 faq.md。
动手吧:4 步彻底告别手改环境变量
- 从 Releases 下载 OpenRelay 对应平台的可执行文件并运行
- 打开
http://localhost:18765,确认已自动发现的 Provider - 在Work标签页为 Claude Code、Aider、Goose 打开开关
- 新开一个终端继续写代码 🚀
完整功能介绍与安装细节请参考项目 README.md。
【免费下载链接】openrelay几百个免费 AI 模型配额,一键接入本地项目。| Hundreds of free AI model quotas, one-click access to local projects.项目地址: https://gitcode.com/gh_mirrors/openrel/openrelay
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考