在 Codex 中使用 OpenCode Zen — 通过 Codex Router 接入按量付费模型

在 Codex 中使用 OpenCode Zen，指的是通过 Codex Router 把 opencode 平台的按量付费部分接入 Codex 模型选择器。它与包月制的 Go 订阅共享同一份存储密钥，但取自更大的 Zen 目录，其中包含 GPT 模型。

OpenCode Zenpay-per-usecurated catalog

一个供应商族，两个计费端点

opencode 在一个账户下发布两个端点。Codex Router 把它们视为一个可选族，共用一把密钥（OPENCODE_API_KEY 或 OPENCODE_GO_API_KEY）：

没有单独的 “Zen Key”。一把 opencode 账户 Key 两者通用，OpenCode Go 指南 深入介绍订阅部分。

在 Codex 中配置 Zen

先安装 Codex Router（见安装指南），然后保存密钥并启用该族：

./bin/model-router codex provider-key opencode-go set
./bin/model-router codex providers enable opencode-go

密钥来自你的 opencode 账户，在 opencode.ai/auth 获取。它保存在受保护的按用户文件中，只发送给 opencode 自己的端点。Windows 上用 ./model-router.ps1 codex 加相同命令，然后完全退出并重新打开 Codex。

定制 Zen 目录

Zen 不提供任何预选模型，因此你需要根据账户当前可见的内容自行构建清单：

./bin/curate-models opencode-zen

定制会列出 Zen 宣传的模型，让你勾选想要的，并保存到受保护状态。只有在需要指向其它端点时才设置 OPENCODE_ZEN_BASE_URL。

一把密钥背后的供应商 ID

目录在内部按端点和每个模型向上游使用的协议拆分为多个供应商 ID：

它们共享一把密钥并一起切换。这就是为什么 Go 选择和 Zen 选择在注册表中看起来像不同的供应商，尽管它们是同一份凭据。

定制的 Zen 模型也按同样方式拆分：Claude 落在 opencode-zen-messages，GPT、Grok 与 Muse 落在 opencode-zen-responses；Gemini 会被拒绝，因为 Zen 没有与之匹配的协议。这些变体共享 Go 的密钥与选择开关，但保留 Zen 独立计费的冷却范围。用 ./bin/curate-models opencode-zen 重新定制，可把已有的 Chat 条目迁移到匹配的协议上。

匿名免费网关

独立的 opencode-free 网关同样使用 Zen 端点，但不要求任何密钥。其目录由供应商控制，并过滤为免费 ID——big-pickle 以及以 -free 结尾的模型 ID。可用性与限制可能随时变化，请把它当作尝鲜而非依赖。

./bin/model-router codex providers enable opencode-free
./bin/curate-models opencode-free

验证集成

./bin/model-router codex doctor
./bin/model-router codex providers
./bin/test-model 'opencode-zen/MODEL_ID' --live --yes

供应商必须报告 SHOW 与 ready。完全退出 Codex、重新打开、新建任务并检查选择器。条目缺失见模型缺失。

常见问题

Codex 中的 OpenCode Zen 是什么？ OpenCode Zen 是 opencode 的按量付费端点。Codex Router 的 opencode-zen 供应商会用与 Go 订阅同一份存储密钥，把你在 Zen 实时目录中定制的模型接入 Codex 选择器。

Codex Router 会预选 Zen 模型吗？ 不会。Zen 端点不提供任何预选模型。你可以用 ./bin/curate-models opencode-zen 从其实时目录中定制想要的模型。

Go 和 Zen 是同一份凭据吗？ 是。两个端点共享同一份存储密钥，路由器在内部把它们拆分为不同的供应商 ID。启用或停用其中任何一个都会整体切换整个族。

相关：模型总览、OpenCode Go 指南、安装、故障排查。