---
title: "使用 Zen 模型列表"
description: "理解 OpenCode Zen 的定位、接入流程、模型 ID、计费、隐私和团队治理边界。"
verifiedAt: "2026-05-09"
---

OpenCode Zen 是 OpenCode 团队提供的精选模型入口。它把一组经过测试和验证、适合作为 coding agent 的模型放到同一个 provider 下面，让你在 OpenCode 里用 `opencode/<model-id>` 选择。

> [!NOTE]
> **这一篇用 10 分钟换什么**：你会知道 Zen 是否适合你、怎么接入、模型 ID 怎么写、价格和隐私该在哪里核对，以及团队该如何控制模型访问。

## 先给结论：Zen 是可选 provider，不是必选套餐

Zen 的价值不是“OpenCode 只能用它”，而是提供一条更省心的模型选择路径。你仍然可以使用 OpenAI、Anthropic、Google、OpenRouter、本地模型或其他 provider。

| 适合用 Zen | 可以不用 Zen |
| --- | --- |
| 想快速获得官方筛选过的 coding agent 模型 | 已有稳定 provider 和账单体系 |
| 不想逐个调 provider、endpoint、模型能力 | 需要企业云、VPC 或内部合规 |
| 团队希望统一模型访问和月度限额 | 必须把请求留在自有基础设施 |
| 想用 `opencode/<model-id>` 简化选择 | 已有自建网关或本地模型服务 |

> [!IMPORTANT]
> Zen 当前仍是 beta。价格、模型列表、免费模型和弃用计划都可能变化，写配置前要重新核对官方页面或模型 endpoint。

## Zen 在 OpenCode 模型层的位置

```mermaid
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 类似：

1. 打开 [OpenCode Zen](https://opencode.ai/auth)，登录并添加账单信息。
2. 复制 Zen API key。
3. 在 TUI 里运行 `/connect`，选择 OpenCode Zen。
4. 粘贴 API key。
5. 在 TUI 里运行 `/models`，查看可用模型。

配置里使用模型时，格式是：

```jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/gpt-5.5"
}
```

这里的 `opencode` 是 provider ID，`gpt-5.5` 是 Zen 模型 ID。

## 模型列表不要手抄，直接查官方 endpoint

Zen 的模型列表变化快。教程里不应该长期冻结完整模型和价格表，否则很快会过期。

完整模型和元数据从这里查：

```text
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`。

> [!WARNING]
> 不要把免费模型、价格或弃用日期写进长期配置后就不再检查。免费期、beta 策略和模型可用性都可能变化。

## 价格和充值怎么理解

Zen 是按请求计费，可以向账户充值。官方说明里还有几个容易忽略的点：

- 价格按每 1M tokens 展示，并区分输入、输出、缓存读取和缓存写入。
- 信用卡手续费按成本转嫁。
- 默认自动充值规则是余额低于指定阈值时充值，你可以更改金额或关闭自动充值。
- 可以给整个 workspace 和单个成员设置月度限额。
- 免费模型通常有额外条件，不能默认当成生产可用模型。

> [!CAUTION]
> 月度限额和自动充值不是一回事。如果自动充值开启，实际扣款行为还要看余额阈值和充值规则。

## 隐私和数据边界

官方 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`。

## 接下来去哪

<Cards>
  <Card title="配置模型供应商" href="/docs/opencode/official/03-models/providers">
    理解 Zen、直接 provider、第三方网关和本地模型各自适合什么。
  </Card>
  <Card title="选择模型" href="/docs/opencode/official/03-models/models">
    回到 provider/model/variant 的通用选择逻辑。
  </Card>
  <Card title="安全与权限" href="/docs/opencode/official/05-security/permissions">
    模型选好以后，继续收紧文件、命令和工具权限。
  </Card>
  <Card title="排查问题" href="/docs/opencode/official/08-platform/troubleshooting">
    如果 provider、模型或认证失败，按排障顺序定位。
  </Card>
</Cards>

## 官方资料

- [OpenCode Zen](https://opencode.ai/docs/zen/)
- [Zen models endpoint](https://opencode.ai/zen/v1/models)
- [OpenCode providers](https://opencode.ai/docs/providers/)
- [OpenCode model config](https://opencode.ai/docs/config/#models)
