Workbranch › Guide
GuidaCome usare Claude Code nell'app desktop di Claude
Per usare Claude Code non serve il terminale. L'app desktop di Claude lo include già, nella scheda Code. Questa guida spiega come avviare una sessione su una cartella, decidere cosa Claude può modificare, rivedere le sue modifiche e far lavorare più sessioni insieme.
In breve: installa l'app desktop di Claude, accedi e fai clic sulla scheda Code in alto nella barra laterale. Sotto la casella del prompt, scegli un ambiente Local (locale), fai clic sul controllo della cartella e scegli Open folder… (apri cartella), poi scrivi il compito e premi Invio. Serve un piano Pro, Max, Team o Enterprise.
Prima di iniziare
La scheda Code usa lo stesso motore di Claude Code della versione da terminale, ma con finestre e pulsanti al posto dei comandi da digitare. Indichi una cartella, assegni un compito e controlli le modifiche sullo schermo. Claude Code è incluso nell'app, quindi non devi installare nient'altro.
- Piano: la scheda Code richiede un abbonamento a pagamento (Pro, Max, Team o Enterprise). Sul piano Free, facendo clic su Code compare un invito a passare a un piano superiore.
- Sistema: macOS (un'unica versione per Intel e Apple Silicon), Windows x64 o ARM64 e Linux in beta (Ubuntu e Debian, tramite apt o un pacchetto .deb).
Se l'app non è ancora installata, la nostra guida per installare l'app desktop di Claude copre ogni sistema.
Avvia la tua prima sessione
- Apri Claude e accedi con il tuo account Anthropic.
- Fai clic su Code in alto nella barra laterale. Se le schede mostrano solo icone, passaci sopra con il mouse per trovarla.
- Guarda la riga di controlli sotto la casella del prompt. Fai clic sul primo, il selettore dell'ambiente, e scegli la prima voce sotto Local.
- Fai clic sul controllo della cartella lì accanto, scegli Open folder… e seleziona la cartella in cui vuoi far lavorare Claude. Per la prima prova è ideale un piccolo progetto che conosci bene.
- Se vuoi, scegli un modello dal selettore dei modelli verso destra nella stessa riga.
- Descrivi il compito con parole semplici, per esempio "Spiega cosa fa questo progetto" o "Crea un CLAUDE.md con le istruzioni per questa cartella", e premi Invio.
Ogni conversazione nella scheda Code è una sessione, con la propria cronologia, la propria cartella e le proprie modifiche. Per fermare Claude, fai clic sul pulsante di stop o premi Esc. Per cambiare direzione senza fermarlo, scrivi una correzione e premi Invio; Claude la legge appena finisce l'azione in corso.
Per indicare a Claude un singolo file, scrivi @ seguito dal nome del file nella casella del prompt. Scrivi / per sfogliare i comandi e le skill integrati.
Scegli quanto Claude può fare da solo
Il selettore della modalità, anch'esso sotto la casella del prompt, stabilisce quando Claude si ferma a chiederti conferma. A ottobre 2026 le opzioni sono:
| Modalità | Cosa succede |
|---|---|
| Manual | Claude chiede prima di ogni modifica e comando; approvi o rifiuti ogni cambiamento. |
| Accept edits | Le modifiche ai file e i comandi semplici sui file passano; gli altri comandi richiedono ancora la tua approvazione. |
| Plan | Claude esplora e propone un piano senza modificare nulla. |
| Auto | Nessuna richiesta di routine; un classificatore in background controlla le azioni e blocca quelle rischiose. |
| Bypass permissions | Nessuna richiesta, a parte i controlli di sicurezza. Anthropic la consiglia solo dentro container isolati o macchine virtuali. |
Una buona abitudine suggerita dalla documentazione di Anthropic: avvia un compito più grande in Plan, leggi il piano, poi passa a Manual o Accept edits per eseguirlo. Puoi cambiare modalità durante la sessione con Cmd+Shift+M su Mac o Ctrl+Shift+M su Windows. L'app ricorda la modalità scelta per ogni cartella, tranne Plan, che vale solo per quella sessione.
Rivedi cosa ha cambiato Claude
- Dopo che Claude ha modificato dei file, compare un contatore come
+12 -1. Fai clic su di esso, oppure su Changes (modifiche) nella barra del titolo, per aprire la vista delle differenze. - Scorri le modifiche file per file. Per commentare una riga, passaci sopra con il mouse, fai clic sul + accanto al numero di riga, scrivi la nota e premi Invio.
- Invia tutti i commenti con Cmd+Enter (Ctrl+Enter su Windows). Claude li legge e corregge.
Per far controllare a Claude il proprio lavoro, scrivi /code-review nella casella del prompt. Nelle sessioni locali il risultato appare come una scheda con i pulsanti Walk through in diff (rivedi nelle differenze) e Apply fixes (applica correzioni).
Più sessioni contemporaneamente
- Nuova sessione: fai clic su + New (nuova) nella barra laterale o premi Cmd+N (Ctrl+N su Windows). Passa da una sessione all'altra con Ctrl+Tab.
- Affiancate: fai Opzione-clic (Alt-clic su Windows) su una sessione, oppure fai clic destro e scegli Open in > Split view (apri in vista divisa).
- Tieni separato il lavoro in parallelo: in un progetto Git, attiva Worktree sotto la casella del prompt prima di iniziare, e ogni sessione avrà la propria copia isolata del progetto.
- Domanda veloce: premi Cmd+; (Ctrl+; su Windows) per una chat laterale che vede la sessione ma non vi aggiunge nulla. Le chat laterali non vengono conservate dopo la chiusura dell'app.
- Fai ordine: passa il mouse su una sessione finita, apri il suo menu e scegli Archive (archivia).
Buono a sapersi
- Altri ambienti: il selettore dell'ambiente offre anche Cloud (gira sui server di Anthropic e continua dopo che chiudi l'app), SSH (una macchina remota) e, su Windows, WSL.
- Utilizzo: su Pro e Max, Claude Code e le normali chat di Claude attingono agli stessi limiti di utilizzo, e anche le sessioni nel cloud contano.
- Il terminale c'è, se lo vuoi: premi Ctrl+` per aprirne uno dentro la sessione, ma non è mai obbligatorio.
- Extra: il pulsante + accanto alla casella del prompt aggiunge connettori e plugin; li gestisci in Customize (personalizza) nella barra laterale.
- Stesse impostazioni ovunque: il CLAUDE.md di una cartella, le impostazioni e i server MCP valgono nell'app desktop, nel terminale e sul web.
Se qualcosa non funziona
- Facendo clic su Code compare l'invito a passare a un piano superiore: il tuo account è sul piano Free. Claude Code richiede un piano a pagamento.
- Ti chiede di accedere online: completa l'accesso nel browser, poi riavvia l'app.
- Un errore 403 o di autenticazione: esci e accedi di nuovo; la documentazione desktop di Anthropic ha una sezione di risoluzione dei problemi per questo errore.
- Nessun controllo dell'ambiente sotto la casella del prompt: hai una versione meno recente dell'interfaccia. Aggiorna l'app; la documentazione di Anthropic spiega come verificare quale interfaccia hai.
- Local è disattivato (grigio): con un account di lavoro, la tua organizzazione potrebbe aver disattivato le sessioni locali. Chiedi al tuo amministratore.
Tieni traccia di cosa ha deciso ogni sessione
Con più sessioni attive è facile perdere decisioni e punti aperti. Il plugin Workbranch per Claude Code mostra cosa è ancora aperto quando una sessione parte in una cartella collegata a un progetto Workbranch, e con "save this to Workbranch" (salva in Workbranch) archivia per argomento le attività e le decisioni della sessione. Vedi Workbranch per Claude.
Fonti
- Use Claude Code with your Pro or Max plan (Claude Help Center, verificato il 2026-10-30)
- Get started with the desktop app (Claude Code Docs, verificato il 2026-10-30)
- Use Claude Code Desktop (Claude Code Docs, verificato il 2026-10-30)
- Claude Code overview (Claude Code Docs, verificato il 2026-10-30)
Domande frequenti
Devo prima installare Node.js o la CLI di Claude Code?
No. L'app desktop include Claude Code, quindi la scheda Code funziona da sola. Installa la CLI solo se vuoi anche eseguire claude in un terminale.
Posso spostare una sessione del terminale nell'app desktop?
Sì. Esegui /desktop in una sessione del terminale per continuarla nell'app, dove le differenze sono più facili da rivedere. Secondo Anthropic serve un abbonamento claude.ai e funziona su macOS e Windows x64.
Una sessione può continuare se chiudo l'app?
Le sessioni locali richiedono l'app aperta. Scegli invece un ambiente Cloud e la sessione gira sull'infrastruttura di Anthropic, continuando anche dopo che hai chiuso l'app; le sessioni nel cloud contano nei limiti del tuo piano.