Glossario Claude Code

Tutto quello che ti serve conoscere per iniziare ad usare il più famoso AI coding tool del mercato

Glossario Claude Code

Addentrarsi nel mondo di Claude Code e del suo ecosistema sembra facile:

  • apri un terminale
  • scrivi claude
  • inizi a sparare prompt a manetta

Se stai usando Claude Code (d’ora in avanti lo chiamerò CC) in questo modo, vuol dire che lo stai utilizzando al 20% del suo potenziale.

Esistono infatti tutta una serie di strumenti di base che casa Anthropic ti fornisce per poter configurare e rendere più potente lo strumento.

E siccome tra mille termini si fa confusione, ho pensato di darti una breve lista di termini che aiutano a farsi un’idea dell’ecosistema CC!

Sei pronto? Bene, iniziamo!

Funzionalità ed estensioni

Nome Definizione Come si attiva Come lavora
Agent L’agente che gestisce la conversazione con l’utente e coordina il lavoro sul progetto. Entra in azione quando invii una richiesta in una sessione di Claude Code. Interpreta l’obiettivo, raccoglie informazioni, usa strumenti, verifica i risultati e può delegare attività ai subagent.
Subagent Un agente secondario a cui delegare un compito specifico, con un contesto separato da quello principale e istruzioni dedicate. Restituisce i risultati all’agente che lo ha avviato. L’agente principale lo avvia quando ritiene utile delegare, oppure su tua richiesta esplicita nel prompt. I subagent personalizzati si possono definire in file Markdown in .claude/agents/. Usa gli strumenti consentiti nel proprio contesto e restituisce il risultato all’agente principale. Può lavorare mentre l’agente principale attende.
Skill File Markdown contenente conoscenze e istruzioni riutilizzabili che Claude carica e usa al momento del bisogno. Può essere richiamato dall’utente con /nome-skill o attivato da Claude al momento del bisogno, secondo la configurazione. Viene caricata nel contesto e fornisce informazioni e soluzioni utili.
Hook File che serve a impostare una automazione che si esegue al verificarsi di un evento di Claude Code. Al verificarsi di un evento di CC, come ad esempio prima di usare uno strumento o dopo una modifica. Può avviare script o altre azioni configurate.
Script File scritto in un linguaggio di programmazione, generalmente Javascript o Typescript.
Serve a svolgere azioni precise senza dipendere dal fattore di interpretazione di Claude
Per convenzione, viene definito nella cartella .claude/scripts e viene invocato da skill, hook o agenti. Viene eseguito da Claude tramite terminale
Tool Una capacità operativa che Claude può utilizzare, come leggere un file, modificarlo, cercare nel codice o eseguire un comando nel terminale. Al momento del bisogno Generalmente tramite terminale o come strumento di Claude Code
MCP (Server) E’ una suite di strumenti codificati in linguaggi di programmazione che permettono l’uso di piattaforme esterne o semplicemente di lanciare logica applicativa. CC li usa in base al bisogno e alle richieste esplicite dell’utente. Viene interrogato da Claude, fornisce la lista degli strumenti con nome e descrizione e una documentazione dell’intera suite.
Claude studia il tutto e decide quali strumenti chiamare e in che ordine.
Plugin Un pacchetto installabile che raccoglie una o più estensioni, come skill, subagent, hook e server MCP. Serve a distribuire e riutilizzare una suite di configurazioni e strumenti. Si installa, per esempio, con /plugin install nome-plugin@nome-marketplace. La suite agisce in simbiosi con CC
Marketplace Un catalogo attraverso cui scoprire e installare plugin. È il canale di distribuzione, non il plugin stesso. Nella chat CC digitare: /plugin marketplace add nome-marketplace Claude Code ne legge il catalogo e rende disponibili i plugin per l’installazione. Aggiungere un marketplace non significa installare automaticamente tutti i plugin che contiene.
Slash command Un comando che inizia con/. Può controllare la sessione, come /clear, oppure richiamare una skill disponibile. Nella chat CC digitare / Dipende dal comando
  1. Agent

    Definizione
    L’agente che gestisce la conversazione con l’utente e coordina il lavoro sul progetto.
    Come si attiva
    Entra in azione quando invii una richiesta in una sessione di Claude Code.
    Come lavora
    Interpreta l’obiettivo, raccoglie informazioni, usa strumenti, verifica i risultati e può delegare attività ai subagent.
  2. Subagent

    Definizione
    Un agente secondario a cui delegare un compito specifico, con un contesto separato da quello principale e istruzioni dedicate. Restituisce i risultati all’agente che lo ha avviato.
    Come si attiva
    L’agente principale lo avvia quando ritiene utile delegare, oppure su tua richiesta esplicita nel prompt. I subagent personalizzati si possono definire in file Markdown in .claude/agents/.
    Come lavora
    Usa gli strumenti consentiti nel proprio contesto e restituisce il risultato all’agente principale. Può lavorare mentre l’agente principale attende.
  3. Skill

    Definizione
    File Markdown contenente conoscenze e istruzioni riutilizzabili che Claude carica e usa al momento del bisogno.
    Come si attiva
    Può essere richiamato dall’utente con /nome-skill o attivato da Claude al momento del bisogno, secondo la configurazione.
    Come lavora
    Viene caricata nel contesto e fornisce informazioni e soluzioni utili.
  4. Hook

    Definizione
    File che serve a impostare una automazione che si esegue al verificarsi di un evento di Claude Code.
    Come si attiva
    Al verificarsi di un evento di CC, come ad esempio prima di usare uno strumento o dopo una modifica.
    Come lavora
    Può avviare script o altre azioni configurate.
  5. Script

    Definizione
    File scritto in un linguaggio di programmazione, generalmente Javascript o Typescript.
    Serve a svolgere azioni precise senza dipendere dal fattore di interpretazione di Claude
    Come si attiva
    Per convenzione, viene definito nella cartella .claude/scripts e viene invocato da skill, hook o agenti.
    Come lavora
    Viene eseguito da Claude tramite terminale
  6. Tool

    Definizione
    Una capacità operativa che Claude può utilizzare, come leggere un file, modificarlo, cercare nel codice o eseguire un comando nel terminale.
    Come si attiva
    Al momento del bisogno
    Come lavora
    Generalmente tramite terminale o come strumento di Claude Code
  7. MCP (Server)

    Definizione
    E’ una suite di strumenti codificati in linguaggi di programmazione che permettono l’uso di piattaforme esterne o semplicemente di lanciare logica applicativa.
    Come si attiva
    CC li usa in base al bisogno e alle richieste esplicite dell’utente.
    Come lavora
    Viene interrogato da Claude, fornisce la lista degli strumenti con nome e descrizione e una documentazione dell’intera suite.
    Claude studia il tutto e decide quali strumenti chiamare e in che ordine.
  8. Plugin

    Definizione
    Un pacchetto installabile che raccoglie una o più estensioni, come skill, subagent, hook e server MCP. Serve a distribuire e riutilizzare una suite di configurazioni e strumenti.
    Come si attiva
    Si installa, per esempio, con /plugin install nome-plugin@nome-marketplace.
    Come lavora
    La suite agisce in simbiosi con CC
  9. Marketplace

    Definizione
    Un catalogo attraverso cui scoprire e installare plugin. È il canale di distribuzione, non il plugin stesso.
    Come si attiva
    Nella chat CC digitare: /plugin marketplace add nome-marketplace
    Come lavora
    Claude Code ne legge il catalogo e rende disponibili i plugin per l’installazione. Aggiungere un marketplace non significa installare automaticamente tutti i plugin che contiene.
  10. Slash command

    Definizione
    Un comando che inizia con/. Può controllare la sessione, come /clear, oppure richiamare una skill disponibile.
    Come si attiva
    Nella chat CC digitare /
    Come lavora
    Dipende dal comando

1 / 10


File e cartelle principali

Nome Tipo Definizione Come si attiva Come lavora
CLAUDE.md File Un file Markdown con istruzioni e informazioni persistenti: convenzioni, struttura del progetto e comandi utili. Inseriscilo nella root del tuo progetto Entra nella context window all’avvio di ogni sessione.
SKILL.md File Il file principale di una skill: contiene metadati, descrizione e istruzioni. Può essere accompagnato da script, esempi e altri materiali. Va creata una cartella con il nome della skill sotto .claude/skills.
Es: .claude/skills/nome-skill/SKILL.md
Viene usata in automatico da Claude al momento del bisogno.
.claude Folder La cartella che raccoglie configurazioni ed estensioni di Claude Code. Creala nella root del tuo progetto Viene riconosciuta e usata da CC in automatico
~/.claude/settings.json File Le impostazioni globali dell’utente, applicate ai diversi progetti sulla stessa macchina. Crealo nella cartella .claude sotto la tua cartella utente.
Es: C:/Users/Alfredo/.claude/settings.json
Viene usato automaticamente ad ogni reload di CC.
.claude/settings.json File Le impostazioni del progetto, che possono essere versionate e condivise con il team. Crealo nella cartella .claude del tuo progetto.
Es. C:/prj-1/.claude/settings.json
Viene usato automaticamente ad ogni reload di CC. Ha la precedenza in caso di conflitto sul file globale, secondo le regole della singola opzione.
.claude/settings.local.json File Le impostazioni personali valide soltanto per quel progetto, pensate per restare fuori dal controllo di versione. Crealo nella cartella .claude del tuo progetto.
Es. C:/prj-1/.claude/settings.local.json
Viene usato automaticamente ad ogni reload di CC. Ha la precedenza in caso di conflitto sul file globale, secondo le regole della singola opzione.
.claude/skills/ Folder La cartella delle skill del progetto: ogni skill ha una propria sottocartella con il relativo SKILL.md Creala nella root del tuo progetto Viene usata da CC in caso di bisogno
.claude/agents/ Folder La cartella che contiene le definizioni dei subagent personalizzati del progetto. Creala nella root del tuo progetto Viene usata da CC in caso di bisogno
.claude/commands/ Folder Il percorso storico per definire comandi personalizzati in Markdown, ancora supportato. Le skill costituiscono oggi il meccanismo più completo per questi workflow. Creala nella root del tuo progetto Il contenuto del file viene usato come istruzione per Claude quando richiami il comando. Non viene eseguito direttamente come codice: è Claude a interpretare le istruzioni e a usare gli strumenti necessari.
~/.claude.json File Un file gestito da Claude Code per conservare stato e configurazioni interne, come informazioni di accesso e alcune configurazioni MCP. È distinto da settings.json Normalmente viene creato e gestito da Claude Code durante l’uso. Viene aggiornato di volta in volta con le nuove configurazioni globali dell’utente.
Non contiene proprio tutte le impostazioni globali: molte appartengono a ~/.claude/settings.json.
  1. CLAUDE.md

    Tipo
    File
    Definizione
    Un file Markdown con istruzioni e informazioni persistenti: convenzioni, struttura del progetto e comandi utili.
    Come si attiva
    Inseriscilo nella root del tuo progetto
    Come lavora
    Entra nella context window all’avvio di ogni sessione.
  2. SKILL.md

    Tipo
    File
    Definizione
    Il file principale di una skill: contiene metadati, descrizione e istruzioni. Può essere accompagnato da script, esempi e altri materiali.
    Come si attiva
    Va creata una cartella con il nome della skill sotto .claude/skills.
    Es: .claude/skills/nome-skill/SKILL.md
    Come lavora
    Viene usata in automatico da Claude al momento del bisogno.
  3. .claude

    Tipo
    Folder
    Definizione
    La cartella che raccoglie configurazioni ed estensioni di Claude Code.
    Come si attiva
    Creala nella root del tuo progetto
    Come lavora
    Viene riconosciuta e usata da CC in automatico
  4. ~/.claude/settings.json

    Tipo
    File
    Definizione
    Le impostazioni globali dell’utente, applicate ai diversi progetti sulla stessa macchina.
    Come si attiva
    Crealo nella cartella .claude sotto la tua cartella utente.
    Es: C:/Users/Alfredo/.claude/settings.json
    Come lavora
    Viene usato automaticamente ad ogni reload di CC.
  5. .claude/settings.json

    Tipo
    File
    Definizione
    Le impostazioni del progetto, che possono essere versionate e condivise con il team.
    Come si attiva
    Crealo nella cartella .claude del tuo progetto.
    Es. C:/prj-1/.claude/settings.json
    Come lavora
    Viene usato automaticamente ad ogni reload di CC. Ha la precedenza in caso di conflitto sul file globale, secondo le regole della singola opzione.
  6. .claude/settings.local.json

    Tipo
    File
    Definizione
    Le impostazioni personali valide soltanto per quel progetto, pensate per restare fuori dal controllo di versione.
    Come si attiva
    Crealo nella cartella .claude del tuo progetto.
    Es. C:/prj-1/.claude/settings.local.json
    Come lavora
    Viene usato automaticamente ad ogni reload di CC. Ha la precedenza in caso di conflitto sul file globale, secondo le regole della singola opzione.
  7. .claude/skills/

    Tipo
    Folder
    Definizione
    La cartella delle skill del progetto: ogni skill ha una propria sottocartella con il relativo SKILL.md
    Come si attiva
    Creala nella root del tuo progetto
    Come lavora
    Viene usata da CC in caso di bisogno
  8. .claude/agents/

    Tipo
    Folder
    Definizione
    La cartella che contiene le definizioni dei subagent personalizzati del progetto.
    Come si attiva
    Creala nella root del tuo progetto
    Come lavora
    Viene usata da CC in caso di bisogno
  9. .claude/commands/

    Tipo
    Folder
    Definizione
    Il percorso storico per definire comandi personalizzati in Markdown, ancora supportato. Le skill costituiscono oggi il meccanismo più completo per questi workflow.
    Come si attiva
    Creala nella root del tuo progetto
    Come lavora
    Il contenuto del file viene usato come istruzione per Claude quando richiami il comando. Non viene eseguito direttamente come codice: è Claude a interpretare le istruzioni e a usare gli strumenti necessari.
  10. ~/.claude.json

    Tipo
    File
    Definizione
    Un file gestito da Claude Code per conservare stato e configurazioni interne, come informazioni di accesso e alcune configurazioni MCP. È distinto da settings.json
    Come si attiva
    Normalmente viene creato e gestito da Claude Code durante l’uso.
    Come lavora
    Viene aggiornato di volta in volta con le nuove configurazioni globali dell’utente.
    Non contiene proprio tutte le impostazioni globali: molte appartengono a ~/.claude/settings.json.

1 / 10


Contesto e memoria

Nome Definizione Hints & Tips
Sessione Una conversazione di lavoro con Claude Code, con una propria cronologia e un proprio contesto. Può essere ripresa successivamente. Con il comando da terminale claude --resume è possibile trovare lo storico delle sessioni avvenute in una determinata cartella per l’utente in uso
Contesto L’insieme delle informazioni disponibili al modello in un dato momento: istruzioni, messaggi, contenuti letti e risultati degli strumenti. N/A
Context window La quantità massima di informazioni che il modello può elaborare contemporaneamente, misurata in token. E’ la somma dei token in input (prompt, skill e altro testo di configurazione) + output.

Più una context window si riempie, più l’LLM fa fatica a garantire una buona qualità dell’output.
Token Un’unità con cui il modello rappresenta e misura il testo. Generalmente un token è una porzione di una parola, simile alla divisione in sillabe. Serve a conteggiare contesto, utilizzo e, quando previsto, costi API. I token in output costano di solito almeno il triplo dei token in input.
Compaction La sintesi della conversazione per liberare spazio nel contesto mantenendo le informazioni rilevanti. Si può richiedere con/compact. Una best practice è quella di non affidarsi troppo a questo metodo di sfoltimento della context window.
E’ preferibile piuttosto:
• far salvare a Claude le informazioni rilevanti in uno o più file Markdown
• usare il comando /clear per azzerare la context window
• indicare a Claude di usare le informazioni contenute nei Markdown come base per continuare il lavoro
  1. Sessione

    Definizione
    Una conversazione di lavoro con Claude Code, con una propria cronologia e un proprio contesto. Può essere ripresa successivamente.
    Hints & Tips
    Con il comando da terminale claude --resume è possibile trovare lo storico delle sessioni avvenute in una determinata cartella per l’utente in uso
  2. Contesto

    Definizione
    L’insieme delle informazioni disponibili al modello in un dato momento: istruzioni, messaggi, contenuti letti e risultati degli strumenti.
    Hints & Tips
    N/A
  3. Context window

    Definizione
    La quantità massima di informazioni che il modello può elaborare contemporaneamente, misurata in token.
    Hints & Tips
    E’ la somma dei token in input (prompt, skill e altro testo di configurazione) + output.

    Più una context window si riempie, più l’LLM fa fatica a garantire una buona qualità dell’output.
  4. Token

    Definizione
    Un’unità con cui il modello rappresenta e misura il testo. Generalmente un token è una porzione di una parola, simile alla divisione in sillabe. Serve a conteggiare contesto, utilizzo e, quando previsto, costi API.
    Hints & Tips
    I token in output costano di solito almeno il triplo dei token in input.
  5. Compaction

    Definizione
    La sintesi della conversazione per liberare spazio nel contesto mantenendo le informazioni rilevanti. Si può richiedere con/compact.
    Hints & Tips
    Una best practice è quella di non affidarsi troppo a questo metodo di sfoltimento della context window.
    E’ preferibile piuttosto:
    • far salvare a Claude le informazioni rilevanti in uno o più file Markdown
    • usare il comando /clear per azzerare la context window
    • indicare a Claude di usare le informazioni contenute nei Markdown come base per continuare il lavoro

1 / 5


Questo è quanto.

Spero di averti chiarito un po’ le idee. Ho cercato di rendere i concetti quanto più possibile diretti e sintetici.

Se senti ancora di avere difficoltà: prova ad applicare queste nozioni man mano, facendo pratica con l’interfaccia di Claude Code e fermandoti su un concetto alla volta.

Son sicuro che in poco tempo ti renderai conto che non era poi così difficile.

Un abbraccio e buon coding!