Dokumentasi

Dokumentasi

Zed

Zed mendeklarasikan penyedia yang kompatibel dengan OpenAI di settings.json dan menerima kunci secara terpisah melalui Agent Panel. Array models bukan sekadar kemudahan — array tersebut adalah seluruh daftar model yang akan dikenal Zed.

Blok language_models.openai_compatible di settings.json mendeklarasikan endpoint dan modelnya; key dimasukkan di UI Agent Panel, tidak pernah di file.

~/.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
          }
        ]
      }
    }
  }
}
Kunci API tidak dimasukkan ke file ini. Dokumentasi Zed menyatakannya secara langsung — masukkan kunci di pengaturan penyedia Agent Panel, atau atur variabel lingkungan yang dibuat Zed untuk nama penyedia tersebut. settings.json disinkronkan dan dibagikan; kunci yang dimasukkan ke dalamnya akan ikut terbawa.
available_models adalah seluruh katalog menurut Zed — tidak ada panggilan penemuan untuk penyedia yang kompatibel dengan OpenAI, jadi model yang tidak Anda cantumkan tidak akan muncul di pemilih. Tambahkan satu entri untuk setiap ID yang ingin digunakan, dengan max_tokens diatur ke jendela konteks asli model tersebut.
Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Zed.

Langkah demi langkah

  1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
  2. Buka settings.json melalui zed: open settings dari palet perintah, lalu tambahkan blok di atas.
  3. Buka pengaturan Agent Panel, cari penyedia dengan nama yang Anda gunakan sebagai kunci (kunavo di sini), lalu tempel kunci API di sana.
  4. Pilih model di pemilih model Agent Panel — pemilih itu menampilkan display_name, dan mengirimkan name.
  5. Ganti hanya capabilities yang berbeda dari nilai bawaan Zed; nilai bawaannya adalah tools: true, dengan images dan parallel tool calls dinonaktifkan.

Diperiksa terhadap Dokumentasi akses API Zed pada 6 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Zed.

# 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-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

ID modelKunavo masuk / keluarKegunaannya di Zed
claude-sonnet-5$1.40 / $7.00pilihan bawaan agent — tools dan images aktif
claude-opus-5$3.50 / $17.50refaktor besar, saat rencana lebih penting daripada kecepatan
claude-haiku-4-5$0.70 / $3.50bantuan inline dan pengeditan cepat
gpt-5-6-terra$0.70 / $4.20keluarga kedua di balik entri penyedia yang sama
Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Pertanyaan umum

Bagaimana cara menambahkan penyedia yang kompatibel dengan OpenAI ke Zed?

Tambahkan blok language_models.openai_compatible ke settings.json dengan nama penyedia sebagai kunci, api_url yang mengarah ke root /v1 endpoint, dan array available_models yang mencantumkan ID setiap model yang Anda inginkan. Lalu buka pengaturan penyedia Agent Panel dan masukkan kunci API di sana. Dokumentasi Zed menegaskan bahwa kunci tidak boleh berada di settings.json.

Mengapa model tidak muncul di pemilih model Zed?

Karena model tersebut tidak ada di available_models. Zed tidak menanyakan katalog ke endpoint yang kompatibel dengan OpenAI, sehingga array dalam settings.json adalah daftar lengkap model yang ditawarkan penyedia tersebut. Tambahkan entri dengan ID model sebagai name, display_name untuk pemilih, dan max_tokens yang diatur ke jendela konteks aslinya.

Di mana Zed menyimpan kunci API untuk penyedia kustom?

Di UI pengaturan penyedia pada Agent Panel, atau di variabel lingkungan yang dibuat Zed dari nama penyedia — bukan di settings.json. Zed sengaja menyimpan kredensial di luar file pengaturan, karena file tersebut ditujukan agar portabel dan dapat dibagikan, sedangkan kunci tidak.

Bisakah Zed menggunakan model Claude melalui endpoint kustom?

Ya. Penyedia openai_compatible meneruskan nama model langsung ke api_url, sehingga ID Claude ditentukan oleh endpoint, bukan oleh Zed. Atur capabilities.tools ke true untuk model yang mendukung pemanggilan tool — ini adalah nilai bawaan Zed untuk jenis penyedia ini — dan agent akan bekerja sama seperti saat menggunakan penyedia pihak pertama.