---
title: "Roo Code sau khi ngừng hoạt động: cài đặt OpenAI Compatible"
description: "Roo Code đã ngừng hoạt động vào tháng 5/2026. Cấu hình cho bản cài sẵn và các fork, cùng lựa chọn thay thế (Cline hoặc fork Zoo Code) với BroadNet Inference."
url: https://broadrouter.com/vi/guides/roo-code-openai-compatible/
lang: vi
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Được dịch từ tiếng Anh với sự hỗ trợ của AI. [Đọc bản gốc tiếng Anh](https://broadrouter.com/guides/roo-code-openai-compatible/) (cập nhật ngày 2026-11-16).

# Dùng Roo Code với BroadNet Inference (OpenAI Compatible)

Cập nhật 2026-11-16

Roo Code đã ngừng hoạt động ngày 15/5/2026, nên thiết lập mới nên dùng Cline hoặc fork cộng đồng Zoo Code. Với bản đã cài, hãy chọn API Provider là OpenAI Compatible, Base URL là https://inference.broadnet.ai/v1, API Key là key BroadNet và Model là broadnet/glm-5.3. Roo Code cần gọi tool native, nên hãy chọn model có hỗ trợ tool.

> **Roo Code đã ngừng hoạt động ngày 15/5/2026.** [Kho mã](https://github.com/RooCodeInc/Roo-Code) đã được lưu trữ và chỉ còn đọc. Nếu cần một agent còn được bảo trì, hãy dùng [Cline với BroadNet Inference](https://broadrouter.com/vi/guides/cline-openai-compatible/), hoặc fork cộng đồng [Zoo Code](https://github.com/Zoo-Code-Org/Zoo-Code), vốn tiếp tục codebase của Roo Code. Các bước bên dưới vẫn áp dụng cho bản Roo Code đã cài. Xem thêm [Cline vs Roo Code vs Aider](https://broadrouter.com/vi/blog/cline-vs-roo-code-vs-aider/).

Roo Code là một coding agent cho VS Code. Provider **OpenAI Compatible** của nó làm việc với mọi endpoint dùng định dạng chat completions của OpenAI, kể cả BroadNet Inference tại `https://inference.broadnet.ai/v1`. Có một quy tắc quyết định cách thiết lập: theo [tài liệu Roo Code](https://roocodeinc.github.io/Roo-Code/providers/openai-compatible), nó **chỉ dùng gọi tool native**, không có phương án dự phòng bằng XML. Model bạn chọn phải hỗ trợ gọi tool kiểu OpenAI.

## Thiết lập

1.  **Lấy key BroadNet.** Key trả theo mức dùng dùng được với mọi model chat. Xem [API key và danh sách IP cho phép](https://broadrouter.com/vi/guides/api-keys-ip-allow-lists/).
    
2.  **Mở cài đặt Roo Code** bằng biểu tượng cài đặt trong bảng Roo Code.
    
3.  **Đặt API Provider** là **OpenAI Compatible**.
    
4.  **Nhập thông tin kết nối.**
    
    | Trường | Giá trị |
    | --- | --- |
    | Base URL | `https://inference.broadnet.ai/v1` |
    | API Key | key BroadNet của bạn |
    | Model | `broadnet/glm-5.3` |
    
5.  **Chỉnh Model Configuration.** Đặt **Context Window** bằng context của model trong bảng dưới. Đặt **Max Output Tokens** có chừa chỗ cho suy luận; hãy bắt đầu với vài nghìn. Chỉ bật **Image Support** cho Qwen3.8 27B hoặc DeepSeek V4.1 Flash. Nhập **Input Price** và **Output Price** từ [trang giá](https://broadrouter.com/vi/pricing/) nếu bạn muốn chi phí ước tính của Roo khớp với hóa đơn.
    
6.  **Chạy một task thử**, ví dụ “list the files in this folder and summarize the README”. Roo Code sẽ gọi các tool làm việc với file. Nếu các lần gọi đó chạy được, gọi tool đã hoạt động.
    

## Chọn model nào

| Model | ID | Context | BroadNet liệt kê tool |
| --- | --- | --- | --- |
| GLM 5.3 | `broadnet/glm-5.3` | 1.048.576 | Có |
| Qwen3.8 27B | `broadnet/qwen3.8-27b` | 262.144 | Có, kèm đầu vào hình ảnh |
| DeepSeek V4.1 Flash | `broadnet/deepseek-v4.1-flash` | 1.048.576 | Không được liệt kê; nhận ảnh |

Hãy bắt đầu với [GLM 5.3](https://broadrouter.com/vi/models/glm-5.3/). Model này có context 1 triệu token và được BroadNet liệt kê hỗ trợ tool và đầu ra có cấu trúc. Dùng [Qwen3.8 27B](https://broadrouter.com/vi/models/qwen3.8-27b/) khi bạn muốn dán ảnh chụp màn hình hoặc làm việc bằng tiếng Ả Rập.

DeepSeek V4.1 Flash là model của các gói không giới hạn. Vì Roo Code cần gọi tool native mà tài liệu BroadNet không liệt kê tool cho model này, hãy thử trước khi dựa vào nó. Một giờ Meteor giá $1 và đủ cho một task thật. BroadNet Gemma 4 VL 26B cũng không được liệt kê có tool, nên không hợp với Roo Code.

## Xử lý sự cố

-   **401.** Key bị thiếu, sai hoặc đã hết hạn, hoặc hạn mức trả theo mức dùng đã hết. Nhập lại key và kiểm tra số dư.
-   **Request đầu tiên thất bại với lỗi model.** Giá trị **Model** phải khớp chính xác với một ID BroadNet, kể cả tiền tố `broadnet/`. GLM 5.3, Qwen3.8 27B và DeepSeek V4.1 Flash cần nạp tiền; tín dụng ban đầu $5 dùng được cho Gemma 4 VL 26B và hai model Transcribe.
-   **Lỗi gọi tool.** Hãy chuyển sang một model được liệt kê có tool. Tài liệu Roo lưu ý rằng hỗ trợ tool không đầy đủ ở phía provider gây ra các lỗi này.
-   **Câu trả lời rỗng.** Suy luận được tính vào giới hạn đầu ra. Hãy tăng **Max Output Tokens**. [Vì sao câu trả lời trả về rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/).
-   **429.** Key trả theo mức dùng cho phép 30 request mỗi phút và 4 request cùng lúc. Các subtask của Roo và một cửa sổ VS Code thứ hai dùng chung giới hạn đó. Xem [lỗi và thử lại](https://broadrouter.com/vi/guides/errors-and-retries/).
-   **Task song song trên một gói.** Một [phiên của gói](https://broadrouter.com/vi/guides/unlimited-llm-api-sessions/) chạy một request tại một thời điểm. Nếu bạn chạy orchestrator và các subtask song song, mỗi cái cần một phiên riêng, nếu không chúng sẽ xếp hàng chờ.

## Thuật ngữ trong hướng dẫn này

[Token](https://broadrouter.com/vi/glossary/token/)

Token là đơn vị văn bản mà model ngôn ngữ đọc và viết: một từ, một phần của từ, một dấu câu hoặc một chuỗi byte do tokenizer của model tạo ra. API LLM đếm, giới hạn và thường tính phí theo token.

[Tool calling (gọi tool, function calling)](https://broadrouter.com/vi/glossary/tool-calling/)

Tool calling, còn gọi là function calling, là tính năng của API LLM trong đó model trả về một yêu cầu có cấu trúc để chạy một hàm do nhà phát triển định nghĩa, kèm đối số JSON. Ứng dụng chạy hàm rồi gửi kết quả lại; model không bao giờ tự chạy code.

[Trả theo mức dùng (pay-as-you-go)](https://broadrouter.com/vi/glossary/pay-as-you-go/)

Trả theo mức dùng (pay-as-you-go) là mô hình giá mà bạn chỉ trả cho những gì đã dùng, đo theo đơn vị như token, request hoặc phút âm thanh, không có gói đăng ký hay cam kết tối thiểu. Hầu hết API LLM tính phí theo cách này, trừ vào số dư trả trước hoặc qua hóa đơn định kỳ.

[API key (khóa API)](https://broadrouter.com/vi/glossary/api-key/)

API key là một chuỗi bí mật dùng để xác định và cấp quyền cho client gọi API. API LLM thường yêu cầu nó trong header Authorization: Bearer, và bất kỳ ai giữ key đều có thể gửi request được tính phí vào tài khoản sở hữu key đó.

[Giới hạn tần suất (rate limit)](https://broadrouter.com/vi/glossary/rate-limit/)

Giới hạn tần suất (rate limit) là mức trần mà API đặt ra cho lượng sử dụng của một client trong một khoảng thời gian, như số request mỗi phút hoặc số token mỗi phút. Request vượt giới hạn bị từ chối, thường với HTTP 429 Too Many Requests, cho đến khi mức dùng giảm xuống dưới giới hạn.

[Token đầu vào và đầu ra (input and output tokens)](https://broadrouter.com/vi/glossary/input-and-output-tokens/)

Token đầu vào là token mà model ngôn ngữ đọc trong một request, gồm system prompt, lịch sử hội thoại, định nghĩa tool và hình ảnh. Token đầu ra là token nó sinh ra để trả lời, kể cả phần suy luận. API LLM thường tính giá riêng cho hai loại, và đầu ra thường đắt hơn.

[AI coding agent](https://broadrouter.com/vi/glossary/coding-agent/)

AI coding agent là công cụ phần mềm trong đó một model ngôn ngữ làm việc trên codebase theo vòng lặp: đọc file, sửa file, chạy lệnh như test, đọc kết quả và quyết định bước tiếp theo cho tới khi xong task hoặc chạm giới hạn.

[Base URL](https://broadrouter.com/vi/glossary/base-url/)

Base URL là địa chỉ gốc cố định của một API, như https://api.example.com/v1, mà client đặt trước mọi đường dẫn endpoint, như /chat/completions. Trong SDK tương thích OpenAI, đổi base URL cùng với API key và model ID sẽ trỏ cùng một đoạn code sang nhà cung cấp khác.

## Câu hỏi thường gặp

### Roo Code còn được bảo trì không?

Không. Kho GitHub của nó đã được lưu trữ (archived) ngày 15/5/2026 và README cho biết extension đã ngừng hoạt động. Thông báo hướng người dùng sang Zoo Code (trong thông báo viết là ZooCode), một fork của cộng đồng, và sang Cline. Các bản đã cài vẫn chạy với cấu hình bên dưới nhưng không còn nhận bản sửa lỗi.

### Vì sao Roo Code báo lỗi gọi tool?

Roo Code chỉ dùng gọi tool native, không có phương án dự phòng bằng XML. Hãy dùng model mà BroadNet liệt kê có tool, như broadnet/glm-5.3 hoặc broadnet/qwen3.8-27b.

### Vì sao Roo Code nhận phản hồi rỗng?

Model đã dùng hết ngân sách đầu ra cho suy luận. GLM 5.3, Qwen3.8 27B và DeepSeek V4.1 Flash suy luận trước, và phần suy luận được tính vào max\_tokens. Hãy tăng Max Output Tokens trong Model Configuration.

### Có dùng gói DeepSeek không giới hạn với Roo Code được không?

Các gói không giới hạn dùng DeepSeek V4.1 Flash. Tài liệu BroadNet không ghi gọi tool cho model này, mà Roo Code bắt buộc phải gọi tool, nên hãy thử trên một giờ Meteor trước khi mua một tháng.

## Hướng dẫn liên quan

-   [Dùng Cline với BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/vi/guides/cline-openai-compatible/)
-   [Vì sao model suy luận trả về câu trả lời rỗng](https://broadrouter.com/vi/guides/reasoning-tokens-empty-response/)
-   [Gói LLM API không giới hạn cho agent hoạt động thế nào?](https://broadrouter.com/vi/guides/unlimited-llm-api-sessions/)
-   [Mã lỗi BroadNet Inference và khi nào nên thử lại](https://broadrouter.com/vi/guides/errors-and-retries/)
-   [Mọi công cụ dùng được với BroadNet Inference (tiếng Anh)](https://broadrouter.com/integrations/): SDK, agent lập trình, giao diện chat và công cụ tự động hóa, kèm cấu hình chính xác cho từng công cụ

Hãy thử với khối lượng công việc thực tế của bạn. Tài khoản mới được tặng US$5 tín dụng ban đầu cho Gemma và chuyển giọng nói thành văn bản. DeepSeek, GLM và Qwen3.8 cần nạp tiền.

[Bắt đầu](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-roo-code-openai-compatible&utm_content=page-cta) ·

**Nguồn**

-   [Kho GitHub của Roo Code (lưu trữ ngày 15/5/2026, thông báo ngừng hoạt động; kiểm tra ngày 2026-11-14)](https://github.com/RooCodeInc/Roo-Code)
-   [Kho GitHub của Zoo Code, bản fork cộng đồng tiếp nối Roo Code (kiểm tra ngày 2026-11-16)](https://github.com/Zoo-Code-Org/Zoo-Code)
-   [Tài liệu Roo Code, provider OpenAI Compatible (kiểm tra ngày 2026-11-14)](https://roocodeinc.github.io/Roo-Code/providers/openai-compatible)
-   [Tài liệu tham chiếu API BroadNet Inference (tiếng Anh)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=vi-guides-roo-code-openai-compatible&utm_content=sources)
