编程智能体最初是为一两家大服务商设计的,但现在几乎都支持自定义的 OpenAI 兼容端点。这样你就可以用开源模型来运行它们:每个任务更便宜,上下文往往更大,基础设施也由你选择。本页是一张总览图,给出每个智能体的准确设置名,并在有完整分步指南时附上链接。
你需要服务商提供什么?
下面每个智能体都需要同样的三个值:
| 值 | BroadNet Inference |
|---|---|
| Base URL | https://inference.broadnet.ai/v1 |
| API 密钥 | 你的按量付费密钥或套餐密钥 |
| 模型 ID | broadnet/glm-5.3、broadnet/deepseek-v4.1-flash 或 broadnet/qwen3.8-27b |
还有两个设置对每个智能体都很重要:上下文窗口和最大输出 token。对于自定义模型 ID,智能体无法自动识别这两个值,只能猜。请根据模型页面设置。
逐个智能体:准确的设置
| 智能体 | 在哪里设置 | Base URL 字段 | 模型字段 | 完整指南 |
|---|---|---|---|---|
| Aider | 环境变量 | OPENAI_API_BASE |
--model openai/<id> |
Aider 指南 |
| Cline | 设置,API Provider:OpenAI Compatible | Base URL | Model | Cline 指南 |
| Roo Code / Zoo Code | 设置,API Provider:OpenAI Compatible | Base URL | Model | Roo Code 指南 |
| opencode | opencode.jsonc,providers |
settings.baseURL |
models.<key>.modelID |
opencode 指南 |
| Continue | config.yaml,provider: openai |
apiBase |
model |
Continue 指南 |
| Codex CLI | config.toml,[model_providers.<id>] |
base_url |
model |
见下文 |
Aider
export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY=your-key
aider --model openai/broadnet/deepseek-v4.1-flash
openai/ 前缀告诉 Aider 走 OpenAI 兼容的路径。Aider 可能会警告它不知道这个模型的上下文大小;对于不在它列表中的模型,这是正常的。
Cline
API Provider 选择 OpenAI Compatible,然后填写 Base URL、API Key 和 Model。打开 Model Configuration,设置上下文窗口和最大输出 token。Cline 可以为 Plan 和 Act 模式使用不同的模型,这是一个省钱的办法:把更贵的模型只留给规划。
Roo Code 和 Zoo Code
Roo Code 的仓库已于 2026 年 5 月 15 日归档,README 说这个扩展已经停止服务。它引导用户转向 Zoo Code(由 Roo Code 社区发起、继续其开发的分支)和 Cline。已安装的 Roo Code 使用与 Cline 相同的 OpenAI Compatible 字段;Roo 的更新日志显示旧的 XML 工具调用已被移除,所以请选择列明支持原生工具调用的模型。Zoo Code 请按它自己的文档操作。
opencode
opencode 在 opencode.jsonc 的 providers 下添加服务商,使用 OpenAI 兼容包和 settings.baseURL。BroadNet 的 ID 本身已经包含斜杠,所以请用 glm-5.3 这样的短映射键,把完整 ID 填在 modelID 中。capabilities 和 limit 要自己设置;否则 opencode 会按默认假设处理。
Continue
models:
- name: GLM 5.3
provider: openai
model: broadnet/glm-5.3
apiBase: https://inference.broadnet.ai/v1
apiKey: your-key
capabilities: [tool_use]
defaultCompletionOptions:
contextLength: 1048576
maxTokens: 8000
Continue 的 Agent 模式需要 tool_use。不支持工具调用的模型不要加这一项。
Codex CLI
Codex 在 config.toml 中用 base_url 和 env_key 定义服务商。它当前的配置参考说 responses 是唯一受支持的 wire_api 值,现在 Codex 遇到 wire_api = "chat" 会直接报错。BroadNet Inference 提供的是 /v1/chat/completions,所以 Codex 无法直接调用。变通办法是加一个做格式转换的代理。LiteLLM 的文档说它的代理提供 /v1/responses,并能通过 chat completions 进行桥接:
- 运行 LiteLLM 代理,把 BroadNet 配置为 OpenAI 兼容的后端,并按 LiteLLM 的 Responses API 页面说明开启 chat completions 桥接。
- 把 Codex 的
base_url指向这个代理。 - 用一个短任务测试。桥接可能丢失只有 Responses 才有的功能,所以要检查工具调用能否端到端正常工作。
如果觉得这样的管道太复杂,opencode 和 Aider 都是原生支持 chat completions 的终端智能体。
怎样在接入智能体之前测试端点?
智能体出问题时,很难分清是智能体的问题还是端点的问题。先单独检查端点,发送一个带工具的请求:
curl -s https://inference.broadnet.ai/v1/chat/completions \
-H "Authorization: Bearer $BROADNET_API_KEY" -H "Content-Type: application/json" \
-d '{"model":"broadnet/glm-5.3","max_tokens":2000,
"messages":[{"role":"user","content":"Read the file README.md"}],
"tools":[{"type":"function","function":{"name":"read_file",
"parameters":{"type":"object","properties":{"path":{"type":"string"}},"required":["path"]}}}]}'
如果回复中有 finish_reason: "tool_calls" 和一个 read_file 调用,说明模型和密钥都没问题,剩下的问题出在智能体的设置上。如果它用纯文本回答,请为依赖工具的智能体换一个模型。API 请求构建器可以用 curl、Python 或 Node 帮你写出这个请求。
最常出什么问题?
- **模型 ID 错误。**完整复制,包括
broadnet/前缀。 - **空回答。**三个大模型都会先思考再回答,而思考计入输出上限。把上限调高。参见为什么回答是空的。
- **工具调用报错。**使用列明支持工具调用的模型。BroadNet 为 GLM 5.3 和 Qwen3.8 27B 列出了工具支持,DeepSeek V4.1 Flash 没有。更多内容见开源模型的工具调用。
- **429 错误。**一个按量付费密钥允许每分钟 30 个请求,同时 4 个。两个编辑器窗口共用一个密钥,请求会叠加。参见错误与重试。
- **默认使用 Responses API。**有些工具默认使用 OpenAI 较新的 API。在允许的地方把它们切换到 chat completions。
每个智能体该选哪个模型,见编程智能体最佳开源模型。三个最流行的智能体有何不同,见 Cline、Roo Code 与 Aider 对比。
BroadNet Inference 的定位
BroadNet Inference 为上面所有智能体提供一个 OpenAI 兼容端点,可使用 GLM 5.3、DeepSeek V4.1 Flash 和 Qwen3.8 27B,并且零数据保留。它的不限量套餐让 DeepSeek V4.1 Flash 变成每个会话每月固定 $60,适合 Aider 和其他整天运行的智能体。不加代理的话,它不能直接替换 Codex CLI 的后端,也不托管网页搜索这类服务商侧工具。从 inference.broadnet.ai 获取一个密钥开始吧。

