Blog

Cara Menjalankan Qwen Code di Terminal dan Menyiapkan Mode Pengeditan

Markdown

Menginstal Qwen Code, menjalankannya di dalam proyek, menghubungkan model melalui auth, mode Plan, Auto-Edit, Auto, dan YOLO, model lokal, serta perlindungan proyek.

Baca artikel lengkap

Pertanyaannya kira-kira begini: bagaimana membuat Qwen bekerja dengan benar di konsol dan menulis kode sendiri? Biasanya, di balik pertanyaan itu ada kekecewaan: seseorang menginstal Qwen Code, mengajukan pertanyaan, lalu mendapat teks dan sepotong kode sebagai jawaban yang harus disalin secara manual, padahal ia dijanjikan agen yang akan masuk ke proyek dan mengerjakan semuanya sendiri.

Itulah tepatnya Qwen Code: agen yang lengkap. Agen ini dapat membuka file, mengeditnya, dan menjalankan perintah sendiri. Perilakunya bergantung pada mode persetujuan aktif: Ask Permissions meminta konfirmasi, sedangkan Auto-Edit dan Auto mengizinkan pekerjaan lebih mandiri. Periksa baris status alih-alih menganggap mode bernama Default sebagai pilihan awal instalasi. Berikut urutannya: instalasi, menjalankannya di dalam proyek, menghubungkan model setelah perubahan pada bulan April, lalu beralih ke mode yang memungkinkan agen mengedit kode tanpa bertanya hal yang tidak perlu. Semuanya diperiksa berdasarkan dokumentasi resmi Qwen per 30 Agustus 2026.

Sumber praktis tentang model dan agen: dokumentasi Ailoot.

Apa Arti “Qwen Code Menulis Kode Sendiri”?

Poin utama

Qwen Code adalah agen AI di terminal. Agen ini membaca seluruh proyek, membuka dan mengedit file sendiri, menjalankan perintah, lalu memeriksa hasilnya. Obrolan di browser memberi Anda teks yang perlu dipindahkan secara manual. Agen bekerja langsung di dalam folder kode. Deskripsi resminya adalah “agen coding AI sumber terbuka yang berjalan di terminal Anda.”

Perbedaannya sederhana. Obrolan di browser menjawab pertanyaan dengan teks. Anda membaca jawabannya, menyalin kode, menempelkannya ke file, menjalankannya sendiri, menemukan kesalahannya sendiri, lalu membawanya kembali ke obrolan. Anda menjadi kurir antara obrolan dan proyek.

Agen bekerja dengan cara berbeda. Anda memberinya tugas dalam bahasa sehari-hari: “tambahkan formulir umpan balik,” “perbaiki kesalahan ini.” Lalu agen memeriksa struktur proyek, menemukan file yang relevan, membuat perubahan, dan menjalankan pemeriksaan. Dokumentasinya menjelaskan dengan lugas: agen membuat rencana, menulis kode, dan memastikan semuanya berfungsi.

Dari sinilah kebingungan dalam pertanyaan itu muncul. “Qwen tidak menulis kode sendiri” hampir selalu berarti salah satu dari dua hal: orang tersebut membuka obrolan di browser alih-alih agen terminal, atau agennya berjalan tetapi disetel ke mode yang meminta izin untuk setiap pengeditan. Solusi untuk yang pertama adalah menginstal Qwen Code; untuk yang kedua, beralih mode. Keduanya dibahas di bawah.

Bagaimana Cara Menginstal Qwen Code di Terminal?

Poin utama

Instalasinya cukup dengan satu perintah. Di macOS dan Linux, gunakan penginstal resmi Qwen atau npm (Node.js 22 atau versi lebih baru diperlukan). Di Windows, gunakan perintah di PowerShell. Setelah instalasi, mulai ulang terminal, jika tidak, perintah qwen mungkin tidak ditemukan. Instalasi gratis dan sama untuk semua orang; biaya baru muncul nanti, saat Anda mengakses model.

Cara tercepat adalah menggunakan penginstal resmi, yang memilih versi untuk sistem Anda secara otomatis.

Di macOS dan Linux, buka terminal lalu tempelkan satu baris ini:

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Di Windows, lakukan hal yang sama dengan perintah PowerShell ini:

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

Pilihan kedua adalah npm, jika sudah terinstal. Anda memerlukan Node.js versi 22 atau lebih baru:

npm install -g @qwen-code/qwen-code@latest

Setelah instalasi, mulai ulang terminal. Penginstal menambahkan perintah qwen ke jalur sistem, dan terminal tidak akan mengetahuinya sebelum dimulai ulang—itulah alasan paling umum untuk pesan “saya sudah menginstalnya, tetapi perintahnya tidak ditemukan.” Untuk memeriksa apakah semuanya sudah terinstal, jalankan:

qwen --version

Jika Anda melihat nomor versi, berarti agen sudah terinstal dan siap dijalankan di proyek Anda.

Bagaimana Cara Menjalankan Qwen Code di Proyek?

Poin utama

Buka folder proyek dengan perintah cd, lalu ketik qwen. Antarmuka terminal agen akan terbuka. Saat pertama kali dijalankan, agen akan meminta Anda menghubungkan model melalui menu /auth. Setelah itu, Anda dapat menuliskan tugas dalam bahasa sehari-hari—agen akan memeriksa proyek dan mulai bekerja. Intinya: jalankan agen dari folder proyek agar agen dapat melihat semua file Anda.

Pertama, buka folder yang berisi kode Anda. Ini penting: agen bekerja di folder tempat agen dijalankan dan hanya dapat melihat isinya.

cd path-to-your-project
qwen

Antarmuka agen akan terbuka langsung di terminal. Saat pertama kali dijalankan, agen akan menawarkan untuk menghubungkan model; hal itu dibahas di bagian berikutnya. Setelah model terhubung, Anda dapat memberi agen tugas dalam bahasa sehari-hari untuk melihat apa saja yang dapat diaksesnya:

what does this project do?

Agen akan membaca file, memahami strukturnya, lalu memberi Anda jawaban yang berguna. Setelah itu, Anda bisa memintanya menulis dan mengedit kode: “tambahkan tombol logout,” “pecah file ini menjadi dua,” “cari tahu mengapa tes gagal.” Agen menemukan bagian yang relevan dan membuat perubahan sendiri.

Ada juga cara kedua untuk menjalankannya—dengan satu perintah, tanpa antarmuka. Cara ini berguna untuk skrip dan tugas otomatis:

qwen -p "reread README and update the list of commands"

Cara ini menjalankan tugas lalu keluar, tanpa percakapan. Anda belum memerlukannya untuk langkah awal, tetapi ada baiknya mengetahuinya untuk nanti.

Mengapa Agen Berjalan tetapi Tidak Melakukan Apa Pun Sendiri?

Poin utama

Jika Ask Permissions aktif, Qwen Code menunggu konfirmasi Anda sebelum edit dan perintah. Selain itu, model harus terhubung sebelum agen dapat mengedit: Alibaba menutup akses gratis melalui qwen.ai pada 15 April 2026, dan tanpa akses ke model yang terhubung, agen benar-benar tidak dapat memikirkan tugas. Dua alasan umum mengapa agen “hanya diam” adalah tidak ada model yang terhubung atau mode berhati-hati dengan permintaan konfirmasi sedang aktif.

Hambatan pertama adalah akses ke model. Qwen Code sebelumnya menyediakan akses gratis: Anda masuk dengan akun qwen.ai, lalu agen bekerja tanpa kartu. Akses itu disebut Qwen OAuth dan kini telah dihentikan. Dokumentasi otorisasi menyatakannya secara langsung: tingkat gratis Qwen OAuth dihentikan pada 15 April 2026; login yang tersimpan sebelumnya mungkin masih berfungsi untuk sementara, tetapi server menolak permintaan baru. Opsi “masuk dengan qwen.ai” juga dihapus dari menu.

Jadi, agar agen mulai memikirkan tugas, Anda perlu menghubungkan model. Bagian berikutnya membahas pilihan koneksi, baik yang berbayar maupun lokal gratis.

Alasan kedua lebih sulit disadari dan lebih menjengkelkan. Model sudah terhubung, agen merespons, tetapi tidak mengedit file apa pun—agen hanya menunjukkan rencana tindakannya lalu menunggu. Perilaku itu sesuai dengan mode Ask Permissions, yang meminta konfirmasi sebelum edit dan perintah; itu bukan bukti mode awal universal. Agar agen bekerja sendiri, Anda perlu beralih mode. Hal itu dibahas dua bagian lagi di bawah, tempat Anda akan menemukan jawaban atas pertanyaan awal.

Bagaimana Cara Menghubungkan Model Sekarang Setelah Akses Gratis Ditutup?

Poin utama

Saat pertama kali dijalankan, perintah /auth membuka menu dengan tiga opsi. Alibaba ModelStudio adalah opsi resmi berbayar (pengguna perorangan dapat memperoleh Coding Plan dengan kuota mingguan). Penyedia pihak ketiga terhubung menggunakan kunci ke DeepSeek, Kimi, dan lainnya. Custom Provider menghubungkan model Anda sendiri atau model lokal melalui Ollama dan alat serupa. Hanya opsi terakhir—model lokal—yang dapat digunakan gratis tanpa kartu.

Di dalam agen, ketik perintah:

/auth

Menu dengan tiga opsi utama akan terbuka. Berikut fungsi masing-masing.

Alibaba ModelStudio adalah opsi resmi dari pembuat Qwen. Tersedia Coding Plan dengan harga tetap dan kuota mingguan untuk pengembang perorangan, Token Plan dengan harga bayar sesuai pemakaian untuk tim, serta opsi untuk menghubungkan kunci ModelStudio yang sudah ada. Ini adalah akses berbayar ke model “asli” Qwen.

Penyedia pihak ketiga memungkinkan Anda memilih penyedia bawaan dan menghubungkan akun dengan kunci. Daftar resmi mencakup DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope, dan lainnya. Dapatkan kunci dari penyedia, masukkan kunci itu, lalu agen akan menggunakan model dari penyedia tersebut.

Custom Provider menghubungkan server, proksi, atau mesin lokal Anda sendiri. Di sinilah Anda menghubungkan model yang berjalan di komputer melalui Ollama. Opsi ini mendukung format OpenAI, Anthropic, dan Gemini, sehingga dapat digunakan dengan hampir semua metode akses.

Anda juga dapat memasukkan kunci dan pengaturan secara manual di file ~/.qwen/settings.json. File ini memiliki kolom modelProviders (model yang tersedia), env (kunci itu sendiri), security.auth.selectedType (protokol yang diaktifkan saat mulai), dan model.name (model default). Setelah itu, qwen akan berjalan dengan pengaturan tersebut dan tidak akan menanyakan apa pun. Untuk pertama kali, lebih mudah menggunakan /auth; Anda dapat kembali ke file itu nanti jika ingin menyimpan semua pengaturan.

Untuk melihat apa yang masih gratis setelah April, baca artikel tentang Qwen Code gratis.

Mode Mana yang Harus Diaktifkan agar Agen Mengedit Kode Sendiri?

Poin utama

Dokumentasi lima mode Qwen Code menyebut Auto sebagai default dalam referensi singkatnya, sementara bagian Ask Permissions masih memuat redaksi mode awal lama. Halaman tanpa versi ini tidak membuktikan default setiap instalasi: periksa mode aktif sesi Anda. Auto memakai pengklasifikasi untuk menyetujui atau memblokir tindakan yang dievaluasi. Jika Anda ingin agen mengedit file tanpa meminta konfirmasi, gunakan Auto-Edit. Jika Anda siap membiarkannya mengedit dan menjalankan perintah tanpa bertanya sama sekali, gunakan YOLO—tetapi hanya di proyek pribadi Anda dan dengan hati-hati. Mode inilah yang menentukan apakah agen “menanyakan segala hal” atau “bekerja sendiri.”

Inti gagasannya begini: mode akses menentukan seberapa mandiri agen bertindak, dan ada lima mode, dari yang paling berhati-hati hingga yang paling longgar.

ModeMengedit fileMenjalankan perintahKegunaan
Plantidak, hanya bacatidakMemahami proyek dan menyusun rencana tanpa mengubah apa pun
Ask Permissionsdengan konfirmasidengan konfirmasiKode yang belum dikenal atau penting, saat Anda ingin melihat setiap langkah
Auto-Editsendiridengan konfirmasiBanyak pengeditan kecil, sementara perintah tetap dalam kendali Anda
Autoberdasarkan penilaian keamananberdasarkan penilaian keamananPekerjaan mandiri jangka panjang dengan perlindungan
YOLOsendirisendiriProyek pribadi Anda, saat Anda memercayakan semuanya kepada agen

Jika agen hanya menunjukkan pengeditan lalu menunggu, kemungkinan besar agen berada dalam mode Ask Permissions (disebut Default di versi lama). Anda harus mengonfirmasi setiap pengeditan dan perintah secara manual, sehingga terasa seolah agen tidak melakukan apa pun sendiri.

Agar agen mengedit file tanpa meminta konfirmasi, beralihlah ke Auto-Edit. Pengeditan akan berlangsung otomatis, tetapi agen tetap meminta persetujuan sebelum menjalankan perintah—perlindungan yang masuk akal agar rm tidak dijalankan di lokasi yang salah secara tidak sengaja.

Auto menggunakan evaluator internal untuk tindakan yang memerlukan penilaian. Pilih secara sengaja setelah memeriksa versi terpasang dan status aktif; kata default yang dipertahankan dalam konfigurasi Ask Permissions adalah nama kompatibilitas, bukan bukti bahwa itulah mode awal.

YOLO adalah mode yang paling longgar. Agen mengedit file dan menjalankan perintah sendiri, tanpa bertanya apa pun. Dokumentasi menyatakan bahwa mode ini hanya untuk proyek pribadi tepercaya dan alur kerja otomatis. Hasil yang tidak diinginkan mudah terjadi dalam proyek kerja, jadi aktifkan mode ini hanya saat Anda berpikiran jernih dan, sebaiknya, gunakan salinan proyek.

Bagaimana Cara Beralih Mode Selama Sesi?

Poin utama

Selagi tetap berada di dalam agen, tekan Shift+Tab (di Windows, Tab), dan mode akan berganti dalam urutan: Plan, konfirmasi, pengeditan otomatis, Auto, YOLO, lalu kembali ke Plan. Mode saat ini ditampilkan pada baris status di bagian bawah layar. Alur kerja yang praktis adalah memulai dengan Plan, meninjau tugas, lalu beralih ke Auto-Edit atau Auto dan membiarkan agen bekerja.

Anda dapat beralih mode sambil bekerja, bahkan di tengah tugas. Tekan Shift+Tab untuk maju ke mode berikutnya. Di Windows, tombol Tab biasa memiliki fungsi yang sama. Urutannya adalah Plan, lalu konfirmasi, lalu pengeditan otomatis, lalu Auto, lalu YOLO, kemudian kembali ke Plan.

Mode saat ini selalu ditampilkan pada baris status di bagian bawah antarmuka. Biasakan memeriksanya sebelum memberikan tugas besar kepada agen agar Anda tidak menjalankan YOLO saat hanya ingin melihat rencana.

Alur kerja yang ramah bagi pemula terdiri dari tiga langkah:

  1. Jalankan agen dalam mode Plan dan minta agen menganalisis tugas serta mengusulkan rencana. Agen tidak akan menyentuh apa pun; agen hanya akan membaca kode dan menjelaskan apa yang hendak dilakukan.
  2. Baca rencananya. Jika Anda setuju, beralihlah ke Auto-Edit atau Auto dengan menekan Shift+Tab.
  3. Minta agen melanjutkan. Kini agen akan mengedit file sendiri sementara Anda memantau hasilnya.

Pendekatan ini menghilangkan ketakutan utama pemula—bahwa agen akan langsung merusak semuanya. Pertama, Anda meninjau rencana dalam mode aman, baru setelah itu membiarkan agen melanjutkan.

Model Lokal Tanpa Kartu

Poin utama

Ya, Anda dapat menggunakan model lokal. Qwen Code dapat bekerja dengan model yang berjalan langsung di komputer melalui Ollama atau program serupa—hubungkan model dari menu sebagai Custom Provider. Anda tidak memerlukan layanan cloud Alibaba untuk ini. Model terbuka dapat diunduh gratis, tidak perlu kartu, dan data proyek Anda tidak meninggalkan komputer. Komprominya: Anda memerlukan komputer yang bertenaga, atau agen akan berpikir dengan lambat.

Instal model terbuka di komputer melalui Ollama atau vLLM, lalu hubungkan sebagai Custom Provider dari menu /auth. Setelah itu, agen menggunakan model di komputer Anda sendiri, bukan layanan cloud Alibaba. Tidak perlu kartu atau kunci, dan tidak ada batas permintaan. Untuk melihat model terbuka mana yang mampu menangani coding, baca ulasan model coding gratis ini.

Komprominya adalah perangkat keras. Model yang mampu menulis kode dengan cukup baik memerlukan banyak memori video. Penggunaan model ini memungkinkan dilakukan di komputer gaming dengan kartu grafis bertenaga, tetapi modelnya mungkin tidak muat di laptop biasa. Kalaupun muat, proses berpikir untuk setiap jawaban bisa begitu lama hingga lebih mudah mencari pilihan lain.

Manfaat lain menjalankan model secara lokal adalah privasi data. Semua kode Anda tetap berada di komputer; tidak ada yang dikirim ke server pihak lain. Untuk proyek sensitif, hal ini lebih penting daripada menghemat biaya langganan.

Bagaimana Cara Mencegah Agen Merusak Proyek?

Poin utama

Ada tiga hal. Simpan proyek dalam kendali versi git agar Anda dapat membatalkan pengeditan agen dengan satu perintah. Mulai tugas dalam mode Plan dan baca rencananya sebelum membiarkan agen melanjutkan. Jangan aktifkan YOLO pada proyek kerja—gunakan hanya untuk salinan dan eksperimen kecil. Dengan begitu, kemandirian agen akan menguntungkan Anda.

Agen yang mandiri memang nyaman selama agen melakukan apa yang Anda inginkan. Agar satu kesalahan langkah tidak merugikan Anda, lakukan tiga kebiasaan berikut.

Pertama, gunakan git. Jika proyek berada dalam kendali versi, Anda dapat melihat setiap perubahan agen dan membatalkan perubahan apa pun. Agen mandiri memang berisiko tanpa git: agen mengubah sesuatu, dan tidak ada cara untuk memulihkan versi sebelumnya. Dengan git, Anda dapat membatalkan perubahan menggunakan satu perintah singkat.

Kedua, mulai dengan mode Plan. Sebelum memberi agen tugas besar, minta agen membuat rencana dalam mode yang tidak menyentuh apa pun. Baca dan pahami apa yang hendak dilakukan agen, lalu beralih ke mode pengeditan.

Ketiga, berhati-hatilah dengan YOLO. Dalam mode ini, agen menjalankan perintah sendiri, termasuk perintah yang menghapus file. Mode ini terlalu berisiko untuk proyek kerja. Gunakan YOLO hanya untuk salinan kasar dan tugas kecil yang tidak akan menjadi masalah jika terjadi kesalahan.

Tiga kebiasaan ini mengatasi ketakutan utama—“saya melakukan vibe coding dan merusaknya.” Untuk informasi lebih lanjut tentang membatalkan perubahan dalam vibe coding, baca ulasan terpisah ini. Artikel itu membahas Claude Code, tetapi prinsip menggunakan git sama persis.

Dari Mana Sebaiknya Anda Memulai untuk Tugas Anda?

Poin utama

Instal Qwen Code, buka folder proyek, jalankan qwen, lalu hubungkan model melalui /auth—model berbayar atau model lokal melalui Ollama. Kemudian mulai dalam mode Plan, baca rencananya, beralih ke Auto-Edit dengan menekan Shift+Tab, lalu biarkan agen bekerja. Simpan proyek dalam kendali versi git. Seluruh penyiapan pertama kali memerlukan waktu sekitar dua puluh menit.

Berikut seluruh proses dalam bentuk daftar singkat. Ikuti dari atas ke bawah:

  1. Instal Qwen Code dengan satu perintah lalu mulai ulang terminal.
  2. Buka folder proyek dengan cd lalu jalankan qwen.
  3. Hubungkan model melalui /auth: paket berbayar atau model lokal melalui Ollama jika membayar dengan kartu bukan pilihan.
  4. Berikan tugas kepada agen dalam mode Plan dan baca rencananya.
  5. Beralih ke Auto-Edit atau Auto dengan Shift+Tab, lalu biarkan agen bekerja.
  6. Simpan proyek dalam kendali versi git agar Anda dapat membatalkan pengeditan apa pun.

Singkatnya, “Qwen tidak menulis kode sendiri” hampir selalu berarti model belum terhubung atau agen berada dalam mode konfirmasi. Atasi yang pertama melalui menu /auth, dan yang kedua dengan menekan Shift+Tab sampai mencapai Auto-Edit. Setelah itu, agen benar-benar bekerja sendiri di terminal.

Jika Anda ingin membandingkan Qwen dengan agen lain untuk tugas Anda, baca ulasan alternatif Claude Code ini. Qwen dibahas bersama yang lainnya, sehingga Anda dapat melihat mana yang sesuai untuk setiap kebutuhan.

Sumber

Sumber daya dan alat lainnya: Ailoot.

Rincian selengkapnya

Pertanyaan tentang Cara Menjalankan Qwen Code di Terminal dan Menyiapkan Mode Pengeditan | Ailoot

Mengapa Qwen Code menampilkan usulan perubahan dan menunggu?

Periksa mode aktif pada baris status. Ask Permissions menunggu konfirmasi; Plan untuk analisis. Auto-Edit mengizinkan edit sambil mempertahankan persetujuan perintah, dan akses model juga harus dikonfigurasi.

Apakah mode bernama Default membuktikan mode awal instalasi baru?

Tidak. Nama lama Default dipertahankan untuk kompatibilitas Ask Permissions, sedangkan referensi singkat dokumentasi menyebut Auto sebagai default. Periksa versi terpasang dan mode sesi aktif, alih-alih menyimpulkannya dari nama.

Semua artikel