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 URL | BASE_URL_DARI_DASBOR |
| API Key | qdr-... (buat di menu Kunci API) |
| Model | sonnet-5 / opus-5 |
Langkah-langkah
Pasang opencode
Pasang lewat skrip resmi, npm, atau Homebrew:
curl -fsSL https://opencode.ai/install | bash # atau: npm i -g opencode-ai # atau: brew install sst/tap/opencodeBuat kunci RouterKu
Buka menu
Kunci APIdi RouterKu → Buat kunci → salin (qdr-...). Kunci hanya tampil sekali.Daftarkan penyedia RouterKu di opencode.json
Buat/edit
~/.config/opencode/opencode.json(global) atauopencode.jsondi root proyek, lalu tambahkan penyediarouterku:{ "$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" }Jalankan & pilih model
Jalankan
opencodedi folder proyek. Ketik/modelsuntuk memilih model RouterKu (mis. RouterKu Sonnet 5), lalu mulai memberi perintah.
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-5 | Terkuat — penalaran mendalam untuk tugas berat, banyak tool, dan agen coding. |
sonnet-5 | Andalan harian (default) — seimbang antara kualitas, kecepatan, dan biaya. |
haiku-55 | Tercepat & termurah — balasan chat ringan, klasifikasi, dan boilerplate. |
opus-5 untuk tugas berat, sonnet-5 untuk kerja harian yang lebih hemat.Tips
- Taruh
opencode.jsondi 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 listkalau 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 bukan200, buat kunci baru di menuKunci 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
.envtulis 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 kunciqdr-...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 diGET /v1/models). - Tidak konek / timeout — pastikan Base URL berakhiran
/v1dan 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:
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"}]}'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)
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!"}]}'from openai import OpenAI
client = OpenAI(api_key="qdr-...", base_url="BASE_URL_DARI_DASBOR")
resp = client.chat.completions.create(
model="sonnet-5",
messages=[{"role": "user", "content": "Halo!"}],
)
print(resp.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({ apiKey: "qdr-...", baseURL: "BASE_URL_DARI_DASBOR" });
const resp = await client.chat.completions.create({
model: "sonnet-5",
messages: [{ role: "user", content: "Halo!" }],
});
console.log(resp.choices[0].message.content);const res = await fetch("BASE_URL_DARI_DASBOR/chat/completions", {
method: "POST",
headers: {
Authorization: "Bearer qdr-...",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "sonnet-5",
messages: [{ role: "user", content: "Halo!" }],
}),
});
const data = await res.json();
console.log(data.choices[0].message.content);package main
import (
"bytes"
"encoding/json"
"fmt"
"io"
"net/http"
)
func main() {
body, _ := json.Marshal(map[string]any{
"model": "sonnet-5",
"messages": []map[string]string{{"role": "user", "content": "Halo!"}},
})
req, _ := http.NewRequest("POST", "BASE_URL_DARI_DASBOR/chat/completions", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer qdr-...")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))
}<?php
$ch = curl_init("BASE_URL_DARI_DASBOR/chat/completions");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer qdr-...", "Content-Type: application/json"],
CURLOPT_POSTFIELDS => json_encode([
"model" => "sonnet-5",
"messages" => [["role" => "user", "content" => "Halo!"]],
]),
]);
$res = json_decode(curl_exec($ch), true);
echo $res["choices"][0]["message"]["content"];require "net/http"
require "json"
uri = URI("BASE_URL_DARI_DASBOR/chat/completions")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer qdr-..."
req["Content-Type"] = "application/json"
req.body = { model: "sonnet-5", messages: [{ role: "user", content: "Halo!" }] }.to_json
res = http.request(req)
puts JSON.parse(res.body)["choices"][0]["message"]["content"]import java.net.URI;
import java.net.http.*;
var client = HttpClient.newHttpClient();
var body = "{\"model\":\"sonnet-5\",\"messages\":[{\"role\":\"user\",\"content\":\"Halo!\"}]}";
var req = HttpRequest.newBuilder(URI.create("BASE_URL_DARI_DASBOR/chat/completions"))
.header("Authorization", "Bearer qdr-...")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
var res = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());using System.Net.Http;
using System.Text;
var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer qdr-...");
var json = "{\"model\":\"sonnet-5\",\"messages\":[{\"role\":\"user\",\"content\":\"Halo!\"}]}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var res = await client.PostAsync("BASE_URL_DARI_DASBOR/chat/completions", content);
Console.WriteLine(await res.Content.ReadAsStringAsync());// Cargo.toml: reqwest = { version = "0.12", features = ["json", "blocking"] }
use serde_json::json;
fn main() {
let res = reqwest::blocking::Client::new()
.post("BASE_URL_DARI_DASBOR/chat/completions")
.header("Authorization", "Bearer qdr-...")
.json(&json!({ "model": "sonnet-5", "messages": [{ "role": "user", "content": "Halo!" }] }))
.send().unwrap().text().unwrap();
println!("{res}");
}Asisten coding di editor lain
Siap mulai pakai AI tanpa ribet?
Daftar gratis, isi saldo mulai Rp20.000 lewat QRIS, dan langsung tancap gas di editor atau aplikasimu.