Tinklaraštis

Dirbtinis intelektas ir programavimas: Kaip paleisti Qwen Code terminale, kad jis už jus rašytų kodą 2026 m.

Markdown

Qwen Code įdiegimas, paleidimas projekte, modelio prijungimas per auth, Plan, Auto-Edit, Auto ir YOLO režimai, vietinis modelis ir projekto apsauga.

Skaityti visą straipsnį

Klausimas skamba maždaug taip: kaip pasiekti, kad Qwen tinkamai veiktų konsolėje ir pats rašytų kodą? Dažniausiai už jo slypi nusivylimas: kas nors įsidiegė Qwen Code, uždavė klausimą ir gavo atsakymą su tekstu bei kodo fragmentu, kurį turėjo nukopijuoti rankiniu būdu, nors jam buvo pažadėtas agentas, kuris įeitų į projektą ir viską padarytų pats.

Būtent toks ir yra Qwen Code: visavertis agentas. Jis gali pats atverti ir redaguoti failus bei vykdyti komandas. Jo elgsena priklauso nuo aktyvaus patvirtinimo režimo: Ask Permissions prašo patvirtinimo, o Auto-Edit ir Auto leidžia daugiau savarankiško darbo. Patikrinkite būsenos eilutę, užuot manę, kad režimas pavadinimu Default yra pradinė parinktis. Toliau aptariama iš eilės: diegimas, paleidimas projekte, modelio prijungimas po balandžio pakeitimų ir perjungimas į režimą, kuriuo agentas redaguoja kodą neužduodamas nereikalingų klausimų. Viskas patikrinta pagal oficialią Qwen dokumentaciją 2026 m. rugpjūčio 30 d.

Praktiniai šaltiniai apie modelius ir agentus: Ailoot dokumentacija.

Ką reiškia „Qwen Code pats rašo kodą“?

Pagrindinė mintis

Qwen Code yra AI agentas terminale. Jis perskaito visą projektą, pats atveria ir redaguoja failus, vykdo komandas ir patikrina rezultatus. Pokalbių langas naršyklėje pateikia tekstą, kurį perkeliate rankiniu būdu. Agentas dirba tiesiai kodo aplanke. Oficialus apibūdinimas: „atvirojo kodo AI programavimo agentas, gyvenantis jūsų terminale“.

Skirtumas paprastas. Pokalbių langas naršyklėje atsako į klausimą tekstu. Perskaitote atsakymą, nukopijuojate kodą, įklijuojate jį į failą, patys jį paleidžiate, patys surandate klaidą ir grąžinate ją į pokalbį. Jūs tampate tarpininku tarp pokalbio ir projekto.

Agentas dirba kitaip. Paprasta kalba nurodote jam užduotį: „pridėk atsiliepimų formą“, „ištaisyk šią klaidą“. Tada jis išnagrinėja projekto struktūrą, suranda reikiamus failus, atlieka pakeitimus ir paleidžia patikrą. Dokumentacijoje pasakyta aiškiai: agentas sudaro planą, parašo kodą ir įsitikina, kad jis veikia.

Todėl ir kyla klausimas. „Qwen pats nerašo kodo“ beveik visada reiškia vieną iš dviejų dalykų: žmogus atsidarė pokalbių langą naršyklėje, o ne terminalo agentą, arba agentas veikia režimu, kuriuo prašo leidimo kiekvienam pakeitimui. Pirmą problemą išsprendžia Qwen Code įdiegimas, antrą — režimo pakeitimas. Toliau aptariami abu sprendimai.

Kaip įdiegti Qwen Code terminale?

Pagrindinė mintis

Jis įdiegiamas viena komanda. „macOS“ ir „Linux“ naudokite oficialią Qwen diegimo programą arba npm (reikalinga Node.js 22 arba naujesnė versija). „Windows“ sistemoje naudokite komandą „PowerShell“. Įdiegę iš naujo paleiskite terminalą, kitaip komanda qwen gali būti nerasta. Diegimas nemokamas ir visiems vienodas; išlaidos atsiranda vėliau, kai gaunate prieigą prie modelio.

Greičiausias būdas — oficiali diegimo programa, kuri automatiškai parenka jūsų sistemai skirtą versiją.

„macOS“ ir „Linux“ atidarykite terminalą ir įklijuokite vieną eilutę:

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

„Windows“ sistemoje atlikite tą patį naudodami šią „PowerShell“ komandą:

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

Kitas būdas — npm, jei jį jau esate įdiegę. Tam reikalinga Node.js 22 arba naujesnė versija:

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

Įdiegę iš naujo paleiskite terminalą. Diegimo programa įtraukia komandą qwen į sistemos kelius, o terminalas jos neatpažins, kol nebus paleistas iš naujo. Tai dažniausia priežastis, kodėl rodoma „Įdiegiau, bet komandos neranda“. Norėdami patikrinti, ar viskas įdiegta, vykdykite:

qwen --version

Jei matote versijos numerį, agentas įdiegtas ir paruoštas paleisti jūsų projekte.

Kaip paleisti Qwen Code savo projekte?

Pagrindinė mintis

Pereikite į projekto aplanką komanda cd, tada įveskite qwen. Atsidarys agento terminalo sąsaja. Pirmą kartą paleidus bus pasiūlyta prijungti modelį per meniu /auth. Po to galėsite paprasta kalba pateikti užduotis — agentas išnagrinės projektą ir imsis darbo. Svarbiausia: paleiskite jį iš projekto aplanko, kad jis matytų visus jūsų failus.

Pirmiausia pereikite į aplanką, kuriame yra jūsų kodas. Tai svarbu: agentas dirba aplanke, iš kurio buvo paleistas, ir mato tik jo turinį.

cd path-to-your-project
qwen

Agento sąsaja atsidarys tiesiai terminale. Pirmą kartą jis pasiūlys prijungti modelį; apie tai rašoma kitame skyriuje. Prijungę modelį, galite pateikti agentui užduotį paprasta kalba ir pažiūrėti, ką jis gali pasiekti:

ką daro šis projektas?

Agentas perskaitys failus, supras struktūrą ir pateiks naudingą atsakymą. Tada galėsite paprašyti jo parašyti ir redaguoti kodą: „pridėk atsijungimo mygtuką“, „padalyk šį failą į du“, „išsiaiškink, kodėl nepavyksta testas“. Jis suras reikiamas vietas ir pats atliks pakeitimus.

Jį taip pat galima paleisti antruoju būdu — viena komanda, be sąsajos. Tai naudinga scenarijams ir automatizuotoms užduotims:

qwen -p "iš naujo perskaityk README ir atnaujink komandų sąrašą"

Taip užduotis atliekama, o agentas baigia darbą be pokalbio. Pirmiesiems žingsniams šio būdo nereikia, bet vėliau pravers jį žinoti.

Kodėl agentas veikia, bet nieko nedaro pats?

Pagrindinė mintis

Jei aktyvus Ask Permissions, Qwen Code laukia jūsų patvirtinimo prieš redagavimus ir komandas. Be to, prieš atlikdamas pakeitimus jis turi būti prijungtas prie modelio: „Alibaba“ 2026 m. balandžio 15 d. nutraukė nemokamą prieigą per qwen.ai, o neturėdamas prijungto modelio prieigos agentas tiesiog negali apgalvoti užduoties. Dvi dažnos priežastys, kodėl jis „tiesiog nieko nedaro“: neprijungtas modelis arba įjungtas atsargus režimas, kuriame prašoma patvirtinti veiksmus.

Pirmoji kliūtis — prieiga prie modelio. Anksčiau Qwen Code siūlė nemokamą prieigą: prisijungdavote naudodami qwen.ai paskyrą ir agentas veikdavo be mokėjimo kortelės. Ši prieiga vadinosi Qwen OAuth ir buvo nutraukta. Autorizavimo dokumentacijoje tai nurodyta tiesiai: nemokama Qwen OAuth pakopa nutraukta 2026 m. balandžio 15 d.; anksčiau išsaugoti prisijungimai dar gali trumpai veikti, bet serveris atmeta naujas užklausas. Meniu taip pat pašalinta parinktis „prisijungti per qwen.ai“.

Taigi, kad agentas apskritai pradėtų apgalvoti užduotį, reikia prijungti modelį. Kitame skyriuje aptariamos prijungimo galimybės — mokamos ir nemokamos vietinės.

Antroji priežastis mažiau pastebima ir labiau erzina. Modelis prijungtas, agentas atsako, tačiau neredaguoja jokių failų — tik parodo, ką ketina daryti, ir laukia. Tai numatyta Ask Permissions režimo elgsena — prieš redagavimus ir komandas prašoma patvirtinimo; tai neįrodo visuotinio paleidimo režimo. Kad jis dirbtų pats, reikia perjungti režimą. Apie tai rašoma dviem skyriais žemiau; ten rasite atsakymą į pradinį klausimą.

Kaip prijungti modelį, kai nemokama prieiga nutraukta?

Pagrindinė mintis

Pirmą kartą paleidus komandą /auth atidaromas meniu su trimis parinktimis. „Alibaba ModelStudio“ yra oficiali mokama parinktis (pavieniai naudotojai gali įsigyti „Coding Plan“ su savaitine kvota). Trečiųjų šalių teikėjai prijungiami raktu: DeepSeek, Kimi ir kiti. „Custom Provider“ leidžia prijungti jūsų pačių arba vietinį modelį per Ollama ir panašius įrankius. Tik paskutinė parinktis — vietinis modelis — veikia nemokamai ir be kortelės.

Agente įveskite komandą:

/auth

Atsidarys meniu su trimis pagrindinėmis parinktimis. Štai ką daro kiekviena iš jų.

„Alibaba ModelStudio“ yra oficiali Qwen kūrėjų parinktis. Pavieniam programuotojui siūlomas „Coding Plan“ su fiksuota kaina ir savaitine kvota, komandoms — „Token Plan“ su mokėjimu pagal naudojimą, taip pat galima prijungti jau turimą „ModelStudio“ raktą. Tai mokama prieiga prie „gimtojo“ Qwen modelio.

Trečiųjų šalių teikėjai leidžia pasirinkti integruotą teikėją ir prisijungti naudojant raktą. Oficialiajame sąraše yra DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope ir kiti. Gaukite teikėjo raktą, įveskite jį, ir agentas naudos to teikėjo modelį.

„Custom Provider“ leidžia prijungti jūsų serverį, tarpinį serverį arba vietinę vykdymo aplinką. Čia prijungiamas kompiuteryje per Ollama veikiantis modelis. Ši parinktis palaiko OpenAI, Anthropic ir Gemini formatus, todėl veikia beveik su bet kokiu prieigos būdu.

Raktą ir nustatymus taip pat galite įvesti rankiniu būdu faile ~/.qwen/settings.json. Jame yra laukas modelProviders (kokie modeliai prieinami), env (patys raktai), security.auth.selectedType (kurį protokolą įjungti paleidus) ir model.name (numatytasis modelis). Tada qwen paleidžiamas su šiais nustatymais ir nieko neklausia. Pirmą kartą paprasčiau naudoti /auth; prie failo galėsite grįžti, kai norėsite išsaugoti visus nustatymus.

Norėdami sužinoti, kas liko nemokama po balandžio, skaitykite straipsnį apie nemokamą Qwen Code.

Kurį režimą įjungti, kad agentas pats redaguotų kodą?

Pagrindinė mintis

Qwen Code penkių režimų dokumentacijos trumpoje lentelėje Auto pažymėtas kaip numatytasis, o Ask Permissions skyriuje dar likusi senesnė pradinio režimo formuluotė. Šis be versijos pateiktas puslapis nenustato kiekvieno diegimo numatytojo režimo: patikrinkite aktyvų režimą savo sesijoje. Auto naudoja klasifikatorių vertinamiems veiksmams leisti arba blokuoti. Jei norite, kad jis redaguotų failus neprašydamas patvirtinimo, naudokite Auto-Edit. Jei esate pasirengę leisti jam redaguoti failus ir vykdyti komandas visiškai neklausinėjant, naudokite YOLO — tačiau tik savo projekte ir atsargiai. Režimas perjungia agentą iš „klausia dėl visko“ į „dirba pats“.

Pagrindinė mintis tokia: prieigos režimas nustato, kiek savarankiškai agentas veikia. Yra penki režimai — nuo atsargiausio iki laisviausio.

RežimasRedaguoja failusVykdo komandasKam skirtas
Planne, tik skaitoneSuprasti projektą ir sudaryti planą nieko nekeičiant
Ask Permissionstik gavęs patvirtinimątik gavęs patvirtinimąNepažįstamas arba svarbus kodas, kai norite matyti kiekvieną žingsnį
Auto-Editpatstik gavęs patvirtinimąDaug smulkių pakeitimų, o komandos lieka jūsų kontroliuojamos
Autopagal saugumo įvertinimąpagal saugumo įvertinimąIlgas savarankiškas darbas su apsaugos priemonėmis
YOLOpatspatsJūsų projektas, kuriame agentui patikite viską

Jei agentas tik parodo pakeitimus ir laukia, tikriausiai įjungtas Ask Permissions režimas (senesnėse versijose jis vadinosi Default). Tuomet kiekvieną pakeitimą ir komandą turite patvirtinti rankiniu būdu, todėl atrodo, kad agentas nieko nedaro pats.

Kad agentas redaguotų failus neprašydamas patvirtinimo, perjunkite į Auto-Edit. Pakeitimai bus atliekami automatiškai, tačiau prieš vykdydamas komandas agentas vis tiek klaus — tai pagrįsta apsauga, kad netyčia nebūtų paleista rm netinkamoje vietoje.

Auto naudoja vidinį vertintoją veiksmams, kuriuos reikia įvertinti. Jį pasirinkite sąmoningai, patikrinę įdiegtą versiją ir aktyvią būseną; Ask Permissions konfigūracijoje paliktas žodis default yra suderinamumo pavadinimas, o ne įrodymas, kad tai paleidimo režimas.

YOLO yra daugiausia laisvės suteikiantis režimas. Agentas pats redaguoja failus ir vykdo komandas, nieko neklausdamas. Dokumentacijoje nurodoma, kad jis skirtas tik patikimiems asmeniniams projektams ir automatizuotoms darbo eigoms. Darbiniame projekte lengva sulaukti nepageidaujamo rezultato, todėl įjunkite jį tik gerai apgalvoję ir, pageidautina, dirbdami su kopija.

Kaip perjungti režimus per sesiją?

Pagrindinė mintis

Likdami agente paspauskite Shift+Tab (sistemoje „Windows“ — Tab), ir režimai keisis tokia tvarka: Plan, patvirtinimai, automatiniai pakeitimai, Auto, YOLO ir vėl Plan. Dabartinis režimas rodomas ekrano apačioje esančioje būsenos eilutėje. Patogi darbo eiga: pradėkite nuo Plan, peržiūrėkite užduotį, tada perjunkite į Auto-Edit arba Auto ir leiskite agentui dirbti.

Režimus galite keisti darbo metu, net ir įpusėję užduotį. Paspauskite Shift+Tab, kad pereitumėte į kitą režimą. Sistemoje „Windows“ tą patį atlieka įprastas Tab klavišas. Režimai keičiasi taip: Plan, patvirtinimai, automatiniai pakeitimai, Auto, YOLO ir vėl Plan.

Dabartinis režimas visada rodomas sąsajos apačioje esančioje būsenos eilutėje. Prieš pateikdami agentui didelę užduotį įpraskite patikrinti režimą, kad nepaleistumėte YOLO, kai norėjote tik peržiūrėti planą.

Pradedantiesiems tinkama darbo eiga susideda iš trijų žingsnių:

  1. Paleiskite agentą Plan režimu ir paprašykite išanalizuoti užduotį bei pasiūlyti planą. Jis nieko nelies — tik perskaitys kodą ir aprašys, ką ketina daryti.
  2. Perskaitykite planą ir, jei sutinkate, paspausdami Shift+Tab perjunkite į Auto-Edit arba Auto.
  3. Liepkite tęsti. Dabar agentas pats redaguos failus, o jūs stebėsite rezultatus.

Šis būdas sumažina didžiausią pradedančiųjų baimę — kad agentas iškart viską sugadins. Pirmiausia saugiu režimu peržiūrite planą, o tik tada leidžiate jam tęsti.

Vietinis modelis be mokėjimo kortelės

Pagrindinė mintis

Taip, galite naudoti vietinį modelį. Qwen Code gali veikti su modeliu, paleistu jūsų kompiuteryje per Ollama ar panašią programą — prijunkite jį iš meniu kaip Custom Provider. „Alibaba“ debesijos tam nereikia. Atvirus modelius galima nemokamai atsisiųsti, mokėjimo kortelės nereikia, o projekto duomenys nepalieka jūsų kompiuterio. Kompromisas tas, kad reikės galingo kompiuterio, kitaip agentas mąstys lėtai.

Įdiekite atvirą modelį savo kompiuteryje per Ollama arba vLLM, tada prijunkite jį kaip Custom Provider iš meniu /auth. Po to agentas naudos jūsų kompiuteryje veikiantį modelį, o ne „Alibaba“ debesiją. Nereikia nei kortelės, nei raktų, nėra ir užklausų limito. Norėdami sužinoti, kurie atviri modeliai gali atlikti programavimo užduotis, skaitykite šią nemokamų programavimo modelių apžvalgą.

Kompromisas — techninė įranga. Modeliui, kuris pakankamai gerai rašo kodą, reikia daug vaizdo atminties. Tai įmanoma žaidimų kompiuteryje su galinga vaizdo plokšte, tačiau įprastame nešiojamajame kompiuteryje modelis gali netilpti arba kiekvieną atsakymą gali rengti taip ilgai, kad paprasčiau būtų ieškoti kito varianto.

Dar vienas vietinio modelio privalumas — duomenų privatumas. Visas jūsų kodas lieka kompiuteryje; niekas nesiunčiama į kieno nors kito serverį. Dirbant su jautriu projektu, tai svarbiau už sutaupytą prenumeratos mokestį.

Kaip neleisti agentui sugadinti projekto?

Pagrindinė mintis

Trys dalykai. Naudokite git versijų valdymą, kad bet kurį agento pakeitimą galėtumėte atšaukti viena komanda. Pradėkite užduotis Plan režimu ir perskaitykite planą prieš leisdami agentui tęsti. Nejunkite YOLO darbiniame projekte — palikite jį kopijoms ir nedideliems bandymams. Taip agento savarankiškumas bus jums naudingas.

Savarankiškas agentas patogus, kol daro tai, ko norėjote. Kad klaida jums brangiai nekainuotų, laikykitės trijų įpročių.

Pirma, naudokite git. Jei projektas valdomas versijų valdymo sistema, galite matyti kiekvieną agento pakeitimą ir bet kurį iš jų atšaukti. Be git savarankiškas agentas iš tiesų rizikingas: jis ką nors pakeičia, o ankstesnės versijos atkurti neįmanoma. Naudojant git, pakanka vienos trumpos komandos.

Antra, pradėkite Plan režimu. Prieš pavesdami agentui didelę užduotį, paprašykite sudaryti planą režimu, kuriuo jis nieko nelies. Perskaitykite planą ir supraskite, ką agentas ketina daryti, tada leiskite redaguoti.

Trečia, atsargiai naudokite YOLO. Šiuo režimu agentas pats vykdo komandas, įskaitant tas, kurios ištrina failus. Darbiniam projektui tai per didelė rizika. YOLO palikite juodraštinėms kopijoms ir nedidelėms užduotims, kai nieko tokio, jei kas nors nepavyktų.

Šie trys įpročiai padeda įveikti pagrindinę baimę — „naudojau vibe coding ir viską sugadinau“. Daugiau apie vibe coding pakeitimų atšaukimą skaitykite atskiroje apžvalgoje. Joje kalbama apie Claude Code, tačiau git naudojimo principas visiškai toks pat.

Nuo ko pradėti atliekant savo užduotį?

Pagrindinė mintis

Įdiekite Qwen Code, pereikite į projekto aplanką, paleiskite qwen ir prijunkite modelį per /auth — mokamą arba vietinį per Ollama. Tada pradėkite Plan režimu, perskaitykite planą, paspausdami Shift+Tab perjunkite į Auto-Edit ir leiskite agentui dirbti. Naudokite git versijų valdymą. Pirmą kartą viską nustatyti užtrunka apie dvidešimt minučių.

Štai visas procesas trumpu sąrašu. Atlikite žingsnius iš eilės:

  1. Įdiekite Qwen Code viena komanda ir iš naujo paleiskite terminalą.
  2. Komanda cd pereikite į projekto aplanką ir paleiskite qwen.
  3. Per /auth prijunkite modelį: mokamą planą arba vietinį modelį per Ollama, jei negalite mokėti kortele.
  4. Plan režimu pateikite agentui užduotį ir perskaitykite jo planą.
  5. Paspausdami Shift+Tab perjunkite į Auto-Edit arba Auto ir leiskite jam dirbti.
  6. Naudokite git versijų valdymą, kad galėtumėte atšaukti bet kokį pakeitimą.

Trumpai tariant, „Qwen pats nerašo kodo“ beveik visada reiškia, kad neprijungtas modelis arba agentas veikia patvirtinimo režimu. Pirmą problemą išspręskite meniu /auth, o antrą — spauskite Shift+Tab, kol pasieksite Auto-Edit. Po to agentas iš tiesų dirbs pats terminale.

Jei norite palyginti Qwen su kitais jūsų užduočiai tinkamais agentais, skaitykite šią Claude Code alternatyvų apžvalgą. Qwen pateikiamas kartu su kitais, kad galėtumėte pamatyti, kuris iš jų kam tinka.

Šaltiniai

Praktiniai šaltiniai: Ailoot dokumentacija.

Daugiau šaltinių ir įrankių: Ailoot.

Išsamiau

Klausimai ir atsakymai

Kodėl Qwen Code rodo siūlomus pakeitimus ir laukia?

Patikrinkite aktyvų režimą būsenos eilutėje. Ask Permissions laukia patvirtinimo, o Plan skirtas analizei. Auto-Edit leidžia redagavimus, išlaikydamas komandų patvirtinimą; taip pat turi būti sukonfigūruota modelio prieiga.

Ar režimo pavadinimas Default įrodo, kuriuo režimu paleidžiamas naujas diegimas?

Ne. Senesnis Default pavadinimas išlaikytas Ask Permissions suderinamumui, o dokumentacijos trumpoje lentelėje Auto pažymėtas kaip numatytasis. Tikrinkite įdiegtą versiją ir aktyvios sesijos režimą, užuot sprendę pagal pavadinimą.

Visi straipsniai