Blog

Qwen Code in de terminal uitvoeren en de bewerkingsmodus instellen

Markdown

Qwen Code installeren, starten in een project, een model verbinden via authenticatie, de modi Plan, Auto-Edit, Auto en YOLO gebruiken, een lokaal model inzetten en het project beschermen.

Lees het volledige artikel

De vraag klinkt ongeveer zo: hoe zorg je dat Qwen goed werkt in de console en zelfstandig code schrijft? Meestal zit hier teleurstelling achter: iemand heeft Qwen Code geïnstalleerd, een vraag gesteld en als antwoord tekst en een stukje code gekregen dat diegene met de hand moest kopiëren, terwijl er een agent was beloofd die het project zou openen en alles zelf zou doen.

Dat is precies wat Qwen Code is: een volwaardige agent. Het kan bestanden openen en bewerken en zelf opdrachten uitvoeren. Het gedrag hangt af van de actieve goedkeuringsmodus: Ask Permissions vraagt bevestiging, terwijl Auto-Edit en Auto zelfstandiger werk toestaan. Controleer de statusregel in plaats van aan te nemen dat een modus met de naam Default de begininstelling is. Hieronder bespreken we alles op volgorde: de installatie, starten in een project, een model verbinden na de wijzigingen in april en overschakelen naar een modus waarin de agent code bewerkt zonder onnodige vragen te stellen. Alles is gecontroleerd aan de hand van de officiële documentatie van Qwen, zoals die was op 30 augustus 2026.

Praktische bronnen over modellen en agents: Ailoot-documentatie.

Wat betekent “Qwen Code schrijft zelf code”?

Belangrijkste punt

Qwen Code is een AI-agent in de terminal. Het leest het hele project, opent en bewerkt zelf bestanden, voert opdrachten uit en controleert de resultaten. Een chat in de browser geeft je tekst die je zelf overzet. De agent werkt direct in de codemap. De officiële omschrijving luidt: “een open-source AI-codeeragent die in je terminal leeft”.

Het verschil is eenvoudig. Een chat in de browser beantwoordt een vraag met tekst. Je leest het antwoord, kopieert de code, plakt die in je bestand, voert die zelf uit, zoekt zelf naar fouten en brengt die weer terug naar de chat. Jij bent de koerier tussen de chat en het project.

Een agent werkt anders. Je geeft hem een taak in gewone taal: “voeg een feedbackformulier toe”, “los deze fout op”. Daarna onderzoekt hij de projectstructuur, zoekt de relevante bestanden, brengt wijzigingen aan en voert een controle uit. De documentatie zegt het duidelijk: de agent maakt een plan, schrijft code en controleert of die werkt.

Daar komt de verwarring in de vraag vandaan. “Qwen schrijft niet zelf code” betekent bijna altijd een van twee dingen: iemand heeft een chat in de browser geopend in plaats van de terminalagent, of de agent draait wel, maar staat in een modus waarin hij voor elke bewerking toestemming vraagt. Het eerste los je op door Qwen Code te installeren; het tweede door van modus te wisselen. Hieronder behandelen we beide oplossingen.

Hoe installeer je Qwen Code in de terminal?

Belangrijkste punt

Je installeert het met één opdracht. Gebruik op macOS en Linux het officiële installatieprogramma van Qwen of npm (Node.js 22 of hoger is vereist). Gebruik op Windows een opdracht in PowerShell. Start na de installatie de terminal opnieuw op, anders wordt de opdracht qwen mogelijk niet gevonden. De installatie is gratis en voor iedereen hetzelfde; de kosten beginnen later, wanneer je toegang krijgt tot een model.

De snelste manier is het officiële installatieprogramma, dat automatisch de juiste versie voor je systeem kiest.

Open op macOS en Linux de terminal en plak deze regel:

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

Gebruik op Windows deze PowerShell-opdracht:

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

De tweede optie is npm, als je dat al hebt geïnstalleerd. Hiervoor is Node.js versie 22 of hoger vereist:

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

Start na de installatie de terminal opnieuw op. Het installatieprogramma voegt de opdracht qwen toe aan de systeempaden, maar de terminal weet dat pas nadat je die opnieuw hebt opgestart. Dit is de meest voorkomende reden voor “Ik heb het geïnstalleerd, maar de opdracht wordt niet gevonden.” Controleer met deze opdracht of alles is geïnstalleerd:

qwen --version

Als je een versienummer ziet, is de agent geïnstalleerd en klaar om in je project te starten.

Hoe start je Qwen Code in je project?

Belangrijkste punt

Ga met de opdracht cd naar de projectmap en typ daarna qwen. De terminalinterface van de agent wordt geopend. De eerste keer vraagt die je een model te verbinden via het menu /auth. Daarna kun je opdrachten in gewone taal geven en gaat de agent het project bekijken en aan de slag. Het belangrijkste: start de agent vanuit de projectmap, zodat hij al je bestanden kan zien.

Ga eerst naar de map met je code. Dat is belangrijk: de agent werkt in de map van waaruit hij is gestart en ziet alleen de inhoud daarvan.

cd path-to-your-project
qwen

De interface van de agent wordt direct in de terminal geopend. De eerste keer biedt hij aan een model te verbinden; dat bespreken we in de volgende sectie. Zodra het model is verbonden, kun je de agent een opdracht in gewone taal geven om te zien waartoe hij toegang heeft:

what does this project do?

De agent leest de bestanden, begrijpt de structuur en geeft je een nuttig antwoord. Daarna kun je hem vragen code te schrijven en te bewerken: “voeg een uitlogknop toe”, “splits dit bestand in tweeën”, “zoek uit waarom de test mislukt”. Hij vindt de relevante plekken en brengt de wijzigingen zelf aan.

Je kunt de agent ook met één opdracht starten, zonder interface. Dat is handig voor scripts en geautomatiseerde taken:

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

De agent voert de taak uit en sluit af zonder gesprek. Voor de eerste stappen heb je dit niet nodig, maar later is het handig om te kennen.

Waarom draait de agent, maar doet hij niets uit zichzelf?

Belangrijkste punt

Als Ask Permissions actief is, wacht Qwen Code op je bevestiging voor bewerkingen en opdrachten. Bovendien moet er een model zijn verbonden voordat het wijzigingen kan aanbrengen: Alibaba heeft op 15 april 2026 de gratis toegang via qwen.ai gesloten. Zonder verbonden modeltoegang kan de agent een taak niet doordenken. De twee veelvoorkomende redenen waarom de agent “stil blijft zitten” zijn dat er geen model is verbonden of dat de voorzichtige modus met bevestigingsvragen is ingeschakeld.

De eerste hindernis is toegang tot een model. Qwen Code bood vroeger gratis toegang: je logde in met een qwen.ai-account en de agent werkte zonder betaalkaart. Die toegang heette Qwen OAuth en is stopgezet. De documentatie over autorisatie zegt het rechtstreeks: de gratis Qwen OAuth-laag is op 15 april 2026 stopgezet; eerder opgeslagen aanmeldingen werken mogelijk nog kort, maar de server weigert nieuwe verzoeken. De optie “aanmelden met qwen.ai” is ook uit het menu verwijderd.

Om de agent überhaupt een taak te laten doordenken, moet je dus een model verbinden. In de volgende sectie bespreken we de verbindingsopties, zowel betaalde als gratis lokale opties.

De tweede reden is minder zichtbaar en frustrerender. Het model is verbonden, de agent reageert, maar bewerkt geen bestanden: hij laat alleen zien wat hij van plan is en wacht. Dat gedrag hoort bij Ask Permissions, dat vóór bewerkingen en opdrachten om bevestiging vraagt; het bewijst geen universele begininstelling. Om de agent zelfstandig te laten werken, moet je van modus wisselen. Dat bespreken we twee secties verderop; daar vind je het antwoord op de oorspronkelijke vraag.

Hoe verbind je een model nu de gratis toegang is gesloten?

Belangrijkste punt

De eerste keer opent de opdracht /auth een menu met drie opties. Alibaba ModelStudio is de officiële betaalde optie (individuele gebruikers kunnen een Coding Plan met een wekelijkse limiet nemen). Je kunt externe providers via een sleutel verbinden, zoals DeepSeek, Kimi en andere. Met Custom Provider verbind je je eigen of een lokaal model via Ollama en vergelijkbare tools. Alleen de laatste optie, een lokaal model, werkt gratis zonder betaalkaart.

Typ in de agent deze opdracht:

/auth

Er wordt een menu met drie hoofdopties geopend. Dit doet elke optie.

Alibaba ModelStudio is de officiële optie van de makers van Qwen. Het biedt een Coding Plan met een vaste prijs en wekelijkse limiet voor een individuele ontwikkelaar, een Token Plan met betaling naar gebruik voor teams en de mogelijkheid om een bestaande ModelStudio-sleutel te verbinden. Dit is betaalde toegang tot het “eigen” model van Qwen.

Met externe providers kun je een ingebouwde provider kiezen en verbinden met een sleutel. De officiële lijst bevat DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope en andere providers. Haal een sleutel op bij de provider, voer die in en de agent gebruikt het model van die provider.

Met Custom Provider verbind je je eigen server, proxy of lokale engine. Zo verbind je een model dat op je computer draait via Ollama. Deze optie ondersteunt de indelingen OpenAI, Anthropic en Gemini en werkt daardoor met vrijwel elke toegangsmethode.

Je kunt de sleutel en instellingen ook handmatig invoeren in het bestand ~/.qwen/settings.json. Dit bestand bevat het veld modelProviders (welke modellen beschikbaar zijn), env (de sleutels zelf), security.auth.selectedType (welk protocol bij het opstarten moet worden ingeschakeld) en model.name (het standaardmodel). Daarna start qwen met deze instellingen en vraagt het niets. De eerste keer is het makkelijker om /auth te gebruiken; je kunt later naar het bestand teruggaan om alle instellingen op te slaan.

Lees het artikel over gratis Qwen Code voor informatie over wat er na april gratis bleef.

Welke modus moet je inschakelen zodat de agent zelf code bewerkt?

Belangrijkste punt

De documentatie over de vijf Qwen Code-modi noemt Auto als standaard in het korte overzicht, terwijl het onderdeel Ask Permissions nog oudere tekst over de beginmodus bevat. Deze pagina zonder versiepin stelt de standaard voor elke installatie niet vast: controleer de actieve modus in je sessie. Auto gebruikt een classifier om beoordeelde acties goed te keuren of te blokkeren. Als je wilt dat het bestanden bewerkt zonder om toestemming te vragen, gebruik je Auto-Edit. Als je bereid bent het zonder enige vraag te laten bewerken en opdrachten uit te voeren, gebruik je YOLO — maar alleen in je eigen project en voorzichtig. De modus is de schakelaar tussen “vraagt overal toestemming voor” en “werkt zelfstandig”.

Het basisidee is eenvoudig: de toegangsmodus bepaalt hoe zelfstandig de agent werkt. Er zijn vijf modi, van de voorzichtigste tot de meest permissieve.

ModusBewerkt bestandenVoert opdrachten uitWaarvoor bedoeld
Plannee, alleen-lezenneeHet project begrijpen en een plan maken zonder iets te wijzigen
Ask Permissionsmet bevestigingmet bevestigingVoor onbekende of belangrijke code, wanneer je elke stap wilt zien
Auto-Editzelfstandigmet bevestigingVeel kleine bewerkingen, terwijl jij de opdrachten onder controle houdt
Autoop basis van een veiligheidsbeoordelingop basis van een veiligheidsbeoordelingLang zelfstandig werken met waarborgen
YOLOzelfstandigzelfstandigJe eigen project, waarin je de agent alles toevertrouwt

Als de agent alleen wijzigingen laat zien en wacht, staat hij waarschijnlijk in de modus Ask Permissions (in oudere versies Default genoemd). Dan moet je elke bewerking en opdracht handmatig bevestigen, waardoor het lijkt alsof de agent niets zelfstandig doet.

Schakel over naar Auto-Edit om bestanden zonder bevestiging te laten bewerken. De bewerkingen gebeuren automatisch, maar de agent vraagt nog steeds toestemming voordat hij opdrachten uitvoert — een verstandige bescherming tegen het per ongeluk uitvoeren van rm op de verkeerde plek.

Auto gebruikt een interne beoordelaar voor acties die beoordeling nodig hebben. Kies de modus bewust nadat je de geïnstalleerde versie en actieve status hebt gecontroleerd; het woord default in de Ask Permissions-configuratie is een compatibiliteitsnaam, geen bewijs dat dit de beginmodus is.

YOLO is de meest permissieve modus. De agent bewerkt bestanden en voert opdrachten uit zonder iets te vragen. Volgens de documentatie is deze modus alleen bedoeld voor vertrouwde persoonlijke projecten en geautomatiseerde workflows. In een werkproject kun je gemakkelijk een ongewenst resultaat krijgen, dus schakel deze modus alleen met een helder hoofd in, bij voorkeur op een kopie.

Hoe wissel je tijdens een sessie van modus?

Belangrijkste punt

Blijf in de agent en druk op Shift+Tab (op Windows op Tab); de modi doorlopen deze reeks: Plan, bevestigingen, automatische bewerkingen, Auto, YOLO en terug naar Plan. De huidige modus staat in de statusregel onderaan het scherm. Een handige workflow is om te beginnen in Plan, de taak te bekijken en dan over te schakelen naar Auto-Edit of Auto om de agent aan het werk te zetten.

Je kunt tijdens het werk van modus wisselen, zelfs midden in een taak. Druk op Shift+Tab om naar de volgende modus te gaan. Op Windows doet de gewone Tab-toets hetzelfde. De reeks is: Plan, bevestigingen, automatische bewerkingen, Auto, YOLO en terug naar Plan.

De huidige modus staat altijd in de statusregel onderaan de interface. Maak er een gewoonte van die te controleren voordat je de agent een grote taak geeft. Zo start je niet per ongeluk YOLO wanneer je alleen een plan wilde bekijken.

Een gebruiksvriendelijke workflow voor beginners bestaat uit drie stappen:

  1. Start de agent in Plan-modus en vraag hem de taak te analyseren en een plan voor te stellen. Hij raakt niets aan; hij leest alleen de code en beschrijft wat hij van plan is.
  2. Lees het plan en schakel, als je akkoord bent, met Shift+Tab over naar Auto-Edit of Auto.
  3. Geef aan dat hij verder kan. De agent bewerkt nu zelf bestanden terwijl jij de resultaten in de gaten houdt.

Deze aanpak neemt de grootste angst van beginners weg: dat de agent meteen alles kapotmaakt. Eerst bekijk je het plan in een veilige modus en pas daarna laat je hem verdergaan.

De volledige aanpak voor vibe coding draait om de methode; de tool komt op de tweede plaats. Qwen, Claude of iets anders: je kunt het onderliggende model vervangen. Drie fundamenten helpen je resultaten te behouden wanneer je van model wisselt: een AI-kloon, een Second Brain en contextengineering. Samen zorgen ze voor voorspelbare resultaten; eenmalig geluk heeft daar niets mee te maken.

Een lokaal model zonder betaalkaart

Belangrijkste punt

Ja, je kunt een lokaal model gebruiken. Qwen Code kan werken met een model dat op je eigen computer draait via Ollama of een vergelijkbaar programma. Je verbindt het vanuit het menu als Custom Provider. Je hebt hiervoor de cloud van Alibaba niet nodig. Open modellen kun je gratis downloaden, een betaalkaart is niet nodig en je projectgegevens verlaten je computer niet. Daar staat tegenover dat je een krachtige computer nodig hebt, anders denkt de agent langzaam.

Installeer een open model op je computer via Ollama of vLLM en verbind het daarna vanuit het menu /auth als Custom Provider. Vervolgens gebruikt de agent een model op je eigen computer in plaats van de cloud van Alibaba. Je hebt geen betaalkaart of sleutels nodig en er geldt geen limiet op het aantal verzoeken. Lees deze bespreking van gratis codeermodellen om te zien welke open modellen geschikt zijn voor programmeren.

De keerzijde is de benodigde hardware. Een model dat redelijk goed code schrijft, gebruikt veel videogeheugen. Op een gamingcomputer met een krachtige grafische kaart is dit haalbaar, maar op een gewone laptop past het model mogelijk niet of duurt het zo lang om elk antwoord te bedenken dat je beter een andere optie kunt zoeken.

Een ander voordeel van lokaal draaien is de privacy van je gegevens. Al je code blijft op je computer; er wordt niets naar een server van iemand anders gestuurd. Voor een gevoelig project is dat belangrijker dan besparen op een abonnement.

Hoe voorkom je dat de agent het project kapotmaakt?

Belangrijkste punt

Doe drie dingen. Houd het project onder versiebeheer met git, zodat je elke wijziging van de agent met één opdracht ongedaan kunt maken. Begin taken in Plan-modus en lees het plan voordat je de agent verder laat gaan. Schakel YOLO niet in voor een werkproject; bewaar die modus voor kopieën en kleine experimenten. Zo werkt de zelfstandigheid van de agent in je voordeel.

Een zelfstandige agent is handig zolang hij doet wat je wilt. Volg drie gewoonten om te voorkomen dat een misstap je duur komt te staan.

Gebruik ten eerste git. Als het project onder versiebeheer staat, kun je elke wijziging van de agent bekijken en ongedaan maken. Zonder git is een zelfstandige agent echt riskant: hij verandert iets en je kunt de vorige versie niet herstellen. Met git kun je de wijziging met één korte opdracht terugdraaien.

Begin ten tweede in Plan-modus. Vraag de agent, voordat je hem een grote taak geeft, een plan te maken in een modus waarin hij niets aanraakt. Lees het en begrijp wat hij van plan is, en schakel dan over naar bewerken.

Wees ten derde voorzichtig met YOLO. In deze modus voert de agent zelf opdrachten uit, ook opdrachten die bestanden verwijderen. Dat is te riskant voor een werkproject. Bewaar YOLO voor ruwe kopieën en kleine taken waarbij het niet uitmaakt als er iets misgaat.

Deze drie gewoonten nemen de grootste angst weg: “Ik heb met vibe coding iets gemaakt en het kapotgemaakt.” Lees deze afzonderlijke bespreking voor meer informatie over wijzigingen terugdraaien bij vibe coding. Die gaat over Claude Code, maar het principe van git gebruiken is precies hetzelfde.

Waar begin je met jouw taak?

Belangrijkste punt

Installeer Qwen Code, ga naar je projectmap, voer qwen uit en verbind via /auth een betaald model of een lokaal model via Ollama. Begin vervolgens in Plan-modus, lees het plan, druk op Shift+Tab om over te schakelen naar Auto-Edit en laat de agent aan het werk gaan. Houd het project onder versiebeheer met git. De volledige installatie duurt de eerste keer ongeveer twintig minuten.

Hier is het hele proces in een korte lijst. Volg de stappen van boven naar beneden:

  1. Installeer Qwen Code met één opdracht en start de terminal opnieuw op.
  2. Ga met cd naar de projectmap en voer qwen uit.
  3. Verbind via /auth een model: een betaald abonnement of een lokaal model via Ollama als betalen met een kaart geen optie is.
  4. Geef de agent een taak in Plan-modus en lees zijn plan.
  5. Schakel met Shift+Tab over naar Auto-Edit of Auto en laat hem aan het werk gaan.
  6. Houd het project onder versiebeheer met git, zodat je elke bewerking ongedaan kunt maken.

Kortom, “Qwen schrijft niet zelf code” betekent bijna altijd dat er geen model is verbonden of dat de agent in de bevestigingsmodus staat. Los het eerste op via het menu /auth en het tweede door op Shift+Tab te drukken totdat je Auto-Edit bereikt. Daarna werkt de agent echt zelfstandig in de terminal.

Wil je Qwen vergelijken met andere agents voor jouw taak? Bekijk dan deze bespreking van alternatieven voor Claude Code. Qwen staat daar naast de andere agents, zodat je kunt zien welke geschikt is voor welke taak.

Bronnen

De volledige aanpak voor vibe coding draait om de methode; de specifieke agent komt op de tweede plaats: een AI-kloon, een Second Brain en contextengineering. Je kunt de tool op de achtergrond vervangen; de methode blijft hetzelfde. Praktische bronnen: Ailoot-documentatie.

Meer bronnen en tools: Ailoot.

Meer details

Vragen en antwoorden

Waarom toont Qwen Code voorgestelde wijzigingen en wacht het daarna?

Controleer de actieve modus in de statusregel. Ask Permissions wacht op bevestiging; Plan is voor analyse. Auto-Edit staat bewerkingen toe maar behoudt opdrachtgoedkeuring en modeltoegang moet ook zijn ingesteld.

Bewijst een modus met de naam Default hoe een verse installatie begint?

Nee. De oudere naam Default blijft behouden voor Ask Permissions-compatibiliteit, terwijl het korte documentatieoverzicht Auto als standaard noemt. Bekijk je geïnstalleerde versie en actieve sessiemodus in plaats van het uit de naam af te leiden.

Alle artikelen