Concetti

Claude Code ti permette di estendere l’assistente con sei tipi di oggetti. Hanno nomi simili e appaiono in sezioni diverse di CLACOROO, quindi vale la pena fissare il vocabolario.

Questa pagina è il glossario. La sezione Funzionalità è dove agisci su ognuno di questi oggetti.

I sei oggetti

marketplace  →  plugin  →  ┬→  skill
                           ├→  agent
                           ├→  server MCP
                           └→  hook

Si legge dall’alto in basso: un marketplace distribuisce plugin; ogni plugin può contenere una combinazione di skill, agent, server MCP e hook. CLACOROO ha una sezione di sidebar per ogni casella.

Marketplace

Un marketplace è la sorgente da cui installi i plugin. In pratica, un marketplace è un repository Git (o una cartella locale) con un manifest marketplace.json che dichiara quali plugin sono disponibili.

Aggiungi un marketplace una volta; ti espone un catalogo di plugin che puoi installare. Puoi anche rimuoverlo quando non vuoi più nessuno dei suoi plugin.

Esempi:

• Un repo di un’organizzazione ufficiale con plugin verificati
• Il tuo marketplace privato con plugin interni
• Una cartella locale con plugin sperimentali che stai testando

Sezione CLACOROO: Marketplace.

Plugin

Un plugin è un’unità di estensione che installi in Claude Code. Ogni plugin può fornire una combinazione di:

• Skill (conoscenza)
• Agent (assistenti specializzati)
• server MCP (integrazioni esterne)
• Hook (script che girano su eventi)

I plugin si installano da un marketplace e vivono nella tua config Claude Code. Possono essere attivati o disattivati globalmente, o scopati a un progetto se vuoi un plugin solo in una cartella specifica.

Quando installi un plugin, tutte le quattro cose che contiene diventano disponibili e appaiono nelle loro rispettive sezioni di sidebar in CLACOROO.

Sezione CLACOROO: Plugin.

Skill

Una skill è un pezzo di contesto che Claude Code carica su richiesta. Concretamente, una skill è un file Markdown con una descrizione di quando si applica — quando tu (o un altro tool) menzioni qualcosa che matcha, Claude Code aggiunge il contenuto della skill al prompt.

Le skill sono passive: non eseguono codice, non hanno tool. Insegnano all’assistente come pensare su un argomento specifico (scrivere una migration SQL, formattare JSON per un’API specifica, seguire una style guide, …).

Sezione CLACOROO: Skill — esplora, anteprima, copia il pattern di trigger, edita.

Agent

Un agent è un assistente specializzato a cui Claude Code può delegare. Un agent ha i suoi:

• System prompt (le istruzioni con cui parte)
• Lista di tool (Bash, Edit, Read, Write, WebFetch, …)
• Scope (il tipo di task che gestisce)

Tu lanci un agent esplicitamente (con /agent-name o simile) quando vuoi un comportamento specializzato — tipo “comportati come code reviewer”, “scrivi le release notes”, “fai un audit accessibilità”.

Gli agent sono attivi: girano, chiamano tool, producono risultati.

Sezione CLACOROO: Agent — esplora, leggi il comando di lancio, vedi quali tool hanno.

Server MCP

Un server Model Context Protocol (MCP) è il ponte tra Claude Code e uno strumento esterno. Attraverso un server MCP, l’assistente può interrogare un database, raggiungere una API, cercare in un indice di documentazione, fare una ricerca su un vector store — qualsiasi cosa il server sia configurato per fare.

I server MCP usano tre transport:

• http — request/response HTTPS
• sse — server-sent events (HTTP streaming)
• stdio — sottoprocesso locale con cui CLACOROO comunica via standard input/output

Sezione CLACOROO: Server MCP — vedi lo stato (Connesso · Auth richiesta · Errore), aggiungi/rimuovi server aggiunti dall’utente.

Hook

Un hook è uno script che Claude Code esegue in un momento specifico. I plugin dichiarano hook per aggiungere comportamento a eventi come:

• PreToolUse — prima che un tool parta
• PostToolUse — dopo che un tool finisce
• UserPromptSubmit — quando invii un messaggio
• SessionStart — all’inizio della sessione
• Stop — quando l’assistente si ferma

Gli hook sono automatici — non li invochi tu. Si attivano sui loro eventi, eseguono il loro comando, e (se sono ben scritti) migliorano in silenzio il tuo flusso di lavoro.

Sezione CLACOROO: Hook — vedi ogni hook raggruppato per evento, con plugin e dipendenze CLI.

In sintesi

Oggetto	Cos’è	Come si attiva	Sezione CLACOROO
Marketplace	La sorgente dei plugin	Lo aggiungi tu	Marketplace
Plugin	L’unità installabile	Lo installi/attivi/disattivi tu	Plugin
Skill	Un file di contesto su richiesta	Pattern match nella conversazione	Skill
Agent	Un assistente specializzato	Lo lanci tu esplicitamente	Agent
Server MCP	Un ponte verso un tool esterno	Claude Code lo usa quando serve	Server MCP
Hook	Uno script eseguito su un evento	Si attiva da solo sul suo evento	Hook

Due cose in più da sapere

Scope

I plugin (e i server MCP) possono essere scopati:

• Globale — attivo in ogni sessione Claude Code
• Progetto — attivo solo dentro una cartella specifica
• Locale — stessa idea, in alcuni posti usato come sinonimo di progetto

CLACOROO mostra lo scope come badge su ogni card e ti permette di filtrarci.

Dove vive tutto su disco

Tutta la tua configurazione Claude Code sta su disco in file in chiaro, principalmente in:

• ~/.claude/ (macOS, Linux)
• %APPDATA%\Claude\ (Windows)

CLACOROO legge da lì e scrive solo i file che deve (principalmente settings.json). Il resto è mediato dai comandi claude ....

Dove andare adesso

• Plugin — la sezione di lavoro: attiva, disattiva, aggiorna, rimuovi
• Server MCP — configura la tua prima integrazione
• Hook — scopri cosa parte quando e da cosa dipende
• Quick start — il tour di cinque minuti che trasforma questi concetti in azioni