Windows 上接入 OpenCode Go 与 Codex：安装、排错和回滚

本文依据 codex-router 官方仓库于 2026 年 9 月 27 日核对，未在 Windows 实机完成本轮测试。它是社区集成，兼容性会随 Codex 和路由器版本变化。先在一个可丢弃的小项目中验证，再用于日常工作。

安装前检查

准备 Codex、Node.js 22.19+（项目推荐 Node 24 LTS）、Git，以及 uv 或支持 venv 的 Python 3.10+。Windows PowerShell 需要允许 FullLanguage 和 Add-Type；受组织策略限制时，应找管理员确认可用方案，不要降低系统防护。

备份当前 Codex 配置，记录实际配置目录。WSL 与 Windows 原生进程可能读取不同目录，不要仅凭默认路径判断。准备可用的 OpenCode Go 账号与密钥；套餐和模型以 Go 官方文档为准。

安装和认证

以下是项目当前推荐的 Windows 引导安装命令。下载后先查看脚本与仓库说明，再决定是否运行；本文中的命令没有在你的电脑执行。

$installer = Join-Path $env:TEMP "codex-router-install.ps1"
Invoke-WebRequest https://raw.githubusercontent.com/duolahypercho/codex-router/main/install.ps1 -OutFile $installer
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer -Target codex -Guided

向导中选择所需的 OpenCode provider。完成后进入安装程序显示的路由器目录，按需设置密钥并检查状态：

.\model-router.ps1 codex provider-key opencode-go set
.\model-router.ps1 codex providers enable opencode-go
.\model-router.ps1 codex doctor
.\model-router.ps1 codex status

密钥在交互提示中输入，不要放在命令参数、截图或聊天记录里。网关在本机运行，但模型请求及其认证信息仍会发送给上游，并不是“密钥永远不出本机”。当前路由器将 Go 和按量计费的 Zen 归在同一 provider 家族；核对所选模型的实际端点，避免把 Zen 调用误认为订阅内用量。

怎样才算接入成功

先解决 doctor 报出的失败项，再完整退出 Codex 并重新打开，新建任务。使用当前目录中的模型 ID，不要照抄旧截图：例如 Grok 的路由标识现为 opencode-go-responses/grok-4.5。

选择器能显示模型只是第一步。让它读取测试文件、修改一处代码、执行测试，再检查结果。记录客户端版本、模型 ID、报错、耗时和上游用量；没有看到预期结果时，不要继续迁移其他项目。

常见故障排查

回滚

在安装目录中先禁用集成，需要移除时再卸载：

.\model-router.ps1 codex disable
# To remove the integration:
.\model-router.ps1 codex uninstall

随后重开 Codex，确认原来的工作方式恢复；对照备份检查配置。不要在卸载前直接删除整个 Codex 目录，其中可能还有自己的设置与历史记录。

下一步是完成一次小任务验收。更多客户端选择可参照 AI 编程 CLI 对比，需要比较其他网关可看 9Router。