Una lezione completa su "Claude Code" alla portata di uno studente delle medie

Claude Code può sembrare difficile a prima vista.

Termini come Terminal, MCP, hook, Skills e API arrivano tutti insieme, ed è facile perdersi nella prima ora.

In questo articolo, organizzerò Claude Code come una "lezione in cui un insegnante spiega a due studenti delle medie."

Alla fine, capirete l'ordine in cui imparare le operazioni di base, le integrazioni esterne, Skills, memoria, hook, MCP e le API.

L'immagine di copertina è stata generata dall'AI. Il prompt è disponibile in questo articolo.

Claude Code è un "AI che agisce", non solo un "AI che risponde"

Claude Code non si limita a rispondere alle domande; è un AI che esegue compiti all'interno del tuo computer.

Nei documenti ufficiali, viene descritto come uno strumento di sviluppo di tipo agente in grado di modificare file, eseguire comandi, gestire operazioni git e integrarsi con MCP.

Una volta compreso questo, tutte le funzioni si collegano.

L'insegnante ha scritto questo sulla lavagna:

"Chat AI è un insegnante che dà consigli. Claude Code è un capoclasse che lavora insieme a te in classe."

Mina chiede:

"Quindi Claude Code è solo per chi sa programmare?"

L'insegnante scuote la testa.

"All'inizio è diventato famoso come strumento per scrivere codice. Ma la sua essenza è un AI che legge cartelle, corregge file ed esegue procedure. Può essere usato per scrivere, creare documenti, pagine web, appunti di ricerca e materiali didattici."

Ren dice:

"Quindi invece di dire a ChatGPT 'scrivi un tema', posso dire a Claude Code 'guarda questa cartella, correggila e controllala'."

Esatto.

Quando si insegna Claude Code, queste tre categorie sono sufficienti per iniziare:

• Leggi
• Correggi
• Controlla

Per esempio, se l'insegnante tiene una lezione su come creare una pagina web per la festa della scuola, chiederebbe a Claude Code così.

La cosa importante qui è non chiedere all'AI solo una "risposta". Dai a Claude Code una sequenza di compiti.

Indice

• Claude Code è un "AI che agisce", non solo un "AI che risponde"
• Operazioni di base: "Richiedi, Conferma, Correggi"
• Memoria: Il foglio dei passaggi di consegna dell'insegnante
• Skills: Le carte delle mosse speciali
• Hook: La campanella e l'agente di pattuglia
• MCP: Il pullman della gita scolastica
• API e SDK: Come usare Claude Code come componente
• Un menù di pratica di 30 minuti per iniziare

Operazioni di base: "Richiedi, Conferma, Correggi"

Le basi di Claude Code prevedono un flusso di richiesta, conferma e correzione.

Più che memorizzare comandi difficili, migliorerai più velocemente imparando questo schema conversazionale.

All'inizio, usalo con l'idea di "correggere insieme" piuttosto che "completare in un colpo solo."

L'insegnante ha dato ai due studenti il primo schema.

Mina dice con un'espressione sollevata:

"Avevo paura che cambiasse tutto all'improvviso. Devo solo fargli proporre le cose prima."

L'insegnante risponde:

"Sì. È più sicuro creare punti di conferma piuttosto che lasciare che Claude Code lavori da solo."

L'uso di base consiste in questi cinque punti:

• claude per avviare il dialogo
• claude "richiesta" per passare la richiesta iniziale
• claude -p "richiesta" per un'esecuzione una tantum non interattiva
• /help per controllare i comandi disponibili
• /status per controllare lo stato

Tuttavia, non è necessario insegnare tutto a studenti delle medie fin dall'inizio. Nella prima lezione, basta aprire claude e dire una frase.

Ren dice:

"Se la prima parola è solo questa, non fa paura."

L'insegnante continua:

"Esatto. Puoi usare Claude Code mentre gli chiedi come si usa. Se non capisci, chiedi come usarlo."

L'obiettivo delle operazioni di base non è memorizzare comandi. È che l'umano decida l'ambito di ciò da lasciare all'AI.

Memoria: Il foglio dei passaggi di consegna dell'insegnante

La memoria è un posto dove scrivere le premesse che vuoi che Claude Code legga ogni volta.

Nei documenti ufficiali, viene spiegato come un sistema per usare diversi file di istruzioni per utenti o progetti. In un contesto di classe, è come un foglio di passaggio di consegne tra insegnanti.

L'insegnante ha scritto CLAUDE.md sulla lavagna.

Mina chiede:

"Cos'è?"

L'insegnante risponde:

"È il regolamento di classe che Claude Code legge prima di iniziare a lavorare."

Per un progetto sulla festa della scuola, potresti scriverlo così.

Ren dice:

"Quindi non devo dirlo ogni volta."

L'insegnante annuisce.

"Esatto. Se spieghi la stessa cosa ogni volta, mettila nella Memoria."

Le informazioni adatte alla Memoria includono:

• Obiettivi del progetto
• Regole per lo stile di scrittura o il design
• Comandi usati frequentemente
• File che non devono essere toccati

Al contrario, alcune informazioni non sono adatte alla Memoria:

• Richieste valide solo per oggi
• Idee non confermate
• Password o chiavi API
• Informazioni personali

Se insegni a uno studente delle medie, puoi spiegarlo così:

"La Memoria non è una magia per rendere l'AI più intelligente. È un quaderno per le regole che non vuoi che dimentichi ogni volta."

Questa spiegazione è sufficiente.

Skills: Le carte delle mosse speciali

Le Skills sono procedure di lavoro usate frequentemente trasformate in un formato richiamabile.

Nei documenti ufficiali, vengono spiegate come un sistema incentrato su SKILL.md che organizza template, esempi, script e materiali di riferimento. In una classe, sono come le carte delle mosse speciali che tiri fuori solo quando necessario.

L'insegnante ha disegnato tre carte:

• Correzione del tema
• Creazione della pagina per la festa della scuola
• Creazione del test di vocabolario inglese

Mina chiede:

"In cosa è diverso da una raccolta di prompt?"

L'insegnante risponde:

"Una raccolta di prompt è un foglio che incolli ogni volta. Le Skills sono carte che tieni nella cassetta degli attrezzi di Claude Code."

La struttura base di una Skill è questa:

In SKILL.md, scrivi quando usarla, cosa fare e cosa leggere. Claude Code può usare automaticamente una Skill adatta alla conversazione, oppure l'utente può chiamarla usando /nome-skill.

Ren dice:

"Quindi posso trasformare in Skill le regole di correzione che l'insegnante usa sempre."

Esatto.

Per una Skill di correzione del tema, la progetteresti così.

La cosa importante qui è non trasformare tutto in una Skill. Per una richiesta una tantum, basta chiedere sul momento.

I compiti che dovrebbero diventare Skill soddisfano questi criteri:

• Si ripetono molte volte
• Hanno una procedura fissa
• Hanno criteri di valutazione
• Hanno materiali di riferimento o template
• La qualità tende a variare a seconda della persona

L'insegnante ha detto infine:

"Le Skills non aggiungono talento all'AI. Trasformano le procedure umane in un formato riutilizzabile."

Visita anche il sito Claude Code Dictionary.

Hook: La campanella e l'agente di pattuglia

Gli hook sono meccanismi che vengono eseguiti automaticamente prima o dopo il lavoro di Claude Code.

Nei documenti ufficiali, vengono spiegati come impostazioni per eseguire comandi o processi in base a eventi specifici come PreToolUse o PostToolUse. In una classe, sono la campanella e l'agente di pattuglia.

Mina chiede:

"Una campanella?"

L'insegnante risponde:

"Sì. Suona prima che inizi la lezione. Suona prima della consegna. Ti ferma se provi ad andare in un posto pericoloso. Ecco cosa sono gli hook."

Per esempio, prima che Claude Code riscriva un file, può eseguire un pattugliamento come questo:

• Sta cercando di toccare .env?
• Sta cercando di rompere file di configurazione importanti?
• Dovrebbe eseguire i test dopo la riscrittura?
• Dovrebbe formattare il testo?
• Dovrebbe lasciare un log?

Gli occhi di Ren brillano:

"Quindi puoi fermare l'AI quando sta per fare un errore!"

L'insegnante dice con un tono un po' severo:

"Tuttavia, gli hook sono strumenti potenti. Poiché possono eseguire automaticamente comandi shell, sono pericolosi se aggiunti senza capirli."

Quando spieghi gli hook a studenti delle medie, non è necessario che scrivano le impostazioni all'inizio. Insegna solo i ruoli:

Prima del lavoro: Ferma le operazioni pericolose. Dopo il lavoro: Esegui test o controlli. Al completamento: Controlla le attività non finite.

In pratica, introducili in quest'ordine:

• Prima, controlla manualmente.
• Se lo stesso controllo appare molte volte, trasformalo in una checklist.
• Una volta che la checklist è stabile, trasformala in un hook.

Non automatizzare all'improvviso. Se automatizzi un controllo che un umano non capisce, anche il fallimento verrà automatizzato.

L'insegnante ha scritto sulla lavagna:

"Gli hook non sono robot comodi; sono agenti di pattuglia che seguono le regole che hai impostato."

MCP: Il pullman della gita scolastica

MCP (Model Context Protocol) è un meccanismo per collegare Claude Code a servizi e dati esterni.

Nei documenti ufficiali, MCP viene spiegato come uno standard aperto per collegare strumenti AI con fonti di dati esterne. In una classe, è il pullman della gita scolastica per uscire dall'aula.

L'insegnante ha disegnato un'immagine dell'aula. Fuori, ha disegnato la biblioteca, la sala insegnanti, il municipio e un museo.

Ren dice:

"Claude Code può uscire dall'aula?"

L'insegnante risponde:

"Questa è l'idea. Quando connetti MCP, Claude Code può accedere a informazioni esterne come GitHub, Sentry, PostgreSQL, Slack, Google Drive e Figma."

Ovviamente, non gli lasci vedere tutto liberamente. Decidi tu il server di connessione, l'autenticazione e i permessi.

Nelle impostazioni MCP di Claude Code, puoi aggiungere server HTTP o server stdio in esecuzione locale.

Mina dice preoccupata:

"Connettersi all'esterno è un po' spaventoso."

L'insegnante risponde:

"Questa sensazione è corretta. MCP è comodo, ma più connetti, più informazioni può toccare. Quindi, inizia con sola lettura."

L'ordine per insegnare MCP è il seguente:

• Prima, usa solo file locali.
• Poi, connettiti a dati di sola lettura sicuri.
• Dopo, connettiti a GitHub o alla gestione dei ticket.
• Infine, considera la scrittura o i dati di produzione.

Il valore di MCP non è che l'AI diventa più intelligente. È che l'AI può andare a prendere da sola i materiali necessari per il lavoro.

L'insegnante riassume:

"MCP è il pullman che mostra all'AI il mondo esterno. Tuttavia, l'insegnante decide dove è permesso andare."

API e SDK: Come usare Claude Code come componente

API (Application Programming Interface) e SDK (Software Development Kit) sono modi per incorporare Claude Code in app o processi automatizzati.

Nei documenti ufficiali, l'SDK di Claude Code viene spiegato come un sistema che può essere usato da CLI, TypeScript e Python. In una classe, è un modo per far partecipare il capoclasse al lavoro fuori dall'aula.

Ren chiede:

"Cosa sono le API?"

L'insegnante risponde:

"Invece di un umano che parla su uno schermo, è l'ingresso per chiedere a Claude Code di fare lavori da un programma."

Per esempio, l'uso normale è così. Un umano chiede una volta dal terminale.

Usando l'SDK, puoi chiamare Claude Code all'interno di un'app o di un processo batch. L'SDK Python è fornito come claude-code-sdk, ed è disponibile anche un SDK TypeScript.

Mina chiede:

"È una cosa che i principianti dovrebbero fare subito?"

L'insegnante risponde:

"No. Non è una cosa da fare subito."

API e SDK vengono usati nelle seguenti fasi:

• Quando vuoi eseguire automaticamente lo stesso compito ogni giorno.
• Quando vuoi assistere a revisioni o test in CI.
• Quando vuoi chiamare Claude Code da strumenti interni.
• Quando vuoi eseguire più processi in parallelo.
• Quando vuoi ricevere i risultati in JSON.

Per gli studenti delle medie, è così:

"Chiedere al capoclasse a mano è la base di Claude Code. Inviare richieste automaticamente dalla sala di regia sono le API e l'SDK."

È comodo, ma usarlo dall'inizio causa confusione. L'ordine è: Base, Memoria, Skills, MCP, hook e poi API.

Un menù di pratica di 30 minuti per iniziare

Non devi imparare tutto su Claude Code subito.

Se restringi cosa fare nei primi 30 minuti, la paura scompare. Quando insegni a studenti delle medie, crea prima piccole esperienze di successo.

L'insegnante ha infine presentato un menù di lezione di 30 minuti.

Mina dice:

"Penso di poterlo fare in classe!"

Ren dice:

"Quindi MCP e hook possono venire dopo."

L'insegnante risponde:

"Sì. L'ordine è importante. Se vai direttamente all'integrazione esterna o all'esecuzione automatica, non saprai cosa sta succedendo."

I primi tre obiettivi sono:

• Fai spiegare a Claude Code una cartella.
• Fagli correggere un piccolo file.
• Fagli spiegare il motivo della correzione.

Se riesci a fare solo questo, hai colto l'essenza di Claude Code. Dopo, procedi in base alle tue esigenze:

• Se spiegare la stessa cosa ogni volta è una seccatura: Memoria.
• Se fare lo stesso compito ogni volta: Skills.
• Se vuoi mostrare materiali esterni: MCP.
• Se vuoi automatizzare i controlli: hook.
• Se vuoi integrarlo in un sistema: API e SDK.

Claude Code non è uno strumento per memorizzare funzioni. È uno strumento per sviluppare come consegnare il lavoro.

L'insegnante ha detto infine:

"Le persone che sanno usare l'AI non sono quelle che sono esperte di AI. Sono persone che sanno dividere il lavoro, consegnare le regole ed eseguire controlli."

Questa è la conclusione più importante quando si insegna Claude Code a studenti delle medie.

Articoli correlati

[Principianti OK] Supporto individuale Claude Code

*I posti early bird per le prime 10 persone sono esauriti.

Design Pattern di Claude Code

~Struttura delle cartelle, Skills, database e flussi di generazione contenuti completamente rivelati~

Richieste, consulenze individuali e richieste di formazione aziendale:

https://kawai-official.pages.dev/