AiHubMix Documentation Hub

当前已支持 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

一、安装 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 安装

Windows 用户可通过以下方式安装 OpenCode：

# 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

二、启动与登录 OpenCode

安装完成后，执行以下步骤完成登录与配置。

登录OpenCode

在终端输入以下命令：

opencode auth login

选择 AI 供应商

在登录界面中选择 **AIHubMix **作为模型供应商。

API Key授权

输入 AiHubMix API Key 并在 OpenCode 登录页面中输入该密钥以完成授权。

三、模型使用

安装验证

可通过以下命令验证 OpenCode 是否安装并配置成功：

opencode

选择模型

输/models ，搜aihubmix，选择需要的模型。

四、在 OpenCode 客户端使用

下载 OpenCode 桌面端：https://opencode.ai/download 。
打开 OpenCode，输入/model -> Connet provider -> 搜索aihubmix -> 输入 API Key -> Submit 。
在模型选择栏搜aihubmix ，选择需要使用的模型即可使用。

五、手动配置更新模型

以添加 DeepSeek V4 Pro 为例。

第一步：确认模型 ID

在 AIHubMix 模型界面找到目标模型，复制 ID。也可以通过 API 直接查询：

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

第二步：打开配置文件

根据你的系统，在终端运行对应命令： 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 内容。

第三步：写入配置

如果是空文件，直接粘贴以下内容：

{
  "$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"`

第四步：重启 OpenCode

保存配置文件后，完全退出 OpenCode 并重新启动，新模型才会加载。

第五步：验证

打开模型选择（默认快捷键 ;），搜索 V4 或 DeepSeek，确认 DeepSeek-V4-Pro 已出现在列表中。

六、自定义 Base URL

默认情况下，OpenCode 会把 AIHubMix 的请求发往 https://aihubmix.com/v1。如果你需要让请求走自建网关、企业代理或加速节点，可以在配置文件中通过 options.baseURL 覆盖，无需修改 OpenCode 源码或重新安装。

第一步：打开配置文件

按「五、手动配置更新模型」中的方式打开 ~/.config/opencode/opencode.json（Windows 为 %USERPROFILE%\.config\opencode\opencode.json）。

第二步：添加 `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。

第三步：重启并验证

完全退出 OpenCode 后重新启动。可运行以下命令确认配置已生效：

opencode debug config

在输出的 provider.aihubmix.options.baseURL 中应能看到你填入的地址；之后任意一次模型请求都会发往该地址。 字段说明：

字段	说明
`options.baseURL`	自定义请求地址，优先级高于默认地址；填到域名级即可，路径自动拼接

七、常见问题与提示

若API Key无法通过验证，请重新登录AIHubMix并检查密钥有效性。
查看帮助文档：opencode ->/help。
opencode官方文档：https://opencode.ai/docs/ 。

最新更新日期： 2026年4月27日

编程助手

IDE 集成

Agent / Workflow 平台

SDK 与框架

OpenCode

一、安装 OpenCode

二、启动与登录 OpenCode

三、模型使用

四、在 OpenCode 客户端使用

五、手动配置更新模型

第一步：确认模型 ID

第二步：打开配置文件

第三步：写入配置

第四步：重启 OpenCode

第五步：验证

六、自定义 Base URL

第一步：打开配置文件

第二步：添加 `options.baseURL`

第三步：重启并验证

七、常见问题与提示

​一、安装 OpenCode

​二、启动与登录 OpenCode

​三、模型使用

​四、在 OpenCode 客户端使用

​五、手动配置更新模型

​第一步：确认模型 ID

​第二步：打开配置文件

​第三步：写入配置

​第四步：重启 OpenCode

​第五步：验证

​六、自定义 Base URL

​第一步：打开配置文件

​第二步：添加 options.baseURL

​第三步：重启并验证

​七、常见问题与提示

一、安装 OpenCode

二、启动与登录 OpenCode

三、模型使用

四、在 OpenCode 客户端使用

五、手动配置更新模型

第一步：确认模型 ID

第二步：打开配置文件

第三步：写入配置

第四步：重启 OpenCode

第五步：验证

六、自定义 Base URL

第一步：打开配置文件

第二步：添加 `options.baseURL`

第三步：重启并验证

七、常见问题与提示