Codex + OpenRelay：国内用户玩转 OpenAI Codex 的最佳方案——墨涩网

对于国内开发者来说，OpenAI Codex 是个好东西——GPT-5.5 编程特化模型，能理解整个代码仓库、自动写代码、跑测试、修 Bug。但有个硬伤：国内网络直连不了 OpenAI API。

以前的解决方案要么是找中转站（依赖第三方），要么自建 Nginx 反向代理（需要海外 VPS）。今天五哥介绍一个更优雅的方案——OpenRelay，一个开源的本地 AI 代理网关，启动一条命令，Codex 直接能用，还能顺便把你的 Claude、Groq、Kiro 等散落配额全部聚合起来。

OpenRelay 是什么？

OpenRelay 是由开发者 romgX 构建的开源 AI 代理工具，核心解决的是"AI 订阅孤岛"的问题。它运行在本地，自动扫描你电脑上散落的各种 AI 配额（IDE 内置配额、浏览器 Cookie、API Key），然后聚合成一个标准的 OpenAI/Anthropic 兼容 API 端点（http://localhost:18765）。

支持的提供商多达 32 个：

• IDE 类：Cursor、Windsurf、VS Code Copilot、Kiro、Antigravity、OpenCode 等
• API 直连类：OpenAI、Anthropic、Google Gemini、Groq、DeepSeek、Cerebras、SambaNova 等
• 桌面应用类：Claude Desktop、Claude Code 等

安装 OpenRelay

1. 下载二进制

从 GitHub Releases 下载对应平台的文件：

• macOS Apple Silicon：openrelay-macos-arm64
• macOS Intel：openrelay-macos-x64
• Linux x86_64：openrelay-linux-x64
• Windows：openrelay-windows-x64.exe

2. 赋予执行权限

# macOS / Linux
chmod +x openrelay-macos-arm64

# macOS 需要解除隔离（未签名应用）
xattr -d com.apple.quarantine openrelay-macos-arm64

3. 启动

./openrelay-macos-arm64

服务启动在 http://localhost:18765，浏览器打开就能看到管理面板，支持中英双语。首次启动会自动扫描本地可用的 AI 配额。

配置 Codex CLI 接入 OpenRelay

OpenRelay 启动后，只需要设置两个环境变量，Codex CLI 就能用了：

export OPENAI_BASE_URL=http://localhost:18765
export OPENAI_API_KEY=unused

然后正常启动 Codex：

codex

输入 /status 查看状态，如果 Model provider 显示为 localhost:18765，说明配置成功。Codex 的所有请求会通过 OpenRelay 转发到你配置的后端模型。

Web 面板一键配置（更简单）

打开 http://localhost:18765，在"工具配置"页面选择 Codex，点击"启用"，面板会直接给出需要执行的命令，复制粘贴到终端就行。

进阶玩法

路径路由：指定 Codex 用哪个提供商

想让 Codex 专门走某个提供商？URL 路径就行：

# Codex 走 Groq（免费高速）
export OPENAI_BASE_URL=http://localhost:18765/groq

# Codex 走 Kiro 免费配额
export OPENAI_BASE_URL=http://localhost:18765/kiro

# Codex 走 DeepSeek（便宜大碗）
export OPENAI_BASE_URL=http://localhost:18765/deepseek

模型组：自动故障转移

在面板中创建模型组，比如把 Groq + DeepSeek + 本地 Ollama 组成一个 "codex-group"。然后：

export OPENAI_BASE_URL=http://localhost:18765/codex-group

当 Groq 配额耗尽返回 429 时，OpenRelay 会在 1 秒内自动切换到 DeepSeek。Codex 完全无感知，写代码不会中断。

多工具共用一个 OpenRelay

OpenRelay 不只是给 Codex 用的。你的 Claude Code、Aider、Cursor 都可以指向它：

# Claude Code / Aider
export ANTHROPIC_BASE_URL=http://localhost:18765
export ANTHROPIC_API_KEY=unused

# Codex / 其他 OpenAI 兼容工具
export OPENAI_BASE_URL=http://localhost:18765
export OPENAI_API_KEY=unused

一个 OpenRelay 实例，所有 AI 工具共用，配额统一管理。

核心特性

• 自动发现：启动即扫描本地 32 个提供商的凭据，无需手动配置 API Key
• 协议转换：把 Claude Message API、Gemini REST API 等不同协议统一转换为 OpenAI Chat Completions API
• IDE 代理：支持 Cursor RPC 代理、Windsurf RPC 代理，IDE 额度用完也能续命
• 零数据泄露：所有凭据仅在本地内存处理，请求直连 AI 后端，不经过任何中转服务器

总结

Codex + OpenRelay 的组合，是国内用户玩转 OpenAI Codex 的最佳方案之一。相比中转站，它不依赖第三方；相比自建 Nginx，它零配置门槛。而且 OpenRelay 还能把你的 Claude、Groq、Kiro 等散落配额全部聚合，一个入口用尽所有模型。

如果你是 Claude Code + Codex + Cursor 的重度用户，OpenRelay 基本就是必备工具了。

OpenRelay 项目地址：https://github.com/romgX/openrelay

官方文档：https://openrelay.cc