Blog

Ako spustiť Qwen Code v termináli a nastaviť režim úprav

Markdown

Inštalácia Qwen Code, jeho spustenie v projekte, pripojenie modelu cez auth, režimy Plan, Auto-Edit, Auto a YOLO, lokálny model a ochrana projektu.

Prečítať celý článok

Otázka znie asi takto: ako dosiahnuť, aby Qwen správne fungoval v konzole a sám písal kód? Zvyčajne sa za ňou skrýva sklamanie: niekto si nainštaloval Qwen Code, položil otázku a dostal odpoveď v podobe textu a úryvku kódu, ktorý musel skopírovať ručne, hoci mu sľubovali agenta, ktorý vstúpi do projektu a všetko urobí sám.

Presne tým Qwen Code je: plnohodnotným agentom. Dokáže sám otvárať a upravovať súbory aj spúšťať príkazy. Správanie závisí od aktívneho režimu schvaľovania: Ask Permissions žiada potvrdenie, kým Auto-Edit a Auto umožňujú samostatnejšiu prácu. Kontrolujte stavový riadok namiesto predpokladu, že názov Default určuje režim čerstvej inštalácie. Nižšie nájdete postupne inštaláciu, spustenie v projekte, pripojenie modelu po aprílových zmenách a prepnutie do režimu, v ktorom agent upravuje kód bez zbytočných otázok. Všetko bolo overené podľa oficiálnej dokumentácie Qwen k 30. augustu 2026.

Praktické zdroje o modeloch a agentoch: dokumentácia Ailoot.

Čo znamená „Qwen Code píše kód sám“?

Kľúčové zistenie

Qwen Code je AI agent v termináli. Prečíta celý projekt, sám otvára a upravuje súbory, spúšťa príkazy a kontroluje výsledky. Chat v prehliadači vám poskytne text, ktorý musíte preniesť ručne. Agent pracuje priamo v priečinku s kódom. Oficiálny opis znie „open-source AI coding agent, ktorý žije vo vašom termináli“.

Rozdiel je jednoduchý. Chat v prehliadači odpovie na otázku textom. Prečítate si odpoveď, skopírujete kód, vložíte ho do súboru, sami ho spustíte, sami nájdete chybu a pošlete ju späť do chatu. Ste poslíčkom medzi chatom a projektom.

Agent pracuje inak. Zadáte mu úlohu v bežnom jazyku: „pridaj formulár spätnej väzby“, „oprav túto chybu“. Potom preskúma štruktúru projektu, nájde príslušné súbory, upraví ich a spustí kontrolu. Dokumentácia to hovorí priamo: agent vytvorí plán, napíše kód a overí, či funguje.

Odtiaľ pramení nejasnosť v otázke. „Qwen sám nepíše kód“ takmer vždy znamená jedno z dvoch: buď má človek otvorený chat v prehliadači namiesto terminálového agenta, alebo agent beží v režime, v ktorom si pri každej úprave pýta povolenie. Prvý problém vyrieši inštalácia Qwen Code, druhý prepnutie režimu. Nižšie sa venujeme obom riešeniam.

Ako nainštalovať Qwen Code do terminálu?

Kľúčové zistenie

Nainštalujete ho jedným príkazom. V macOS a Linuxe použite oficiálny inštalátor Qwen alebo npm (vyžaduje sa Node.js 22 alebo novší). Vo Windows použite príkaz v PowerShelli. Po inštalácii reštartujte terminál, inak sa príkaz qwen nemusí nájsť. Inštalácia je bezplatná a pre všetkých rovnaká; náklady vznikajú až neskôr, keď získate prístup k modelu.

Najrýchlejšou cestou je oficiálny inštalátor, ktorý automaticky vyberie verziu pre váš systém.

V macOS a Linuxe otvorte terminál a vložte jeden riadok:

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

Vo Windows postupujte rovnako pomocou tohto príkazu PowerShellu:

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

Druhou možnosťou je npm, ak ho už máte nainštalovaný. Vyžaduje sa Node.js verzie 22 alebo novšej:

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

Po inštalácii reštartujte terminál. Inštalátor pridá príkaz qwen do systémových ciest a terminál o ňom nebude vedieť, kým ho nereštartujete — to je najčastejší dôvod hlásenia „Nainštaloval som to, ale príkaz sa nedá nájsť“. Ak chcete overiť, že sa všetko nainštalovalo, spustite:

qwen --version

Ak sa zobrazí číslo verzie, agent je nainštalovaný a pripravený na spustenie vo vašom projekte.

Ako spustiť Qwen Code vo svojom projekte?

Kľúčové zistenie

Prejdite do priečinka projektu príkazom cd a potom zadajte qwen. Otvorí sa terminálové rozhranie agenta. Pri prvom spustení vám ponúkne pripojenie modelu cez ponuku /auth. Potom mu môžete zadávať úlohy v bežnom jazyku — agent preskúma projekt a pustí sa do práce. Podstatné je spustiť ho z priečinka projektu, aby videl všetky vaše súbory.

Najprv prejdite do priečinka s vaším kódom. Je to dôležité: agent pracuje v priečinku, z ktorého bol spustený, a vidí iba jeho obsah.

cd path-to-your-project
qwen

Rozhranie agenta sa otvorí priamo v termináli. Pri prvom spustení vám ponúkne pripojenie modelu; tomu sa venuje nasledujúca časť. Keď je model pripojený, môžete agentovi zadať úlohu v bežnom jazyku a zistiť, k čomu má prístup:

čo robí tento projekt?

Agent prečíta súbory, porozumie štruktúre a poskytne vám užitočnú odpoveď. Potom ho môžete požiadať, aby napísal a upravil kód: „pridaj tlačidlo odhlásenia“, „rozdeľ tento súbor na dva“, „zisti, prečo zlyháva test“. Nájde príslušné miesta a zmeny vykoná sám.

Dá sa spustiť aj druhým spôsobom — jediným príkazom, bez rozhrania. Hodí sa to na skripty a automatizované úlohy:

qwen -p "znovu si prečítaj README a aktualizuj zoznam príkazov"

Tým sa úloha vykoná a agent sa ukončí bez konverzácie. Na začiatku to nepotrebujete, ale neskôr sa vám to môže hodiť.

Prečo agent beží, ale nič nerobí sám?

Kľúčové zistenie

Ak je aktívny Ask Permissions, Qwen Code pred úpravami a príkazmi čaká na vaše potvrdenie. Navyše musí byť pripojený model, aby mohol upravovať súbory: Alibaba 15. apríla 2026 ukončila bezplatný prístup cez qwen.ai a bez prístupu k pripojenému modelu agent jednoducho nedokáže premyslieť úlohu. Dva bežné dôvody, prečo „len nečinne čaká“, sú nepripojený model alebo zapnutý opatrný režim s výzvami na potvrdenie.

Prvou prekážkou je prístup k modelu. Qwen Code kedysi ponúkal bezplatný prístup: prihlásili ste sa účtom qwen.ai a agent fungoval bez platobnej karty. Tento prístup sa volal Qwen OAuth a bol ukončený. Dokumentácia autorizácie to uvádza priamo: bezplatná úroveň Qwen OAuth bola ukončená 15. apríla 2026; predtým uložené prihlásenia môžu ešte krátko fungovať, ale server nové požiadavky odmieta. Z ponuky bola odstránená aj možnosť „prihlásiť sa cez qwen.ai“.

Aby teda agent vôbec začal premýšľať nad úlohou, potrebujete pripojený model. Nasledujúca časť opisuje možnosti pripojenia, platené aj bezplatné lokálne.

Druhý dôvod je nenápadnejší a frustrujúcejší. Model je pripojený, agent odpovedá, ale neupravuje žiadne súbory — iba ukazuje, čo plánuje urobiť, a čaká. V režime Ask Permissions je toto správanie očakávané: pred úpravami a príkazmi žiada potvrdenie; nedokazuje univerzálny režim pri štarte. Ak chcete, aby pracoval samostatne, musíte prepnúť režim. Tomu sa venujeme o dve časti nižšie, kde nájdete odpoveď na pôvodnú otázku.

Ako pripojiť model teraz, keď je bezplatný prístup ukončený?

Kľúčové zistenie

Pri prvom spustení otvorí príkaz /auth ponuku s tromi možnosťami. Alibaba ModelStudio je oficiálna platená možnosť (jednotliví používatelia si môžu zaobstarať Coding Plan s týždenným limitom). Poskytovateľov tretích strán pripojíte pomocou kľúča pre DeepSeek, Kimi a ďalších. Custom Provider pripojí váš vlastný alebo lokálny model cez Ollama a podobné nástroje. Bez platobnej karty funguje bezplatne iba posledná možnosť — lokálny model.

V agentovi zadajte príkaz:

/auth

Otvorí sa ponuka s tromi hlavnými možnosťami. Tu je vysvetlenie každej z nich.

Alibaba ModelStudio je oficiálna možnosť od tvorcov Qwen. Ponúka Coding Plan s pevnou cenou a týždenným limitom pre jednotlivého vývojára, Token Plan s priebežným účtovaním pre tímy a možnosť pripojiť existujúci kľúč ModelStudio. Ide o platený prístup k „natívnemu“ modelu Qwen.

Poskytovatelia tretích strán vám umožňujú vybrať si vstavaného poskytovateľa a pripojiť sa pomocou kľúča. Zoznam zahŕňa DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope a ďalších. Získajte kľúč od poskytovateľa, zadajte ho a agent bude používať jeho model.

Custom Provider pripojí váš vlastný server, proxy alebo lokálne prostredie. Takto pripojíte model spustený vo svojom počítači cez Ollama. Táto možnosť podporuje formáty OpenAI, Anthropic a Gemini, takže funguje takmer s akýmkoľvek spôsobom prístupu.

Kľúč a nastavenia môžete zadať aj ručne do súboru ~/.qwen/settings.json. Obsahuje pole modelProviders (dostupné modely), env (samotné kľúče), security.auth.selectedType (protokol, ktorý sa má povoliť pri spustení) a model.name (predvolený model). Potom sa qwen spustí s týmito nastaveniami a nebude sa na nič pýtať. Prvýkrát je jednoduchšie použiť /auth; k súboru sa môžete vrátiť, keď budete chcieť uložiť všetky nastavenia.

Ak chcete zistiť, čo zostalo bezplatné po apríli, prečítajte si článok o bezplatnom Qwen Code.

Ktorý režim zapnúť, aby agent sám upravoval kód?

Kľúčové zistenie

Dokumentácia piatich režimov Qwen Code v stručnom prehľade označuje Auto ako predvolený, zatiaľ čo sekcia Ask Permissions stále obsahuje staršie znenie o úvodnom režime. Táto neverzionovaná stránka neurčuje predvolený režim každej inštalácie: overte aktívny režim relácie. Auto používa klasifikátor na schválenie či blokovanie posudzovaných činností. Ak chcete, aby upravoval súbory bez výzvy na potvrdenie, použite Auto-Edit. Ak ste pripravení nechať ho upravovať súbory a spúšťať príkazy bez akýchkoľvek otázok, použite YOLO — ale iba vo vlastnom projekte a opatrne. Režim prepína medzi stavom „pýta sa na všetko“ a „pracuje samostatne“.

Základná myšlienka je takáto: režim prístupu určuje, ako samostatne agent koná, a existuje päť režimov — od najopatrnejšieho po najpovolenejší.

RežimUpravuje súborySpúšťa príkazyNa čo slúži
Plannie, iba na čítanieniePochopenie projektu a vytvorenie plánu bez akýchkoľvek zmien
Ask Permissionss potvrdeníms potvrdenímNeznámy alebo dôležitý kód, keď chcete vidieť každý krok
Auto-Editsamostatnes potvrdenímMnožstvo drobných úprav, pričom príkazy zostanú pod vašou kontrolou
Autopodľa posúdenia bezpečnostipodľa posúdenia bezpečnostiDlhšia samostatná práca s ochrannými opatreniami
YOLOsamostatnesamostatneVáš vlastný projekt, v ktorom agentovi dôverujete so všetkým

Ak vám agent iba zobrazuje úpravy a čaká, pravdepodobne je v režime Ask Permissions (v starších verziách sa volal Default). Vtedy musíte každú úpravu a príkaz potvrdiť ručne, takže to vyzerá, akoby agent nič nerobil sám.

Ak chcete, aby upravoval súbory bez výzvy na potvrdenie, prepnite na Auto-Edit. Úpravy sa budú vykonávať automaticky, ale pred spustením príkazov sa agent stále opýta — je to rozumná ochrana pred náhodným spustením rm na nesprávnom mieste.

Auto používa interný hodnotiaci systém na činnosti vyžadujúce posúdenie. Vyberajte ho vedome po kontrole nainštalovanej verzie a aktívneho stavu; slovo default zachované v konfigurácii Ask Permissions je kompatibilný názov, nie dôkaz režimu pri štarte.

YOLO je najpovolenejší režim. Agent sám upravuje súbory a spúšťa príkazy bez toho, aby sa na čokoľvek pýtal. Dokumentácia uvádza, že je určený iba pre dôveryhodné osobné projekty a automatizované pracovné postupy. V pracovnom projekte ľahko dôjde k neželanému výsledku, preto ho zapínajte len s rozvahou a najlepšie na kópii.

Ako prepínať režimy počas relácie?

Kľúčové zistenie

Zostaňte v agentovi a stlačte Shift+Tab (vo Windows Tab). Režimy sa budú striedať v tomto poradí: Plan, potvrdenia, automatické úpravy, Auto, YOLO a znova Plan. Aktuálny režim sa zobrazuje v stavovom riadku v dolnej časti obrazovky. Užitočný pracovný postup je začať v režime Plan, skontrolovať úlohu a potom prejsť na Auto-Edit alebo Auto a nechať agenta pracovať.

Režimy môžete prepínať priebežne, aj uprostred úlohy. Stlačením Shift+Tab prejdete na ďalší režim. Vo Windows robí to isté bežný kláves Tab. Poradie je: Plan, potvrdenia, automatické úpravy, Auto, YOLO a znova Plan.

Aktuálny režim sa vždy zobrazuje v stavovom riadku v dolnej časti rozhrania. Zvyknite si ho skontrolovať pred zadaním veľkej úlohy, aby ste nespustili YOLO, keď ste chceli iba zobraziť plán.

Pracovný postup vhodný pre začiatočníkov má tri kroky:

  1. Spustite agenta v režime Plan a požiadajte ho, aby úlohu analyzoval a navrhol plán. Ničoho sa nedotkne; iba prečíta kód a opíše, čo plánuje urobiť.
  2. Prečítajte si plán a ak s ním súhlasíte, stlačením Shift+Tab prejdite na Auto-Edit alebo Auto.
  3. Povedzte mu, aby pokračoval. Agent teraz bude sám upravovať súbory a vy budete sledovať výsledky.

Tento prístup zmierňuje hlavný strach začiatočníka — že agent okamžite všetko pokazí. Najprv si plán bezpečne skontrolujete a až potom mu dovolíte pokračovať.

Lokálny model bez platobnej karty

Kľúčové zistenie

Áno, môžete používať lokálny model. Qwen Code dokáže pracovať s modelom spusteným priamo vo vašom počítači cez Ollama alebo podobný program — pripojíte ho z ponuky ako Custom Provider. Cloud Alibaba na to nepotrebujete. Open models sa dajú stiahnuť zadarmo, platobná karta nie je potrebná a údaje o vašom projekte neopustia váš počítač. Nevýhodou je, že potrebujete výkonný počítač, inak bude agent premýšľať pomaly.

Nainštalujte si do počítača open model cez Ollama alebo vLLM a potom ho pripojte ako Custom Provider z ponuky /auth. Agent potom používa model vo vašom vlastnom počítači namiesto cloudu Alibaba. Nepotrebujete kartu ani kľúče a počet požiadaviek nie je obmedzený. Ak chcete zistiť, ktoré open models zvládnu programovanie, prečítajte si túto recenziu bezplatných modelov na programovanie.

Nevýhodou je hardvér. Model, ktorý píše kód dostatočne dobre, potrebuje veľa video pamäte. Na hernom počítači s výkonnou grafickou kartou je to uskutočniteľné, ale na bežnom notebooku sa model nemusí zmestiť alebo môže každú odpoveď premýšľať tak dlho, že bude jednoduchšie hľadať inú možnosť.

Ďalšou výhodou lokálnej prevádzky je súkromie údajov. Všetok váš kód zostáva vo vašom počítači; nič sa neposiela na server niekoho iného. Pri citlivom projekte je to dôležitejšie než ušetriť na predplatnom.

Ako zabrániť agentovi, aby pokazil projekt?

Kľúčové zistenie

Tri veci. Udržiavajte projekt pod správou verzií v git, aby ste mohli jedným príkazom vrátiť ktorúkoľvek úpravu agenta. Úlohy začínajte v režime Plan a pred pokračovaním agenta si prečítajte plán. Nezapínajte YOLO v pracovnom projekte — vyhraďte ho pre kópie a malé experimenty. Vďaka tomu bude samostatnosť agenta pracovať vo váš prospech.

Samostatný agent je užitočný, pokiaľ robí to, čo ste chceli. Aby vás jeho chybný krok niečo nestál, osvojte si tri návyky.

Po prvé, používajte git. Ak je projekt pod správou verzií, môžete si pozrieť každú úpravu agenta a ktorúkoľvek z nich vrátiť späť. Samostatný agent je bez git naozaj riskantný: niečo zmení a predchádzajúcu verziu už nemožno obnoviť. S git stačí na vrátenie jedna krátka príkazová veta.

Po druhé, začnite v režime Plan. Predtým, ako agentovi zadáte veľkú úlohu, požiadajte ho o vytvorenie plánu v režime, v ktorom sa ničoho nedotkne. Prečítajte si ho a pochopte, čo chce agent urobiť; až potom povoľte úpravy.

Po tretie, dávajte si pozor na YOLO. V tomto režime agent sám spúšťa príkazy vrátane tých, ktoré odstraňujú súbory. Na pracovný projekt je to príliš veľké riziko. YOLO si nechajte pre pracovné kópie a malé úlohy, pri ktorých nebude záležať na tom, ak sa niečo pokazí.

Tieto tri návyky riešia hlavný strach — „robil som vibe coding a pokazil som to“. Viac o vracaní zmien pri vibe codingu sa dozviete v tejto samostatnej recenzii. Týka sa Claude Code, ale zásada používania git je úplne rovnaká.

Kde začať s vašou úlohou?

Kľúčové zistenie

Nainštalujte Qwen Code, prejdite do priečinka projektu, spustite qwen a pripojte model cez /auth — platený model alebo lokálny cez Ollama. Potom začnite v režime Plan, prečítajte si plán, stlačením Shift+Tab prepnite na Auto-Edit a nechajte agenta pracovať. Projekt udržiavajte pod správou verzií v git. Prvé nastavenie zaberie približne dvadsať minút.

Tu je celý postup v skrátenom zozname. Postupujte zhora nadol:

  1. Nainštalujte Qwen Code jedným príkazom a reštartujte terminál.
  2. Príkazom cd prejdite do priečinka projektu a spustite qwen.
  3. Pripojte model cez /auth: platený plán alebo lokálny model cez Ollama, ak nemôžete platiť kartou.
  4. Zadajte agentovi úlohu v režime Plan a prečítajte si jeho plán.
  5. Stlačením Shift+Tab prepnite na Auto-Edit alebo Auto a nechajte ho pracovať.
  6. Udržiavajte projekt pod správou verzií v git, aby ste mohli vrátiť každú úpravu.

Stručne povedané, „Qwen sám nepíše kód“ takmer vždy znamená, že buď nie je pripojený model, alebo je agent v režime potvrdení. Prvý problém vyriešte v ponuke /auth a druhý stláčaním Shift+Tab, kým sa nedostanete na Auto-Edit. Potom agent naozaj pracuje samostatne v termináli.

Ak chcete porovnať Qwen s inými agentmi pre svoju úlohu, pozrite si túto recenziu alternatív ku Claude Code. Qwen je uvedený spolu s ostatnými, takže môžete zistiť, ktorý sa hodí na čo.

Zdroje

Praktické zdroje: dokumentácia Ailoot.

Ďalšie zdroje a nástroje: Ailoot.

Viac podrobností

Otázky a odpovede: Ako spustiť Qwen Code v termináli a nastaviť režim úprav

Prečo Qwen Code ukazuje navrhnuté zmeny a čaká?

Skontrolujte aktívny režim v stavovom riadku. Ask Permissions čaká na potvrdenie; Plan slúži na analýzu. Auto-Edit povoľuje úpravy a zachováva schvaľovanie príkazov a musí byť nastavený aj prístup k modelu.

Dokazuje názov Default, v akom režime začne čerstvá inštalácia?

Nie. Starší názov Default zostáva pre kompatibilitu Ask Permissions, kým stručný prehľad dokumentácie označuje Auto ako predvolený. Namiesto úsudku z názvu prezrite nainštalovanú verziu a aktívny režim relácie.

Všetky články