OpenHands

Settings → LLM → Advanced üç alan alır — Custom Model, Base URL, API Key — model kimliğinde openai/ öneki bulunur ve temel URL /v1'i korur.

# Settings → LLM → Advanced  (toggle "Advanced" on first)
Custom Model   openai/claude-sonnet-5
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...

# The "openai/" prefix is the provider, not a vendor: it tells OpenHands to
# speak the OpenAI Chat Completions protocol to the Base URL above. The model
# id after the slash is Kunavo's, and resolves at Kunavo.
#
# Keep the /v1. It belongs to the openai/ prefix — a litellm_proxy/ model
# takes the bare origin instead, which is the opposite convention.

Adım adım

1. /app/keys adresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.
2. Ayarlar → LLM bölümünü açın ve Advanced anahtarını etkinleştirin. Üç alan şu sırayla görünür: Custom Model, Base URL, API Key.
3. Model kimliğini ön ekiyle yazın — openai/claude-sonnet-5, claude-sonnet-5 değil. Kunavo'nun sunduğu kimlikler, GET /v1/models isteğinin döndürdüğü kimliklerdir; OpenHands'ın kendi belgeleri de özel bir kimliği bu listeden almanızı söyler.
4. https://api.kunavo.com/v1 adresini Base URL alanına, anahtarınızı da API Key alanına yapıştırın; ardından Save Changes seçeneğine tıklayın. OpenHands, yerel bir profil kaydedilirken yapılandırmanın önce arka uca göre doğrulandığını ve doğrulama başarısızsa kaydın engellendiğini belirtir. Bu nedenle buradaki bir hata, yalnızca görünüşte değil, gerçekten bir ret anlamına gelir.
5. Tarayıcınızın erişebildiğini değil, arka ucun erişebildiğini kontrol edin. Temel URL'nin Agent Server'ı çalıştıran makineden çözümlenmesi gerekir — belgeler, Agent Canvas Docker'da çalışıyorsa 127.0.0.1 adresinin kapsayıcıyı ifade ettiğini açıkça belirtir. Kunavo gibi herkese açık bir uç nokta kolay durumdur; önünde kurumsal bir proxy varsa durum farklıdır.
6. Yeni bir yazışma başlatın ve ona bir dosyayı okuyup düzenleyecek görev verin. OpenHands, kaydedilmiş bir LLM'in yeni yazışmalara uygulandığını ve eski yazışmaların önce yeniden başlatılması gerektiğini belirtir. Araçları kullanan bir çalıştırma, bu eşleşme hakkında bir selamlaşmadan daha fazla bilgi verir.

OpenHands'ın Language Model (LLM) Settings 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 OpenHands 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ış.

Hata ayıklamadan önce bilmeniz gereken üç sınır

OpenHands, tek süreçli bir CLI'dan daha fazla bileşene sahiptir ve bunlardan ikisi LLM uç noktasına benzese de o değildir. Bu bilgiler, yukarıdaki tarihte incelenen kendi belgelerinden alınmıştır:

1. Korumalı alan model değildir. OpenHands, çalışmalarınızı bir aracı sunucu korumalı alanında yürütür ve ağ üzerinden modele çağrı yapar; bunlar farklı kimlik bilgilerine sahip ayrı arayüzlerdir. Burada yapılandırılan anahtar model çağrılarını sağlar. Korumalı alanın nereye erişebileceği konusunda hiçbir şeyi belirlemez; korumalı alanın ağ sorunu da kimlik doğrulama hatası gibi görünmez.
2. ACP aracıları tamamen ayrı tutulur. Agent Canvas, bir ACP aracısı olarak Claude Code, Codex veya Gemini CLI'ye görev devredebilir; Model Yapılandırma sayfası bunların “kendi model erişimlerini yönettiğini” belirtir. Dolayısıyla bir LLM profili bu alt sürecin yönlendirmesini değiştirmez. Anahtarınız üzerinden trafik bekliyor ama hiç görmüyorsanız hangi aracının çalıştığını kontrol edin. OpenHands ile Claude Code karşılaştırması, bunu belirleyen kimlik bilgisi önceliği kuralı da dahil olmak üzere bu ayrımı ele alır.
3. Profiller ve 10 profil sınırı. Kaydedilmiş bir yapılandırma LLM profiline dönüşür; en son kaydedilen profil yeni yazışmalarda etkin olur ve profiller, bağlamı kaybetmeden yazışma ortasında değiştirilebilir. Ucuz ve pahalı bir model kimliğini aynı anahtarla kullanmayı mümkün kılan mekanizma budur. Belgeler, hesap başına en fazla 10 profil olduğunu belirtir. Bir Sağlayıcı Bağlantısı, sağlayıcıyı, API anahtarını ve isteğe bağlı temel URL'yi birden fazla profil için bir kez saklar. Aynı sayfada, bu panelin yerel aracı sunucusu arka uçlarında kullanılabildiği, OpenHands Cloud arka ucunda ise gizlendiği belirtilir.