Jak spustit Qwen Code v terminálu a nastavit režim úprav

Otázka zní asi takto: jak zařídit, aby Qwen v konzoli správně fungoval a sám psal kód? Obvykle se za ní skrývá zklamání: někdo si nainstaloval Qwen Code, položil otázku a dostal odpověď ve formě textu a kusu kódu, který musel ručně zkopírovat, přestože mu slibovali agenta, který vstoupí do projektu a všechno udělá sám.

Přesně takový Qwen Code je: plnohodnotný agent. Dokáže sám otevírat a upravovat soubory a spouštět příkazy. Chování závisí na aktivním režimu schvalování: Ask Permissions žádá potvrzení, Auto-Edit a Auto dovolují samostatnější práci. Ověřte stavový řádek místo předpokladu, že režim nazvaný Default je výchozí volbou instalace. Níže postupně najdete instalaci, spuštění v projektu, připojení modelu po dubnových změnách a přepnutí do režimu, v němž agent upravuje kód bez zbytečných otázek. Vše bylo ověřeno podle oficiální dokumentace Qwen ke dni 30. srpna 2026.

Praktické zdroje o modelech a agentech: dokumentace Ailoot.

Co znamená, že „Qwen Code píše kód sám“?#

Rozdíl je jednoduchý. Chat v prohlížeči odpoví na otázku textem. Přečtete si odpověď, zkopírujete kód, vložíte ho do souboru, sami ho spustíte, sami zachytíte chybu a vrátíte se s ní do chatu. Jste prostředníkem mezi chatem a projektem.

Agent funguje jinak. Zadáte mu úkol běžným jazykem: „přidej formulář zpětné vazby“, „oprav tuto chybu“. Potom prozkoumá strukturu projektu, najde příslušné soubory, upraví je a spustí kontrolu. Dokumentace to popisuje jednoduše: agent vytvoří plán, napíše kód a ověří, že funguje.

Právě tady vzniká zmatek v otázce. „Qwen nepíše kód sám“ obvykle znamená jednu ze dvou věcí: buď má člověk otevřený chat v prohlížeči místo terminálového agenta, nebo agent běží, ale je nastavený do režimu, v němž žádá o svolení při každé úpravě. První problém vyřeší instalace Qwen Code, druhý přepnutí režimu. Obě řešení popisujeme níže.

Jak nainstalovat Qwen Code do terminálu?#

Nejrychlejší je oficiální instalátor, který automaticky vybere verzi pro váš systém.

V macOS a Linuxu otevřete terminál a vložte jeden řádek:

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

Ve Windows proveďte totéž tímto příkazem PowerShellu:

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

Druhou možností je npm, pokud už ho máte nainstalovaný. Vyžaduje Node.js verze 22 nebo novější:

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

Po instalaci restartujte terminál. Instalátor přidá příkaz qwen do systémových cest a terminál o něm nebude vědět, dokud ho nerestartujete. To je nejčastější důvod hlášky „Nainstaloval jsem ho, ale příkaz se nenašel.“ Ověřte instalaci příkazem:

qwen --version

Pokud se zobrazí číslo verze, agent je nainstalovaný a připravený ke spuštění ve vašem projektu.

Jak spustit Qwen Code ve svém projektu?#

Nejprve přejděte do složky s kódem. Je to důležité: agent pracuje ve složce, ze které byl spuštěn, a vidí pouze její obsah.

cd path-to-your-project
qwen

Rozhraní agenta se otevře přímo v terminálu. Při prvním spuštění nabídne připojení modelu; tomu se věnuje následující část. Jakmile model připojíte, můžete agentovi běžným jazykem zadat úkol a zjistit, k čemu má přístup:

what does this project do?

Agent přečte soubory, porozumí struktuře a podá užitečnou odpověď. Pak ho můžete požádat, aby napsal a upravil kód: „přidej tlačítko pro odhlášení“, „rozděl tento soubor na dva“, „zjisti, proč test selhává“. Najde příslušná místa a provede změny sám.

Spustit ho lze i druhým způsobem: jedním příkazem, bez rozhraní. Hodí se to pro skripty a automatizované úlohy:

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

Provede úkol a ukončí se bez konverzace. Na první kroky to nepotřebujete, ale později se to může hodit.

Proč agent běží, ale sám nic nedělá?#

První překážkou je přístup k modelu. Qwen Code dříve nabízel bezplatný přístup: přihlásili jste se účtem qwen.ai a agent fungoval bez platební karty. Tento přístup se nazýval Qwen OAuth a byl ukončen. Dokumentace k autorizaci to říká přímo: bezplatná úroveň Qwen OAuth byla ukončena 15. dubna 2026; dříve uložená přihlášení mohla ještě krátce fungovat, ale server nové požadavky odmítá. Z nabídky byla odstraněna i možnost „sign in with qwen.ai“.

Aby agent vůbec začal úkol promýšlet, potřebujete tedy připojený model. V následující části najdete možnosti připojení, placené i bezplatné místní.

Druhý důvod je méně nápadný a ještě frustrující. Model je připojený, agent odpovídá, ale neupravuje žádné soubory: pouze ukazuje, co plánuje udělat, a čeká. Toto chování odpovídá režimu Ask Permissions žádajícímu potvrzení úprav a příkazů; nedokazuje univerzální výchozí režim při spuštění. Chcete-li, aby pracoval sám, musíte přepnout režim. Tomu se věnují dvě následující části, kde najdete odpověď na původní otázku.

Jak připojit model, když je bezplatný přístup ukončen?#

V agentovi zadejte příkaz:

/auth

Otevře se nabídka se třemi hlavními možnostmi. Zde je, co každá z nich nabízí.

Alibaba ModelStudio je oficiální možnost od tvůrců Qwen. Nabízí Coding Plan s pevnou cenou a týdenním limitem pro jednotlivého vývojáře, Token Plan s platbou podle spotřeby pro týmy a možnost připojit existující klíč ModelStudio. Jde o placený přístup k „nativnímu“ modelu Qwen.

Poskytovatelé třetích stran vám umožní vybrat vestavěného poskytovatele a připojit se klíčem. Oficiální seznam zahrnuje DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope a další. Získejte klíč od poskytovatele, zadejte ho a agent bude používat jeho model.

Custom Provider připojí váš vlastní server, proxy nebo místní engine. Tímto způsobem připojíte model spuštěný ve svém počítači přes Ollama. Tato možnost podporuje formáty OpenAI, Anthropic a Gemini, takže funguje téměř s jakýmkoli způsobem přístupu.

Klíč a nastavení můžete zadat také ručně v souboru ~/.qwen/settings.json. Obsahuje pole modelProviders (dostupné modely), env (samotné klíče), security.auth.selectedType (protokol, který se má při spuštění povolit) a model.name (výchozí model). Pak se qwen spustí s tímto nastavením a na nic se nebude ptát. Pro začátek je jednodušší použít /auth; k souboru se můžete vrátit, až budete chtít všechna nastavení uložit.

Přehled toho, co zůstalo po dubnu bezplatné, najdete v článku o bezplatném Qwen Code.

Který režim zapnout, aby agent sám upravoval kód?#

Základní princip je tento: režim přístupu určuje, jak samostatně agent jedná. Existuje pět režimů, od nejopatrnějšího po nejvolnější.

Pokud vám agent pouze ukazuje úpravy a čeká, nejspíš je v režimu Ask Permissions (ve starších verzích nazývaném Default). Pak musíte každou úpravu a příkaz ručně potvrdit, takže to vypadá, jako by agent sám nic nedělal.

Chcete-li, aby upravoval soubory bez dotazování, přepněte na Auto-Edit. Úpravy budou probíhat automaticky, ale před spouštěním příkazů se agent stále zeptá. Je to rozumná ochrana před nechtěným spuštěním příkazu rm na nesprávném místě.

Auto používá interní vyhodnocování akcí vyžadujících posouzení. Zvolte jej vědomě po ověření instalované verze a aktivního stavu; slovo default zachované v konfiguraci Ask Permissions je kompatibilní název, nikoli důkaz počátečního režimu.

YOLO je nejvolnější režim. Agent sám upravuje soubory a spouští příkazy, aniž by se na cokoli ptal. Dokumentace uvádí, že je určen pouze pro důvěryhodné osobní projekty a automatizované pracovní postupy. Ve firemním projektu snadno vznikne nežádoucí výsledek, proto ho zapínejte jen s rozmyslem a nejlépe na kopii.

Jak přepínat režimy během relace?#

Režimy můžete přepínat průběžně, i uprostřed úkolu. Stisknutím Shift+Tab přejdete na další režim. Ve Windows dělá totéž běžná klávesa Tab. Cyklus je: Plan, potom potvrzování, automatické úpravy, Auto, YOLO a zpět na Plan.

Aktuální režim se vždy zobrazuje ve stavovém řádku ve spodní části rozhraní. Zvykněte si ho před zadáním velkého úkolu zkontrolovat, abyste nespustili YOLO, když jste chtěli jen prohlédnout plán.

Postup vhodný pro začátečníky má tři kroky:

1. Spusťte agenta v režimu Plan a požádejte ho, aby úkol analyzoval a navrhl plán. Na nic nesáhne; pouze přečte kód a popíše, co hodlá udělat.
2. Přečtěte si plán, a pokud s ním souhlasíte, stisknutím Shift+Tab přepněte na Auto-Edit nebo Auto.
3. Řekněte mu, ať pokračuje. Agent teď bude sám upravovat soubory a vy můžete sledovat výsledky.

Tento postup odstraňuje hlavní obavu začátečníků, že agent okamžitě všechno rozbije. Nejprve si v bezpečném režimu prohlédnete plán a teprve potom ho necháte pokračovat.

Celý přístup k vibe codingu stojí především na metodě; nástroj je až druhotný. Qwen, Claude, cokoli — model běžící na pozadí můžete změnit. Tři základy vám pomohou udržet výsledky při změně modelů: AI klon, Second Brain a kontextové inženýrství. Dohromady přinášejí předvídatelné výsledky; jednorázové štěstí s tím nemá nic společného.

Místní model bez platební karty#

Nainstalujte si otevřený model do počítače přes Ollama nebo vLLM a pak ho připojte jako Custom Provider v nabídce /auth. Agent potom používá model ve vašem počítači místo cloudu Alibaba. Nepotřebujete kartu ani klíče a neplatí žádný limit požadavků. Přehled otevřených modelů vhodných pro programování najdete v této recenzi bezplatných modelů pro programování.

Nevýhodou jsou nároky na hardware. Model, který píše kód dostatečně dobře, potřebuje hodně video paměti. Na herním počítači s výkonnou grafickou kartou to lze zvládnout, ale na běžný notebook se model nemusí vejít, případně mu může promýšlení každé odpovědi trvat tak dlouho, že bude snazší hledat jinou možnost.

Další výhodou místního provozu je ochrana soukromí dat. Veškerý váš kód zůstává v počítači; nic se neposílá na server někoho jiného. U citlivého projektu je to důležitější než úspora za předplatné.

Jak zabránit tomu, aby agent projekt poškodil?#

Samostatný agent je užitečný, dokud dělá to, co chcete. Abyste předešli tomu, že vás jeho chyba něco bude stát, dodržujte tři návyky.

Za prvé používejte git. Pokud je projekt pod správou verzí, můžete vidět každou úpravu agenta a kteroukoli z nich vrátit. Bez gitu je samostatný agent opravdu riskantní: něco změní a předchozí verzi nelze obnovit. S gitem stačí k návratu jeden krátký příkaz.

Za druhé začínejte v režimu Plan. Než agentovi svěříte velký úkol, požádejte ho o vytvoření plánu v režimu, v němž na nic nesáhne. Přečtěte si ho a pochopte, co agent zamýšlí udělat, a pak přepněte na úpravy.

Za třetí buďte opatrní s YOLO. V tomto režimu agent sám spouští příkazy, včetně těch, které mažou soubory. Pro pracovní projekt je to příliš velká volnost. YOLO si nechte pro hrubé kopie a malé úkoly, kde nebude vadit, když se něco pokazí.

Tyto tři návyky řeší hlavní obavu: „Použil jsem vibe coding a všechno rozbil.“ Více o vracení změn při vibe codingu najdete v samostatné recenzi. Ta se věnuje Claude Code, ale princip používání gitu je úplně stejný.

Kde začít s vaším úkolem?#

Zde je celý postup v krátkém seznamu. Postupujte odshora dolů:

1. Nainstalujte Qwen Code jediným příkazem a restartujte terminál.
2. Přejděte do složky projektu příkazem cd a spusťte qwen.
3. Přes /auth připojte model: placený tarif nebo místní model přes Ollama, pokud nemůžete platit kartou.
4. Zadejte agentovi úkol v režimu Plan a přečtěte si jeho plán.
5. Stisknutím Shift+Tab přepněte na Auto-Edit nebo Auto a nechte ho pracovat.
6. Udržujte projekt pod správou verzí git, abyste mohli vrátit jakoukoli úpravu.

Stručně řečeno, „Qwen nepíše kód sám“ téměř vždy znamená, že buď není připojený žádný model, nebo je agent v režimu potvrzování. První problém vyřešíte v nabídce /auth, druhý stisknutím Shift+Tab, dokud se nedostanete na Auto-Edit. Potom agent v terminálu opravdu pracuje sám.

Pokud chcete Qwen porovnat s dalšími agenty pro svůj úkol, podívejte se na tuto recenzi alternativ ke Claude Code. Qwen se v ní objevuje spolu s ostatními, takže uvidíte, který se hodí k čemu.

Celý přístup k vibe codingu stojí na metodě a konkrétní agent je až druhotný: AI klon plus Second Brain plus kontextové inženýrství. Nástroj běžící na pozadí můžete změnit; metoda zůstává stejná. Praktické zdroje: dokumentace Ailoot.

Další zdroje a nástroje: Ailoot.