---
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="/zh-Hant/docs/opencode/official/03-models/providers">
    理解 Zen、直接 provider、第三方閘道器和本地模型各自適合什麼。
  </Card>
  <Card title="選擇模型" href="/zh-Hant/docs/opencode/official/03-models/models">
    回到 provider/model/variant 的通用選擇邏輯。
  </Card>
  <Card title="安全與許可權" href="/zh-Hant/docs/opencode/official/05-security/permissions">
    模型選好以後，繼續收緊檔案、命令和工具許可權。
  </Card>
  <Card title="排查問題" href="/zh-Hant/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)
