Skip to main content

1. 取得 API Key

開啟 Ace Data Cloud 應用程式列表,進入可用的應用程式並複製 API Key。 取得 Ace Data Cloud API Key

2. 安裝 OpenCode

也可以使用 npm:

3. 設定 API Key

如需長期生效,把這一行加入 ~/.zshrc 或 ~/.bashrc 後重新開啟終端機。

4. 設定 Provider

編輯 ~/.config/opencode/opencode.json:
前往 模型目錄 查看模型名稱(例如 claude-opus-5、gpt-6-sol),並將所有 MODEL_ID 替換為同一個名稱;精確驗證時,以 /v1/models 回應中的 id 值為準。該值就是 API model 參數使用的模型名稱,不是服務或 API 的 UUID。Ace Data Cloud 這裡使用 Chat Completions,所以 adapter 是 @ai-sdk/openai-compatible。

5. 驗證並啟動

然後在專案目錄執行 opencode。如果模型未出現,檢查設定檔路徑、JSON 語法和環境變數;401 表示 Key 無效或未匯出。 IDE 擴充功能重複使用同一份 OpenCode runtime 設定,請參見 OpenCode IDE Extension。

官方參考