Cara menggunakan Qwen Code: instalasi, /auth, pelokalan bahasa Jepang, dan pengaturan API

Qwen Code adalah agen coding AI sumber terbuka (Apache-2.0) yang dipublikasikan oleh tim Qwen Alibaba. Alur penggunaannya terdiri dari 4 tahap: “instalasi → jalankan qwen di proyek → konfigurasi tujuan koneksi dengan /auth → minta agen mengerjakan tugas”. Namun, karena kuota Qwen OAuth gratis berakhir pada 15 April 2026, masuk sesuai penjelasan lama tidak lagi membuatnya berjalan gratis. Halaman ini menjelaskan secara berurutan cara memulai sesuai menu /auth saat ini, beralih ke tampilan Jepang, konfigurasi khusus untuk menggunakan Claude atau GPT, serta perintah yang sering digunakan. Versi terbaru adalah v0.24.7 yang dipublikasikan ke npm pada 29 September 2026; karena rilis dilakukan setidaknya sekali seminggu, periksa versi lokal Anda dengan qwen --version.

Instalasi

Berikut langkah dari README resmi. Dengan installer mandiri, Anda tidak perlu menyiapkan Node.js sendiri. Node.js 22 atau lebih baru hanya diperlukan jika menggunakan 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

Setelah instalasi, buka kembali terminal agar variabel lingkungan diterapkan. Qwen Code awalnya berbasis Google Gemini CLI v0.8.2, tetapi sejak v0.1 pengembangan dilakukan secara mandiri tanpa sinkronisasi dengan upstream. Pengaturan dan kuota gratis Gemini CLI tidak berlaku begitu saja.

Peluncuran pertama dan pengubahan ke bahasa Jepang

cd /path/to/your-project
qwen

# セッション内で：
/language ui ja-JP          # 画面表示を日本語に
/language output Japanese   # モデルの回答を日本語に
/auth                       # 接続先と API キーを設定

Dengan /language ui ja-JP layar menjadi berbahasa Jepang, dan layar berikutnya menampilkan terjemahan Qwen Code sendiri seperti “Pilih metode autentikasi” dan “Mode persetujuan alat”. Halaman ini juga menggunakan istilah yang sama. Bahasa jawaban terpisah dari bahasa UI dan ditentukan dengan /language output Japanese.

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

Memilih tujuan koneksi melalui /auth

Saat membuka /auth (juga disebut /login), layar “Pilih metode autentikasi” muncul dengan tiga pilihan tingkat teratas. Jika Anda mencoba memilih Qwen OAuth, akan muncul “Selesai — beralihlah ke Coding Plan atau API Key”.

Ketiga opsi ModelStudio bukan sekadar perbedaan cara membayar tagihan yang sama. Dokumentasi menetapkan endpoint dan kunci yang berbeda untuk masing-masing opsi, dan tidak akan berfungsi jika jenis kunci tidak cocok dengan baseUrl. Per 1 Oktober 2026, Coding Plan menampilkan “jumlah terbatas, berdasarkan urutan pendaftaran; diisi ulang setiap hari pukul 00.00 (UTC+8)”, sehingga ada hari ketika pendaftaran tersedia dan ada hari ketika tidak. Satu permintaan Coding Plan secara internal menjadi beberapa panggilan model; menurut Alibaba, tugas sederhana mengonsumsi 5–10 panggilan, sedangkan tugas kompleks mengonsumsi 10–30 panggilan atau lebih. Cara membandingkan harga dibahas secara rinci dalam versi bahasa Inggris Qwen Code pricing.

Menggunakan Claude atau GPT: mengonfigurasi Custom Provider di settings.json

Dokumentasi autentikasi Qwen Code merekomendasikan ~/.qwen/settings.json modelProviders untuk terhubung ke penyedia pihak ketiga seperti OpenAI, Anthropic, Google, OpenRouter, dan endpoint milik sendiri. Untuk Kunavo, konfigurasinya 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

Ada empat hal penting yang perlu diperhatikan.

• baseUrl hanya sampai /v1.Referensi penyedia model dengan jelas menyebutkan “tentukan rute /v1 API, bukan /v1/chat/completions. Jalur permintaan akan ditambahkan oleh SDK”. Jika jalur turut ditulis, yang muncul bukan kesalahan autentikasi melainkan 404.
• Lokasi kunci. Qwen Code membaca dari lingkungan menggunakan nama variabel yang ditentukan dalam envKey. Prioritasnya adalah export shell, .env (.qwen/.env direkomendasikan, hanya satu berkas pertama yang ditemukan), lalu env dalam settings.json; opsi terakhir menyimpan nilai dalam teks biasa sehingga tidak disarankan.
• Berkas konfigurasi mengalahkan flag CLI. Urutan resolusinya adalah nilai yang dimasukkan melalui /auth → modelProviders yang dipilih → argumen CLI → variabel lingkungan → settings.json. Karena itu --openai-base-url dapat tampak diabaikan. security.auth.apiKey dan security.auth.baseUrl yang disebut dalam panduan lama sudah tidak direkomendasikan.
• Mulailah dengan Chat Completions. Jika wireApi dihilangkan, format Chat Completions digunakan. Dengan "responses", tidak ada deteksi otomatis endpoint maupun fallback. Pengeditan modelProviders langsung berlaku pada sesi yang sedang berjalan (dapat dilihat setelah membuka kembali /model).

Katalog Kunavo tidak memiliki model teks Qwen. Ini bukan cara murah untuk menggunakan Qwen, melainkan cara menggunakan Claude atau GPT di dalam Qwen Code dengan satu saldo prabayar. Selain itu, Kunavo belum memverifikasi Qwen Code secara langsung terhadap endpoint miliknya. Konfigurasi ini dibuat dari dokumentasi resmi, sama seperti halaman pengaturan Qwen Code berbahasa Inggris. Pertahankan jalur yang sedang berjalan saat mencobanya.

Tugas pertama dan perintah yang sering digunakan

Sesuai contoh README, mulailah dengan permintaan seperti “jelaskan repositori ini dan beri tahu saya harus mulai membaca dari mana” agar Anda dapat memastikan pembacaan file dan pemanggilan alat berjalan sebagaimana mestinya. Sapaan saja tidak akan menemukan masalah koneksi.

Mode persetujuan otomatis seperti yolo diperingatkan oleh dokumentasi itu sendiri agar “hanya digunakan di lingkungan tepercaya, sandbox, atau sekali pakai”. Perkiraan biaya /stats model dihitung oleh Qwen Code dan bukan jumlah tagihan itu sendiri. Periksa jumlah aktual dalam catatan penggunaan endpoint tujuan.

Batasan yang perlu diketahui

• web_search bawaan ditentukan oleh tujuan koneksi. Karena menggunakan pencarian sisi server DashScope, fitur ini aktif untuk Standard API Key dan Token Plan ModelStudio serta entri yang menunjuk ke host DashScope yang dikenali; tidak aktif untuk Coding Plan (karena belum diverifikasi pada endpoint tersebut), penyedia pihak ketiga, atau endpoint khusus pada host lain (dokumentasi web_search). Jika diperlukan, tambahkan server pencarian MCP.
• Jalur Kunavo hanya untuk chat. Kunavo tidak memiliki model embedding, text-to-speech, atau speech-to-text. Live Voice Qwen Code wajib menggunakan endpoint DashScope, sehingga apa pun tujuan model chat, fitur tersebut tetap memerlukan kunci lain.

Pembayaran saat mencoba Kunavo

Kunavo menggunakan sistem pengisian prabayar tanpa biaya bulanan; saldo dipotong berdasarkan token. Pengisian minimum adalah $10, dan checkout Stripe menerima kartu (Visa, Mastercard, American Express, JCB), Apple Pay, Google Pay, dan Link. Tinjau penjelasan penagihan, lalu buat akun untuk menerbitkan kunci. Setelah permintaan pertama, cara paling pasti untuk memeriksa jumlah yang benar-benar ditagihkan adalah melalui catatan penggunaan.

Pertanyaan umum

Diverifikasi pada 1 Oktober 2026: README Qwen Code; dokumentasi autentikasi, penyedia model, perintah, dan web_search (cabang main); string UI bahasa Jepang (packages/cli/src/i18n/locales/ja.js); npm @qwen-code/qwen-code 0.24.7; serta halaman Coding Plan dan Token Plan Alibaba Cloud. Kunavo belum menjalankan Qwen Code terhadap endpoint miliknya.