使用 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、模型或認證失敗,按排障順序定位。