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.
{
"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 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.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
- Buat key di
/app/keysdan salin — key hanya ditampilkan sekali. - Buka
settings.jsonmelalui zed: open settings dari palet perintah, lalu tambahkan blok di atas. - Buka pengaturan Agent Panel, cari penyedia dengan nama yang Anda gunakan sebagai kunci (
kunavodi sini), lalu tempel kunci API di sana. - Pilih model di pemilih model Agent Panel — pemilih itu menampilkan
display_name, dan mengirimkanname. - Ganti hanya
capabilitiesyang berbeda dari nilai bawaan Zed; nilai bawaannya adalahtools: 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 model | Kunavo masuk / keluar | Kegunaannya di Zed |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | pilihan bawaan agent — tools dan images aktif |
claude-opus-5 | $3.50 / $17.50 | refaktor besar, saat rencana lebih penting daripada kecepatan |
claude-haiku-4-5 | $0.70 / $3.50 | bantuan inline dan pengeditan cepat |
gpt-5-6-terra | $0.70 / $4.20 | keluarga kedua di balik entri penyedia yang sama |
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.