OpenClaude’a LLMTR gateway girdisi ekleme ve model keşfi

Girdi hangi depoda ve hangi dalda duruyor

Bu entegrasyon bir ortam değişkeni numarası değil, kaynak ağacında duran bir kayıt. knowhycodata/openclaude deposunda feat/add-llmtr-provider dalında, src/integrations/gateways/llmtr.ts dosyasında tanımlı. Kaydı üreten yardımcı defineGateway, yani LLMTR aracın gateway listesine kendi girdisiyle katılıyor.

Bunu açıkça söylemek gerekiyor: dal upstream’e merge edilmedi. OpenClaude’un resmi sürümünü kurup gateway listesine bakarsanız orada LLMTR göremezsiniz. Denemek için knowhycodata/openclaude deposundaki feat/add-llmtr-provider dalını almanız ve kendi kopyanızı çalıştırmanız gerekir.

Kaydın üst düzey alanları kimliği ve varsayılanları belirliyor. Kategori toplayıcı olarak işaretli, taban adres gateway’in OpenAI uyumlu kökü, model yönlendirme açık. Varsayılan model olarak global bir geçiş rotası seçilmiş; kaynaktaki yorum bunu taze bir kurulumda geniş kullanılabilirlik gerekçesiyle açıklıyor.

src/integrations/gateways/llmtr.ts dosyasındaki kaydın üst düzey alanları

export default defineGateway({
  id: 'llmtr',
  label: 'LLMTR',
  category: 'aggregating',
  defaultBaseUrl: 'https://llmtr.com/v1',
  defaultModel: 'anthropic/claude-sonnet-4.6',
  supportsModelRouting: true,
  // setup, startup, transportConfig, preset,
  // validation, catalog ve usage alanları izliyor
})

Anahtar yalnızca kendi değişkeninden okunuyor

Kayıttaki en dikkate değer güvenlik kararı kimlik yalıtımı. Kurulum bölümü anahtar tabanlı doğrulama istiyor ve anahtarı tek bir değişkenden, LLMTR_API_KEY üzerinden okuyor. Yanına konan bayrak, genel bir OpenAI anahtarına geri düşmeyi kapatıyor; kaynaktaki yorum gerekçeyi doğrudan yazıyor, çünkü aksi halde başka bir sağlayıcı için tutulan kimlik bilgisi llmtr.com adresine gönderilmiş olurdu.

Taşıma katmanı OpenAI uyumlu bir kabuk üzerinden kuruluyor ve gereken biçim sohbet tamamlama olarak sabitlenmiş. Çıktı sınırı max_tokens alanıyla gönderiliyor, kimlik ise yalnızca Authorization başlığıyla taşınıyor; ek kimlik başlıkları kapalı. Doğrulama tarafı da aynı yalıtımı sürdürüyor: kayıt varsayılan taban adrese ve llmtr.com sunucu adına eşleşiyor, anahtar eksikse mesaj hangi değişkenin doldurulması gerektiğini adıyla söylüyor.

Kaydın beklediği tek kimlik değişkeni

export LLMTR_API_KEY=llmtr-your_key

Model listesi melez bir katalogla doluyor

Katalog kaynağı melez olarak işaretli: dosyada elle yazılmış tohum girdiler var, geri kalanı çalışma anında model listesi ucundan çekiliyor. Kaynaktaki yorum bunun gerekçesini de veriyor; gateway yüzlerce rota sunduğu için hepsini sabit bir listede tutmak anlamlı değil.

Keşif anahtarsız yapılıyor. Katalog her kimlik için aynı olduğundan kaydın açıklaması gizli bilgi göndermemeyi ve önbelleği anahtara göre bölmemeyi tercih ediyor. Önbellek bir gün tutuluyor, yenileme bayat kayıt için arka planda çalışıyor ve elle yenilemeye de izin veriliyor.

Asıl ayırt edici kısım eşleme fonksiyonundaki filtre. LLMTR’nin model listesi gömme, görüntü, ses, video ve yeniden sıralama gibi işlemleri de tarif ettiği için, bir kodlama ajanı oturumunda işe yaramayacak rotalar burada eleniyor. Bir kayıt üç koşulu birden sağlamıyorsa listeye hiç girmiyor.

• Desteklenen operasyonlar arasında sohbet tamamlama bulunmalı
• Desteklenen uçlar arasında sohbet tamamlama ucu bulunmalı
• Desteklenen parametreler arasında araç tanımı bulunmalı
• Üçü sağlandığında görüntü ve akıl yürütme yetenekleri kayıttan türetilerek işaretlenir
• Bağlam penceresi ve tek yanıt sınırı da aynı kayıttan okunur

Keşfin uyguladığı araç filtresini elle sınama

curl -s "https://llmtr.com/v1/models?supported_parameters=tools" \
  | grep -o '"id":"[^"]*"' \
  | head -20

Takma adlar seçimi yeniden başlatmada koruyor

Tohum girdilerin her birinde birden fazla ad geçiyor ve bunları karıştırmamak gerekiyor. Katalog kimliği aracın kendi iç anahtarı, tel adı ise istekte gönderilen canonical LLMTR kimliği. Bunların yanında bir tanımlayıcı kimlik ve isteğe bağlı takma adlar var.

Takma adların varlığı bir hata düzeltmesi. Kaynaktaki yorum, model desteğini sınayan fonksiyonun tel adına, katalog kimliğine ve takma adlara baktığını, tanımlayıcı kimliğe bakmadığını söylüyor. Takma ad yazılmasaydı tanımlayıcı kimlikle yapılmış bir seçim aracı yeniden başlattığınızda kaybolurdu. Nokta içeren sürüm numaralarının tire ile yazılmış karşılıkları da bu yüzden listede duruyor.

Varsayılan model ve Türkiye’de barındırılan rotalar

Varsayılan olarak global bir geçiş rotası seçilmiş. Kaynaktaki yorum bu tercihi gerekçelendiriyor: gateway çok satıcılı olduğu için taze bir kurulumda geniş kullanılabilirliği olan bir rota daha makul bir başlangıç noktası. Türkiye’de barındırılan llmtr ön ekli modeller ise seçicide bir seçim uzakta duruyor.

Bu ayrımı kurulumda bilinçli yapmak işe yarar. Geçiş rotaları satıcı çeşitliliği ve tanıdık davranış getirir; llmtr ön ekli rotalar ise LLMTR’nin kendi altyapısında çalışır ve gateway’i genel bir vekilden ayıran taraf odur. Tohum listede bu ikinci kümeden gemma ve muse glimmer girdileri bulunuyor; katalogda başka llmtr rotaları da var ve keşif onları da listeye taşıyor.

Ön ayar bölümü ayrıca bir model ortam değişkeni tanımlıyor ve satıcı kimliğini openai olarak işaretliyor. Bu, aracın OpenAI uyumlu yolu kullandığını gösteren bir etiket; anahtarın nereden okunacağını değiştirmez, çünkü kimlik yalıtımı bayrağı ayrıca duruyor.

Kaydın söylemediği şey: kullanım raporu

Kaydın son alanı kullanım raporlamasını kapalı olarak işaretliyor. Yani OpenClaude arayüzünde bu gateway için token tüketimi veya harcama özeti beklemeyin. Ücretlendirme token bazlı işlediği için tüketimi izlemek isteyen ekiplerin bunu panel tarafından takip etmesi gerekir; araç bu bilgiyi göstermeyecek.

Kurulumu bitirdikten sonra iki şeyi sırayla kontrol edin. Önce açılıştaki hazırlık sınaması: model listesi ucuna gidilir, dönmüyorsa taban adres veya ağ tarafında bir sorun vardır. Sonra ilk model seçimi: liste geliyor ama beklediğiniz kimlik listede yoksa muhtemelen üç koşullu filtreye takılmıştır, örneğin araç tanımı desteklemeyen bir rota seçmişsinizdir.

• Kullanım raporlaması kapalı, tüketim araç içinde görünmez
• Anahtar eksikse mesaj doldurulması gereken değişkeni adıyla söyler
• Liste boş dönüyorsa önce taban adresi ve ağ erişimini sınayın
• Beklenen model listede yoksa araç desteği koşulunu doğrulayın

Sık sorulan sorular

OpenClaude’un resmi sürümünde LLMTR girdisini bulamıyorum, neden?

Çünkü değişiklik upstream’e merge edilmedi. Girdi knowhycodata/openclaude deposunda feat/add-llmtr-provider dalında, src/integrations/gateways/llmtr.ts dosyasında duruyor. Denemek için o dalı almanız ve kendi kopyanızı çalıştırmanız gerekir.

Neden mevcut OpenAI anahtarım kullanılmıyor?

Kayıt yalnızca kendi kimlik değişkenini okuyacak şekilde yapılandırılmış ve genel anahtara geri düşmek açıkça kapatılmış. Gerekçe kaynakta yazılı: aksi halde başka bir sağlayıcı için tutulan kimlik bilgisi bu gateway’e gönderilmiş olurdu. Anahtarı LLMTR_API_KEY değişkenine yazın.

Katalogdaki bazı modeller neden seçicide görünmüyor?

Keşif eşlemesi üç koşul arıyor: modelin sohbet tamamlama operasyonunu desteklemesi, aynı ucu sunması ve araç tanımı parametresini kabul etmesi. Gömme, görüntü, ses veya video rotaları bu filtreden geçmez, çünkü kodlama ajanı oturumunda kullanılamazlar.

Model seçimim yeniden başlatınca neden korunuyor?

Tohum girdilerdeki takma adlar bunun için var. Model desteğini sınayan fonksiyon tel adına, katalog kimliğine ve takma adlara bakıyor; tanımlayıcı kimliğe bakmıyor. Takma ad tanımlı olduğu sürece tanımlayıcı kimlikle yapılmış bir seçim de yeniden başlatmadan sonra tanınıyor.

İlgili yazılar

• LLMTR entegre geliştirici araçları: 21 aracın bağlanma biçimi
• OpenCode yapılandırmasında LLMTR sağlayıcı bloğu ve model adları
• Codex CLI için LLMTR model sağlayıcısı: Responses zorunluluğu

• Model katalogu
• Chat Completions rehberi
• API anahtarlari
• Fiyatlandirma