---
title: "opencode özel OpenAI uyumlu sağlayıcı kurulumu | BroadRouter"
description: "BroadNet Inference'ı opencode kodlama ajanına opencode.jsonc içinde özel OpenAI uyumlu sağlayıcı olarak ekleyin: model takma adları, yetenekler ve sınırlar."
url: https://broadrouter.com/tr/guides/opencode-custom-provider/
lang: tr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

İngilizceden yapay zekâ desteğiyle çevrilmiştir. [İngilizce aslını okuyun](https://broadrouter.com/guides/opencode-custom-provider/) (güncelleme: 2026-11-16).

# BroadNet Inference'ı opencode'a özel sağlayıcı olarak ekleyin

Güncellendi 2026-11-16

opencode.jsonc içinde providers altına bir broadnet girdisi ekleyin: package @opencode/ai/providers/openai-compatible, settings.baseURL https://inference.broadnet.ai/v1 ve env BROADNET\_API\_KEY. Kısa model anahtarlarını modelID ile broadnet/glm-5.3 gibi BroadNet kimliklerine eşleyin, ardından modeli /models ile seçin. npm @ai-sdk/openai-compatible ve options.baseURL kullanan eski V1 yapılandırmaları da çalışmaya devam eder.

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

1.  **Anahtarınızı** opencode’u başlatan kabukta dışa aktarın:

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **Yapılandırmayı oluşturun.** Projenize `opencode.jsonc` olarak koyun ya da her yerde kullanmak için `~/.config/opencode/opencode.jsonc` dosyasına yazın.

```jsonc
{
  "$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 }
        }
      }
    }
  }
}
```

3.  **opencode’u başlatın ve modeli** `/models` ile seçin. Referans `broadnet/<eşleme anahtarı>` biçimindedir, örneğin `broadnet/glm-5.3`. opencode BroadNet’e `modelID` değ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:

```json
{
  "$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](https://opencode.ai/docs/migrate-v1/) her alanın karşılığını gösterir.

## Hangi modeli seçmeli

| Görev | Model | Notlar |
| --- | --- | --- |
| Araçlarla ajan tabanlı kodlama | [GLM 5.3](https://broadrouter.com/tr/models/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](https://broadrouter.com/tr/models/qwen3.8-27b/) | Araçlar ve görseller; 262K bağlam |
| Gün boyu oturumlar, sabit fiyat | [DeepSeek V4.1 Flash](https://broadrouter.com/tr/models/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_KEY` iç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 ve `modelID` değ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ızca `broadnet/gemma-4-26b-a4b` modelini kapsar.
-   **Boş yanıtlar.** `limit.output` değerini yükseltin. [Yanıtlar neden boş geliyor](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/).
-   **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](https://broadrouter.com/tr/guides/errors-and-retries/) rehberine bakın.
-   **Bir planda alt ajanlar.** Her [plan oturumu](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/) aynı anda tek istek işler; bu yüzden her birinin kendi oturumu yoksa paralel alt ajanlar sıraya girer.

## Bu rehberdeki terimler

[Kullandıkça öde (pay-as-you-go)](https://broadrouter.com/tr/glossary/pay-as-you-go/)

Kullandıkça öde, abonelik veya asgari taahhüt olmadan yalnızca kullandığınız kadar ödediğiniz, token, istek veya ses dakikası gibi birimler üzerinden ölçülen bir fiyatlandırma modelidir. LLM API'lerinin çoğu bu şekilde, ön ödemeli bir bakiyeden veya dönemsel faturayla ücretlendirir.

[Eşzamanlılık (concurrency)](https://broadrouter.com/tr/glossary/concurrency/)

Eşzamanlılık (concurrency), bir istemcinin aynı anda işlemde olan istek sayısıdır. LLM API'leri bunu genellikle dakikadaki istek sayısından ayrı olarak anahtar veya plan başına sınırlar, çünkü açık her istek yanıtı bitene kadar GPU kapasitesi tutar.

[Token](https://broadrouter.com/tr/glossary/token/)

Token, bir dil modelinin okuduğu ve yazdığı metin birimidir: modelin tokenizer'ının ürettiği bir kelime, kelime parçası, noktalama işareti veya bayt dizisi. LLM API'leri kullanımı token cinsinden sayar, sınırlar ve genellikle faturalandırır.

[Chat Completions API](https://broadrouter.com/tr/glossary/chat-completions-api/)

Chat Completions API, OpenAI'nin bir model adı ile rollerle etiketlenmiş mesaj listesini alıp modelin sonraki mesajını döndüren HTTP uç noktasıdır: POST /v1/chat/completions. İstek ve yanıt yapısı, OpenAI uyumlu sağlayıcıların ve SDK'ların yeniden kullandığı ortak format hâline geldi.

[Girdi ve çıktı token'ları](https://broadrouter.com/tr/glossary/input-and-output-tokens/)

Girdi token'ları, bir dil modelinin istekte okuduğu token'lardır: sistem istemi, konuşma geçmişi, araç tanımları ve görseller dahil. Çıktı token'ları ise modelin yanıt olarak ürettikleridir, akıl yürütme dahil. LLM API'leri bunları genellikle ayrı fiyatlandırır ve çıktı genellikle daha pahalıdır.

[Hız sınırı (rate limit)](https://broadrouter.com/tr/glossary/rate-limit/)

Hız sınırı (rate limit), bir API'nin bir istemcinin belirli bir zaman aralığındaki kullanımına koyduğu üst sınırdır; örneğin dakika başına istek veya dakika başına token. Sınırı aşan istekler, kullanım tekrar sınırın altına inene kadar genellikle HTTP 429 Too Many Requests ile reddedilir.

[Yapay zekâ kodlama ajanı (AI coding agent)](https://broadrouter.com/tr/glossary/coding-agent/)

Yapay zekâ kodlama ajanı, bir dil modelinin bir kod tabanı üzerinde döngü içinde çalıştığı bir yazılım aracıdır: dosyaları okur, düzenler, testler gibi komutları çalıştırır, çıktıyı okur ve görev bitene ya da bir sınıra ulaşılana kadar bir sonraki adıma karar verir.

[Yapılandırılmış çıktı (structured output)](https://broadrouter.com/tr/glossary/structured-output/)

Yapılandırılmış çıktı, modelin yanıtını geliştiricinin belirlediği bir biçimle, genellikle bir JSON Schema ile sınırlayan bir LLM API özelliğidir; böylece kod yanıtı güvenilir şekilde ayrıştırabilir. Geçerli JSON'u garanti eden ama belirli bir yapıyı garanti etmeyen JSON modundan daha katıdır.

## Sık sorulan sorular

### opencode BroadNet modelimi neden bulamıyor?

opencode referansı sağlayıcı/eşleme anahtarı olarak çözer ve kimlikler büyük-küçük harfe duyarlıdır. Aşağıdaki yapılandırmayla broadnet/glm-5.3 seçin; burada glm-5.3 eşleme anahtarıdır. modelID değeri yalnızca BroadNet'e gönderilen kimliktir.

### Yapılandırmam @ai-sdk/openai-compatible ile provider ve npm kullanıyor. Bu yanlış mı?

Hayır. Bu V1 formatıdır ve opencode'un geçiş rehberine göre desteklenmeye devam ediyor. Yerel V2 biçiminde provider, providers olur; npm, package olur (aisdk:@ai-sdk/openai-compatible); options.baseURL de settings.baseURL olur.

### opencode yanıtları neden boş geliyor?

Model çıktı bütçesini akıl yürütmeye harcamış. Modelin limit.output değerini yükseltin. BroadNet'te akıl yürütme max\_tokens sınırına dahildir.

## İlgili rehberler

-   [Cline'ı BroadNet Inference ile kullanın (OpenAI Compatible sağlayıcı)](https://broadrouter.com/tr/guides/cline-openai-compatible/)
-   [Ajanlar için sınırsız LLM API planları nasıl çalışır?](https://broadrouter.com/tr/guides/unlimited-llm-api-sessions/)
-   [Akıl yürüten model neden boş yanıt döndürür?](https://broadrouter.com/tr/guides/reasoning-tokens-empty-response/)
-   [Vercel AI SDK'yı BroadNet Inference ile kullanın](https://broadrouter.com/tr/guides/vercel-ai-sdk-openai-compatible/)
-   [BroadNet Inference ile çalışan tüm araçlar (İngilizce)](https://broadrouter.com/integrations/): SDK'lar, kodlama ajanları, sohbet arayüzleri ve otomasyon araçları, her biri için tam ayarlarıyla

Gerçek iş yükünüzle deneyin. Yeni hesaplar şunlar için US$5 kredi ile başlar: Gemma ve transkripsiyon. Bakiye yüklemesi gerekenler: DeepSeek, GLM ve Qwen3.8.

[Başlayın](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-opencode-custom-provider&utm_content=page-cta) ·

**Kaynaklar**

-   [opencode belgeleri, Providers (özel sağlayıcı) (2026-11-14 tarihinde kontrol edildi)](https://opencode.ai/docs/providers/)
-   [opencode belgeleri, Models (takma adlar, yetenekler, sınırlar) (2026-11-14 tarihinde kontrol edildi)](https://opencode.ai/docs/models/)
-   [opencode belgeleri, Config konumları (2026-11-14 tarihinde kontrol edildi)](https://opencode.ai/docs/config/)
-   [opencode belgeleri, V1'den geçiş (2026-11-14 tarihinde kontrol edildi)](https://opencode.ai/docs/migrate-v1/)
-   [BroadNet Inference API referansı (İngilizce)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=tr-guides-opencode-custom-provider&utm_content=sources)
