A Qwen Code futtatása a terminálban és a szerkesztési mód beállítása

A kérdés nagyjából így hangzik: hogyan lehet elérni, hogy a Qwen megfelelően működjön a konzolban, és magától írjon kódot? A kérdés mögött általában csalódás húzódik: valaki telepítette a Qwen Code-ot, feltett egy kérdést, majd szöveget és egy kódrészletet kapott válaszul, amit kézzel kellett bemásolnia, holott olyan ügynököt ígértek neki, amely belép a projektbe, és mindent maga elvégez.

Pontosan ez a Qwen Code: egy teljes értékű ügynök. Képes fájlokat megnyitni, szerkeszteni és parancsokat futtatni. A működése az aktív jóváhagyási módtól függ: az Ask Permissions megerősítést kér, az Auto-Edit és Auto önállóbb munkát enged. Az állapotsort ellenőrizze ahelyett, hogy egy Default nevű módot feltételezne gyári alapbeállításnak. Az alábbiakban sorra vesszük a telepítést, a projektben való indítást, a modell csatlakoztatását az áprilisi változások után, majd az átváltást olyan módra, amelyben az ügynök felesleges kérdések nélkül szerkeszti a kódot. Mindent a Qwen hivatalos dokumentációja alapján ellenőriztünk, 2026. augusztus 30-i állapot szerint.

Gyakorlati források modellekről és ügynökökről: Ailoot dokumentáció.

Mit jelent az, hogy „a Qwen Code magától ír kódot”?#

A különbség egyszerű. A böngészős csevegés szöveggel válaszol a kérdésre. Ön elolvassa a választ, kimásolja a kódot, beilleszti a fájlba, maga futtatja, maga keresi meg a hibát, majd visszaviszi azt a csevegésbe. Ön a futár a csevegés és a projekt között.

Az ügynök másként működik. Hétköznapi nyelven ad neki feladatot: „adj hozzá egy visszajelzési űrlapot”, „javítsd ki ezt a hibát”. Ezután megvizsgálja a projekt szerkezetét, megkeresi a releváns fájlokat, módosításokat végez, és ellenőrzést futtat. A dokumentáció világosan fogalmaz: az ügynök tervet készít, kódot ír, és gondoskodik róla, hogy működjön.

Innen ered a kérdésben rejlő félreértés. A „Qwen nem ír magától kódot” szinte mindig azt jelenti, hogy az illető a terminálos ügynök helyett böngészős csevegést nyitott meg, vagy az ügynök fut ugyan, de olyan módra van állítva, amely minden szerkesztéshez engedélyt kér. Az első problémára a Qwen Code telepítése, a másodikra a módváltás a megoldás. Mindkettővel foglalkozunk alább.

Hogyan telepítsük a Qwen Code-ot a terminálba?#

A leggyorsabb megoldás a hivatalos telepítő, amely automatikusan kiválasztja a rendszerének megfelelő verziót.

macOS és Linux rendszeren nyissa meg a terminált, és illessze be ezt az egy sort:

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

Windowson ugyanezt a következő PowerShell-paranccsal végezheti el:

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

A másik lehetőség az npm, ha már telepítve van. Ehhez Node.js 22-es vagy újabb verzió szükséges:

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

A telepítés után indítsa újra a terminált. A telepítő hozzáadja a qwen parancsot a rendszer elérési útjaihoz, de a terminál csak az újraindítás után ismeri fel — ez a leggyakoribb oka annak, hogy „telepítettem, de nem találja a parancsot”. A telepítés ellenőrzéséhez futtassa ezt:

qwen --version

Ha verziószám jelenik meg, az ügynök telepítve van, és készen áll arra, hogy elindítsa a projektben.

Hogyan indítsuk el a Qwen Code-ot a projektben?#

Először lépjen be a kódot tartalmazó mappába. Ez fontos: az ügynök abban a mappában dolgozik, ahonnan elindították, és csak annak tartalmát látja.

cd path-to-your-project
qwen

Az ügynök felülete közvetlenül a terminálban nyílik meg. Első alkalommal felajánlja egy modell csatlakoztatását; erről a következő szakaszban lesz szó. Miután a modell csatlakozott, hétköznapi nyelven adhat feladatot az ügynöknek, hogy kiderüljön, mihez fér hozzá:

what does this project do?

Az ügynök beolvassa a fájlokat, megérti a struktúrát, és hasznos választ ad. Ezután megkérheti, hogy írjon és szerkesszen kódot: „adj hozzá egy kijelentkezés gombot”, „bontsd ketté ezt a fájlt”, „derítsd ki, miért hibázik a teszt”. Megkeresi a megfelelő helyeket, és maga végzi el a módosításokat.

Van egy másik indítási mód is: egyetlen paranccsal, a felület nélkül. Ez szkriptekhez és automatizált feladatokhoz hasznos:

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

Ez lefuttatja a feladatot, majd beszélgetés nélkül kilép. Az első lépésekhez nincs rá szüksége, de későbbre érdemes megjegyezni.

Miért fut az ügynök, de miért nem csinál semmit magától?#

Az első akadály a modellhozzáférés. Korábban a Qwen Code ingyenes hozzáférést kínált: bejelentkezett egy qwen.ai-fiókkal, az ügynök pedig bankkártya nélkül működött. Ezt a hozzáférést Qwen OAuthnak nevezték, és megszüntették. A hitelesítési dokumentáció egyértelműen kimondja: az ingyenes Qwen OAuth-szint 2026. április 15-én megszűnt; a korábban mentett bejelentkezések még rövid ideig működhetnek, de a szerver elutasítja az új kéréseket. A „bejelentkezés qwen.ai-val” lehetőséget is eltávolították a menüből.

Ahhoz tehát, hogy az ügynök egyáltalán elkezdjen gondolkodni a feladaton, csatlakoztatnia kell egy modellt. A következő szakasz a csatlakoztatási lehetőségeket tárgyalja, a fizetőstől az ingyenes helyi modellekig.

A második ok kevésbé feltűnő és bosszantóbb. A modell csatlakoztatva van, az ügynök válaszol, de egyetlen fájlt sem szerkeszt — csak megmutatja, mit tervez, és várakozik. Ez az Ask Permissions módban elvárt működés: szerkesztés és parancsok előtt megerősítést kér; nem bizonyít általános indulási alapbeállítást. Ahhoz, hogy önállóan dolgozzon, módot kell váltania. Erről két szakasszal lejjebb lesz szó; ott találja meg a választ az eredeti kérdésre.

Hogyan csatlakoztassunk most modellt, hogy az ingyenes hozzáférés megszűnt?#

Az ügynökben írja be a parancsot:

/auth

Megnyílik egy menü három fő lehetőséggel. Íme, mire szolgál mindegyik.

Az Alibaba ModelStudio a Qwen készítőinek hivatalos lehetősége. Egyéni fejlesztők számára fix árú és heti kvótás Coding Plant, csapatoknak használatalapú árazású Token Plant, valamint meglévő ModelStudio-kulcs csatlakoztatására szolgáló lehetőséget kínál. Ez fizetős hozzáférés a Qwen „natív” modelljéhez.

A külső szolgáltatók közül választhat egy beépített szolgáltatót, és kulccsal csatlakozhat hozzá. A hivatalos lista a DeepSeek, a Grok, a MiniMax, a Z.AI, a Kimi és a ModelScope szolgáltatót tartalmazza. Kérjen kulcsot a szolgáltatótól, írja be, és az ügynök az adott szolgáltató modelljét fogja használni.

A Custom Provider a saját szerver, proxy vagy helyi motor csatlakoztatására szolgál. Itt csatlakoztathatja az Ollamán keresztül a számítógépén futó modellt. Ez a lehetőség az OpenAI, az Anthropic és a Gemini formátumát támogatja, ezért szinte bármilyen hozzáférési móddal működik.

A kulcsot és a beállításokat kézzel is megadhatja a ~/.qwen/settings.json fájlban. A fájlban szerepel a modelProviders mező (az elérhető modellek), az env (maguk a kulcsok), a security.auth.selectedType (az indításkor engedélyezendő protokoll) és a model.name (az alapértelmezett modell). Ezután a qwen ezekkel a beállításokkal indul, és nem kérdez semmit. Első alkalommal egyszerűbb az /auth menüt használni; később visszatérhet a fájlhoz, ha az összes beállítást el szeretné menteni.

Ha arra kíváncsi, mi maradt ingyenes április után, olvassa el a Qwen Code ingyenes használatáról szóló cikket.

Melyik módot kapcsoljuk be, hogy az ügynök önállóan szerkessze a kódot?#

A lényeg: a hozzáférési mód határozza meg, mennyire önállóan cselekszik az ügynök. Öt mód van, a legóvatosabbtól a legmegengedőbbig.

Ha az ügynök csak megmutatja a szerkesztéseket, majd vár, valószínűleg Ask Permissions módban van (a régebbi verziókban ezt Defaultnak hívták). Ilyenkor minden szerkesztést és parancsot kézzel kell jóváhagynia, ezért úgy tűnhet, mintha az ügynök nem csinálna semmit magától.

Ha azt szeretné, hogy az ügynök kérdezés nélkül szerkessze a fájlokat, váltson Auto-Edit módra. A szerkesztések automatikusan megtörténnek, az ügynök azonban továbbra is engedélyt kér a parancsok futtatása előtt — ez ésszerű védelem az ellen, hogy véletlenül rossz helyen fusson le az rm.

Az Auto belső értékelőt használ az értékelést igénylő műveletekhez. A telepített verzió és az aktív állapot ellenőrzése után tudatosan válassza; az Ask Permissions konfigurációjában megőrzött default szó kompatibilitási név, nem bizonyítja az indulási módot.

A YOLO a legmegengedőbb mód. Az ügynök kérdezés nélkül szerkeszti a fájlokat és futtatja a parancsokat. A dokumentáció szerint csak megbízható személyes projektekhez és automatizált munkafolyamatokhoz való. Munkaprojektben könnyű nem kívánt eredményt elérni, ezért csak megfontoltan, lehetőleg egy másolaton kapcsolja be.

Hogyan válthatunk módot munkamenet közben?#

Munka közben, akár egy feladat közepén is módot válthat. Nyomja meg a Shift+Tab billentyűkombinációt a következő módra lépéshez. Windowson ugyanezt a Tab billentyű végzi. A sorrend: Plan, megerősítés, automatikus szerkesztés, Auto, YOLO, majd vissza a Plan módhoz.

Az aktuális mód mindig látható a felület alján található állapotsorban. Mielőtt nagy feladatot ad az ügynöknek, szokja meg az ellenőrzését, nehogy YOLO módban indítsa el, amikor csak a tervet akarta megnézni.

A kezdők számára jól követhető munkafolyamat három lépésből áll:

1. Indítsa el az ügynököt Plan módban, és kérje meg, hogy elemezze a feladatot, majd javasoljon tervet. Semmihez sem nyúl; csak beolvassa a kódot, és leírja, mit szándékozik tenni.
2. Olvassa el a tervet, és ha egyetért vele, a Shift+Tab megnyomásával váltson Auto-Edit vagy Auto módra.
3. Mondja meg az ügynöknek, hogy folytassa. Ekkor önállóan szerkeszti a fájlokat, Ön pedig figyelheti az eredményeket.

Ez a megközelítés eloszlatja a kezdők legnagyobb félelmét, hogy az ügynök azonnal mindent tönkretesz. Először biztonságos módban átnézi a tervet, és csak utána engedi tovább dolgozni.

A vibe coding teljes megközelítése a módszerre épül; az eszköz másodlagos. Qwen, Claude vagy bármi más — az alatta működő modell lecserélhető. Három alapelv segít megőrizni az eredményeket a modellváltáskor: egy AI-klón, egy Second Brain és a kontextusmérnökség. Együtt kiszámítható eredményt adnak; ennek semmi köze az egyszeri szerencséhez.

Helyi modell bankkártya nélkül#

Telepítsen egy nyílt modellt a számítógépére az Ollamán vagy a vLLM-en keresztül, majd csatlakoztassa Custom Providerként az /auth menüből. Ezután az ügynök a saját gépén futó modellt használja az Alibaba felhője helyett. Nincs szükség bankkártyára vagy kulcsokra, és nincs kéréskorlát. Ha arra kíváncsi, mely nyílt modellek alkalmasak kódolásra, olvassa el ezt az ingyenes kódolási modellekről szóló áttekintést.

A kompromisszumot a hardver jelenti. Egy olyan modell, amely elfogadhatóan jól ír kódot, sok videomemóriát igényel. Erős grafikus kártyával szerelt gamer számítógépen megoldható, egy átlagos laptopon azonban lehet, hogy nem fér el a modell, vagy olyan sokáig tart minden válasz átgondolása, hogy egyszerűbb másik lehetőséget keresni.

A helyi futtatás további előnye az adatvédelem. Az összes kód a számítógépén marad; semmi sem kerül más szerverére. Érzékeny projektnél ez fontosabb lehet, mint az előfizetési díj megtakarítása.

Hogyan akadályozhatjuk meg, hogy az ügynök tönkretegye a projektet?#

Az önálló ügynök kényelmes, amíg azt csinálja, amit szeretne. Hogy egy félrelépés ne kerüljön sokba, tartsa be ezt a három szokást.

Először is használjon git-et. Ha a projekt verziókezelés alatt áll, láthatja az ügynök összes módosítását, és bármelyiket visszavonhatja. Git nélkül valóban kockázatos egy önálló ügynök: módosít valamit, Ön pedig nem tudja visszaállítani az előző verziót. Git használatával egy rövid paranccsal visszavonhatja a módosítást.

Másodszor, Plan módban kezdjen. Mielőtt nagy feladatot ad az ügynöknek, kérje meg, hogy készítsen tervet egy olyan módban, amelyben semmihez sem nyúl. Olvassa el, értse meg, mit szándékozik tenni az ügynök, majd váltson szerkesztési módra.

Harmadszor, bánjon óvatosan a YOLO móddal. Ebben a módban az ügynök önállóan futtat parancsokat, köztük fájlokat törlő parancsokat is. Ez túl nagy kockázat egy munkaprojekthez. Tartsa meg a YOLO módot durva másolatokhoz és olyan kisebb feladatokhoz, ahol nem gond, ha valami félresikerül.

Ez a három szokás a legnagyobb félelmet kezeli: „vibe codinggal készítettem, és elrontottam”. Ha többet szeretne megtudni a változtatások visszavonásáról vibe coding közben, olvassa el ezt a külön áttekintést. A cikk a Claude Code-ról szól, de a git használatának alapelve pontosan ugyanaz.

Mivel kezdje el a feladatát?#

Íme az egész folyamat rövid listája. Haladjon végig rajta fentről lefelé:

1. Telepítse a Qwen Code-ot egyetlen paranccsal, majd indítsa újra a terminált.
2. Lépjen be a projektmappába a cd paranccsal, majd futtassa a qwen parancsot.
3. Csatlakoztasson modellt az /auth menün keresztül: egy fizetős csomagot vagy helyi modellt az Ollamán keresztül, ha a bankkártyás fizetés nem jöhet szóba.
4. Adjon feladatot az ügynöknek Plan módban, és olvassa el a tervét.
5. A Shift+Tab billentyűkombinációval váltson Auto-Edit vagy Auto módra, majd hagyja dolgozni az ügynököt.
6. Tartsa a projektet git-verziókezelés alatt, hogy bármelyik szerkesztést visszavonhassa.

Röviden: a „Qwen nem ír magától kódot” szinte mindig azt jelenti, hogy nincs modell csatlakoztatva, vagy az ügynök megerősítést kérő módban van. Az első problémát az /auth menüben, a másodikat pedig a Shift+Tab megnyomásával oldhatja meg, amíg el nem éri az Auto-Edit módot. Ezután az ügynök valóban magától dolgozik a terminálban.

Ha össze szeretné hasonlítani a Qwent más, az Ön feladatához használható ügynökökkel, olvassa el a Claude Code alternatíváiról szóló áttekintést. A Qwen a többi mellett szerepel benne, így láthatja, melyik mire való.

A vibe coding teljes megközelítése a módszerre épül, a konkrét ügynök pedig másodlagos: AI-klón plusz Second Brain plusz kontextusmérnökség. Lecserélheti az alatta működő eszközt; a módszer ugyanaz marad. Gyakorlati források: Ailoot dokumentáció.

További források és eszközök: Ailoot.