Dokümantasyon

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.

~/.config/zed/settings.json
{
  "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
          }
        ]
      }
    }
  }
}
API anahtarı bu dosyaya konmaz. Zed belgelerinde bu açıkça belirtilir — anahtarı Agent Panel sağlayıcı ayarlarına girin veya Zed'in sağlayıcı adı için oluşturduğu ortam değişkenini ayarlayın. settings.json eşitlenir ve paylaşılır; dosyadaki bir anahtar onunla birlikte paylaşılır.
Zed açısından tüm katalog 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.
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 Zed 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.
  2. Komut paletinden zed: open settings komutunu kullanarak settings.json dosyasını açın ve yukarıdaki bloğu ekleyin.
  3. Agent Panel ayarlarını açın, anahtar olarak kullandığınız adın (kunavo burada) altında sağlayıcıyı bulun ve API anahtarını buraya yapıştırın.
  4. Agent Panel'in model seçicisinde modeli seçin — burada display_name'i gösterir ve name'i gönderir.
  5. Yalnızca Zed'in varsayılanlarından farklı olan capabilities değerlerini geçersiz kılın; varsayılan ayar tools: 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ğiKunavo giriş / çıkışZed içinde kullanım alanı
claude-sonnet-5$1.40 / $7.00aracılar ve görseller açık, aracının varsayılanı
claude-opus-5$3.50 / $17.50planın hızdan daha önemli olduğu büyük yeniden düzenlemeler
claude-haiku-4-5$0.70 / $3.50satır içi yardımlar ve hızlı düzenlemeler
gpt-5-6-terra$0.70 / $4.20aynı sağlayıcı kaydının arkasında ikinci bir aile
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

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.