---
title: "编程智能体接入任意 OpenAI 兼容模型 | BroadRouter"
description: "把 Aider、Cline、Roo Code、opencode、Continue 和 Codex CLI 接入任意 OpenAI 兼容端点：每个工具的准确字段名，以及最容易出错的设置。"
url: https://broadrouter.com/zh/blog/use-open-models-in-coding-agents/
lang: zh-Hans
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。[阅读英文原文](https://broadrouter.com/blog/use-open-models-in-coding-agents/)（2026-11-16 更新）。

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

BroadNet Inference 团队 · 阅读约 4 分钟 · 发布于 2026-11-14 · 更新于 2026-11-16

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

## 要点

-   三个值就能接入任何智能体：base URL（BroadNet 为 https://inference.broadnet.ai/v1）、API 密钥和准确的模型 ID。
-   上下文大小和最大输出 token 要自己设置。对于自定义模型 ID，智能体无法自动识别。
-   依赖工具的智能体需要支持工具调用的模型；Aider 的文本编辑格式不需要。
-   Codex CLI 的配置参考只列出 responses 这一个受支持的 wire\_api，所以无法直接调用只支持 chat completions 的 API。
-   Roo Code 已于 2026 年 5 月 15 日归档。Zoo Code 是延续它的社区分支；Cline 是它的上游项目。

**本页内容**

1.  你需要服务商提供什么？
2.  逐个智能体：准确的设置
3.  怎样在接入智能体之前测试端点？
4.  最常出什么问题？
5.  BroadNet Inference 的定位

_[image: A developer working at a laptop with code on screen, at dusk.]_

编程智能体最初是为一两家大服务商设计的，但现在几乎都支持自定义的 OpenAI 兼容端点。这样你就可以用开源模型来运行它们：每个任务更便宜，上下文往往更大，基础设施也由你选择。本页是一张总览图，给出每个智能体的准确设置名，并在有完整分步指南时附上链接。

## 你需要服务商提供什么？

下面每个智能体都需要同样的三个值：

| 值 | BroadNet Inference |
| --- | --- |
| [Base URL](https://broadrouter.com/zh/glossary/base-url/) | `https://inference.broadnet.ai/v1` |
| API 密钥 | 你的按量付费密钥或套餐密钥 |
| 模型 ID | `broadnet/glm-5.3`、`broadnet/deepseek-v4.1-flash` 或 `broadnet/qwen3.8-27b` |

还有两个设置对每个智能体都很重要：**上下文窗口**和**最大输出 token**。对于自定义模型 ID，智能体无法自动识别这两个值，只能猜。请根据[模型页面](https://broadrouter.com/zh/models/)设置。

## 逐个智能体：准确的设置

| 智能体 | 在哪里设置 | Base URL 字段 | 模型字段 | 完整指南 |
| --- | --- | --- | --- | --- |
| Aider | 环境变量 | `OPENAI_API_BASE` | `--model openai/<id>` | [Aider 指南](https://broadrouter.com/zh/guides/aider-unlimited-deepseek/) |
| Cline | 设置，API Provider：OpenAI Compatible | Base URL | Model | [Cline 指南](https://broadrouter.com/zh/guides/cline-openai-compatible/) |
| Roo Code / Zoo Code | 设置，API Provider：OpenAI Compatible | Base URL | Model | [Roo Code 指南](https://broadrouter.com/zh/guides/roo-code-openai-compatible/) |
| opencode | `opencode.jsonc`，`providers` | `settings.baseURL` | `models.<key>.modelID` | [opencode 指南](https://broadrouter.com/zh/guides/opencode-custom-provider/) |
| Continue | `config.yaml`，`provider: openai` | `apiBase` | `model` | [Continue 指南](https://broadrouter.com/zh/guides/continue-dev-openai-compatible/) |
| Codex CLI | `config.toml`，`[model_providers.<id>]` | `base_url` | `model` | 见下文 |

### Aider

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

```yaml
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 代理](https://broadrouter.com/zh/guides/litellm-proxy-custom-provider/)，把 BroadNet 配置为 OpenAI 兼容的后端，并按 LiteLLM 的 Responses API 页面说明开启 chat completions 桥接。
2.  把 Codex 的 `base_url` 指向这个代理。
3.  用一个短任务测试。桥接可能丢失只有 Responses 才有的功能，所以要检查工具调用能否端到端正常工作。

如果觉得这样的管道太复杂，opencode 和 Aider 都是原生支持 chat completions 的终端智能体。

## 怎样在接入智能体之前测试端点？

智能体出问题时，很难分清是智能体的问题还是端点的问题。先单独检查端点，发送一个带工具的请求：

```bash
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 请求构建器](https://broadrouter.com/tools/api-request-builder/)可以用 curl、Python 或 Node 帮你写出这个请求。

## 最常出什么问题？

1.  \*\*模型 ID 错误。\*\*完整复制，包括 `broadnet/` 前缀。
2.  \*\*空回答。\*\*三个大模型都会先思考再回答，而思考计入输出上限。把上限调高。参见[为什么回答是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
3.  \*\*工具调用报错。\*\*使用列明支持[工具调用](https://broadrouter.com/zh/glossary/tool-calling/)的模型。BroadNet 为 GLM 5.3 和 Qwen3.8 27B 列出了工具支持，DeepSeek V4.1 Flash 没有。更多内容见[开源模型的工具调用](https://broadrouter.com/zh/blog/tool-calling-open-models/)。
4.  \*\*429 错误。\*\*一个按量付费密钥允许每分钟 30 个请求，同时 4 个。两个编辑器窗口共用一个密钥，请求会叠加。参见[错误与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。
5.  \*\*默认使用 Responses API。\*\*有些工具默认使用 OpenAI 较新的 API。在允许的地方把它们切换到 chat completions。

每个智能体该选哪个模型，见[编程智能体最佳开源模型](https://broadrouter.com/zh/blog/best-open-model-for-coding-agents/)。三个最流行的智能体有何不同，见 [Cline、Roo Code 与 Aider 对比](https://broadrouter.com/zh/blog/cline-vs-roo-code-vs-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](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-blog-use-open-models-in-coding-agents&utm_content=body) 获取一个密钥开始吧。

相关免费工具（英文）

-   [Agent run cost estimator](https://broadrouter.com/tools/agent-run-cost-estimator/) Context growth per step, total tokens and cost of one agent run, with a DeepSeek session comparison.
-   [LLM batch job planner](https://broadrouter.com/tools/llm-batch-job-planner/) Run time, binding limit, cost per model and the flat sessions needed to finish a big job by a deadline.
-   [Flat-rate vs per-token LLM cost calculator](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/) Break-even between an unlimited plan and paying per token, per agent.
-   [LLM rate limit and concurrency calculator](https://broadrouter.com/tools/llm-rate-limit-calculator/) Which limit binds first: RPM, TPM or concurrency, with Little's law.

[免费工具（英文）](https://broadrouter.com/tools/)

## 本文涉及的术语

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

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

[Base URL（base\_url）](https://broadrouter.com/zh/glossary/base-url/)

base URL 是 API 固定的根地址，例如 https://api.example.com/v1，客户端会把它加在每个端点路径（例如 /chat/completions）前面。在 OpenAI 兼容 SDK 中，修改 base URL，再配合 API 密钥和模型 ID，就能让同一份代码改用另一家服务商。

[Chat Completions API（对话补全接口）](https://broadrouter.com/zh/glossary/chat-completions-api/)

Chat Completions API 是 OpenAI 的 HTTP 端点 POST /v1/chat/completions，它接收模型名称和一组带角色标记的消息，返回模型的下一条消息。它的请求与响应结构已成为 OpenAI 兼容服务商和各类 SDK 通用的格式。

[开放权重模型（open-weight model）](https://broadrouter.com/zh/glossary/open-weight-model/)

开放权重模型是公开发布训练好的权重、任何人都可以下载和运行的机器学习模型，通常附带有条件的许可证。它不同于完全开源的 AI，后者还会公开训练代码和训练数据的详细信息，让其他人能够研究并复现模型。

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

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

[输入 token 与输出 token](https://broadrouter.com/zh/glossary/input-and-output-tokens/)

输入 token 是语言模型在一次请求中读取的 token，包括系统提示词、对话历史、工具定义和图片。输出 token 是模型生成回复的 token，包括思考内容。大模型 API 通常分别计价，输出一般更贵。

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

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

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

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 的不限量套餐中。

## 继续阅读

-   [Claude Code 接入开源模型：代理、原生端点与限制](https://broadrouter.com/zh/blog/claude-code-with-openai-compatible-models/)
-   [编程智能体最佳开源模型：按工具、上下文和成本来选](https://broadrouter.com/zh/blog/best-open-model-for-coding-agents/)
-   [Cline vs Roo Code vs Aider：用开源模型的团队怎么选（2026）](https://broadrouter.com/zh/blog/cline-vs-roo-code-vs-aider/)
-   [用 OpenAI 兼容模型接入 MCP 服务器（任意服务商）](https://broadrouter.com/zh/blog/mcp-with-openai-compatible-models/)
-   [迁移到 OpenAI 兼容 API：切换服务商检查清单](https://broadrouter.com/zh/blog/openai-compatible-api-migration-checklist/)
-   [AI 编程智能体跑一次要花多少钱：步数、上下文增长与缓存](https://broadrouter.com/zh/blog/ai-coding-agent-run-cost/)
-   [OpenClaw 和 Hermes Agent 接便宜模型：配置与 token 账](https://broadrouter.com/zh/blog/openclaw-hermes-agent-cheap-model/)
-   [指南：用不限量的 DeepSeek V4.1 Flash 运行 Aider](https://broadrouter.com/zh/guides/aider-unlimited-deepseek/)
-   [指南：在 Cline 中使用 BroadNet Inference（OpenAI Compatible 提供商）](https://broadrouter.com/zh/guides/cline-openai-compatible/)
-   [指南：在 Roo Code 中使用 BroadNet Inference（OpenAI Compatible）](https://broadrouter.com/zh/guides/roo-code-openai-compatible/)
-   [指南：把 BroadNet Inference 添加为 opencode 的自定义供应商](https://broadrouter.com/zh/guides/opencode-custom-provider/)
-   [指南：在 Continue 中使用 BroadNet Inference（config.yaml 与 apiBase）](https://broadrouter.com/zh/guides/continue-dev-openai-compatible/)
-   [指南：用 LiteLLM 路由到 BroadNet Inference（SDK 与代理）](https://broadrouter.com/zh/guides/litellm-proxy-custom-provider/)

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

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-blog-use-open-models-in-coding-agents&utm_content=page-cta) ·

**来源**

-   [Aider 文档：OpenAI 兼容 API](https://aider.chat/docs/llms/openai-compat.html)
-   [Aider 文档：选项参考（--message、--yes-always；2026-11-14 核实）](https://aider.chat/docs/config/options.html)
-   [Cline 文档：OpenAI Compatible 提供方](https://docs.cline.bot/provider-config/openai-compatible)
-   [Roo Code 仓库：归档说明（2026-11-14 核实）](https://github.com/RooCodeInc/Roo-Code)
-   [Roo Code 更新日志：移除旧的 XML 工具调用（2026-11-16 核实）](https://github.com/RooCodeInc/Roo-Code/blob/main/CHANGELOG.md)
-   [Zoo Code 仓库（2026-11-14 核实）](https://github.com/Zoo-Code-Org/Zoo-Code)
-   [opencode 文档：Providers](https://opencode.ai/docs/providers/)
-   [Continue 文档：OpenAI 提供方](https://docs.continue.dev/customize/model-providers/top-level/openai)
-   [Continue 文档：config.yaml 参考（capabilities、defaultCompletionOptions；2026-11-14 核实）](https://docs.continue.dev/reference)
-   [Codex 配置参考：model\_providers 与 wire\_api（2026-11-14 核实）](https://learn.chatgpt.com/docs/config-file/config-reference)
-   [LiteLLM 文档：/v1/responses 桥接到 chat completions（2026-11-14 核实）](https://docs.litellm.ai/docs/response_api)
