Usa Claude Code in VS Code

• Rivedere e modificare i piani di Claude prima di accettarli
• Accettare automaticamente le modifiche mentre vengono apportate
• Fare @-mention di file con intervalli di righe specifici dalla tua selezione
• Accedere alla cronologia delle conversazioni
• Aprire più conversazioni in schede o finestre separate

​

Prerequisiti

• VS Code 1.94.0 o superiore
• Un account Anthropic: qualsiasi abbonamento Claude a pagamento (Pro, Max, Team o Enterprise) o un account Claude Console funziona, e non è richiesta alcuna chiave API. Accederai con questo account quando aprirai l’estensione per la prima volta. Se accedi a Claude tramite un provider di terze parti come Amazon Bedrock o Google Cloud’s Agent Platform, consulta Usa provider di terze parti per le istruzioni di configurazione.

​

Installa l’estensione

• Installa per VS Code
• Installa per Cursor

• Altri fork di VS Code: l’estensione si installa anche in fork come Devin Desktop o Kiro. Cerca “Claude Code” nella vista Estensioni dell’editor, oppure installala dal registro Open VSX.
• Editor che non possono installare l’estensione: installa la CLI ed esegui invece claude nel terminale integrato dell’editor. La CLI funziona in qualsiasi terminale.
• Dev container: per eseguire Claude Code all’interno di un dev container, consulta Container di sviluppo.

​

Inizia

1

Apri il pannello di Claude Code

In tutto VS Code, l’icona Spark indica Claude Code: Il modo più rapido per aprire Claude è fare clic sull’icona Spark nella Editor Toolbar (angolo in alto a destra dell’editor). L’icona appare solo quando hai un file aperto.Altri modi per aprire Claude Code:

• Activity Bar: fai clic sull’icona Spark nella barra laterale sinistra per aprire l’elenco delle sessioni. Fai clic su una sessione qualsiasi per aprirla nella tua posizione preferita, oppure avviane una nuova. Questa icona è sempre visibile nella Activity Bar.
• Command Palette: Cmd+Shift+P (Mac) o Ctrl+Shift+P (Windows/Linux), digita “Claude Code” e seleziona un’opzione come “Open in New Tab”
• Status Bar: fai clic su ✻ Claude Code nell’angolo in basso a destra della finestra. Funziona anche quando non è aperto alcun file.

Puoi trascinare il pannello di Claude per riposizionarlo ovunque in VS Code. Consulta Personalizza il tuo workflow per i dettagli.

2

Accedi

La prima volta che apri il pannello, appare una schermata di accesso. Fai clic su Sign in e completa l’autorizzazione nel browser.Se in seguito vedi Not logged in · Please run /login, l’estensione riapre automaticamente la schermata di accesso. Se non appare, ricarica la finestra dalla Command Palette con Developer: Reload Window.Se hai ANTHROPIC_API_KEY impostata nella tua shell ma vedi comunque la richiesta di accesso, è possibile che VS Code non abbia ereditato l’ambiente della tua shell. Avvia VS Code da un terminale con code . in modo che erediti le tue variabili d’ambiente, oppure accedi con il tuo account Claude.Dopo l’accesso, appare una checklist Learn Claude Code. Completa ogni elemento facendo clic su Show me, oppure chiudila con la X. Per riaprirla in seguito, deseleziona Hide Onboarding nelle impostazioni di VS Code in Extensions > Claude Code.

3

Invia un prompt

Chiedi a Claude di aiutarti con il tuo codice o i tuoi file, che si tratti di spiegare come funziona qualcosa, eseguire il debug di un problema o apportare modifiche.

Claude vede automaticamente il testo selezionato. Premi Option+K (Mac) / Alt+K (Windows/Linux) per inserire anche un riferimento @-mention (come @file.ts#5-10) nel tuo prompt.

Ecco un esempio di domanda su una riga specifica di un file:

4

Rivedi le modifiche

Controlla la modalità di permesso mostrata in fondo alla casella del prompt:

• In modalità Auto o Edit automatically, Claude modifica la maggior parte dei file nel tuo workspace senza chiedere.
• In modalità Manual, quando Claude vuole modificare un file, mostra un confronto affiancato tra l’originale e le modifiche proposte, quindi chiede il permesso. Puoi accettare, rifiutare o dire a Claude cosa fare invece. Se modifichi direttamente il contenuto proposto nella vista diff prima di accettare, Claude viene informato che l’hai modificato, così non presume che il file corrisponda alla sua proposta originale.

Per rivedere una modifica proposta una variazione alla volta, usa i pulsanti Accept this change e Reject this change sotto ciascuna variazione nel diff. Rifiutare una variazione la annulla nel contenuto proposto; accettarla la contrassegna come revisionata. La revisione per singola variazione richiede Claude Code v2.1.275 o successivo.Accettare o rifiutare l’intero file conclude comunque la revisione. Un diff con più di 100 variazioni si apre senza i pulsanti per singola variazione, quindi rivedilo come file intero.Le stesse azioni sono disponibili in corrispondenza del cursore dal menu contestuale dell’editor e dalla Command Palette come Claude Code: Accept Change at Cursor e Claude Code: Reject Change at Cursor.

​

Usa la casella del prompt

• Modalità di permesso: fai clic sull’indicatore della modalità in fondo alla casella del prompt per cambiare modalità di permesso. Con Claude Code v2.1.283 o versioni successive, Auto è la modalità di permesso iniziale predefinita, mentre nelle versioni precedenti lo è solo sui piani Pro, Max e Team. Consulta come l’estensione sceglie la modalità di permesso iniziale per sapere cosa la modifica e per conoscere tutte le modalità di permesso offerte dall’indicatore.
  • Auto: un classificatore esamina la maggior parte delle azioni invece di chiedertelo. Consulta modalità auto per sapere cosa esamina e blocca.
  • Manual: Claude chiede il permesso prima di modificare i file e di eseguire la maggior parte dei comandi della shell.
  • Plan: Claude descrive cosa farà e attende l’approvazione prima di apportare modifiche. VS Code apre automaticamente il piano come documento Markdown completo in cui puoi aggiungere commenti inline per dare feedback prima che Claude inizi. Puoi anche digitare /plan nella casella del prompt. Richiede Claude Code v2.1.280 o versioni successive.
    • /plan: passa al plan mode. Se sei già in plan mode, mostra invece il piano corrente.
    • /plan con un’attività, come /plan fix the auth bug: passa al plan mode e inizia a pianificare quell’attività.
    • /plan open: quando sei già in plan mode, apre il file del piano nell’editor.
  • Edit automatically: Claude apporta modifiche senza chiedere.
• Modello: seleziona Switch model… dal menu dei comandi per cambiare modello durante la sessione. Puoi anche fare clic sul nome del modello in fondo alla casella del prompt per aprire lo stesso selettore. Con Claude Code v2.1.284 o versioni successive, anche digitare /model da solo nella casella del prompt apre il selettore. Quando il modello corrente supporta i livelli di sforzo, il selettore mostra anche una riga Effort e il pulsante con il nome del modello mostra il livello selezionato. Quando scegli un livello diverso da max, Claude Code lo salva come predefinito per il modello corrente, in modelSettings nelle tue impostazioni utente; max si applica solo alla sessione corrente. Il pulsante con il nome del modello e la riga Effort richiedono Claude Code v2.1.257 o versioni successive. Quando i workflow dinamici sono abilitati e il modello corrente li supporta, sotto la riga Effort compare un interruttore Ultracode. Attivalo per fare in modo che Claude pianifichi un workflow per ogni attività sostanziale in questa sessione, al livello di sforzo selezionato. Mentre è attivo, il pulsante con il nome del modello mostra · Ultracode dopo il livello. L’interruttore richiede Claude Code v2.1.284 o versioni successive.
• Menu dei comandi: fai clic su / o digita / per aprire il menu dei comandi. Le opzioni includono l’allegare file, il cambio di modello e l’attivazione o disattivazione del ragionamento esteso. La sezione Customize include voci come server MCP, comandi, stili di output, hook, memoria, istruzioni, permessi e plugin. Gli elementi con un’icona del terminale si aprono nel terminale integrato.
  • Per sfogliare comandi come /usage o /remote-control, seleziona Slash commands nella sezione Customize. Una finestra di dialogo li elenca con una casella di filtro. Scegline uno per eseguirlo. Digitare / nella casella del prompt continua a suggerire i comandi inline. Richiede Claude Code v2.1.257 o versioni successive. Anche digitare /skills apre questa finestra di dialogo. Ogni riga di una skill mostra la sua visibilità, come On o Name only. Fai clic sulla visibilità per modificarla, tranne che nelle righe contrassegnate come locked, come le skill dei plugin. La scorciatoia /skills e i controlli della visibilità richiedono Claude Code v2.1.280 o versioni successive.
  • Seleziona Output styles nella sezione Customize per scegliere uno stile di output, compresi i tuoi stili personalizzati. Richiede Claude Code v2.1.257 o versioni successive. Per creare invece uno stile personalizzato, seleziona Build a custom style dal menu Output styles. Claude Code scrive per te il file dello stile a livello di progetto o di utente. Richiede Claude Code v2.1.261 o versioni successive.
  • Seleziona Hooks nella sezione Customize per visualizzare gli hook caricati nella sessione, raggruppati per evento. Puoi aggiungere, modificare o rimuovere gli hook salvati nei tuoi file di impostazioni utente, di progetto e locali. Gli hook provenienti da altre fonti, come le impostazioni gestite o i plugin, sono di sola lettura. Richiede Claude Code v2.1.269 o versioni successive.
  • Seleziona Permissions nella sezione Customize per visualizzare le regole di permesso della sessione, raggruppate in Allow, Ask e Deny. Puoi aggiungere regole alle tue impostazioni utente, di progetto o locali e rimuovere le regole salvate lì. Le regole provenienti da altre fonti, come le impostazioni gestite o le approvazioni concesse solo per questa sessione, sono di sola lettura. Richiede Claude Code v2.1.269 o versioni successive.
  • Seleziona Memory nella sezione Customize per attivare o disattivare la memoria automatica. Mentre è attiva, puoi anche sfogliare le memorie salvate da Claude e mostrare nel tuo file manager le cartelle che le contengono. Richiede Claude Code v2.1.274 o versioni successive. Fai clic su una memoria salvata per leggerla nella finestra di dialogo, dove puoi modificarne il testo, eliminarla o aprirne il file nell’editor. Visualizzare, modificare ed eliminare una memoria nella finestra di dialogo richiede Claude Code v2.1.275 o versioni successive.
  • Seleziona Instructions nella sezione Customize per modificare i file CLAUDE.md che Claude legge. Scegli un file per aprirlo nell’editor. Se il file non esiste ancora, Claude Code lo crea prima. Richiede Claude Code v2.1.274 o versioni successive.
  • Seleziona Status nella sezione Customize, oppure digita /status, per controllare la versione di Claude Code, l’account, il modello e i dettagli dei server MCP della sessione. Richiede Claude Code v2.1.280 o versioni successive.
  • Seleziona Sandbox nella sezione Customize, oppure digita /sandbox, per vedere se i comandi Bash di Claude vengono eseguiti in sandbox. Lì puoi cambiare la modalità della sandbox e aggiungere comandi esclusi. Richiede Claude Code v2.1.280 o versioni successive.
  • Seleziona Claude in Chrome nella sezione Customize, oppure digita /chrome, per controllare e gestire la connessione a Claude in Chrome. Entrambi richiedono l’accesso con un account claude.ai. Richiede Claude Code v2.1.280 o versioni successive.
  • Seleziona Export conversation nella sezione Context, oppure digita /export, per copiare la conversazione come testo semplice o salvarla in un file. Aggiungi un nome di file, come /export notes.txt, per saltare la finestra di dialogo e scegliere dove salvare il file. Richiede Claude Code v2.1.280 o versioni successive.
  • La sezione Settings include Enable Remote Control for all sessions, che imposta remoteControlAtStartup per controllare se le nuove sessioni interattive si connettono automaticamente a Remote Control. Richiede Claude Code v2.1.203 o versioni successive. Quando attivi o disattivi l’interruttore in una finestra di VS Code, la modifica non è limitata alle sessioni che avvii successivamente. Si applica anche alle sessioni già aperte in quella finestra di VS Code. Se lo disattivi, le sessioni aperte si disconnettono. Con Claude Code v2.1.261 o versioni successive, la modifica raggiunge anche le sessioni aperte nelle altre finestre di VS Code.
  • La sezione Settings include anche Focus view, che nasconde le chiamate agli strumenti, i risultati degli strumenti e il ragionamento dietro righe espandibili, lasciando visibili i tuoi prompt e le risposte di Claude. Attivala o disattivala lì, con Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux), oppure dal Command Palette con Claude Code: Toggle Focus view. La modifica si applica a tutte le sessioni aperte e persiste tra le sessioni. Richiede Claude Code v2.1.221 o versioni successive. L’ultima lista di cose da fare di Claude rimane visibile, così come il testo a cui si riferisce una domanda in sospeso di Claude; questo richiede Claude Code v2.1.225 o versioni successive. Mentre Claude esegue dei subagent, righe di avanzamento in tempo reale con la loro attività più recente compaiono sotto il gruppo di chiamate agli strumenti che li ha avviati. Questo richiede Claude Code v2.1.269 o versioni successive.
  • Per uscire dal tuo account Anthropic, seleziona Sign out nella sezione Settings, oppure digita /logout. Con un provider di terze parti, il menu non offre nessuna delle due opzioni. Richiede Claude Code v2.1.277 o versioni successive.
  • Per segnalare un bug, fai clic su Report a problem in fondo al menu, oppure digita /bug o /feedback con una descrizione facoltativa che precompila la segnalazione. Quando invii la segnalazione e hai effettuato l’accesso ad Anthropic su una connessione diretta, Claude Code la invia ad Anthropic. Richiede Claude Code v2.1.229 o versioni successive. Con un provider di terze parti, o senza credenziali Anthropic, non viene inviato nulla. La finestra di dialogo lo indica prima che tu scriva. L’invio salva la segnalazione come archivio locale in ~/.claude/feedback-bundles/ con i pattern noti di chiavi API e token oscurati. Il salvataggio della segnalazione sul tuo computer richiede Claude Code v2.1.284 o versioni successive. Dopo il salvataggio della segnalazione, la conferma indica il nome del file e include un pulsante Show folder. Invia quel file al tuo referente commerciale Anthropic o allegalo a una richiesta di assistenza. Se la policy della tua organizzazione disattiva il feedback sul prodotto, Report a problem non compare nel menu, e /bug e /feedback mostrano l’avviso Feedback is turned off by your organization's policy or this environment's settings. invece di aprire la segnalazione. Con Claude Code v2.1.284 o versioni successive, se imposti la variabile d’ambiente DISABLE_FEEDBACK_COMMAND o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, anche il feedback viene disattivato e l’apertura della segnalazione mostra invece quell’avviso.
• Domande a margine: digita /btw seguito da una domanda per chiedere informazioni sulla tua sessione senza aggiungerla alla conversazione. La risposta si apre in un pannello accanto alla chat, dove puoi porre domande di approfondimento. Richiede Claude Code v2.1.227 o versioni successive. Il thread sopravvive al ricaricamento della finestra. Claude Code conserva i 20 scambi più recenti e fa scadere i thread memorizzati secondo la pianificazione di cleanupPeriodDays, purché Claude Code possa determinare in modo sicuro il periodo di conservazione. Per cancellare un thread, fai clic sull’icona del cestino nel pannello.
• Copiare una risposta: passa il mouse su una risposta e fai clic su Copy response per copiarla negli appunti, oppure digita /copy per copiare l’ultima risposta. /copy 2 copia la penultima. Richiede Claude Code v2.1.277 o versioni successive.
• Segnalibri: passa il mouse su una risposta e fai clic su Bookmark response per salvarla, oppure fai clic su Remove bookmark su una risposta salvata per rimuoverla. Per rivedere le risposte salvate, apri il pannello Bookmarks. Puoi fare clic sull’icona del segnalibro nella parte superiore del pannello di Claude Code, selezionare Bookmarks nella sezione Context del menu dei comandi oppure digitare /bookmarks. Richiede Claude Code v2.1.286 o versioni successive.
• File che Claude ti invia: quando la sessione è connessa a Remote Control e Claude ti invia file con lo strumento SendUserFile, la conversazione mostra una riga come Sent report.md, chart.png. Fai clic sul nome di un file per aprirlo nell’editor.
• Indicatore del contesto: la casella del prompt mostra quanta parte della finestra di contesto di Claude stai utilizzando. Claude esegue automaticamente la compattazione quando necessario, oppure puoi eseguire /compact manualmente.
• Orologio della cache del prompt: un’icona a forma di orologio accanto all’indicatore del contesto stima quanto tempo manca alla scadenza della cache del prompt della conversazione. Effettua un conto alla rovescia a partire dalla durata di cinque minuti o di un’ora della cache, e ogni risposta che utilizza la cache fa ripartire il conto alla rovescia. A parte la compattazione, le azioni che invalidano la cache non azzerano l’orologio, quindi può ancora mostrare minuti rimanenti dopo che hai cambiato modello.
  • Finché il conto alla rovescia non si esaurisce, l’icona mostra i minuti rimanenti, come 12m.
  • Quando il conto alla rovescia si esaurisce, i minuti scompaiono e l’icona diventa rossa, o del colore di errore del tuo tema, fino alla risposta successiva. Probabilmente la cache è scaduta, quindi aspettati una risposta più lenta e più costosa al tuo prossimo messaggio mentre la cache viene ricostruita. Se la durata di cinque minuti continua a esaurirsi tra un messaggio e l’altro, consulta Scegliere il TTL autonomamente.
  • Subito dopo la compattazione della conversazione, anche l’icona diventa rossa senza minuti fino alla risposta successiva, perché la cache non copre ancora la conversazione compattata.
• Mappa degli agenti: quando la conversazione include dei subagent, in fondo alla casella del prompt compare un conteggio degli agenti, come 2 agents. Il relativo punto indica se qualche subagent è al lavoro o è in attesa del tuo permesso. Fai clic sul conteggio degli agenti per aprire la mappa degli agenti, che disegna i subagent della conversazione come un albero sotto l’agente principale, ciascuno con il proprio stato, il tempo trascorso e il conteggio dei token. Fai clic su un subagent per vederne il prompt e le chiamate agli strumenti, aprirne la trascrizione di sola lettura o interromperlo mentre è in esecuzione. Richiede Claude Code v2.1.269 o versioni successive. La mappa elenca anche le altre attività in background della sessione, come i comandi della shell in background e i monitor, sotto gli agenti. Fai clic su una riga per aprire la scheda dell’attività e interromperla da lì. Per aprire la mappa quando non viene mostrato alcun conteggio degli agenti, ad esempio quando Claude ha avviato una shell in background ma nessun subagent, digita /tasks nella casella del prompt. Le attività in background nella mappa e il comando /tasks digitato richiedono Claude Code v2.1.277 o versioni successive. Con Claude Code v2.1.286 o versioni successive, quando fai clic su Stop o premi Esc, il turno corrente termina. Gli agenti in background continuano a essere eseguiti finché non terminano o finché non li interrompi dalla mappa.
• Ragionamento esteso: consente a Claude di dedicare più tempo a ragionare su problemi complessi. Attivalo tramite il menu dei comandi (/). Il ragionamento di Claude compare nella conversazione come blocchi compressi: fai clic su un blocco per leggerlo, oppure premi Ctrl+O per espandere o comprimere tutti i blocchi di ragionamento della sessione. Consulta Ragionamento esteso per i dettagli.
• Input su più righe: premi Shift+Enter per aggiungere una nuova riga senza inviare. Funziona anche nel campo di testo libero “Other” delle finestre di dialogo con domande.

​

Fare riferimento a file e cartelle

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

• Quando il file si trova nel tuo workspace e corrisponde alle impostazioni files.exclude o search.exclude, Claude riceve al massimo il percorso del file e non il testo che hai selezionato.
• Lo stesso vale per un file ignorato da git, purché l’impostazione search.useIgnoreFiles di VS Code e l’impostazione respectGitIgnore dell’estensione siano entrambe attive, come avviene per impostazione predefinita.

• Per allegare un’immagine, incollala dagli appunti nella casella del prompt.
• Per allegare file, tieni premuto Shift mentre li trascini nella casella del prompt.
• Per rimuovere un allegato dal contesto, fai clic sulla X presente su di esso.

​

Includere l’output del terminale nei prompt

​

Incollare testo

• Se quando incolli compare un avviso come Removed 3 invisible characters from the pasted text, il testo è stato inserito senza quei caratteri.
• Se al momento dell’invio compare un avviso sui caratteri rimossi, non è stato inviato nulla. Il testo ripulito è di nuovo nella casella del prompt. Invia di nuovo per inviare il testo così come viene mostrato.

​

Formule matematiche LaTeX nelle risposte

• Formule in display: un blocco $$ … $$ o \[ … \] su una o più righe a sé stanti, e un blocco di codice delimitato con math come linguaggio
• Formule inline: $…$ o \(…\) che si apre e si chiude sulla stessa riga, come $E = mc^2$ o \(a^2 + b^2 = c^2\)

​

Riprendere conversazioni passate

• Titoli delle sessioni: le nuove sessioni ricevono titoli generati dall’AI in base al tuo primo messaggio.
• Rinomina e archivia: passa il mouse su una sessione per mostrare queste azioni. Rinominala per darle un titolo descrittivo, oppure archiviala per spostarla nel gruppo Archived sessions in fondo all’elenco.

This conversation is still open somewhere else. Using it in two places at once can mix up its messages.

• Una sessione: espandi Archived sessions e fai clic su Unarchive session.
• Tutte le sessioni archiviate in una volta: passa il mouse sull’intestazione Archived sessions nell’elenco delle sessioni nella Activity Bar e fai clic sulla relativa icona di ripristino dall’archivio. Richiede Claude Code v2.1.277 o versioni successive.

• L’estensione sceglie la modalità di permesso iniziale da claudeCode.initialPermissionMode o da una scelta che viene mantenuta da una conversazione precedente
• Hai configurato claudeCode.claudeProcessWrapper
• Una regola di negazione rimuove lo strumento ExitPlanMode

​

Riprendere le sessioni cloud da claude.ai

​

Controllare account e utilizzo

• Piano claude.ai: barre di utilizzo per i limiti del tuo piano, come la sessione corrente e la settimana. Ogni barra mostra quanto manca al ripristino del relativo limite. La finestra di dialogo mostra anche una ripartizione di ciò che contribuisce ai limiti del tuo piano. Segnala i comportamenti che rappresentano il 10% o più dell’utilizzo recente, come i cache miss, il contesto lungo e le sessioni con uso intensivo di subagent o altamente parallele. Ogni comportamento segnalato è accompagnato da un suggerimento per ridurlo. Le tabelle di attribuzione mostrano quanta parte dell’utilizzo proviene da ciascuna skill, subagent, plugin e server MCP. Usa l’interruttore Day e Week per passare dalle ultime 24 ore agli ultimi 7 giorni. I dati sono approssimativi e calcolati dalle sessioni locali su questa macchina, quindi l’utilizzo da altri dispositivi o da claude.ai non è incluso.
• Altri metodi di accesso: quando i limiti del piano non si applicano al tuo metodo di accesso, ad esempio con un provider di terze parti o con una chiave API, la sezione Usage mostra invece il costo e l’utilizzo dei token della sessione stessa. Il comando /usage della CLI mostra gli stessi totali nel suo blocco Session. Anche l’elenco delle sessioni nella Activity Bar mostra i totali della sessione attiva sotto l’intestazione Account & usage. Richiede Claude Code v2.1.277 o versioni successive.

​

Tornare indietro con i checkpoint

• Fork conversation from here: avvia un nuovo branch della conversazione a partire da questo messaggio mantenendo intatte tutte le modifiche al codice
• Rewind code to here: ripristina le modifiche ai file a questo punto della conversazione mantenendo l’intera cronologia della conversazione
• Fork conversation and rewind code: avvia un nuovo branch della conversazione e ripristina le modifiche ai file a questo punto

​

Personalizza il tuo workflow

​

Scegli dove posizionare Claude

• Barra laterale secondaria: il lato destro della finestra. Mantiene Claude visibile mentre scrivi codice.
• Barra laterale primaria: la barra laterale sinistra con le icone per Explorer, Search, ecc.
• Area dell’editor: apre Claude come scheda accanto ai tuoi file. Utile per le attività secondarie.

​

Continua le conversazioni dopo un ricaricamento

• Scheda dell’editor: la conversazione torna insieme alla sua scheda.
• Barra laterale: la conversazione torna se negli ultimi 10 minuti hai inviato un messaggio o Claude ha risposto al suo interno. Se non torna, riprendi la conversazione dalla cronologia delle sessioni.

​

Passaggi interrotti dopo un ricaricamento

​

Disattiva la continuazione dopo un ricaricamento

​

A conversation was not reopened

“Fix the login bug” was not reopened. It did not finish opening the last 2 times, and opening it again may stop Claude Code from responding here.

• Per aprirla comunque: fai clic su Open it anyway oppure scegli la conversazione dalla cronologia delle sessioni. Una volta completata l’apertura della conversazione, torna come di consueto dopo i ricaricamenti successivi.
• Se il pannello smette di rispondere durante il caricamento della conversazione: ricarica la finestra. Si apre una nuova chat.
• Per lasciarla chiusa: continua a lavorare nella nuova chat. L’avviso scompare non appena invii un prompt.

​

Esegui più conversazioni

​

Organizza le sessioni in gruppi

• Raggruppa o separa una sessione: fai clic con il pulsante destro su una sessione per creare un gruppo a partire da essa, spostarla in un gruppo esistente o rimuoverla dal suo gruppo. Ogni sessione appartiene a un solo gruppo alla volta, quindi spostarla in un altro gruppo la rimuove dal primo.
• Sposta più sessioni contemporaneamente: fai Cmd-clic (Mac) / Ctrl-clic (Windows/Linux) su ciascuna sessione, oppure Shift-clic per selezionare un intervallo, quindi fai clic con il pulsante destro sulla selezione.
• Raggruppa una sessione dalla sua scheda: esegui Claude Code: Add Session Tab to Group dalla Command Palette, quindi scegli o crea un gruppo. Richiede Claude Code v2.1.257 o versioni successive.
• Rinomina o elimina un gruppo: fai clic con il pulsante destro sull’intestazione di un gruppo. L’eliminazione di un gruppo rimuove solo il gruppo, e le sue sessioni tornano nell’elenco non raggruppato.

​

Filtra l’elenco delle sessioni

• Active: attiva questo interruttore per mostrare solo le sessioni che richiedono il tuo input, sono in esecuzione o non sono state lette, più la sessione nella scheda di Claude su cui hai messo il focus per ultima.
• Filtra per stato: fai clic sull’icona a forma di imbuto, quindi seleziona Needs input, Working o Completed per mostrare le sessioni in uno qualsiasi di quegli stati. Seleziona Open o Closed per restringere l’elenco in base al fatto che una sessione sia aperta. Una sessione è considerata aperta quando ha una scheda in questa finestra o è in esecuzione in un altro processo di Claude Code su questa macchina, ad esempio in un terminale.

​

Passa alla modalità terminale

​

Gestire i plugin

​

Installare i plugin

• I plugin installati compaiono in alto con interruttori per attivarli o disattivarli.
  • Se disattivi un plugin che il file condiviso .claude/settings.json del tuo progetto attiva, l’estensione te lo chiede prima: Disable for me lo disattiva solo per te, mentre Disable for everyone modifica il file condiviso.
  • Un plugin che non è stato caricato mostra un breve motivo sulla sua riga. Fai clic sul motivo per vedere cosa puoi fare, inclusa la copia del messaggio di errore completo da cercare in Risoluzione dei problemi dei plugin.
• I plugin disponibili dai marketplace che hai configurato compaiono sotto
• Cerca per filtrare i plugin per nome o descrizione
• Fai clic su Install su qualsiasi plugin disponibile

• Install for you: disponibile in tutti i tuoi progetti (ambito utente)
• Install for this project: condiviso con i collaboratori del progetto (ambito di progetto)
• Install locally: solo per te, solo in questo repository (ambito locale)

​

Disinstallare i plugin

• Un plugin che il file condiviso .claude/settings.json del tuo progetto attiva: scegli Disable for me, che mantiene il plugin installato per i tuoi collaboratori, oppure Uninstall for everyone, che rimuove l’installazione del progetto con --keep-data, in modo che la directory dei dati salvati del plugin resti. Se hai già disattivato il plugin per te, l’icona del cestino rimuove la tua installazione senza fare domande.
• Altrimenti, l’ultima installazione di un plugin con dati salvati: scegli se mantenere o eliminare i dati; Keep è l’opzione predefinita

​

Condividere un link di installazione di un plugin

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

• Nome del plugin: al massimo 100 caratteri, deve iniziare con una lettera o una cifra ASCII e per il resto usare solo lettere ASCII, cifre, ., _ e -.
• Sorgente del marketplace: solo le forme elencate dal parametro marketplace, quindi non un percorso locale, un indirizzo http:// o il nome del marketplace, come claude-plugins-official. Un URL https:// non può contenere un nome utente, una password o una query string.
• Ref Git: per fissare il marketplace a un branch o a un tag, aggiungi il ref alla sorgente dopo %23, la forma codificata di #, come in marketplace=owner/repo%23v1.0. Un link con un # non codificato non funziona. I marketplace nell’organizzazione GitHub anthropics non possono essere fissati in un link.

• Il marketplace non elenca alcun plugin con quel nome: la finestra di dialogo segnala che il plugin non è stato trovato. Verifica il valore di plugin rispetto all’elenco del marketplace.
• Il plugin è già installato: la finestra di dialogo lo segnala e non cambia nulla.
• È già stato aggiunto un marketplace diverso con lo stesso nome: la finestra di dialogo indica che il marketplace del link non è stato aggiunto e non viene installato nulla.

​

Gestire i marketplace

• Inserisci un repository GitHub, un URL o un percorso locale per aggiungere un nuovo marketplace
• Fai clic sull’icona di aggiornamento per aggiornare l’elenco dei plugin di un marketplace
• Fai clic sull’icona del cestino per rimuovere un marketplace. La rimozione disinstalla ogni plugin che hai installato da esso, quindi una conferma elenca prima quei plugin

​

Plugin che disegnano nel pannello

• Un riquadro accanto alla conversazione o sopra la casella del prompt
• Una notifica toast o una riga di stato sopra la casella del prompt
• Un messaggio o una chiamata a uno strumento disegnati nel modo proprio del plugin

• From the token-chart plugin: il plugin ha disegnato o stampato questo elemento, oppure questa scheda è il plugin che ti chiede qualcosa
• Edited by the token-chart plugin: il plugin ha modificato qualcosa che Claude Code disegna, come una chiamata a uno strumento
• Prompt from the token-chart plugin: il plugin ha inviato questo messaggio per tuo conto

​

Automatizza le attività del browser con Chrome

@browser go to localhost:3000 and check the console for errors

• Abilitare Chrome per impostazione predefinita: fai in modo che ogni sessione si colleghi al tuo browser all’avvio, senza digitare @browser
• Richieste di permesso nelle sessioni di VS Code: quando Claude Code ti chiede conferma prima di un’azione nel browser
• Usare Claude Code con Chrome: istruzioni di configurazione, l’elenco completo delle funzionalità e risoluzione dei problemi

​

Lavorare con git

​

Creare commit e pull request

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

​

Eseguire attività in background

​

Spostare in background un comando o un subagent in esecuzione

• Tempistica: l’azione compare dopo che un comando è in esecuzione da circa due secondi, oppure non appena Claude inizia ad attendere un subagent che ha avviato dalla conversazione principale.
• Dopo il clic: Claude smette di attendere e prosegue il turno. Il comando o il subagent continua a essere eseguito come attività in background che avvisa Claude al termine.

​

L’azione Run in background non compare sotto un subagent

• Spawned by the main agent: il subagent è stato avviato in background, quindi Claude non lo sta attendendo e non devi fare nulla. Per fare in modo che Claude attenda invece i subagent, consulta Fare in modo che Claude attenda un subagent.
• Spawned by indica un altro subagent: l’azione compare solo per i subagent avviati dall’agente principale, non per un subagent annidato atteso da un altro subagent. Per terminare anticipatamente il subagent annidato, fai clic su Stop agent nella sua scheda. Il subagent in attesa prosegue quindi senza quel risultato.

​

Monitorare i processi in background

​

Comandi e scorciatoie di VS Code

​

Aprire una scheda di VS Code da altri strumenti

open "vscode://anthropic.claude-code/open"

xdg-open "vscode://anthropic.claude-code/open"

Start-Process "vscode://anthropic.claude-code/open"

start "" "vscode://anthropic.claude-code/open"

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

​

Configurare le impostazioni

• Impostazioni dell’estensione in VS Code: controllano il comportamento dell’estensione all’interno di VS Code. Aprile con Cmd+, (Mac) o Ctrl+, (Windows/Linux), quindi vai su Extensions > Claude Code. Puoi anche digitare / e selezionare General config… per aprire le impostazioni.
• Impostazioni di Claude Code in ~/.claude/settings.json: condivise tra l’estensione e la CLI. Usale per i comandi consentiti, le variabili d’ambiente, gli hook e i server MCP. Con Claude Code v2.1.283 o successiva, sono anche uno degli input che determinano la modalità di permesso con cui iniziano le conversazioni, mentre nelle versioni precedenti solo con i piani Pro, Max e Team. Cambiare modalità di permesso elenca l’ordine. Consulta Impostazioni per i dettagli.

​

Impostazioni dell’estensione

​

Usa provider di terze parti

​

Usare uno screen reader

• Le risposte di Claude: l’estensione annuncia ogni risposta una sola volta, quando è completa, e resta in silenzio mentre il testo viene trasmesso. Lo screen reader legge i blocchi di codice come un riepilogo con il numero di righe, legge i link tramite la loro etichetta e legge le tabelle cella per cella; la risposta completa resta leggibile nella trascrizione.
• Richieste di permesso e domande: l’estensione annuncia una richiesta quando compare la relativa richiesta di permesso, indicando lo strumento che Claude vuole usare. Fa un annuncio analogo quando Claude ti pone una domanda e quando Claude termina un piano e attende la tua revisione.
• Cambi di stato: l’estensione annuncia quando Claude inizia a lavorare, quando Claude è pronto per il tuo input e quando Claude Code inizia a compattare la conversazione.
• Messaggi in coda: quando invii un messaggio mentre Claude sta lavorando, l’estensione annuncia “Message queued.” per quel messaggio.
• Errori e prompt del modello: l’estensione annuncia gli errori nella conversazione e annuncia quando compare la richiesta di consenso per i crediti di utilizzo o la richiesta per le richieste segnalate.

​

Usare il pannello della chat dalla tastiera

• I tuoi messaggi: “You”
• I messaggi di Claude: “Claude”
• Passaggi degli strumenti: “Claude” più il nome dello strumento, ad esempio “Claude, Bash”
• Blocchi di ragionamento: “Claude, thinking”

• Con il focus su quell’opzione, premi il tasto freccia Left o Right. L’estensione annuncia ogni destinazione man mano che ti sposti su di essa. I tasti freccia richiedono Claude Code v2.1.268 o versioni successive.
• Fai clic sulla destinazione nell’etichetta.

​

Estensione VS Code vs. Claude Code CLI

​

Eseguire la CLI in VS Code

​

Passare dall’estensione alla CLI

​

Connettersi a strumenti esterni con MCP

• Aggiungere server
• Rimuovere server salvati nell’ambito locale, utente o di progetto
• Abilitare o disabilitare server
• Riconnetterti a un server
• Gestire l’autenticazione OAuth

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

​

Il server MCP integrato per l’IDE

• Apre i diff nel visualizzatore di diff nativo di VS Code
• Legge la tua selezione corrente per le @-menzioni
• Chiede a VS Code di eseguire le celle quando lavori in un notebook Jupyter

• Messaggi in coda: se metti in coda un messaggio mentre Claude lavora, il messaggio mantiene la selezione che avevi quando hai premuto Enter, qualunque cosa selezioni in seguito.
• File sensibili: per escludere un file sensibile come .env, aggiungi una regola di negazione Read per il suo percorso. Una regola di negazione corrispondente impedisce sia al testo selezionato sia all’avviso del file aperto per quel file di raggiungere Claude.
• Attach Open File disattivato: se disattivi l’impostazione Attach Open File, la CLI riceve il percorso del file attivo solo mentre hai del testo selezionato al suo interno.

• Trasporto: ws:// non crittografato. Poiché il socket è solo di loopback, qualsiasi processo in grado di intercettare il traffico può anche leggere il token dal file di lock, quindi TLS non aggiungerebbe protezione.
• Token di autenticazione: ogni attivazione dell’estensione genera un nuovo token di autenticazione casuale e lo scrive in un file di lock in ~/.claude/ide/<port>.lock. Per connettersi, la CLI deve presentare il token come header X-Claude-Code-Ide-Authorization.
• Permessi del file di lock: il file di lock ha permessi 0600 in una directory 0700, quindi solo l’utente che esegue VS Code può leggerlo. Se è impostata CLAUDE_CONFIG_DIR, il file di lock viene invece scritto in $CLAUDE_CONFIG_DIR/ide/.

{
  "permissions": {
    "deny": [
      "mcp__ide__getDiagnostics",
      "mcp__claude-vscode__getDiagnostics"
    ]
  }
}

1. Il codice viene inserito come nuova cella alla fine del notebook attivo.
2. VS Code scorre fino a rendere visibile la cella.
3. Un Quick Pick nativo ti chiede di scegliere Execute o Cancel.

​

Risolvi i problemi comuni

​

L’estensione non si installa

• Assicurati di avere una versione compatibile di VS Code (1.94.0 o successiva)
• Verifica che VS Code abbia il permesso di installare estensioni
• Prova a installarla direttamente dal VS Code Marketplace

​

Icona Spark non visibile

1. Apri un file: l’icona richiede che sia aperto un file. Avere aperta solo una cartella non è sufficiente.
2. Controlla la versione di VS Code: è richiesta la 1.94.0 o successiva. Controlla in Help > About
3. Riavvia VS Code: esegui “Developer: Reload Window” dalla Command Palette
4. Disattiva le estensioni in conflitto: disattiva temporaneamente altre estensioni di AI (Cline, Continue, ecc.)
5. Controlla l’attendibilità del workspace: l’estensione non funziona in Restricted Mode

​

Cmd+Esc non fa nulla su macOS

1. Apri Impostazioni di Sistema
2. Vai su Tastiera, poi Abbreviazioni da tastiera, poi Controller di gioco
3. Deseleziona la casella Game Overlay

​

Una conversazione ripresa è inizialmente vuota

​

Il pannello smette di rispondere ogni volta che un ricaricamento riapre una conversazione

​

Una formula viene mostrata come LaTeX grezzo

• La formula è inline e il pannello non la tratta come matematica: chiedi a Claude di inviarla di nuovo come blocco $$ su righe proprie. Il pannello lascia una formula inline così com’è scritta quando il testo tra i suoi delimitatori $…$:
  • È più di una semplice operazione aritmetica ma non contiene alcun carattere come =, + o ^ che lo contrassegni come matematica, come in $O(n log n)$
  • Inizia con una cifra e non contiene alcun carattere di questo tipo, come in $30$ e $1/N$
  • Ha spazi all’interno dei simboli del dollaro, come in $ x^2 $
  • È più lungo di 60 caratteri
  • È suddiviso su due righe. Anche una formula \(…\) suddivisa su due righe non viene composta.
• La formula ha un errore di sintassi TeX: chiedi a Claude di riscriverla con l’errore corretto.
• La formula definisce una macro: una formula con una definizione di macro come \newcommand o \def viene mostrata così com’è scritta. Chiedi a Claude di riscriverla senza la macro.
• La formula contiene un % senza escape: chiedi a Claude di riscriverla con \% per il segno di percentuale.
• La formula è troppo grande: una formula più lunga di 8.192 caratteri, o una il cui output composto sarebbe molto più grande del suo sorgente TeX, viene mostrata così com’è scritta. Chiedi a Claude di suddividerla in formule più piccole o di scriverla in modo più compatto.
• La formula segue una grande quantità di matematica: all’interno di un blocco di testo in una risposta, il pannello compone le formule in ordine fino a un limite. Una formula successiva che supererebbe il limite viene mostrata così com’è scritta. Chiedi a Claude di inviare di nuovo da sola la formula di cui hai bisogno.

​

Claude Code non risponde mai

1. Controlla la connessione a internet: assicurati di avere una connessione a internet stabile
2. Avvia una nuova conversazione: prova ad avviare una nuova conversazione per vedere se il problema persiste
3. Prova la CLI: esegui claude dal terminale per vedere se ottieni messaggi di errore più dettagliati

​

Disinstallare l’estensione

1. Premi Cmd+Shift+X su Mac o Ctrl+Shift+X su Windows/Linux per aprire la vista Estensioni
2. Cerca “Claude Code”
3. Fai clic su Disinstalla

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

​

Passaggi successivi

• Esplora i workflow comuni per ottenere il massimo da Claude Code
• Configura i server MCP per estendere le capacità di Claude con strumenti esterni. Aggiungili e gestiscili con /mcp nel pannello della chat.
• Configura le impostazioni di Claude Code per personalizzare i comandi consentiti, gli hook e altro ancora. Queste impostazioni sono condivise tra l’estensione e la CLI.
• Esamina le misure di sicurezza e l’utilizzo dei dati di Claude Code