Glossario Claude Code
Tutto quello che ti serve conoscere per iniziare ad usare il più famoso AI coding tool del mercato
- #claude
- #code
- #claude-code
- #ai
- #gen-ai
- #glossario
- #coding
- #vibe
- #vibe-coding
- #concetti-chiave
- #concetti
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 / 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 / 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 / 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!