Menyiapkan Qwen Code: Instalasi, penyedia, antarmuka bahasa Jerman, dan API

Qwen Code adalah agen coding AI sumber terbuka (Apache-2.0) dari tim Qwen milik Alibaba. Penyiapannya terdiri dari empat langkah: instal, jalankan qwen di proyek, pilih provider dengan /auth, lalu berikan tugas. Penting diketahui sebelumnya: kuota Qwen OAuth gratis berakhir pada 15 April 2026 — siapa pun yang mengikuti panduan lama tidak lagi dapat melanjutkan secara gratis dengan cara tersebut. Halaman ini mengikuti menu /auth terbaru, menunjukkan cara beralih ke bahasa Jerman, menyiapkan endpoint sendiri untuk Claude atau GPT, serta perintah-perintah penting. Versi terbaru adalah v0.24.7, diterbitkan di npm pada 29 September 2026; rilis hadir setidaknya setiap minggu, periksa versi Anda dengan qwen --version.

Instalasi

Perintah-perintah ini berasal dari README resmi. Dengan installer mandiri, Anda tidak perlu menyediakan Node.js sendiri; hanya instalasi npm yang mewajibkan Node.js 22 atau yang lebih baru.

# macOS / Linux (offizieller Standalone-Installer)
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 (benötigt Node.js 22 oder neuer)
npm install -g @qwen-code/qwen-code@latest

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

Buka kembali terminal setelah itu agar variabel lingkungan diterapkan. Qwen Code awalnya didasarkan pada Google Gemini CLI v0.8.2, tetapi sejak v0.1 dikembangkan secara independen dan tidak lagi diselaraskan dengan versi asli. Pengaturan dan kuota Gemini CLI tidak berlaku di sini.

Pemula dan antarmuka bahasa Jerman

cd /pfad/zu/ihrem-projekt
qwen

# in der Sitzung:
/language ui de-DE        # Oberfläche auf Deutsch
/language output German   # Antworten des Modells auf Deutsch
/auth                     # Anbieter und API-Key einrichten

Setelah /language ui de-DE, Qwen Code menampilkan istilah bahasa Jermannya sendiri, seperti „Authentifizierungsmethode auswählen“ atau „Werkzeug-Genehmigungsmodus“; halaman ini menggunakan istilah yang sama. Bahasa jawaban terpisah dari pengaturan tersebut dan ditetapkan dengan /language output German.

Selain terminal, tersedia aplikasi desktop, antarmuka web di browser (qwen serve --open, eksperimental), integrasi untuk VS Code, Zed, dan JetBrains, serta mode tanpa antarmuka untuk skrip dan CI (qwen -p "..."). Semuanya berada di repositori gratis yang sama; inferensi dibayar secara terpisah.

Memilih provider dengan /auth

/auth (alias /login) membuka „Authentifizierungsmethode auswählen“ dengan tiga opsi tingkat teratas. Jika masih ingin memilih Qwen OAuth, Anda akan melihat: „Dihentikan — beralihlah ke Coding Plan atau API Key“.

Ketiga jalur ModelStudio bukan tiga metode pembayaran untuk tagihan yang sama: dokumentasi memberikan endpoint dan key tersendiri untuk masing-masing, dan jenis key serta baseUrl harus sesuai. Pada 1 Oktober 2026, Coding Plan tercantum sebagai „tersedia secara terbatas, siapa cepat dia dapat, diisi ulang setiap hari pukul 00.00 (UTC+8)“ — jadi mungkin tidak dapat dipesan pada hari tertentu. Satu tugas menghabiskan beberapa pemanggilan model dalam Coding Plan; Alibaba menyebutkan biasanya 5–10 untuk tugas sederhana dan 10–30 atau lebih untuk tugas kompleks. Halaman berbahasa Inggris harga Qwen Code membahas perbandingan biaya secara terperinci.

Menggunakan Claude atau GPT: Custom Provider dalam settings.json

Dokumentasi autentikasi merekomendasikan blok modelProviders dalam ~/.qwen/settings.json untuk provider pihak ketiga seperti OpenAI, Anthropic, Google, OpenRouter, atau endpoint sendiri. Untuk Kunavo, bentuknya seperti ini:

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

# Den Key nicht in settings.json schreiben, sondern in .qwen/.env oder die Umgebung
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Empat hal yang menghemat waktu saat melakukan pemecahan masalah:

• baseUrl diakhiri dengan /v1. Referensi Model Providers menyatakan secara eksplisit: tetapkan ke root /v1 API, bukan ke /v1/chat/completions — SDK sendiri yang menambahkan path tersebut. Dengan path tersebut, hasilnya 404, bukan kesalahan autentikasi.
• Lokasi key. Qwen Code membacanya dari variabel lingkungan yang disebutkan oleh envKey. Urutannya: export shell, lalu file .env (disarankan .qwen/.env; hanya file pertama yang ditemukan yang digunakan), terakhir env dalam settings.json — key tersimpan sebagai teks biasa di sana.
• File mengalahkan opsi CLI. Urutannya: nilai dari /auth → entri modelProviders yang dipilih → argumen CLI → variabel lingkungan → settings.json. Karena itu --openai-base-url terkadang tidak berpengaruh. security.auth.apiKey dan security.auth.baseUrl dari panduan lama sudah usang.
• Mulai dengan Chat Completions. Tanpa wireApi, Chat Completions yang digunakan. Dengan "responses", tidak ada deteksi endpoint maupun fallback otomatis. Perubahan pada modelProviders juga berlaku dalam sesi yang sedang berjalan (/model untuk membukanya kembali).

Katalog Kunavo tidak memiliki model teks Qwen. Jadi ini bukan cara yang lebih murah untuk menggunakan Qwen, melainkan cara menggunakan Claude atau GPT dalam Qwen Code melalui saldo prabayar. Kunavo juga tidak menjalankan Qwen Code sendiri terhadap endpoint-nya; seperti halaman bahasa Inggris penyiapan Qwen Code, konfigurasi ini berasal dari dokumentasi resmi. Pertahankan rute yang berfungsi saat Anda mencobanya.

Tugas pertama dan perintah penting

README secara garis besar menyarankan tugas pertama berikut: „Jelaskan repositori ini dan tunjukkan kepada saya dari mana harus memulai.“ Ini sekaligus memeriksa akses file dan pemanggilan alat — sapaan sederhana „Halo“ tidak akan mengungkap masalah koneksi.

Untuk yolo dan mode otomatis lainnya, dokumentasi sendiri memperingatkan: gunakan hanya di lingkungan tepercaya, terisolasi, atau sekali pakai. Perkiraan biaya dalam /stats model dihitung sendiri oleh Qwen Code; jumlah sebenarnya tercantum dalam log penggunaan provider Anda.

Batasan yang perlu Anda ketahui

• Pencarian web bawaan bergantung pada host. Fitur ini menggunakan pencarian sisi server DashScope: aktif untuk ModelStudio Standard API Key dan Token Plan serta entri pada host DashScope yang terdeteksi, nonaktif untuk Coding Plan (belum diverifikasi di sana), dan nonaktif untuk provider pihak ketiga serta endpoint sendiri pada host lain (dokumentasi web_search). Alternatifnya: server pencarian MCP.
• Kunavo hanya menyediakan chat. Kunavo tidak menyediakan model embedding, text-to-speech, atau speech-to-text. Live Voice Qwen Code tetap memerlukan endpoint DashScope dan menggunakan key miliknya sendiri, ke mana pun model chat diarahkan.

Membayar saat mencoba Kunavo

Kunavo bekerja dengan saldo prabayar tanpa langganan dan menagih berdasarkan token. Isi ulang minimum adalah $10; checkout Stripe menyediakan kartu (Visa, Mastercard, American Express), Apple Pay, Google Pay, dan Link, serta EPS di Austria — debit langsung SEPA saat ini tidak tersedia. Stripe hanya menawarkan Pay by Bank kepada pembeli di Britania Raya, Irlandia, dan Finlandia; di Jerman, fitur ini sejauh ini hanya tersedia sebagai pratinjau tertutup (dokumentasi Stripe, per 3 Oktober 2026). Detail tersedia di Billing; buat key dengan akun. Setelah tugas pertama, log penggunaan menampilkan jumlah sebenarnya.

Pertanyaan umum

Diverifikasi pada 1 Oktober 2026: README Qwen Code, dokumentasi tentang autentikasi, Model Providers, perintah, dan web_search (branch main), teks UI berbahasa Jerman (packages/cli/src/i18n/locales/de.js), @qwen-code/qwen-code 0.24.7 di npm, serta halaman Alibaba Cloud tentang Coding Plan dan Token Plan. Kunavo tidak menjalankan Qwen Code terhadap endpoint-nya.