Zed ingin ganti model? Sambungkan ke APIYI dengan endpoint kompatibel OpenAI: 2 konfigurasi Provider

Catatan penulis: Pahami dulu tiga jalur Agent di Zed, lalu hubungkan APIYI ke Zed memakai dua Provider kustom—OpenAI-compatible dan Anthropic-compatible—sambil menjelaskan Base URL, ID model, harga, dan poin troubleshooting.

Saat menulis kode di Zed lewat panel Agent atau Inline Assistant, Anda ingin mengganti ke model lain, tetapi menemukan beberapa pintu masuk di halaman pengaturan—LLM Providers, External Agents, dan terminal thread—dan tidak yakin di mana kunci API harus diisi. Kasus yang lebih umum: Anda mengisi gateway pihak ketiga, lalu terus mendapat 404 atau gagal autentikasi. Artikel ini memaparkan cara lengkap menghubungkan gateway model pihak ketiga ke Zed dengan Provider kustom (OpenAI-compatible / Anthropic-compatible), menggunakan APIYI sebagai contoh untuk menuntaskan alur konfigurasi.

Ini bukan sekadar panduan cepat “salin-tempel konfigurasi, selesai”. Artikel ini lebih dulu menjelaskan batas integrasi model pada masing-masing dari tiga jalur AI di Zed, lalu memberikan dua rute yang bisa diikuti. Detail yang paling mudah salah—kapan Base URL perlu ditambah /v1 dan kapan tidak—akan dibahas terpisah.

Nilai inti: Setelah membaca artikel ini, Anda bisa menentukan lapisan konfigurasi mana yang perlu diubah, dan dalam 5 menit membuat Agent di Zed memakai model seperti claude-opus-5-5 dan claude-sonnet-5-5. Kalau muncul masalah, Anda juga tahu item mana yang harus diperiksa lebih dulu.

---

Poin inti mengganti model di Zed: pahami dulu tiga jalur Agent

Zed adalah editor kolaboratif multipengguna berperforma tinggi yang dibuat oleh tim asli Atom / Tree-sitter. Per 13 November 2026, repositori GitHub zed-industries/zed memiliki sekitar 94.884 star (pengamatan GitHub API). Halaman releases resmi menunjukkan bahwa versi stabil per 11 November 2026 adalah 1.28.1, dan Preview pada hari yang sama adalah 1.29.1. macOS, Linux, dan Windows dapat diunduh langsung; versi Web belum tersedia secara resmi.

Sebelum mengganti model di Zed, pahami dulu satu hal: dokumentasi resmi membagi kemampuan AI menjadi tiga jalur, dan cara memasukkan model serta cara autentikasi di setiap jalur berbeda. Jika salah mengisi tempatnya, konfigurasi tidak akan berlaku, dan kunci tidak akan dibaca oleh jalur lain.

Jalur	Dari mana model berasal	Siapa yang mengelola autentikasi	Penggunaan umum
Zed Agent	LLM Providers (hosting Zed, kunci vendor, langganan, gateway, model lokal)	Zed sendiri; kunci disimpan di keychain sistem	Panel Agent, Inline Assistant, alat bawaan / profiles / skills / MCP
External Agents (ACP)	Agent eksternal memilih modelnya sendiri	Dikelola sendiri oleh Agent eksternal	Menjalankan Claude Agent, Codex, OpenCode, Copilot, Cursor, dan lainnya di thread Zed
Terminal Threads	Ditentukan oleh CLI / TUI yang Anda jalankan	Konfigurasi CLI itu sendiri	Menjalankan berbagai Agent CLI langsung di thread terminal

Batas integrasi Zed Agent dan External Agent

“Mengganti model untuk Zed Agent” berarti mengonfigurasi LLM Providers, yaitu lapisan API Access; inilah fokus utama artikel ini. Vendor utama yang didukung resmi meliputi Anthropic, OpenAI, Google AI, Mistral, DeepSeek, xAI, dan OpenCode; selain itu juga tersedia dua endpoint kustom: Anthropic-compatible dan OpenAI-compatible. Gateway pihak ketiga terhubung melalui kedua jenis endpoint kustom ini.

Jika Anda hanya ingin menggunakan Claude Agent atau OpenCode di panel, itu termasuk External Agent dan menggunakan Agent Client Protocol (ACP). Dalam kasus ini, thread dikelola oleh Zed, sedangkan runtime, autentikasi, dan pemilihan model biasanya menjadi tanggung jawab Agent eksternal itu sendiri. Kunci yang Anda isi di LLM Providers tidak otomatis dibagikan kepadanya; Claude Agent perlu menjalankan /login di thread-nya sendiri. Agent eksternal dapat diinstal dengan membuka registry melalui command palette zed: acp registry. Menurut dokumentasi resmi, Zed tidak menagih biaya terpisah untuk External Agents; tagihan ditangani oleh penyedia Agent.

---

Poin Inti Konfigurasi Provider Kustom Zed

Perbedaan antara kedua jenis endpoint kustom ini terutama terletak pada format permintaannya. OpenAI-compatible memakai Chat Completions, sedangkan Anthropic-compatible memakai Messages API (/v1/messages). Perbedaan ini langsung menentukan bagaimana Base URL harus ditulis, sekaligus menentukan apakah kita bisa memanfaatkan penagihan Prompt Cache.

Item konfigurasi	OpenAI-compatible	Anthropic-compatible
Format permintaan	/v1/chat/completions	/v1/messages
api_url APIYI	https://api.apiyi.com/v1	https://api.apiyi.com (tanpa /v1)
Bidang model	available_models[].name + max_tokens	available_models
Sakelar kemampuan	default tools=true, images=false, chat_completions=true	dapat dikonfigurasi capabilities.prompt_caching
Penagihan cache	dokumentasi APIYI menyatakan tidak berlaku	berlaku dalam format Messages native
Skenario yang cocok	ingin memakai satu Provider untuk beberapa model	terutama memakai Claude, konteks panjang, butuh cache

Mengapa Base URL yang Satu Ditambah /v1, yang Lain Tidak

Menurut FAQ Base URL APIYI (pengecekan dokumen 2026-11-13), klien yang kompatibel dengan OpenAI akan langsung menempelkan /chat/completions di belakang api_url, jadi api_url perlu ditulis sampai level /v1. Sementara itu, klien di sisi Anthropic menempelkan /v1/messages sendiri, sehingga yang diisi hanya domain root. Kalau ditulis https://api.apiyi.com/v1, permintaan akhirnya akan menjadi /v1/v1/messages dan langsung mengembalikan 404.

Ada dua hal lagi yang perlu diperhatikan. Kunci API Zed disimpan di keychain sistem, bukan ditulis ke settings.json; kalau variabel lingkungan yang bersesuaian tidak kosong, variabel lingkungan tersebut yang akan dipakai alih-alih keychain. Selain itu, untuk model yang hanya mendukung antarmuka Responses, capabilities.chat_completions harus disetel ke false, kalau tidak Zed akan memanggilnya lewat Chat Completions.

---

Panduan Cepat Menghubungkan Zed ke APIYI

Anda bisa memilih salah satu dari dua jalur berikut, atau memasang keduanya lalu beralih di pemilih model. Siapkan kunci API sebelum mulai.

🚀 Mulai cepat: setelah masuk, buat token di halaman token APIYI api.apiyi.com/token. Sebaiknya buat satu token khusus untuk Zed agar mudah memantau penggunaan dan mencabutnya kapan saja. Dokumentasi mulai cepat di docs.apiyi.com/getting-started juga menyediakan skill.md / llms.txt agar Agent dapat membaca penjelasan platform.

Jalur A: Menghubungkan Zed lewat endpoint OpenAI-compatible

1. Buka pengaturan Agent: jalankan agent: open settings dari command palette. Nama entri antarmuka bisa sedikit berbeda antar versi; patokannya adalah blok LLM Providers di halaman pengaturan AI / Agent.
2. Di blok LLM Providers, klik Add Provider, lalu pilih jenis OpenAI-compatible.
3. Beri nama Provider sendiri, misalnya apiyi; ini akan menjadi language_models.openai_compatible.apiyi di settings.json.
4. Isi API URL dengan https://api.apiyi.com/v1. Di sini /v1 wajib disertakan; ini juga format yang diberikan halaman kompatibilitas OpenAI APIYI.
5. Tempel token yang baru dibuat ke API Key; Zed akan menyimpannya di keychain sistem.
6. Tambahkan model: isi kolom name dengan ID asli dari tabel model APIYI, misalnya claude-opus-5-5, claude-sonnet-5-5, atau bisa juga menambahkan claude-fable-5-2. Isi max_tokens sesuai dokumentasi model; jika belum yakin, pakai nilai konservatif dulu, lalu naikkan setelah berhasil.
7. Biarkan sakelar kemampuan pada default (tools=true). Buka images secara manual saat perlu mengirim gambar.
8. Kembali ke panel Agent, cari apiyi atau nama model di pemilih model. Versi terbaru pemilih model sudah mendukung pencarian fuzzy; setelah dipilih, kirim satu pesan untuk verifikasi.

Keuntungan jalur ini adalah satu Provider bisa menampung beberapa model. Dokumentasi APIYI menjelaskan bahwa endpoint kompatibel OpenAI /v1/chat/completions hanya perlu mengubah satu string model untuk berganti model.

Rute B: Menghubungkan Zed lewat endpoint Anthropic-compatible

1. Sama seperti sebelumnya, buka LLM Providers → Add Provider, lalu pilih Anthropic-compatible sebagai jenisnya.
2. Isi API URL dengan https://api.apiyi.com, hanya tulis domain root, jangan tambahkan /v1. Permintaan yang sebenarnya akan masuk ke endpoint native Anthropic milik APIYI di https://api.apiyi.com/v1/messages.
3. Tempel token yang sama, atau buat token khusus terpisah.
4. Tambahkan claude-opus-5-5, claude-sonnet-5-5, dan ID lain di available_models.
5. Jika ingin percakapan dengan konteks panjang dapat memanfaatkan cache, aktifkan capabilities.prompt_caching. Sesuai penjelasan di halaman kemampuan Claude APIYI, penagihan cache hanya berlaku pada format Messages native.
6. Pilih model tersebut di pemilih model, lalu kirim satu pesan untuk pengujian.

💡 Saran pemilihan: Jika keseharian Anda didominasi Claude, sesi panjang, dan sering membaca ulang kumpulan file yang sama, Rute B lebih hemat. Jika perlu sering berpindah antar beberapa model, Rute A lebih praktis. Kedua rute bisa memakai token APIYI yang sama, dan Anda dapat beralih sesuai tugas di pemilih model Zed.

Referensi harga model Claude (tanggal data 2026-11-13)

Data berikut berasal dari tabel model lengkap APIYI, diperiksa terhadap dokumentasi pada 2026-11-13, dengan satuan dolar AS / per 1M token, penagihan sesuai penggunaan.

ID model	Input	Output	Baca cache	Endpoint didukung	Platform tersedia
claude-opus-5-5	$4	$20	$0.2	chat + messages	APIYI apiyi.com
claude-opus-5-5-thinking	Sama dengan opus-5-5	Sama dengan opus-5-5	Sama dengan opus-5-5	Mengacu pada tabel lengkap	APIYI apiyi.com
claude-sonnet-5-5	$2	$10	$0.1	Mengacu pada tabel lengkap	APIYI apiyi.com
claude-fable-5-2	$8	$40	$0.2	Mengacu pada tabel lengkap	APIYI apiyi.com

Model dan harga mengacu pada daftar model platform. Sebelum melakukan konfigurasi, Anda dapat membuka docs.apiyi.com/models untuk memeriksa angka dan grup pada hari tersebut (pada tabel lengkap, kolom claude-opus-5-5 berisi grup seperti ClaudeCode, Claude_Reverse, Claude_Enterprise, Default, SVIP, dan lain-lain).

Mengenai batasan penggunaan claude-opus-5-5, pembaruan peluncuran APIYI (2026-09-23) menyebutkan tiga hal: mode thinking tidak dapat diatur ke disabled; jika tool_choice diatur ke any / tool akan mengembalikan 400; effort default medium. Jika Zed Agent memunculkan 400 saat memanggil tool, periksa dulu poin-poin ini.

Penanganan Kesalahan Umum pada Endpoint Kustom Zed

Ketika Provider kustom bermasalah, sebagian besar penyebabnya ada di tiga hal: URL, Key, dan nama model. Tabel di bawah ini diurutkan berdasarkan frekuensi kemunculan, jadi bisa diperiksa satu per satu.

Gejala	Penyebab umum	Cara penanganan
404 Not Found	Pada Anthropic-compatible diisi /v1, sehingga path menjadi /v1/v1/messages	Kembalikan ke domain root https://api.apiyi.com
404 / path salah	Pada OpenAI-compatible kurang /v1	Ubah menjadi https://api.apiyi.com/v1
401 / autentikasi gagal	Token salah, sudah dihapus, atau variabel environment menimpa keychain	Periksa ulang di api.apiyi.com/token, kosongkan variabel environment yang konflik
Model tidak ditemukan	ID salah ketik atau memakai alias	Salin ID asli dari docs.apiyi.com/models
400 (pemanggilan tool)	tool_choice bernilai any / tool, atau mencoba mematikan thinking	Sesuaikan dengan keterangan rilis yang berlaku
Gambar tidak valid	OpenAI-compatible default images=false	Aktifkan images di capabilities
Model yang hanya mendukung Responses memberi error	Masih dipanggil lewat Chat Completions	Set capabilities.chat_completions menjadi false

🎯 Saran troubleshooting: Saat muncul 404, bandingkan dulu api_url di pengaturan Zed dengan FAQ Base URL APIYI (docs.apiyi.com/faq/base-url-config) kata per kata. Sebagian besar masalah muncul karena /v1 ditulis kelebihan atau kurang satu kali.

---

Peringatan risiko penggunaan Provider kustom di Zed

• Bukan layanan resmi: Provider kustom OpenAI-compatible / Anthropic-compatible adalah kemampuan akses generik yang disediakan Zed; gateway pihak ketiga bukan layanan resmi Zed. Jika terjadi masalah layanan, Anda perlu menghubungi pihak gateway.
• Key dan tagihan menjadi tanggung jawab Anda: Token dan penagihan penggunaan berada di akun Anda sendiri. Sebaiknya buat token khusus untuk Zed, periksa penggunaan secara berkala, dan jangan menuliskan Key ke settings.json lalu meng-commit-nya ke repositori. Zed secara default menyimpan menggunakan keychain, yang memang sudah menurunkan risiko ini.
• Ketentuan External Agent ditentukan penyedia: Langganan, kuota, dan ketentuan penggunaan External Agent seperti Claude Agent, Codex, dan lain-lain ditentukan oleh penyedia masing-masing, dan independen dari konfigurasi Provider Zed Agent.
• Perbedaan versi: Deskripsi antarmuka dalam artikel ini didasarkan pada dokumentasi resmi dan informasi releases versi 1.28.x / 1.29.x (tanggal pengamatan 2026-11-13). Nama entri pada versi selanjutnya mungkin dapat berubah.

---

FAQ Pertanyaan Umum

Q1: Apa itu endpoint kompatibel OpenAI di Zed?

Itu adalah salah satu tipe Provider kustom di LLM Providers. Selama sisi server mengimplementasikan antarmuka Chat Completions, Anda dapat terhubung ke Zed Agent melalui api_url dan daftar model, tanpa harus menunggu adaptasi resmi dari Zed.

Q2: Apakah Key yang diisi di LLM Providers bisa langsung digunakan oleh Claude Agent?

Tidak bisa. Claude Agent termasuk External Agent, autentikasinya dikelola sendiri, dan Anda perlu menjalankan `/login` di thread-nya. Key di LLM Providers hanya untuk Zed Agent.

Q3: OpenAI-compatible dan Anthropic-compatible, mana yang harus dipilih?

Jika penggunaan utama adalah Claude dan membutuhkan penagihan cache, pilih Anthropic-compatible; jika ingin memasang beberapa model di satu Provider, pilih OpenAI-compatible. Menurut dokumentasi APIYI, penagihan cache hanya berlaku pada format Messages native.

Q4: Model ID sebaiknya diisi apa?

Isi ID asli dari tabel daftar model platform, misalnya `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-fable-5-2`. Sebaiknya salin langsung dari docs.apiyi.com/models untuk menghindari kesalahan ketik yang menyebabkan “model tidak ditemukan”.

Q5: Setelah dikonfigurasi selalu 404, bagaimana cara menelusurinya?

Periksa dulu `/v1`: OpenAI-compatible harus menyertakannya, Anthropic-compatible tidak boleh menyertakannya. Jika jalurnya sudah benar, periksa kembali apakah Model ID sesuai dengan daftar model APIYI.

Q6: Di mana API Key disimpan? Apakah akan tersinkronisasi ke repositori?

Zed menyimpan Key di keychain sistem, bukan di settings.json, sehingga saat berbagi file pengaturan Key tidak akan ikut terbawa. Perlu diperhatikan bahwa variabel lingkungan dengan nama yang sama, jika tidak kosong, akan diprioritaskan di atas keychain; saat menelusuri 401 jangan lupa memeriksa variabel lingkungan.

Q7: Apa saja batasan yang diketahui dari konfigurasi ini?

OpenAI-compatible secara default tidak mengaktifkan kemampuan gambar; pemikiran (thinking) pada `claude-opus-5-5` tidak dapat dimatikan, dan `tool_choice` yang diatur ke any / tool akan mengembalikan 400. Selain itu, Provider kustom bukan layanan resmi Zed, stabilitasnya bergantung pada pihak gateway.

---

Poin Penting Integrasi Zed dengan APIYI (Key Takeaways)

• Pisahkan dulu jalurnya: Zed Agent menggunakan LLM Providers, External Agent mengelola autentikasinya sendiri.
• Dua jenis endpoint: OpenAI-compatible menggunakan chat, Anthropic-compatible menggunakan messages.
• Aturan URL: Kompatibel OpenAI isi /v1, Claude native hanya isi domain root.
• ID model: Salin ID asli seperti claude-opus-5-5 sesuai tabel model APIYI.
• Penagihan cache: Saat butuh cache, gunakan Anthropic-compatible dan aktifkan prompt_caching.
• Urutan troubleshooting: Periksa berturut-turut /v1, token, ID model, parameter tool.
• Cara memulai: Buat token khusus di api.apiyi.com/token, selesai dikonfigurasi dalam 5 menit.

---

Ringkasan

Saat mengganti model di Zed, kuncinya adalah memastikan lapisan mana yang ingin diubah:

1. Ganti model Zed Agent: Di LLM Providers gunakan Add Provider untuk menambahkan endpoint OpenAI-compatible atau Anthropic-compatible.
2. External Agent: Claude Agent, OpenCode, dan lainnya melakukan autentikasi sendiri, Key tidak dibagikan dengan Zed Agent.
3. Base URL: Kompatibel OpenAI isi https://api.apiyi.com/v1, kompatibel Anthropic isi https://api.apiyi.com, /v1 ditulis lebih atau kurang akan 404.

Sebelum konfigurasi, disarankan memeriksa model dan harga hari itu di docs.apiyi.com/models terlebih dahulu, lalu buat Key khusus Zed dari halaman token. Gunakan claude-sonnet-5-5 dulu untuk memastikan berjalan lancar, lalu beralih ke claude-opus-5-5 sesuai tugas. Anda dapat membandingkan hasil di kedua Provider dengan token yang sama melalui APIYI apiyi.com.

---

📚 Referensi

1. Repositori GitHub Zed: observasi kode sumber dan jumlah star (2026-11-13)
2. Tautan: github.com/zed-industries/zed

3. Keterangan: lisensi terutama GPL-3.0-or-later, dengan komponen Apache-2.0

4. Zed AI Overview: penjelasan resmi tiga jalur AI

5. Tautan: zed.dev/docs/ai/overview

6. Keterangan: batasan Zed Agent, External Agents, Terminal Threads

7. Zed Use API Access: konfigurasi Provider kustom

8. Tautan: zed.dev/docs/ai/use-api-access

9. Keterangan: field OpenAI-compatible / Anthropic-compatible dan penyimpanan keychain

10. Zed External Agents: Agen eksternal ACP

11. Tautan: zed.dev/docs/ai/external-agents

12. Keterangan: cara mengintegrasikan Claude Agent, Codex, OpenCode, dan lainnya

13. Zed Releases: catatan pembaruan versi

14. Tautan: zed.dev/releases/stable

15. Keterangan: versi stabil 1.28.1 dan konten pembaruan Preview

16. Daftar Lengkap Model APIYI: ID model dan harga

17. Tautan: docs.apiyi.com/models.md

18. Keterangan: harga input / output / baca cache, mengacu pada daftar hari itu

19. FAQ Konfigurasi Base URL APIYI: aturan /v1

20. Tautan: docs.apiyi.com/faq/base-url-config.md

21. Keterangan: perbedaan penulisan Base URL kompatibel OpenAI dan Claude native

22. Halaman Kapabilitas Claude APIYI: endpoint native dan kompatibel

23. Tautan: docs.apiyi.com/api-capabilities/claude.md

24. Keterangan: penagihan cache hanya berlaku pada format Messages

25. Dinamika Peluncuran claude-opus-5-5 APIYI: batasan penggunaan

26. Tautan: docs.apiyi.com/live/2026-09/claude-opus-5-5.md
27. Keterangan: penjelasan nilai default thinking, tool_choice, effort

---

Penulis: Tim Teknis APIYI
Komunikasi Teknis: Jika menemui masalah konfigurasi, lihat pusat dokumentasi docs.apiyi.com, atau hubungi kami melalui halaman utama situs resmi APIYI

Artikel terkait

• Tutorial langkah demi langkah: Hubungkan semua agen dengan satu kunci menggunakan API gateway terpadu magpie open-source (contoh: Claude Code, Codex, Pi, Hermes): Tutorial lengkap yang bisa langsung diikuti: dalam sekitar 30 menit, semua Agen pemrograman di mesinmu—seperti Claude Code, Codex, Pi, dan Hermes—dapat menggunakan satu kunci API dan satu alamat gateway, lengkap dengan tangkapan layar antarmuka magpie, panduan integrasi langkah demi langkah, perbandingan konfigurasi bawaan, dan tabel pemecahan masalah.
• Pembaruan besar Antigravity terungkap: 4 perubahan baru, gunakan Magpie untuk terhubung ke APIYI: Uraikan UI baru, agen suara, eksekusi cloud, dan Gemini 4 Carbon dalam pembaruan besar Antigravity, jelaskan tingkat bukti, serta berikan 3 cara menghubungkan APIYI ke Antigravity melalui Magpie dan 5 langkah konfigurasi.
• Bagaimana Menggunakan Langganan Claude di OpenCode? Integrasi dalam 3 Langkah, 5 Batasan: OpenCode 2.2.3 menambah Claude Agent: instal Claude Code dan jalankan claude auth login untuk memakai langganan di /connect; artikel ini membahas perbedaan dengan plugin yang ditarik Maret, 3 langkah integrasi, alasan baca file paralel jadi serial, 5 batasan, dan Claude Opus 5.5 via APIYI untuk nonpelanggan atau tim, dengan biaya sesuai pemakaian.