OpenCode 可通过自定义 OpenAI 兼容提供方连接 TokenHub。腾讯云 OpenCode 文档的配置样例使用 DeepSeek V4 Pro;下文依据同一平台的混元调用指南,将模型 ID 和显示名替换为 Hy4。此替换是按文档 schema 做的适配示例,不是腾讯云发布的 Hy4 专属示例,也未经实际调用验证。
适合的任务:在 OpenCode 桌面端或 CLI 中使用 TokenHub Hy4 辅助代码分析、编写和修改。
不适合的任务:需要已验证的 Hy4 专属配置或生产可用性保证的场景;官方 OpenCode 页面没有给出 Hy4 示例,本文也未实测。
适用的模型版本:TokenHub 模型 ID hy4,对应 Hy4 正式版。
适用的客户端、Agent 或 API:OpenCode 桌面端或 CLI;TokenHub 的 OpenAI 兼容提供方。
推荐的推理档位和参数:TokenHub 混元指南称 Hy4 默认推理档位为 high。OpenCode 接入页未说明如何在该自定义提供方配置中覆盖推理档位,本文不添加未证实的参数。
以下 JSON 沿用腾讯云 OpenCode 文档中的配置结构,将示例模型 deepseek-v4-pro 替换为混元指南列出的正式版模型 ID hy4,显示名改为 Hy4。这属于 schema 适配,非官方 Hy4 原样配置:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"tencent": {
"npm": "@ai-sdk/openai-compatible",
"name": "Tencent",
"options": {
"baseURL": "https://tokenhub.tencentmaas.com/v1"
},
"models": {
"hy4": {
"name": "Hy4"
}
}
}
}
}配置文件路径:~/.config/opencode/opencode.json。在 OpenCode CLI 输入 /connect,选择 Tencent,再粘贴 TokenHub API Key;随后输入 /models,选择 Hy4。
在 OpenCode 的模型管理中添加自定义 OpenAI 兼容提供方,填写:
| 字段 | 值 |
|---|---|
| 提供商 ID | tencent |
| 显示名称 | Tencent |
| 基础 URL | https://tokenhub.tencentmaas.com/v1 |
| API 密钥 | TokenHub API Key |
| 模型 ID | hy4 |
| 模型显示名称 | Hy4 |
保存后重启 OpenCode,并在模型列表选择 Hy4。桌面端字段中的 hy4 同样是依据混元指南对官方 DeepSeek 示例所作的替换。
在 TokenHub 创建 API Key,并确认密钥的可访问范围包含 Hy4。官方 OpenCode 文档对 DeepSeek 示例要求密钥权限包含 DeepSeek V4 Pro;将权限检查对象改为 Hy4 是基于 TokenHub 模型 ID 的适配。
按上文配置 OpenCode 桌面端或 CLI,使用基础 URL https://tokenhub.tencentmaas.com/v1。
通过 /connect 保存 API Key,在 /models 中选择 Hy4;桌面端则重启后选择该模型。
发起一个简单的代码解释任务,检查是否收到回答。此步骤是建议的用户侧验证流程,不代表本文已运行 OpenCode 或完成请求测试。
腾讯云 OpenCode 文档最近更新时间为 2026-08-31,介绍桌面端和 CLI 配置,示例模型为 deepseek-v4-pro,基础 URL 为 https://tokenhub.tencentmaas.com/v1。
该文档的 CLI 配置使用 @ai-sdk/openai-compatible、provider.tencent.models 字段;CLI 通过 /connect 配置 API Key、通过 /models 切换模型。
TokenHub 混元调用指南列出正式版模型 ID hy4,与 hy4-preview 区分;Hy4 上下文窗口为 1,024k,最大输入为 960k,最大输出为 64k。
混元指南称 Hy4 默认推理档位为 high。这些模型 ID 和参数用于交叉核对,未在腾讯云 OpenCode 页作为 Hy4 配置示例出现。
配置 JSON 是基于官方 OpenCode 示例结构替换模型 ID 的推导,腾讯云文档没有确认该具体 Hy4 配置,也未提供 Hy4 与 OpenCode 的兼容性测试结果。
本文没有验证 OpenCode 版本、模型调用、密钥权限报错、流式输出或工具调用行为;如遇配置问题,应先核对当前 OpenCode 对自定义提供方的要求和 TokenHub 控制台的模型权限。
不要将 hy4-preview 或其他平台的模型标识当作 TokenHub 正式版模型 ID;TokenHub 混元指南使用 hy4。
2026-11-16 使用 Tabbit 阅读腾讯云 TokenHub OpenCode 配置文档及混元调用指南。本文根据前者的配置字段和后者公布的 hy4 模型 ID 编写适配示例;未安装 OpenCode、未写入本机配置,也未使用 API Key 发起请求。
Hy4