OpenCode'u ücretsiz LLM API ile kullanın
OpenCode, terminal ve masaüstü için açık kaynaklı bir kodlama agentıdır. Herhangi bir OpenAI uyumlu sağlayıcıyı kabul eder. Bu kılavuz OpenCode'u FreeLLMAPI üzerinden ücretsiz modellere bağlar. Tek bir komut yapılandırmayı yazar ve anahtarı saklar.
Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.
1. adım: FreeLLMAPI'yi kurun
FreeLLMAPI açık kaynaklı bir ağ geçididir. Docker içinde bilgisayarınızda çalışır ve 45 sağlayıcının ücretsiz katmanlarını tek bir anahtarın arkasında toplar.
macOS veya Linux'a kurun
curl -fsSL https://freellmapi.co/install.sh | bashhttp://localhost:3001 adresini açın. Keys sayfasına en az iki ücretsiz sağlayıcı anahtarı ekleyin. Google AI Studio ve Groq, birkaç dakika içinde birer ücretsiz anahtar verir. Birleşik anahtarınızı aynı sayfadan kopyalayın.
2. adım: OpenCode'u tek komutla bağlayın
Tek komut
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencodeKomut üç şey yapar:
- Bir
freellmapisağlayıcısını~/.config/opencode/opencode.jsondosyasına ekler. Sağlayıcı, canlı kataloğunuzdaki modelleri bağlam limitleriyle listeler. freellmapi/autodeğerini varsayılan model olarak ayarlar.- Anahtarı OpenCode'un kimlik bilgisi dosyası olan
~/.local/share/opencode/auth.jsondosyasında saklar. CLI'de veya masaüstü uygulamasında ortam değişkenine gerek yoktur.
Komut yazmadan önce bir yedek alır. Yeni sağlayıcıyı mevcut ayarlarla birleştirir, bu nedenle diğer sağlayıcılarınız kalır. XDG_CONFIG_HOME veya XDG_DATA_HOME ayarlıysa komut bu klasörleri kullanır.
Uzun bir göreve başlamadan önce ağ geçidinin şu anda bir isteğe yanıt verebildiğinden emin olun. Bu çağrı yalnızca o anda kullanılabilir anahtarı olan modelleri listeler:
Hangi modellerin hazır olduğunu kontrol edin
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"exhausted durumundaki bir model anahtarlara sahiptir, ancak hepsi şu anda limitindedir. Bu durum, bekleme süreleri bitince temizlenir. Bir istemcinin isteklerinin ağ geçidine ulaştığından emin olmak için npx freellmapi doctor komutunu çalıştırın. Kontrol panelindeki istek günlüğü, OpenCode'dan gelen her çağrıyı gösterir. X-Routed-Via yanıt üstbilgisi, her isteği yanıtlayan sağlayıcıyı ve modeli gösterir. Bir istek başka bir sağlayıcıya geçtiyse X-Fallback-Trail üstbilgisi, başarısız olan her adımı ve nedenini gösterir.
Elle kurulum: opencode.json sağlayıcı bloğu
Elle kurmak için bu bloğu ~/.config/opencode/opencode.json dosyasına veya projenizdeki opencode.json dosyasına ekleyin. OpenCode, @ai-sdk/openai-compatible paketini /v1/chat/completions uç noktaları için kullanır.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"model": "freellmapi/auto",
"provider": {
"freellmapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "FreeLLMAPI",
"options": {
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}Sonra anahtarı ekleyin. OpenCode'u başlatın, /connect komutunu çalıştırın, freellmapi sağlayıcısını seçin ve birleşik anahtarınızı yapıştırın. /connect içindeki sağlayıcı kimliği, yapılandırmadaki kimlikle eşleşmelidir. Model seçmek için /models komutunu çalıştırın.
limit.context, modelin en fazla girdi token sayısıdır.limit.output, modelin üretebileceği en fazla token sayısıdır.- Üst düzey
modelalanıprovider/modelbiçimini kullanır. Bu alan yoksa OpenCode, daha önce kullandığı modeli korur. - Kullanmak istediğiniz her model kimliği
modelseşleşmesinde olmalıdır.GET /v1/modelsüzerinden daha fazla kimlik ekleyin.
providers anahtarı içeren bir V2 yapılandırma biçimini tanımlar. Belgeler, yukarıdaki V1 biçiminin desteklenmeye devam ettiğini söyler. FreeLLMAPI kurulum komutu V1 biçimini yazar.OpenCode için modeller seçin
OpenCode bir agenttır. Araç çağrıları yoluyla dosyaları okur, düzenler ve komutları çalıştırır. Her istek bir sistem istemi, araç tanımları ve dosya içerikleri taşır. Araç çağrısı olan ve geniş bir bağlam penceresi bulunan modelleri kullanın.
| 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 freellmapi/auto kullanın. İstekleri zekâya veya hıza göre yönlendirmek için auto:smart veya auto:fast değerini models eşleşmesine ekleyin. Kontrol panelinde oluşturduktan sonra, örneğin auto:coding gibi adlandırılmış bir profil de ekleyebilirsiniz.
Hız limitleri ve uzun oturumlar
Tek bir agent görevi düzinelerce istek gönderebilir. Tek bir ücretsiz katman uzun bir görevi hızla durdurur. FreeLLMAPI her anahtarın istek ve token sayısını sayar. Bir sağlayıcı 429 hatası gönderdiğinde yönlendirici isteği zincirdeki sonraki modele gönderir ve oturum devam eder.
- Dört veya daha fazla sağlayıcıdan anahtar ekleyin. Daha fazla sağlayıcı, günde daha fazla istek verir.
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchdeğerini FreeLLMAPI.envdosyasında ayarlayarak bağlam devrini açın. Model değiştiğinde, sonraki model bir görevi sürdürdüğüne dair kısa bir not alır.- Yapışkan oturumlar, bir konuşmayı 30 dakika boyunca tek bir modelde tutar. Bu, agentın tutarlı kalmasını sağlar.
- Her görev için yeni bir oturum başlatın. Daha küçük bir bağlam, istek başına daha az token kullanır.
Sorun giderme
| Sorun | Neden | Çözüm |
|---|---|---|
| Geçerli bir anahtarla "Invalid API key" | Yapılandırmadaki boş apiKey, /connect anahtarının yerine geçer | apiKey alanını options bölümünden kaldırın veya setup-opencode komutunu yeniden çalıştırın |
| OpenCode yeni sağlayıcıyı kullanmıyor | Üst düzey model ayarlanmamış | "model": "freellmapi/auto" olarak ayarlayın |
| Model bulunamadı | Model kimliği sağlayıcının models eşleşmesinde yok | Kimliği eşleşmeye ekleyin veya setup-opencode komutunu yeniden çalıştırın |
{env:VAR} anahtarı boş | OpenCode, ayarlanmamış bir değişkeni boş bir metinle değiştirir | Değişkeni aynı kabukta dışa aktarın veya anahtarı /connect ile saklayın |
| Araç çağrıları başarısız oluyor | Model zayıf araç çağrısı yapıyor | Yukarıdaki tablodan bir model seçin |
| "Tüm modeller N denemeden sonra hız limitine takıldı" | Tüm anahtarlar limitinde | Daha fazla sağlayıcıdan anahtar ekleyin veya bekleme sürelerinin dolmasını bekleyin |
Sık sorulan sorular
OpenCode'u ücretsiz kullanabilir miyim?
Evet. OpenCode açık kaynaklıdır. FreeLLMAPI'ye OpenAI uyumlu bir sağlayıcı olarak bağlayın. Ağ geçidi her isteği ücretsiz sağlayıcı katmanlarına gönderir, bu nedenle çıkarım maliyeti $0'dır.
OpenCode'a özel bir OpenAI uyumlu sağlayıcı nasıl eklenir?
opencode.json dosyasına npm değeri @ai-sdk/openai-compatible olan, options.baseURL ve bir models eşleşmesi içeren bir sağlayıcı ekleyin. Sonra anahtarı saklamak için /connect, model seçmek için /models komutunu çalıştırın.
OpenCode için en iyi ücretsiz model hangisi?
En az 128K bağlamı olan ve araç çağrısı yapan bir model kullanın. Bu sayfadaki tablo, bugün her iki kuralı da karşılayan en güçlü ücretsiz modelleri gösterir. Yönlendiricinin birini seçmesi için freellmapi/auto kullanın.
OpenCode API anahtarlarını nerede saklar?
/connect ile eklenen anahtarlar ~/.local/share/opencode/auth.json dosyasına gider. FreeLLMAPI kurulum komutu anahtarı oraya yazar, bu nedenle hem CLI hem de masaüstü uygulaması onu bulur.
İlgili rehberler
- Aider'ı ücretsiz LLM API ile kullanın
- Codex CLI'ı ücretsiz modellerle kullanın
- Claude Code'u ücretsiz nasıl kullanırsınız
- En iyi ücretsiz kodlama model API'leri
- Ücretsiz OpenAI uyumlu API base URL'leri
Kaynaklar
- OpenCode docs: providers (V1 config) (20 November 2026 tarihinde kontrol edildi)
- OpenCode docs: config (20 November 2026 tarihinde kontrol edildi)
- OpenCode docs: migrate from V1 (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI CLI generators (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI docs: context handoff (20 November 2026 tarihinde kontrol edildi)