跳轉到主要內容
OpenCode 現已支援 AiHubMix 作為新的模型提供商。您可以在 OpenCode 中使用您的 AiHubMix API 金鑰來存取其模型服務。 AiHubMix 目前支援主要的模型系列,包括 GPT、Claude、DeepSeek、Gemini 和 Qwen。為了在 OpenCode 中獲得最佳效能,建議使用以下模型:
  • claude-sonnet-4-5
  • glm-4.6
  • gpt-5
  • gpt-5-codex
本指南提供在不同作業系統上安裝、配置和啟動 OpenCode,以及連接到 AiHubMix API 的詳細步驟。

系統需求

安裝前,請確保您的系統符合以下需求:
  • Node.js ≥ 18.0.0
  • 套件管理器(視作業系統而定,可選):
    • macOS / Linux: brew
    • Arch Linux: paru
    • Windows: chocowingetscoop

  1. 安裝 OpenCode
您可以使用以下任一方法安裝 OpenCode: 使用 Node.js

使用 Homebrew (macOS / Linux)

使用 Paru (Arch Linux)

在 Windows 上

  1. 啟動並登入 OpenCode
安裝後,請按照以下步驟登入並配置 OpenCode。

步驟 1. 登入

在您的終端機中執行以下命令:

步驟 2. 選擇 AI 提供商

在登入介面中,選擇 AiHubMix 作為您的模型提供商。 圖片

步驟 3. 使用 API 金鑰進行授權

登入您的 AiHubMix 帳戶以取得您的 API 金鑰。在 OpenCode 登入畫面中輸入以完成授權。 圖片 圖片
  1. 驗證安裝
要確認 OpenCode 已成功安裝並配置,請執行:
圖片 如果控制台返回有效的模型回應,則設定完成。 圖片

自訂 Base URL

預設情況下,OpenCode 會把 AiHubMix 的請求發往 https://aihubmix.com/v1。如果您需要讓請求走自建網關、企業代理或加速節點,可以透過 options.baseURL 覆蓋,無需修改 OpenCode 原始碼或重新安裝

步驟 1:開啟設定檔

開啟 ~/.config/opencode/opencode.json(Windows 為 %USERPROFILE%\.config\opencode\opencode.json)。

步驟 2:新增 options.baseURL

aihubmix 這個 provider 下新增 options.baseURL。只需寫這一個欄位,OpenCode 會自動與內建設定深度合併,不必重寫整份 provider:
注意baseURL 只需填到網域層級(如 https://api.inferera.com),/v1/chat/completions 等路徑會由 SDK 自動拼接。不要自己再加 /v1(如 https://api.inferera.com/v1),否則會被拼成 /v1/v1/ 導致 404。

步驟 3:重新啟動並驗證

完全退出 OpenCode 後重新啟動。執行以下命令確認設定已生效:
在輸出的 provider.aihubmix.options.baseURL 中應能看到您填入的位址。
  1. 問題與提示
  • 如果您的 API 金鑰驗證失敗,請重新使用 AiHubMix 進行身份驗證,並檢查金鑰的狀態。
  • 檢視應用程式內說明:opencode -> /help
  • 官方文件:https://opencode.ai/docs/

最後更新:2026-06-01