Claude Code ora ripiega su AGENTS.md, semplificando i repo multi-agente

Claude Code ora leggerà il file AGENTS.md di un repository quando non esiste alcun file di istruzioni specifico per Claude, colmando una lacuna per i team che eseguono più agenti di codifica AI sullo stesso codebase. La modifica è stata introdotta in Claude Code 2.1.277, annunciata il 18 settembre 2026 dal team di Claude Code: se una cartella non ha CLAUDE.md, Claude controllerà e userà invece AGENTS.md.

Un fallback, non una presa di controllo

Il comportamento si applica solo quando non è presente alcun file specifico per Claude. Se Claude Code trova un CLAUDE.md, un .claude/CLAUDE.md o un CLAUDE.local.md in qualsiasi punto del percorso verso la directory di lavoro, quel file ha la precedenza e AGENTS.md viene ignorato. Quando nessuno di questi esiste, AGENTS.md può fornire le regole di codifica, i passaggi di build e i requisiti di test del progetto. La funzionalità viene distribuita come plugin integrato e i team possono regolare il comportamento — solo CLAUDE.md, AGENTS.md come fallback, entrambi caricati insieme o un elenco di fonti limitato — tramite /config, impostazioni utente o impostazioni gestite.

Perché i repository accumulano file duplicati

I team che usano più strumenti spesso finiscono con più di un file di istruzioni nello stesso repo: CLAUDE.md per Claude Code, AGENTS.md per Codex, Cursor e altri. Iniziano come copie l'uno dell'altro e si allontanano fino a quando uno di essi indirizza un agente verso un comando di build che non funziona più. Un AGENTS.md condiviso elimina questa duplicazione per i repo che non hanno bisogno di istruzioni specifiche per Claude.

Cosa controllare prima di affidarsi a questa funzione

• CLAUDE.md ha ancora la precedenza per impostazione predefinita — i team che vogliono che entrambi i file vengano considerati devono modificare esplicitamente l'impostazione della fonte delle istruzioni.
• Il supporto presenta attualmente delle lacune nelle distribuzioni Bedrock, Vertex e Foundry, quindi lo stesso repo può risolvere le istruzioni in modo diverso a seconda del provider su cui un membro del team sta lavorando.
• Una issue GitHub tracciata (#96005) segnala istruzioni duplicate quando la stessa guida arriva anche attraverso un secondo canale, come un harness per agenti — vale la pena verificare prima di dare per scontato che AGENTS.md da solo sia autorevole.

Per gli MSP che standardizzano un unico file di istruzioni tra i repo dei clienti che usano strumenti agentici misti, questo elimina una vera fonte di deriva — ma conviene verificare quale provider e versione di Claude Code usa ogni team prima di trattare AGENTS.md come unica fonte di verità.

Fonti: DevOps.com, dev.to.