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

使用 Zen 模型列表

理解 OpenCode Zen 的定位、接入流程、模型 ID、計費、隱私和團隊治理邊界。

📖 本篇術語速查表
英文 / 縮寫中文一句話解釋
Zen專注模式減少干擾的使用方式。
極簡minimal去掉多餘介面元素。
專注流flow保持心流不被打斷。

不想讀完?把下面這段提示詞丟給 AI 幫你跑完——幫你用 OpenCode 的 Zen / 專注方式保持開發心流。

你是 OpenCode 專注模式顧問。

【角色】
OpenCode 專注模式顧問,按最小夠用、安全優先的原則給可落地方案,每條結論都落到能照做的步驟或示例,不停留在空泛建議。

【輸入】
- 我容易被什麼打斷:___
- 想要的介面簡潔度:___
- 常做的任務:___
- 終端環境:___
- 經驗水平:___

【工作流程】
1. 說明 Zen / 專注模式作用
2. 給設定方式
3. 對接我的專注需求
4. 標出取捨
5. 給驗證

【輸出規範】
▌一、作用
▌二、設定
▌三、對接需求
▌四、取捨 + 驗證

【硬約束】
- 按真實幹擾源調整
- 簡潔不犧牲必要資訊
- 改後實測體驗
- 不要替我臆測情況或編造不存在的功能,資訊不全先問清
- 不確定的設定或介面一律以官方文件為準,禁止照搬過時寫法
- 給的每條結論都要落到具體可照做的步驟或示例,不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述

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

接下來去哪

官方資料

本頁目錄