# Claude Code ora legge AGENTS.md: cosa è cambiato nella versione 2.1.277 > Il 18 settembre 2026, Claude Code 2.1.277 ha introdotto il supporto diretto ad AGENTS.md: quando il file viene caricato, come scegliere una delle 4 modalità e come gestire gli import. Source: https://ailoot.ai/blog/it/claude-code-agents-md-support/ Canonical: https://ailoot.ai/blog/it/claude-code-agents-md-support/ Language: it Publisher: Ailoot (https://ailoot.ai/) Translation: guide-041 Revision: sha256-8cd3867d7699352c2ca747d9d3790508a1b8462667236da988b231b142767b3d Il 18 settembre 2026 è stato aggiunto il supporto per `AGENTS.md` in Claude Code 2.1.277. Se la funzionalità è disponibile nella sessione e nella directory di lavoro e, nell'intera catena di directory a monte, non è presente alcun `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md`, Claude Code legge `AGENTS.md` per impostazione predefinita, senza import manuale. In precedenza, si otteneva questo risultato importando `@AGENTS.md` in `CLAUDE.md` oppure creando un collegamento simbolico da `CLAUDE.md` ad `AGENTS.md`: per maggiori dettagli, leggi l'articolo [su un unico file di istruzioni per più agenti](https://ailoot.ai/blog/it/agents-md-claude-md-one-instruction-file/). Se usi Claude Code e uno o due altri strumenti nello stesso repository, la modalità Project instructions che scegli determina quali file di istruzioni Claude Code legge. Di seguito trovi le condizioni per ciascuna delle quattro modalità e i passaggi per migrare dalla configurazione precedente. Altri materiali sulla configurazione degli strumenti sono disponibili nella [documentazione di Ailoot](https://ailoot.ai/docs/).
[Guide Ailoot](https://ailoot.ai/docs/)
## Cosa è cambiato nella versione 2.1.277?
Punto chiave Dal 18 settembre 2026, Claude Code legge `AGENTS.md` per impostazione predefinita se, nell'intera catena di directory dalla cartella di lavoro a quelle superiori, non è presente alcun `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md`. Se uno di questi file esiste, la lettura automatica di `AGENTS.md` tramite Project instructions non è attiva. L'import esplicito di `@AGENTS.md` da `CLAUDE.md` continua a funzionare. I file utente `~/.claude/CLAUDE.md`, i file `CLAUDE.md` gestiti dall'organizzazione e `.claude/rules/` vengono caricati indipendentemente dalla scelta tra i file di progetto. La modalità si cambia tramite `/config`. La funzionalità non è ancora disponibile su Bedrock, Vertex o Foundry.
Il CHANGELOG.md ufficiale del progetto Claude Code su GitHub lo descrive così:

Aggiunto il supporto per AGENTS.md: in un progetto senza CLAUDE.md, Claude Code legge AGENTS.md; modifica l'impostazione in "Project instructions" tramite /config (non ancora disponibile su Bedrock, Vertex o Foundry)

— Anthropic, commit di claude-code CHANGELOG.md, ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
Traduzione: è stato aggiunto il supporto per `AGENTS.md`: in un progetto senza `CLAUDE.md`, Claude Code ora legge `AGENTS.md`; l'impostazione si può cambiare in “Project instructions” tramite `/config` (non ancora disponibile su Bedrock, Vertex o Foundry). Prima di questa versione, l'assenza di `CLAUDE.md`, `.claude/CLAUDE.md` e `CLAUDE.local.md` nella cartella di lavoro e nelle directory superiori non bastava, da sola, ad attivare la lettura di `AGENTS.md`. Servivano un import esplicito, un collegamento simbolico o un hook manuale. Ora, quando la funzionalità è disponibile, l'agente carica il file automaticamente. ## Quali file impediscono la lettura automatica di AGENTS.md
Punto chiave Nella modalità predefinita, `CLAUDE.md`, `.claude/CLAUDE.md` e `CLAUDE.local.md` vengono verificati nella directory di lavoro e in quelle superiori. Il file personale `~/.claude/CLAUDE.md`, il file `CLAUDE.md` gestito dall'organizzazione e i file `.claude/rules/` non impediscono la lettura di `AGENTS.md` e vengono caricati insieme a esso.
Se hai un file personale `~/.claude/CLAUDE.md` con impostazioni di stile di programmazione, questo non impedirà a Claude Code di leggere l'`AGENTS.md` del progetto. Tuttavia, qualsiasi `CLAUDE.local.md` nella cartella di lavoro, anche se non è aggiunto a Git e contiene appunti personali, blocca la lettura automatica di `AGENTS.md` nella modalità predefinita. L'import esplicito continua a funzionare; per leggere direttamente entrambi i file, devi cambiare modalità. Se in Project instructions è selezionata una modalità di lettura diretta (vedi “4 modalità Project instructions: quale scegliere” qui sotto) e nella directory di lavoro o in quelle superiori non è presente alcun `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md`, all'avvio della sessione Claude Code legge ogni `AGENTS.md` e `.claude/AGENTS.md` presente in queste directory. Per il caso in cui non ci siano file che bloccano il caricamento, la documentazione mostra una riga di questo tipo in una sessione interattiva: ``` no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md ``` Un file `AGENTS.md` in una sottodirectory viene caricato quando Claude apre un file in quella directory con lo strumento Read. In modalità `claude-md-or-agents-md`, ciò avviene solo se la sottodirectory non contiene un proprio `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md`. Per la modalità `claude-md-and-agents-md`, la documentazione descrive la regola generale: `CLAUDE.md` e `AGENTS.md` vengono letti insieme, prima `CLAUDE.md` e poi `AGENTS.md` in ciascuna directory. `AGENTS.local.md`, `AGENTS.override.md` e qualsiasi elemento nella directory `.agents/` non vengono letti automaticamente. Nella [documentazione di Ailoot](https://ailoot.ai/docs/) trovi materiali sulla configurazione dell'ambiente di lavoro di un agente AI, inclusi file di istruzioni con il contesto del progetto.
[Guide Ailoot](https://ailoot.ai/docs/)
## 4 modalità Project instructions: quale scegliere
Punto chiave Nella sezione Project instructions del comando `/config` ci sono quattro valori: `claude-md-or-agents-md` (predefinito: uno dei due file), `claude-md-and-agents-md` (entrambi insieme), `claude-md` (viene letto automaticamente solo `CLAUDE.md`, anche se nel progetto è presente soltanto `AGENTS.md`) e `managed-only` (all'avvio vengono caricati solo il file `CLAUDE.md` gestito dall'organizzazione e la memoria automatica, senza file di progetto o personali). La modifica ha effetto dal messaggio successivo e in ogni nuova sessione.
Il comportamento delle modalità nella tabella è descritto nella documentazione di Anthropic. La colonna a destra dà indicazioni su quale scegliere: | Valore | Cosa legge Claude Code | Quando usarla | |----|----|----| | `claude-md-or-agents-md` | `CLAUDE.md`, oppure `AGENTS.md` se nella directory di lavoro o in quelle superiori non è presente alcun `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md` | Impostazione predefinita, se il repository usa uno solo dei due file e non ci sono file che bloccano il caricamento nelle directory superiori | | `claude-md-and-agents-md` | Entrambi i file insieme: in ogni directory, prima `CLAUDE.md` e poi `AGENTS.md` | Ti serve un `AGENTS.md` condiviso da tutti gli strumenti più un `CLAUDE.md` breve solo per Claude; oppure devi leggere `AGENTS.md` quando è presente `CLAUDE.local.md` | | `claude-md` | Solo `CLAUDE.md`; la lettura automatica di `AGENTS.md` tramite Project instructions è disattivata, anche se `AGENTS.md` è l'unico file (l'import esplicito di `@AGENTS.md` da `CLAUDE.md` continua a funzionare) | `AGENTS.md` è scritto per un altro strumento e potrebbe confondere Claude | | `managed-only` | All'avvio della sessione: solo il file `CLAUDE.md` gestito dall'organizzazione e la memoria automatica; i file di progetto, locali e utente `CLAUDE.md`, `.claude/rules/` e tutti i file `AGENTS.md` sono esclusi dall'insieme iniziale. Tuttavia, i file `CLAUDE.md` e `.claude/rules/` nelle sottodirectory vengono caricati in seguito quando Claude apre un file lì. La modalità limita l'insieme iniziale e non garantisce il completo isolamento dai file di progetto | Per le organizzazioni che vogliono controllare l'insieme di istruzioni con cui Claude Code avvia una sessione, indipendentemente dal fatto che il progetto contenga `CLAUDE.md` o `AGENTS.md` | Puoi scegliere la modalità anche senza interfaccia, tramite `settings.json`: ```json { "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` Claude Code ignora questo valore nelle impostazioni `project` e `local`. Secondo la documentazione di Anthropic, si può impostare in `~/.claude/settings.json`, in un file `--settings` o nelle impostazioni gestite dall'organizzazione. Se hai già configurato un file di istruzioni condiviso da più strumenti AI nello stesso repository, le [istruzioni per le versioni precedenti alla 2.1.277](https://ailoot.ai/blog/it/agents-md-claude-md-one-instruction-file/) spiegano come funziona l'import `@`. Questo metodo funziona ancora. ## Perché Project instructions non è presente in /config
Punto chiave Secondo la documentazione di Anthropic, la sezione Project instructions potrebbe mancare per i seguenti motivi: - Claude Code è a una versione precedente alla 2.1.277. - La sessione non riceve i flag delle funzionalità da Anthropic, per esempio quando si usa Bedrock, un altro provider di terze parti o la telemetria è disattivata. - È la prima sessione subito dopo l'installazione o l'aggiornamento da una versione precedente. Se questa è l'unica ragione, la funzionalità apparirà nella sessione successiva. `AGENTS.md` verrà caricato solo se sono soddisfatte le condizioni della modalità selezionata. - Il plugin integrato `agents-md` è disattivato in `/plugin`.
Per prima cosa, verifica la versione con il comando `claude --version`. Se è precedente alla 2.1.277, aggiorna Claude Code. Se la versione è adeguata ma la sezione continua a non comparire, verifica gli altri motivi elencati sopra. Finché la funzionalità non è disponibile, l'import di `@AGENTS.md` in `CLAUDE.md` resta una soluzione alternativa funzionante. ## Cosa fare con il vecchio import @AGENTS.md
Punto chiave Puoi mantenere l'import di `@AGENTS.md` in `CLAUDE.md` e il collegamento simbolico: il file non verrà letto due volte in nessuna modalità. Una richiesta testuale del tipo “leggi AGENTS.md” dovrebbe essere sostituita con un import se mantieni `CLAUDE.md`. Prima di eliminare un file, salva tutte le istruzioni necessarie e verifica le condizioni della modalità selezionata. Se passi alla lettura diretta, rimuovi qualsiasi hook `SessionStart` che stampava manualmente il contenuto di `AGENTS.md`; altrimenti, una seconda copia del file verrà aggiunta al contesto. Poi verifica il caricamento in una nuova sessione; il metodo dipende dalla versione e dall'eventuale presenza di file che bloccano il caricamento.
I passaggi successivi dipendono dalla configurazione precedente. Per prima cosa, assicurati che la funzionalità sia disponibile nella sessione, come descritto nella sezione precedente. - **`CLAUDE.md` con un import `@AGENTS.md`.** Puoi lasciarlo così: Claude Code non leggerà il file due volte con nessun valore di Project instructions. Eliminare `CLAUDE.md` è facoltativo: l'import dà già a Claude accesso al contenuto di `AGENTS.md`. Continua a verificare il caricamento tramite l'import usando `/memory`; una domanda diretta a Claude sul contenuto delle istruzioni è solo una verifica debole. - **`CLAUDE.md` che chiede a parole di leggere `AGENTS.md`.** Una richiesta del genere non è un import e, da sola, non garantisce che il file venga caricato. Sostituisci la formulazione con un import `@AGENTS.md` se vuoi mantenere `CLAUDE.md` (per esempio, per gli strumenti che lo leggono a loro volta). Se decidi di eliminare del tutto `CLAUDE.md` e hai selezionato la modalità `claude-md-or-agents-md`, verifica prima che `CLAUDE.md` non contenga istruzioni esclusive e che nella directory di lavoro o in quelle superiori non ci siano altri `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md`; altrimenti, Claude Code continuerà a leggere il file rimanente invece di `AGENTS.md`. Dopo averlo eliminato, assicurati che la transizione sia avvenuta: quando non rimangono file che bloccano il caricamento, in una sessione interattiva appare la riga `AGENTS.md loaded`. Se `CLAUDE.md` rimane e in modalità `claude-md-and-agents-md` vengono letti entrambi i file, controlla `/memory` (nella versione 2.1.280+). Una domanda diretta a Claude non permette di distinguere il caricamento diretto dall'import. - **Collegamento simbolico `CLAUDE.md` ad `AGENTS.md`.** Puoi mantenerlo: nessuna modalità comporta una lettura duplicata. Prima di eliminare il collegamento in modalità `claude-md-or-agents-md`, verifica che le istruzioni necessarie siano state conservate e che nella directory di lavoro o in quelle superiori non ci siano altri `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md`. Verifica il caricamento allo stesso modo: la riga `AGENTS.md loaded` all'avvio della sessione quando non ci sono file che bloccano il caricamento, oppure `/memory` (versione 2.1.280+). Se `CLAUDE.md` rimane in modalità `claude-md-and-agents-md`, una domanda diretta a Claude è solo una verifica debole. L'assenza di un errore non basta a confermare il caricamento. - **Un hook `SessionStart` che stampava manualmente il contenuto di `AGENTS.md`.** Quando il file viene letto direttamente, un hook del genere aggiunge una seconda copia al contesto. Mentre l'hook è attivo, la domanda “cosa contengono le tue istruzioni?” non conferma la lettura diretta: Claude può rispondere sulla base del testo aggiunto dall'hook. Procedi così: 1. Verifica che la funzionalità sia disponibile: versione 2.1.277 o successiva, la sessione riceve i flag delle funzionalità, il plugin è attivo e la prima sessione dopo l'installazione o l'aggiornamento è terminata. Scegli una modalità di lettura diretta: né `claude-md` né `managed-only`. Per la modalità predefinita, verifica anche che non ci siano file che bloccano il caricamento. 2. Rimuovi l'hook. 3. Chiudi la sessione e aprine una nuova. L'hook `SessionStart` aggiunge il testo all'avvio, quindi il suo contenuto resta nel contesto di una sessione già aperta. La risposta di Claude sul contenuto delle istruzioni in quella sessione non conferma la lettura diretta. 4. Verifica il caricamento nella nuova sessione. Nella versione 2.1.280 o successiva, il percorso di `AGENTS.md` è visibile in `/memory`. Nelle versioni dalla 2.1.277 alla 2.1.279, se non ci sono file che bloccano il caricamento, cerca la riga `AGENTS.md loaded` all'avvio: la documentazione la descrive specificamente per il caso in cui non sia stato trovato `CLAUDE.md`. Se mantieni `CLAUDE.md` e usi la modalità `claude-md-and-agents-md`, la verifica è limitata: `/memory` non mostra `AGENTS.md` in queste versioni, la documentazione non descrive una riga di caricamento per questo caso e una parafrasi delle istruzioni non permette di distinguere la lettura diretta da un import `@` all'interno di `CLAUDE.md`. In tal caso, aggiorna alla versione 2.1.280 o successiva e controlla `/memory`. ## Come verificare che AGENTS.md sia stato caricato
Punto chiave Dalla versione 2.1.280, `AGENTS.md` caricato tramite Project instructions compare in `/memory` e nell'elenco dei file di memoria del comando `/context`. Nelle versioni dalla 2.1.277 alla 2.1.279 non compare lì, anche se i comandi stessi funzionano e mostrano i file `CLAUDE.md` e gli altri file di memoria caricati. In queste versioni, se non ci sono file che bloccano il caricamento, controlla la riga `AGENTS.md loaded` all'avvio della sessione. Chiedere a Claude il contenuto delle istruzioni è solo una verifica debole: la risposta non permette di distinguere la lettura diretta da un import `@` e può basarsi sul testo aggiunto da un hook `SessionStart`. Conviene quindi chiedere solo in una nuova sessione, dopo aver rimosso un hook del genere.
Ci sono altre due differenze rispetto al normale `CLAUDE.md`: gli hook `InstructionsLoaded` non vengono attivati per questo tipo di `AGENTS.md` (funzionano invece per `AGENTS.md` importato tramite la sintassi `@` da `CLAUDE.md` o collegato tramite un collegamento simbolico `CLAUDE.md`); le directory aggiunte con il flag `--add-dir` insieme alla variabile `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` caricano solo il `CLAUDE.md` di quella directory, senza includere il suo `AGENTS.md`. Se devi esaminare il contenuto di un file di istruzioni di progetto molto lungo, leggi l'analisi separata [su come configurare CLAUDE.md senza renderlo prolisso](https://ailoot.ai/blog/it/claude-md-template/). Illustra la struttura delle istruzioni, mentre le condizioni di caricamento di `AGENTS.md` sono descritte sopra. Per gli appunti di lavoro tra una sessione e l'altra, leggi l'analisi di [un secondo cervello in Claude Code](https://ailoot.ai/blog/it/claude-code-second-brain/), dedicata alla memoria personale stratificata sopra le istruzioni del progetto. ## E adesso? La funzionalità è stata rilasciata il 18 settembre 2026 nella versione 2.1.277. Anthropic potrebbe chiarire i dettagli delle modalità nelle versioni future; prima di modificare le impostazioni di un progetto importante, confronta quindi questo articolo con le opzioni attuali di `/config` e con il changelog ufficiale.
### Fonti - [Claude Code, commit su GitHub con la voce 2.1.277 nel CHANGELOG.md (18 settembre 2026)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3) - [Documentazione di Claude Code: come Claude ricorda il tuo progetto - sezione AGENTS.md](https://code.claude.com/docs/en/memory)
[Guide Ailoot](https://ailoot.ai/docs/)
[Vai ad Ailoot](https://ailoot.ai/)
## Domande frequenti ### Perché AGENTS.md non viene caricato anche se esiste? Nella modalità predefinita, un CLAUDE.md, .claude/CLAUDE.md o CLAUDE.local.md nella directory di lavoro o in una directory superiore impedisce la selezione automatica di AGENTS.md. Controlla anche versione di Claude Code, disponibilità della funzione e modalità Project instructions in /config. ### Come verifico il caricamento diretto dopo aver rimosso un hook manuale? Apri una nuova sessione senza l’output del vecchio SessionStart. Dalla versione 2.1.280 controlla /memory o l’elenco Memory files in /context. Nelle 2.1.277-2.1.279 vale la riga di caricamento all’avvio, in assenza di CLAUDE.md che lo blocchino. Una parafrasi di Claude, da sola, è una prova debole. ## Ailoot · L’azienda e il suo portafoglio di progetti Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI. L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.