Dokümantasyon

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.

agents.config.json
{
  "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"]
      }
    ]
  }
}
Kunavo, Nanocoder’ı bu uç noktaya bağlayarak çalıştırmamıştır. Yukarıdaki her alan, burada tamamlanmış bir oturumdan değil, doğrudan Nanocoder’ın kendi Özel Sağlayıcı sayfasından aktarılmıştır; bu bir yapılandırma başvuru kaynağıdır, uyumluluk testi değildir. Önce kapsamı sınırlı, küçük bir görev çalıştırın ve bunu yaparken kullanabileceğiniz başka bir yol bulundurun.
Temel URL’de /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.
Hangi yapılandırmanın geçerli olduğunu üç arama sırasıyla belirler: önce 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.
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 Nanocoder kurulumunda açılır.

Adım adım

  1. /app/keys adresinde bir anahtar oluşturup kopyalayın; anahtar yalnızca bir kez gösterilir. Anahtarı dosyaya yapıştırmak yerine KUNAVO_API_KEY olarak 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 .env dosyasını okur.
  2. Nanocoder içinde /settings providers komutunu ç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; Kunavo GET /v1/models yanıtı verdiğinden bu istek listeyi doldurur.
  3. Sihirbazı atlayıp yukarıdaki blokla kendiniz agents.config.json dosyasını da yazabilirsiniz. Ayarların dosya bazında çözümlendiğini unutmayın: proje düzeyindeki dosyada nanocoder.providers tanımlanmışsa, bloğun tamamı o dosyadan alınır ve genel yapılandırmanızdaki girdiler onunla birleştirilmez.
  4. Bağlam penceresi belirleyin. Nanocoder sınırı sırasıyla /context-max, contextWindows[model], contextWindow, NANOCODER_CONTEXT_LIMIT ve 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 /models adresindedir.
  5. /model uygulamasını açın, listelediğiniz kimliklerden birini seçin — seçicide bu kimlikler verdiğiniz name altı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üyorsa disableToolModels bu ö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.

Kısa sürüm budur. Model seçimi, gerçek bir oturumun maliyeti ve hata durumlarını içeren tam rehber Nanocoder ve OpenCode karşılaştırması — sağlayıcı ayarlarına ek olarak her birinin maliyeti 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 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ğiKunavo giriş / çıkışNanocoder içinde kullanım alanı
claude-sonnet-5$1.40 / $7.00bir 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.50tur 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.00aynı anahtarla başka bir aileden ikinci görüş
claude-opus-5$3.50 / $17.50bir oturumdaki tek kapsamlı yeniden yapılandırma; yanlış bir planın maliyetli olduğu durum
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.

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.