Cline + API key sendiri: setup 5 menit
Cline adalah extension coding agent di VS Code: dia membaca codebase-mu, mengusulkan edit, menjalankan perintah, dan mengerjakan task dengan campuran baca-tulis-test. Untuk itu dia butuh satu hal: akses ke model AI lewat API key.
Kebanyakan tutorial berhenti di “daftar provider, masukkan kartu kredit”. Tutorial ini tidak — alurnya pakai API key milikmu sendiri dari GiantRouter, dibayar QRIS, dengan batas budget yang kamu pasang sendiri. Kalau kamu sudah terbiasa dengan VS Code, semua langkah di bawah selesai dalam hitungan menit.
Yang perlu disiapkan
- VS Code (atau fork-nya: Cursor, VSCodium) dengan Cline terpasang dari marketplace.
- Saldo GiantRouter — Rp10.000 sudah cukup untuk hari pertama. Cara top-up-nya ada di API AI bayar rupiah pakai QRIS.
Enam langkah setup
1. Buat API key dengan batas budget. Di dashboard GiantRouter, buat API key baru dan pasang batas pemakaiannya. Untuk hari pertama, Rp10.000 adalah batas yang masuk akal: cukup untuk banyak request kecil, dan key berhenti sendiri kalau ada yang salah.
2. Simpan key di tempat aman. Key tampil sekali — salin dan simpan di
password manager atau file .env lokal yang tidak ikut ke git. Key yang
bocor = pemakaian orang lain di saldo kamu; batas budget adalah rem
daruratnya, tapi kebiasaan yang benar tetap: jangan pernah commit key.
3. Konfigurasi Cline ke gateway. Buka pengaturan Cline, pilih provider API “Anthropic” (format request-nya Anthropic-compatible), lalu isi:
Base URL: https://api.giantrouter.my.id
API Key: <key kamu dari langkah 1>
Model: pilih dari katalog, mulai dari yang murahBase URL inilah yang membelokkan semua request Cline ke gateway — tidak ada kode project yang berubah, tidak ada konfigurasi per-repo yang harus diulang.
4. Pilih model pertama dengan sadar. Untuk task kecil (perbaiki test, jelaskan fungsi, edit terlokalisasi), model kelas flash/hemat sudah cukup dan harganya jauh lebih murah. Untuk task arsitektural atau refactor lintas file, baru pilih model besar. Harga per juta token tampil terbuka di halaman depan — beda model bisa beda puluhan kali lipat, jadi pilihannya bagian dari kontrol biayamu, bukan cuma selera.
5. Jalankan satu task kecil. Contoh task pertama yang bagus: “jelaskan apa yang dilakukan file X ini” atau “perbaiki test yang gagal di file Y”. Task pertama sekaligus mengetes rantai penuh: Cline → gateway → model → hasil.
6. Buka laporan pemakaian. Di dashboard, lihat request yang baru saja terjadi: model yang kepakai, token input dan output, biayanya. Ini kebiasaan yang akan menyelamatkan budget kamu — biaya per task tampil, bukan tersembunyi di tagihan akhir bulan.
Tiga kebiasaan kecil yang menghemat banyak
- Satu key per konteks. Key untuk eksperimen, key untuk kerjaan client — dengan budget masing-masing. Laporan biayanya juga terpisah per konteks.
- Model besar hanya untuk task yang butuh. Pola yang biasa: draf dan iterasi kecil di model murah, review dan keputusan desain di model besar.
- Cek laporan setelah sesi pertama. Dari sana kamu bisa hitung sendiri biaya per task-mu — contoh cara hitungnya ada di biaya Claude Code per task.
Kalau kamu sudah pakai provider lain
Migrasi dari provider API lain (OpenAI-compatible apa pun, atau akses Anthropic langsung) biasanya cuma dua perubahan: base URL dan key. Format request dan struktur prompt tidak berubah. Dua hal yang perlu diperhatikan saat pindah:
- Nama model bisa beda penamaannya antar-katalog. Cek nama model yang tampil di katalog GiantRouter dan sesuaikan satu baris konfigurasi.
- Jalankan satu task kecil untuk pembandingan. Task yang sama di provider lama dan di gateway — bandingkan hasil dan biayanya dari laporan pemakaian. Keputusan pindah atau tidak jadi keputusan berdasar angka, bukan rasa.
Dan karena tidak ada kontrak bulanan di alur ini, “coba dulu” tidak punya biaya keputusan: satu QRIS Rp10.000 dan satu jam percobaan sudah cukup untuk tahu cocok atau tidak.
Kalau ada yang macet
Kebanyakan masalah setup pertama ada di tiga hal, dan ketiganya bisa dipastikan sendiri tanpa bertanya ke siapa pun:
| Gejala | Penyebab paling umum | Cek di mana |
|---|---|---|
| Request gagal dengan error auth | Base URL salah ketik atau key belum disalin penuh | Konfigurasi provider di Cline |
| Request berhenti di tengah task | Batas budget key sudah tersentuh | Laporan pemakaian di dashboard |
| Respons terasa “model kecil banget” | Model yang terpilih bukan yang kamu kira | Nama model di laporan tiap request |
Kalau ketiganya sudah benar dan masih bermasalah, coba satu request lewat
curl/terminal langsung ke endpoint gateway — memisahkan “masalah Cline” dari
“masalah koneksi” biasanya menyelesaikan pencarian dalam satu langkah.
Kenapa “key milik sendiri” penting di sini
Cline yang jalan di atas akses bareng milik orang lain (paket sharing) punya dua masalah: jejak pemakaianmu bercampur di satu akun yang sama dengan orang lain, dan begitu akun itu diblokir penyedia, kerjaanmu berhenti di tengah jalan. Dengan key sendiri lewat gateway resmi, pemakaianmu terisolasi — penjelasan lengkapnya ada di API resmi, bukan akunan bareng.