Panduan Pengaturan Provider AI

Konfigurasi OpenCode

OpenCode adalah asisten coding AI terminal sumber terbuka. Alat ini cocok untuk tanya jawab kode, modifikasi berkas, dan pergantian model dalam direktori proyek. Pemula disarankan untuk menggunakan panduan koneksi bawaannya terlebih dahulu dan menghindari penulisan JSON lengkap secara manual di awal.

Informasi resmi Unduhan dan dokumentasi mengacu pada situs resmi.

Situs Resmi OpenCode Asisten coding AI terminal sumber terbuka Dokumentasi Petunjuk instalasi, autentikasi, dan perintah Referensi konfigurasi provider AI Lihat konsep konfigurasi di opencode.json

Tentang alat ini dan kegunaannya

Lokasi Berkas Konfigurasi

Sistem	Lokasi Berkas Konfigurasi	Deskripsi
Windows	`C: \Users\YourUsername\. config\opencode\opencode.json`	Jika berkas belum ada, buat berkas baru
macOS / Linux	`~/. config/opencode/opencode.json`	Jika berkas belum ada, buat berkas baru

Mulai dengan panduan koneksi

Panduan Koneksi OpenCode

cd YOUR_TEST_PROJECT opencode /connect

Periksa Model OpenCode

cd YOUR_TEST_PROJECT opencode /models

Hal yang perlu diperhatikan saat konfigurasi manual

Hanya edit berkas konfigurasi jika dokumentasi provider Anda secara jelas menentukan kolom Provider OpenCode, tempat meletakkan Base URL, dan Key. Kolom dapat bervariasi antarversi, jangan langsung menyalin contoh JSON dari alat lain ke OpenCode.

Item yang perlu diverifikasi	Deskripsi
Tipe Provider	Jangan mencampuradukkan protokol OpenAI, Claude, Gemini, atau lainnya
Base URL	Gunakan alamat lengkap yang disediakan oleh provider untuk OpenCode atau protokol yang sesuai
Key	Gunakan Key yang sesuai dengan Provider saat ini
Nama Model	Salin daftar model dari backend provider

Cara menguji setelah menyimpan

Masuk ke direktori proyek uji lalu jalankan opencode.
Gunakan /models terlebih dahulu untuk memastikan model yang baru dikonfigurasi terlihat.
Setelah memilih model, kirim 'Please only reply: OpenCode configuration successful'.
Untuk pertama kali, jangan biarkan alat ini memodifikasi berkas; cukup minta untuk menjelaskan direktori saat ini atau berkas saat ini.
Jika gagal, kembali terlebih dahulu ke /connect atau periksa provider, Base URL, Key, dan nama model berdasarkan dokumentasi provider.

Gejala	Pemeriksaan prioritas	Penanganan
Tidak ada model di dalam `/models`	Apakah provider berhasil disimpan, apakah daftar model dapat diambil	Tambahkan ID model / nama model dari backend provider secara manual
Koneksi gagal	Apakah Base URL sesuai dengan protokol Provider saat ini	Jangan mencampuradukkan alamat Claude, Gemini, dan OpenAI
Berkas konfigurasi tidak valid	Format JSON, tanda koma, tanda kutip	Prioritaskan pembuatan konfigurasi menggunakan panduan koneksi, lalu lakukan penyesuaian manual kecil jika diperlukan.

Situs Resmi OpenCode Lihat petunjuk instalasi, autentikasi, dan perintah.

Referensi Konfigurasi Provider AI OpenCode Lihat pendekatan konfigurasi opencode.json.