Roo Code

Roo Code adalah agen coding VS Code (turunan Cline) dengan mode Architect / Code / Ask. Pasang RouterKu sebagai provider OpenAI-compatible.

Nilai koneksi

Langkah-langkah

1. Pasang ekstensi Roo Code

   Pasang Roo Code dari Marketplace, lalu buka panelnya di sidebar VS Code.

2. Buka Providers

   Settings (ikon ⚙) → Providers, lalu pilih API Provider = OpenAI Compatible.

3. Isi koneksi RouterKu

   Base URL	BASE_URL_DARI_DASBOR
   API Key	qdr-...
   Model	sonnet-5

4. Simpan & jalankan

   Simpan, pilih mode (Architect untuk rencana, Code untuk eksekusi), lalu ketik tugas.

Model yang disarankan

Tips

• Set model berbeda per mode: opus-5 untuk Architect, sonnet-5 untuk Code.
• Roo bisa membaca banyak berkas sekaligus — pakai model konteks besar untuk basis kode besar.
• Kalau balasan terpotong, naikkan batas token output di setelan Roo.

Kalau bermasalah

• 401 / authentication failed / invalid_api_key — cek dulu apakah kuncinya memang mati, atau cuma tidak sampai ke permintaan. Jalankan uji mandiri di bawah: kalau balasannya 200, kunci kamu SEHAT dan masalahnya ada di konfigurasi Roo Code (lihat 3 poin berikutnya). Kalau bukan 200, buat kunci baru di menu Kunci API.
• 401 padahal kunci sehat (1) — belum restart Roo Code. Banyak aplikasi hanya membaca file .env/variabel lingkungan saat start. Setelah mengubah kunci, tutup penuh lalu jalankan ulang Roo Code.
• 401 padahal kunci sehat (2) — penulisan kunci kotor. Di file .env tulis polos tanpa kutip/spasi: ROUTERKU_API_KEY=qdr-... (bukan = "qdr-..."). Pastikan tidak ada spasi di ujung dan kunci tersalin utuh (tanpa terpotong).
• 401 padahal kunci sehat (3) — nama variabel salah. Rujukan seperti ${ROUTERKU_API_KEY} umumnya hanya dikenali bila namanya HURUF BESAR dan variabelnya benar-benar ada; kalau tidak, teks ${...} terkirim mentah sebagai kunci → 401. Saat ragu, isi kunci qdr-... langsung untuk memastikan.
• 402 / insufficient_balance — saldo habis. Isi lewat menu Isi Saldo.
• 404 / model_not_found — ID model salah. Pakai persis, mis. sonnet-5 (daftar di GET /v1/models).
• Tidak konek / timeout — pastikan Base URL berakhiran /v1 dan bisa diakses dari mesin Roo Code.
• 429 / rate_limited — melewati 240 permintaan/menit atau 24 paralel. Beri jeda atau kurangi konkurensi.

Uji mandiri kunci — jalankan di terminal mesin yang sama. Ganti qdr-... dengan kuncimu:

curl -s -o /dev/null -w "%{http_code}\n" BASE_URL_DARI_DASBOR/chat/completions \
  -H "Authorization: Bearer qdr-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"haiku-45","max_tokens":10,"messages":[{"role":"user","content":"ping"}]}'