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 分组），也可以用同一把——但分组决定可用模型，通常分开配更清晰。