Roo Code là gì?
Roo Code là một tác nhân mã hóa VS Code mã nguồn mở có thể sử dụng các nhà cung cấp OpenAI-compatible, chỉnh sửa tệp và chạy các công cụ đã được phê duyệt.
Hướng dẫn Roo Code này bổ sung TokenHub thông qua cài đặt nhà cung cấp OpenAI Compatible. Trước tiên, hãy kiểm tra tác vụ chỉ đọc, sau đó xác thực native tool calling trước khi bật chỉnh sửa tệp hoặc lệnh đầu cuối. Roo Code có thể đọc tệp, đề xuất chỉnh sửa và chạy các công cụ đầu cuối từ VS Code, do đó, khả năng kết nối của nhà cung cấp và khả năng của tác nhân phải được kiểm tra riêng. Tắt tính năng phê duyệt tự động trong lần chạy đầu tiên, sử dụng kho lưu trữ dùng một lần và xem xét từng hành động được yêu cầu cho đến khi mô hình đã chọn chứng tỏ được độ tin cậy với các lệnh gọi công cụ gốc.
Roo Code có thể định tuyến yêu cầu mô hình qua cổng API OpenAI compatible tương thích của TokenHub. Giữ nguyên cách cài đặt chính thức, sau đó thay API key, Base URL và model ID.
Endpoint TokenHub dùng trong hướng dẫn này là https://us-api.tokenhub.com/v1/chat/completions.
Khi nào nên dùng
Bắt đầu với repository nhỏ hoặc dự án thử nghiệm. Trước tiên yêu cầu công cụ đọc file, giải thích mã hoặc lập kế hoạch, rồi mới bật chỉnh sửa.
Cài đặt hoặc mở công cụ
Làm theo tài liệu chính thức của Roo Code để cài đặt hoặc mở công cụ. Nếu giao diện thay đổi, ưu tiên tài liệu hiện tại.
Với công cụ CLI, hãy kiểm tra executable trước khi thêm thông tin xác thực TokenHub:
# open the tool, then open its model or provider settingsChuẩn bị thông tin xác thực TokenHub
Tạo TokenHub API key và chọn một mô hình phù hợp từ danh sách mô hình TokenHub.
export TOKENHUB_API_KEY="sk-..."Lưu key trong shell cục bộ, kho bí mật của IDE hoặc trường API key an toàn của công cụ. Không commit key vào repository.
Cấu hình nhà cung cấp TokenHub
Trong phần Models, Providers, API Keys hoặc OpenAI Compatible, nhập các giá trị dưới đây.
Giá trị provider
| Trường | Giá trị |
|---|---|
| Nhà cung cấp | OpenAI Compatible hoặc Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | Giá trị của TOKENHUB_API_KEY |
| Mô hình | gpt-4.1 hoặc model ID TokenHub khác |
Vị trí file cài đặt
| Trường | Giá trị |
|---|---|
| Provider settings | Roo Code provider settings or configuration profile |
| Provider mode | OpenAI Compatible |
| Required fields | Base URL, API Key, Model ID |
Khi extension sở hữu schema riêng, hãy dùng UI cài đặt trước. UI sẽ lưu cùng giá trị vào user settings và tránh phải đoán private key có thể đổi theo phiên bản.
Use a model that supports OpenAI tool calling for Code mode tasks.
Nếu công cụ tách chat, edit, apply và fast models, hãy dùng cùng một mô hình TokenHub cho lần thử đầu tiên. Sau đó mới tách theo chi phí, độ trễ và năng lực suy luận.
Biến môi trường tạm thời chỉ để debug
Khi extension sở hữu schema riêng, hãy dùng UI cài đặt trước. UI sẽ lưu cùng giá trị vào user settings và tránh phải đoán private key có thể đổi theo phiên bản.
Chỉ dùng biến tạm thời để kiểm tra key, mạng và tên mô hình. Sau khi xác minh, chuyển cùng giá trị vào cấu hình bền vững ở trên.
Xác minh kết nối
Trước tiên dùng prompt chỉ đọc để xác nhận mô hình đọc được ngữ cảnh và không sửa file. Sau đó mới thử chỉnh sửa hoặc tác vụ agent.
Đọc README của dự án và tóm tắt trong ba câu. Không chỉnh sửa file.Sau khi prompt chạy thành công, kiểm tra log TokenHub để xác nhận tên mô hình, endpoint, lượng token và billing group.
Khắc phục sự cố
| Hiện tượng | Cách xử lý |
|---|---|
| 401 hoặc lỗi xác thực | Kiểm tra TOKENHUB_API_KEY còn hợp lệ và đã lưu trong cùng terminal, IDE hoặc profile client. |
| 404 hoặc không tìm thấy mô hình | Dùng model ID có trong workspace TokenHub và phù hợp với giao thức đã chọn. |
| Sai endpoint | Giữ Base URL đúng như phần trên. Công cụ tương thích OpenAI thường cần /v1; công cụ tương thích Claude thường không cần. |
| Request timeout | Kiểm tra đường mạng tới https://us-api.tokenhub.com, proxy settings và allowlist của workspace. |
| Công cụ dùng mô hình khác | Kiểm tra lại mọi trường chat, edit, apply, fast hoặc autocomplete. |
Chọn mô hình
Roo Code API nhà cung cấp FAQ
Tôi nên chọn API Provider nào trong Roo Code?
Chọn OpenAI Compatible, sau đó nhập TokenHub Base URL, khóa API và ID mẫu chính xác.
Điều gì sẽ xảy ra nếu tính năng trò chuyện hoạt động nhưng lệnh gọi công cụ không thành công?
Trước tiên, hãy chuyển sang mô hình Mã hóa hoặc Agent hỗ trợ rõ ràng native tool calling, sau đó kiểm tra các quyền và chế độ phê duyệt Roo Code.
Làm cách nào tôi có thể giảm rủi ro trong lần thử nghiệm Roo Code đầu tiên?
Sử dụng kho lưu trữ thử nghiệm, bắt đầu bằng phần giải thích chỉ đọc, tắt tự động phê duyệt, sau đó dần dần xác minh các chỉnh sửa và lệnh đầu cuối.
Làm cách nào để khắc phục sự cố Roo Code 401?
Kiểm tra khóa API xem có ký tự hoặc dấu cách bị thiếu không và xác nhận nó được lưu trong cấu hình hoạt động. Thử lại một yêu cầu ngắn và kiểm tra nhật ký TokenHub.
Làm cách nào để khắc phục sự cố Roo Code 404?
Sử dụng gốc TokenHub API kết thúc bằng /v1, tránh đường dẫn /chat/completions trùng lặp và xác nhận rằng ID mẫu tồn tại.
Tài liệu tham khảo
Cấu hình này dựa trên TokenHub và tài liệu chính thức; lần xác minh gần nhất: 2026-09-04。
