OpenCode | 文档中心

一、前置工作

获取配置凭证

支持两种使用方式，但对应的凭证获取方式不同：

使用方式

说明

获取方式（以下为 API Key 均为示例）

按量付费 API 调用

按实际使用量计费，适合轻度使用

Base URL OpenAI 兼容协议：https://maas-api.hivoice.cn/v1 Anthropic 兼容协议：https://maas-api.hivoice.cn/anthropic
API Key
格式：sk-xxxxx

前往 API Key 创建 API Key

Token Plan

固定订阅费，按套餐限量调用

Base URL OpenAI 兼容协议：https://maas-api.hivoice.cn/v1 Anthropic 兼容协议：https://maas-api.hivoice.cn/anthropic
API Key
格式：tp-xxxxx

成功订阅后，前往订阅管理获取专属 API Key

二、安装 OpenCode

安装 Node.js（v18.0 或更高版本）。
在终端中执行以下命令安装 OpenCode

安装命令

Bash

npm install -g opencode-ai

运行以下命令验证安装。若有版本号输出，则表示安装成功。

Bash

opencode -v

三、配置 Unisound U2 模型

1.配置基本信息

编辑或新建 opencode.json 配置文件，具体路径如下：

macOS/Linux：~/.config/opencode/opencode.json
Windows：用户目录\.config\opencode\opencode.json

将以下内容完整复制到配置文件中（实际使用时按需更换 UNISOUND_API_KEY）：

JSON

{
  "$schema": "https://opencode.ai/config.json",
	"provider": {
		"unisound": {
			"npm": "@ai-sdk/openai-compatible",
			"name": "Unisound U2",
			"options": {
				"baseURL": "BASE_URL",
				"apiKey": "UNISOUND_API_KEY"
			}
		}
	},
	"models": {
		"u2": {
			"name": "u2",
			"limit": {
				"context": 196608,
				"output": 65535
			},
			"modalities": {
				"input": [
					"text"
				],
				"output": [
					"text"
				]
			}
		}
	}
}