打破模型封锁！OpenCodex + NVIDIA NIM 完全指南：让 Codex/Claude Code/Grok 跑任意大模型！

「OpenAI 只让用 GPT？Anthropic 只让用 Claude？今天，这一切结束了。」

一篇保姆级教程，手把手教你用OpenCodex打通NVIDIA NIM，让 Codex CLI、Claude Code、Grok Build 三大编码神器全部解锁任意模型。DeepSeek、Llama、MiniMax、Kimi……想用哪个用哪个。

📖 目录

1. 一句话看懂 OpenCodex
2. 为什么你需要它？
3. OpenCodex 到底是什么？
4. 它和 AutoForge 有什么区别？
5. 准备工作
6. 安装 OpenCodex
7. 配置 NVIDIA NIM
8. 绑定 Codex CLI
9. 绑定 Claude Code
10. 绑定 Grok Build
11. Web 仪表盘使用指南
12. 七大踩坑实录
13. 日常使用命令大全
14. 进阶玩法
15. 总结

1. 一句话看懂 OpenCodex

OpenCodex 是一个"翻译官 + 路由器"。

它坐在你的电脑里（localhost:10100），把 Codex、Claude Code、Grok Build 发出来的"OpenAI 方言"，翻译成 NVIDIA NIM、DeepSeek、Kimi 等任意供应商能听懂的"方言"。

你输入: codex "写一个快速排序" ↓ Codex CLI（以为自己在跟 OpenAI 说话） ↓ OpenCodex（翻译 + 路由）localhost:10100 ↓ NVIDIA NIM（实际执行：DeepSeek / Llama / MiniMax） ↓ 结果返回给你

核心效果：你用的还是熟悉的 Codex 界面，但背后跑的是你想用的任意模型。

2. 为什么你需要它？

😤 原生工具的"霸王条款"

🎉 OpenCodex 带来的自由

• ✅40+ 供应商：NVIDIA NIM、DeepSeek、Kimi、Gemini、Ollama、Groq……
• ✅102+ 模型：从 8B 小模型到 550B 超大模型，随你挑
• ✅零代码改动：Codex/Claude/Grok 的界面完全不变
• ✅本地代理：数据走本地，安全可控
• ✅组合路由：一个模型挂了自动切另一个

3. OpenCodex 到底是什么？

技术本质

OpenCodex 是一个基于Bun 运行时的本地代理服务器。它做三件事：

1. 协议翻译：把 OpenAI 的 Responses API 翻译成各供应商的原生协议
2. 模型发现：自动拉取供应商的/v1/models列表
3. 请求路由：根据你指定的模型，把请求转发到正确的供应商

支持的客户端

• 🟢Codex CLI（OpenAI 官方编码工具）
• 🟢Claude Code（Anthropic 官方编码工具）
• 🟢Claude Desktop
• 🟢Grok Build（xAI 终端编码工具）

支持的供应商（部分）

4. 它和 AutoForge 有什么区别？

很多人搜"让 Claude Code 长期运行"会找到AutoForge，但它和 OpenCodex 完全不同：

一句话：AutoForge 解决的是"任务怎么拆"，OpenCodex 解决的是"模型怎么换"。两者不冲突，但 AutoForge 已被官方功能取代，OpenCodex 目前无可替代。

5. 准备工作

5.1 安装 Node.js

OpenCodex 需要 Node.js 18+。

# 检查版本node--version# 输出应 >= v18.0.0

如果未安装，去 nodejs.org 下载 LTS 版。

5.2 获取 NVIDIA NIM API Key

1. 访问 build.nvidia.com
2. 登录/注册账号
3. 点击右上角头像 ➜“API Keys”
4. 生成 Key，格式为nvapi-xxxxxxxxxxxxxxxx

💡免费额度：NIM 提供一定的免费调用额度（约 40 RPM），足够日常测试和轻度使用。

5.3 安装目标客户端（至少装一个）

# 安装 Codex CLI（推荐必装）npminstall-g@openai/codex# 安装 Claude Code（可选）# macOS/Linux:curl-fsSLhttps://claude.ai/install.sh|bash# Windows:irm https://claude.ai/install.ps1|iex# 安装 Grok Build（可选，需订阅）irm https://x.ai/cli/install.ps1|iex

6. 安装 OpenCodex

6.1 全局安装

npminstall-g@bitkyc08/opencodex

安装时会自动下载并捆绑 Bun 运行时，不需要单独安装 Bun，Windows 也不需要 WSL。

6.2 启动代理

ocx start

你会看到：

• 终端显示代理启动日志
• 浏览器自动弹出http://localhost:10100
• 看到 OpenCodex 的 Web 仪表盘，说明成功 🎉

6.3 常用启动方式

ocx start# 前台启动（当前窗口运行，Ctrl+C 停止）ocx start--port8888# 自定义端口ocxserviceinstall# 安装为后台服务（Windows/macOS/Linux 都支持）ocxservicestart# 启动后台服务

💡建议：日常使用装后台服务，这样不用每次都手动启动。

7. 配置 NVIDIA NIM

7.1 方式一：Web 仪表盘（最简单）

1. 浏览器打开http://localhost:10100
2. 左侧菜单点击“提供方”（Providers）
3. 点击“Add Provider”按钮
4. 在列表中找到NVIDIA NIM，点击添加
5. 粘贴你的 API Key：nvapi-xxxxxxxxxxxxxxxx
6. 点击保存

几秒钟后，你会看到：

• 连接状态变为 ✅Connected
• 模型数量显示（如102 models available）
• 延迟显示（如Latency: 90 ms）

7.2 方式二：命令行（适合脚本化）

# 添加 NVIDIA NIM 提供商ocx provideraddnvidia --api-key"nvapi-你的密钥"# 测试连接ocx providertestnvidia# 预期输出：# nvidia: connected# Connected — 102 models available.# Latency: 90 ms# 设为默认提供商（这样不用每次指定）ocx provider set-default nvidia# 查看所有已配置提供商ocx provider list

7.3 NVIDIA NIM 热门模型一览

配置完成后，你可以在仪表盘或命令行看到所有可用模型。以下是常用的几个：

💡新手推荐：先用DeepSeek V4 Flash，免费且能力强。

8. 绑定 Codex CLI

Codex CLI 是 OpenAI 官方的终端编码工具，原生只支持 OpenAI 模型。通过 OpenCodex 绑定后，它就能调用 NIM 的任意模型。

8.1 交互式初始化

ocx init

你会看到交互式菜单，关键选择：

1. 选择默认提供商：选第 9 项 “OpenAI API”

   • ❌ 不要选 Claude
   • ❌ 不要选 Grok
   • ✅ 必须选OpenAI API（因为 Codex 只认 OpenAI 协议，OpenCodex 会伪装成 OpenAI 服务器）

2. 输入 API Key：随便填一个占位符，比如sk-dummy

   • 这个 Key 不会被真正使用，OpenCodex 会把它替换为你的 NIM Key

3. 输入 Base URL：确认或输入http://127.0.0.1:10100/v1

4. 选择默认模型：从列表中选择你想要的 NIM 模型，如nvidia/deepseek-ai/deepseek-v4-flash

8.2 验证配置

初始化完成后，检查 Codex 配置文件：

# Windowscat"$env:USERPROFILE\.codex\config.toml"# macOS/Linuxcat~/.codex/config.toml

正确的配置应该类似这样：

model = "nvidia/deepseek-ai/deepseek-v4-flash" model_provider = "ocx" [model_providers.ocx] name = "OpenCodex" base_url = "http://127.0.0.1:10100/v1" env_key = "OPENAI_API_KEY" wire_api = "responses"

⚠️注意：model_provider必须写成"ocx"或其他自定义名字，不能写成"openai"，因为 Codex 把"openai"当作保留内置 provider，会报错。

8.3 启动 Codex

# 使用默认模型启动codex"写一个 Python 快速排序"# 临时切换到其他模型codex-m"nvidia/minimaxai/minimax-m3""分析这段代码的 bug"# 全自动模式（无需每次确认执行）codex --approval-mode full-auto"重构这个项目的日志模块"

如果成功，你会看到 Codex 的 TUI 界面弹出，并且回复来自你指定的 NIM 模型！

9. 绑定 Claude Code

Claude Code 是 Anthropic 的终端编码工具，原生只支持 Claude 模型。绑定方式和 Codex 几乎一样。

9.1 初始化

ocx init

同样选择OpenAI API作为 provider，配置同上。

9.2 启动

claude

Claude Code 启动后，所有的 API 请求都会先走到 OpenCodex，再被转发到 NVIDIA NIM。

⚠️风险提示：Anthropic 的服务条款可能不允许通过第三方代理访问。虽然 OpenCodex 只是本地代理，但建议了解相关条款。OpenCodex 官方也在文档中明确标注了此风险。

10. 绑定 Grok Build

Grok Build 是 xAI 的终端编码工具，原生只支持 Grok 模型，且需要付费订阅。

10.1 检查 Grok 安装

# Windowsgrok--version# 如果找不到，添加 PATH$env:PATH+=";$env:USERPROFILE\.grok\bin"# 永久添加（需重启 PowerShell）[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path","User")+";$env:USERPROFILE\.grok\bin","User")

10.2 验证 OpenCodex 注入

ocx grok

预期输出：

configPath: C:\Users\xxx\.grok\config.toml present: true baseUrl: http://127.0.0.1:10100/v1 models: 105 item(s) candidates: 105 item(s)

这说明 OpenCodex 已经把 NIM 的 105 个模型注入到 Grok Build 的配置中了。

10.3 启动 Grok Build

# 交互式 TUIgrok# 单次执行grokexec"写一个 Python 快速排序"# 计划模式（先出方案，你批准后再执行）grok plan"重构认证模块"# 长期自主运行（自动执行直到完成）grok goal"让所有单元测试通过"# 竞技场模式（8 个代理并行解决同一问题）grok arena"修复内存泄漏"

11. Web 仪表盘使用指南

OpenCodex 的 Web 仪表盘非常实用，地址是http://localhost:10100。

11.1 主要功能区域

11.2 "启动安全"页面解读

在集成 ➜ 启动安全页面，你会看到几个状态：

12. 七大踩坑实录

以下都是我在配置过程中真实踩过的坑，附完整解决方案。

🕳️ 坑 1：Codex 的/model命令无法显示 NIM 模型

现象：在 Codex TUI 里按/进入模型选择，只能看到 OpenAI 的 GPT 模型，看不到任何 NIM 模型。

原因：Codex CLI 的/model菜单只读取内置的 OpenAI 模型列表，对自定义 provider 完全无视。如果你强行选一个，它会覆盖config.toml，导致配置损坏。

解决：永远不要在 TUI 里用/model切换。改用命令行参数：

codex-m"nvidia/deepseek-ai/deepseek-v4-flash""你的提示词"

🕳️ 坑 2：model_provider = "openai"报错

现象：

Error loading config.toml: model_providers contains reserved built-in provider IDs: `openai`. Built-in providers cannot be overridden.

原因：Codex 把"openai"当作保留内置 provider，不允许用户覆盖。

解决：自定义 provider 名字不能用"openai"，改用"ocx"、"nim"、"custom"等：

model_provider = "ocx" [model_providers.ocx] name = "OpenCodex" base_url = "http://127.0.0.1:10100/v1"

🕳️ 坑 3：ocx service install权限不足

现象：

WindowsSchtasksError: Windows access denied while running Task Scheduler. Approve the Windows UAC prompt, or run from an elevated PowerShell window.

原因：安装 Windows 计划任务需要管理员权限。

解决：右键点击 PowerShell 图标 ➜“以管理员身份运行”，再执行：

ocxserviceinstallocxservicestart

🕳️ 坑 4：ocx sync提示free-claude-code冲突

现象：

Codex routing NOT injected: config.toml selects the external model_provider "free-claude-code". OpenCodex preserves external provider configuration.

原因：Codex 之前配置过免费 Claude Code provider，OpenCodex 为了保护现有配置没有强行覆盖。

解决：先还原再重新初始化：

ocx restore# 还原 Codex 原生配置ocx init# 重新绑定到 OpenCodex

🕳️ 坑 5：Grok Build 命令找不到

现象：

grok : 无法将"grok"项识别为 cmdlet、函数、脚本文件或可运行程序的名称。

原因：Grok 安装在$env:USERPROFILE\.grok\bin，但该目录不在系统 PATH 中。

解决：

# 临时（当前窗口有效）$env:PATH+=";$env:USERPROFILE\.grok\bin"# 永久（需重启 PowerShell）[Environment]::SetEnvironmentVariable("Path",[Environment]::GetEnvironmentVariable("Path","User")+";$env:USERPROFILE\.grok\bin","User")

🕳️ 坑 6：NIM 模型 ID 格式错误

现象：请求报错model not found或类似错误。

原因：NIM 的模型 ID 是完整路径格式，如deepseek-ai/deepseek-v4-flash，不是简单的deepseek-v4。

解决：在 OpenCodex 仪表盘里查看完整的模型列表，复制准确的模型 ID。常见正确格式：

nvidia/deepseek-ai/deepseek-v4-flash nvidia/meta/llama-3.3-70b-instruct nvidia/minimaxai/minimax-m3

🕳️ 坑 7：代理没启动就测试 provider

现象：

ocx providertestnvidia# Error: Proxy is not running. Start it with: ocx start

原因：所有 provider 操作（test、list models、sync）都需要代理先运行。

解决：

ocx start# 先启动代理# 然后另开窗口测试ocx providertestnvidia

13. 日常使用命令大全

OpenCodex 代理管理

ocx start# 前台启动代理ocx start--port8888# 指定端口启动ocx stop# 停止代理ocxserviceinstall# 安装后台服务（管理员权限）ocxservicestart# 启动后台服务ocxservicestatus# 查看服务状态ocxserviceuninstall# 卸载服务ocx status# 查看代理状态ocx doctor# 全面健康检查ocx health# 快速健康检查ocx gui# 打开 Web 仪表盘ocx update# 更新到最新版ocx uninstall# 完全卸载

提供商管理

ocx provider list# 列出所有已配置提供商ocx provideraddnvidia --api-key"xxx"# 添加 NVIDIA NIMocx providertestnvidia# 测试连接ocx provider show nvidia# 查看详细配置ocx provider set-default nvidia# 设为默认ocx provider remove nvidia# 删除提供商

Codex CLI 使用

codex"提示词"# 用默认模型启动codex-m"nvidia/模型ID""提示词"# 临时指定模型codex --approval-mode full-auto# 全自动模式codex-m"nvidia/deepseek-ai/deepseek-v4-flash"--approval-mode full-auto"任务"

Claude Code 使用

claude# 启动（已通过 OpenCodex 代理）

Grok Build 使用

grok# 交互式 TUIgrokexec"任务"# 单次执行grok plan"任务"# 计划模式grok goal"任务"# 长期自主运行grok arena"任务"# 竞技场模式（8 代理并行）

14. 进阶玩法

14.1 组合路由（故障转移）

NIM 免费层有 40 RPM 限流，可以配置多个提供商做故障转移：

# 创建组合：优先 NIM，限流时自动切到 DeepSeekocx comboaddmycombo--providersnvidia,deepseek--modefailover# 使用组合codex-m"mycombo""写一个复杂算法"

14.2 子代理路由（Codex 多代理）

Codex 支持最多 8 个并行子代理。你可以让不同子代理用不同模型：

# 配置子代理模型映射ocx v2 setup

然后在 Codex 里按/选择子代理时，每个子代理会走你配置的模型。

14.3 远程访问（局域网共享）

默认 OpenCodex 只监听127.0.0.1。如果想让局域网其他设备访问：

# 设置认证 Token$env:OPENCODEX_API_AUTH_TOKEN="your-secret-token"# 启动（监听所有网卡）ocx start--host0.0.0.0

其他设备通过http://你的IP:10100/v1访问，请求头需携带x-opencodex-api-key。

15. 总结

OpenCodex 的核心价值可以用一句话概括：

“它不改变你熟悉的工具，只改变工具背后的模型。”

你依然可以用 Codex 漂亮的 TUI、Claude 的智能交互、Grok 的竞技场模式——但背后跑的是 DeepSeek、Llama、MiniMax 或任何你想试的模型。这才是 2026 年 AI 编码应有的自由度。

📚 参考链接

• 🔗OpenCodex GitHub: github.com/lidge-jun/opencodex
• 🔗NVIDIA NIM: build.nvidia.com
• 🔗Codex CLI: github.com/openai/codex
• 🔗Claude Code: docs.anthropic.com/claude-code
• 🔗Grok Build: x.ai

📝版权声明：本文为原创技术教程，转载请注明出处。

⭐如果对你有帮助，欢迎点赞、收藏、转发！有任何问题欢迎在评论区交流。

本文基于 OpenCodex v2.10.2 + Codex CLI v0.146.1 + NVIDIA NIM 实测整理。