AI 程式設計教程中文版
官方教程中文版平臺與故障

使用 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 類似:

  1. 開啟 OpenCode Zen,登入並新增賬單資訊。
  2. 複製 Zen API key。
  3. 在 TUI 裡執行 /connect,選擇 OpenCode Zen。
  4. 貼上 API key。
  5. 在 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

接下來去哪

官方資料

本頁目錄