「OpenAI 只让用 GPTAnthropic 只让用 Claude今天这一切结束了。」一篇保姆级教程手把手教你用OpenCodex打通NVIDIA NIM让 Codex CLI、Claude Code、Grok Build 三大编码神器全部解锁任意模型。DeepSeek、Llama、MiniMax、Kimi……想用哪个用哪个。 目录一句话看懂 OpenCodex为什么你需要它OpenCodex 到底是什么它和 AutoForge 有什么区别准备工作安装 OpenCodex配置 NVIDIA NIM绑定 Codex CLI绑定 Claude Code绑定 Grok BuildWeb 仪表盘使用指南七大踩坑实录日常使用命令大全进阶玩法总结1. 一句话看懂 OpenCodexOpenCodex 是一个翻译官 路由器。它坐在你的电脑里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. 为什么你需要它 原生工具的霸王条款工具原生支持你的痛苦Codex CLI只认 OpenAI GPT买了 NIM API 却用不了Claude Code只认 Anthropic Claude想试 DeepSeek 没门Grok Build只认 xAI Grok30美元/月起步模型单一 OpenCodex 带来的自由✅40 供应商NVIDIA NIM、DeepSeek、Kimi、Gemini、Ollama、Groq……✅102 模型从 8B 小模型到 550B 超大模型随你挑✅零代码改动Codex/Claude/Grok 的界面完全不变✅本地代理数据走本地安全可控✅组合路由一个模型挂了自动切另一个3. OpenCodex 到底是什么技术本质OpenCodex 是一个基于Bun 运行时的本地代理服务器。它做三件事协议翻译把 OpenAI 的 Responses API 翻译成各供应商的原生协议模型发现自动拉取供应商的/v1/models列表请求路由根据你指定的模型把请求转发到正确的供应商支持的客户端Codex CLIOpenAI 官方编码工具Claude CodeAnthropic 官方编码工具Claude DesktopGrok BuildxAI 终端编码工具支持的供应商部分类型供应商 官方 APIOpenAI、Anthropic、Google Gemini、xAI、Azure OpenAI 国内大厂DeepSeek、KimiMoonshot、Qwen、MiniMax、SiliconFlow 推理平台NVIDIA NIM、Groq、Together、Fireworks、Cerebras、OpenRouter 本地部署Ollama、vLLM、LM Studio4. 它和 AutoForge 有什么区别很多人搜让 Claude Code 长期运行会找到AutoForge但它和 OpenCodex 完全不同对比项AutoForgeOpenCodex定位Claude Code 的任务编排器通用模型代理网关维护状态❌已废弃作者声明不再维护✅ 活跃更新核心功能把大项目拆成多个会话自动执行让任意客户端调用任意模型支持模型仅 Claude任意模型NVIDIA NIM❌ 不支持✅ 原生支持2026 年还值得用吗❌ 不值得Claude Code 已原生支持长期运行✅ 非常值得一句话AutoForge 解决的是任务怎么拆OpenCodex 解决的是模型怎么换。两者不冲突但 AutoForge 已被官方功能取代OpenCodex 目前无可替代。5. 准备工作5.1 安装 Node.jsOpenCodex 需要 Node.js 18。# 检查版本node--version# 输出应 v18.0.0如果未安装去 nodejs.org 下载 LTS 版。5.2 获取 NVIDIA NIM API Key访问 build.nvidia.com登录/注册账号点击右上角头像 ➜“API Keys”生成 Key格式为nvapi-xxxxxxxxxxxxxxxx免费额度NIM 提供一定的免费调用额度约 40 RPM足够日常测试和轻度使用。5.3 安装目标客户端至少装一个# 安装 Codex CLI推荐必装npminstall-gopenai/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|iex6. 安装 OpenCodex6.1 全局安装npminstall-gbitkyc08/opencodex安装时会自动下载并捆绑 Bun 运行时不需要单独安装 BunWindows 也不需要 WSL。6.2 启动代理ocx start你会看到终端显示代理启动日志浏览器自动弹出http://localhost:10100看到 OpenCodex 的 Web 仪表盘说明成功 6.3 常用启动方式ocx start# 前台启动当前窗口运行CtrlC 停止ocx start--port8888# 自定义端口ocxserviceinstall# 安装为后台服务Windows/macOS/Linux 都支持ocxservicestart# 启动后台服务建议日常使用装后台服务这样不用每次都手动启动。7. 配置 NVIDIA NIM7.1 方式一Web 仪表盘最简单浏览器打开http://localhost:10100左侧菜单点击“提供方”Providers点击“Add Provider”按钮在列表中找到NVIDIA NIM点击添加粘贴你的 API Keynvapi-xxxxxxxxxxxxxxxx点击保存几秒钟后你会看到连接状态变为 ✅Connected模型数量显示如102 models available延迟显示如Latency: 90 ms7.2 方式二命令行适合脚本化# 添加 NVIDIA NIM 提供商ocx provideraddnvidia --api-keynvapi-你的密钥# 测试连接ocx providertestnvidia# 预期输出# nvidia: connected# Connected — 102 models available.# Latency: 90 ms# 设为默认提供商这样不用每次指定ocx provider set-default nvidia# 查看所有已配置提供商ocx provider list7.3 NVIDIA NIM 热门模型一览配置完成后你可以在仪表盘或命令行看到所有可用模型。以下是常用的几个模型名称模型 ID特点DeepSeek V4 Flashdeepseek-ai/deepseek-v4-flash 免费层1M 上下文推荐入门DeepSeek V4 Prodeepseek-ai/deepseek-v4-pro更强推理付费MiniMax M3minimaxai/minimax-m3中文场景表现好Llama 3.3 70Bmeta/llama-3.3-70b-instruct开源标杆稳定可靠Llama 3.1 8Bmeta/llama-3.1-8b-instruct轻量快速适合简单任务Nemotron 3 Ultranvidia/nemotron-3-ultra-550b-a55bNVIDIA 自研超大参数新手推荐先用DeepSeek V4 Flash免费且能力强。8. 绑定 Codex CLICodex CLI 是 OpenAI 官方的终端编码工具原生只支持 OpenAI 模型。通过 OpenCodex 绑定后它就能调用 NIM 的任意模型。8.1 交互式初始化ocx init你会看到交互式菜单关键选择选择默认提供商选第 9 项 “OpenAI API”❌ 不要选 Claude❌ 不要选 Grok✅ 必须选OpenAI API因为 Codex 只认 OpenAI 协议OpenCodex 会伪装成 OpenAI 服务器输入 API Key随便填一个占位符比如sk-dummy这个 Key 不会被真正使用OpenCodex 会把它替换为你的 NIM Key输入 Base URL确认或输入http://127.0.0.1:10100/v1选择默认模型从列表中选择你想要的 NIM 模型如nvidia/deepseek-ai/deepseek-v4-flash8.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-mnvidia/minimaxai/minimax-m3分析这段代码的 bug# 全自动模式无需每次确认执行codex --approval-mode full-auto重构这个项目的日志模块如果成功你会看到 Codex 的 TUI 界面弹出并且回复来自你指定的 NIM 模型9. 绑定 Claude CodeClaude Code 是 Anthropic 的终端编码工具原生只支持 Claude 模型。绑定方式和 Codex 几乎一样。9.1 初始化ocx init同样选择OpenAI API作为 provider配置同上。9.2 启动claudeClaude Code 启动后所有的 API 请求都会先走到 OpenCodex再被转发到 NVIDIA NIM。⚠️风险提示Anthropic 的服务条款可能不允许通过第三方代理访问。虽然 OpenCodex 只是本地代理但建议了解相关条款。OpenCodex 官方也在文档中明确标注了此风险。10. 绑定 Grok BuildGrok 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 主要功能区域菜单功能仪表盘代理运行状态、实时请求数Codex 认证管理 Codex 的 API Key 和路由提供方添加/删除/测试供应商模型查看所有可用模型列表子代理配置多代理路由Codex 子代理选择器日志与调试实时查看 API 请求和响应用量各供应商的 Token 消耗统计路由配置模型组合故障转移/轮询⚙️集成管理 Codex/Claude/Grok 的绑定状态11.2 启动安全页面解读在集成 ➜ 启动安全页面你会看到几个状态状态含义建议Codex 路由自定义本地网关✅ Codex 已指向 OpenCodex正常重启保护未安装⚠️ 重启后代理不会自动启动建议安装后台服务按需启动已启用✅ 运行codex时 shim 自动拉代理正常后台服务可用可以安装 Windows 服务可选12. 七大踩坑实录以下都是我在配置过程中真实踩过的坑附完整解决方案。️ 坑 1Codex 的/model命令无法显示 NIM 模型现象在 Codex TUI 里按/进入模型选择只能看到 OpenAI 的 GPT 模型看不到任何 NIM 模型。原因Codex CLI 的/model菜单只读取内置的 OpenAI 模型列表对自定义 provider 完全无视。如果你强行选一个它会覆盖config.toml导致配置损坏。解决永远不要在 TUI 里用/model切换。改用命令行参数codex-mnvidia/deepseek-ai/deepseek-v4-flash你的提示词️ 坑 2model_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️ 坑 3ocx 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️ 坑 4ocx 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 providerOpenCodex 为了保护现有配置没有强行覆盖。解决先还原再重新初始化ocx restore# 还原 Codex 原生配置ocx init# 重新绑定到 OpenCodex️ 坑 5Grok 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)️ 坑 6NIM 模型 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 providertestnvidia13. 日常使用命令大全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-keyxxx# 添加 NVIDIA NIMocx providertestnvidia# 测试连接ocx provider show nvidia# 查看详细配置ocx provider set-default nvidia# 设为默认ocx provider remove nvidia# 删除提供商Codex CLI 使用codex提示词# 用默认模型启动codex-mnvidia/模型ID提示词# 临时指定模型codex --approval-mode full-auto# 全自动模式codex-mnvidia/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-mmycombo写一个复杂算法14.2 子代理路由Codex 多代理Codex 支持最多 8 个并行子代理。你可以让不同子代理用不同模型# 配置子代理模型映射ocx v2 setup然后在 Codex 里按/选择子代理时每个子代理会走你配置的模型。14.3 远程访问局域网共享默认 OpenCodex 只监听127.0.0.1。如果想让局域网其他设备访问# 设置认证 Token$env:OPENCODEX_API_AUTH_TOKENyour-secret-token# 启动监听所有网卡ocx start--host0.0.0.0其他设备通过http://你的IP:10100/v1访问请求头需携带x-opencodex-api-key。15. 总结你的情况推荐方案有 NVIDIA NIM API想用 Codex✅ OpenCodex Codex CLI有 NIM API想用 Claude Code✅ OpenCodex Claude Code想同时用多个模型对比✅ OpenCodex 组合路由还在用 AutoForge❌ 建议迁移到 Claude Code 原生 OpenCodex不想折腾只要开箱即用❌ 直接用 Claude Code 或 Codex 原生但锁模型OpenCodex 的核心价值可以用一句话概括“它不改变你熟悉的工具只改变工具背后的模型。”你依然可以用 Codex 漂亮的 TUI、Claude 的智能交互、Grok 的竞技场模式——但背后跑的是 DeepSeek、Llama、MiniMax 或任何你想试的模型。这才是 2026 年 AI 编码应有的自由度。 参考链接OpenCodex GitHub: github.com/lidge-jun/opencodexNVIDIA NIM: build.nvidia.comCodex CLI: github.com/openai/codexClaude Code: docs.anthropic.com/claude-codeGrok Build: x.ai版权声明本文为原创技术教程转载请注明出处。⭐如果对你有帮助欢迎点赞、收藏、转发有任何问题欢迎在评论区交流。本文基于 OpenCodex v2.10.2 Codex CLI v0.146.1 NVIDIA NIM 实测整理。