Claude trong Roo Code. Một thẻ lập kế hoạch trung tâm phân nhánh thành nhiều thẻ tác vụ lập trình nhỏ hơn, mỗi thẻ nằm trên một kệ riêng gọn gàng, thể hiện các tác vụ con được điều phối.

Roo Code không giới hạn với Claude API

Roo Code là tiện ích lập trình mạnh mẽ theo mô hình tác nhân dành cho VS Code, phân chia trách nhiệm thành các chế độ hoạt động riêng biệt — Architect, Code, Debug và Ask — mỗi chế độ có thể được cấu hình với mô hình, temperature và thiết lập nhà cung cấp riêng. Tính năng Orchestrator của nó tạo ra các tác vụ phụ khiến mức tiêu thụ API tăng đáng kể. Kết nối Roo Code với cổng Claude không giới hạn có mức phí cố định cho phép bạn gán Opus cho chế độ Architect, Sonnet cho chế độ Code và không còn lo lắng về chi phí cộng dồn của các quy trình được điều phối.

Cách Roo Code nhân mức tiêu thụ API

Kiến trúc của Roo Code khác căn bản so với các trình soạn thảo AI đơn giản dựa trên trò chuyện. Mỗi chế độ hoạt động (Architect, Code, Debug, Ask) duy trì ngữ cảnh riêng và có thể được gán một mô hình khác nhau. Khi chế độ Orchestrator hoạt động, nó phân rã một tác vụ phức tạp thành các tác vụ phụ rồi giao từng tác vụ cho chế độ phù hợp — thực chất là tạo ra các cuộc hội thoại song song, mỗi cuộc tiêu thụ ngân sách token riêng một cách độc lập.

Một tác vụ do Orchestrator điều phối như 'tái cấu trúc mô-đun xác thực' có thể tạo ra một tác vụ phụ Architect để lập kế hoạch cho cấu trúc mới, ba tác vụ phụ Code để triển khai các thành phần khác nhau và một tác vụ phụ Debug để kiểm tra kết quả. Mỗi tác vụ phụ mang theo prompt hệ thống, định nghĩa công cụ và lịch sử hội thoại riêng. Tổng mức tiêu thụ token không tăng theo phép cộng — mà tăng theo phép nhân vì mỗi tác vụ phụ khởi đầu lại với toàn bộ ngữ cảnh được đưa vào.

Điều này còn gia tăng do Roo Code chỉ sử dụng cơ chế gọi công cụ gốc. Khác với một số tác nhân chuyển sang gọi công cụ dựa trên XML khi lời gọi gốc thất bại, Roo Code yêu cầu API hỗ trợ gọi hàm gốc. Mỗi lần gọi công cụ (đọc tệp, ghi tệp, lệnh terminal) là một cặp lời gọi công cụ và phản hồi có cấu trúc, làm tăng lượng dữ liệu bổ sung trong mỗi tương tác. Sự kết hợp giữa mô hình theo chế độ, tác vụ phụ của Orchestrator và lời gọi công cụ gốc khiến Roo Code trở thành một trong những công cụ tiêu thụ API nhiều nhất trong hệ sinh thái VS Code.

Thiết lập hồ sơ cấu hình API

Roo Code tổ chức các thiết lập nhà cung cấp thành Hồ sơ cấu hình API. Mỗi hồ sơ bao gồm loại nhà cung cấp, URL cơ sở, khóa API, mã định danh mô hình và các tham số tùy chọn như temperature và ngân sách suy nghĩ. Mở bảng cài đặt Roo Code trong VS Code rồi chuyển đến Cấu hình API. Nhấp vào Tạo hồ sơ mới để bắt đầu.

Với cách cấu hình qua nhà cung cấp Anthropic, đặt Nhà cung cấp thành Anthropic, nhập https://unlimited.aiprimetech.io làm URL cơ sở (địa chỉ máy chủ gốc, không có /v1 — Anthropic SDK sẽ nối thêm đường dẫn) và dán khóa AI Prime Tech Unlimited của bạn. Chọn mô hình — claude-sonnet-4-5 cho hồ sơ cân bằng hoặc claude-opus-4-6 để có khả năng suy luận tối đa. Đặt temperature trong khoảng từ 0 đến 1 tùy theo mức độ bạn ưu tiên tính xác định hay tính sáng tạo.

Tạo nhiều hồ sơ cho các tình huống khác nhau: hồ sơ nhanh dùng Haiku cho các câu hỏi nhanh, hồ sơ tiêu chuẩn dùng Sonnet cho công việc lập trình hằng ngày và hồ sơ mạnh dùng Opus cho các quyết định về kiến trúc. Đặt tên rõ ràng cho chúng (ví dụ: 'Unlimited-Sonnet', 'Unlimited-Opus') vì bạn sẽ gán các hồ sơ này cho từng chế độ cụ thể ở bước tiếp theo.

Chiến lược gán mô hình theo chế độ

Tính năng nổi bật nhất của Roo Code đối với người dùng gói không giới hạn là khả năng gán mô hình theo chế độ. Trong phần cài đặt, mỗi chế độ (Architect, Code, Debug, Ask) có một danh sách thả xuống để chọn Hồ sơ cấu hình API mà nó sử dụng. Chiến lược tối ưu với gói không giới hạn là tận dụng tối đa: gán Opus cho các chế độ Architect và Debug, nơi khả năng suy luận sâu quan trọng nhất, và Sonnet cho các chế độ Code và Ask, nơi tốc độ và khối lượng công việc chiếm ưu thế.

Chế độ Architect lập kế hoạch cho các thay đổi phức tạp trước khi thực hiện. Chế độ này được hưởng lợi rất lớn từ khả năng vượt trội của Opus trong việc suy luận về tác động trên toàn hệ thống, chuỗi phụ thuộc và các mẫu kiến trúc. Chế độ Debug cũng được hưởng lợi từ Opus vì việc chẩn đoán lỗi thường đòi hỏi duy trì nhiều giả thuyết cùng lúc và suy luận qua các luồng thực thi.

Chế độ Code xử lý việc chỉnh sửa tệp thực tế và được gọi thường xuyên nhất. Sonnet đủ nhanh để duy trì vòng phản hồi ngắn mà vẫn tạo ra mã chất lượng cao. Chế độ Ask dành cho các câu hỏi nhanh và phần giải thích — Sonnet xử lý những việc này hiệu quả. Với gói không giới hạn, việc dùng Opus ở mọi chế độ không làm tăng chi phí, nhưng chênh lệch độ trễ vẫn quan trọng đối với các quy trình tương tác. Cách phân chia này mang lại cả hai lợi ích: suy luận sâu ở nơi cần thiết và phản hồi nhanh ở nơi tốc độ quan trọng.

Orchestrator và các tác vụ phụ Boomerang

Chế độ Orchestrator (đôi khi được gọi là Boomerang) là cơ chế phân rã tác vụ của Roo Code. Khi bạn mô tả một tác vụ phức tạp trong chế độ Orchestrator, nó chia công việc thành các tác vụ phụ riêng biệt và giao từng tác vụ cho chế độ phù hợp. Kết quả của các tác vụ phụ quay trở lại Orchestrator như 'boomerang'; Orchestrator tổng hợp chúng và quyết định bước tiếp theo.

Mỗi tác vụ phụ chạy trong ngữ cảnh hội thoại riêng với ngân sách token riêng. Điều này có nghĩa là một tác vụ Orchestrator có thể tạo ra năm cuộc hội thoại Claude riêng biệt, mỗi cuộc độc lập tiêu thụ hàng chục nghìn token. Với cách tính phí theo token, một phiên Orchestrator cho tính năng có độ phức tạp trung bình có thể dễ dàng tốn vài đô la. Với gói không giới hạn, chi phí hoàn toàn giống một tin nhắn trò chuyện đơn lẻ — không phát sinh thêm.

Để sử dụng Orchestrator hiệu quả với quyền truy cập không giới hạn, đừng hạn chế nó. Hãy để nó tạo số lượng tác vụ con theo yêu cầu của vấn đề. Bật chế độ tự động — trong đó Orchestrator tự quyết định cách chia nhỏ tác vụ mà không yêu cầu xác nhận ở mỗi bước. Cách này mang lại kết quả tốt hơn vì Orchestrator có thể lặp lại quy trình một cách tự do, lập kế hoạch lại và thực thi lại các tác vụ con khi phát hiện thông tin mới trong quá trình xử lý.

Chế độ tùy chỉnh với .roomodes

Roo Code hỗ trợ các chế độ tùy chỉnh ở cấp dự án, được định nghĩa trong tệp .roomodes tại thư mục gốc của dự án. Mỗi chế độ tùy chỉnh chỉ định tên, mô tả, các phần bổ sung cho lời nhắc hệ thống, công cụ được phép sử dụng và Hồ sơ cấu hình API cần dùng. Điều này cho phép bạn tạo các tác nhân chuyên biệt cho dự án của mình — chẳng hạn chế độ 'Di chuyển cơ sở dữ liệu' chỉ có quyền truy cập các tệp SQL và công cụ di chuyển, hoặc chế độ 'Tài liệu' tập trung vào markdown với lời nhắc được tối ưu cho việc viết.

Tạo tệp .roomodes JSON trong thư mục gốc của dự án. Mỗi mục chế độ bao gồm roleDefinition (lời nhắc hệ thống), allowedTools (mảng tên các công cụ mà chế độ có thể sử dụng) và apiConfiguration (hồ sơ cần dùng). Các chế độ tùy chỉnh xuất hiện cùng với các chế độ tích hợp trong bộ chọn chế độ.

Với gói không giới hạn, các chế độ tùy chỉnh mở ra những cách tổ chức quy trình làm việc sáng tạo. Tạo chế độ 'Nghiên cứu' sử dụng Opus để phân tích sâu các cơ sở mã chưa quen thuộc. Tạo chế độ 'Sửa nhanh' sử dụng Haiku cho những thay đổi đơn giản trên một dòng. Tạo chế độ 'Đánh giá' để đọc mã và đưa ra phản hồi mà không chỉnh sửa. Mô hình giá cố định cho phép bạn tự do thử nghiệm cấu hình chế độ mà không lo chi phí khi cấu hình sai.

Yêu cầu về gọi công cụ gốc

Roo Code chỉ sử dụng cơ chế gọi hàm gốc — nó không chuyển sang cách gọi công cụ dựa trên XML như một số tác nhân khác. Điều này có nghĩa là nhà cung cấp API phải hỗ trợ đúng tham số tools trong Messages API, bao gồm các khối tool_use và tool_result qua nhiều lượt hội thoại. Cổng AI Prime Tech Unlimited hỗ trợ đầy đủ cơ chế này cho tất cả các mô hình Claude.

Nếu gặp lỗi gọi công cụ, nguyên nhân gần như luôn là một trong hai vấn đề: sử dụng phiên bản mô hình cũ có khả năng hỗ trợ gọi công cụ kém hơn, hoặc cấu hình URL cơ sở sai khiến yêu cầu được chuyển đến endpoint không đúng. Hãy xác minh mã định danh mô hình trong hồ sơ của bạn khớp với một mô hình Claude hiện hành và URL cơ sở đúng với loại nhà cung cấp đã chọn.

Bộ công cụ của Roo Code bao gồm thao tác tệp (đọc, ghi, liệt kê), lệnh terminal (thực thi, đọc đầu ra), thao tác trình duyệt (khi được bật) và công cụ MCP (khi được cấu hình). Mỗi lần gọi công cụ bổ sung dữ liệu có cấu trúc vào cuộc hội thoại — thường là 200-500 token cho mỗi lần gọi, bao gồm cả kết quả. Với một tác vụ phức tạp có hàng chục lần gọi công cụ, lượng dữ liệu này tích lũy đáng kể.

Khắc phục sự cố cấu hình Roo Code

Vấn đề phổ biến nhất là chế độ và hồ sơ không khớp: bạn đã tạo hồ sơ nhưng quên gán chúng cho các chế độ. Kiểm tra danh sách thả xuống Cấu hình API của từng chế độ trong phần cài đặt — nếu nó hiển thị 'Mặc định' và bạn chưa đặt hồ sơ mặc định, các yêu cầu sẽ thất bại. Hãy gán rõ một hồ sơ cho từng chế độ bạn định sử dụng.

Nếu các tác vụ con của Orchestrator thất bại trong khi sử dụng trực tiếp chế độ vẫn hoạt động, nguyên nhân thường là các chế độ tác vụ con kế thừa hồ sơ của Orchestrator trừ khi được cấu hình rõ theo cách khác. Hãy đảm bảo mỗi chế độ mà Orchestrator có thể gọi đều được gán một hồ sơ hợp lệ riêng. Một cách thiết lập phổ biến là đặt hồ sơ mặc định thành cấu hình Sonnet của bạn và chỉ ghi đè Architect và Debug bằng Opus.

Lỗi hết thời gian chờ kết nối trong các phiên Orchestrator kéo dài thường cho thấy có quá nhiều tác vụ con chạy đồng thời và chạm giới hạn tốc độ. Cổng đưa các yêu cầu vượt mức vào hàng đợi và trả kết quả khi có thể xử lý, nhưng VS Code có thể coi độ trễ này là hết thời gian chờ. Hãy giảm số tác vụ Orchestrator chạy đồng thời trong phần cài đặt nếu thường xuyên gặp tình trạng này, hoặc chỉ cần chờ — cuối cùng cổng sẽ xử lý tất cả yêu cầu trong giới hạn sử dụng hợp lý.

# Roo Code -> Settings -> API Configuration -> Create New Profile
#
# Profile: Unlimited-Sonnet
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-sonnet-4-5
#
# Profile: Unlimited-Opus
#   Provider:  Anthropic
#   Base URL:  https://aiprimetech.io
#   API Key:   <your AI Prime Tech Unlimited key>
#   Model:     claude-opus-4-6
#
# Mode Assignment:
#   Architect -> Unlimited-Opus
#   Code      -> Unlimited-Sonnet
#   Debug     -> Unlimited-Opus
#   Ask       -> Unlimited-Sonnet

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

Việc gán mô hình theo từng chế độ mang lại lợi ích gì với gói không giới hạn?

Bạn có thể gán các mô hình đắt tiền như Opus cho những chế độ cần suy luận nhiều (Architect, Debug) mà không lo chi phí, đồng thời giữ các mô hình nhanh hơn cho những chế độ dùng thường xuyên (Code, Ask) để giảm độ trễ. Với hình thức tính phí theo token, chiến lược này tốn kém; với gói không giới hạn, bạn có thể tối ưu chất lượng mà không phát sinh thêm chi phí.

Chế độ Orchestrator ảnh hưởng đến mức sử dụng API như thế nào?

Orchestrator chia tác vụ thành các tác vụ con, mỗi tác vụ chạy trong một cuộc hội thoại riêng với ngân sách token riêng. Một tác vụ phức tạp có thể tạo ra 5-10 cuộc hội thoại Claude riêng biệt. Với hình thức tính phí theo token, điều này làm chi phí tăng mạnh; với gói không giới hạn, chi phí đã được bao gồm trong mức giá cố định.

Roo Code có hoạt động với endpoint tương thích OpenAI không?

Có. Tạo một hồ sơ với Nhà cung cấp được đặt thành Tương thích OpenAI, URL cơ sở được đặt thành https://unlimited.aiprimetech.io/v1, và nhập mã định danh mô hình theo cách thủ công. Tuy nhiên, nên sử dụng phương thức kết nối qua nhà cung cấp Anthropic để có khả năng tương thích tốt nhất với việc gọi công cụ.

.roomodes là gì và tôi có nên sử dụng không?

Tệp .roomodes tại thư mục gốc của dự án định nghĩa các chế độ tùy chỉnh với công cụ, lời nhắc và mô hình được gán cụ thể. Với gói không giới hạn, hãy thoải mái sử dụng chúng để tạo các tác nhân chuyên biệt cho những quy trình làm việc khác nhau — nghiên cứu, đánh giá, di chuyển, viết tài liệu — mà không lo chi phí token bổ sung từ các lời nhắc hệ thống phong phú.

Tại sao tôi gặp lỗi gọi công cụ với Roo Code?

Roo Code yêu cầu cơ chế gọi hàm gốc và không có phương án dự phòng bằng XML. Hãy đảm bảo mã định danh mô hình của bạn là một mô hình Claude hiện hành (claude-sonnet-4-5 hoặc mới hơn) và URL cơ sở được cấu hình đúng với loại nhà cung cấp bạn đã chọn. Các phiên bản mô hình cũ có thể hỗ trợ gọi công cụ kém hơn.

Bắt đầu sử dụng Claude chỉ trong vài phút

Lấy khóa API — không cần tài khoản Anthropic hay đăng ký danh sách chờ.

Lấy khóa API của bạn

AI Prime Tech là một cổng API độc lập. AI Prime Tech không liên kết với, không được Anthropic chứng thực và không phải là đại lý bán lại của Anthropic. Claude và các tên mô hình liên quan là nhãn hiệu của chủ sở hữu tương ứng.