Cara menggunakan Qwen Code: instalasi, pemilihan akun dan model, serta pengaturan API

Qwen Code adalah agen coding AI sumber terbuka (Apache-2.0) yang dipublikasikan oleh tim Alibaba Qwen. Cara menggunakannya terdiri dari empat langkah: “instalasi → jalankan qwen di proyek → atur tujuan koneksi dengan /auth → minta pekerjaan”. Namun, karena tingkat gratis Qwen OAuth berakhir pada 15 April 2026, login mengikuti panduan lama tidak lagi membuatnya berjalan secara gratis. Hal lain yang perlu diketahui pengguna berbahasa Korea: Qwen Code tidak memiliki UI berbahasa Korea. Halaman ini menjelaskan secara berurutan cara memulai berdasarkan menu /auth saat ini, pengaturan jawaban berbahasa Korea, konfigurasi kustom untuk menggunakan Claude·GPT, dan perintah yang sering digunakan. Versi terbaru adalah v0.24.7 yang diunggah ke npm pada 29 September 2026, dan rilis baru muncul setidaknya setiap minggu; periksa versi yang terinstal dengan qwen --version.

Instalasi

Ini adalah perintah dari README resmi. Dengan skrip instalasi mandiri, Anda tidak perlu menyiapkan Node.js secara langsung; Node.js 22 atau yang lebih baru hanya diperlukan saat memasang melalui npm.

# macOS / Linux (공식 단독 설치 스크립트)
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

# Windows (PowerShell)
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

# npm (Node.js 22 이상 필요)
npm install -g @qwen-code/qwen-code@latest

# Homebrew (macOS / Linux)
brew install qwen-code

Buka kembali terminal setelah instalasi agar variabel lingkungan diterapkan. Qwen Code awalnya berbasis Google Gemini CLI v0.8.2, tetapi sejak v0.1 dikembangkan secara independen tanpa sinkronisasi dengan sumber aslinya. Pengaturan atau kuota gratis Gemini CLI tidak berlaku secara otomatis.

Menjalankan untuk pertama kali dan jawaban berbahasa Korea

cd /path/to/your-project
qwen

# 세션 안에서:
/language output Korean   # 모델 답변을 한국어로 (UI는 한국어 미지원)
/auth                     # 공급자와 API 키 설정

Bahasa UI bawaan hanya Tionghoa Sederhana, Inggris, Rusia, Jerman, Jepang, Portugis Brasil, Prancis, dan Katalan; berkas terjemahan UI di repositori juga tidak memiliki bahasa Korea (diperiksa pada 1 Oktober 2026). Karena itu, menu tampil dalam bahasa Inggris dan halaman ini mengutip teks Inggris yang terlihat di layar apa adanya. Bahasa jawaban model terpisah dari UI, sehingga dapat ditetapkan ke bahasa Korea dengan /language output Korean.

Selain terminal, tersedia aplikasi desktop, UI web yang dibuka di browser (qwen serve --open, fitur eksperimental), integrasi VS Code·Zed·JetBrains, serta eksekusi headless untuk skrip dan CI (qwen -p "..."). Semuanya berada dalam repositori gratis yang sama, sedangkan biaya inferensi dibayar secara terpisah.

Memilih tujuan koneksi dengan /auth

Saat membuka /auth (alias /login), muncul layar “Select authentication method:” dengan tiga pilihan tingkat teratas. Jika memilih Qwen OAuth, muncul pesan “Discontinued — switch to Coding Plan or API Key”.

Tiga opsi ModelStudio bukan tiga cara untuk membayar tagihan yang sama. Dokumentasi menetapkan endpoint dan key terpisah untuk masing-masing opsi, dan opsi tersebut tidak akan berfungsi jika jenis key dan baseUrl tidak cocok. Per 1 Oktober 2026, Coding Plan ditandai sebagai “jumlah terbatas·siapa cepat dia dapat, diisi ulang setiap tengah malam (UTC+8)”, sehingga pendaftaran mungkin tidak tersedia pada hari tertentu. Dalam Coding Plan, satu tugas dihitung sebagai beberapa panggilan model; Alibaba menjelaskan bahwa tugas sederhana biasanya memerlukan 5–10 panggilan, sedangkan tugas kompleks memerlukan 10–30 panggilan atau lebih. Perbandingan tarif dibahas lebih lanjut di halaman bahasa Inggris Qwen Code pricing.

Menggunakan Claude atau GPT: Custom Provider di settings.json

Dokumentasi autentikasi Qwen Code merekomendasikan ~/.qwen/settings.json berupa modelProviders untuk koneksi pihak ketiga seperti OpenAI, Anthropic, Google, OpenRouter, dan endpoint milik sendiri. Untuk Kunavo, konfigurasinya adalah sebagai berikut.

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

# 키는 settings.json에 직접 쓰지 말고 .qwen/.env 나 환경 변수로
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Empat hal yang menghemat waktu debugging:

• baseUrl hanya sampai /v1. Dokumentasi referensi penyedia model secara jelas menyatakan: “tentukan root /v1 API, bukan seluruh jalur /v1/chat/completions, karena SDK yang menambahkan jalur permintaan”. Jika jalur lengkap ditulis, hasilnya 404, bukan kesalahan autentikasi.
• Tempat menyimpan kunci. Qwen Code membaca kunci dari variabel lingkungan dengan nama yang ditentukan di envKey. Urutan prioritasnya adalah export di shell, file .env (.qwen/.env direkomendasikan, hanya file pertama yang ditemukan yang digunakan), lalu env di settings.json. Opsi terakhir tidak disarankan karena menyimpan kunci dalam teks biasa.
• Berkas konfigurasi mengalahkan flag CLI. Urutan keputusan adalah nilai input /auth → entri modelProviders yang dipilih → argumen CLI → variabel lingkungan → settings.json. Inilah alasan --openai-base-url tampak diabaikan. security.auth.apiKey dan security.auth.baseUrl yang disebut dalam penjelasan lama akan dihentikan dukungannya.
• Mulailah dengan Chat Completions. Jika wireApi dihilangkan, formatnya adalah Chat Completions. Jika diubah ke "responses", tidak ada deteksi endpoint otomatis maupun perpindahan otomatis saat gagal. Perubahan pada modelProviders langsung berlaku bahkan untuk sesi yang sedang berjalan (akan terlihat setelah membuka kembali /model).

Katalog Kunavo tidak memiliki model teks Qwen. Ini bukan cara murah untuk menggunakan Qwen, melainkan cara menggunakan Claude dan GPT dalam Qwen Code dengan satu saldo prabayar. Kunavo juga belum memverifikasi Qwen Code secara langsung menggunakan endpoint miliknya. Konfigurasi ini ditulis berdasarkan dokumentasi resmi, seperti halaman pengaturan bahasa Inggris Qwen Code settings. Uji coba sambil mempertahankan rute yang sedang Anda gunakan.

Pekerjaan pertama dan perintah yang sering digunakan

Permintaan pertama yang dicontohkan README adalah “jelaskan repositori ini dan beri tahu saya harus mulai dari mana”. Dengan begitu, pembacaan berkas dan pemanggilan alat dapat diperiksa sekaligus. Sekadar menyapa tidak akan menemukan masalah koneksi.

Mode persetujuan otomatis seperti yolo diperingatkan oleh dokumentasi agar hanya digunakan “di lingkungan yang tepercaya, berupa sandbox, atau dapat dibuang”. Perkiraan biaya /stats model adalah perhitungan Qwen Code, bukan jumlah yang ditagihkan. Periksa jumlah sebenarnya dalam catatan penggunaan penyedia yang terhubung.

Batasan yang perlu diketahui

• web_search bawaan diaktifkan atau dinonaktifkan bergantung pada tujuan koneksi. Karena menggunakan pencarian sisi server DashScope, fitur ini aktif untuk ModelStudio Standard API Key dan Token Plan, serta entri yang menunjuk ke host DashScope yang dikenali; fitur ini nonaktif untuk Coding Plan (belum diverifikasi pada endpoint tersebut), dan juga nonaktif pada endpoint kustom pihak ketiga atau host lain (dokumentasi web_search). Jika perlu, tambahkan server pencarian MCP.
• Rute Kunavo hanya untuk chat. Kunavo tidak memiliki model embedding, sintesis suara, atau pengenalan suara. Live Voice Qwen Code wajib menggunakan endpoint DashScope, sehingga tetap menggunakan key terpisah di mana pun model chat dijalankan.

Pembayaran saat menguji dengan Kunavo

Kunavo menggunakan pengisian prabayar tanpa biaya bulanan; saldo dipotong berdasarkan token. Pengisian minimum adalah $10, dan checkout Stripe menerima kartu (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay, dan Link. Jika checkout ditampilkan dalam won Korea, KakaoPay, Naver Pay, PAYCO, Samsung Pay, serta kartu domestik yang tidak mendukung pembayaran internasional dapat dipilih (konversi ke won dikenai biaya konversi Stripe sebesar 2–4%; pembayaran dalam dolar dapat menghindarinya). Toss Pay tidak tersedia. Tinjau panduan pembayaran, lalu buat akun untuk menerbitkan kunci. Setelah permintaan pertama, periksa jumlah aktual melalui catatan penggunaan.

Pertanyaan umum

Diperiksa pada 1 Oktober 2026: README Qwen Code; dokumentasi autentikasi, penyedia model, perintah, dan web_search (cabang main); daftar berkas terjemahan UI repositori; @qwen-code/qwen-code 0.24.7 di npm; serta halaman Coding Plan dan Token Plan Alibaba Cloud. Kunavo belum menjalankan Qwen Code pada endpoint miliknya.