Laman utama / Panduan / Cline, Roo Code dan Kilo Code dengan API percuma

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 | bash

Salin kunci bersatu anda daripada halaman Keys. Ketiga-tiga ejen menggunakan nilai yang sama:

MedanNilai
Base URLhttp://localhost:3001/v1
Kunci API<unified-key>
ID Modelauto, atau ID katalog daripada GET /v1/models
Status Roo Code: README Roo Code menyatakan bahawa sambungan itu telah ditamatkan pada 15 Mei 2026. Repositori itu diarkibkan dan hanya boleh dibaca. Langkah di bawah masih terpakai untuk pemasangan sedia ada, tetapi pengguna baharu patut memilih Cline atau Kilo Code.

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:

  1. Buka panel Cline dalam VS Code. Klik ikon tetapan (gear).
  2. Tetapkan API Provider kepada OpenAI Compatible.
  3. Tetapkan Base URL kepada http://localhost:3001/v1.
  4. Tetapkan API Key kepada kunci bersatu anda.
  5. Tetapkan Model ID kepada auto atau kepada model daripada jadual di bawah.
  6. 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 untuk Cline, Roo Code dan Kilo Code: panggilan alat dan konteks 128K+
ModelPercuma padaKonteksHad percuma (tawaran terbaik)AlatPenglihatan
GLM 5.3UnoRouter1M1 permintaan/minit
1 req/min per model
YaTidak
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 permintaan/minit
40 RPM
YaYa
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaYaYa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceYaTidak
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditYaYa
Gemini 3.7 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditYaYa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 permintaan/minit
50 permintaan/hari
50 req/day account-wide (1,000 after a $10 purchase)
YaYa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 permintaan/minit
50 permintaan/hari
Shared rate limit
YaTidak
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 permintaan/minit
250 permintaan/hari
70,000 token/minit
~6M
YaYa
Gemini 3.6 FlashGoogle AI Studio1M10 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayYaYa

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 auto untuk membenarkan penghala memilih model bagi setiap permintaan. Apabila satu penyedia menghantar ralat 429, penghala mencuba model seterusnya.
  • Guna auto:smart untuk 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

MasalahPuncaPenyelesaian
"Invalid API Key"Kunci itu bukan kunci bersatu FreeLLMAPI andaSalin semula kunci bersatu daripada halaman Keys
"Model Not Found"ID model tiada dalam katalog andaGuna auto atau ID daripada GET /v1/models
Ejen berhenti selepas satu langkah, atau panggilan alat gagalModel mempunyai panggilan alat yang lemah atau tiada langsungPilih model daripada jadual di atas
Ralat tetingkap konteks pada tugasan panjangTetapan konteks lebih besar daripada konteks sebenar modelTetapkan tetingkap konteks yang betul, atau mulakan tugasan baharu
"Semua model dihadkan kadar selepas N percubaan"Setiap kunci dalam rantaian telah mencapai hadTambah kunci daripada lebih banyak penyedia, atau tunggu tempoh rehat
Kilo: Model not found: openai-compatible/autoModel lalai tiada dalam peta model penyediaJalankan setup-kilo sekali lagi, yang meletakkan model lalai di hadapan
Guna setiap satu daripada ini melalui satu kunci. FreeLLMAPI ialah penghala sumber terbuka yang anda hoskan sendiri. Ia meletakkan semua peringkat percuma ini di belakang satu titik akhir serasi OpenAI dan beralih ke pembekal lain apabila had kadar dicapai. Layari katalog atau mula sekarang.

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

Sumber

Semua panduan · Lihat semua model percuma