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 | bashSao 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ường | Giá trị |
|---|---|
| Base URL | http://localhost:3001/v1 |
| API key | <unified-key> |
| Model ID | auto, hoặc một ID trong danh mục từ GET /v1/models |
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:
- Mở bảng Cline trong VS Code. Nhấp vào biểu tượng cài đặt (bánh răng).
- Đặt API Provider thành OpenAI Compatible.
- Đặt Base URL thành
http://localhost:3001/v1. - Đặt API Key thành khóa thống nhất của bạn.
- Đặt Model ID thành
autohoặc một mô hình trong bảng dưới đây. - 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í trên | Ngữ cảnh | Giới hạn miễn phí (ưu đãi tốt nhất) | Công cụ | Thị giác |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 yêu cầu/phút 1 req/min per model | Có | Không |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 yêu cầu/phút 40 RPM | Có | Có |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Có | Có |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Có | Không |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Có | Có |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 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 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 yêu cầu/phút 50 yêu cầu/ngày Shared rate limit | Có | Không |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 yêu cầu/phút 250 yêu cầu/ngày 70,000 token/phút ~6M | Có | Có |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 yêu cầu/phút 20 yêu cầu/ngày 250,000 token/phút ~3M | Có | Có |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Có | 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:smartcho 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ân | Cách khắc phục |
|---|---|---|
| "Invalid API Key" | Khóa không phải là khóa thống nhất của FreeLLMAPI | Sao 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ạn | Dù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ại | Mô 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ài | Cà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ạn | Thê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/auto | Mô hình mặc định không có trong bản ánh xạ mô hình của nhà cung cấp | Chạy lại setup-kilo, lệnh này đặt mô hình mặc định lên đầ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
- Mô hình AI miễn phí trong VS Code
- Continue với API LLM miễn phí
- API model lập trình miễn phí tốt nhất
- API LLM miễn phí với function calling
- Cách dùng Claude Code miễn phí
Nguồn
- Cline docs: OpenAI Compatible provider (đã kiểm tra 20 November 2026)
- Cline docs: running models locally (đã kiểm tra 20 November 2026)
- Kilo docs: custom models (đã kiểm tra 20 November 2026)
- Kilo docs: OpenAI Compatible provider (đã kiểm tra 20 November 2026)
- Roo Code repository (archived) (đã kiểm tra 20 November 2026)
- Roo Code docs: settings management (đã kiểm tra 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (đã kiểm tra 20 November 2026)