
OpenRelay 核心原理拆解如何实现 Anthropic 与 OpenAI API 的无缝互转【免费下载链接】openrelay几百个免费 AI 模型配额一键接入本地项目。| Hundreds of free AI model quotas, one-click access to local projects.项目地址: https://gitcode.com/gh_mirrors/openrel/openrelayOpenRelay 是一款开源的本地 AI 代理工具它在本机自动发现数十个免费 AI 模型配额并以统一端点同时提供 Anthropic Messages 与 OpenAI Chat Completions 两种 API通过双向格式转换让任意配额驱动任意工具。本文拆解它的核心原理格式互转、凭据发现、IDE 透明代理与配额故障转移。先通过下面的演示动图直观感受 OpenRelay 的运行效果为什么 API 互转是个难题 目前主流 AI 生态分裂成两套 API 标准对比维度Anthropic Messages APIOpenAI Chat Completions API请求端点/v1/messages/v1/chat/completions鉴权头x-api-keyanthropic-versionAuthorization: Bearer系统提示独立的system字段拼进messages的role: system工具调用toolstool_use块functionstool_calls流式输出message_start/content_block_delta等事件chat.completion.chunk增量这意味着什么Claude Pro 的配额只能给会讲 Anthropic 协议的工具用Groq、DeepSeek 等 OpenAI 兼容服务又只认 OpenAI 协议。工具被配额锁死配额被工具锁死——这就是 OpenRelay 要拆掉的墙。核心架构一台机器、一个端点、两个网关OpenRelay 的架构可以概括为一句话在你本机起一个代理服务器默认localhost:18765同时挂两个网关你的工具 (Claude Code / Aider / Cursor...) │ ▼ OpenRelay 本地代理 :18765 ├── POST /v1/messages ← Anthropic 格式网关 └── POST /v1/chat/completions ← OpenAI 格式网关 │ ▼ 格式双向转换层消息结构 / 工具调用 / 流式事件 │ ▼ 任意 ProviderClaude Desktop / Kiro / Groq / DeepSeek / Ollama ...关键设计有三个双向转换客户端发 Anthropic 格式、后端是 OpenAI 服务商时请求转成 OpenAI 格式响应再转回 Anthropic 格式反过来也一样。双向能力由 CHANGELOG.md 中的 API Compatibility 一节明确列出且完整支持 tool/function calling 与流式streaming non-streaming。流式 SSE 逐事件映射两边的流式事件类型完全不同转换层会把 Anthropic 的content_block_delta序列映射为 OpenAI 的 chunk 增量反之亦然因此客户端的打字机效果不会断。直连后端AI 请求从你的机器直接发给所选 ProviderOpenRelay 官方服务器不在请求链路中纯本地转发。配额从哪来本机凭据自动发现 代理有了真正的难点是把已有订阅变成可用端点。OpenRelay 内置了 45 个非虚拟 Provider分两类本地/CLI/IDE 类11 个Claude Desktop、Claude Code、Kiro、Windsurf、Antigravity、VS Code Copilot 等。OpenRelay 会读取这些已登录应用本机的会话凭据直接复用你的订阅配额。API/本地端点类34 个Groq、Cerebras、Gemini API、DeepSeek、Ollama 等。填一次 API Key全工具复用。以 Claude Desktop 为例凭据发现过程涉及系统级加密解密核心逻辑在 src/cookie.ts 中macOS从 Keychain 读取 Claude Safe Storage 口令用 PBKDF2 派生 AES-128-CBC 密钥解密 Cookies 数据库中的sessionKey、cf_clearance等字段Windows从Local State读取 DPAPI 保护的主密钥用 AES-256-GCM 解密同样的 Cookie 数据库。这段代码完全公开、可审计。凭据只读不写、仅驻留内存不会上传到任何第三方——细节见 PRIVACY.md。任意配额接入任意工具一键配置与 IDE 透明代理格式互转打通后接入工具只需改一个环境变量。例如让 Claude Code 走 Kiro 配额export ANTHROPIC_BASE_URLhttp://localhost:18765/kiro export ANTHROPIC_API_KEYunused更省事的是 Web 面板的Work标签页为 Claude Code、Aider、Goose、OpenClaw 等工具分别选择 Provider点一下开关OpenRelay 自动写好 shell 环境配置重开终端即生效不用手改.zshrc。IDE 场景走的是另一条路线——RPC 透明代理。Cursor、Windsurf 这类 IDE 不走标准 HTTP API而是通过私有 RPC 协议通信。OpenRelay 为每个 IDE 单独起了一个代理端口Cursor:18780、Windsurf:18766、Antigravity:18767、VS Code Copilot:18769把 IDE 的私有请求劫持并转换到任意 ProviderIDE 端无感切换。模型组配额用完自动故障转移 ⚡单个免费配额总有耗尽的时候。OpenRelay 的Custom标签页可以把多个 Provider 合并成一个虚拟模型fast-group Groq (Llama 90B) Cerebras (Llama 70B) SambaNova (Llama 405B)客户端只需要把model参数填成fast-group路由层按轮询 故障转移策略分发Groq 限流 → 自动切 Cerebras → 再切 SambaNova全程无需人工干预。安全与隐私设计速览凭据不离开本机Token/Cookie 只在本机内存中使用API Key 存在本地~/.openrelay/直连 AI 后端请求链路中没有任何第三方服务器与反代有本质区别详见 faq.md 的封号风险说明默认不记录提示词日志只含请求元数据Provider、模型、状态码消息内容不落盘代码可审计凭据处理核心 src/cookie.ts 公开可查。快速上手 下载对应平台的单文件二进制Windows x64 / macOS / Linux无需 Node.js 环境运行后浏览器打开http://localhost:18765在 Provider 面板确认已发现的本地配额绿点 已连接需要时在侧边栏为 API 服务商填入 Key在 Work 标签页为目标工具选择 Provider 并开启重开终端即可。更多原理细节与常见问题可查阅项目仓库内的 README.md、faq.md中文与 faq-en.md英文。框架部分代理、格式转换、配置采用 MIT 许可证模型组等 Pro 功能为商业授权LICENSE / COMMERCIAL-LICENSE.txt。总结OpenRelay 的本质是一个格式翻译官 配额调度器——用双向 API 转换抹平 Anthropic 与 OpenAI 的协议差异用本机凭据发现盘活闲置订阅再用模型组兜底限流。理解这三层你就理解了它如何让几百个免费 AI 模型配额真正一键接入你的本地项目。【免费下载链接】openrelay几百个免费 AI 模型配额一键接入本地项目。| Hundreds of free AI model quotas, one-click access to local projects.项目地址: https://gitcode.com/gh_mirrors/openrel/openrelay创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考