Trang chủ / Hướng dẫn / Cline, Roo Code và Kilo Code với API miễn phí

Cline, Roo Code và Kilo Code với API miễn phí

Cline, Roo Code và Kilo Code là các agent lập trình cho VS Code. Mỗi cái có thể dùng một API tương thích OpenAI. Hướng dẫn này kết nối chúng tới các mô hình miễn phí qua FreeLLMAPI. Hướng dẫn cũng cho biết mô hình miễn phí nào xử lý các prompt dài, nhiều công cụ mà các agent này gửi.

Mã, tên mô hình và nhãn danh mục trực tiếp được hiển thị bằng tiếng Anh.

Trước khi bắt đầu

FreeLLMAPI là một gateway mã nguồn mở chạy trên máy tính của bạn. Nó gom các gói miễn phí của 45 nhà cung cấp sau một khóa duy nhất. Cài đặt bằng Docker, rồi thêm ít nhất hai khóa nhà cung cấp miễn phí ở trang Keys.

Cài đặt trên macOS hoặc Linux

curl -fsSL https://freellmapi.co/install.sh | bash

Sao chép khóa thống nhất của bạn từ trang Keys. Cả ba agent dùng cùng các giá trị:

TrườngGiá trị
Base URLhttp://localhost:3001/v1
API key<unified-key>
Model IDauto, hoặc một ID trong danh mục từ GET /v1/models
Trạng thái Roo Code: README của Roo Code nói rằng tiện ích đã ngừng hoạt động vào ngày 15 tháng 5 năm 2026. Kho mã được lưu trữ và chỉ đọc. Các bước dưới đây vẫn áp dụng cho bản cài đặt hiện có, nhưng người dùng mới nên chọn Cline hoặc Kilo Code.

Cline

Cách nhanh nhất là lệnh thiết lập. Lệnh đọc danh mục trực tiếp của bạn, sao lưu cài đặt Cline hiện có và thêm một nhà cung cấp OpenAI Compatible.

Một lệnh

npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key>

Dòng đầu tiên hiển thị phần khác biệt và không ghi gì. Dòng thứ hai ghi thay đổi. Để thiết lập Cline thủ công, thực hiện các bước sau:

  1. Mở bảng Cline trong VS Code. Nhấp vào biểu tượng cài đặt (bánh răng).
  2. Đặt API Provider thành OpenAI Compatible.
  3. Đặt Base URL thành http://localhost:3001/v1.
  4. Đặt API Key thành khóa thống nhất của bạn.
  5. Đặt Model ID thành auto hoặc một mô hình trong bảng dưới đây.
  6. Mở Model Configuration. Đặt Context Window thành ngữ cảnh của mô hình của bạn. Chỉ bật Image Support với mô hình thị giác.

Cline hiển thị ghi chú này cho các nhà cung cấp OpenAI Compatible: "Cline dùng prompt phức tạp, nên hành vi có thể khác nhau giữa các mô hình." Với mô hình nhỏ hơn, tài liệu Cline khuyến nghị Use Compact Prompt trong Cline Settings, Features.

Kilo Code

Chạy lệnh thiết lập. Lệnh ghi một cấu hình Kilo toàn cục với nhà cung cấp openai-compatible và đặt nó làm mô hình mặc định.

Một lệnh

export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-kilo --url http://localhost:3001 --dry-run
npx freellmapi setup-kilo --url http://localhost:3001
kilo run "Say hello"

Cấu hình tham chiếu khóa là {env:FREELLMAPI_API_KEY}, vì vậy hãy export biến này trước khi khởi động Kilo. Kilo chỉ mở rộng {env:...} trong cấu hình đáng tin cậy, ví dụ thư mục toàn cục ~/.config/kilo. Trong cấu hình của dự án, Kilo bỏ qua nó và ghi một cảnh báo. Cấu hình được tạo có dạng sau:

Cấu hình toàn cục của Kilo (dạng)

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "openai-compatible/auto",
  "provider": {
    "openai-compatible": {
      "options": {
        "apiKey": "{env:FREELLMAPI_API_KEY}",
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "tool_call": true,
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

Trong tiện ích VS Code, bạn cũng có thể thêm nhà cung cấp thủ công. Mở Settings, rồi tab Providers, sau đó nhấp Custom provider. Đặt Provider API thành OpenAI Compatible. Nhập base URL và khóa, rồi nhấp Fetch models để đọc danh sách mô hình.

Roo Code (bản cài đặt hiện có)

Lệnh thiết lập ghi một tệp nhập cho tiện ích VS Code. Lệnh cũng ghi một profile cho Roo CLI.

Một lệnh

npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>

Sau đó, yêu cầu Roo Code tải tệp nhập. Thêm dòng này vào settings.json của VS Code và tải lại cửa sổ. Profile freellmapi trở thành profile hiện tại.

settings.json của VS Code

"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"

Để thiết lập thủ công, mở cài đặt Roo Code và đặt API Provider thành OpenAI Compatible. Nhập base URL, khóa và mô hình. Roo Code chỉ dùng gọi công cụ gốc. Tài liệu của họ nói rằng mô hình không có gọi công cụ gốc thì không thể dùng với Roo Code.

Chọn mô hình cho công việc của agent

Các agent này gửi một system prompt lớn, định nghĩa công cụ và nội dung tệp trong mỗi yêu cầu. Dùng mô hình có gọi công cụ và cửa sổ ngữ cảnh lớn. Bảng liệt kê các mô hình miễn phí có gọi công cụ và ít nhất 128K ngữ cảnh hiện nay, theo mức độ thông minh.

Mô hình miễn phí cho Cline, Roo Code và Kilo Code: gọi công cụ và 128K+ ngữ cảnh
Mô hìnhMiễn phí trênNgữ cảnhGiới hạn miễn phí (ưu đãi tốt nhất)Công cụThị giác
GLM 5.3UnoRouter1M1 yêu cầu/phút
1 req/min per model
CóKhông
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 yêu cầu/phút
40 RPM
CóCó
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaCóCó
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceCóKhông
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditCóCó
Gemini 3.7 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditCóCó
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 yêu cầu/phút
50 yêu cầu/ngày
50 req/day account-wide (1,000 after a $10 purchase)
CóCó
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 yêu cầu/phút
50 yêu cầu/ngày
Shared rate limit
CóKhông
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 yêu cầu/phút
250 yêu cầu/ngày
70,000 token/phút
~6M
CóCó
Gemini 3.6 FlashGoogle AI Studio1M10 yêu cầu/phút
20 yêu cầu/ngày
250,000 token/phút
~3M
CóCó
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayCóCó

Đang hiển thị 12 trong số 109 mô hình miễn phí phù hợp. Xem tất cả mô hình.

Dữ liệu trực tiếp từ danh mục FreeLLMAPI (phiên bản 2026.11.19, đã kiểm tra 2026-11-19). Giới hạn miễn phí thay đổi thường xuyên. Danh mục được kiểm tra mỗi ngày.

  • Dùng auto để bộ định tuyến chọn mô hình cho mỗi yêu cầu. Khi một nhà cung cấp gửi lỗi 429, bộ định tuyến thử mô hình tiếp theo.
  • Dùng auto:smart cho việc lập kế hoạch và lỗi khó.
  • Đặt cửa sổ ngữ cảnh trong agent thành ngữ cảnh thực của mô hình. Nếu giá trị quá cao, agent gửi các prompt mà mô hình từ chối.
  • Bắt đầu một tác vụ mới khi ngữ cảnh trở nên lớn. Ngữ cảnh nhỏ hơn dùng ít token hơn cho mỗi yêu cầu.

Khắc phục sự cố

Vấn đềNguyên nhânCách khắc phục
"Invalid API Key"Khóa không phải là khóa thống nhất của FreeLLMAPISao chép lại khóa thống nhất từ trang Keys
"Model Not Found"Model id không có trong danh mục của bạnDùng auto hoặc một ID từ GET /v1/models
Agent dừng sau một bước, hoặc gọi công cụ thất bạiMô hình có gọi công cụ yếu hoặc không cóChọn một mô hình từ bảng trên
Lỗi cửa sổ ngữ cảnh trong tác vụ dàiCài đặt ngữ cảnh lớn hơn ngữ cảnh thực của mô hìnhĐặt cửa sổ ngữ cảnh đúng, hoặc bắt đầu tác vụ mới
"Mọi mô hình bị giới hạn tốc độ sau N lần thử"Mọi khóa trong chuỗi đều đã đạt giới hạnThêm khóa từ nhiều nhà cung cấp hơn, hoặc chờ thời gian nghỉ kết thúc
Kilo: Model not found: openai-compatible/autoMô hình mặc định không có trong bản ánh xạ mô hình của nhà cung cấpChạy lại setup-kilo, lệnh này đặt mô hình mặc định lên đầu
Dùng tất cả các mô hình này qua một khóa duy nhất. FreeLLMAPI là bộ định tuyến mã nguồn mở, tự lưu trữ. Nó đặt tất cả các gói miễn phí này sau một endpoint duy nhất tương thích OpenAI, và tự chuyển sang nhà cung cấp khác khi một nhà cung cấp bị giới hạn tốc độ. Xem danh mục hoặc bắt đầu.

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

Tôi có thể dùng Cline miễn phí không?

Có. Cline miễn phí và là mã nguồn mở. Đặt API provider của nó thành OpenAI Compatible và trỏ tới FreeLLMAPI. Gateway gửi mỗi yêu cầu tới các gói miễn phí của nhà cung cấp, nên chi phí suy luận là $0.

Mô hình miễn phí nào tốt nhất cho Cline?

Dùng mô hình có gọi công cụ và ít nhất 128K ngữ cảnh. Cline gửi prompt phức tạp kèm định nghĩa công cụ. Bảng trên trang này cho thấy các mô hình miễn phí mạnh nhất đáp ứng cả hai quy tắc hiện nay.

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

Không. README của Roo Code nói rằng tiện ích đã ngừng hoạt động vào ngày 15 tháng 5 năm 2026, và kho mã đã được lưu trữ. Các bản cài đặt hiện có vẫn hoạt động với nhà cung cấp OpenAI Compatible.

Làm sao dùng Kilo Code với API tương thích OpenAI tùy chỉnh?

Thêm một nhà cung cấp openai-compatible với baseURL và apiKey trong cấu hình Kilo toàn cục, hoặc chạy npx freellmapi setup-kilo. Trong tiện ích VS Code, dùng Settings, Providers, Custom provider.

Tại sao Cline thất bại với mô hình miễn phí?

Phần lớn lỗi đến từ mô hình có gọi công cụ yếu hoặc cửa sổ ngữ cảnh nhỏ. Chọn mô hình có gọi công cụ và 128K ngữ cảnh, và bật Use Compact Prompt cho mô hình nhỏ hơn.

Hướng dẫn liên quan

Nguồn

Tất cả hướng dẫn · Xem tất cả mô hình miễn phí