Dokümantasyon

Qoder

Bağımsız Qoder masaüstü uygulaması, Provider → Custom altında istenen bir Base URL'yi kabul eder. Üç alanı ve elle yazılmış bir model kimliğini doldurduğunuzda Qoder, tek bir anahtarla Claude ve GPT'ye bağlanır; bu modeller kendi kataloğunda görünmez.

Qoder Settings → Models → + Add → Provider → Custom, OpenAI uyumlu bir Base URL, API Key ve elle girilen Model IDs alır — böylece bağımsız Qoder masaüstü uygulaması Claude ve GPT'ye ulaşır; ikisi de kendi kataloğunda bulunmaz.

Qoder Ayarları → Modeller → + Ekle → Sağlayıcı → Özel

Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model

Bu, bağımsız Qoder uygulamasıdır; Qoder IDE değildir. “Qoder”, belgeleri ayrı ayrı yayımlanan ürünlerden oluşan bir ailedir ve istenen bir uç noktanın kullanılabileceğini yalnızca bağımsız masaüstü uygulamasının belgeleri açıklar: özel modeller sayfasında OpenAI Compatible ve Anthropic Compatible seçenekleri Custom altında yer alır. 5 Eylül 2026 tarihli 0.1.8 sürüm notunda bu özellik “Personal plan BYOK artık OpenAI veya Anthropic uyumlu tüm model hizmetleri için özel Base URL'leri destekliyor” ifadesiyle duyurulmuştur. Qoder IDE'nin özel modeller sayfasında yalnızca adı belirtilmiş sağlayıcılar listelenir ve Base URL dizesi hiçbir yerde geçmez. Alanı ekranınızda göremiyorsanız muhtemelen başka bir Qoder ürünündesiniz.

Base URL sonunda /v1 ekini içerir. Qoder'ın sayfası “model hizmetinin sağladığı Base URL'nin aynısını girin” der ve örnek biçim olarak https://api.example.com/v1 adresini gösterir. Dolayısıyla OpenAI uyumlu bir uç nokta için alan, yalnızca sunucu adresini değil, /v1 ile biten kök adresi bekler. Bu, https://api.kunavo.com isteyen ve rotayı kendileri ekleyen Anthropic tarzı istemcilerin tersidir.

Qoder ayrıca Anthropic Compatible özel sağlayıcısını sunar ve Kunavo /v1/messages isteklerini de yanıtlar. Belgelerinde tek bir Base URL örneği yayımlanır ve her protokolün hangi rotayı eklediği belirtilmez; bu yüzden söz konusu türün https://api.kunavo.com mi yoksa https://api.kunavo.com/v1 mi istediği açıklığa kavuşmuyor. Yukarıdaki OpenAI uyumlu yol, Qoder'ın kendi örneğinin işaret ettiği yoldur; bunun yerine Anthropic türünü seçerseniz iki biçimi de denemeyi bekleyin. Qoder'ın sorun giderme listesi tam olarak bu noktadan başlar: “Base URL'nin eksiksiz olup olmadığı ve seçilen uyumlu protokol ile API türünün uç noktayla eşleşip eşleşmediği.”

Kunavo, Qoder içinde oturum başlatmadı. Buradaki hiçbir şey istemcinin çalışma zamanında test edildiği anlamına gelmez: alan adları aşağıdaki tarihte Qoder'ın kendi sayfasından aktarılmıştır; uç nokta tarafındaki bilgiler ise Kunavo'nun yayımladığı arayüze dayanır. İkiliyi gerçekten kontrol eden adım, kendi makinenizde çalışan Validate and Add Model düğmesidir.

Henüz anahtarınız yok mu? Bir Kunavo hesabı oluşturun, bir anahtar oluşturun ( sk-kn- ile başlar) ve $10'dan kredi ekleyin — çağrılar bu bakiyeden ödenir ve başarısız çağrılar ücretlendirilmez. Ardından kontrol paneli Qoder kurulumunda açılır.

Adım adım

/app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
Qoder Settings'i açın, soldaki gezinme menüsünden Models'i seçin ve + Add'e tıklayın.
Provider bölümünü açın ve OpenAI Compatible seçeneğini Custom altından seçin; üstündeki önceden ayarlanmış sağlayıcılardan birini seçmeyin. Ardından API türü olarak Chat Completions API seçeneğini seçin.
Base URL, API Key ve en az bir Model ID girin. Qoder bu alan için model listesi keşfi belgelemediğinden kimlikleri kendiniz yazın. Aynı uç noktada ek model varsa her biri için Add Model ID'ye tıklayın.
Next'e tıklayın ve Qoder'ın kendiliğinden belirleyemediği özellikleri ayarlayın: Display name, Supported Context Windows, bu değerlerden bir Default Context Window ve modelin desteklediği durumlarda Vision ile Thinking Mode seçenekleri.
Validate and Add Model'e tıklayın. Qoder'ın model seçici sayfasında, eklendikten sonra “modelin task, Agent ve automation model seçicilerinde kullanılabilir olduğu” belirtiliyor.

bağımsız Qoder uygulamasının özel modeller sayfası ile 21 Eylül 2026 tarihinde kontrol edilmiştir. Üçüncü taraf ayarları değişebilir; buradaki alan adı gördüğünüzle artık eşleşmiyorsa yetkili kaynak bu sayfa değil, ilgili sayfadır.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber Qoder ve Claude Code — hangi Qoder, hangi uç nokta, hangi fatura içindedir.

İstemcide hata ayıklamadan önce doğrulayın

Tek bir istek, hatanın uç noktadan mı, anahtardan mı yoksa yapılandırma dosyasından mı kaynaklandığını kesinleştirir. Bu JSON döndürürse aynı temel URL ve anahtar Qoder içinde çalışır.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Alana hangi model kimliği yazılmalı

Her metin modeline model kimliğiyle erişilebilir — güncel liste GET /v1/models, fiyatları içeren katalog ise modeller sayfasında. Ücretler 1 milyon token başına USD cinsindendir; giriş / çıkış.

Model kimliği	Kunavo giriş / çıkış	Qoder içinde kullanım alanı
`claude-sonnet-5`	$1.40 / $7.00	task ve Agent seçicileri için varsayılan çalışma modeli
`claude-opus-5`	$3.50 / $17.50	yanlış planın maliyetinin belirteçlerden fazla olduğu büyük ölçekli yeniden düzenlemeler
`claude-haiku-4-5`	$0.70 / $3.50	sayının belirleyici olduğu yüksek hacimli otomasyon çalıştırmaları
`gpt-5-6-sol`	$2.00 / $12.00	aynı anahtar ve aynı uç noktayla farklı bir aileden ikinci bir görüş

Faturalandırma aylık ücret olmadan, ön ödemeli bakiyeden token başına yapılır — faturalandırmaya bakın. Tekrarlanan bağlamda — bir düzenleyicinin veya sohbet istemcisinin gönderdiği içeriğin çoğu budur — istem önbellekleme, faturayı model seçiminden daha fazla değiştirir.

Qoder'ınızda neden Base URL alanı olmayabilir?

Qoder'ın üç arayüzünde kendi anahtarını getirme (BYOK) desteği belgelenmiştir; ancak seçtiğiniz bir uç nokta yalnızca birinde belgelenir. Yukarıdaki kurulumu bulunduğunuz yerde yapıp yapamayacağınızı belirleyen tek nokta budur; bu yüzden bir yapılandırma dosyasına dokunmadan önce kontrol etmenizde fayda var. Üstelik CLI sayfası yapılandırma dosyasına dokunmamanızı açıkça söylüyor.

Arayüz	Özel Base URL belgelenmiş mi?	Kendi sayfasında ne yazıyor?
Qoder (bağımsız uygulama)	Evet	`OpenAI Compatible` ve `Anthropic Compatible`, Provider listesindeki Custom altında, Base URL, API Key ve elle girilen Model ID değerleriyle birlikte bulunur. Bu sayfa.
Qoder IDE	Hayır	Özel modeller sayfasında “Uygulanabilir olduğu planlar: Individuals kullanıcıları” ifadesi yer alır ve Alibaba Cloud Model Studio, DeepSeek, Z.ai, Kimi, MiniMax ve Xiaomi MIMO gibi sağlayıcılar listelenir. `Base URL` dizesi sayfada bulunmaz.
Qoder CLI	Belgeler sayfasında yok	`/model` altında `Add custom model...` içeren bir Custom sekmesi vardır, ancak sayfada Base URL belgelenmemiştir ve “BYOK'u `settings.json` dosyasında elle yapılandırmayın” uyarısı bulunur.

CLI kafa karıştırıcıdır; çünkü kendi sürüm notları ile kendi belgeleri birbiriyle uyuşmaz. 11 Eylül 2026 tarihli 1.1.50 sürüm notunda “Personal sürümü kullanıcıları artık Custom sayfasından özel URL uç noktalarına sahip BYOK modellerini merkezi olarak yapılandırıp yönetebilir” denirken, bu sürüm notundan sonra da mevcut olan özel modeller sayfasında bunun yerine bir katalog anlatılır: “Kullanılabilir sağlayıcılar, modeller ve kimlik bilgisi alanları, mevcut hesaba sunulan BYOK kataloğu tarafından belirlenir.” IDE sayfasıyla birlikte her iki kaynak da bu özelliği Individual plan ile sınırlar. Dolayısıyla Custom sekmesi görünmüyorsa ya da uç nokta alanı içermiyorsa kontrol edilmesi gereken, bir yapılandırma dosyası değil, hesabın planı ve o hesabın kataloğunda neler sunulduğudur. CLI sayfası bu dosyayı elle düzenlememenizi söyler; dosya zaten katalogdan yeniden oluşturulur.

Sık sorulan sorular

Qoder'a özel bir sağlayıcıyı nasıl eklerim?

Bağımsız Qoder masaüstü uygulamasında: Qoder Settings'i açın, soldaki gezinme menüsünden Models'i seçin, + Add'e tıklayın; ardından Provider'ı açıp Custom altında “OpenAI Compatible” veya “Anthropic Compatible” seçeneğini belirleyin. OpenAI türünde ayrıca Chat Completions API veya Responses API'yi seçin. Base URL, API Key ve en az bir Model ID girin; aynı uç noktadaki ek modeller için Add Model ID'yi kullanın. Display name, Supported Context Windows, Default Context Window, Vision ve Thinking Mode değerlerini ayarlamak için Next'e tıklayın, ardından Validate and Add Model'e tıklayın. Qoder kaydetmeden önce bağlantıyı doğrular.

Qoder Base URL değerinin sonunda /v1 bulunması gerekir mi?

OpenAI uyumlu bir uç nokta için evet. Qoder'ın özel modeller sayfası model hizmetinin sağladığı Base URL'nin aynısını girmenizi söylüyor ve örnek biçim olarak https://api.example.com/v1 adresini gösteriyor. Dolayısıyla alan yalın ana makine adresi yerine /v1 kökünü ister; Kunavo için bu https://api.kunavo.com/v1 olur. Anthropic Compatible türü için sayfada ayrı bir örnek yok ve hangi rotanın eklendiği belirtilmiyor; belgeler bu durumu açıklığa kavuşturmuyor. Doğrulama başarısız olursa önce /v1 kökünü, ardından yalın ana makine adresini deneyin.

Qoder'ımda neden Custom sekmesi veya Base URL alanı yok?

Çünkü Qoder'ın üç arayüzünde BYOK kuralları farklıdır. İstenen Base URL'yi yalnızca bağımsız Qoder masaüstü uygulaması destekler. Qoder IDE'nin özel modeller sayfasında adı belirtilen sağlayıcılar listelenir ve Base URL'den söz edilmez. Qoder CLI sayfasında ise kullanılabilir sağlayıcı, model ve kimlik bilgisi alanlarının mevcut hesaba sunulan BYOK kataloğu tarafından belirlendiği yazılıdır. Hem IDE hem CLI sayfaları bu özelliği Individual plan ile de sınırlar. Alan görünmüyorsa hangi Qoder ürününün açık olduğunu ve hesap planınızın ve kataloğun neler sunduğunu kontrol edin. CLI sayfası özellikle BYOK'u settings.json içinde elle yapılandırmamanız konusunda uyarır.

Qoder, Anthropic hesabı olmadan Claude modellerini kullanabilir mi?

Özel bir sağlayıcı aracılığıyla evet; Qoder'ın yerleşik kataloğu ayrı bir konudur. Model seçici sayfasında Qwen, DeepSeek, GLM, Kimi ve MiniMax modelleri listeleniyor; Claude, GPT veya Gemini modellerinden söz edilmiyor. Bu nedenle kendi anahtarınızı getirmek, bir modeli kullanmak için belgelenmiş yoldur. Buradaki “OpenAI Compatible”, bir satıcıyı değil kablo üzerindeki protokolü belirtir: yazdığınız Model ID, yapılandırdığınız Base URL'de çözümlenir. Dolayısıyla uç nokta Claude modelini sunuyorsa Claude kimliği çalışır; kullandığınız kimlik bilgileri Anthropic'e değil o uç noktaya aittir.

Qoder'da özel model kullanmak yine de Qoder Credits tüketir mi?

Qoder'ın özel modeller sayfasında özel model ücretlerinin doğrudan sağlayıcının API hesabına faturalandırıldığı ve Qoder Credits kullanmadığı belirtiliyor. İstisna, sabit bir model kullandığı ve ayrı faturalandırıldığı belirtilen Repo Wiki'dir; oluşturma sırasında da bir istem gösterilir. Kunavo tarafındaki ücret ise aylık ücret olmaksızın ön ödemeli bakiyeden belirteç başına alınır. Ayrıca Qoder'da kayıtlı bir özel modelin Edit işleminin yalnızca API anahtarını güncellediğini unutmayın: Base URL'yi değiştirmek için girdiyi silip yeniden eklemeniz gerekir.

Kunavo, Qoder içinde bu kurulumu test etti mi?

Hayır. Kunavo hiçbir Qoder arayüzünde oturum başlatmadı; bu sayfa çalışma zamanı uyumluluk raporu değildir. Alan adları ve sıraları, aşağıda belirtilen tarihte Qoder'ın kendi özel modeller sayfasından aktarılmıştır; uç nokta tarafındaki bilgiler Kunavo'nun yayımladığı API'ye dayanır. Gerekli kontrol sizin makinenizde yapılır: Qoder'ın Validate and Add Model düğmesi kaydetmeden önce Base URL'yi, anahtarı ve Model ID'yi birlikte sınar. Aynı Base URL ve anahtarla yapılan basit bir curl isteği de sorunun uç noktadan mı yoksa istemciden mi kaynaklandığını gösterir.