Come eseguire Qwen Code nel terminale e configurare la modalità di modifica

La domanda suona così: come si fa a far funzionare Qwen correttamente nella console e a fargli scrivere codice da solo? Di solito, dietro c'è una delusione: qualcuno ha installato Qwen Code, ha fatto una domanda e ha ricevuto in risposta del testo e un pezzo di codice da copiare a mano, anche se gli era stato promesso un agente che sarebbe entrato nel progetto e avrebbe fatto tutto da sé.

È proprio questo Qwen Code: un agente a tutti gli effetti. Può aprire file, modificarli ed eseguire comandi da solo. Il comportamento dipende dalla modalità attiva: Ask Permissions richiede conferme, mentre Auto-Edit e Auto consentono più autonomia. Controlla la barra di stato senza presumere che il nome Default indichi la scelta iniziale. Di seguito, in ordine: installazione, avvio in un progetto, collegamento di un modello dopo le modifiche di aprile e passaggio a una modalità in cui l'agente modifica il codice senza fare domande inutili. Tutto è stato verificato sulla documentazione ufficiale di Qwen al 30 agosto 2026.

Risorse pratiche su modelli e agenti: documentazione Ailoot.

Che cosa significa «Qwen Code scrive codice da solo»?#

La differenza è semplice. Una chat nel browser risponde a una domanda con del testo. Leggi la risposta, copi il codice, lo incolli nel tuo file, lo esegui tu, individui l'errore tu e lo riporti nella chat. Fai da corriere tra la chat e il progetto.

Un agente funziona diversamente. Gli assegni un compito in linguaggio semplice: «aggiungi un modulo di feedback», «correggi questo errore». Poi esamina la struttura del progetto, individua i file pertinenti, li modifica ed esegue un controllo. La documentazione lo dice chiaramente: l'agente crea un piano, scrive codice e verifica che funzioni.

È qui che nasce la confusione nella domanda. «Qwen non scrive codice da solo» quasi sempre significa una di queste due cose: la persona ha aperto una chat nel browser invece dell'agente nel terminale, oppure l'agente è in esecuzione ma impostato su una modalità in cui chiede il permesso per ogni modifica. Il primo problema si risolve installando Qwen Code; il secondo, cambiando modalità. Di seguito spieghiamo entrambe le soluzioni.

Come si installa Qwen Code nel terminale?#

Il modo più rapido è l'installer ufficiale, che seleziona automaticamente la versione adatta al tuo sistema.

Su macOS e Linux, apri il terminale e incolla una riga:

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

Su Windows, fai lo stesso con questo comando PowerShell:

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

La seconda opzione è npm, se è già installato. È necessaria la versione 22 o successiva di Node.js:

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

Dopo l'installazione, riavvia il terminale. L'installer aggiunge il comando qwen ai percorsi di sistema e il terminale non lo riconosce finché non viene riavviato: è il motivo più comune per cui qualcuno dice «l'ho installato, ma non trova il comando». Per verificare che tutto sia stato installato, esegui:

qwen --version

Se vedi un numero di versione, l'agente è installato e pronto per essere avviato nel tuo progetto.

Come si avvia Qwen Code nel proprio progetto?#

Per prima cosa, vai alla cartella che contiene il tuo codice. È importante: l'agente lavora nella cartella da cui è stato avviato e ne vede solo il contenuto.

cd path-to-your-project
qwen

L'interfaccia dell'agente si aprirà direttamente nel terminale. Al primo avvio, ti proporrà di collegare un modello; ne parleremo nella prossima sezione. Una volta collegato il modello, puoi assegnare all'agente un compito in linguaggio semplice per vedere a cosa può accedere:

che cosa fa questo progetto?

L'agente leggerà i file, capirà la struttura e ti darà una risposta utile. Poi puoi chiedergli di scrivere e modificare il codice: «aggiungi un pulsante di disconnessione», «dividi questo file in due», «scopri perché il test non passa». Troverà i punti pertinenti e apporterà le modifiche da solo.

C'è anche un secondo modo per avviarlo: con un solo comando, senza interfaccia. È utile per gli script e le attività automatizzate:

qwen -p "rileggi README e aggiorna l'elenco dei comandi"

Esegue il compito e termina senza avviare una conversazione. Non serve per i primi passi, ma è utile conoscerlo per il futuro.

Perché l'agente è in esecuzione ma non fa nulla da solo?#

Il primo ostacolo è l'accesso al modello. In passato Qwen Code offriva l'accesso gratuito: accedevi con un account qwen.ai e l'agente funzionava senza carta di credito. Quell'accesso si chiamava Qwen OAuth ed è stato interrotto. La documentazione sull'autorizzazione lo dice chiaramente: il livello gratuito Qwen OAuth è stato interrotto il 15 aprile 2026; gli accessi salvati in precedenza potrebbero continuare a funzionare per un breve periodo, ma il server rifiuta le nuove richieste. Anche l'opzione «accedi con qwen.ai» è stata rimossa dal menu.

Quindi, perché l'agente possa iniziare a ragionare su un compito, devi collegare un modello. La prossima sezione illustra le opzioni di collegamento, sia a pagamento sia locali e gratuite.

Il secondo motivo è meno evidente e più frustrante. Il modello è collegato, l'agente risponde, ma non modifica i file: mostra soltanto ciò che intende fare e aspetta. È il comportamento previsto in Ask Permissions, che richiede conferma prima di modifiche e comandi; non dimostra una modalità iniziale universale. Per farlo lavorare da solo, devi cambiare modalità. Ne parleremo tra due sezioni: lì troverai la risposta alla domanda iniziale.

Come si collega un modello ora che l'accesso gratuito è chiuso?#

Nell'agente, digita il comando:

/auth

Si aprirà un menu con tre opzioni principali. Ecco a cosa serve ciascuna.

Alibaba ModelStudio è l'opzione ufficiale dei creatori di Qwen. Offre un Coding Plan a prezzo fisso e con quota settimanale per un singolo sviluppatore, un Token Plan con tariffazione a consumo per i team e la possibilità di collegare una chiave ModelStudio esistente. È un accesso a pagamento al modello «nativo» di Qwen.

I provider di terze parti ti consentono di scegliere un provider integrato e collegarti con una chiave. L'elenco ufficiale include DeepSeek, Grok, MiniMax, Z.AI, Kimi, ModelScope e altri. Ottieni una chiave dal provider, inseriscila e l'agente userà il modello di quel provider.

Custom Provider collega il tuo server, proxy o motore locale. Qui puoi collegare un modello in esecuzione sul tuo computer tramite Ollama. Questa opzione supporta i formati OpenAI, Anthropic e Gemini, quindi funziona con quasi tutti i metodi di accesso.

Puoi anche inserire manualmente la chiave e le impostazioni nel file ~/.qwen/settings.json. Contiene il campo modelProviders (i modelli disponibili), env (le chiavi), security.auth.selectedType (il protocollo da attivare all'avvio) e model.name (il modello predefinito). A quel punto, qwen si avvierà con queste impostazioni senza chiedere nulla. La prima volta è più semplice passare da /auth; puoi tornare al file quando vuoi salvare tutte le impostazioni.

Per scoprire che cosa è rimasto gratuito dopo aprile, leggi l'articolo su Qwen Code gratuito.

Quale modalità attivare perché l'agente modifichi il codice da solo?#

Ecco l'idea fondamentale: la modalità di accesso determina quanto agisce in autonomia l'agente. Le modalità sono cinque, dalla più prudente alla più permissiva.

Se l'agente ti mostra soltanto le modifiche e aspetta, probabilmente è nella modalità Ask Permissions (chiamata Default nelle versioni precedenti). In tal caso, devi confermare a mano ogni modifica e comando, e sembra che l'agente non faccia niente da solo.

Per fargli modificare i file senza chiedere, passa ad Auto-Edit. Le modifiche avverranno automaticamente, ma l'agente continuerà a chiedere prima di eseguire comandi: una protezione sensata per evitare, ad esempio, di eseguire rm nel posto sbagliato.

Auto usa un valutatore interno per le azioni da esaminare. Sceglila deliberatamente dopo aver controllato versione e stato attivo; default conservato nella configurazione Ask Permissions è un nome di compatibilità, non prova della modalità di avvio.

YOLO è la modalità più permissiva. L'agente modifica file ed esegue comandi da solo, senza chiedere nulla. La documentazione afferma che va usata solo per progetti personali di cui ti fidi e per flussi di lavoro automatizzati. In un progetto di lavoro è facile ottenere un risultato indesiderato, quindi attivala solo a mente lucida e, preferibilmente, su una copia.

Come si cambia modalità durante una sessione?#

Puoi cambiare modalità mentre lavori, anche nel mezzo di un compito. Premi Shift+Tab per passare alla modalità successiva. Su Windows, il normale tasto Tab fa la stessa cosa. La sequenza è: Plan, poi conferme, poi modifiche automatiche, poi Auto, poi YOLO e di nuovo Plan.

La modalità corrente è sempre indicata nella riga di stato in fondo all'interfaccia. Abituati a controllarla prima di assegnare all'agente un compito importante, per evitare di avviare YOLO quando volevi solo consultare un piano.

Un flusso di lavoro adatto ai principianti prevede tre passaggi:

1. Avvia l'agente in modalità Plan e chiedigli di analizzare il compito e proporre un piano. Non toccherà nulla: leggerà il codice e descriverà soltanto ciò che intende fare.
2. Leggi il piano e, se sei d'accordo, passa ad Auto-Edit o Auto premendo Shift+Tab.
3. Digli di procedere. Ora l'agente modificherà i file da solo, mentre tu controlli i risultati.

Questo approccio elimina la paura principale di chi è alle prime armi: che l'agente rompa tutto subito. Prima esamini il piano in una modalità sicura, e solo dopo gli consenti di procedere.

L'approccio completo al vibe coding si basa sul metodo; lo strumento è secondario. Qwen, Claude o altro: il modello sottostante si può cambiare. Tre elementi fondamentali aiutano a mantenere risultati costanti quando si cambia modello: un clone AI, un Second Brain e il context engineering. Insieme producono risultati prevedibili; la fortuna di un singolo tentativo non c'entra.

Un modello locale senza carta#

Installa un modello aperto sul tuo computer tramite Ollama o vLLM, poi collegalo come Custom Provider dal menu /auth. A quel punto, l'agente userà un modello sulla tua macchina invece del cloud di Alibaba. Non servono carta né chiavi e non c'è un limite alle richieste. Per scoprire quali modelli aperti sono adatti alla programmazione, leggi questa recensione dei modelli gratuiti per programmare.

Il compromesso riguarda l'hardware. Un modello che scrive codice abbastanza bene richiede molta memoria video. È fattibile su un computer da gaming con una scheda grafica potente, ma su un normale portatile il modello potrebbe non starci, oppure potrebbe impiegare così tanto tempo a elaborare ogni risposta che sarebbe più semplice cercare un'altra opzione.

Un altro vantaggio dell'esecuzione locale è la privacy dei dati. Tutto il codice resta sul tuo computer; non viene inviato al server di nessun altro. Per un progetto sensibile, questo conta più del risparmio su un abbonamento.

Come evitare che l'agente rompa il progetto?#

Un agente autonomo è comodo finché fa ciò che volevi. Per evitare che un passo falso ti costi caro, segui tre abitudini.

Primo, usa git. Se il progetto è sotto controllo di versione, puoi vedere ogni modifica dell'agente e annullarla. Senza git, un agente autonomo è davvero rischioso: modifica qualcosa e non c'è modo di ripristinare la versione precedente. Con git, basta un comando breve per annullare le modifiche.

Secondo, inizia con la modalità Plan. Prima di affidare all'agente un compito importante, chiedigli di preparare un piano in una modalità in cui non toccherà nulla. Leggilo e cerca di capire cosa intende fare l'agente, poi passa alle modifiche.

Terzo, fai attenzione a YOLO. In questa modalità l'agente esegue comandi da solo, compresi quelli che cancellano file. È troppo rischiosa per un progetto di lavoro. Tieni YOLO per le copie di prova e i compiti piccoli, dove un eventuale problema non avrà conseguenze.

Queste tre abitudini affrontano la paura principale: «ho fatto vibe coding e ho rotto tutto». Per saperne di più su come annullare le modifiche nel vibe coding, leggi questa recensione separata. Parla di Claude Code, ma il principio di usare git è esattamente lo stesso.

Da dove iniziare per il tuo compito?#

Ecco il procedimento completo, in breve. Seguilo dall'inizio alla fine:

1. Installa Qwen Code con un solo comando e riavvia il terminale.
2. Vai alla cartella del progetto con cd ed esegui qwen.
3. Collega un modello tramite /auth: un piano a pagamento oppure un modello locale tramite Ollama, se pagare con carta non è un'opzione.
4. Assegna un compito all'agente in modalità Plan e leggi il suo piano.
5. Passa ad Auto-Edit o Auto con Shift+Tab e lascia lavorare l'agente.
6. Tieni il progetto sotto git per poter annullare qualsiasi modifica.

In breve, «Qwen non scrive codice da solo» quasi sempre significa che non è collegato alcun modello oppure che l'agente è in modalità di conferma. Risolvi il primo problema dal menu /auth e il secondo premendo Shift+Tab finché non arrivi ad Auto-Edit. Dopodiché, l'agente lavorerà davvero da solo nel terminale.

Se vuoi confrontare Qwen con altri agenti per il tuo compito, leggi questa recensione delle alternative a Claude Code. Qwen compare insieme agli altri, così puoi capire quale sia più adatto alle diverse esigenze.

L'approccio completo al vibe coding si basa sul metodo, mentre l'agente specifico viene dopo: un clone AI, un Second Brain e il context engineering. Puoi cambiare lo strumento sottostante; il metodo resta lo stesso. Risorse pratiche: documentazione Ailoot.

Altre risorse e strumenti: Ailoot.