Cara Menjalankan Qwen Code di Terminal dan Menetapkan Mod Suntingan
MarkdownMemasang Qwen Code, melancarkannya dalam projek, menyambungkan model melalui pengesahan, mod Plan, Auto-Edit, Auto dan YOLO, model setempat serta perlindungan projek.
Baca artikel penuh
Soalannya biasanya begini: bagaimana hendak membuat Qwen berfungsi dengan betul dalam konsol dan menulis kod dengan sendiri? Selalunya, di sebaliknya ada rasa kecewa: seseorang memasang Qwen Code, mengemukakan soalan lalu mendapat teks dan cebisan kod sebagai jawapan yang perlu disalin secara manual, sedangkan mereka dijanjikan ejen yang akan masuk ke dalam projek dan melakukan semuanya sendiri.
Itulah sebenarnya Qwen Code: ejen yang lengkap. Ia boleh membuka dan mengedit fail serta menjalankan arahan sendiri. Tingkah lakunya bergantung pada mod kelulusan aktif: Ask Permissions meminta pengesahan, sementara Auto-Edit dan Auto membenarkan kerja lebih autonomi. Semak bar status daripada menganggap mod bernama Default ialah pilihan pemasangan baharu. Di bawah, mengikut turutan: pemasangan, melancarkannya dalam projek, menyambungkan model selepas perubahan pada bulan April, dan bertukar kepada mod yang membolehkan ejen mengedit kod tanpa bertanya soalan yang tidak perlu. Semuanya disemak berdasarkan dokumentasi rasmi Qwen setakat 30 Ogos 2026.
Sumber praktikal tentang model dan ejen: dokumentasi Ailoot.
Apakah Maksud “Qwen Code Menulis Kod dengan Sendiri”?
Inti pati
Qwen Code ialah ejen AI dalam terminal. Ia membaca keseluruhan projek, membuka dan mengedit fail sendiri, menjalankan arahan serta menyemak hasilnya. Sembang dalam pelayar memberikan teks yang perlu anda pindahkan secara manual. Ejen bekerja terus dalam folder kod. Keterangan rasminya ialah “an open-source AI coding agent that lives in your terminal.”
Perbezaannya mudah. Sembang dalam pelayar menjawab soalan dengan teks. Anda membaca jawapan, menyalin kod, menampalnya ke dalam fail, menjalankannya sendiri, mengesan ralat sendiri dan membawanya semula ke dalam sembang. Anda menjadi orang tengah antara sembang dengan projek.
Ejen berfungsi dengan cara yang berbeza. Anda memberinya tugasan dalam bahasa biasa: “tambah borang maklum balas,” “betulkan ralat ini.” Kemudian, ia meneliti struktur projek, mencari fail yang berkaitan, membuat perubahan dan menjalankan semakan. Dokumentasi menerangkannya dengan jelas: ejen membuat pelan, menulis kod dan memastikan kod itu berfungsi.
Di sinilah timbulnya kekeliruan dalam soalan tersebut. “Qwen tidak menulis kod dengan sendiri” hampir selalu bermaksud salah satu daripada dua perkara: sama ada orang itu membuka sembang dalam pelayar dan bukannya ejen terminal, atau ejen sedang berjalan tetapi ditetapkan kepada mod yang meminta kebenaran bagi setiap suntingan. Cara mengatasi masalah pertama ialah memasang Qwen Code; cara mengatasi masalah kedua ialah menukar mod. Kedua-duanya diterangkan di bawah.
Bagaimanakah Cara Memasang Qwen Code dalam Terminal?
Inti pati
Pemasangannya hanya memerlukan satu arahan. Pada macOS dan Linux, gunakan pemasang rasmi Qwen atau npm (Node.js 22 atau lebih baharu diperlukan). Pada Windows, gunakan arahan dalam PowerShell. Selepas pemasangan, mulakan semula terminal, jika tidak, arahan qwen mungkin tidak ditemui. Pemasangan adalah percuma dan sama untuk semua orang; kos hanya bermula kemudian apabila anda mengakses model.
Cara terpantas ialah menggunakan pemasang rasmi, yang memilih versi untuk sistem anda secara automatik.
Pada macOS dan Linux, buka terminal lalu tampal satu baris ini:
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
Pada Windows, lakukan perkara yang sama dengan arahan PowerShell ini:
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex
Pilihan kedua ialah npm, jika anda sudah memasangnya. Pilihan ini memerlukan Node.js versi 22 atau lebih baharu:
npm install -g @qwen-code/qwen-code@latest
Selepas pemasangan, mulakan semula terminal. Pemasang menambah arahan qwen ke laluan sistem, dan terminal tidak akan mengenalinya sehingga anda memulakan semula terminal. Inilah sebab paling lazim bagi mesej “Saya sudah memasangnya, tetapi arahan itu tidak ditemui.” Untuk menyemak sama ada semuanya telah dipasang, jalankan:
qwen --version
Jika nombor versi dipaparkan, ejen telah dipasang dan sedia untuk dilancarkan dalam projek anda.
Bagaimanakah Cara Menjalankan Qwen Code dalam Projek Anda?
Inti pati
Pergi ke folder projek dengan arahan cd, kemudian taip qwen. Antara muka terminal ejen akan terbuka. Pada pelancaran pertama, ejen akan meminta anda menyambungkan model melalui menu /auth. Selepas itu, anda boleh menulis tugasan dalam bahasa biasa—ejen akan meneliti projek dan mula bekerja. Perkara utama: lancarkannya dari folder projek supaya ejen dapat melihat semua fail anda.
Mula-mula, pergi ke folder yang mengandungi kod anda. Ini penting: ejen bekerja dalam folder tempat ia dilancarkan dan hanya dapat melihat kandungan folder itu.
cd path-to-your-project
qwen
Antara muka ejen akan terbuka terus dalam terminal. Kali pertama, ejen akan menawarkan untuk menyambungkan model; perkara ini diterangkan dalam bahagian seterusnya. Setelah model disambungkan, anda boleh memberikan tugasan kepada ejen dalam bahasa biasa untuk melihat perkara yang boleh diaksesnya:
what does this project do?
Ejen akan membaca fail, memahami strukturnya dan memberikan jawapan yang berguna. Kemudian, anda boleh memintanya menulis dan mengedit kod: “tambah butang log keluar,” “bahagikan fail ini kepada dua,” “cari sebab ujian ini gagal.” Ejen mencari bahagian yang berkaitan dan membuat perubahan itu sendiri.
Ada juga cara kedua untuk melancarkannya—dengan satu arahan, tanpa antara muka. Cara ini berguna untuk skrip dan tugasan automatik:
qwen -p "reread README and update the list of commands"
Cara ini menjalankan tugasan lalu keluar tanpa perbualan. Anda tidak memerlukannya untuk langkah awal, tetapi ia berguna untuk diketahui kemudian.
Mengapa Ejen Berjalan tetapi Tidak Melakukan Apa-apa dengan Sendiri?
Inti pati
Jika Ask Permissions aktif, Qwen Code menunggu pengesahan anda sebelum suntingan dan arahan. Selain itu, model perlu disambungkan sebelum ejen boleh membuat suntingan: Alibaba menutup akses percuma melalui qwen.ai pada 15 April 2026, dan tanpa akses kepada model yang disambungkan, ejen memang tidak dapat memikirkan tugasan. Dua sebab lazim ejen “sekadar terhenti” ialah tiada model disambungkan atau mod berhati-hati yang memerlukan pengesahan sedang diaktifkan.
Halangan pertama ialah akses kepada model. Dahulu, Qwen Code menawarkan akses percuma: anda log masuk menggunakan akaun qwen.ai dan ejen berfungsi tanpa kad. Akses ini dipanggil Qwen OAuth dan telah dihentikan. Dokumentasi pengesahan menyatakannya dengan jelas: peringkat percuma Qwen OAuth dihentikan pada 15 April 2026; log masuk yang disimpan sebelum ini mungkin terus berfungsi seketika, tetapi pelayan menolak permintaan baharu. Pilihan “sign in with qwen.ai” juga telah dibuang daripada menu.
Jadi, ejen memerlukan model yang disambungkan untuk mula memikirkan tugasan. Bahagian seterusnya menerangkan pilihan sambungan, termasuk pilihan berbayar dan pilihan setempat yang percuma.
Sebab kedua kurang ketara dan lebih mengecewakan. Model sudah disambungkan, ejen memberi respons, tetapi tidak mengedit sebarang fail—ejen hanya menunjukkan perkara yang dirancangnya dan menunggu. Tingkah laku itu dijangka dalam mod Ask Permissions, yang meminta pengesahan sebelum suntingan dan arahan; ia bukan bukti mod permulaan sejagat. Untuk membolehkannya bekerja sendiri, anda perlu menukar mod. Perkara itu diterangkan dua bahagian di bawah, tempat anda akan menemui jawapan kepada soalan asal.
Bagaimanakah Cara Menyambungkan Model Sekarang Akses Percuma Sudah Ditutup?
Inti pati
Pada pelancaran pertama, arahan /auth membuka menu dengan tiga pilihan. Alibaba ModelStudio ialah pilihan rasmi berbayar (pengguna individu boleh mendapatkan Coding Plan dengan kuota mingguan). Penyedia pihak ketiga membolehkan sambungan menggunakan kunci kepada DeepSeek, Kimi dan penyedia lain. Custom Provider menyambungkan model anda sendiri atau model setempat melalui Ollama dan alat yang serupa. Hanya pilihan terakhir—model setempat—berfungsi secara percuma tanpa kad.
Dalam ejen, taip arahan:
/auth
Menu dengan tiga pilihan utama akan terbuka. Berikut ialah fungsi setiap pilihan.
Alibaba ModelStudio ialah pilihan rasmi daripada pencipta Qwen. Ia menawarkan Coding Plan dengan harga tetap dan kuota mingguan untuk pembangun individu, Token Plan dengan bayaran mengikut penggunaan untuk pasukan, dan pilihan untuk menyambungkan kunci ModelStudio sedia ada. Ini ialah akses berbayar kepada model “asli” Qwen.
Penyedia pihak ketiga membolehkan anda memilih penyedia terbina dalam dan menyambung menggunakan kunci. Senarai rasmi merangkumi DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope dan penyedia lain. Dapatkan kunci daripada penyedia, masukkannya dan ejen akan menggunakan model penyedia itu.
Custom Provider menyambungkan pelayan, proksi atau enjin setempat anda sendiri. Di sinilah anda menyambungkan model yang berjalan pada komputer anda melalui Ollama. Pilihan ini menyokong format OpenAI, Anthropic dan Gemini, jadi ia berfungsi dengan hampir semua kaedah akses.
Anda juga boleh memasukkan kunci dan tetapan secara manual dalam fail ~/.qwen/settings.json. Fail ini mempunyai medan modelProviders (model yang tersedia), env (kunci itu sendiri), security.auth.selectedType (protokol yang perlu diaktifkan semasa permulaan) dan model.name (model lalai). Selepas itu, qwen akan bermula dengan tetapan tersebut tanpa bertanya apa-apa. Untuk kali pertama, lebih mudah menggunakan /auth; anda boleh kembali kepada fail itu apabila mahu menyimpan semua tetapan.
Untuk mengetahui perkara yang masih percuma selepas bulan April, lihat artikel tentang Qwen Code percuma.
Mod Manakah yang Perlu Diaktifkan supaya Ejen Mengedit Kod dengan Sendiri?
Inti pati
Dokumentasi lima mod Qwen Code melabel Auto sebagai lalai dalam rujukan pantasnya, sementara bahagian Ask Permissions masih mengandungi perkataan mod awal yang lama. Halaman tanpa versi ini tidak membuktikan lalai setiap pemasangan: semak mod aktif sesi anda. Auto menggunakan pengelas untuk meluluskan atau menyekat tindakan yang dinilai. Jika anda mahu ejen mengedit fail tanpa bertanya, gunakan Auto-Edit. Jika anda bersedia membenarkannya membuat suntingan dan menjalankan arahan tanpa bertanya langsung, gunakan YOLO—tetapi hanya dalam projek anda sendiri dan dengan berhati-hati. Mod inilah yang membezakan antara “bertanya tentang segala-galanya” dengan “bekerja sendiri.”
Idea utamanya begini: mod akses menentukan tahap kebebasan ejen bertindak. Terdapat lima mod, daripada yang paling berhati-hati hingga yang paling permisif.
| Mod | Mengedit fail | Menjalankan arahan | Kegunaan |
|---|---|---|---|
| Plan | tidak, baca sahaja | tidak | Memahami projek dan membuat pelan tanpa mengubah apa-apa |
| Ask Permissions | dengan pengesahan | dengan pengesahan | Kod yang belum biasa atau penting, apabila anda mahu melihat setiap langkah |
| Auto-Edit | sendiri | dengan pengesahan | Banyak suntingan kecil, sementara arahan kekal di bawah kawalan anda |
| Auto | berdasarkan penilaian keselamatan | berdasarkan penilaian keselamatan | Kerja autonomi yang panjang dengan perlindungan |
| YOLO | sendiri | sendiri | Projek anda sendiri, apabila anda mempercayakan segala-galanya kepada ejen |
Jika ejen hanya menunjukkan suntingan dan menunggu, kemungkinan besar ia berada dalam mod Ask Permissions (dipanggil Default dalam versi terdahulu). Anda perlu mengesahkan setiap suntingan dan arahan secara manual, menyebabkan ejen terasa seperti tidak melakukan apa-apa dengan sendiri.
Untuk membolehkannya mengedit fail tanpa bertanya, tukar kepada Auto-Edit. Suntingan akan berlaku secara automatik, tetapi ejen masih akan meminta kebenaran sebelum menjalankan arahan—perlindungan yang wajar daripada menjalankan rm di lokasi yang salah secara tidak sengaja.
Auto menggunakan penilai dalaman untuk tindakan yang memerlukan penilaian. Pilih secara sengaja selepas memeriksa versi dipasang dan status aktif; perkataan default yang dikekalkan dalam konfigurasi Ask Permissions ialah nama keserasian, bukan bukti bahawa ia mod permulaan.
YOLO ialah mod yang paling permisif. Ejen mengedit fail dan menjalankan arahan sendiri tanpa bertanya apa-apa. Dokumentasi menyatakan bahawa mod ini hanya untuk projek peribadi yang dipercayai dan aliran kerja automatik. Hasil yang tidak diingini mudah berlaku dalam projek kerja, jadi aktifkannya hanya dengan pertimbangan yang wajar dan, sebaik-baiknya, pada salinan.
Bagaimanakah Cara Menukar Mod Semasa Sesi?
Inti pati
Kekal dalam ejen dan tekan Shift+Tab (Tab pada Windows) untuk beralih antara mod: Plan, pengesahan, suntingan automatik, Auto, YOLO dan kembali kepada Plan. Mod semasa dipaparkan pada bar status di bahagian bawah skrin. Aliran kerja yang berguna ialah bermula dalam Plan, menyemak tugasan, kemudian beralih kepada Auto-Edit atau Auto dan membiarkan ejen bekerja.
Anda boleh menukar mod semasa bekerja, termasuk di tengah-tengah tugasan. Tekan Shift+Tab untuk beralih ke mod seterusnya. Pada Windows, kekunci Tab biasa melakukan perkara yang sama. Turutannya ialah: Plan, pengesahan, suntingan automatik, Auto, YOLO dan kembali kepada Plan.
Mod semasa sentiasa dipaparkan pada bar status di bahagian bawah antara muka. Biasakan diri menyemaknya sebelum memberikan tugasan besar kepada ejen supaya anda tidak melancarkan YOLO apabila sebenarnya hanya mahu melihat pelan.
Aliran kerja yang sesuai untuk pemula mempunyai tiga langkah:
- Lancarkan ejen dalam mod Plan dan minta ejen menganalisis tugasan serta mencadangkan pelan. Ejen tidak akan menyentuh apa-apa; ia hanya akan membaca kod dan menerangkan perkara yang dirancangnya.
- Baca pelan itu dan, jika anda bersetuju, tukar kepada Auto-Edit atau Auto dengan menekan Shift+Tab.
- Beritahu ejen supaya meneruskan. Ejen kini akan mengedit fail sendiri sementara anda memantau hasilnya.
Pendekatan ini menghilangkan kebimbangan utama pemula—ejen akan terus merosakkan segala-galanya. Mula-mula, anda menyemak pelan dalam mod selamat, kemudian barulah membiarkan ejen meneruskannya.
Pendekatan penuh kepada vibe coding berasaskan kaedah; alat hanyalah perkara kedua. Qwen, Claude, apa sahaja—model yang berjalan di sebaliknya boleh ditukar. Tiga asas membantu anda mengekalkan hasil apabila bertukar model: klon AI, Second Brain dan kejuruteraan konteks. Gabungan ketiga-tiganya menghasilkan keputusan yang boleh dijangka; nasib baik sekali-sekala langsung tidak berkaitan dengannya.
Model Setempat Tanpa Kad
Inti pati
Ya, anda boleh menggunakan model setempat. Qwen Code boleh berfungsi dengan model yang berjalan terus pada komputer anda melalui Ollama atau program yang serupa—sambungkannya daripada menu sebagai Custom Provider. Anda tidak memerlukan perkhidmatan awan Alibaba. Model terbuka boleh dimuat turun secara percuma, kad tidak diperlukan dan data projek anda tidak meninggalkan mesin. Pertukarannya ialah anda memerlukan komputer berkuasa; jika tidak, ejen akan berfikir dengan perlahan.
Pasang model terbuka pada komputer anda melalui Ollama atau vLLM, kemudian sambungkannya sebagai Custom Provider daripada menu /auth. Selepas itu, ejen menggunakan model pada mesin anda sendiri dan bukannya perkhidmatan awan Alibaba. Tiada kad atau kunci diperlukan dan tiada had permintaan. Untuk melihat model terbuka yang sesuai untuk pengekodan, lihat ulasan model pengekodan percuma ini.
Pertukarannya ialah perkakasan. Model yang menulis kod dengan agak baik memerlukan banyak memori video. Ia boleh digunakan pada komputer permainan dengan kad grafik berkuasa, tetapi model itu mungkin tidak muat pada komputer riba biasa. Jika tidak, masa yang diambil untuk memikirkan setiap jawapan mungkin begitu lama sehingga lebih mudah mencari pilihan lain.
Satu lagi manfaat penggunaan setempat ialah privasi data. Semua kod anda kekal pada komputer; tiada apa-apa dihantar ke pelayan orang lain. Bagi projek sensitif, perkara itu lebih penting daripada penjimatan kos langganan.
Apakah yang Boleh Anda Lakukan supaya Ejen Tidak Merosakkan Projek?
Inti pati
Tiga perkara. Simpan projek di bawah kawalan versi git supaya anda boleh membatalkan sebarang suntingan ejen dengan satu arahan. Mulakan tugasan dalam mod Plan dan baca pelannya sebelum membenarkan ejen meneruskan. Jangan aktifkan YOLO dalam projek kerja—simpan mod itu untuk salinan dan eksperimen kecil. Dengan cara itu, kebebasan ejen memihak kepada anda.
Ejen autonomi memang mudah digunakan selagi ia melakukan perkara yang anda inginkan. Untuk mengelakkan kesilapan daripada merugikan anda, amalkan tiga tabiat.
Pertama, gunakan git. Jika projek berada di bawah kawalan versi, anda boleh melihat setiap suntingan ejen dan membatalkan mana-mana suntingan. Ejen autonomi memang berisiko tanpa git: ia mengubah sesuatu dan tiada cara untuk memulihkan versi terdahulu. Dengan git, satu arahan ringkas sudah cukup untuk mengembalikan perubahan.
Kedua, mulakan dalam mod Plan. Sebelum memberikan tugasan besar kepada ejen, minta ejen membuat pelan dalam mod yang tidak akan menyentuh apa-apa. Baca pelan itu dan fahami perkara yang ingin dilakukan oleh ejen, kemudian beralih kepada mod suntingan.
Ketiga, berhati-hati dengan YOLO. Dalam mod ini, ejen menjalankan arahan sendiri, termasuk arahan yang memadam fail. Kebebasan itu terlalu besar untuk projek kerja. Simpan YOLO untuk salinan kasar dan tugasan kecil yang tidak menjadi masalah jika sesuatu berlaku.
Tiga tabiat ini menangani kebimbangan utama—“Saya menggunakan vibe coding lalu merosakkan semuanya.” Untuk mengetahui lebih lanjut tentang membatalkan perubahan dalam vibe coding, lihat ulasan berasingan ini. Ulasan itu membincangkan Claude Code, tetapi prinsip penggunaan git adalah sama sepenuhnya.
Di Manakah Anda Patut Bermula untuk Tugasan Anda?
Inti pati
Pasang Qwen Code, pergi ke folder projek anda, jalankan qwen dan sambungkan model melalui /auth—model berbayar atau model setempat melalui Ollama. Kemudian mulakan dalam mod Plan, baca pelan, tukar kepada Auto-Edit dengan menekan Shift+Tab dan biarkan ejen bekerja. Simpan projek di bawah kawalan versi git. Persediaan kali pertama mengambil masa kira-kira dua puluh minit.
Berikut ialah keseluruhan proses dalam senarai ringkas. Ikut langkah dari atas ke bawah:
- Pasang Qwen Code dengan satu arahan dan mulakan semula terminal.
- Pergi ke folder projek dengan
cddan jalankanqwen. - Sambungkan model melalui
/auth: pelan berbayar atau model setempat melalui Ollama jika anda tidak boleh membayar menggunakan kad. - Berikan tugasan kepada ejen dalam mod Plan dan baca pelannya.
- Tukar kepada Auto-Edit atau Auto dengan Shift+Tab dan biarkan ejen bekerja.
- Simpan projek di bawah kawalan versi git supaya anda boleh membatalkan sebarang suntingan.
Ringkasnya, “Qwen tidak menulis kod dengan sendiri” hampir selalu bermaksud tiada model disambungkan atau ejen berada dalam mod pengesahan. Selesaikan masalah pertama dalam menu /auth, dan masalah kedua dengan menekan Shift+Tab sehingga mencapai Auto-Edit. Selepas itu, ejen benar-benar bekerja sendiri dalam terminal.
Jika anda mahu membandingkan Qwen dengan ejen lain untuk tugasan anda, lihat ulasan alternatif kepada Claude Code ini. Qwen disenaraikan bersama ejen lain supaya anda dapat melihat ejen yang sesuai untuk setiap kegunaan.
Sumber
- Qwen Code — repositori GitHub rasmi (QwenLM/qwen-code) — keterangan ejen, pemasangan, mod pelancaran, senarai penyedia
- Qwen Code — dokumentasi pengesahan — menu /auth, penghentian peringkat percuma Qwen OAuth pada 15 April 2026, settings.json, Custom Provider
- Qwen Code — mod akses (Approval Mode) — lima mod: Plan / Ask Permissions / Auto-Edit / Auto / YOLO, pertukaran menggunakan Shift+Tab
- Qwen Code — gambaran keseluruhan (Overview) — perkara yang dilakukan ejen: merancang, menulis kod, menyahpepijat dan menelusuri projek
- Qwen Code — panduan ringkas (Quickstart) — pemasangan dan pelancaran pertama dalam projek
Pendekatan penuh kepada vibe coding berpaksikan kaedah, manakala ejen khusus berada di tempat kedua: klon AI ditambah Second Brain ditambah kejuruteraan konteks. Anda boleh menukar alat yang berjalan di sebaliknya; kaedahnya tetap sama. Sumber praktikal: dokumentasi Ailoot.
Lebih banyak sumber dan alat: Ailoot.
Butiran lanjut
Soalan lazim: Cara Menjalankan Qwen Code di Terminal dan Menetapkan Mod Suntingan | Ailoot
Mengapakah Qwen Code menunjukkan perubahan dicadangkan dan menunggu?
Semak mod aktif pada bar status. Ask Permissions menunggu pengesahan; Plan untuk analisis. Auto-Edit membenarkan suntingan sambil mengekalkan kelulusan arahan, dan akses model juga perlu dikonfigurasikan.
Adakah mod bernama Default membuktikan mod permulaan pemasangan baharu?
Tidak. Nama lama Default dikekalkan untuk keserasian Ask Permissions, sementara rujukan pantas dokumentasi melabel Auto sebagai lalai. Periksa versi dipasang dan mod sesi aktif daripada menyimpulkannya berdasarkan nama.