BroadRouter

编程智能体接入开源模型:Aider、Cline、opencode、Codex

BroadNet Inference 团队 · 阅读约 4 分钟 · 发布于 · 更新于

每个主流编程智能体接入自定义模型都需要三个值:base URL、API 密钥和模型 ID。Aider 用 OPENAI_API_BASE,Cline 和 Roo Code 用 OpenAI Compatible 提供方,opencode 用自定义 provider,Continue 用 apiBase。Codex CLI 现在只支持 Responses API,所以 chat completions 端点需要 LiteLLM 这样的转换代理。

A developer working at a laptop with code on screen, at dusk.

编程智能体最初是为一两家大服务商设计的,但现在几乎都支持自定义的 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 进行桥接:

  1. 运行 LiteLLM 代理,把 BroadNet 配置为 OpenAI 兼容的后端,并按 LiteLLM 的 Responses API 页面说明开启 chat completions 桥接。
  2. 把 Codex 的 base_url 指向这个代理。
  3. 用一个短任务测试。桥接可能丢失只有 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 帮你写出这个请求。

最常出什么问题?

  1. **模型 ID 错误。**完整复制,包括 broadnet/ 前缀。
  2. **空回答。**三个大模型都会先思考再回答,而思考计入输出上限。把上限调高。参见为什么回答是空的。
  3. **工具调用报错。**使用列明支持工具调用的模型。BroadNet 为 GLM 5.3 和 Qwen3.8 27B 列出了工具支持,DeepSeek V4.1 Flash 没有。更多内容见开源模型的工具调用。
  4. **429 错误。**一个按量付费密钥允许每分钟 30 个请求,同时 4 个。两个编辑器窗口共用一个密钥,请求会叠加。参见错误与重试。
  5. **默认使用 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 获取一个密钥开始吧。

常见问题

Codex CLI 能用 OpenAI 兼容 API 吗?

只有当端点支持 Responses API 时才行。Codex 的配置参考只列出 responses 这一个受支持的 wire_api 值。对于只支持 chat completions 的服务商,需要在前面加一个 LiteLLM 这样的代理;它的文档介绍了如何通过 /v1/chat/completions 桥接 /v1/responses。

Roo Code 还在维护吗?

没有。它的 GitHub 仓库已于 2026 年 5 月 15 日归档,README 说这个扩展已经停止服务。它引导用户转向 Zoo Code(README 称之为由 Roo Code 社区发起的分支)和 Cline。

为什么智能体提示找不到模型?

模型 ID 必须与服务商的 ID 完全一致。BroadNet 的 ID 带有前缀,例如 broadnet/glm-5.3。在 Aider 中,还要在它前面加上 openai/ 前缀。

为什么用开源模型时智能体返回空回答?

思考模型会把一部分输出预算花在思考上。如果最大输出 token 太小,可见的回答根本来不及开始。把它提高到几千 token。

编程智能体应该用哪个开源模型?

对于通过工具调用工作的智能体,使用列明支持工具调用的模型,例如 GLM 5.3。对于 Aider,DeepSeek V4.1 Flash 效果很好,而且包含在 BroadNet 的不限量套餐中。

以 Markdown 格式阅读问 ChatGPT问 Claude问 Perplexity