Semua integrasi
Asisten coding di editor

opencode

Agen coding di terminal (TUI). Tambah penyedia OpenAI-compatible di opencode.json.

Base URL dan API key diambil dari dasbor RouterKu (menu Integrasi & Kunci API). Pada contoh, ganti BASE_URL_DARI_DASBOR (berakhiran /v1), HOST_DARI_DASBOR (tanpa /v1) dan qdr-... dengan nilai milikmu.

opencode adalah agen coding di terminal (TUI) yang memakai AI SDK dan mendukung penyedia OpenAI-compatible. RouterKu dipasang sebagai penyedia kustom lewat berkas opencode.json.

Nilai koneksi

Base URLBASE_URL_DARI_DASBOR
API Keyqdr-... (buat di menu Kunci API)
Modelsonnet-5 / opus-5

Langkah-langkah

  1. Pasang opencode

    Pasang lewat skrip resmi, npm, atau Homebrew:

    Terminal
    curl -fsSL https://opencode.ai/install | bash
    # atau:  npm i -g opencode-ai
    # atau:  brew install sst/tap/opencode
  2. Buat kunci RouterKu

    Buka menu Kunci API di RouterKu → Buat kunci → salin (qdr-...). Kunci hanya tampil sekali.

  3. Daftarkan penyedia RouterKu di opencode.json

    Buat/edit ~/.config/opencode/opencode.json (global) atau opencode.json di root proyek, lalu tambahkan penyedia routerku:

    ~/.config/opencode/opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "routerku": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "RouterKu",
          "options": {
            "baseURL": "BASE_URL_DARI_DASBOR",
            "apiKey": "qdr-..."
          },
          "models": {
            "sonnet-5": { "name": "RouterKu Sonnet 5" },
            "opus-5": { "name": "RouterKu Opus 5" },
            "haiku-55": { "name": "RouterKu Haiku 55" }
          }
        }
      },
      "model": "routerku/sonnet-5"
    }
  4. Jalankan & pilih model

    Jalankan opencode di folder proyek. Ketik /models untuk memilih model RouterKu (mis. RouterKu Sonnet 5), lalu mulai memberi perintah.

Model dirujuk dengan format id-penyedia/id-model (mis. routerku/sonnet-5). Paket @ai-sdk/openai-compatible dipakai karena RouterKu memakai endpoint /v1/chat/completions.

Alternatif: simpan kunci lewat /connect

Agar kunci tak tersimpan di dalam file config, hapus baris apiKey lalu jalankan /connect di dalam opencode → pilih Other → ketik id routerku (harus sama dengan config) → tempel kunci qdr-.... Kunci tersimpan aman di ~/.local/share/opencode/auth.json.

Bisa juga pakai variabel lingkungan: set "apiKey": "{env:ROUTERKU_API_KEY}" di config, lalu export ROUTERKU_API_KEY=qdr-....

Model yang disarankan

opus-5Terkuat — penalaran mendalam untuk tugas berat, banyak tool, dan agen coding.
sonnet-5Andalan harian (default) — seimbang antara kualitas, kecepatan, dan biaya.
haiku-55Tercepat & termurah — balasan chat ringan, klasifikasi, dan boilerplate.
Asisten coding mengirim konteks besar dan banyak panggilan tool. Batas RouterKu per akun: 240 permintaan/menit dan 24 paralel — cukup untuk kerja normal. Pakai opus-5 untuk tugas berat, sonnet-5 untuk kerja harian yang lebih hemat.

Tips

  • Taruh opencode.json di root proyek agar setelan model ikut per-proyek (menimpa config global).
  • Set "small_model": "routerku/haiku-55" supaya tugas ringan (mis. pembuatan judul sesi) memakai model termurah.
  • Tambah "limit": { "context": 200000, "output": 65536 } di dalam definisi model agar opencode tahu sisa konteks.
  • Cek kredensial dengan opencode auth list kalau memakai /connect.

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 opencode (lihat 3 poin berikutnya). Kalau bukan 200, buat kunci baru di menu Kunci API.
  • 401 padahal kunci sehat (1) — belum restart opencode. Banyak aplikasi hanya membaca file .env/variabel lingkungan saat start. Setelah mengubah kunci, tutup penuh lalu jalankan ulang opencode.
  • 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 opencode.
  • 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:

Terminal
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-55","max_tokens":10,"messages":[{"role":"user","content":"ping"}]}'
Hasil 200 = kunci dan saldo RouterKu sehat, jadi penyebab 401 ada di konfigurasi aplikasinya (paling sering: aplikasi belum di-restart setelah kunci diubah). Hasil 401 = kunci salah/dicabut → buat ulang di menu Kunci API. Hasil 402 = saldo habis → menu Isi Saldo.

Uji endpoint dari kode (opsional)

bash
curl BASE_URL_DARI_DASBOR/chat/completions \
  -H "Authorization: Bearer qdr-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"sonnet-5","messages":[{"role":"user","content":"Halo!"}]}'

Siap mulai pakai AI tanpa ribet?

Daftar gratis, isi saldo mulai Rp20.000 lewat QRIS, dan langsung tancap gas di editor atau aplikasimu.