Dokumentasi

Qoder

Aplikasi desktop Qoder mandiri menerima Base URL sembarang di Provider → Custom. Isi tiga field dan ketik ID model secara manual, lalu Qoder dapat berkomunikasi dengan Claude dan GPT menggunakan satu key—meskipun keduanya tidak tercantum dalam katalognya sendiri.

Qoder Settings → Models → + Add → Provider → Custom menerima Base URL yang kompatibel dengan OpenAI, API Key, dan Model IDs yang diketik manual — sehingga aplikasi desktop Qoder mandiri mengakses Claude dan GPT, yang tidak ada dalam katalognya sendiri.

Pengaturan Qoder → Model → + Tambahkan → Penyedia → Kustom

Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model

Ini adalah aplikasi Qoder mandiri, bukan Qoder IDE. “Qoder” adalah keluarga produk yang didokumentasikan secara terpisah, dan hanya aplikasi desktop mandiri yang mendokumentasikan endpoint sembarang: halaman model kustomnya menyediakan OpenAI Compatible dan Anthropic Compatible di bagian Custom, dan catatan rilis 0.1.8 tanggal 5 September 2026 memperkenalkannya dengan pernyataan “BYOK pada paket Personal kini mendukung Base URL kustom untuk layanan model apa pun yang kompatibel dengan OpenAI atau Anthropic”. Halaman model kustom Qoder IDE hanya mencantumkan provider dengan nama tertentu dan tidak memuat string Base URL. Jika field itu tidak muncul di layar Anda, kemungkinan Anda menggunakan produk Qoder yang berbeda.

Akhiran /v1 harus tetap ada pada Base URL. Halaman Qoder menyatakan untuk “memasukkan Base URL persis seperti yang diberikan oleh layanan model”, lalu menampilkan https://api.example.com/v1 sebagai format contoh—jadi field tersebut mengharapkan root /v1, bukan origin tanpa tambahan, untuk endpoint yang kompatibel dengan OpenAI. Ini kebalikan dari klien bergaya Anthropic, yang mengharapkan https://api.kunavo.com lalu menambahkan rutenya sendiri.

Qoder juga menyediakan provider kustom Anthropic Compatible dan Kunavo juga melayani /v1/messages. Dokumentasinya menerbitkan satu contoh Base URL dan tidak menyebutkan rute yang ditambahkan oleh tiap protokol, sehingga tidak memastikan apakah jenis itu memerlukan https://api.kunavo.com atau https://api.kunavo.com/v1. Jalur yang kompatibel dengan OpenAI di atas adalah jalur yang ditentukan oleh contoh mereka sendiri; jika Anda memilih jenis Anthropic, perkirakan perlu mencoba kedua bentuk. Daftar pemecahan masalah Qoder sendiri dimulai dengan hal yang persis sama—“Apakah Base URL sudah lengkap dan apakah protokol kompatibel serta jenis API yang dipilih cocok dengan endpoint”.

Kunavo belum menjalankan sesi di dalam Qoder. Tidak ada bagian di sini yang merupakan uji runtime terhadap klien: nama field disalin dari halaman Qoder sendiri pada tanggal di bawah, sedangkan informasi sisi endpoint berasal dari permukaan API Kunavo yang dipublikasikan. Tombol Validate and Add Model adalah langkah yang benar-benar menguji pasangan tersebut, dan prosesnya berjalan di komputer Anda, bukan di komputer kami.

Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Qoder.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Buka Qoder Settings, pilih Models di navigasi sebelah kiri, lalu klik + Add.
Buka Provider dan pilih OpenAI Compatible di bagian Custom—bukan salah satu provider prasetel di atasnya. Lalu pilih Chat Completions API sebagai jenis API.
Masukkan Base URL, API Key, dan setidaknya satu Model ID. Qoder tidak mendokumentasikan penemuan daftar model untuk field ini, jadi ketik ID-nya; klik Add Model ID untuk setiap model tambahan di endpoint yang sama.
Klik Next, lalu tetapkan kemampuan yang tidak dapat disimpulkan Qoder: Display name, Supported Context Windows, dan Default Context Window dari nilai-nilai tersebut, serta tombol Vision dan Thinking Mode jika model mendukungnya.
Klik Validate and Add Model. Halaman pemilih model Qoder menyatakan bahwa setelah ditambahkan, “model tersebut akan tersedia di pemilih model untuk tugas, Agent, dan automasi”.

Diperiksa terhadap halaman model kustom aplikasi Qoder mandiri pada 21 September 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Ini versi singkatnya. Panduan lengkap — pilihan model, biaya sesi nyata, dan mode kegagalan — ada di Qoder vs Claude Code — Qoder yang mana, endpoint yang mana, tagihan yang mana.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di Qoder.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

ID model	Kunavo masuk / keluar	Kegunaannya di Qoder
`claude-sonnet-5`	$1.40 / $7.00	model kerja default untuk pemilih tugas dan Agent
`claude-opus-5`	$3.50 / $17.50	refaktor besar, ketika rencana yang salah lebih mahal daripada token
`claude-haiku-4-5`	$0.70 / $3.50	proses automasi bervolume tinggi, ketika jumlahnya menjadi faktor utama
`gpt-5-6-sol`	$2.00 / $12.00	pendapat kedua dari keluarga berbeda, dengan key dan endpoint yang sama

Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Mengapa Qoder Anda mungkin tidak memiliki field Base URL

Tiga antarmuka Qoder mendokumentasikan penggunaan key sendiri dan hanya satu yang mendokumentasikan endpoint pilihan Anda. Inilah satu hal yang menentukan apakah penyiapan di atas dapat dilakukan dari antarmuka yang sedang Anda gunakan, jadi sebaiknya periksa sebelum mengubah file konfigurasi—dan halaman CLI secara eksplisit menyarankan agar Anda tidak mengubahnya.

Antarmuka	Apakah Base URL kustom didokumentasikan?	Keterangan pada halaman resminya
Qoder (aplikasi mandiri)	Ya	`OpenAI Compatible` dan `Anthropic Compatible` berada di bagian Custom dalam daftar Provider, bersama Base URL, API Key, dan Model ID yang diketik secara manual. Halaman ini.
Qoder IDE	Tidak	Halaman model kustomnya mencantumkan “Berlaku untuk: pengguna dengan paket Individuals” dan menyebut provider: Alibaba Cloud Model Studio, DeepSeek, Z.ai, Kimi, MiniMax, Xiaomi MIMO. String `Base URL` tidak muncul.
Qoder CLI	Tidak ada di halaman dokumentasi	Ada tab Custom di bagian `/model` dengan `Add custom model...`, tetapi halaman tersebut tidak mendokumentasikan Base URL dan memperingatkan, “Jangan konfigurasikan BYOK secara manual di `settings.json`”.

Qoder CLI membingungkan karena catatan rilis dan dokumentasinya sendiri tidak selaras. Catatan rilis 1.1.50 tanggal 11 September 2026 menyatakan “Pengguna edisi Personal kini dapat mengonfigurasi dan mengelola model BYOK secara terpusat dengan endpoint URL kustom dari halaman Custom”, sedangkan halaman model kustom yang masih tersedia menjelaskan katalog: “provider, model, dan field kredensial yang tersedia ditentukan oleh katalog BYOK yang tersedia untuk akun saat ini”. Kedua halaman tersebut, bersama halaman IDE, membatasi fitur ini untuk paket Individual. Jadi, jika tab Custom tidak ada atau tidak menampilkan field endpoint, periksa paket akun dan apa yang tersedia di katalog akun tersebut—bukan file konfigurasi, yang menurut halaman CLI tidak boleh diedit manual dan toh dibuat ulang dari katalog.

Pertanyaan umum

Bagaimana cara menambahkan provider kustom ke Qoder?

Di aplikasi desktop Qoder mandiri: buka Qoder Settings, pilih Models di navigasi sebelah kiri, klik + Add, lalu buka Provider dan pilih “OpenAI Compatible” atau “Anthropic Compatible” di bagian Custom. Untuk jenis OpenAI, pilih juga Chat Completions API atau Responses API. Masukkan Base URL, API Key, dan setidaknya satu Model ID; gunakan Add Model ID untuk model tambahan di endpoint yang sama. Klik Next untuk menetapkan Display name, Supported Context Windows, Default Context Window, Vision, dan Thinking Mode, lalu klik Validate and Add Model. Qoder memvalidasi koneksi sebelum menyimpan.

Apakah Base URL Qoder harus diakhiri dengan /v1?

Untuk endpoint yang kompatibel dengan OpenAI, ya. Halaman model kustom Qoder meminta Anda memasukkan Base URL persis seperti yang diberikan oleh layanan model dan menampilkan https://api.example.com/v1 sebagai format contoh. Jadi, field tersebut mengharapkan root /v1, bukan origin tanpa tambahan—untuk Kunavo, gunakan https://api.kunavo.com/v1. Untuk jenis Anthropic Compatible, halaman itu tidak menerbitkan contoh terpisah dan tidak menyebutkan rute yang ditambahkan, sehingga dokumentasinya belum memastikan kasus tersebut; coba root /v1 terlebih dahulu, lalu origin tanpa tambahan jika validasi gagal.

Mengapa Qoder saya tidak memiliki tab Custom atau field Base URL?

Karena ketiga antarmuka Qoder memiliki aturan BYOK yang berbeda. Hanya aplikasi desktop Qoder mandiri yang mendokumentasikan Base URL sembarang. Halaman model kustom Qoder IDE mencantumkan provider bernama tertentu dan tidak pernah menyebut Base URL, sedangkan halaman Qoder CLI menyatakan bahwa provider, model, dan field kredensial yang tersedia ditentukan oleh katalog BYOK yang tersedia untuk akun saat ini. Halaman IDE dan CLI juga membatasi fitur ini untuk paket Individual. Jika field tersebut tidak ada, periksa produk Qoder yang sedang Anda buka serta hal-hal yang diizinkan oleh paket dan katalog akun Anda—halaman CLI secara khusus memperingatkan agar BYOK tidak dikonfigurasi secara manual di settings.json.

Dapatkah Qoder menggunakan model Claude tanpa akun Anthropic?

Bisa melalui provider kustom; katalog bawaan Qoder adalah hal terpisah. Halaman pemilih modelnya mencantumkan model Qwen, DeepSeek, GLM, Kimi, dan MiniMax, tanpa menyebut model Claude, GPT, ataupun Gemini. Jadi, penggunaan key sendiri adalah cara yang didokumentasikan untuk menggunakan model tersebut. “OpenAI Compatible” di sana adalah pilihan protokol komunikasi, bukan pilihan vendor: Model ID yang Anda ketik akan diarahkan ke Base URL yang Anda konfigurasi, sehingga ID Claude dapat digunakan selama endpoint menyediakannya; kredensial yang digunakan adalah kredensial endpoint tersebut, bukan kredensial Anthropic.

Apakah model kustom di Qoder tetap menggunakan Qoder Credits?

Halaman model kustom Qoder menyatakan bahwa biaya model kustom ditagihkan langsung ke akun API provider Anda dan tidak menggunakan Qoder Credits. Repo Wiki disebut sebagai pengecualian karena menggunakan model tetap dan ditagihkan secara terpisah, dengan prompt yang ditampilkan saat fitur tersebut dijalankan. Biaya di sisi Kunavo dihitung per token dari saldo prabayar tanpa biaya bulanan. Perhatikan juga bahwa operasi Edit Qoder pada model kustom yang tersimpan hanya memperbarui API key—untuk mengubah Base URL, hapus entri tersebut dan tambahkan kembali.

Apakah Kunavo sudah menguji penyiapan ini di dalam Qoder?

Belum. Kunavo belum menjalankan sesi di antarmuka Qoder mana pun, dan halaman ini bukan laporan kompatibilitas runtime: nama serta urutan field disalin dari halaman model kustom Qoder sendiri pada tanggal yang ditunjukkan, sedangkan informasi sisi endpoint berasal dari API Kunavo yang dipublikasikan. Pemeriksaan yang diperlukan berjalan di komputer Anda—tombol Validate and Add Model milik Qoder menguji Base URL, key, dan Model ID secara bersamaan sebelum menyimpannya; perintah curl biasa ke Base URL dan key yang sama memastikan apakah kegagalan berasal dari endpoint atau klien.