OpenCode 設定教學：連線 NextHub API

OpenCode 是一款終端機 AI 程式開發工具，支援多模型連線。下面教你連線 NextHub 的 Claude 通道。

連線步驟

1. 安裝 OpenCode

確保已安裝 Node.js，然後全域安裝 OpenCode：

npm i -g opencode-ai

安裝完成後先執行一次，讓它產生預設設定資料夾：

opencode

2. 開啟 OpenCode 設定資料夾

Windows (CMD)

start "" "%USERPROFILE%\.config\opencode"

macOS (Terminal)

open "$HOME/.config/opencode"

3. 編輯 opencode.json — 填入 Claude 設定

在設定資料夾裡找到 opencode.json（沒有就新增），依 OpenCode 官方 schema 在 provider.anthropic.options 中填入你的 ApiKey 和 NextHub 連線網址：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "你的 NextHub ApiKey",
        "baseURL": "https://api.nexthub.cc"
      }
    }
  }
}

Base URL 不要帶 /v1

OpenCode 會自動在 baseURL 後拼接 /v1/messages，所以這裡填裸網域 https://api.nexthub.cc 即可，末尾不要加 /v1。

4. 驗證是否設定成功

執行 opencode，輸入 /models 命令，看到 Claude 模型出現在清單裡即為成功：

opencode
# 進入互動介面後執行
# /models

也可以連線 GPT 通道

在同一個 opencode.json 裡追加 openai 供應商，即可使用 GPT / Codex 系列模型：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "你的 NextHub ApiKey",
        "baseURL": "https://api.nexthub.cc"
      }
    },
    "openai": {
      "options": {
        "apiKey": "你的 NextHub ApiKey",
        "baseURL": "https://api.nexthub.cc/v1"
      }
    }
  }
}

兩組網址口徑不同

anthropic 走 Anthropic 協定，baseURL 填裸網域 https://api.nexthub.cc（自動拼接 /v1/messages）；openai 走 OpenAI 相容協定，baseURL 要帶 /v1。兩把 ApiKey 分別選對應分組（Claude 系分組與 GPT-Azure / GPT-Pro 分組），也可以用同一把——但分組決定可用模型，通常分開設定更清楚。