Qwen Code

Qwen Code membaca endpoint dari modelProviders di ~/.qwen/settings.json — satu entri dengan baseUrl dan envKey menempatkan Claude dan GPT dalam pemilih /model.

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-compatible",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": {
    "KUNAVO_API_KEY": "sk-kn-..."
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Buka ~/.qwen/settings.json (buat jika belum ada), lalu gabungkan empat blok di atas. Dokumentasi menyarankan untuk mendeklarasikan modelProviders dalam file cakupan pengguna “untuk menghindari konflik penggabungan antara pengaturan proyek dan pengguna”.
3. Simpan kunci di tempat yang lebih aman daripada env jika memungkinkan. Qwen Code membacanya dari process.env[envKey], dan dokumentasi mengurutkan sumber dari prioritas tertinggi ke terendah: export shell, lalu file .env, kemudian blok env di settings.json—yang ditandai sebagai penyimpanan teks biasa. Blok env di atas adalah konfigurasi paling sederhana yang berfungsi, bukan tempat terbaik untuk menyimpan kunci.
4. Jalankan qwen. Dengan security.auth.selectedType disetel ke openai dan model.name cocok dengan id yang Anda deklarasikan, langkah interaktif /auth tidak diperlukan—dokumentasi menyatakannya secara eksplisit setelah contoh satu file.
5. Berikan tugas untuk membaca dan mengedit file, bukan sekadar sapaan. Qwen Code adalah agen: pemanggilan alat dan streaming adalah hal yang seharusnya diuji pada penggunaan pertama, dan keduanya yang paling dahulu bermasalah pada endpoint yang hanya cocok sebagian.
6. Tambahkan entri lain di bawah modelProviders.openai untuk beralih model saat runtime dengan /model. Perubahan tersebut dimuat ulang secara langsung dalam sesi yang sedang berjalan; providerProtocol dibaca sekali saat startup dan memerlukan mulai ulang.

Diperiksa terhadap Halaman autentikasi Qwen Code, Opsi 4: Kunci API (fleksibel) 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.

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 Qwen Code.

# 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.

Tiga hal yang dijelaskan dokumentasi dan sering keliru ditebak

Informasi ini berasal dari halaman autentikasi dan referensi penyedia model yang ditautkan di atas. Mengira-ngira alih-alih membacanya dapat menghabiskan banyak waktu untuk debugging.

1. Entri modelProviders memiliki prioritas lebih tinggi daripada flag CLI. Urutan prioritas yang didokumentasikan, dari tertinggi, adalah: penggantian melalui /auth dalam sesi yang sedang berjalan, lalu envKey penyedia model yang dipilih, argumen CLI seperti --openai-api-key, variabel lingkungan, kemudian security.auth.apiKey dalam pengaturan. Kebanyakan orang mengira flag akan menjadi prioritas tertinggi. Ternyata tidak—itulah sebabnya --openai-base-url bisa tampak diabaikan.
2. security.auth.apiKey dan security.auth.baseUrl sudah tidak digunakan lagi. Referensi menyatakannya dan menyarankan migrasi ke modelProviders. Jika tutorial lama meminta Anda mengedit kedua kunci itu, berarti tutorial tersebut mengarahkan Anda ke jalur yang sedang dihentikan.
3. wireApi menentukan format permintaan, dan tidak ada mekanisme yang mendeteksi ketidakcocokan. Jika tidak dicantumkan, formatnya adalah Chat Completions, seperti yang digunakan blok di atas. Menyetel "wireApi": "responses" mengharuskan endpoint benar-benar kompatibel dengan Responses, dan dokumentasi menyatakan dengan jelas bahwa tidak ada deteksi endpoint maupun fallback otomatis saat permintaan gagal. Kunavo mendukung /v1/responses maupun /v1/chat/completions, tetapi halaman ini belum menguji keduanya, jadi mulailah dengan setelan default.

Jika Anda datang ke sini mencari paket gratis

Banyak tulisan yang masih beredar tentang Qwen Code membahas login OAuth Qwen dengan jatah gratis harian. Opsi tersebut sudah tidak tersedia: dokumentasi mencatat bahwa paket gratisnya dihentikan pada 15 April 2026, dan OAuth Qwen tidak lagi menjadi pilihan dalam dialog /auth. Kini ada tiga pilihan: Alibaba ModelStudio—dengan Coding Plan, Token Plan, dan Standard API Key di submenu-nya—Penyedia Pihak Ketiga dan Penyedia Kustom, yang dijelaskan sebagai opsi untuk menghubungkan “server lokal, proksi, atau penyedia yang tidak didukung”. Kunavo adalah pilihan ketiga. Perlu diketahui juga bahwa item submenu ModelStudio bukan tiga cara membayar satu tagihan: masing-masing memiliki host dan kuncinya sendiri, dan kunci Coding Plan tidak akan berfungsi pada host Token Plan.