Claude Code: Skill, CLAUDE.md e MCP - la Guida Completa per Iniziare

Aggiornato: aprile 2026 - Gaetano Castaldo, consulente AI e digital transformation, certificato Salesforce Architect.

Claude Code è l'interfaccia a riga di comando di Anthropic per usare Claude direttamente nel terminale, integrata con l'ambiente di sviluppo. Non è un editor con un chatbot aggiunto: è un agente AI che legge il progetto, esegue comandi, scrive codice e lavora in loop autonomi. Può essere configurato per ricordare il contesto di ogni progetto, eseguire comportamenti ripetibili su richiesta e connettersi a strumenti esterni in tempo reale.

Quello che distingue Claude Code dagli altri AI assistant non è il modello, ma tre meccanismi che la maggior parte degli utenti non configura: le skill, il file CLAUDE.md e i server MCP. Questa guida spiega cosa fa ciascuno e dove trovare le guide specifiche per usarli bene.

Cos'è Claude Code e Come Funziona

Con un AI assistant generico, ogni conversazione parte da zero: devi rispiegare il progetto, le convenzioni, lo stack tecnico. Il risultato dipende da quanto bene hai scritto il prompt al volo.

Claude Code funziona al contrario. Puoi definire una volta il contesto (chi sei, cos'è il progetto, come lavori) e Claude lo ricarica automaticamente ogni sessione. Puoi creare comportamenti ripetibili e precisi. Puoi connettere Claude ai tuoi strumenti aziendali.

I tre meccanismi che rendono tutto questo possibile:

CLAUDE.md: il File che Sostituisce le Istruzioni Ripetute

Ogni volta che apri una sessione con Claude Code, il file CLAUDE.md viene caricato automaticamente, senza che tu lo chieda. Contiene tutto quello che Claude deve sapere prima di iniziare: stack tecnico, convenzioni di naming, file critici, workflow di deploy, regole di comunicazione.

Un CLAUDE.md ben strutturato fa tre cose: elimina le istruzioni ripetute, rende il comportamento di Claude coerente tra sessioni, e diventa documentazione utile anche per i developer umani del team. Nei progetti Castaldo Solutions, un CLAUDE.md ben scritto riduce il tempo di allineamento a zero tra una sessione e l'altra.

Regola pratica: se ti ritrovi a spiegare la stessa cosa a Claude due volte in sessioni diverse, quella cosa va nel CLAUDE.md.

Dove approfondire: CLAUDE.md: come scrivere istruzioni che cambiano davvero il comportamento di Claude - struttura, sezioni, esempi reali e cosa evitare.

Cosa Sono le Skill di Claude Code

Una skill è una cartella con un file SKILL.md al centro. Contiene istruzioni strutturate, riferimenti ed esempi: tutto il necessario perché Claude esegua un task specifico con precisione costante. Si attiva con un comando tipo /new-article o /deploy.

La differenza rispetto a un prompt in chat: è modulare (il contesto arriva solo quando serve), condivisibile (vive in git, tutti i dev del team la usano identica), e versionabile (cambi la skill, cambi il comportamento). Nel 2025 OpenAI ha adottato lo stesso standard in ChatGPT e Codex CLI, con la struttura /home/oai/skills che rispecchia esattamente il formato Anthropic.

Dove approfondire:

• Cosa sono le skill di Claude Code e come funzionano - introduzione per chi parte da zero, con esempi concreti
• Come creare una skill per Claude Code: guida pratica - struttura, scrittura e test di una skill da zero
• Le 8 skill che mi hanno cambiato il lavoro (e una da evitare) - skill reali dal workflow quotidiano, con la ricerca sul context rot
• Skill Claude Code: best practices per scriverle e mantenerle - come affinare le skill nel tempo e evitare gli errori comuni

Cosa Sono i Server MCP e Come si Usano con Claude

I server MCP (Model Context Protocol) permettono a Claude di accedere a strumenti esterni in tempo reale durante la conversazione: CRM, database, calendari, gestionali, API aziendali. Il protocollo, pubblicato da Anthropic nell'ottobre 2024, è stato adottato in pochi mesi da OpenAI, Google DeepMind e Microsoft.

Il risultato pratico: invece di esportare dati, aprire dashboard e copiare numeri in chat, parli con Claude in italiano e lui interroga il sistema direttamente.

Dove approfondire:

• MCP Server: cosa sono e perché cambiano tutto per le PMI - spiegazione completa del protocollo, casi d'uso per reparto e guida all'adozione
• Come abbiamo costruito un MCP Server per VTENext CRM con Claude - caso reale di integrazione su un CRM italiano

Come Strutturare un Progetto Claude Code in VSCode

Skill, CLAUDE.md e MCP funzionano bene solo se il progetto è strutturato correttamente. La cartella .claude/, il file .mcp.json, gli hook: ogni elemento va nel posto giusto o Claude non lo trova.

In rete circolano infografiche con errori nei nomi di file (.mcp.jason, .cl Claude/) che portano a configurazioni rotte silenziosamente. La guida qui sotto usa la struttura corretta, verificata su progetti reali, e spiega cosa serve davvero vs cosa è opzionale.

Dove approfondire: Come strutturare un progetto Claude Code in VSCode - guida pratica con cartelle, file e spiegazione di ogni componente.

Da Dove Partire in Base al Tuo Livello

Se non hai mai usato Claude Code: Inizia da cosa sono le skill, poi passa a come strutturare il progetto.

Se usi Claude Code ma in modo informale: Leggi prima CLAUDE.md - è il cambio che senti subito. Poi le 8 skill dal workflow reale per capire cosa automatizzare.

Se stai valutando l'integrazione con sistemi aziendali: Parti dagli MCP Server e dal caso VTENext.

Domande Frequenti su Claude Code

Cos'è Claude Code? Claude Code è l'interfaccia CLI di Anthropic che permette di usare Claude direttamente nel terminale, integrata con l'ambiente di sviluppo. A differenza di un chatbot, opera come agente autonomo: legge il progetto, esegue comandi, scrive e modifica codice.

Qual è la differenza tra Claude Code e Claude.ai? Claude.ai è l'interfaccia web conversazionale. Claude Code è lo strumento da terminale per sviluppatori: ha accesso al filesystem locale, può eseguire comandi, leggere l'intero codebase e operare in loop autonomi senza supervisione continua.

Cosa sono le skill di Claude Code? Le skill sono moduli di comportamento riproducibili: cartelle con un file SKILL.md che contiene istruzioni strutturate per un task specifico. Si attivano con un comando slash (/deploy, /new-article). Permettono di standardizzare workflow ripetitivi e condividerli tra i membri del team via git.

A cosa serve il file CLAUDE.md? CLAUDE.md è il file di configurazione che Claude legge automaticamente all'inizio di ogni sessione. Contiene il contesto del progetto: stack tecnico, convenzioni, file critici, regole di comportamento. Sostituisce le istruzioni ripetute e rende il comportamento di Claude coerente tra sessioni diverse.

Cos'è un MCP server per Claude? Un MCP (Model Context Protocol) server è un intermediario che permette a Claude di connettersi a strumenti esterni in tempo reale: CRM, database, calendari, API aziendali. Invece di copiare dati in chat, Claude li recupera e li elabora direttamente durante la conversazione.

Claude Code funziona su Windows? Sì. Claude Code funziona su Windows, macOS e Linux. Su Windows si usa tipicamente con Git Bash o WSL per mantenere la sintassi Unix nei comandi.

Vuoi Portare Claude Code nel Tuo Team?

Configurare Claude Code bene la prima volta richiede tempo, ma i risultati sul workflow del team si vedono subito. Se vuoi farlo senza passare settimane a sperimentare, parliamo: possiamo impostare la configurazione ottimale per il tuo stack in pochi giorni.