Dokümantasyon
Zed
Zed, settings.json içinde OpenAI uyumlu bir sağlayıcı tanımlar ve anahtarı Agent Panel üzerinden ayrı olarak alır. models dizisi kolaylık amaçlı değildir — Zed'in tanıyacağı modellerin tamamı bu listededir.
settings.json içindeki language_models.openai_compatible bloğu uç noktayı ve modellerini tanımlar; anahtar Agent Panel arayüzüne girilir, dosyaya asla yazılmaz.
{
"language_models": {
"openai_compatible": {
"kunavo": {
"api_url": "https://api.kunavo.com/v1",
"available_models": [
{
"name": "claude-sonnet-5",
"display_name": "Claude Sonnet 5",
"max_tokens": 200000,
"max_output_tokens": 64000,
"capabilities": { "tools": true, "images": true }
},
{
"name": "claude-haiku-4-5",
"display_name": "Claude Haiku 4.5",
"max_tokens": 200000
}
]
}
}
}
}settings.json eşitlenir ve paylaşılır; dosyadaki bir anahtar onunla birlikte paylaşılır.available_models'dir — OpenAI uyumlu bir sağlayıcı için keşif çağrısı yapılmaz; bu nedenle listelemediğiniz bir model seçicide görünmez. Kullanmayı düşündüğünüz her kimlik için bir kayıt ekleyin ve max_tokens alanını modelin gerçek bağlam penceresine ayarlayın.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 Zed kurulumunda açılır.Adım adım
/app/keysadresinde bir anahtar oluşturup kopyalayın — anahtar yalnızca bir kez gösterilir.- Komut paletinden zed: open settings komutunu kullanarak
settings.jsondosyasını açın ve yukarıdaki bloğu ekleyin. - Agent Panel ayarlarını açın, anahtar olarak kullandığınız adın (
kunavoburada) altında sağlayıcıyı bulun ve API anahtarını buraya yapıştırın. - Agent Panel'in model seçicisinde modeli seçin — burada
display_name'i gösterir vename'i gönderir. - Yalnızca Zed'in varsayılanlarından farklı olan
capabilitiesdeğerlerini geçersiz kılın; varsayılan ayartools: trueşeklindedir, görseller ve paralel araç çağrıları kapalıdır.
Zed'in API erişimi belgeleri ile 6 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 Zed 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ış | Zed içinde kullanım alanı |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | aracılar ve görseller açık, aracının varsayılanı |
claude-opus-5 | $3.50 / $17.50 | planın hızdan daha önemli olduğu büyük yeniden düzenlemeler |
claude-haiku-4-5 | $0.70 / $3.50 | satır içi yardımlar ve hızlı düzenlemeler |
gpt-5-6-terra | $0.70 / $4.20 | aynı sağlayıcı kaydının arkasında ikinci bir aile |
Sık sorulan sorular
Zed'e OpenAI uyumlu bir sağlayıcıyı nasıl eklerim?
settings.json dosyasına, sağlayıcı adınızı anahtar olarak kullanan bir language_models.openai_compatible bloğu ekleyin; api_url değerini uç noktanın /v1 köküne yönlendirin ve kullanmak istediğiniz her model kimliğini available_models dizisinde listeleyin. Ardından Agent Panel sağlayıcı ayarlarını açıp API anahtarını girin. Zed belgeleri, anahtarların settings.json dosyasına konmaması gerektiğini açıkça belirtir.
Bir model neden Zed'in model seçicisinde görünmüyor?
Çünkü available_models içinde yoktur. Zed, kataloğu için OpenAI uyumlu bir uç noktayı sorgulamaz; settings.json içindeki dizi, bu sağlayıcının sunduğu modellerin eksiksiz listesidir. Modelin kimliğini name olarak, seçicide görünecek adı display_name olarak ve gerçek bağlam penceresini max_tokens olarak belirten bir kayıt ekleyin.
Zed özel sağlayıcının API anahtarını nerede saklar?
Agent Panel'in sağlayıcı ayarları arayüzünde veya sağlayıcı adından Zed'in oluşturduğu ortam değişkeninde — settings.json içinde değil. Zed kimlik bilgilerini bilerek ayarlar dosyasının dışında tutar; çünkü bu dosyanın taşınabilir ve paylaşılabilir olması amaçlanırken anahtarın böyle olması istenmez.
Zed, özel bir uç nokta üzerinden Claude modellerini kullanabilir mi?
Evet. openai_compatible sağlayıcısı model adını doğrudan api_url adresine gönderir; dolayısıyla Claude kimliği Zed tarafından değil, uç nokta tarafından çözümlenir. Araç çağrısını destekleyen modeller için capabilities.tools değerini true olarak ayarlayın — bu, Zed'in bu sağlayıcı türü için varsayılanıdır — ve aracı birinci taraf sağlayıcıyla olduğu gibi çalışır.