Zoo Code + JoinGonka Gateway: chuyển từ Roo Code sang các mô hình Gonka

Bước 1: cài tiện ích mở rộng. Trong VS Code, mở bảng tiện ích mở rộng (Ctrl+Shift+X, trên macOS là Cmd+Shift+X), tìm «Zoo Code» và cài đặt tiện ích của nhà phát hành Zoo Code Organization. Hoặc chỉ với một lệnh:

code --install-extension ZooCodeOrganization.zoo-code

Bạn cần VS Code 1.100 trở lên — theo manifest của tiện ích; với VSCodium, Windsurf và các trình soạn thảo khác không có Marketplace, tiện ích được phát hành trên Open VSX. Ngoài kênh ổn định (3.82.2 ngày 18 tháng 9 năm 2026) còn có bản xem trước 3.83.x — bản dựng ban đêm của nhánh chính; để làm việc hãy dùng bản ổn định. Sau khi cài đặt, biểu tượng Zoo Code sẽ xuất hiện trên thanh hoạt động.

Bước 2: lấy khóa. Đăng ký tại gate.joingonka.ai/register, xác nhận địa chỉ và tạo khóa có tiền tố jg- trong mục «API Keys». Nên tạo riêng một khóa cho Zoo Code: chi phí của nó sẽ hiển thị riêng một dòng trong thống kê.

Bước 3: chạy trình cài đặt.

npx @joingonka/setup --tool zoo --model deepseek

Trình cài đặt sẽ hỏi khóa — khóa không được truyền qua đối số dòng lệnh để tránh lưu lại trong lịch sử shell. Nó không ghi gì cả: Zoo Code lưu hồ sơ nhà cung cấp cùng khóa trong kho bí mật bảo mật của VS Code, chứ không phải trong tệp. Vì vậy trình cài đặt in ra các giá trị sẵn sàng cho biểu mẫu và giới hạn thực tế của mô hình đã chọn:

Zoo Code is configured in the VS Code extension UI (no file is written).
Open the Zoo Code settings (gear icon) → API Provider, then enter:

  API Provider: OpenAI Compatible
  Base URL:     https://gate.joingonka.ai/v1
  API Key:      jg-your-key
  Model:        deepseek-ai/DeepSeek-V4-Flash-0731

Then set the real limits of this model under Model Configuration
(the defaults do not fit any Gonka model):

  Context Window Size: 380000
  Max Output Tokens:   32768
  Image Support:       off

Zoo Code relies on native tool calling only — all our Gonka models support it.

Tiếp theo là kết quả của yêu cầu trực tiếp đến gateway — nếu thành công, dòng ✓ Verified: the gateway accepted the key, base URL and model. Khóa, địa chỉ và mô hình được xác minh ngay lập tức, chứ không phải ở tác vụ đầu tiên. Khóa trong khối được in hiển thị đầy đủ để dễ sao chép — đừng công bố kết quả này.

Nếu không có cờ --model, trình cài đặt sẽ dùng MiniMax M2.7: ở nơi người dùng tự chọn mô hình, nó đề xuất mô hình có dung lượng lớn nhất trong mạng. Với Zoo Code, chúng tôi khuyên bắt đầu với DeepSeek V4 Flash: trong kiểm tra của chúng tôi, nó hoàn thành lượt sau kết quả công cụ chỉ với một yêu cầu — chi tiết trong phần kiểm tra; cờ cũng chấp nhận các viết tắt glm (GLM-5.3 Flash) và minimax. Nếu không có cờ --tool, trình cài đặt sẽ hiện menu gồm 25 công cụ.

Một chi tiết về biểu mẫu: không có khối riêng với tiêu đề Model Configuration trong Zoo Code 3.82.2. Các trường giới hạn nằm cùng biểu mẫu ở phía dưới, dưới phần giải thích «Configure the capabilities and pricing for your custom OpenAI-compatible model», và Max Output Tokens đứng trước Context Window Size.

Khi khởi chạy lần đầu, Zoo Code hiển thị lời chào với nút Choose your provider: nút này dẫn đến một biểu mẫu, trong đó OpenRouter được chọn sẵn — hãy đổi nhà cung cấp sang OpenAI Compatible và nhấn Finish ở cuối. Sau đó, biểu mẫu này có thể được mở bằng biểu tượng bánh răng trong tiêu đề bảng điều khiển Zoo Code, mục Providers; các thay đổi được lưu bằng nút Save.

Giới hạn các mô hình của mạng lưới:

Các phần còn lại không cần thay đổi: giữ Enable streaming và Include max output tokens được bật, Enable R1 model parameters và Use Azure được tắt (đây là các thiết lập cho dòng mô hình R1 và Azure OpenAI), để trống các trường Custom Headers và Extra Body.

Các giới hạn được lưu trong hồ sơ (profile) chứ không lưu theo mô hình: nếu bạn thay đổi Model trong cùng một hồ sơ, cửa sổ ngữ cảnh và giới hạn phản hồi vẫn giữ nguyên. Do đó, nên tạo một hồ sơ riêng cho mỗi mô hình — phần tiếp theo sẽ hướng dẫn về điều này.

Zoo Code được phát triển từ cơ sở mã nguồn của Roo Code, vì vậy việc chuyển đổi chỉ mất vài phút và bạn không cần phải thay đổi các tệp dự án. Hướng dẫn di chuyển chính thức mô tả cách xuất và nhập cài đặt; các thành phần còn lại được chuyển bằng một nút riêng biệt hoặc được đọc từ các đường dẫn cũ:

Hồ sơ Roo Code đã kết nối với JoinGonka Gateway sẽ được chuyển cùng với địa chỉ, khóa, mô hình và giới hạn - chỉ cần kiểm tra xem mô hình đó có khả dụng trên mạng hay không: danh sách trả về qua GET https://gate.joingonka.ai/v1/models.

Chế độ và hồ sơ. Có năm chế độ tích hợp: Code, Debug, Architect (chỉ chỉnh sửa tệp Markdown), Ask (trả lời mà không chỉnh sửa) và Orchestrator (phân chia tác vụ phụ cho các chế độ khác). Bạn có thể chuyển đổi chúng bằng danh sách tại trường nhập liệu, bằng lệnh với tên chế độ ở đầu tin nhắn (ví dụ /architect), hoặc bằng tổ hợp phím Ctrl+. (Cmd+. trên macOS). Mỗi chế độ ghi nhớ hồ sơ mà bạn đã làm việc gần nhất, và khi đổi chế độ, Zoo Code sẽ tự động chuyển hồ sơ tương ứng.

Từ đây, ta có một mô hình tiện lợi: một hồ sơ cho mỗi mô hình, được gắn với các chế độ. Trong Settings → Providers, nhấn nút "+" bên cạnh trường Configuration Profile, đặt tên hồ sơ, ví dụ Gonka DeepSeek, và điền vào biểu mẫu; lặp lại cho GLM-5.3 Flash và MiniMax M2.7 - địa chỉ và khóa của tất cả đều giống nhau. Sau đó, trong mỗi chế độ, hãy chọn hồ sơ trong danh sách hồ sơ tại trường nhập liệu và chế độ đó sẽ ghi nhớ nó. Biểu tượng khóa trong danh sách này dùng để cố định một hồ sơ cho tất cả các chế độ trong thư mục làm việc.

Cấp độ suy luận. Tùy chọn Enable Reasoning Effort trong biểu mẫu mở ra danh sách Low, Medium, High, Extra High và Max; khi nó bị tắt, cấp độ sẽ không được gửi vào yêu cầu. Đối với GLM-5.3 Flash, công tắc này về cơ bản là nhị phân: Low tắt suy luận, bất kỳ cấp độ nào khác đều giữ nguyên toàn bộ - thuận tiện để giữ một hồ sơ GLM riêng với Low cho các câu hỏi nhanh. Chi tiết xem tại đánh giá GLM-5.3 Flash. Đối với DeepSeek V4 Flash và MiniMax M2.7, cổng không ghi đè thang đo: cách cấp độ hoạt động phụ thuộc vào chính mô hình đó.

Hãy mở một thư mục chứa tệp nhỏ có lỗi rõ ràng, ví dụ: calc.py với hàm cộng thực hiện phép trừ, sau đó ở chế độ Code, hãy viết: "Đọc calc.py và cho biết bằng một câu liệu nó có lỗi hay không". Zoo Code sẽ yêu cầu quyền đọc tệp — "Zoo wants to read this file", kèm các nút Approve và Deny, nếu quyền đọc chưa được cấp trước đó trong Auto-Approve. Sau đó, mô hình sẽ gọi công cụ hoàn thành và tác vụ sẽ kết thúc bằng khối Task Completed cùng câu trả lời cụ thể; các lập luận, nếu có, sẽ được hiển thị trong khối Thinking riêng biệt. Tỷ lệ phần trăm sử dụng ngữ cảnh trong tiêu đề tác vụ được thu gọn được tính dựa trên Context Window Size — đây là một lý do khác để thiết lập nó một cách chính xác.

Chúng tôi đã tái hiện quy trình này bằng cách gửi truy vấn theo mẫu Zoo Code — luồng, các công cụ trong lược đồ nghiêm ngặt, với kết quả của read_file trong lịch sử. DeepSeek V4 Flash đã phản hồi bằng cách gọi attempt_completion gốc với kết luận chính xác: hàm thực hiện phép trừ thay vì phép cộng. Phần thứ hai của quá trình kiểm tra là bảng điều khiển gateway: trong phần "Sử dụng", truy vấn sẽ xuất hiện theo từng mô hình và thời gian truy cập cuối cùng của khóa sẽ được cập nhật.

Nếu không có Auto-Approve, lỗi sẽ xuất hiện dưới dạng khối API Request Failed kèm các nút Retry và Start New Task, cùng với tiêu đề Provider Error kèm mã lỗi và đếm ngược để thử lại. Văn bản phản hồi của gateway có thể thấy trong tin nhắn hoặc chi tiết của tin nhắn đó:

Tác nhân (agent) tiêu tốn token khác với trò chuyện thông thường. Trong mỗi yêu cầu, Zoo Code đặt vào một hệ thống gợi ý (system prompt) với các quy tắc chế độ, mô tả công cụ và thông tin về thư mục làm việc — đây là hàng nghìn token ngay cả trước câu hỏi của bạn — và một tác vụ thường mất vài bước đi. Do đó, giá mỗi token ở đây rất quan trọng.

Thông qua JoinGonka Gateway, token có giá $0.0069 cho một triệu token đầu vào và $0.021 cho một triệu token đầu ra — giá cả đồng nhất cho tất cả các mô hình trong mạng và được cập nhật trên trang này từ nguồn trực tuyến. Thứ tự giá trị theo mức giá tháng 9 năm 2026:

Để so sánh — cách bạn có thể thanh toán cho các mô hình trong Zoo Code:

Với các thông số Input Price và Output Price đã được điền, chi phí tác vụ sẽ hiển thị trong tiêu đề của nó, nhưng với độ chính xác đến từng xu — các tác vụ ngắn trên các mô hình mạng sẽ hiển thị là $0.00. Chi phí chính xác và số dư còn lại nằm trong bảng điều khiển, tại các mục «Sử dụng» (Usage) và «Thanh toán» (Billing).

Xác nhận và tính tự chủ. Theo mặc định, Auto-Approve bị tắt và Zoo Code sẽ yêu cầu cấp quyền đọc, ghi và thực thi lệnh; đối với các tác vụ dài, hãy bật các danh mục cần thiết trong menu Auto-approve tại trường nhập liệu. Đối với các lệnh, có Destructive Command Guard (Settings → Auto-Approve): tiện ích mở rộng tải xuống tệp thực thi của nó và sau đó các lệnh đã được thông qua sẽ tự động chạy, trong khi các lệnh bị chặn sẽ chờ xác nhận. Với Auto-Approve, Zoo Code cũng tự động thử lại các yêu cầu thất bại: khoảng tạm dừng bắt đầu từ 5 giây và tăng gấp đôi sau mỗi lần thử, nhưng không quá 10 phút.

Phản hồi theo luồng (Streaming). Đừng tắt Enable streaming: ở chế độ này, gateway sẽ gửi văn bản ngay khi được tạo và giới hạn phản hồi chỉ bằng mức trần của mô hình, trong khi yêu cầu không có luồng và không có giới hạn rõ ràng sẽ bị cắt ở mức 1500 token phản hồi (đối với GLM-5.3 Flash là 3000).

Chỉ mục mã nguồn. Tìm kiếm ngữ nghĩa trong dự án (Codebase Indexing) được cấu hình riêng biệt với mô hình, thông qua nhà cung cấp embedding; đối với tác vụ này, có một tùy chọn cục bộ là Semble - Local.

Hình ảnh. Các mô hình mạng là mô hình văn bản. Đối với ảnh chụp màn hình và bản thiết kế, hãy tạo một hồ sơ riêng với mô hình có khả năng xử lý hình ảnh và chuyển sang hồ sơ đó khi cần thực hiện tác vụ như vậy.

Quyền riêng tư. Zoo Code gửi dữ liệu lỗi và dữ liệu sử dụng cho các nhà phát triển, được liên kết với ID cài đặt — không bao gồm mã nguồn và prompt; tính năng này có thể bị tắt bằng công tắc Allow error and usage reporting trong Settings → About Zoo Code. Về phía gateway, hệ thống không lưu trữ nội dung của prompt và phản hồi: trong bảng điều khiển chỉ hiển thị số lượng yêu cầu và token.