Questo è un tutorial in cinque parti per aiutare i ricercatori accademici a iniziare con Claude Code.
L'ho scritto in un linguaggio accessibile e non è necessario alcun background tecnico per comprendere questo tutorial o utilizzare Claude Code.
Parte 1: Cos'è Claude Code?
Claude Code è uno strumento che funziona sul tuo computer. Non lasciarti intimidire dalla parola "codice". Non hai bisogno di alcuna competenza di programmazione per usarlo. Installi Claude Code sul tuo computer proprio come faresti con un'app come Zoom o Zotero.
Una volta che lo hai sul computer, apri la cartella del tuo progetto (tesi, articolo, ecc.) e lasci che Claude lavori all'interno della cartella. Claude può leggere ogni file nella cartella, modificare file esistenti e crearne di nuovi. Può anche ricordare su cosa stavi lavorando dopo aver terminato una sessione.
A differenza delle app basate su browser come ChatGPT e Gemini che "parlano" e basta, Claude Code può effettivamente "fare" cose per te.
1.1 Perché Dovrebbe Interessarti?
Sei un ricercatore e hai una cartella sul tuo computer con diversi PDF, bozze dei tuoi articoli, fogli di calcolo, set di dati e alcune trascrizioni di interviste. Tutti questi documenti sono pertinenti al tuo progetto, ma devi creare collegamenti tra la letteratura pubblicata, i dati raccolti e i tuoi appunti.
Questo è il tipo di caso d'uso per cui è stato creato Claude Code.
La maggior parte degli accademici e dei ricercatori ha utilizzato app di intelligenza artificiale nei propri browser (ChatGPT, Claude, Gemini, ecc.). Apri una scheda, scrivi un prompt e l'IA risponde. Se vuoi fare domande sui tuoi articoli o bozze, li aggiungi a ChatGPT o Claude.
Claude Code è diverso perché, invece di portare i tuoi file a un'app di IA nel browser, porti l'IA nella cartella che contiene tutti i tuoi dati.
1.2 Perché Claude Code è Importante per il Lavoro Accademico
Ci sono due modi fondamentali in cui Claude Code può funzionare come tuo assistente di ricerca affidabile e potente.
In primo luogo, Claude Code si ricorda di te, della tua ricerca, del tuo stile di scrittura e delle tue esigenze di ricerca in continua evoluzione. Non dovrai spiegare ripetutamente le tue richieste.
In secondo luogo, poiché Claude Code lavora all'interno di una cartella sul tuo computer, può elaborare più file contemporaneamente. Ad esempio, può esaminare tutti i quarantacinque PDF nella tua cartella ed estrarre informazioni rilevanti (obiettivi, metodologia, ecc.) da tutti. Puoi persino chiedergli di creare un nuovo file basato sulle informazioni estratte.
Claude Code può gestire tutti i tipi di file, dai file Word ai fogli Excel, PDF, ecc.
1.3 Cosa Significa in Termini Pratici?
Se sei un ricercatore qualitativo, carica una cartella piena di trascrizioni di interviste e chiedi a Claude Code di darti ogni occorrenza di una particolare espressione, ad esempio come ogni partecipante ha parlato di un dato argomento. Poi chiedigli di cercare temi ricorrenti tra le interviste.
Se sei un ricercatore quantitativo, aggiungi un CSV disordinato o un foglio Excel nella tua cartella e chiedi a Claude Code di ripulirlo per te. Puoi chiedergli di eseguire statistiche descrittive o di spiegare un commento critico fatto da un revisore.
1.4 Cosa Non è Claude Code
Claude Code è uno strumento incredibilmente potente, ma non sostituisce il tuo giudizio esperto. Può abbozzare, riassumere, codificare, ma ciò che conta come argomentazione o prova è una tua responsabilità.
Gli accademici che probabilmente avranno successo usando Claude Code sono quelli che lo trattano come un assistente di ricerca e non quelli che delegano a esso tutto il loro pensiero e giudizio.
Parte 2: Installazione dell'App Claude Code, La Tua Prima Sessione
Se sei nuovo a Claude Code, prenditi 15-20 minuti per installarlo e configurarlo. Non hai bisogno di competenze di programmazione per usare Claude Code.
Avrai bisogno di un abbonamento Claude Pro o Max per utilizzare Claude Code sul tuo computer.
2.1 Installazione
Claude Code è disponibile sia per Windows che per Mac. Vai su claude.com/download e scarica la versione compatibile con il tuo computer. Eseguilo come faresti con qualsiasi altro programma di installazione (es. Zoom, Zotero, ecc.). Su Windows, appare nel menu Start. Su Mac, appare nella cartella Applicazioni.
Apri l'app una volta installata. La prima volta che la apri, Claude ti chiederà di accedere tramite browser. Una volta effettuato l'accesso, vedrai una colonna a sinistra e un pannello di chat al centro. La colonna di sinistra mostrerà una cronologia di tutte le tue conversazioni, proprio come in Claude o ChatGPT nel browser.
2.2 Aprire la Tua Prima Cartella
Clicca su "Apri Cartella". Di solito si trova in cima alla barra della chat nel pannello principale. La sua posizione cambia leggermente a ogni aggiornamento, ma la troverai principalmente nelle vicinanze della barra della chat.
Naviga fino a qualsiasi cartella sul tuo computer in cui hai salvato PDF o bozze. Se vuoi essere estremamente cauto, crea una cartella dedicata "Assistente di Ricerca Claude" e naviga fino a quella.
Ora Claude Code si trova all'interno di quella cartella. Ha accesso a ogni file e sottocartella all'interno della cartella principale.
2.3 Com'è una Sessione
Una sessione è la conversazione che hai con Claude nel pannello di chat principale, proprio come fai nelle app basate su browser come ChatGPT.
L'interazione è simile a quella delle app basate su browser come ChatGPT. L'unica differenza è che ora Claude Code ha accesso ai tuoi file sul tuo computer. Ha anche la capacità di creare file sul tuo computer.
Una volta che sei nella cartella, dai a Claude un prompt semplice come:
Leggi tutti gli articoli nella cartella e dammi le loro argomentazioni principali come file separato.
Questo è tutto. La maggior parte della tua interazione con Claude Code consisterà nello scrivere istruzioni come questa.
Claude Code procederà a recuperare le informazioni rilevanti dagli articoli e inizierà a creare un nuovo file. Questo file apparirà nella cartella in cui stai lavorando.
Mentre procede, ti chiederà il permesso di farlo. Puoi fare in modo che Claude Code bypassi le autorizzazioni, ma all'inizio è una buona idea fargliele chiedere. Non vorrai che Claude Code cancelli file importanti senza chiedertelo.
Ogni sessione che avvii in Claude Code viene automaticamente salvata nel pannello a sinistra.
Parte 3: Claude Code Come Tuo Assistente di Ricerca
Ogni volta che Claude Code si avvia, cerca immediatamente un file chiamato CLAUDE.md per un insieme di istruzioni da seguire. Nota le lettere maiuscole, questo è importante.
Ci sono due modi per creare un file CLAUDE.md: automatico e manuale.
3.1 Manualmente
Se vuoi farlo manualmente, apri Blocco note su Windows o TextEdit su un Mac e scrivi il tipo di istruzioni che vuoi che Claude Code segua. Tieni presente che devi scrivere queste istruzioni solo in linguaggio semplice. Non è necessario usare alcun linguaggio di codifica o programmazione.
Puoi dividere il file CLAUDE.md nelle seguenti sezioni:
#Ruolo (il simbolo del cancelletto qui indica che è un'intestazione)
Descrivi il tipo di ruolo che vorresti che Claude Code assumesse come tuo assistente di ricerca. Fornisci alcuni dettagli sul tuo campo di ricerca e sul progetto attuale.
Descrivi gli standard accademici rilevanti per il tuo campo di ricerca. Ad esempio, puoi dire a Claude Code di seguire un determinato stile di citazione o una struttura specifica di un articolo di ricerca.
#Stile di Scrittura
Di' a Claude Code il tipo di stile di scrittura che vorresti seguisse, se vuoi che risponda in stile accademico o in uno stile informale.
#Stile di Critica
Descrivi come vorresti che Claude Code criticasse il tuo lavoro, se vorresti che si concentrasse sulla tua argomentazione, sulle prove o sulla metodologia.
Salva il file come CLAUDE.md nella cartella principale di Claude sul tuo computer e il gioco è fatto.
Non hai bisogno di un file CLAUDE.md perfettamente costruito. Puoi sempre tornare indietro e modificarlo man mano che il tuo progetto evolve.
3.2 Automaticamente
Se non vuoi creare un file CLAUDE.md manualmente, avvia semplicemente una sessione di chat in Claude Code e fornisci dettagli sul suo ruolo, standard, stile di scrittura e stile di critica. Poi chiedigli di creare un file CLAUDE.md usando queste informazioni.
Claude Code creerà il file e lo salverà nella tua cartella Claude.
3.3 Memoria Automatica
Mentre lavori al tuo progetto, Claude Code scriverà brevi note sul tuo lavoro e le salverà per uso proprio. Non le vedrai e non devi preoccupartene troppo. Claude Code mette queste note in una cartella e le gestisce autonomamente.
Ogni volta che avvii una sessione, Claude Code legge CLAUDE.md e le proprie note e le usa per rispondere alle tue domande.
Col tempo, le tue istruzioni e le note di Claude Code gli forniscono abbastanza contesto su di te e sul tuo lavoro da renderlo un assistente di ricerca affidabile.
Puoi chiedere a Claude Code della sua memoria scrivendo "Dimmi cosa hai memorizzato". Se una certa informazione è obsoleta (es. uno stile di citazione), chiedigli semplicemente di aggiornare la sua memoria con la nuova informazione.
3.4 Cosa Non Mettere in CLAUDE.md
Non inserire informazioni riservate in CLAUDE.md o qualsiasi cosa che non vuoi che l'IA utilizzi.
Non lasciare che CLAUDE.md diventi un insieme di informazioni obsolete perché ciò avrà un impatto considerevole sui suoi risultati. Potresti voler aggiornare il file ogni poche settimane.
Parte 4: Lavorare con i Tuoi Documenti di Ricerca
Una cartella di Claude non deve essere organizzata in modo molto ordinato. Questo non significa che devi iniziare a mettere file irrilevanti in questa cartella. Significa che non dovresti perdere tempo a organizzarla. Claude può farlo da solo. L'unica cosa che potresti voler tenere a mente è di non dare ai tuoi file nomi confusionari come Tesi (finale) (finale2) (usa questo).
Aggiungi una serie di PDF, file Word, set di dati, trascrizioni di interviste, ecc. relativi al tuo progetto.
Supponiamo che tu abbia venti articoli di ricerca relativi al tuo argomento di ricerca e che tu voglia trovare un tema comune che li attraversi tutti. O forse hai una certa affermazione o argomentazione e stai cercando articoli che presentino prove a sostegno o in contrasto con tale affermazione.
Apri la cartella in Claude Code e scrivi un prompt come:
Leggi ogni PDF in questa cartella e dimmi quali articoli sono in disaccordo con la seguente argomentazione: [incolla qui l'argomentazione]
Claude leggerà tutti i PDF nella cartella e ti fornirà le informazioni rilevanti da questi articoli. La risposta di Claude potrebbe essere sotto forma di tabella.
4.1 Assistente di Ricerca per la Revisione della Letteratura
Se sei un ricercatore biomedico o uno scienziato sociale che esegue frequentemente revisioni sistematiche, scarica cinquanta articoli di ricerca e mettili in una cartella intitolata "Revisione Sistematica con Claude".
Apri la cartella in Claude Code e fornisci i tuoi criteri di screening (inclusione/esclusione) e chiedigli di esaminare tutti gli articoli nella cartella.
Claude Code esaminerà gli articoli secondo i tuoi criteri e ti darà i risultati sotto forma di tabella.
4.2 Lavorare con le Trascrizioni
Se sei un ricercatore qualitativo, puoi aggiungere le trascrizioni delle interviste nella cartella di Claude e chiedergli di estrarre informazioni relative a un dato argomento.
Ad esempio, puoi chiedergli di estrarre come ogni intervistato ha risposto a una determinata domanda.
4.3 Affida a Claude un Compito Noioso
Metti una cinquantina di PDF in una cartella e aprilo in Claude Code. Poi chiedigli di esaminarli tutti e rinominarli usando i loro titoli.
Vedrai che Claude Code avrà fatto il necessario in un paio di minuti.
4.4 Chiedere a Claude Code di Creare File
Poiché il tuo progetto evolverà, vorrai che Claude Code crei anche alcuni file per te in modo da poterli consultare se necessario. Aiuterà anche Claude Code con un facile recupero man mano che il progetto si sviluppa.
Ogni volta che chiedi a Claude Code di eseguire un compito significativo come esaminare articoli o estrarre informazioni dalle trascrizioni, chiedigli di salvare la risposta nella cartella come file.
Generalmente, Claude Code salverà questi file come markdown (md), che occupano pochissimo spazio e sono molto facili per Claude Code per recuperare informazioni. Ma puoi anche chiedergli di creare un file Word o un foglio Excel.
Parte 5: "Skill" di Claude Code
Una Skill è un insieme di istruzioni che rende Claude Code specializzato per un compito. Proprio come il file CLAUDE.md, anche una Skill è un file markdown scritto in inglese semplice. E proprio come CLAUDE.md, puoi creare un file Skill sia manualmente che automaticamente.
Una volta creata una Skill, Claude Code ricorderà quando usarla. Non devi ricordartelo tu stesso. Ma puoi sempre invocare una Skill se lo desideri, usando il comando barra.
Il modo più semplice per creare una Skill è chiedere a Claude Code di farlo per te. Diciamo che hai riunioni Zoom regolari e hai le trascrizioni di queste riunioni. Per ogni riunione o trascrizione, vuoi estrarre elementi attuabili o cose da fare.
Per creare una Skill, avvia una sessione di Claude Code e chiedigli semplicemente di creare una Skill per estrarre elementi attuabili dalle trascrizioni di Zoom.
Claude Code si metterà al lavoro. Ti farà domande di follow-up e creerà un file Skill che potrai modificare se lo desideri. Forse vuoi che Claude Code segua una struttura specifica durante la risposta.
Una volta creata la Skill, riavvia Claude Code e la Skill sarà pronta per l'uso.
5.1 Differenza tra CLAUDE.md e Skill
CLAUDE.md contiene istruzioni globali su di te e il tuo progetto. Fornisce a Claude Code il quadro generale su di te e la tua ricerca.
Le Skill, d'altra parte, sono pensate per compiti particolari. Questi file contengono informazioni molto più specifiche e granulari. CLAUDE.md, Skill e memoria automatica lavorano insieme per darti la migliore risposta possibile.
Cosa Non Delegare a Claude Code
Claude Code è ottimo per compiti ad alta intensità di lavoro, dispendiosi in termini di tempo e ripetitivi. Affida questi compiti a Claude Code. Ma Claude Code non sarà in grado di creare ciò che conta veramente come contributo accademico perché non sarà in grado di fornirti argomentazioni nuove e originali.
Può sintetizzare informazioni che puoi poi usare a sostegno della tua argomentazione, ma il compito di elaborare un'argomentazione originale rimane tuo in quanto ricercatore.
