在 OpenCode 中使用 AiHubMix

目前已支援 GPT、Claude、DeepSeek、Gemini、Qwen 等主流模型系列。在 OpenCode 使用情境中，建議使用以下模型：

coding-minimax-m2.1-free
coding-glm-4.7-free
claude-sonnet-4-5
gpt-5
gpt-5-codex

本文件將介紹如何在不同作業系統中安裝、設定並啟動 OpenCode，並完成對 AIHubMix API 的接入。

在開始安裝前，請確認系統已滿足以下需求：

Node.js ≥ 18.0.0
對應系統的套件管理工具（選用）：
- macOS / Linux：brew
- Arch Linux：paru
- Windows：choco、winget 或 scoop

1. 安裝 OpenCode

可依照所使用的系統與工具，選擇任一種安裝方式。

1. 使用 Node.js 安裝

# 使用 CURL 指令碼快速安裝
curl -fsSL https://opencode.ai/install | bash

# 使用 NPM
npm install -g opencode-ai

# 使用 Bun
bun install -g opencode-ai

# 使用 PNPM
pnpm install -g opencode-ai

# 使用 Yarn
yarn global add opencode-ai

2. 使用 Homebrew 安裝（macOS / Linux）

brew install sst/tap/opencode

3. 使用 Paru 安裝（Arch Linux）

paru -S opencode-bin

4. Windows 安裝

# Chocolatey
choco install opencode

# WinGet
winget install opencode

# Scoop
scoop bucket add extras
scoop install extras/opencode

# 或使用 NPM（需 Node.js 環境）
# 注意：需要系統管理員權限
npm install -g opencode-ai

2. 啟動與登入 OpenCode

安裝完成後，執行以下步驟完成登入與設定。

1. 登入 OpenCode

在終端機輸入以下指令：

opencode auth login

2. 選擇模型提供商

在登入畫面中選擇 AIHubMix 作為模型提供商。

3. API 金鑰授權

輸入 AiHubMix API 金鑰，並在 OpenCode 登入頁面中填入該金鑰以完成授權。

3. 模型使用

1. 安裝驗證

可透過以下指令驗證 OpenCode 是否安裝並設定成功：

opencode

2. 選擇模型

輸入 /models，搜尋 aihubmix，選擇需要的模型。

4. 在 OpenCode 用戶端使用

下載 OpenCode 桌面版：https://opencode.ai/download。
開啟 OpenCode，輸入 /model → Connect provider → 搜尋 aihubmix → 輸入 API 金鑰 → Submit。
在模型選擇欄搜尋 aihubmix，選擇需要使用的模型即可使用。

5. 手動設定更新模型

以新增 DeepSeek V4 Pro 為例。

步驟 1：確認模型 ID

在 AIHubMix 模型介面找到目標模型，複製 ID。也可以透過 API 直接查詢：

curl https://aihubmix.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | python3 -m json.tool | grep "id"

步驟 2：開啟設定檔

依照您的系統，在終端機執行對應指令： Mac

mkdir -p ~/.config/opencode && open -a TextEdit ~/.config/opencode/opencode.json

Linux

mkdir -p ~/.config/opencode && nano ~/.config/opencode/opencode.json

Windows（在 PowerShell 中執行）

New-Item -ItemType Directory -Force "$env:USERPROFILE\.config\opencode"
notepad "$env:USERPROFILE\.config\opencode\opencode.json"

檔案開啟後，您會看到一個空檔案或已有的 JSON 內容。

步驟 3：寫入設定

如果是空檔案，直接貼上以下內容：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aihubmix": {
      "models": {
        "deepseek-v4-pro": {
          "name": "DeepSeek-V4-Pro",
          "contextLength": 131072,
          "type": "language"
        }
      }
    }
  }
}

如果檔案已有內容，只需在 "models" 裡追加新模型，每個模型之間用逗號隔開：

"models": {
  "deepseek-v4-pro": {
    "name": "DeepSeek-V4-Pro",
    "contextLength": 131072,
    "type": "language"
  },
  "deepseek-v4-flash-think": {
    "name": "DeepSeek-V4-Flash-Think",
    "contextLength": 131072,
    "type": "language"
  }
}

注意：最後一個模型後面不加逗號，否則檔案格式會出錯。

儲存檔案：Mac 按 Command + S，Windows 按 Ctrl + S。 欄位說明：

欄位	說明
`name`	模型 ID
`contextLength`	上下文長度（token 數）
`type`	模型類型，文字對話填 `"language"`

步驟 4：重新啟動 OpenCode

儲存設定檔後，完全退出 OpenCode 並重新啟動，新模型才會載入。

步驟 5：驗證

開啟模型選擇（預設快捷鍵 ;），搜尋 V4 或 DeepSeek，確認 DeepSeek-V4-Pro 已出現在清單中。

自訂 Base URL

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

步驟 1：開啟設定檔

依照「5. 手動設定更新模型」中的方式開啟 ~/.config/opencode/opencode.json（Windows 為 %USERPROFILE%\.config\opencode\opencode.json）。

步驟 2：新增 `options.baseURL`

在 aihubmix 這個 provider 下新增 options.baseURL。只需寫這一個欄位，OpenCode 會自動與內建設定深度合併，不必重寫整份 provider：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aihubmix": {
      "options": {
        "baseURL": "https://api.inferera.com"
      }
    }
  }
}

注意：baseURL 只需填到網域層級（如 https://api.inferera.com），/v1、/chat/completions 等路徑會由 SDK 自動拼接。請不要自己再加 /v1（如 https://api.inferera.com/v1），否則會被拼成 /v1/v1/ 導致 404。

步驟 3：重新啟動並驗證

完全退出 OpenCode 後重新啟動。可執行以下指令確認設定已生效：

opencode debug config

在輸出的 provider.aihubmix.options.baseURL 中應能看到您填入的位址；之後任意一次模型請求都會發往該位址。 欄位說明：

欄位	說明
`options.baseURL`	自訂請求位址，優先級高於預設位址；填到網域層級即可，路徑自動拼接

7. 常見問題與提示

若 API 金鑰無法通過驗證，請重新登入 AIHubMix 並檢查金鑰有效性。
檢視說明文件：opencode → /help
OpenCode 官方文件：https://opencode.ai/docs/。

最後更新：2026-07-29

程式設計助理

IDE 整合

Agent / Workflow

SDK 與框架

在 OpenCode 中使用 AiHubMix

1. 安裝 OpenCode

1. 使用 Node.js 安裝

2. 使用 Homebrew 安裝（macOS / Linux）

3. 使用 Paru 安裝（Arch Linux）

4. Windows 安裝

2. 啟動與登入 OpenCode

1. 登入 OpenCode

2. 選擇模型提供商

3. API 金鑰授權

3. 模型使用

1. 安裝驗證

2. 選擇模型

4. 在 OpenCode 用戶端使用

5. 手動設定更新模型

步驟 1：確認模型 ID

步驟 2：開啟設定檔

步驟 3：寫入設定

步驟 4：重新啟動 OpenCode

步驟 5：驗證

自訂 Base URL

步驟 1：開啟設定檔

步驟 2：新增 `options.baseURL`

步驟 3：重新啟動並驗證

7. 常見問題與提示

​1. 安裝 OpenCode

​1. 使用 Node.js 安裝

​2. 使用 Homebrew 安裝（macOS / Linux）

​3. 使用 Paru 安裝（Arch Linux）

​4. Windows 安裝

​2. 啟動與登入 OpenCode

​1. 登入 OpenCode

​2. 選擇模型提供商

​3. API 金鑰授權

​3. 模型使用

​1. 安裝驗證

​2. 選擇模型

​4. 在 OpenCode 用戶端使用

​5. 手動設定更新模型

​步驟 1：確認模型 ID

​步驟 2：開啟設定檔

​步驟 3：寫入設定

​步驟 4：重新啟動 OpenCode

​步驟 5：驗證

​ 自訂 Base URL

​步驟 1：開啟設定檔

​步驟 2：新增 options.baseURL

​步驟 3：重新啟動並驗證

​7. 常見問題與提示

1. 安裝 OpenCode

1. 使用 Node.js 安裝

2. 使用 Homebrew 安裝（macOS / Linux）

3. 使用 Paru 安裝（Arch Linux）

4. Windows 安裝

2. 啟動與登入 OpenCode

1. 登入 OpenCode

2. 選擇模型提供商

3. API 金鑰授權

3. 模型使用

1. 安裝驗證

2. 選擇模型

4. 在 OpenCode 用戶端使用

5. 手動設定更新模型

步驟 1：確認模型 ID

步驟 2：開啟設定檔

步驟 3：寫入設定

步驟 4：重新啟動 OpenCode

步驟 5：驗證

自訂 Base URL

步驟 1：開啟設定檔

步驟 2：新增 `options.baseURL`

步驟 3：重新啟動並驗證

7. 常見問題與提示