> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 OpenCode 中使用 AiHubMix

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: `choco`、`winget` 或 `scoop`

***

1. 安裝 OpenCode

您可以使用以下任一方法安裝 OpenCode：

**使用 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
```

***

**使用 Homebrew (macOS / Linux)**

```
brew install sst/tap/opencode
```

***

**使用 Paru (Arch Linux)**

```
paru -S opencode-bin
```

***

**在 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

安裝後，請按照以下步驟登入並配置 OpenCode。

### 步驟 1. 登入

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

```
opencode auth login
```

***

### 步驟 2. 選擇 AI 提供商

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

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/oc1.png" alt="圖片" />

***

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

登入您的 AiHubMix 帳戶以取得您的 API 金鑰。在 OpenCode 登入畫面中輸入以完成授權。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/oc2.png" alt="圖片" />

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/oc3.png" alt="圖片" />

***

3. 驗證安裝

要確認 OpenCode 已成功安裝並配置，請執行：

```
opencode
```

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/oc4.png" alt="圖片" />

如果控制台返回有效的模型回應，則設定完成。

<img src="https://mintlify.s3.us-west-1.amazonaws.com/aihubmix/public/en/oc5.png" alt="圖片" />

***

<h2 id="custom-base-url">
  自訂 Base URL
</h2>

預設情況下，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：

```json theme={null}
{
  "$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 後重新啟動。執行以下命令確認設定已生效：

```bash theme={null}
opencode debug config
```

在輸出的 `provider.aihubmix.options.baseURL` 中應能看到您填入的位址。

| 欄位                | 說明                         |
| ----------------- | -------------------------- |
| `options.baseURL` | 自訂請求位址，優先級高於預設位址；填到網域層級即可。 |

***

4. 問題與提示

* 如果您的 API 金鑰驗證失敗，請重新使用 AiHubMix 進行身份驗證，並檢查金鑰的狀態。
* 檢視應用程式內說明：`opencode` -> `/help`
* 官方文件：[https://opencode.ai/docs/](https://opencode.ai/docs/)

***

最後更新：2026-06-01