---
title: "停服后的 Roo Code：OpenAI Compatible 配置 | BroadRouter"
description: "Roo Code 已于 2026 年 5 月停止维护。本文给出现有安装和分支版本的配置方法，以及接下来该迁移到哪里（Cline 或 Zoo Code 分支），并接入 BroadNet Inference。"
url: https://broadrouter.com/zh/guides/roo-code-openai-compatible/
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/roo-code-openai-compatible/) (2026-11-16 更新).

# 在 Roo Code 中使用 BroadNet Inference（OpenAI Compatible）

更新于 2026-11-16

Roo Code 已于 2026 年 5 月 15 日关停，新配置请改用 Cline 或社区分支 Zoo Code。现有安装中，把 API Provider 设为 OpenAI Compatible，Base URL 设为 https://inference.broadnet.ai/v1，API Key 填 BroadNet 密钥，Model 填 broadnet/glm-5.3。Roo Code 需要原生工具调用，请选支持工具的模型。

> **Roo Code 已于 2026 年 5 月 15 日关停。** 它的[代码仓库](https://github.com/RooCodeInc/Roo-Code)已归档，只读。如果需要仍在维护的智能体，请使用[在 Cline 中接入 BroadNet Inference](https://broadrouter.com/zh/guides/cline-openai-compatible/)，或者社区分支 [Zoo Code](https://github.com/Zoo-Code-Org/Zoo-Code)，它延续了 Roo Code 的代码库。下面的步骤对现有的 Roo Code 安装仍然适用。另见 [Cline、Roo Code 与 Aider 对比](https://broadrouter.com/zh/blog/cline-vs-roo-code-vs-aider/)。

Roo Code 是一个 VS Code 里的编程智能体。它的 **OpenAI Compatible** 提供商可以连接任何使用 OpenAI chat completions 格式的端点，包括位于 `https://inference.broadnet.ai/v1` 的 BroadNet Inference。有一条规则决定了配置方式：根据 [Roo Code 的文档](https://roocodeinc.github.io/Roo-Code/providers/openai-compatible)，它**只使用原生工具调用**，没有 XML 回退方案。你选的模型必须支持 OpenAI 风格的工具调用。

## 配置步骤

1.  **获取 BroadNet 密钥。** 按量付费密钥可用于所有对话模型。参见 [API 密钥与 IP 白名单](https://broadrouter.com/zh/guides/api-keys-ip-allow-lists/)。
    
2.  **打开 Roo Code 设置。** 点击 Roo Code 面板里的设置图标。
    
3.  **把 API Provider 设为** **OpenAI Compatible**。
    
4.  **填写连接信息。**
    
    | 字段 | 值 |
    | --- | --- |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API Key | 你的 BroadNet 密钥 |
    | Model | `broadnet/glm-5.3` |
    
5.  **调整 Model Configuration。** 把 **Context Window** 设为下表中该模型的上下文大小。**Max Output Tokens** 要给思考留出空间；可以从几千开始。只有 Qwen3.8 27B 或 DeepSeek V4.1 Flash 才打开 **Image Support**。如果想让 Roo 估算的费用与账单一致，可以从[价格页面](https://broadrouter.com/zh/pricing/)填入 **Input Price** 和 **Output Price**。
    
6.  **运行一个测试任务**，例如 “list the files in this folder and summarize the README”（列出这个文件夹里的文件并总结 README）。Roo Code 会调用它的文件工具。这些调用能成功，就说明工具调用正常。
    

## 选哪个模型

| 模型 | ID | 上下文 | BroadNet 是否列出工具支持 |
| --- | --- | --- | --- |
| GLM 5.3 | `broadnet/glm-5.3` | 1,048,576 | 是 |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | 262,144 | 是，另支持图片输入 |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | 1,048,576 | 未列出；支持图片输入 |

先从 [GLM 5.3](https://broadrouter.com/zh/models/glm-5.3/) 开始。它有 1M token 上下文，BroadNet 为它列出了工具和结构化输出。如果你想粘贴截图或处理阿拉伯语，用 [Qwen3.8 27B](https://broadrouter.com/zh/models/qwen3.8-27b/)。

DeepSeek V4.1 Flash 是不限量套餐所用的模型。Roo Code 需要原生工具调用，而 BroadNet 的文档没有为它列出工具，所以在依赖它之前先测试一下。一小时 Meteor 的价格是 $1，足够跑一个真实任务。BroadNet Gemma 4 VL 26B 也没有列出工具支持，因此不太适合 Roo Code。

## 故障排查

-   **401。** 密钥缺失、无效或已过期，或者按量付费额度已用完。重新输入密钥并检查余额。
-   **第一个请求就因模型错误而失败。** **Model** 的值必须与 BroadNet 的 ID 完全一致，包括 `broadnet/` 前缀。GLM 5.3、Qwen3.8 27B 和 DeepSeek V4.1 Flash 需要先充值；$5 初始额度可用于 Gemma 4 VL 26B 和两个 Transcribe 模型。
-   **工具调用错误。** 换成列出了工具支持的模型。Roo 的文档指出，提供商一侧只部分支持工具时会导致这类错误。
-   **回答为空。** 思考内容计入输出上限。调高 **Max Output Tokens**。[为什么回答会是空的](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)。
-   **429。** 按量付费密钥每分钟允许 30 个请求，同时最多 4 个。Roo 的子任务和另一个 VS Code 窗口会共用这个限制。参见[错误码与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。
-   **在套餐上并行运行任务。** 一个[套餐会话](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)同一时间只处理一个请求。如果你让编排器和子任务并行运行，每个都需要自己的会话，否则它们会排队。

## 本指南涉及的术语

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

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

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

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

[上下文窗口（context window）](https://broadrouter.com/zh/glossary/context-window/)

上下文窗口是语言模型在单次请求中能处理的最大 token 数。它涵盖提示词、对话历史、工具定义、图片以及生成的输出（包括思考 token）。放不下的内容必须删减、摘要，或拆分到多个请求中。

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

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

[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，就能让同一份代码改用另一家服务商。

[并发（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 计费。这类套餐通常会限制别的东西，如并发、速度、模型或使用时间窗口，所以限制条件和价格同样重要。

## 常见问题

### Roo Code 还在维护吗？

没有。它的 GitHub 仓库已于 2026 年 5 月 15 日归档，README 说明该扩展已关停，并引导用户转向社区分支 Zoo Code（公告中写作 ZooCode）和 Cline。现有安装按下面的设置仍然能用，但不会再得到修复。

### Roo Code 为什么报工具调用错误？

Roo Code 只使用原生工具调用，没有 XML 回退方案。请使用 BroadNet 列出了工具支持的模型，例如 broadnet/glm-5.3 或 broadnet/qwen3.8-27b。

### Roo Code 为什么收到空回复？

模型把输出预算用在了思考上。GLM 5.3、Qwen3.8 27B 和 DeepSeek V4.1 Flash 会先思考，而思考内容计入 max\_tokens。请在 Model Configuration 里调高 Max Output Tokens。

### 可以在 Roo Code 上用 DeepSeek 不限量套餐吗？

不限量套餐覆盖 DeepSeek V4.1 Flash。BroadNet 的文档没有为它列出工具调用，而 Roo Code 必须用到工具调用，所以买一个月之前，先用一小时 Meteor 测试一下。

## 相关指南

-   [在 Cline 中使用 BroadNet Inference（OpenAI Compatible 提供商）](https://broadrouter.com/zh/guides/cline-openai-compatible/)
-   [推理模型为什么返回空回答](https://broadrouter.com/zh/guides/reasoning-tokens-empty-response/)
-   [面向智能体的不限量 LLM API 套餐如何运作](https://broadrouter.com/zh/guides/unlimited-llm-api-sessions/)
-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/)
-   [所有可与 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-roo-code-openai-compatible&utm_content=page-cta) ·

**来源**

-   [Roo Code GitHub 仓库（2026 年 5 月 15 日归档，含关停公告；核对于 2026-11-14）](https://github.com/RooCodeInc/Roo-Code)
-   [Zoo Code GitHub 仓库，延续 Roo Code 的社区分支（核对于 2026-11-16）](https://github.com/Zoo-Code-Org/Zoo-Code)
-   [Roo Code 文档：OpenAI Compatible 提供商（核对于 2026-11-14）](https://roocodeinc.github.io/Roo-Code/providers/openai-compatible)
-   [BroadNet Inference API 参考文档 （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-guides-roo-code-openai-compatible&utm_content=sources)
