Cline, Roo Code dan Kilo Code dengan API percuma
Cline, Roo Code dan Kilo Code ialah ejen pengekodan untuk VS Code. Setiap satunya boleh menggunakan API yang serasi dengan OpenAI. Panduan ini menyambungkannya kepada model percuma melalui FreeLLMAPI. Ia juga menunjukkan model percuma yang mengendalikan gesaan panjang yang banyak panggilan alat, yang dihantar oleh ejen ini.
Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.
Sebelum anda mula
FreeLLMAPI ialah gerbang sumber terbuka yang dijalankan pada komputer anda. Ia menghimpunkan tier percuma bagi 45 penyedia di sebalik satu kunci. Pasangnya dalam Docker, kemudian tambah sekurang-kurangnya dua kunci penyedia percuma pada halaman Keys.
Pasang pada macOS atau Linux
curl -fsSL https://freellmapi.co/install.sh | bashSalin kunci bersatu anda daripada halaman Keys. Ketiga-tiga ejen menggunakan nilai yang sama:
| Medan | Nilai |
|---|---|
| Base URL | http://localhost:3001/v1 |
| Kunci API | <unified-key> |
| ID Model | auto, atau ID katalog daripada GET /v1/models |
Cline
Kaedah yang paling pantas ialah arahan persediaan. Arahan ini membaca katalog langsung anda, membuat sandaran tetapan Cline yang sedia ada dan menambah penyedia OpenAI Compatible.
Satu arahan
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>Baris pertama menunjukkan perbezaan dan tidak menulis apa-apa. Baris kedua menulis perubahan itu. Untuk menyediakan Cline secara manual, lakukan langkah berikut:
- Buka panel Cline dalam VS Code. Klik ikon tetapan (gear).
- Tetapkan API Provider kepada OpenAI Compatible.
- Tetapkan Base URL kepada
http://localhost:3001/v1. - Tetapkan API Key kepada kunci bersatu anda.
- Tetapkan Model ID kepada
autoatau kepada model daripada jadual di bawah. - Buka Model Configuration. Tetapkan Context Window kepada konteks model anda. Hidupkan Image Support hanya untuk model penglihatan.
Cline memaparkan nota ini untuk penyedia OpenAI Compatible: "Cline menggunakan gesaan yang kompleks, jadi kelakuan boleh berbeza antara model." Untuk model yang lebih kecil, dokumentasi Cline mengesyorkan Use Compact Prompt dalam Cline Settings, Features.
Kilo Code
Jalankan arahan persediaan. Ia menulis konfigurasi Kilo global dengan penyedia openai-compatible dan menjadikannya model lalai.
Satu arahan
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"Konfigurasi merujuk kunci sebagai {env:FREELLMAPI_API_KEY}, jadi eksport pembolehubah itu sebelum anda memulakan Kilo. Kilo hanya mengembangkan {env:...} dalam konfigurasi yang dipercayai, contohnya folder global ~/.config/kilo. Dalam konfigurasi projek, Kilo mengabaikannya dan mencatat amaran. Konfigurasi yang dijana mempunyai bentuk ini:
Konfigurasi global Kilo (bentuk)
{
"$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 }
}
}
}
}
}Dalam sambungan VS Code, anda juga boleh menambah penyedia secara manual. Buka Settings, kemudian tab Providers, lalu klik Custom provider. Tetapkan Provider API kepada OpenAI Compatible. Masukkan base URL dan kunci, kemudian klik Fetch models untuk membaca senarai model.
Roo Code (pemasangan sedia ada)
Arahan persediaan menulis fail import untuk sambungan VS Code. Ia juga menulis profil untuk Roo CLI.
Satu arahan
npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>Kemudian beritahu Roo Code untuk memuatkan fail import. Tambah baris ini pada settings.json VS Code anda dan muat semula tetingkap. Profil freellmapi menjadi profil semasa.
settings.json VS Code
"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"Untuk menyediakannya secara manual, buka tetapan Roo Code dan tetapkan API Provider kepada OpenAI Compatible. Masukkan base URL, kunci dan model. Roo Code hanya menggunakan panggilan alat asli. Dokumentasinya menyatakan bahawa model tanpa panggilan alat asli tidak boleh digunakan dengan Roo Code.
Pilih model untuk kerja ejen
Ejen ini menghantar gesaan sistem yang besar, takrif alat dan kandungan fail dalam setiap permintaan. Guna model dengan panggilan alat dan tetingkap konteks yang besar. Jadual menunjukkan model percuma dengan panggilan alat dan sekurang-kurangnya 128K konteks hari ini, mengikut kecerdasan.
| Model | Percuma pada | Konteks | Had percuma (tawaran terbaik) | Alat | Penglihatan |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 permintaan/minit 1 req/min per model | Ya | Tidak |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 permintaan/minit 40 RPM | Ya | Ya |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ya | Ya |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ya | Tidak |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ya | Ya |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 permintaan/minit 50 permintaan/hari 50 req/day account-wide (1,000 after a $10 purchase) | Ya | Ya |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 permintaan/minit 50 permintaan/hari Shared rate limit | Ya | Tidak |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 permintaan/minit 250 permintaan/hari 70,000 token/minit ~6M | Ya | Ya |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ya | Ya |
Memaparkan 12 daripada 109 model percuma yang sepadan. Lihat semua model.
Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.
- Guna
autountuk membenarkan penghala memilih model bagi setiap permintaan. Apabila satu penyedia menghantar ralat 429, penghala mencuba model seterusnya. - Guna
auto:smartuntuk perancangan dan pepijat yang sukar. - Tetapkan tetingkap konteks dalam ejen kepada konteks sebenar model. Jika nilainya terlalu tinggi, ejen menghantar gesaan yang model tolak.
- Mulakan tugasan baharu apabila konteks menjadi besar. Konteks yang lebih kecil menggunakan lebih sedikit token bagi setiap permintaan.
Penyelesaian masalah
| Masalah | Punca | Penyelesaian |
|---|---|---|
| "Invalid API Key" | Kunci itu bukan kunci bersatu FreeLLMAPI anda | Salin semula kunci bersatu daripada halaman Keys |
| "Model Not Found" | ID model tiada dalam katalog anda | Guna auto atau ID daripada GET /v1/models |
| Ejen berhenti selepas satu langkah, atau panggilan alat gagal | Model mempunyai panggilan alat yang lemah atau tiada langsung | Pilih model daripada jadual di atas |
| Ralat tetingkap konteks pada tugasan panjang | Tetapan konteks lebih besar daripada konteks sebenar model | Tetapkan tetingkap konteks yang betul, atau mulakan tugasan baharu |
| "Semua model dihadkan kadar selepas N percubaan" | Setiap kunci dalam rantaian telah mencapai had | Tambah kunci daripada lebih banyak penyedia, atau tunggu tempoh rehat |
Kilo: Model not found: openai-compatible/auto | Model lalai tiada dalam peta model penyedia | Jalankan setup-kilo sekali lagi, yang meletakkan model lalai di hadapan |
Soalan lazim
Bolehkah saya guna Cline secara percuma?
Boleh. Cline percuma dan bersumber terbuka. Tetapkan penyedia API kepada OpenAI Compatible dan halakannya ke FreeLLMAPI. Gerbang menghantar setiap permintaan ke tier percuma penyedia, jadi kos inferens ialah $0.
Model percuma yang manakah terbaik untuk Cline?
Guna model dengan panggilan alat dan sekurang-kurangnya 128K konteks. Cline menghantar gesaan yang kompleks dengan takrif alat. Jadual dalam halaman ini menunjukkan model percuma terkuat yang memenuhi kedua-dua syarat hari ini.
Adakah Roo Code masih diselenggara?
Tidak. README Roo Code menyatakan bahawa sambungan itu telah ditamatkan pada 15 Mei 2026, dan repositori itu diarkibkan. Pemasangan sedia ada masih berfungsi dengan penyedia OpenAI Compatible.
Bagaimana saya menggunakan Kilo Code dengan API yang serasi dengan OpenAI tersuai?
Tambah penyedia openai-compatible dengan baseURL dan apiKey dalam konfigurasi Kilo global, atau jalankan npx freellmapi setup-kilo. Dalam sambungan VS Code, guna Settings, Providers, Custom provider.
Mengapa Cline gagal dengan model percuma?
Kebanyakan kegagalan berpunca daripada model dengan panggilan alat yang lemah atau tetingkap konteks yang kecil. Pilih model dengan panggilan alat dan konteks 128K, dan hidupkan Use Compact Prompt untuk model yang lebih kecil.
Panduan berkaitan
- Model AI percuma dalam VS Code
- Continue dengan API LLM percuma
- Model API pengekodan percuma terbaik
- API LLM percuma dengan panggilan fungsi
- Cara guna Claude Code secara percuma
Sumber
- Cline docs: OpenAI Compatible provider (disemak 20 November 2026)
- Cline docs: running models locally (disemak 20 November 2026)
- Kilo docs: custom models (disemak 20 November 2026)
- Kilo docs: OpenAI Compatible provider (disemak 20 November 2026)
- Roo Code repository (archived) (disemak 20 November 2026)
- Roo Code docs: settings management (disemak 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (disemak 20 November 2026)