Cline, Roo Code ve Kilo Code ücretsiz API ile
Cline, Roo Code ve Kilo Code, VS Code için kodlama agentlarıdır. Her biri OpenAI uyumlu bir API kullanabilir. Bu kılavuz bunları FreeLLMAPI üzerinden ücretsiz modellere bağlar. Ayrıca bu agentların gönderdiği uzun ve araç yoğun istemleri hangi ücretsiz modellerin işlediğini gösterir.
Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.
Başlamadan önce
FreeLLMAPI, bilgisayarınızda çalışan açık kaynaklı bir ağ geçididir. 45 sağlayıcının ücretsiz katmanlarını tek bir anahtarın arkasında toplar. Docker içinde kurun, sonra Keys sayfasına en az iki ücretsiz sağlayıcı anahtarı ekleyin.
macOS veya Linux'a kurun
curl -fsSL https://freellmapi.co/install.sh | bashBirleşik anahtarınızı Keys sayfasından kopyalayın. Üç agent de aynı değerleri kullanır:
| Alan | Değer |
|---|---|
| Base URL | http://localhost:3001/v1 |
| API key | <unified-key> |
| Model ID | auto veya GET /v1/models üzerinden bir katalog kimliği |
Cline
En hızlı yöntem kurulum komutudur. Canlı kataloğunuzu okur, mevcut Cline ayarlarının bir yedeğini alır ve bir OpenAI Compatible sağlayıcı ekler.
Tek komut
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>İlk satır farkı gösterir ve hiçbir şey yazmaz. İkinci satır değişikliği yazar. Cline'ı elle kurmak için şu adımları uygulayın:
- VS Code'da Cline panelini açın. Ayarlar (dişli) simgesine tıklayın.
- API Provider alanını OpenAI Compatible olarak ayarlayın.
- Base URL alanını
http://localhost:3001/v1olarak ayarlayın. - API Key alanını birleşik anahtarınıza ayarlayın.
- Model ID alanını
autoolarak veya aşağıdaki tablodaki bir modele ayarlayın. - Model Configuration bölümünü açın. Context Window alanını modelinizin bağlamına ayarlayın. Image Support seçeneğini yalnızca bir görüntü modeli için açın.
Cline, OpenAI Compatible sağlayıcılar için şu notu gösterir: "Cline karmaşık istemler kullanır, bu nedenle davranış modellere göre değişebilir." Daha küçük modeller için Cline belgeleri, Cline Settings, Features bölümünde Use Compact Prompt seçeneğini önerir.
Kilo Code
Kurulum komutunu çalıştırın. Bu komut, bir openai-compatible sağlayıcısı içeren genel bir Kilo yapılandırması yazar ve bunu varsayılan model yapar.
Tek komut
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"Yapılandırma anahtara {env:FREELLMAPI_API_KEY} olarak başvurur. Bu nedenle Kilo'yu başlatmadan önce değişkeni dışa aktarın. Kilo, {env:...} ifadesini yalnızca güvenilen yapılandırmada genişletir, örneğin ~/.config/kilo genel klasöründe. Proje yapılandırmasında Kilo bunu yok sayar ve bir uyarı kaydeder. Oluşturulan yapılandırmanın biçimi şöyledir:
Kilo genel yapılandırması (biçim)
{
"$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 }
}
}
}
}
}VS Code uzantısında sağlayıcıyı elle de ekleyebilirsiniz. Settings bölümünü, sonra Providers sekmesini açın ve Custom provider seçeneğine tıklayın. Provider API alanını OpenAI Compatible olarak ayarlayın. Base URL ve anahtarı girin, sonra model listesini okumak için Fetch models seçeneğine tıklayın.
Roo Code (mevcut kurulumlar)
Kurulum komutu, VS Code uzantısı için bir içe aktarma dosyası yazar. Ayrıca Roo CLI için bir profil de yazar.
Tek komut
npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>Sonra Roo Code'a içe aktarma dosyasını yüklemesini söyleyin. Bu satırı VS Code settings.json dosyanıza ekleyin ve pencereyi yeniden yükleyin. freellmapi profili geçerli profil olur.
VS Code settings.json
"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"Elle kurmak için Roo Code ayarlarını açın ve API Provider alanını OpenAI Compatible olarak ayarlayın. Base URL, anahtar ve modeli girin. Roo Code yalnızca yerel araç çağrısını kullanır. Belgeleri, yerel araç çağrısı olmayan bir modelin Roo Code ile kullanılamayacağını söyler.
Agent işleri için modeller seçin
Bu agentlar her istekte büyük bir sistem istemi, araç tanımları ve dosya içerikleri gönderir. Araç çağrısı olan ve geniş bir bağlam penceresi bulunan modelleri kullanın. Tablo, bugün araç çağrısı olan ve en az 128K bağlamı bulunan ücretsiz modelleri zekâya göre gösterir.
| Model | Ücretsiz olduğu yer | Bağlam | Ücretsiz limitler (en iyi teklif) | Araçlar | Görsel girdi |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 istek/dk 1 req/min per model | Evet | Hayır |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 istek/dk 40 RPM | Evet | Evet |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Evet | Evet |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Evet | Hayır |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Evet | Evet |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 istek/dk 50 istek/gün 50 req/day account-wide (1,000 after a $10 purchase) | Evet | Evet |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 istek/dk 50 istek/gün Shared rate limit | Evet | Hayır |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 istek/dk 250 istek/gün 70,000 jeton/dk ~6M | Evet | Evet |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Evet | Evet |
109 eşleşen ücretsiz modelden 12 tanesi gösteriliyor. Tüm modelleri gör.
Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.
- Her istek için yönlendiricinin bir model seçmesi üzere
autokullanın. Bir sağlayıcı 429 hatası gönderdiğinde yönlendirici sonraki modeli dener. - Planlama ve zor hatalar için
auto:smartkullanın. - Agentta bağlam penceresini modelin gerçek bağlamına ayarlayın. Değer çok yüksekse agent, modelin reddettiği istemler gönderir.
- Bağlam büyüdüğünde yeni bir görev başlatın. Daha küçük bir bağlam, istek başına daha az token kullanır.
Sorun giderme
| Sorun | Neden | Çözüm |
|---|---|---|
| "Invalid API Key" | Anahtar, FreeLLMAPI birleşik anahtarınız değil | Birleşik anahtarı Keys sayfasından yeniden kopyalayın |
| "Model Not Found" | Model kimliği katalogunuzda yok | auto veya GET /v1/models kimliğini kullanın |
| Agent bir adımdan sonra durur veya araç çağrıları başarısız olur | Model zayıf araç çağrısı yapıyor veya hiç yapmıyor | Yukarıdaki tablodan bir model seçin |
| Uzun görevlerde bağlam penceresi hataları | Bağlam ayarı modelin gerçek bağlamından büyük | Doğru bağlam penceresini ayarlayın veya yeni bir görev başlatın |
| "Tüm modeller N denemeden sonra hız limitine takıldı" | Zincirdeki her anahtar limitinde | Daha fazla sağlayıcıdan anahtar ekleyin veya bekleme sürelerinin dolmasını bekleyin |
Kilo: Model not found: openai-compatible/auto | Varsayılan model, sağlayıcının model eşleşmesinde yok | setup-kilo komutunu yeniden çalıştırın. Bu, varsayılan modeli başa koyar |
Sık sorulan sorular
Cline'ı ücretsiz kullanabilir miyim?
Evet. Cline ücretsiz ve açık kaynaklıdır. API sağlayıcısını OpenAI Compatible olarak ayarlayın ve FreeLLMAPI'ye yöneltin. Ağ geçidi her isteği ücretsiz sağlayıcı katmanlarına gönderir, bu nedenle çıkarım maliyeti $0'dır.
Cline için en iyi ücretsiz model hangisi?
En az 128K bağlamı olan ve araç çağrısı yapan bir model kullanın. Cline, araç tanımları içeren karmaşık istemler gönderir. Bu sayfadaki tablo, bugün her iki kuralı da karşılayan en güçlü ücretsiz modelleri gösterir.
Roo Code hâlâ bakımda mı?
Hayır. Roo Code README dosyası, uzantının 15 Mayıs 2026'da kapatıldığını ve deponun arşivlendiğini söyler. Mevcut kurulumlar OpenAI Compatible sağlayıcıyla hâlâ çalışır.
Kilo Code'u özel bir OpenAI uyumlu API ile nasıl kullanırım?
Genel Kilo yapılandırmasına baseURL ve apiKey içeren bir openai-compatible sağlayıcı ekleyin veya npx freellmapi setup-kilo komutunu çalıştırın. VS Code uzantısında Settings, Providers, Custom provider yolunu kullanın.
Cline neden ücretsiz modellerle başarısız oluyor?
Çoğu hata, zayıf araç çağrısı yapan modellerden veya küçük bir bağlam penceresinden gelir. Araç çağrısı ve 128K bağlamı olan bir model seçin. Daha küçük modeller için Use Compact Prompt seçeneğini açın.
İlgili rehberler
- VS Code'da ücretsiz AI modelleri
- Ücretsiz LLM API ile Continue
- En iyi ücretsiz kodlama model API'leri
- Fonksiyon çağrısı destekli ücretsiz LLM API
- Claude Code'u ücretsiz nasıl kullanırsınız
Kaynaklar
- Cline docs: OpenAI Compatible provider (20 November 2026 tarihinde kontrol edildi)
- Cline docs: running models locally (20 November 2026 tarihinde kontrol edildi)
- Kilo docs: custom models (20 November 2026 tarihinde kontrol edildi)
- Kilo docs: OpenAI Compatible provider (20 November 2026 tarihinde kontrol edildi)
- Roo Code repository (archived) (20 November 2026 tarihinde kontrol edildi)
- Roo Code docs: settings management (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI docs: clients and coding agents (20 November 2026 tarihinde kontrol edildi)