opencode 是一个运行在终端里的开源编程 agent。不在它内置目录中的供应商,要在 opencode.jsonc 里作为自定义供应商添加。BroadNet Inference 使用 OpenAI 对话补全格式,所以用的是 opencode 的 OpenAI 兼容运行时包。本指南依据 opencode 当前(V2)的文档。
配置步骤
- 在启动 opencode 的 shell 中导出密钥:
export BROADNET_API_KEY='your-broadnet-key'
- 创建配置文件。 放在项目里命名为
opencode.jsonc,或者放在~/.config/opencode/opencode.jsonc,在所有项目中生效。
{
"$schema": "https://opencode.ai/config.json",
"model": "broadnet/glm-5.3",
"providers": {
"broadnet": {
"name": "BroadNet Inference",
"env": ["BROADNET_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": {
"baseURL": "https://inference.broadnet.ai/v1"
},
"models": {
"glm-5.3": {
"modelID": "broadnet/glm-5.3",
"name": "GLM 5.3",
"capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"deepseek-v4.1-flash": {
"modelID": "broadnet/deepseek-v4.1-flash",
"name": "DeepSeek V4.1 Flash",
// BroadNet's docs don't list tool calling for this model: test it first
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"qwen3.8-27b": {
"modelID": "broadnet/qwen3.8-27b",
"name": "Qwen3.8 27B",
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 262144, "output": 16000 }
}
}
}
}
}
- 启动 opencode,并用
/models选择模型。 引用格式是broadnet/<映射键>,例如broadnet/glm-5.3。opencode 发送给 BroadNet 的是modelID的值。
配置文件会合并。opencode 先应用全局文件,然后从当前目录向上查找项目文件(最远的先应用),再应用 .opencode/ 中的配置,所以项目文件可以覆盖全局的供应商设置。如果你的公司使用托管的系统配置,它会覆盖以上两者。密钥请放在环境变量里而不是文件里,这样配置文件就可以放进版本控制。
为什么要用别名
BroadNet 的 ID 本身就带斜杠(broadnet/glm-5.3)。models 映射键是 opencode 显示和选择时用的名字,modelID 是它实际发送的值。简短的键让引用更易读。
capabilities 和 limit 请自己设置。对于目录外的模型,opencode 会假定它支持 JSON 工具调用、接受文本和图片输入、上下文为 200,000 token、输出为 32,000 token。它的文档称这些为兜底假设,而不是检测出来的值。上面 output 设为 16000 是我们的建议,不是 BroadNet 的限制;这样可以给思考留出空间。
旧版 V1 配置
opencode V2 仍然能读取 V1 格式,所以像这样的现有配置块可以继续使用:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"broadnet": {
"npm": "@ai-sdk/openai-compatible",
"name": "BroadNet Inference",
"options": {
"baseURL": "https://inference.broadnet.ai/v1",
"apiKey": "{env:BROADNET_API_KEY}"
},
"models": {
"broadnet/glm-5.3": { "name": "GLM 5.3" }
}
}
}
}
在原生 V2 写法中,provider 变成 providers,npm 变成 package(如果想继续使用 AI SDK 的包,就写 aisdk:@ai-sdk/openai-compatible),options.baseURL 和 options.apiKey 移到 settings 下。opencode V1 迁移指南列出了每个字段的对应关系。
选哪个模型
| 任务 | 模型 | 说明 |
|---|---|---|
| 带工具的 agent 编程 | GLM 5.3 | 列出了工具和结构化输出;1M 上下文 |
| 截图、阿拉伯语 | Qwen3.8 27B | 工具和图片;262K 上下文 |
| 全天会话、固定价格 | DeepSeek V4.1 Flash | 不限量套餐;BroadNet 未列出工具 |
opencode 依赖工具调用。BroadNet 的文档没有为 DeepSeek V4.1 Flash 列出工具调用,所以配置里把它标成了需要测试的假设。买一个月 Full Moon($60)之前,先用一小时 Meteor($1)跑一个真实任务。
故障排查
- 401。
BROADNET_API_KEY中的密钥错误、已过期,或者按量付费额度已用完。确认运行 opencode 的进程里设置了这个变量。 - 找不到模型或模型被拒绝。 选择映射键(
broadnet/glm-5.3),并检查modelID是否与 BroadNet 的 ID 完全一致。引用区分大小写。付费模型需要先充值;$5 额度只能用于broadnet/gemma-4-26b-a4b和两个 Transcribe 模型。 - 回答为空。 调高
limit.output。为什么回答会是空的。 - 429。 按量付费密钥每分钟允许 30 个请求,同时最多 4 个在处理中。重试也会计入。见错误码与重试。
- 在套餐上运行子 agent。 每个套餐会话一次只处理一个请求,所以并行的子 agent 会排队,除非每个都有自己的会话。
