BroadRouter

Kodlama ajanlarında açık modeller: Aider, Cline, opencode, Codex

BroadNet Inference ekibi · 4 dk okuma · Yayımlandı · Güncellendi

Her büyük kodlama ajanı özel bir model için üç değer alır: temel URL, API anahtarı ve model kimliği. Aider OPENAI_API_BASE, Cline ve Roo Code OpenAI Compatible sağlayıcısı, opencode özel bir sağlayıcı, Continue apiBase kullanır. Codex CLI artık yalnızca Responses API'yi konuşuyor; bu yüzden chat completions uç noktası için LiteLLM gibi çeviri yapan bir proxy gerekir.

A developer working at a laptop with code on screen, at dusk.

Kodlama ajanları bir iki büyük sağlayıcı için yapıldı, ama artık neredeyse hepsi özel bir OpenAI uyumlu uç nokta kabul ediyor. Bu da onları açık modellerle çalıştırmanızı sağlar: görev başına daha ucuz, çoğu zaman daha geniş bağlamla ve sizin seçtiğiniz altyapıda. Bu sayfa bir harita. Her ajan için tam ayar adlarını veriyor ve elimizde varsa adım adım rehbere bağlanıyor.

Sağlayıcıdan neye ihtiyacınız var?

Aşağıdaki her ajan aynı üç değere ihtiyaç duyar:

Değer BroadNet Inference
Temel URL https://inference.broadnet.ai/v1
API anahtarı Kullandıkça öde veya plan anahtarınız
Model kimliği broadnet/glm-5.3, broadnet/deepseek-v4.1-flash veya broadnet/qwen3.8-27b

Her ajan için iki ayar daha önemli: bağlam penceresi ve en fazla çıktı token’ı. Ajanlar özel model kimlikleri için bunları algılayamaz, bu yüzden tahmin eder. Bunları modeller sayfasına göre ayarlayın.

Ajan ajan: tam ayarlar

Ajan Nerede ayarlanır Temel URL alanı Model alanı Tam rehber
Aider Ortam değişkenleri OPENAI_API_BASE --model openai/<id> Aider rehberi
Cline Settings, API Provider: OpenAI Compatible Base URL Model Cline rehberi
Roo Code / Zoo Code Settings, API Provider: OpenAI Compatible Base URL Model Roo Code rehberi
opencode opencode.jsonc, providers settings.baseURL models.<key>.modelID opencode rehberi
Continue config.yaml, provider: openai apiBase model Continue rehberi
Codex CLI config.toml, [model_providers.<id>] base_url model Aşağıya bakın

Aider

export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY=your-key
aider --model openai/broadnet/deepseek-v4.1-flash

openai/ öneki Aider’a OpenAI uyumlu yolu kullanmasını söyler. Aider, modelin bağlam boyutunu bilmediği konusunda uyarabilir; listesi dışındaki modeller için bu beklenen bir durumdur.

Cline

API Provider olarak OpenAI Compatible seçin, ardından Base URL, API Key ve Model alanlarını doldurun. Model Configuration bölümünü açın ve bağlam penceresini ve en fazla çıktı token’ını ayarlayın. Cline, Plan ve Act modları için farklı modeller kullanabilir; bu, pahalı modeli planlamaya ayırmanın ucuz bir yoludur.

Roo Code ve Zoo Code

Roo Code’un deposu 15 Mayıs 2026’da arşivlendi ve README’si eklentinin kapatıldığını söylüyor. Roo Code topluluğunun başlattığı ve geliştirmesini sürdüren bir çatal (fork) olan Zoo Code’a ve Cline’a yönlendiriyor. Mevcut Roo Code kurulumları Cline ile aynı OpenAI Compatible alanlarını kullanır; Roo’nun değişiklik günlüğü eski XML araç çağırmanın kaldırıldığını gösteriyor, bu yüzden yerel araç çağırması listelenmiş bir model seçin. Zoo Code için kendi belgelerini izleyin.

opencode

opencode, sağlayıcıları opencode.jsonc içinde providers altına, OpenAI uyumlu paket ve settings.baseURL ile ekler. BroadNet kimlikleri zaten bir eğik çizgi içerdiğinden glm-5.3 gibi kısa bir eşleme anahtarı kullanın ve tam kimliği modelID alanına yazın. capabilities ve limit değerlerini kendiniz ayarlayın; aksi halde opencode varsayımlara geri döner.

Continue

models:
  - name: GLM 5.3
    provider: openai
    model: broadnet/glm-5.3
    apiBase: https://inference.broadnet.ai/v1
    apiKey: your-key
    capabilities: [tool_use]
    defaultCompletionOptions:
      contextLength: 1048576
      maxTokens: 8000

Continue, Agent modu için tool_use gerektirir. Araç çağırması olmayan modellerde bunu çıkarın.

Codex CLI

Codex, sağlayıcıları config.toml içinde base_url ve env_key ile tanımlar. Güncel yapılandırma referansı, desteklenen tek wire_api değerinin responses olduğunu söylüyor ve Codex artık wire_api = "chat" değerini hata vererek reddediyor. BroadNet Inference /v1/chat/completions sunduğu için Codex onu doğrudan çağıramaz. Geçici çözüm, çeviri yapan bir proxy’dir. LiteLLM belgelerine göre proxy’si /v1/responses sunar ve bunu chat completions üzerinden köprüleyebilir:

  1. LiteLLM proxy’sini BroadNet’i OpenAI uyumlu arka uç olarak kullanacak şekilde çalıştırın ve LiteLLM’in Responses API sayfasında anlatıldığı gibi chat completions köprüsünü açın.
  2. Codex’in base_url değerini proxy’ye yönlendirin.
  3. Kısa bir görevi test edin. Köprüler yalnızca Responses’a özgü özellikleri düşürebilir; araç çağrılarının uçtan uca çalıştığını kontrol edin.

Bu size fazla tesisat işi gibi geliyorsa, opencode ve Aider chat completions’ı doğrudan konuşan terminal ajanlarıdır.

Uç noktayı ajandan önce nasıl test edersiniz?

Bir ajan başarısız olduğunda sorunun ajanda mı uç noktada mı olduğunu anlamak zordur. Önce uç noktayı tek başına, bir araç sunan tek bir istekle kontrol edin:

curl -s https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"broadnet/glm-5.3","max_tokens":2000,
       "messages":[{"role":"user","content":"Read the file README.md"}],
       "tools":[{"type":"function","function":{"name":"read_file",
         "parameters":{"type":"object","properties":{"path":{"type":"string"}},"required":["path"]}}}]}'

Yanıtta finish_reason: "tool_calls" ve bir read_file çağrısı varsa model ve anahtar sorunsuzdur; kalan sorun ajanın ayarlarındadır. Düz metinle yanıt veriyorsa araçla çalışan ajanlar için başka bir model seçin. API istek oluşturucu bu isteği sizin için curl, Python veya Node olarak yazar.

En sık ne bozulur?

  1. Yanlış model kimliği. broadnet/ öneki dahil birebir kopyalayın.
  2. Boş yanıtlar. Üç büyük modelin hepsi yanıt vermeden önce akıl yürütür ve akıl yürütme çıktı sınırına sayılır. Sınırı yükseltin. Yanıtlar neden boş gelir.
  3. Araç çağrısı hataları. Araç çağırması listelenmiş bir model kullanın. BroadNet araçları GLM 5.3 ve Qwen3.8 27B için listeliyor, DeepSeek V4.1 Flash için listelemiyor. Ayrıntılar açık modellerle araç çağırma yazısında.
  4. 429 hataları. Kullandıkça öde anahtarı dakikada 30 isteğe ve aynı anda 4 uçuştaki isteğe izin verir. Aynı anahtarı kullanan iki editör penceresi birbirine eklenir. Bkz. hatalar ve yeniden denemeler.
  5. Varsayılan olarak Responses API. Bazı araçlar varsayılan olarak OpenAI’ın daha yeni API’sini kullanır. İzin verdikleri yerde chat completions’a geçirin.

Hangi ajan için hangi modelin seçileceği kodlama ajanları için en iyi açık model yazısında. En popüler üç ajanın farkları Cline, Roo Code ve Aider karşılaştırmasında.

BroadNet Inference nereye oturuyor?

BroadNet Inference, yukarıdaki her ajana GLM 5.3, DeepSeek V4.1 Flash ve Qwen3.8 27B için sıfır veri saklamalı tek bir OpenAI uyumlu uç nokta sunar. Sınırsız planları DeepSeek V4.1 Flash’ı oturum başına ayda sabit $60 yapar; bu da Aider’a ve gün boyu çalışan diğer ajanlara uyar. Proxy olmadan Codex CLI için doğrudan yerine geçmez ve web araması gibi sağlayıcı tarafı araçlar barındırmaz. inference.broadnet.ai adresinde bir anahtarla başlayın.

Sık sorulan sorular

Codex CLI'ı OpenAI uyumlu bir API ile kullanabilir miyim?

Yalnızca uç nokta Responses API'yi konuşuyorsa. Codex'in yapılandırma referansı, desteklenen tek wire_api değeri olarak responses'ı listeliyor. Yalnızca chat completions sunan bir sağlayıcı için önüne LiteLLM gibi bir proxy koyun; LiteLLM belgeleri /v1/responses isteklerinin /v1/chat/completions üzerinden köprülenmesini anlatıyor.

Roo Code hâlâ geliştiriliyor mu?

Hayır. GitHub deposu 15 Mayıs 2026'da arşivlendi ve README eklentinin kapatıldığını söylüyor. Kullanıcıları, README'nin Roo Code topluluğunun başlattığı bir çatal (fork) olarak tanımladığı Zoo Code'a ve Cline'a yönlendiriyor.

Ajanım neden model bulunamadı diyor?

Model kimliği sağlayıcının kimliğiyle birebir eşleşmeli. BroadNet kimlikleri bir önek içerir; örneğin broadnet/glm-5.3. Aider'da bunun önüne ayrıca openai/ önekini eklersiniz.

Ajan açık bir modelle neden boş yanıt döndürüyor?

Akıl yürütme modelleri çıktı bütçesinin bir kısmını düşünmeye harcar. En fazla çıktı token'ı sınırı küçükse görünür yanıt hiç başlamaz. Sınırı birkaç bin token'a çıkarın.

Kodlama ajanımda hangi açık modeli kullanmalıyım?

Araç çağrılarıyla çalışan ajanlar için GLM 5.3 gibi araç çağırması listelenmiş bir model kullanın. Aider için DeepSeek V4.1 Flash iyi çalışır ve BroadNet'in sınırsız planları kapsamındadır.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor