opencode, terminal için açık kaynaklı bir kodlama ajanıdır. Yerleşik kataloğunda olmayan sağlayıcılar opencode.jsonc içinde özel sağlayıcı (custom provider) olarak eklenir. BroadNet Inference OpenAI chat completions formatını konuştuğu için opencode’un OpenAI uyumlu çalışma zamanı paketini kullanır. Bu rehber güncel (V2) opencode belgelerini izler.
Kurulum
- Anahtarınızı opencode’u başlatan kabukta dışa aktarın:
export BROADNET_API_KEY='your-broadnet-key'
- Yapılandırmayı oluşturun. Projenize
opencode.jsoncolarak koyun ya da her yerde kullanmak için~/.config/opencode/opencode.jsoncdosyasına yazın.
{
"$schema": "https://opencode.ai/config.json",
"model": "broadnet/glm-5.3",
"providers": {
"broadnet": {
"name": "BroadNet Inference",
"env": ["BROADNET_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": {
"baseURL": "https://inference.broadnet.ai/v1"
},
"models": {
"glm-5.3": {
"modelID": "broadnet/glm-5.3",
"name": "GLM 5.3",
"capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"deepseek-v4.1-flash": {
"modelID": "broadnet/deepseek-v4.1-flash",
"name": "DeepSeek V4.1 Flash",
// BroadNet's docs don't list tool calling for this model: test it first
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 1048576, "output": 16000 }
},
"qwen3.8-27b": {
"modelID": "broadnet/qwen3.8-27b",
"name": "Qwen3.8 27B",
"capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
"limit": { "context": 262144, "output": 16000 }
}
}
}
}
}
- opencode’u başlatın ve modeli
/modelsile seçin. Referansbroadnet/<eşleme anahtarı>biçimindedir, örneğinbroadnet/glm-5.3. opencode BroadNet’emodelIDdeğerini gönderir.
Yapılandırma dosyaları birleştirilir. opencode önce genel dosyayı, ardından geçerli dizinden yukarı doğru bulunan proje dosyalarını (en uzaktaki önce), sonra varsa .opencode/ yapılandırmasını uygular; böylece bir proje dosyası genel sağlayıcıyı geçersiz kılabilir. Şirketiniz kullanıyorsa yönetilen sistem yapılandırması ikisini de geçersiz kılar. Yapılandırmanın sürüm kontrolüne girebilmesi için anahtarı dosyada değil ortam değişkeninde tutun.
Neden takma adlar
BroadNet kimlikleri zaten bir eğik çizgi içerir (broadnet/glm-5.3). models eşlemesindeki anahtar opencode’un gösterdiği ve seçtiği addır; modelID ise gönderdiği değerdir. Kısa anahtarlar referansları okunur tutar.
capabilities ve limit değerlerini kendiniz ayarlayın. Kataloğu dışındaki bir model için opencode JSON araç desteği, metin ve görsel girdi, 200.000 token’lık bağlam ve 32.000 çıktı token’ı varsayar. Belgeleri bunlara algılanmış değerler değil, yedek varsayımlar (fallback) der. Yukarıdaki 16000 output değeri bir BroadNet sınırı değil, bizim önerimizdir; akıl yürütmeye yer bırakır.
Eski V1 yapılandırmaları
opencode V2 V1 formatını hâlâ okur, bu yüzden aşağıdaki gibi mevcut bir blok çalışmaya devam eder:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"broadnet": {
"npm": "@ai-sdk/openai-compatible",
"name": "BroadNet Inference",
"options": {
"baseURL": "https://inference.broadnet.ai/v1",
"apiKey": "{env:BROADNET_API_KEY}"
},
"models": {
"broadnet/glm-5.3": { "name": "GLM 5.3" }
}
}
}
}
Yerel V2 biçiminde provider, providers olur; npm, package olur (AI SDK paketini korumak istiyorsanız aisdk:@ai-sdk/openai-compatible); options.baseURL ve options.apiKey de settings altına taşınır. opencode V1 geçiş rehberi her alanın karşılığını gösterir.
Hangi modeli seçmeli
| Görev | Model | Notlar |
|---|---|---|
| Araçlarla ajan tabanlı kodlama | GLM 5.3 | Araçlar ve yapılandırılmış çıktı listeleniyor; 1M bağlam |
| Ekran görüntüleri, Arapça | Qwen3.8 27B | Araçlar ve görseller; 262K bağlam |
| Gün boyu oturumlar, sabit fiyat | DeepSeek V4.1 Flash | Sınırsız planlar; araçlar BroadNet tarafından listelenmiyor |
opencode araç çağrılarına dayanır. BroadNet’in belgeleri DeepSeek V4.1 Flash için araç çağırmayı listelemez; bu yüzden yapılandırma bunu test edilmesi gereken bir varsayım olarak işaretler. Bir Full Moon ayı ($60) satın almadan önce gerçek bir işi bir Meteor saatinde ($1) deneyin.
Sorun giderme
- 401.
BROADNET_API_KEYiçindeki anahtar yanlış, süresi dolmuş veya kullandıkça öde hakkı tükenmiş. Değişkenin opencode’u çalıştıran süreçte tanımlı olduğundan emin olun. - Model bulunamadı veya reddedildi. Eşleme anahtarını (
broadnet/glm-5.3) seçin vemodelIDdeğerinin BroadNet’in kimliğiyle birebir aynı olduğunu kontrol edin. Referanslar büyük-küçük harfe duyarlıdır. Ücretli modeller bakiye yüklemesi gerektirir; $5 kredi yalnızcabroadnet/gemma-4-26b-a4bmodelini kapsar. - Boş yanıtlar.
limit.outputdeğerini yükseltin. Yanıtlar neden boş geliyor. - 429. Kullandıkça öde anahtarları dakikada 30 isteğe ve aynı anda işlemde 4 isteğe izin verir. Yeniden denemeler de sayılır. Hatalar ve yeniden denemeler rehberine bakın.
- Bir planda alt ajanlar. Her plan oturumu aynı anda tek istek işler; bu yüzden her birinin kendi oturumu yoksa paralel alt ajanlar sıraya girer.
