Tutorial Menghubungkan Cline ke API Relay: Konfigurasi Agen Pemrograman VS Code

发布时间2026年8月30日 01:08
语言id

Tutorial koneksi agen pemrograman open-source VS Code (Cline): cara membuat kunci sk-, konfigurasi API Provider dan Base URL, untuk memanggil model Claude / GPT / Gemini.

I. Apa itu Cline

Cline adalah agen pemrograman AI open-source populer di VS Code yang mampu membaca basis kode, mengubah file, dan menjalankan perintah terminal, serta mendukung secara native berbagai Provider seperti Anthropic / OpenAI / Google (Gemini). Dengan mengarahkan API Provider-nya ke gateway relay dan memasukkan kunci sk-, Anda dapat menggunakan saldo platform untuk memanggil Claude / GPT / Gemini, dengan penagihan berbasis token.

II. Persiapan

Login ke konsol API Jizhi (Extreme Intelligence), buat kunci sk-xxxxxx di bagian "API Keys" (kunci hanya ditampilkan sekali, harap simpan).
Konfirmasi slug model yang ingin digunakan (seperti claude-sonnet-5, gpt-5.5, gemini-3.7-flash).
Konfirmasi alamat gateway: https://www.relay-api.com.

III. Konfigurasi di Cline

Buka Cline → ikon roda gigi (Settings) → API Provider, pilih berdasarkan jenis model:

① Anthropic (untuk Claude)

Base URL : https://www.relay-api.com
API Key  : sk-kunci_anda
Model ID : claude-sonnet-5

② OpenAI Compatible (untuk GPT)

Base URL : https://www.relay-api.com/v1
API Key  : sk-kunci_anda
Model ID : gpt-5.5

③ Untuk Gemini: Pilih Provider Google Gemini (atau OpenAI-compatible), gunakan Base URL https://www.relay-api.com/v1beta, dan Model ID gemini-3.7-flash (nama model mengikuti URL).

Setelah selesai mengisi, klik Connect / Continue untuk verifikasi. Gunakan pintu masuk (entry) Base URL sesuai tabel di atas.

IV. Referensi Alamat Antarmuka

Grup Model	Entry (Base URL)	Protokol
Claude / Anthropic	`https://www.relay-api.com`	Anthropic Messages
GPT / OpenAI	`https://www.relay-api.com/v1`	OpenAI Chat Completions
Gemini	`https://www.relay-api.com/v1beta`	Google generateContent

V. Pemecahan Masalah Umum

Gejala	Tindakan
401 / 403	Kunci tidak valid, tidak diaktifkan, atau saldo tidak cukup; pastikan `sk-` sudah benar dan lakukan pengisian saldo.
404 / Model tidak tersedia	Nama model tidak sesuai dengan slug platform, atau model tersebut belum diaktifkan; periksa kembali Model ID.
Unknown model	ID model yang dimasukkan harus tepat (termasuk huruf besar/kecil), periksa melalui pusat model.

Saran Keamanan: Jangan tulis kunci langsung ke repositori publik, gunakan .env atau variabel lingkungan; buat kunci terpisah untuk setiap perangkat agar mudah memantau statistik dan limit.

Penjelasan Base URL: Situs ini menerima /v1beta/models/... maupun /v1beta/v1beta/models/... (serta /v1/... dan /v1/v1/...), jadi tidak masalah apakah klien Anda menambahkan /v1 atau /v1beta secara otomatis: Base URL bisa diisi dengan root domain atau dengan alamat yang menyertakan /v1beta. Silakan cari dan salin Model ID di "Model ID" di sudut kanan atas halaman "Token" pada konsol.