---
title: "opencode 自定义 OpenAI 兼容供应商配置 | BroadRouter"
description: "在 opencode.jsonc 中把 BroadNet Inference 添加为 opencode 编程 agent 的自定义 OpenAI 兼容供应商，并设置模型别名、能力和限制。"
url: https://broadrouter.com/zh/guides/opencode-custom-provider/
lang: zh-Hans
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。 [阅读英文原文](https://broadrouter.com/guides/opencode-custom-provider/) (2026-11-16 更新).

# 把 BroadNet Inference 添加为 opencode 的自定义供应商

更新于 2026-11-16

在 opencode.jsonc 的 providers 下添加一个 broadnet 条目：package 设为 @opencode/ai/providers/openai-compatible，settings.baseURL 设为 https://inference.broadnet.ai/v1，env 设为 BROADNET\_API\_KEY。再用 modelID 把简短的模型键映射到 BroadNet 的 ID，例如 broadnet/glm-5.3，然后用 /models 选择模型。使用 npm @ai-sdk/openai-compatible 和 options.baseURL 的旧版 V1 配置仍然可用。

opencode 是一个运行在终端里的开源编程 agent。不在它内置目录中的供应商，要在 `opencode.jsonc` 里作为**自定义供应商**添加。BroadNet Inference 使用 OpenAI 对话补全格式，所以用的是 opencode 的 OpenAI 兼容运行时包。本指南依据 opencode 当前（V2）的文档。

## 配置步骤

1.  在启动 opencode 的 shell 中**导出密钥**：

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **创建配置文件。** 放在项目里命名为 `opencode.jsonc`，或者放在 `~/.config/opencode/opencode.jsonc`，在所有项目中生效。

```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 }
        }
      }
    }
  }
}
```

3.  **启动 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 格式，所以像这样的现有配置块可以继续使用：

```json
{
  "$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 迁移指南](https://opencode.ai/docs/migrate-v1/)列出了每个字段的对应关系。

## 选哪个模型

| 任务 | 模型 | 说明 |
| --- | --- | --- |
| 带工具的 agent 编程 | [GLM 5.3](https://broadrouter.com/zh/models/glm-5.3/) | 列出了工具和结构化输出；1M 上下文 |
| 截图、阿拉伯语 | [Qwen3.8 27B](https://broadrouter.com/zh/models/qwen3.8-27b/) | 工具和图片；262K 上下文 |
| 全天会话、固定价格 | [DeepSeek V4.1 Flash](https://broadrouter.com/zh/models/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`。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **429。** 按量付费密钥每分钟允许 30 个请求，同时最多 4 个在处理中。重试也会计入。见[错误码与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。
-   **在套餐上运行子 agent。** 每个[套餐会话](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)一次只处理一个请求，所以并行的子 agent 会排队，除非每个都有自己的会话。

## 本指南涉及的术语

[子智能体（subagent）](https://broadrouter.com/zh/glossary/subagent/)

子智能体是主智能体为处理一项明确任务而启动的独立智能体。它有自己的上下文窗口、系统提示词和工具权限，完成工作后只把结果或摘要返回给主智能体，从而让主对话保持精简。

[AI 智能体（AI agent）](https://broadrouter.com/zh/glossary/agent/)

AI 智能体是由语言模型自主决定步骤、朝目标推进的系统：它决定调用哪些工具、读取结果，然后重复，直到给出最终回答或触及上限。在固定位置调用模型的固定脚本，通常称为工作流（workflow）。

[按量付费（pay-as-you-go）](https://broadrouter.com/zh/glossary/pay-as-you-go/)

按量付费是一种计价模式：你只为实际用量付费，按 token、请求次数或音频分钟等单位计量，没有订阅费，也没有最低消费承诺。大多数大模型 API 都这样计费，从预付余额中扣减或定期开具账单。

[Token（词元）](https://broadrouter.com/zh/glossary/token/)

token（词元）是大语言模型读写文本的基本单位：由模型的分词器切分出的一个词、词的一部分、一个标点或一段字节序列。大模型 API 按 token 计数、设定限制，通常也按 token 计费。

[并发（concurrency）](https://broadrouter.com/zh/glossary/concurrency/)

并发（concurrency）是客户端在同一时刻正在进行中的请求数。大模型 API 往往按密钥或套餐单独限制并发，与每分钟请求数分开计算，因为每个未完成的请求在响应结束前都会占用 GPU 资源。

[大模型包月套餐（flat-rate LLM plan）](https://broadrouter.com/zh/glossary/flat-rate-llm-plan/)

大模型包月套餐（固定价格套餐）是按一个周期（如一个月）收取固定费用、提供大模型 API 使用权的计价方式，不按 token 计费。这类套餐通常会限制别的东西，如并发、速度、模型或使用时间窗口，所以限制条件和价格同样重要。

[结构化输出（structured output）](https://broadrouter.com/zh/glossary/structured-output/)

结构化输出是大模型 API 的一项功能，它把模型的回复约束为开发者指定的格式（通常是 JSON Schema），让代码能可靠地解析。它比 JSON mode 更严格：JSON mode 只保证输出是合法 JSON，不保证特定结构。

[速率限制（rate limit）](https://broadrouter.com/zh/glossary/rate-limit/)

速率限制是 API 对客户端在一个时间窗口内的使用量设定的上限，例如每分钟请求数或每分钟 token 数。超出限制的请求会被拒绝，通常返回 HTTP 429 Too Many Requests，直到用量回落到限制以下。

## 常见问题

### opencode 为什么找不到我的 BroadNet 模型？

opencode 按“供应商/映射键”解析模型引用，而且 ID 区分大小写。按下面的配置，应该选择 broadnet/glm-5.3，其中 glm-5.3 是映射键。modelID 的值只是发送给 BroadNet 的内容。

### 我的配置用的是 provider 和 npm（@ai-sdk/openai-compatible），这样写错了吗？

没错。那是 V1 格式，opencode 的迁移指南说它仍然受支持。原生 V2 写法把 provider 改名为 providers，npm 改为 package（aisdk:@ai-sdk/openai-compatible），options.baseURL 改为 settings.baseURL。

### opencode 的回复为什么是空的？

模型把输出预算花在了思考上。请调高该模型的 limit.output。在 BroadNet 上，思考内容计入 max\_tokens。

## 相关指南

-   [在 Cline 中使用 BroadNet Inference（OpenAI Compatible 提供商）](https://broadrouter.com/zh/guides/cline-openai-compatible/)
-   [面向智能体的不限量 LLM API 套餐如何运作](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)
-   [推理模型为什么返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
-   [用 Vercel AI SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/vercel-ai-sdk-openai-compatible/)
-   [所有可与 BroadNet Inference 配合使用的工具 （英文）](https://broadrouter.com/integrations/)：SDK、编程智能体、聊天界面和自动化工具，并附每个工具的具体设置

用你的真实业务负载试一试。 新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-opencode-custom-provider&utm_content=page-cta) ·

**来源**

-   [opencode 文档：Providers（自定义供应商）（核对于 2026-11-14）](https://opencode.ai/docs/providers/)
-   [opencode 文档：Models（别名、能力、限制）（核对于 2026-11-14）](https://opencode.ai/docs/models/)
-   [opencode 文档：配置文件位置（核对于 2026-11-14）](https://opencode.ai/docs/config/)
-   [opencode 文档：从 V1 迁移（核对于 2026-11-14）](https://opencode.ai/docs/migrate-v1/)
-   [BroadNet Inference API 参考文档 （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-opencode-custom-provider&utm_content=sources)
