Dokümantasyon
Nanocoder
Nanocoder, uzak uç noktaları Ollama gibi ele alır: nanocoder.providers altında ad, temel URL, anahtar ve model listesinden oluşan tek bir kayıt bulunur. sdkProvider varsayılan olarak openai-compatible olduğundan başka bir şey tanımlamanız gerekmez.
agents.config.json içinde nanocoder.providers altında bir Custom Provider girdisi — name, baseUrl, apiKey, models — varsayılanı openai-compatible olduğundan sdkProvider satırı gerekmez.
{
"nanocoder": {
"providers": [
{
"name": "Kunavo",
"baseUrl": "https://api.kunavo.com/v1",
"apiKey": "${KUNAVO_API_KEY}",
"models": ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-sol"]
}
]
}
}/v1 son eki bulunmalıdır. Nanocoder belgelerinde bu konu bir kuralla değil, örnekle açıklığa kavuşturulur: alan tablosunda baseUrl yalnızca “API uç noktası URL’si” olarak tanımlanır; ancak Özel Sağlayıcı sayfasının kendi örneği "baseUrl": "https://my-api.example.com/v1" şeklindedir ve sitedeki OpenAI uyumlu tüm sağlayıcı sayfaları da aynı son eki kullanır — https://openrouter.ai/api/v1, http://localhost:11434/v1. Son eki kaldırırsanız anahtar için 401 değil, yol için 404 alırsınız.sdkProvider yukarıda bilerek yer almıyor; alan tablosuna göre varsayılan değeri “openai-compatible” ve Kunavo burada bu kablo biçiminde yanıt verir. Belgelenen diğer değerler (google, anthropic, github-copilot) farklı bir SDK kullanır; bunların hiçbiri bir chat completions uç noktasına ulaşmak için gerekli değildir.NANOCODER_PROVIDERS (veya NANOCODER_PROVIDERS_FILE), sonra çalışma dizinindeki agents.config.json, ardından kullanıcıya özel dosya — macOS’ta ~/Library/Preferences/nanocoder/, Linux’ta ~/.config/nanocoder/, Windows’ta %APPDATA%\nanocoder\. İlk bulunan geçerli olur. NANOCODER_CONFIG_DIR ayarlandığında proje ve ana dizin aramaları tamamen atlanır. Düzenlediğiniz anahtar gönderilen anahtar değilse, kontrol etmeniz gereken yer bu öncelik sırasıdır.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 Nanocoder kurulumunda açılır.Adım adım
/app/keysadresinde bir anahtar oluşturup kopyalayın; anahtar yalnızca bir kez gösterilir. Anahtarı dosyaya yapıştırmak yerineKUNAVO_API_KEYolarak dışa aktarın: Nanocoder, sağlayıcı kaydındaki tüm dizgelerde$VAR,${VAR}ve${VAR:-default}değişkenlerini özyinelemeli olarak işler ve çalışma dizinindeki.envdosyasını okur.- Nanocoder içinde
/settings providerskomutunu çalıştırın ve Custom Provider seçeneğini belirleyin. Sihirbaz şu alanları kendi sırasıyla ister: Provider name, Base URL, API key (optional), Model names ve Request timeout. Ayrıca model listesini uç noktadan almayı önerir; KunavoGET /v1/modelsyanıtı verdiğinden bu istek listeyi doldurur. - Sihirbazı atlayıp yukarıdaki blokla kendiniz
agents.config.jsondosyasını da yazabilirsiniz. Ayarların dosya bazında çözümlendiğini unutmayın: proje düzeyindeki dosyadananocoder.providerstanımlanmışsa, bloğun tamamı o dosyadan alınır ve genel yapılandırmanızdaki girdiler onunla birleştirilmez. - Bağlam penceresi belirleyin. Nanocoder sınırı sırasıyla
/context-max,contextWindows[model],contextWindow,NANOCODER_CONTEXT_LIMITve ardından models.dev üzerinden belirler. Kunavo bir models.dev sağlayıcısı olmadığından, ilk dört seçenekten biri ayarlanmadığında, bütçe modelinize ait olmayan varsayılan bir değere göre hesaplanır. Sayılar/modelsadresindedir. /modeluygulamasını açın, listelediğiniz kimliklerden birini seçin — seçicide bu kimlikler verdiğiniznamealtında görünür — ve araç çağırması gereken küçük bir işlem çalıştırın. Belirli bir modelde araç çağrıları hatalı biçimde dönüyorsadisableToolModelsbu özelliği sağlayıcı başına değil, model başına kapatır.
Nanocoder’ın Özel Sağlayıcı 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.
İ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 Nanocoder 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ış | Nanocoder içinde kullanım alanı |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | bir terminal ajanının düzenleme ve çalıştırma döngüsü için varsayılan çalışma modeli |
claude-haiku-4-5 | $0.70 / $3.50 | tur sayısının maliyeti belirlediği, araç kullanımının yoğun olduğu uzun oturumlar ve dosyaların hızlıca incelenmesi |
gpt-5-6-sol | $2.00 / $12.00 | aynı anahtarla başka bir aileden ikinci görüş |
claude-opus-5 | $3.50 / $17.50 | bir oturumdaki tek kapsamlı yeniden yapılandırma; yanlış bir planın maliyetli olduğu durum |
Sık sorulan sorular
Nanocoder özel bir API uç noktasını destekliyor mu?
Evet. Bu, belgelenmiş ve ilk tarafça sunulan bir özelliktir; belgelenmemiş bir alan değildir. Nanocoder’ın kendi “Custom Provider” sayfasında, OpenAI uyumlu API sunan tüm hizmetlerin özel sağlayıcı olarak eklenebileceği belirtilir ve yazılacak nesnenin name, baseUrl, apiKey ve models alanları gösterilir. Sağlayıcıyı /settings providers sihirbazıyla etkileşimli olarak veya agents.config.json dosyasına elle ekleyebilirsiniz. Bu bilgiler 21 Eylül 2026 tarihli belgelere dayanmaktadır.
Nanocoder API anahtarını nereye koymalıyım?
Anahtarı agents.config.json içindeki sağlayıcı girdisinin apiKey alanına koyun. Nanocoder, sağlayıcı yapılandırmalarındaki dizge alanlarında ortam değişkenlerini özyinelemeli olarak işler. Bu nedenle daha güvenli yöntem, değeri kabuğunuzda veya çalışma dizinindeki bir .env dosyasında dışa aktararak "apiKey": "${KUNAVO_API_KEY}" kullanmaktır. Ortam değişkeni üzerinden NANOCODER_PROVIDERS geçersiz kılmaları en yüksek önceliğe sahiptir; ardından proje düzeyindeki agents.config.json, sonra da kullanıcıya özel dosya gelir. Düzenleme etkisiz görünüyorsa, genellikle daha yüksek öncelikli bir ayar onu geçersiz kılıyordur.
Nanocoder baseUrl değerinin sonunda /v1 olmalı mı?
OpenAI uyumlu bir uç nokta için evet; örneğin https://api.kunavo.com/v1. Nanocoder belgeleri, metin içinde son ekle ilgili bir kural belirtmez; alan tablosunda baseUrl yalnızca API uç noktası URL’si olarak açıklanır. Ancak konu örnekle açıklığa kavuşur: Özel Sağlayıcı sayfasındaki örnekte https://my-api.example.com/v1 kullanılır ve sitedeki tüm OpenAI uyumlu sağlayıcı sayfalarında aynı son ek bulunur. /v1 eksik olduğunda kimlik doğrulama hatası yerine yolda 404 hatası alırsınız.
Nanocoder bu modeller için neden maliyet göstermiyor veya yanlış bağlam boyutu gösteriyor?
Çünkü Nanocoder model meta verilerini models.dev üzerinden okur ve listede bulunmayan üçüncü taraf bir ağ geçidi için orada bir kayıt yoktur. Belgelenen bağlam sınırı önceliği şöyledir: önce /context-max veya --context-max, ardından contextWindows[model], sonra contextWindow, sonra NANOCODER_CONTEXT_LIMIT ve son olarak models.dev. Bu nedenle sınırın doğru hesaplanması için sağlayıcı girdisinde ilk dört seçenekten birini ayarlayın. Yanıt başına maliyet rakamı, hangi durumda olursa olsun istemcinin bildirilen tokenlar üzerinden yaptığı kendi hesabıdır; alt bilgiye değil, sağlayıcınızın kendi kayıtlarına göre kontrol edin.