Kako zagnati Qwen Code v terminalu in nastaviti način urejanja
MarkdownNamestitev Qwen Code, zagon v projektu, povezava modela prek auth, načini Plan, Auto-Edit, Auto in YOLO, lokalni model ter zaščita projekta.
Preberi celoten članek
Vprašanje se glasi nekako takole: kako doseči, da Qwen pravilno deluje v konzoli in sam piše kodo? Za tem se običajno skriva razočaranje: nekdo je namestil Qwen Code, zastavil vprašanje, dobil besedilo in kos kode, ki ga je moral ročno kopirati, čeprav mu je bil obljubljen agent, ki bo vstopil v projekt in vse opravil sam.
Prav to je Qwen Code: polnopravni agent. Sam lahko odpira datoteke, jih ureja in izvaja ukaze. Vedenje je odvisno od aktivnega načina odobravanja: Ask Permissions zahteva potrditev, Auto-Edit in Auto pa omogočata bolj samostojno delo. Preverite vrstico stanja, namesto da predpostavljate, da je način z imenom Default začetna izbira. Spodaj po vrsti: namestitev, zagon v projektu, povezava modela po aprilskih spremembah in preklop v način, v katerem agent ureja kodo brez nepotrebnih vprašanj. Vse je bilo preverjeno glede na uradno dokumentacijo Qwen na dan 30. avgusta 2026.
Praktični viri o modelih in agentih: dokumentacija Ailoot.
Kaj pomeni »Qwen Code sam piše kodo«?
Ključna ugotovitev
Qwen Code je agent umetne inteligence v terminalu. Prebere celoten projekt, sam odpira in ureja datoteke, izvaja ukaze ter preverja rezultate. Klepet v brskalniku vam ponudi besedilo, ki ga morate sami prenesti. Agent deluje neposredno v mapi s kodo. Uradni opis se glasi »odprtokodni agent za kodiranje z umetno inteligenco, ki deluje v vašem terminalu«.
Razlika je preprosta. Klepet v brskalniku na vprašanje odgovori z besedilom. Preberete odgovor, kopirate kodo, jo prilepite v datoteko, sami zaženete program, sami poiščete napako in jo prenesete nazaj v klepet. Vi ste posrednik med klepetom in projektom.
Agent deluje drugače. V vsakdanjem jeziku mu dodelite nalogo: »dodaj obrazec za povratne informacije«, »odpravi to napako«. Nato pregleda strukturo projekta, poišče ustrezne datoteke, jih spremeni in zažene preverjanje. Dokumentacija to pove jasno: agent pripravi načrt, napiše kodo in poskrbi, da deluje.
Od tod izvira zmeda v vprašanju. »Qwen sam ne piše kode« skoraj vedno pomeni eno od dveh stvari: oseba ima odprt klepet v brskalniku namesto agenta v terminalu ali pa agent deluje v načinu, ki za vsako urejanje zahteva dovoljenje. Prvo rešite z namestitvijo Qwen Code, drugo s preklopom načina. Oboje obravnavamo spodaj.
Kako namestiti Qwen Code v terminal?
Ključna ugotovitev
Namestitev zahteva en sam ukaz. V macOS in Linux uporabite uradni namestitveni program Qwen ali npm (potrebujete Node.js 22 ali novejšo različico). V Windows uporabite ukaz v PowerShellu. Po namestitvi znova zaženite terminal, sicer ukaz qwen morda ne bo najden. Namestitev je brezplačna in za vse enaka; stroški nastanejo pozneje, ko dostopate do modela.
Najhitrejša možnost je uradni namestitveni program, ki samodejno izbere različico za vaš sistem.
V macOS in Linux odprite terminal in prilepite eno vrstico:
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash
V Windows naredite enako s tem ukazom za PowerShell:
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex
Druga možnost je npm, če ga že imate nameščenega. Potrebujete Node.js različice 22 ali novejše:
npm install -g @qwen-code/qwen-code@latest
Po namestitvi znova zaženite terminal. Namestitveni program doda ukaz qwen med sistemske poti, terminal pa ga ne bo prepoznal, dokler ga ne zaženete znova — to je najpogostejši razlog za sporočilo »namestil sem ga, vendar ukaza ne najde«. Če želite preveriti, ali se je vse namestilo, zaženite:
qwen --version
Če vidite številko različice, je agent nameščen in pripravljen za zagon v vašem projektu.
Kako zagnati Qwen Code v projektu?
Ključna ugotovitev
Z ukazom cd odprite mapo projekta, nato vnesite qwen. Odpre se terminalski vmesnik agenta. Ob prvem zagonu vas bo pozval, da prek menija /auth povežete model. Nato mu lahko v vsakdanjem jeziku napišete naloge — agent bo pregledal projekt in začel delati. Ključno je, da ga zaženete iz mape projekta, da lahko vidi vse vaše datoteke.
Najprej odprite mapo s svojo kodo. To je pomembno: agent deluje v mapi, iz katere ste ga zagnali, in vidi samo njeno vsebino.
cd path-to-your-project
qwen
Vmesnik agenta se bo odprl neposredno v terminalu. Ob prvem zagonu bo ponudil povezavo z modelom; to je opisano v naslednjem razdelku. Ko je model povezan, lahko agentu v vsakdanjem jeziku dodelite nalogo in preverite, do česa lahko dostopa:
what does this project do?
Agent bo prebral datoteke, razumel strukturo in vam podal uporaben odgovor. Nato ga lahko prosite, naj napiše in uredi kodo: »dodaj gumb za odjavo«, »razdeli to datoteko na dve«, »ugotovi, zakaj test ne uspe«. Sam poišče ustrezna mesta in izvede spremembe.
Za zagon je na voljo tudi drugi način — z enim ukazom, brez vmesnika. Uporaben je za skripte in avtomatizirana opravila:
qwen -p "reread README and update the list of commands"
Ta način izvede nalogo in se konča brez pogovora. Za prve korake ga ne potrebujete, vendar ga je koristno poznati za pozneje.
Zakaj agent deluje, vendar sam ničesar ne naredi?
Ključna ugotovitev
Če je aktiven Ask Permissions, Qwen Code pred urejanjem in ukazi čaka na vašo potrditev. Poleg tega mora biti model povezan, preden lahko agent ureja: Alibaba je 15. aprila 2026 ukinila brezplačni dostop prek qwen.ai, brez dostopa do povezanega modela pa agent naloge preprosto ne more premisliti. Dva pogosta razloga, zakaj »samo čaka«, sta, da ni povezan noben model ali da je vklopljen previdni način s pozivi za potrditev.
Prva ovira je dostop do modela. Qwen Code je prej omogočal brezplačen dostop: prijavili ste se z računom qwen.ai, agent pa je deloval brez kartice. Ta dostop se je imenoval Qwen OAuth in je bil ukinjen. Dokumentacija za avtorizacijo to pove neposredno: brezplačna raven Qwen OAuth je bila ukinjena 15. aprila 2026; prej shranjene prijave bodo morda še kratek čas delovale, vendar strežnik zavrača nove zahteve. Možnost »prijava z qwen.ai« je bila odstranjena tudi iz menija.
Da bi agent sploh začel obdelovati nalogo, morate torej povezati model. V naslednjem razdelku so opisane možnosti povezave, tako plačljive kot brezplačne lokalne.
Drugi razlog je manj očiten in bolj neprijeten. Model je povezan, agent se odziva, vendar ne ureja nobene datoteke — samo pokaže, kaj namerava narediti, in čaka. To je pričakovano vedenje v načinu Ask Permissions, ki pred urejanjem in ukazi zahteva potrditev; ne dokazuje univerzalne privzete nastavitve ob zagonu. Če želite, da deluje samostojno, morate zamenjati način. To je opisano dva razdelka nižje, kjer boste našli odgovor na prvotno vprašanje.
Kako povezati model, ko je brezplačni dostop ukinjen?
Ključna ugotovitev
Ob prvem zagonu ukaz /auth odpre meni s tremi možnostmi. Alibaba ModelStudio je uradna plačljiva možnost (posamezni uporabniki lahko pridobijo Coding Plan s tedensko kvoto). Zunanji ponudniki se povežejo s ključem; med njimi so DeepSeek, Kimi in drugi. Custom Provider poveže vaš lastni ali lokalni model prek Ollame in podobnih orodij. Brezplačno, brez kartice, deluje samo zadnja možnost — lokalni model.
V agentu vnesite ukaz:
/auth
Odpre se meni s tremi glavnimi možnostmi. Poglejmo, kaj omogoča vsaka.
Alibaba ModelStudio je uradna možnost ustvarjalcev Qwena. Ponuja Coding Plan s fiksno ceno in tedensko kvoto za posameznega razvijalca, Token Plan s plačilom po porabi za ekipe ter možnost povezave obstoječega ključa ModelStudio. To je plačljiv dostop do Qwenovega »izvornega« modela.
Zunanji ponudniki omogočajo, da izberete vgrajenega ponudnika in se povežete s ključem. Uradni seznam vključuje DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope in druge. Pri ponudniku pridobite ključ, ga vnesete in agent bo uporabljal model tega ponudnika.
Custom Provider poveže vaš lastni strežnik, posredniški strežnik ali lokalni pogon. Tukaj lahko prek Ollame povežete model, ki deluje v vašem računalniku. Ta možnost podpira formate OpenAI, Anthropic in Gemini, zato deluje s skoraj vsakim načinom dostopa.
Ključ in nastavitve lahko ročno vnesete tudi v datoteko ~/.qwen/settings.json. Vsebuje polje modelProviders (razpoložljivi modeli), env (ključi sami), security.auth.selectedType (protokol, ki ga je treba omogočiti ob zagonu) in model.name (privzeti model). Nato se bo qwen zagnal s temi nastavitvami in ne bo ničesar spraševal. Prvič je lažje uporabiti /auth; k datoteki se lahko vrnete, ko želite shraniti vse nastavitve.
Če želite izvedeti, kaj je po aprilu ostalo brezplačno, preberite članek o brezplačnem Qwen Code.
Kateri način omogočiti, da bo agent sam urejal kodo?
Ključna ugotovitev
Dokumentacija petih načinov Qwen Code v hitrem pregledu Auto označuje kot privzetega, razdelek Ask Permissions pa še vsebuje starejše besedilo o začetnem načinu. Ta stran brez navedene različice ne potrjuje privzete nastavitve vsake namestitve: preverite aktivni način v svoji seji. Auto z razvrščevalnikom odobri ali blokira ocenjena dejanja. Če želite, da ureja datoteke brez pozivov, uporabite Auto-Edit. Če ste pripravljeni, da ureja datoteke in izvaja ukaze brez vprašanj, uporabite YOLO — vendar samo v svojem projektu in previdno. Način je stikalo med »sprašuje o vsem« in »dela sam«.
Osnovna zamisel je naslednja: način dostopa določa, kako samostojno deluje agent. Na voljo je pet načinov, od najbolj previdnega do najbolj dovoljujočega.
| Način | Ureja datoteke | Izvaja ukaze | Namen |
|---|---|---|---|
| Plan | ne, samo branje | ne | Razume projekt in pripravi načrt, ne da bi karkoli spremenil |
| Ask Permissions | s potrditvijo | s potrditvijo | Za neznano ali pomembno kodo, kadar želite spremljati vsak korak |
| Auto-Edit | samostojno | s potrditvijo | Za številne manjše spremembe, medtem ko imate ukaze pod nadzorom |
| Auto | na podlagi varnostne ocene | na podlagi varnostne ocene | Za daljše samostojno delo z zaščitnimi ukrepi |
| YOLO | samostojno | samostojno | Za vaš projekt, kadar agentu zaupate vse |
Če vam agent samo pokaže spremembe in čaka, je verjetno v načinu Ask Permissions (v starejših različicah se je imenoval Default). Nato morate ročno potrditi vsako urejanje in vsak ukaz, zaradi česar se zdi, kot da agent sam ne počne ničesar.
Če želite, da agent ureja datoteke brez pozivov, preklopite na Auto-Edit. Urejanje bo potekalo samodejno, vendar bo agent pred izvajanjem ukazov še vedno prosil za dovoljenje — to je smiselna zaščita pred nenamernim izvajanjem ukaza rm na napačnem mestu.
Auto uporablja notranji ocenjevalnik za dejanja, ki potrebujejo oceno. Izberite ga zavestno po preverjanju nameščene različice in aktivnega stanja; beseda default, ohranjena v konfiguraciji Ask Permissions, je združljivostno ime, ne dokaz začetnega načina.
YOLO je najbolj dovoljujoč način. Agent sam ureja datoteke in izvaja ukaze, ne da bi karkoli vprašal. Dokumentacija pravi, da je namenjen samo zaupanja vrednim osebnim projektom in avtomatiziranim potekom dela. V delovnem projektu lahko hitro nastane neželen rezultat, zato ga vklopite le premišljeno in po možnosti na kopiji.
Kako zamenjati način med sejo?
Ključna ugotovitev
Ostanite v agentu in pritisnite Shift+Tab (v Windows tipko Tab); načini se bodo menjavali v tem vrstnem redu: Plan, potrditve, samodejno urejanje, Auto, YOLO in znova Plan. Trenutni način je prikazan v vrstici stanja na dnu zaslona. Uporaben potek dela je, da začnete v načinu Plan, pregledate nalogo, nato preklopite na Auto-Edit ali Auto in pustite agentu delati.
Način lahko zamenjate sproti, tudi sredi naloge. Pritisnite Shift+Tab za preklop na naslednji način. V Windows enako deluje običajna tipka Tab. Vrstni red je: Plan, potrditve, samodejno urejanje, Auto, YOLO in nazaj na Plan.
Trenutni način je vedno prikazan v vrstici stanja na dnu vmesnika. Preden agentu dodelite veliko nalogo, se navadite preveriti način, da ne zaženete YOLO, ko ste želeli samo pregledati načrt.
Potek dela, primeren za začetnike, ima tri korake:
- Zaženite agenta v načinu Plan in ga prosite, naj analizira nalogo ter predlaga načrt. Ničesar se ne bo dotaknil; prebral bo samo kodo in opisal, kaj namerava narediti.
- Preberite načrt. Če se strinjate, pritisnite Shift+Tab in preklopite na Auto-Edit ali Auto.
- Naročite mu, naj nadaljuje. Agent bo zdaj sam urejal datoteke, vi pa boste spremljali rezultate.
S tem pristopom odpravite glavni strah začetnikov — da bo agent takoj vse pokvaril. Najprej pregledate načrt v varnem načinu, šele nato mu dovolite nadaljevati.
Lokalni model brez kartice
Ključna ugotovitev
Da, uporabite lahko lokalni model. Qwen Code lahko deluje z modelom, ki teče neposredno v vašem računalniku prek Ollame ali podobnega programa — v meniju ga povežite kot Custom Provider. Za to ne potrebujete Alibabinega oblaka. Odprte modele lahko prenesete brezplačno, kartica ni potrebna in podatki vašega projekta ne zapustijo računalnika. Slabost je, da potrebujete zmogljiv računalnik, sicer bo agent razmišljal počasi.
V računalnik namestite odprti model prek Ollame ali vLLM in ga nato v meniju /auth povežite kot Custom Provider. Agent bo tako uporabljal model, ki deluje na vašem računalniku, namesto Alibabinega oblaka. Kartica in ključi niso potrebni, prav tako ni omejitve števila zahtev. Če želite izvedeti, kateri odprti modeli so primerni za kodiranje, preberite ta pregled brezplačnih modelov za kodiranje.
Slabost je strojna oprema. Model, ki dokaj dobro piše kodo, potrebuje veliko videopomnilnika. Uporaba je izvedljiva na igralnem računalniku z zmogljivo grafično kartico, vendar se model morda ne bo prilegal v običajen prenosnik. Lahko pa bo premislek o vsakem odgovoru trajal tako dolgo, da bo lažje poiskati drugo možnost.
Dodatna prednost lokalnega delovanja je zasebnost podatkov. Vsa vaša koda ostane v računalniku; nič se ne pošlje na strežnik nekoga drugega. Pri občutljivem projektu je to pomembnejše od prihranka pri naročnini.
Kako preprečiti, da agent pokvari projekt?
Ključna ugotovitev
Tri stvari. Projekt vključite v sistem za nadzor različic git, da lahko z enim ukazom razveljavite katerokoli spremembo agenta. Naloge začnite v načinu Plan in preberite načrt, preden agentu dovolite nadaljevanje. V delovnem projektu ne omogočite YOLO — prihranite ga za kopije in manjše poskuse. Tako vam bo samostojnost agenta koristila.
Samostojni agent je priročen, dokler počne, kar želite. Da vas napaka ne bi drago stala, upoštevajte tri navade.
Prvič, uporabljajte git. Če je projekt pod nadzorom različic, lahko pregledate vsako spremembo agenta in katerokoli razveljavite. Samostojni agent je brez git res tvegan: nekaj spremeni, vi pa ne morete obnoviti prejšnje različice. Z git lahko spremembo razveljavite z enim kratkim ukazom.
Drugič, začnite v načinu Plan. Preden agentu dodelite večjo nalogo, ga prosite, naj pripravi načrt v načinu, v katerem se ničesar ne dotakne. Načrt preberite in se prepričajte, da razumete, kaj namerava agent narediti, nato preklopite na urejanje.
Tretjič, previdno z načinom YOLO. V tem načinu agent sam izvaja ukaze, tudi tiste, ki brišejo datoteke. Za delovni projekt je to preveč tvegano. YOLO prihranite za grobe kopije in manjše naloge, pri katerih ne bo pomembno, če gre kaj narobe.
Te tri navade obravnavajo glavni strah — »z vibe codingom sem nekaj naredil in pokvaril«. Več o razveljavljanju sprememb pri vibe codingu preberite v tem ločenem pregledu. Obravnava Claude Code, vendar je načelo uporabe git popolnoma enako.
Kje začeti pri svoji nalogi?
Ključna ugotovitev
Namestite Qwen Code, odprite mapo projekta, zaženite qwen in prek /auth povežite model — plačljivi ali lokalni prek Ollame. Nato začnite v načinu Plan, preberite načrt, pritisnite Shift+Tab za preklop na Auto-Edit in pustite agentu delati. Projekt vključite v sistem git. Prva nastavitev traja približno dvajset minut.
Tukaj je celoten postopek v obliki kratkega seznama. Sledite mu od začetka do konca:
- Namestite Qwen Code z enim ukazom in znova zaženite terminal.
- Z ukazom
cdodprite mapo projekta in zaženiteqwen. - Prek
/authpovežite model: plačljivi paket ali lokalni model prek Ollame, če plačilo s kartico ni mogoče. - Agentu dodelite nalogo v načinu Plan in preberite njegov načrt.
- S kombinacijo Shift+Tab preklopite na Auto-Edit ali Auto in pustite agentu delati.
- Projekt vključite v sistem git, da lahko razveljavite katerokoli spremembo.
Na kratko: »Qwen sam ne piše kode« skoraj vedno pomeni, da ni povezan noben model ali da je agent v načinu, ki zahteva potrditev. Prvo težavo odpravite v meniju /auth, drugo pa tako, da pritiskate Shift+Tab, dokler ne dosežete načina Auto-Edit. Nato agent res samostojno dela v terminalu.
Če želite Qwen primerjati z drugimi agenti za svojo nalogo, preberite ta pregled alternativ Claude Code. Qwen je predstavljen skupaj z drugimi, zato lahko vidite, kateri je primeren za kaj.
Viri
- Qwen Code — uradni repozitorij GitHub (QwenLM/qwen-code) — opis agenta, namestitev, načini zagona, seznam ponudnikov
- Qwen Code — dokumentacija za avtorizacijo — meni /auth, ukinitev brezplačne ravni Qwen OAuth 15. aprila 2026, settings.json, Custom Provider
- Qwen Code — načini dostopa (Approval Mode) — pet načinov: Plan / Ask Permissions / Auto-Edit / Auto / YOLO, preklapljanje s Shift+Tab
- Qwen Code — pregled (Overview) — kaj počne agent: načrtuje, piše kodo, odpravlja napake, se pomika po projektu
- Qwen Code — hitri začetek (Quickstart) — namestitev in prvi zagon v projektu
Praktični viri: dokumentacija Ailoot.
Več virov in orodij: Ailoot.
Več podrobnosti
Vprašanja in odgovori: Kako zagnati Qwen Code v terminalu in nastaviti način urejanja
Zakaj Qwen Code pokaže predlagane spremembe in čaka?
V vrstici stanja preverite aktivni način. Ask Permissions čaka na potrditev, Plan je namenjen analizi. Auto-Edit omogoči urejanje in ohrani odobravanje ukazov, nastavljen pa mora biti tudi dostop do modela.
Ali ime načina Default dokazuje, v katerem načinu začne sveža namestitev?
Ne. Starejše ime Default ostaja zaradi združljivosti z Ask Permissions, hitri pregled dokumentacije pa kot privzetega označuje Auto. Preverite nameščeno različico in aktivni način seje, namesto da sklepate iz imena.