使用 Zen 模型列表
理解 OpenCode Zen 的定位、接入流程、模型 ID、计费、隐私和团队治理边界。
OpenCode Zen 是 OpenCode 团队提供的精选模型入口。它把一组经过测试和验证、适合作为 coding agent 的模型放到同一个 provider 下面,让你在 OpenCode 里用 opencode/<model-id> 选择。
这一篇用 10 分钟换什么:你会知道 Zen 是否适合你、怎么接入、模型 ID 怎么写、价格和隐私该在哪里核对,以及团队该如何控制模型访问。
先给结论:Zen 是可选 provider,不是必选套餐
Zen 的价值不是“OpenCode 只能用它”,而是提供一条更省心的模型选择路径。你仍然可以使用 OpenAI、Anthropic、Google、OpenRouter、本地模型或其他 provider。
| 适合用 Zen | 可以不用 Zen |
|---|---|
| 想快速获得官方筛选过的 coding agent 模型 | 已有稳定 provider 和账单体系 |
| 不想逐个调 provider、endpoint、模型能力 | 需要企业云、VPC 或内部合规 |
| 团队希望统一模型访问和月度限额 | 必须把请求留在自有基础设施 |
想用 opencode/<model-id> 简化选择 | 已有自建网关或本地模型服务 |
Zen 当前仍是 beta。价格、模型列表、免费模型和弃用计划都可能变化,写配置前要重新核对官方页面或模型 endpoint。
Zen 在 OpenCode 模型层的位置
flowchart LR
OpenCode[OpenCode] --> Provider{选择 provider}
Provider --> Zen[OpenCode Zen<br/>opencode/model-id]
Provider --> Direct[直接 provider<br/>openai / anthropic / google]
Provider --> Gateway[第三方网关<br/>OpenRouter / 自建代理]
Provider --> Local[本地模型<br/>Ollama / LM Studio]
Zen --> Models[精选 coding agent 模型]
Zen --> Billing[Zen 账单和团队治理]
可以把 Zen 理解成 OpenCode 官方维护的一层 AI gateway:它帮你筛选和接入模型,但不阻止你使用其他 provider。
怎么接入
Zen 的使用方式和其他 provider 类似:
- 打开 OpenCode Zen,登录并添加账单信息。
- 复制 Zen API key。
- 在 TUI 里运行
/connect,选择 OpenCode Zen。 - 粘贴 API key。
- 在 TUI 里运行
/models,查看可用模型。
配置里使用模型时,格式是:
{
"$schema": "https://opencode.ai/config.json",
"model": "opencode/gpt-5.5"
}这里的 opencode 是 provider ID,gpt-5.5 是 Zen 模型 ID。
模型列表不要手抄,直接查官方 endpoint
Zen 的模型列表变化快。教程里不应该长期冻结完整模型和价格表,否则很快会过期。
完整模型和元数据从这里查:
https://opencode.ai/zen/v1/models当前官方文档把模型大致分成这些接入形态:
- GPT 系列:通过
https://opencode.ai/zen/v1/responses,AI SDK 包使用@ai-sdk/openai。 - Claude 系列:通过
https://opencode.ai/zen/v1/messages,AI SDK 包使用@ai-sdk/anthropic。 - Gemini 系列:通过 Zen 的 model-specific endpoint,AI SDK 包使用
@ai-sdk/google。 - Qwen、MiniMax、GLM、Kimi、Big Pickle、Ling、Hy3、Nemotron 等:通过
chat/completions,AI SDK 包使用@ai-sdk/openai-compatible。
不要把免费模型、价格或弃用日期写进长期配置后就不再检查。免费期、beta 策略和模型可用性都可能变化。
价格和充值怎么理解
Zen 是按请求计费,可以向账户充值。官方说明里还有几个容易忽略的点:
- 价格按每 1M tokens 展示,并区分输入、输出、缓存读取和缓存写入。
- 信用卡手续费按成本转嫁。
- 默认自动充值规则是余额低于指定阈值时充值,你可以更改金额或关闭自动充值。
- 可以给整个 workspace 和单个成员设置月度限额。
- 免费模型通常有额外条件,不能默认当成生产可用模型。
月度限额和自动充值不是一回事。如果自动充值开启,实际扣款行为还要看余额阈值和充值规则。
隐私和数据边界
官方 Zen 文档说明,模型托管在美国,提供商遵循零保留政策,不会把数据用于训练;但存在例外,需要你主动判断能不能用于敏感任务。
重点记住:
- 免费模型在免费期可能会收集数据用于改进模型。
- NVIDIA 免费端点只适合试用,不适合生产或敏感数据。
- OpenAI API 请求按 OpenAI 数据政策处理。
- Anthropic API 请求按 Anthropic 数据政策处理。
- 团队要禁用会收集数据或不符合合规要求的模型。
如果你处理客户代码、生产日志、密钥片段或未公开产品计划,不要只看“模型强不强”,先看数据边界。
团队怎么用
Zen 支持团队工作区。常见治理动作包括:
- 邀请成员加入 workspace。
- 分配角色:
Admin管模型、成员、API key 和账单;Member管自己的 API key。 - 为成员设置月度支出限额。
- 启用或禁用特定模型。
- 使用自带 OpenAI 或 Anthropic key,同时访问 Zen 里的其他模型。
团队场景里,模型治理比个人更重要。强模型、免费模型、实验模型、会收集数据的模型,都应该有明确启用规则。
怎么判断是否该用 Zen
按这组问题检查:
- 你是否需要 OpenCode 官方筛选过的模型组合?
- 你是否能接受 Zen 的账单、地区和数据边界?
- 你的团队是否需要统一模型访问和月度限额?
- 你是否已经核对最新价格、免费期和弃用列表?
- 你的项目配置里是否使用
opencode/<model-id>,而不是只写裸模型名?
如果这些问题答不清,先用 /connect 做个人小范围验证,不要直接写进团队默认配置。
新手常见坑
- 以为不用 Zen 就不能用 OpenCode。
- 复制旧模型 ID,没用
/models或 endpoint 重新确认。 - 把免费模型用于敏感代码或生产任务。
- 只看输入价格,忽略输出、缓存和自动充值。
- 团队没有禁用不符合数据边界的模型。
- 在配置中写
gpt-5.5,忘了应该写opencode/gpt-5.5。
接下来去哪
配置模型供应商
理解 Zen、直接 provider、第三方网关和本地模型各自适合什么。
选择模型
回到 provider/model/variant 的通用选择逻辑。
安全与权限
模型选好以后,继续收紧文件、命令和工具权限。
排查问题
如果 provider、模型或认证失败,按排障顺序定位。