Claude Code 102 per ricercatori accademici

.</think>Questo è il secondo di una serie di tutorial che sto realizzando su Claude Code per ricercatori accademici.

Questo tutorial si basa sul primo, Claude Code 101, che è diventato virale con oltre 4 milioni di visualizzazioni. Puoi leggerlo qui sotto:

Scrivo questi tutorial in un linguaggio semplice e accessibile. Non hai bisogno di competenze tecniche per capire questi tutorial o usare Claude Code. Se sai scrivere frasi in inglese, puoi usare usare Claude Code.

Breve Riassunto di Claude Code 101

Nel primo tutorial, hai imparato come aprire una singola cartella, aggiungere i tuoi PDF e dare PDF e dare a Claude Code un file CLAUDE.md, che contiene le istruzioni per Claude Code. Questo tipo di configurazione funziona per un progetto più breve o quando stai iniziando con Claude Code.

Ma come ricercatori accademici, i nostri progetti si sviluppano per mesi e persino anni, accumulando centinaia di articoli e diverse bozze.

In questo tutorial, impareremo come strutturare un progetto accademico più lungo con l'aiuto di Claude Code.

Parte 1: Strutturare un Progetto Lungo

Supponiamo che stiamo lavorando a un progetto come una tesi di dottorato, una monografia o un articolo di ricerca. Se organizzi un progetto come questo in una sola cartella con un unico file CLAUDE.md, Claude finirà per darti lo stesso tipo di risultati. Non sarà in grado di darti risultati precisi e personalizzati adatti al tuo lavoro.

Pensala in questo modo: se vuoi che il tuo assistente di ricerca (umano) scriva una sezione del tuo articolo, pulisca un set di dati o annoti un articolo, gli darai un set di istruzioni diverso per ognuno di questi compiti.

Possiamo usare esattamente questo schema organizzativo in Claude Code creando sottocartelle.

1.1 Sottocartelle per una Migliore Organizzazione

Diciamo che stai lavorando a una tesi di dottorato per la quale hai una cartella principale chiamata "La Mia Tesi". All'interno della cartella principale, crea delle sottocartelle:

• Letteratura per PDF e appunti sulla borsa di studio pubblicata
• Capitoli per le bozze dei tuoi capitoli
• Dati per i set di dati
• Appunti per appunti delle riunioni e idee
• Corrispondenza per email del relatore, scambi con i co-autori, rapporti dei revisori

Questo tipo di organizzazione aiuterà sia te che Claude Code. Se devi lavorare a una bozza di un capitolo, puoi andare direttamente alla cartella Capitoli.

Lo stesso vale per Claude Code. Se gli fai una domanda su, ad esempio, un certo dato, saprà cercarlo nella cartella Dati.

1.2 File CLAUDE.md per le Sottocartelle

Nel tutorial 101, abbiamo scritto un file CLAUDE.md, che è un insieme di istruzioni che Claude Code legge ogni volta che avvia una sessione.

Nella tua tesi principale, scrivi un file CLAUDE.md che racconti a Claude Code di te e del tuo progetto in termini generali. Chiameremo questo file CLAUDE.md "globale".

Questo non significa che devi essere vago. Sii preciso ma dagli il quadro generale. Avremo tempo per la specificità più tardi. Tratta questo CLAUDE.md come la costituzione del tuo progetto.

All'interno di ogni sottocartella, metti un altro file CLAUDE.md che si applica solo a quella particolare sottocartella. Chiameremo questi file CLAUDE.md "locali". Lo scopo dei file CLAUDE.md locali nelle sottocartelle è quello di dare a Claude Codezioni specifiche su questi compiti senza appesantire il file CLAUDE.md principale.

Ad esempio, il file CLAUDE.md nella tua sottocartella Capitoli potrebbe dire:

Se ti chiedo di criticare la mia bozza, segui la struttura: argomentazione, prove, letteratura, controargomentazione. Usa sempre lo stile di citazione MLA 9a edizione salvo diversa indicazione.

Il tuo file CLAUDE.md per la sottocartella Dati può contenere un'istruzione come:

Tratta tutti i file CSV e i fogli Excel come dati grezzi salvo diversa indicazione. Non sovrascrivere mai alcun file grezzo. Salva le versioni versioni pulite con _clean aggiunto alla fine dei nomi dei file.

E il tuo file CLAUDE.md per la cartella Corrispondenza potrebbe dire:

Dai sempre priorità ai punti che sono comuni tra i rapporti di revisione e gli scambi con i co-autori.

1.3 File CLAUDE.md Annidati

Quando Claude Code lavora in una sottocartella, legge due file CLAUDE.md: uno, che si trova nella sottocartella, e l'altro, che si trova nella cartella principale.

Questi file CLAUDE.md annidati danno a Claude Code un'idea chiara di cosa riguarda il tuo progetto complessivo e come rispondere a domande specifiche in modo preciso.

1.4 Stili di Output per i File CLAUDE.md Locali

Dovresti anche considerare di aggiungere una breve istruzione sullo stile di output in ogni file CLAUDE.md locale.

Ad esempio, nella sottocartella Letteratura, puoi chiedere a Claude Code di darti una tabella con colonne per argomentazione, prove, rilevanza al tuo progetto quando gli chiedi di riassumere un articolo. Allo stesso modo, nella sottocartella Appunti, puoi chiedergli di rispondere con punti elenco.

Puoi sempre tornare indietro e rivedere queste istruzioni.

1.5 Esempio/Esercizio Pratico

Apri la cartella principale della tua tesi in Claude Code e digita il seguente prompt:

Leggi i cinque articoli che ho aggiunto oggi alla sottocartella Letteratura e dimmi quali supportano o confutano le mie argomentazioni in "Capitolo 3 – Outline.md" nella sottocartella Capitoli.

Claude Code leggerà il file CLAUDE.md globale e due file CLAUDE.md locali nelle sottocartelle Letteratura e Capitoli e ti dirà quale articolo supporta o confuta le tue argomentazioni.

1.6 Cosa Non Fare

Non duplicare le istruzioni nei file CLAUDE.md globali e locali. È inutile e porterà Claude Code a elaborare più token.

I file CLAUDE.md locali nelle sottocartelle non dovrebbero contraddire le istruzioni nel file CLAUDE.md globale. Se c'è una contraddizione, Claude Code seguirà l'istruzione più specifica, ma finirai per essere confuso.

Parte 2: Modalità Piano e Comandi Barra Personalizzati

Un progetto accademico lungo come una tesi di dottorato o un articolo di ricerca coinvolge determinati compiti ripetitivi. Ad esempio, potresti selezionare articoli per la revisione della letteratura più e più volte. Dovrai scrivere uno schema ogni volta che inizi a abbozzare un capitolo. Se scrivi bozze zero (note anche come scrittura libera), dovrai "pulirle" quasi quotidianamente.

Ma ci sono anche compiti complessi e non ripetitivi. Ad esempio, rispondere al feedback dei revisori richiede un serio impegno con il loro feedback critico seguito dalla riscrittura del tuo manoscritto.

Claude Code può aiutarti con entrambi i tipi di compiti. Per compiti complessi e una tantum, Claude Code offre una Modalità Piano e per compiti ripetitivi, ha Comandi Barra Personalizzati.

2.1 Modalità Piano

Generalmente, quando dai a Claude Code un compito, inizia immediatamente a lavorare. Per compiti piccoli e a basso rischio, funziona bene. Ad esempio, chiedi a Claude Code di rinominare tutti i PDF nella tua sottocartella Letteratura usando i loro titoli e nomi degli autori. Claude Code lo fa immediatamente.

Ma questo approccio non produce risultati desiderabili per compiti complessi. Supponi di avere i tuoi appunti grezzi su trenta articoli di ricerca e chiedi a Claude Code di sintetizzare i tuoi appunti. Se Claude Code fraintende un'istruzione per qualsiasi motivo, te ne accorgerai conto solo dopo aver completato il compito.

La Modalità Piano ti dà più controllo su Claude Code. Invece di agire immediatamente, scrive un piano passo dopo passo di ciò che farà. Tu leggi il piano; se non sei d'accordo con qualcosa, gli chiedi di modificare il piano di conseguenza.

Puoi trovare la Modalità Piano nel menu delle autorizzazioni sotto la barra della chat. Puoi anche aprirla usando Ctrl + Maiusc + M. O semplicemente chiedere a Claude Code di mostrarti il piano nel prompt prima di eseguire qualsiasi cosa.

2.2 Quando Usare la Modalità Piano

La Modalità Piano è più adatta per compiti complessi che coinvolgono tre o più passaggi, un compito che coinvolge più di una sottocartella, o un compito che produce un output lungo. Esempi possono includere: sintetizzare i tuoi appunti, selezionare studi per una revisione sistematica, o pulire un set di dati e produrre un codebook.

Non chiederesti al tuo assistente di ricerca (umano) di andare e "abbozzare il capitolo tre" senza chiedere il loro piano. La Modalità Piano in Claude Code funziona allo stesso modo.

2.3 Comandi Barra Personalizzati

Un Comando Barra è una scorciatoia. Claude Code ha diversi Comandi Barra integrati. Apri il tuo Claude Code e digita una barra in avanti, e ti mostrerà un elenco di Comandi Barra integrati. Quando digiti, ad esempio, il Comando Barra integrato, /schedule, Claude Code creerà un compito programmato che può essere eseguito su richiesta o automaticamente.

Un Comando Barra non è altro che un insieme di istruzioni scritte in un inglese semplice che Claude Code segue. Puoi pensarlo come un prompt lungo che non devi digitare ogni volta che vuoi usarlo per un compito ripetitivo.

Ricorda, nella Parte 5 del tutorial 101, abbiamo imparato a creare un'Abilità sia manualmente che automaticamente. Se creiamo un'Abilità automaticamente, ci darà un Comando Barra Personalizzato.

Quando crei un Comando Barra Personalizzato, Claude Code creerà un file .md nella cartella .claude/commands sul tuo computer. Devi conoscere questo percorso in modo che se devi modificare il file .md, tu sappia dove trovarlo.

2.4 Creare il Primo Comando Barra Personalizzato

Il modo più semplice per creare un Comando Barra Personalizzato è chiedere a Claude Code di crearne uno per te. Ad esempio, puoi aprire Claude Code e digitare quanto segue:

Crea un Comando Barra chiamato /firstdraft che converte i miei appunti grezzi nella mia cartella Appunti in paragrafi coesi e coerenti senza parole o frasi ridondanti.

Claude Code scriverà un insieme di istruzioni in un file .md e lo metterà nella cartella .claude/commands. Una volta che Claude Code ha finito di creare il Comando Barra, riavvia la sessione e digita la barra in avanti. Vedrai /firstdraft nel menu.

Puoi costruire una libreria di Comandi Barra Personalizzati scritti specificamente per il tuo progetto.

2.5 Cosa Non Fare

Non scrivere Comandi Barra per compiti che fai una volta ogni sei mesi. Quei Comandi affolleranno il tuo Menu Barra e probabilmente diventeranno obsoleti man mano che il tuo progetto si evolve.

Non aggiungere istruzioni lunghe che coinvolgono processi multi-fase in un file Comando Barra. Tieni un Comando Barra per un compito specifico e ripetitivo. Se le tue istruzioni superano le quindici righe, molto probabilmente hai bisogno di due Comandi Barra.

Per compiti più lunghi e complessi, non saltare la Modalità Piano.

Parte 3: Sottoagenti per Compiti di Ricerca Paralleli

Fino ad ora, abbiamo esaminato solo compiti che possono essere eseguiti in una singola sessione di Claude Code, sia in Modalità Piano che con Comandi Barra Personalizzati. Hai un assistente AI con cui lavori nel pannello principale.

Ma per un progetto più lungo come una tesi di dottorato o un articolo di ricerca, potresti aver bisogno di più assistenti AI. È qui che entrano in gioco i sottoagenti.

3.1 Perché Un Solo Assistente Non Basta

Nei progetti più lunghi, incontriamo due problemi durante l'utilizzo di un agente AI come Claude Code.

Se chiedi a Claude Code di leggere venti PDF nella tua cartella Letteratura, ogni pagina di ogni articolo diventa parte della conversazione per Claude Code. Fai diverse domande e lui ti risponde.

Ora tutto il testo negli articoli e le tue conversazioni fanno parte della memoria di Claude Code per quella sessione. Ora se gli chiedi di abbozzare uno schema per il Capitolo 4 della tua tesi, le sue risposte diventeranno lente e poco chiare a causa di tutto il contesto. Questo si chiama "inquinamento del contesto".

In secondo luogo, in una singola sessione, puoi assegnare a Claude Code compiti solo in sequenza. Se vuoi tre critiche diverse del tuo manoscritto (una da un teorico, una da un informazionista e una dal Revisore 2), non puoi eseguirle in sequenza in una singola sessione perché ogni critica influenzerà la successiva a causa dell'inquinamento del contesto.

Per un compito come questo, hai bisogno di tre sessioni indipendenti.

3.2 Cos'è un Sottoagente?

Pensa a un sottoagente come a una versione specializzata di Claude Code con le proprie istruzioni e, cosa più importante, la propria finestra di contesto. La finestra di contesto è la memoria di lavoro di Claude Code per una singola conversazione. Tutto ciò che Claude Code può "vedere" in un dato momento, dai tuoi file ai tuoi prompt alle sue stesse risposte alle istruzioni in CLAUDE.md si trova all'interno della finestra di questa finestra di contesto. Quando fai una domanda, Claude Code usa la sua finestra di contesto per rispondere.

Come i Comandi Barra Personalizzati, anche un sottoagente esiste come file .md. Ma a differenza di un Comando Barra, che non ha una finestra di contesto, un sottoagente ne ha una.

Un'altra differenza importante tra un Comando Barra e un sottoagente è che, a differenza di un Comando Barra, un sottoagente non legge il file CLAUDE.md. Ha le proprie istruzioni in un file .md e basta.

Un sottoagente avrà un ruolo molto specifico, ad esempio, "Controllore di Citazioni" o "Revisore Critico". E ogni agente ha il proprio contesto. Quando deleghi un compito dalla tua sessione principale a un sottoagente, la sua lettura e il suo ragionamento rimarranno all'interno del sottoagente. Riceverai solo la risposta finale. In questo modo puoi evitare che la tua sessione principale si riempia di inquinamento del contesto.

3.3 Sottoagenti per Ricercatori

Sebbene il tipo esatto di sottoagenti di cui hai bisogno dipenda dal tuo progetto, ecco alcuni esempi generali.

• Sottoagente Revisore della Letteratura: legge ogni nuovo PDF aggiunto alla cartella Letteratura e ti riassunti strutturati riguardo alla tua argomentazione.
• Sottoagente Controllore di Citazioni: prende un capitolo bozza di capitolo e verifica ogni fonte citata rispetto agli articoli nella cartella Letteratura e segnala i riferimenti mancanti.
• Sottoagente Revisore della Metodologia: per progetti empirici, controlla se la sezione dei metodi è in linea con i dati e le analisi.
• Sottoagente Revisore 2: critica le tue bozze come un revisore ostile.

3.4 Creare un Sottoagente

Proprio come per creare Comandi Barra Personalizzati, il modo più semplice per creare un sottoagente è chiedere a Claude Code di crearne uno. Apri una sessione e digita:

Crea un sottoagente chiamato Controllore di Citazioni. Prenderà una bozza dalla cartella Capitoli, elencherà ogni citazione nel testo, verificherà ciascuna rispetto agli articoli nella cartella Letteratura. Poi creerà un file markdown con i riferimenti mancanti. Il sottoagente non deve mai modificare o cambiare la bozza.

Claude Code creerà un file citation-checker.md e lo metterà nella cartella Agents all'interno della tua cartella .claude.

Riavvia la sessione e il tuo sottoagente è pronto per l'uso. Per utilizzare un sottoagente, basta chiedere a Claude Code di usarlo. Ad esempio, "Usa, "Usa Controllore di Citazioni su chapter_4.md nella cartella Capitoli."

Se vuoi, puoi sempre andare e modificare il file .md del sottoagente per adattarlo alle tue esigenze.

3.5 Esempio: Critica Parallela

Supponi di aver finito di abbozzare un capitolo e ora vuoi un feedback prima di inviarlo al tuo supervisore o collega. Apri una sessione e digita:

In parallelo, fai sì che il Revisore della Metodologia e il Revisore 2 leggano e critichino chapter_4 nella cartella Capitoli e mi diano rapporti di revisione. Salva i due rapporti come chapter_4_critiques sotto il nome del sottoagente nella stessa cartella.

Entrambi i sottoagenti useranno i propri rispettivi contesti per leggere e valutare la tua bozza. Una volta terminato, avrai le due critiche come due file separati. La tua sessione principale non ha mai dovuto aggiungere la tua bozza, o qualsiasi cosa correlata, nella sua finestra di contesto.

Tieni presente che questo potrebbe richiedere alcuni minuti a seconda del modello che stai utilizzando.

3.6 Cosa Non Fare

Non creare un sottoagente per compiti minori.

Non dare ai tuoi sottoagenti responsabilità sovrapposte.

Non lasciare mai che il tuo sottoagente modifichi le tue bozze. Un sottoagente dovrebbe sempre produrre i suoi rapporti suoi rapporti come file separati.

Parte 4: Collegare Claude Code ad Altre App

Fino ad ora, il tuo progetto è rimasto all'interno di Claude Code senza integrazione con nessun'altra app. Tutto ciò che Claude Code legge, modifica, scrive esiste all'interno della cartella del tuo progetto.

Ma i progetti accademici come tesi di dottorato e articoli di ricerca coinvolgono processi organizzativi e strutturali complessi che sono distribuiti su varie applicazioni. Ad esempio, le tue citazioni sono in Zotero, le tue bozze in Google Drive e i tuoi appunti delle riunioni in Zoom.

Come integriamo queste app con il nostro Claude Code?

Nel 2024, Anthropic ha introdotto un metodo chiamato Model Context Protocol (MCP) che consente agli utenti di integrare app come Zoom e Google Drive con Claude Code.

Non devi preoccuparti di cosa sia MCP e come funzioni. Devi solo sapere come collegare diverse app usando MCP.

4.1 Come Collegare un'App a Claude Code

Apri il tuo Claude Code e nell'angolo in alto a sinistra, vedrai un'opzione "Personalizza". Cliccaci sopra e poi seleziona "Collega le tue app" nella schermata successiva.

Questo ti mostrerà i Connettori, un elenco di app approvate da Anthropic per essere utilizzate in Claude Code. Cerca app come Zoom o Google Drive e clicca su "Collega" nella schermata successiva.

Ti verrà chiesto di concedere le autorizzazioni a Claude Code. Una volta fatto, la tua app sarà collegata a Claude Code.

4.2 Esempio Pratico

Collega il tuo Zoom a Claude Code, apri una sessione e digita:

Prendi la trascrizione delle tre chiamate recenti che ho avuto con il mio collega. Estrai tutti i commenti relativi al Capitolo 4 in Bozze. Salva tutti i commenti estratti in un nuovo file nella cartella Corrispondenza con la data di oggi.

4.3 Connettori e Sottoagenti

Man mano che il tuo progetto si evolve, puoi usare una combinazione di Connettori e sottoagenti per rendere efficienti i tuoi processi.

Ad esempio, puoi impostare un sottoagente chiamato Revisore della Letteratura che utilizza i database PubMed o arxiv disponibili nell'elenco dei Connettori.

4.4 Cosa Non Fare

Non installare troppi Connettori. Sii selettivo e installa solo quelli relativi al tuo progetto.

Non collegare app che potrebbero contenere informazioni riservate che non vuoi condividere con l'AI. Ad esempio, se il tuo Slack contiene messaggi con dati riservati non pubblicati, non collegarlo.

Parte 5: Hook e Compiti Pianificati

Una delle parti più importanti di qualsiasi progetto di ricerca è avere un backup di tutti i tuoi file. Non vuoi avere una singola copia della tua tesi su un computer che si blocca tre giorni prima della discussione.

5.1 Cos'è un Hook?

Gli Hook in Claude Code possono automatizzare il processo di creazione di backup. Un Hook è un breve insieme di istruzioni che si attiva automaticamente quando si verifica un evento specifico in Claude Code. Una volta impostato un Hook, non dovrai ricordarti di usarlo. Claude Code lo userà da solo.

5.2 Creare il Tuo Primo Hook

Il modo più semplice per creare un Hook è semplicemente chiedere a Claude Code di crearne uno. Apri una sessione di Claude Code e digita:

Imposta un hook di sicurezza pre-modifica che copi un capitolo e salvi la sua versione corrente prima di iniziare a modificarlo.

Questo Hook creerà una versione di backup di qualsiasi capitolo a cui chiedi a Claude Code di modificare.

Una volta che l'Hook è pronto per l'uso, chiedi a Claude Code quanto segue:

Modifica Chapter_4.md in Bozze alla luce dei commenti nella trascrizione della riunione Zoom di oggi.

Claude Code creerà un backup del file originale, lo metterà in una cartella di backup e modificherà una copia nella cartella Bozze.

5.3 Cosa Sono i Compiti Pianificati

I progetti di scrittura accademica più lunghi coinvolgono compiti che devono essere eseguiti a intervalli regolari. Ad esempio, vuoi eseguire scansioni della letteratura ogni settimana per rimanere aggiornato sulle ultime pubblicazioni.

Puoi impostare Compiti Pianificati proprio come gli Hook in Claude Code. Semplicemente descrivi cosa dovrebbe accadrà e quando, e Claude Code scriverà una routine per quello. I Compiti Pianificati useranno i Connettori e i sottoagenti di cui abbiamo parlato nelle parti precedenti.

5.4 Casi d'Uso per i Compiti Pianificati

Come ricercatore, potresti voler pianificare un backup regolare delle tue bozze. Puoi chiedere a Claude Code di creare un compito di Backup Bozze che copi tutto nella cartella Bozze e lo salvi in una cartella di backup con un timestamp.

5.5 Esempio

Apri una sessione di Claude Code e digita:

Crea un Compito Pianificato che venga eseguito ogni lunedì mattina alle 9:00. Dovrebbe usare il MCP di PubMed per recuperare nuovi articoli sui social media e la salute mentale pubblicati nell'ultima settimana. Dovrebbe poi passare gli articoli al sottoagente Revisore della Letteratura per selezionarli. Salva la tabella di selezione in una sottocartella chiamata Scansioni Settimanali nella cartella Letteratura.

5.6 Cosa Non Fare

Non impostare Hook o Compiti Pianificati che coinvolgano la cancellazione di alcun file.

Non creare troppi Hook in modo da avere difficoltà a ricordarli. Oppure puoi mantenere un elenco separato di Hook per ricordarteli.

Non impostare un Hook o un Compito Pianificato per qualcosa che non hai fatto manualmente almeno quattro volte.