Glossario

Questo glossario definisce la terminologia di Claude Code. Ogni voce rimanda alla pagina dove il concetto è trattato in profondità. Per i concetti a livello di modello come tokens, temperature e RAG, consulta il glossario della piattaforma.

​

A

​

Agent teams

Più sessioni indipendenti di Claude Code coordinate da un team lead, con un elenco di attività condiviso e messaggistica peer-to-peer. A differenza dei subagents, che vengono eseguiti all’interno di una singola sessione e riferiscono solo al genitore, i compagni di squadra hanno ciascuno la propria finestra di contesto e puoi interagire direttamente con uno qualsiasi di loro. Agent teams è sperimentale e deve essere abilitato impostando CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1. Scopri di più: Run agent teams

​

Agentic coding

Un flusso di lavoro in cui l’IA può leggere file, eseguire comandi e apportare modifiche autonomamente mentre tu osservi, reindizzi o ti allontani, a differenza degli assistenti basati su chat che rispondono solo con testo che devi applicare tu stesso. Claude Code è agentic perché ha tools che gli permettono di agire, non solo di consigliare. Scopri di più: How Claude Code works

​

Agentic harness

Gli strumenti, la gestione del contesto e l’ambiente di esecuzione che trasformano un modello di linguaggio in un agente di codifica capace. Claude Code è l’harness; Claude è il modello al suo interno. L’harness fornisce accesso ai file, esecuzione shell, gating delle autorizzazioni, caricamento della memoria e il loop che concatena le azioni insieme. Scopri di più: How Claude Code works

​

Agentic loop

Il ciclo che Claude attraversa per ogni attività: raccogliere contesto, intraprendere un’azione, verificare i risultati e ripetere fino al completamento. Ogni utilizzo di uno strumento restituisce informazioni che informano il passo successivo. Puoi interrompere il loop in qualsiasi momento per reindirizzare. La maggior parte dei punti di estensione, inclusi hooks, skills e MCP, si collegano a fasi specifiche di questo loop. Scopri di più: How Claude Code works

​

Auto memory

Note che Claude scrive per se stesso in base alle tue correzioni e preferenze, archiviate per repository git in ~/.claude/projects/. Tutti i worktrees dello stesso repository condividono una directory di auto memory. Le prime 200 righe o 25 KB dell’indice MEMORY.md si caricano all’inizio di ogni sessione. Auto memory è la controparte scritta da Claude di CLAUDE.md, che scrivi tu. Scopri di più: Auto memory

​

Auto mode

Una permission mode in cui un modello classificatore separato esamina ogni azione in background invece di mostrarti prompt di approvazione. Il classificatore blocca l’escalation dell’ambito, l’infrastruttura non attendibile e l’prompt injection. Non vede mai i risultati degli strumenti, quindi le istruzioni iniettate non possono influenzare le sue decisioni. Auto mode è un’anteprima di ricerca disponibile su piani Max, Team, Enterprise e API. Scopri di più: Eliminate prompts with auto mode

​

B

​

Bare mode

Un flag di avvio, --bare, che salta l’auto-discovery di hooks, skills, plugins, server MCP, auto memory e CLAUDE.md. Solo i flag che passi esplicitamente hanno effetto. Consigliato per CI e chiamate con script dove hai bisogno di un comportamento identico tra le macchine indipendentemente dalla configurazione locale. Scopri di più: Start faster with bare mode

​

Bundled skills

Playbook basati su prompt inclusi con Claude Code, come /batch, /simplify, /debug e /loop. A differenza dei comandi built-in, che eseguono logica fissa, le bundled skills danno a Claude un prompt dettagliato e gli permettono di orchestrare il lavoro, quindi possono generare agenti, leggere file e adattarsi al tuo codebase. Scopri di più: Bundled skills

​

C

​

Channel

Un server MCP che invia eventi nella tua sessione in esecuzione in modo che Claude possa reagire a cose che accadono mentre sei lontano dal terminale. I canali possono essere bidirezionali: Claude legge un evento in entrata e risponde attraverso lo stesso canale. Telegram, Discord e iMessage sono inclusi nell’anteprima di ricerca. Scopri di più: Channels

​

Checkpoint

Uno snapshot automatico del tuo codice acquisito prima di ogni modifica che Claude apporta. Premi Esc due volte o esegui /rewind per ripristinare il codice, la conversazione o entrambi a un punto precedente. I checkpoint sono locali alla sessione, separati da git e non traccia le modifiche apportate tramite lo strumento Bash. Scopri di più: Checkpointing

​

.claude directory

La directory da cui Claude Code legge la configurazione con ambito di progetto: impostazioni, hooks, skills, subagents, regole e auto memory. Un progetto ha .claude/ alla sua radice; i tuoi valori predefiniti a livello di utente sono in ~/.claude/. Scopri di più: The .claude directory

​

CLAUDE.md

Un file markdown di istruzioni persistenti che scrivi per Claude, caricato all’inizio di ogni sessione come messaggio utente dopo il prompt di sistema. Metti qui le convenzioni di progetto, le note sull’architettura e le regole “fai sempre X”. CLAUDE.md sopravvive alla compaction e viene riletto fresco dal disco in seguito. Puoi posizionare CLAUDE.md a livello di progetto in ./CLAUDE.md o ./.claude/CLAUDE.md, a livello di utente in ~/.claude/CLAUDE.md, o come managed policy per la tua organizzazione. Le posizioni più specifiche hanno la precedenza. Scopri di più: CLAUDE.md files

​

Command

Un’istruzione riutilizzabile che invochi digitando /name nel prompt. I comandi built-in come /clear, /model e /compact controllano la sessione. Puoi definire i tuoi comandi come file in .claude/commands/, o installarli da un plugin. Skills sono il modo consigliato per confezionare comandi multi-step. Scopri di più: Commands · Skills

​

Compaction

Riassunto automatico della tua conversazione quando la context window si avvicina al suo limite. Gli output degli strumenti più vecchi vengono cancellati per primi, quindi la conversazione viene riassunta. CLAUDE.md a livello di radice del progetto e auto memory sopravvivono alla compaction e si ricaricano dal disco; le istruzioni date solo in conversazione potrebbero andare perse. Esegui /compact per attivare manualmente, opzionalmente con un focus come /compact focus on the API changes. Scopri di più: What survives compaction · When context fills up

​

Context window

La memoria di lavoro per una sessione, che contiene la cronologia della conversazione, i contenuti dei file, gli output dei comandi, CLAUDE.md, auto memory, le skills caricate e le istruzioni di sistema. Man mano che lavori, il contesto si riempie fino a quando compaction lo riassume. Esegui /context per vedere cosa sta usando lo spazio. Per il concetto di modello sottostante, consulta il glossario della piattaforma. Scopri di più: Explore the context window

​

D

​

Dispatch

Un router di attività avviato da telefono che genera una sessione di Claude Code nell’app Desktop quando invii un’attività di codifica dall’app mobile Claude. Il tuo prompt viene instradato automaticamente allo strumento giusto. Disponibile su piani Pro e Max. Scopri di più: Sessions from Dispatch

​

E

​

Effort level

Un’impostazione che controlla quanto del budget di thinking con ragionamento adattivo Claude utilizza ad ogni turno. Uno sforzo più elevato significa più token di thinking e ragionamento più profondo; uno sforzo inferiore è più veloce ed economico. Effort è supportato su Opus 4.7, Opus 4.6 e Sonnet 4.6. Scopri di più: Adjust effort level

​

Extended thinking

Ragionamento passo dopo passo visibile che il modello esegue prima di rispondere. Puoi limitare i token di thinking con MAX_THINKING_TOKENS o regolare il effort level. Il thinking appare in testo grigio corsivo nel terminale. Scopri di più: Use extended thinking

​

H

​

Hook

Un gestore definito dall’utente che viene eseguito automaticamente in un punto specifico del ciclo di vita di Claude Code, come prima dell’esecuzione di uno strumento, dopo una modifica di file o all’avvio della sessione. I gestori possono essere un comando shell, un endpoint HTTP, uno strumento MCP, un prompt LLM o un subagent. Gli hooks sono deterministici: si attivano in punti di ciclo di vita fissi piuttosto che a discrezione del modello. Una configurazione di hook ha tre livelli:

• Hook event: il punto del ciclo di vita
• Matcher: filtra quali eventi lo attivano
• Hook handler: cosa viene eseguito

Scopri di più: Get started with hooks · Hooks reference

​

M

​

Managed settings

Un file di impostazioni applicato a livello di organizzazione da IT o DevOps, posizionato in un percorso a livello di OS al di fuori di ~/.claude. Gli utenti non possono ignorare o escludere le impostazioni gestite. Usalo per politiche di sicurezza, requisiti di conformità o tooling standardizzato su una flotta. Scopri di più: Server-managed settings

​

MCP (Model Context Protocol)

Uno standard aperto per connettere strumenti AI a fonti di dati esterne e servizi. I server MCP danno a Claude nuovi strumenti per Slack, Jira, database, browser e centinaia di altre integrazioni. Connetti i server tramite /mcp o aggiungendoli a .mcp.json. Per il protocollo stesso, consulta il glossario della piattaforma. Scopri di più: Model Context Protocol

​

MCP Tool Search

Un meccanismo di risparmio di contesto che rinvia gli schemi degli strumenti MCP fino a quando non sono necessari. Solo i nomi degli strumenti si caricano all’avvio; Claude recupera lo schema completo su richiesta quando decide di utilizzare uno strumento specifico. Questo impedisce ai server MCP inattivi di consumare molto contesto. Scopri di più: Scale with MCP Tool Search

​

N

​

Non-interactive mode

Una modalità che esegue un singolo prompt e esce senza una sessione conversazionale, invocata con -p o --print. Usata per CI, script e piping. L’Agent SDK è l’equivalente Python e TypeScript. Precedentemente chiamata headless mode. Scopri di più: Run Claude Code programmatically

​

O

​

Output style

Una configurazione che modifica il prompt di sistema di Claude per cambiare il comportamento della risposta, il tono o il formato. Gli output styles disattivano le parti specifiche dell’ingegneria del software del prompt di sistema predefinito, a differenza di CLAUDE.md che viene consegnato come messaggio utente seguendo il prompt di sistema. Gli stili built-in includono Default, Explanatory e Learning. Scopri di più: Output styles

​

P

​

Permission mode

Il comportamento di approvazione di base per la sessione. Cicla con Shift+Tab nella CLI o usa il selettore di modalità in VS Code, Desktop e claude.ai. Le modalità disponibili sono default, acceptEdits, plan, auto, dontAsk e bypassPermissions. Scopri di più: Choose a permission mode

​

Permission rule

Una voce di impostazioni che consente, chiede informazioni su o nega un’invocazione di uno strumento in base al nome dello strumento e al modello di argomento. Le regole vengono valutate deny→ask→allow, il primo match vince. Le permission rules sono controlli granulari sovrapposti alla più ampia permission mode. Scopri di più: Configure permissions

​

Plan mode

Una permission mode in cui Claude ricerca e propone modifiche senza modificare i tuoi file sorgente. Può leggere, cercare ed eseguire comandi di esplorazione, quindi presenta un piano per l’approvazione prima di toccare qualsiasi cosa. Entra in plan mode con /plan o premendo Shift+Tab. Scopri di più: Analyze before you edit with plan mode

​

Plugin

Un bundle di skills, hooks, subagents e server MCP confezionati come una singola unità installabile. Le plugin skills sono spaziate dei nomi come plugin-name:skill-name in modo che più plugin coesistano. Distribuisci i plugin tra i team tramite un marketplace. Scopri di più: Plugins

​

Project trust

Una finestra di dialogo una tantum che accetta una directory prima che Claude Code carichi la sua configurazione. Trust gates l’auto-installazione dei plugin del marketplace e l’esecuzione degli hooks definiti dal progetto. Fidarsi di una directory significa che i suoi file .claude/settings.json, .mcp.json e altri file di configurazione hanno effetto. Scopri di più: The .claude directory

​

Prompt injection

Istruzioni ostili incorporate in un file, pagina web o risultato dello strumento che tentano di reindirizzare Claude verso azioni che non hai mai chiesto. Le difese di Claude Code includono il sistema di autorizzazioni, le blocklist dei comandi e la verifica della fiducia. Auto mode aggiunge una sonda lato server che scansiona i risultati degli strumenti per contenuti sospetti e un classificatore che non vede mai i risultati degli strumenti, quindi il testo iniettato non può influenzare le sue decisioni di approvazione. Scopri di più: Protect against prompt injection

​

R

​

Remote Control

Un modo per continuare una sessione locale di Claude Code dal tuo telefono o browser tramite claude.ai. Il tuo codice rimane sulla tua macchina; solo l’interfaccia utente è remota. Diverso da Claude Code sul web, che viene eseguito in una sandbox cloud. Scopri di più: Remote Control

​

Rules

File di istruzioni modulari in .claude/rules/ che si caricano insieme a CLAUDE.md. Una regola può essere con ambito di percorso con frontmatter YAML paths: in modo che si carichi solo quando Claude legge un file corrispondente, mantenendo il contesto snello fino a quando non è rilevante. Scopri di più: Organize rules with .claude/rules/

​

S

​

Sandboxing

Isolamento a livello di OS del filesystem e della rete per lo strumento Bash. I comandi vengono eseguiti all’interno di un confine che definisci in anticipo, in modo che Claude possa lavorare liberamente al suo interno senza prompt di approvazione per comando. Sandboxing è un livello separato dalle permission rules. Scopri di più: Sandboxing

​

Session

Una conversazione legata alla tua directory corrente, con la sua propria context window indipendente. Le sessioni possono essere riprese con claude -c, fork con --fork-session per preservare la cronologia sotto un nuovo ID di sessione, o eseguite in parallelo tra i terminali. L’esecuzione di /clear avvia una nuova sessione; quella precedente rimane archiviata ed è disponibile tramite /resume. La trascrizione di ogni sessione è archiviata in ~/.claude/projects/. Scopri di più: Work with sessions

​

Settings layers

La gerarchia da cui Claude Code legge la configurazione, in ordine di precedenza dal più alto al più basso: managed policy, argomenti della riga di comando, impostazioni locali in .claude/settings.local.json, impostazioni di progetto in .claude/settings.json, quindi impostazioni utente in ~/.claude/settings.json. Gli array si uniscono tra i livelli; gli scalari a un livello più alto sovrascrivono quelli inferiori. Scopri di più: Settings files

​

Skill

Un file SKILL.md contenente istruzioni, conoscenze o un flusso di lavoro che Claude aggiunge al suo toolkit. Claude carica una skill automaticamente quando rilevante, o la invochi direttamente con /skill-name. Le skills seguono lo standard open Agent Skills; Claude Code lo estende con il controllo dell’invocazione e l’esecuzione del subagent. Le skills sono il successore consigliato ai comandi personalizzati. Un file in .claude/commands/deploy.md e uno in .claude/skills/deploy/SKILL.md creano entrambi /deploy e funzionano allo stesso modo; i file di comando esistenti continuano a funzionare. Scopri di più: Extend Claude with skills

​

Subagent

Un assistente AI specializzato che viene eseguito nella sua propria context window con un prompt di sistema personalizzato, accesso specifico agli strumenti e autorizzazioni indipendenti. Lavora su un’attività delegata e restituisce un riepilogo alla conversazione principale. Usa i subagents per mantenere grandi esplorazioni fuori dal tuo contesto primario o per eseguire ricerche parallele. Diverso da agent teams, dove ogni agente è una sessione completamente indipendente con cui puoi parlare direttamente. I subagents built-in includono Explore, Plan e general-purpose. Scopri di più: Create custom subagents

​

Surface

Qualsiasi luogo in cui accedi a Claude Code: la CLI, VS Code, JetBrains, Desktop o claude.ai. Tutte le surface condividono lo stesso motore, quindi il tuo CLAUDE.md, le impostazioni e le skills funzionano allo stesso modo su di esse. Slack e l’estensione Chrome sono integrazioni che si connettono a una surface piuttosto che essere surface stesse. Scopri di più: Platforms and integrations

​

T

​

Teleport

Un comando, /teleport, che tira una sessione cloud di Claude Code nel tuo terminale locale. Claude recupera il branch, carica la cronologia della conversazione e riprende dallo stato dell’ultima sessione web. La direzione inversa è --remote, che invia un’attività locale da eseguire sul web. Scopri di più: From web to terminal

​

Tool

Un’azione che Claude può intraprendere: leggere un file, modificare il codice, eseguire un comando shell, cercare il web, generare un subagent. Gli strumenti sono ciò che rende Claude Code agentic. Senza di essi, Claude può solo rispondere con testo. Ogni utilizzo di uno strumento restituisce un risultato che informa la decisione successiva di Claude nel agentic loop. Scopri di più: Tools available to Claude

​

W

​

Worktree isolation

Una modalità di isolamento che esegue Claude in un worktree git separato in .claude/worktrees/, abilitata con il flag -w o isolation: worktree nella configurazione del subagent. Le modifiche rimangono su un branch separato in una directory separata, in modo che gli agenti paralleli non sovrascrivano i file l’uno dell’altro. Scopri di più: Run parallel sessions with git worktrees

---

​

Deprecated and renamed terms

Questi termini appaiono in documenti più vecchi, post di blog e contenuti della comunità. Usa il nome attuale quando cerchi su questo sito.