AnswersPublished18 sources
Claude Code apre ad AGENTS.md: una sola guida di progetto per più agenti
Claude Code 2.1.277, pubblicato il 18 settembre 2026, può leggere AGENTS.md come istruzioni di progetto se nel repository non esiste CLAUDE.md. La novità semplifica l'uso di un unico file di istruzioni con più strumenti di coding assistito, ma non implica la fusione automatica di AGENTS.md e CLAUDE.md.
Pubblicato daModificato con GPT-5.6 TerraImmagini generate con GPT Image 2
Research answer
Key takeaways
- Claude Code 2.1.277, pubblicato il 18 settembre 2026, può leggere AGENTS.md come istruzioni di progetto se nel repository non esiste CLAUDE.md.
- La novità semplifica l'uso di un unico file di istruzioni con più strumenti di coding assistito, ma non implica la fusione automatica di AGENTS.md e CLAUDE.md.
- AGENTS.md contiene le regole permanenti del repository; SKILL.md serve invece a distribuire competenze e flussi di lavoro riutilizzabili, attivati quando necessari.
AI Prompt
openai.comCreate a landscape editorial hero image for this Studio Global article: What changed in Claude Code version 2.1.277, released on September 18, 2026, regarding support for the open AGENTS.md project-instructions f. Article summary: Claude Code 2.1.277 adds native, opt-in-configurable fallback support for `AGENTS.md`: a repository without `CLAUDE.md` can now supply Claude Code’s project instructions through the shared open format instead. It is a fa. Topic tags: general, general web, user generated. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fa
Claude Code 2.1.277 aggiunge il supporto alla convenzione aperta AGENTS.md come fallback per le istruzioni di progetto. Nel comportamento predefinito documentato, Claude Code legge AGENTS.md se nel progetto non trova un file CLAUDE.md. In altre parole, un repository già organizzato attorno a una guida condivisa per gli agenti può funzionare con Claude Code senza dover creare prima un file specifico per Anthropic. 1
La regola pratica: fallback, non fusione
Il comportamento annunciato è semplice:
- Non c'è
CLAUDE.md: Claude Code può usareAGENTS.mdper le istruzioni del progetto.1
- C'è
CLAUDE.md:CLAUDE.mdresta il file di istruzioni consolidato; l'annuncio non descrive un caricamento automatico combinato dei due file nel comportamento predefinito.
L'opzione può essere attivata o modificata nelle impostazioni Project instructions, accessibili con /config. Anthropic precisa che la funzione non è ancora supportata nelle distribuzioni di Claude Code su Amazon Bedrock, Google Vertex AI o Azure AI Foundry. 1
Che cos'è AGENTS.md e perché conta
AGENTS.md è una convenzione aperta in Markdown pensata per raccogliere le indicazioni specifiche di un repository destinate agli agenti di coding: una sorta di “README per gli agenti”. Può includere contesto del progetto, procedure di installazione, comandi di build e test, convenzioni di sviluppo e aspettative per i contributi. 19
32
Il formato nasce da una collaborazione che ha coinvolto OpenAI Codex, Amp, Google Jules, Cursor e Factory; oggi è gestito dalla Agentic AI Foundation, nell'ambito della Linux Foundation. Il progetto dichiara un'adozione in oltre 60.000 repository open source. 19
21
Tra gli strumenti dell'ecosistema figurano OpenAI Codex, Google Jules, Cursor, l'agente di coding di GitHub Copilot, Gemini CLI, Aider, Zed, Warp, VS Code, Devin, JetBrains Junie, Factory, Goose e OpenCode. Le regole con cui ciascun prodotto trova e interpreta i file restano però differenti: la presenza di AGENTS.md non garantisce quindi un comportamento identico ovunque. 19
Il vantaggio: meno file duplicati da mantenere
Prima del supporto nativo, i team che adottavano AGENTS.md come fonte comune dovevano spesso mantenere anche un CLAUDE.md, creare un collegamento simbolico tra i due file oppure usare un CLAUDE.md minimo che importasse quello condiviso. Queste soluzioni erano documentate come workaround perché Claude Code non leggeva nativamente AGENTS.md. 10
Con il nuovo fallback, quel lavoro aggiuntivo si riduce per i repository che non richiedono istruzioni specifiche per Claude. Lo stesso file può così offrire a Claude Code la guida di base già usata da altri strumenti compatibili.
Non significa, però, che tutti i sistemi di istruzioni siano ormai equivalenti. I team dovrebbero continuare a verificare come ogni agente individua i file, applica istruzioni nelle sottodirectory e risolve eventuali conflitti.
AGENTS.md e SKILL.md: ruoli diversi
AGENTS.md e SKILL.md sono formati complementari, non alternative dirette.
AGENTS.mdcontiene linee guida a livello di repository: contesto e regole permanenti per lavorare in uno specifico codebase.19
32
SKILL.mdfa parte di una Agent Skill: un pacchetto riutilizzabile nel file system, con istruzioni, metadati e risorse di supporto facoltative. Claude usa le skill pertinenti per fornire flussi di lavoro o conoscenze specialistiche.33
Claude Code dichiara che le sue skill seguono lo standard interoperabile Agent Skills. Nella documentazione di Claude Code, una skill di progetto è organizzata come directory contenente SKILL.md, ad esempio .claude/skills/<nome>/SKILL.md. 37
39
I limiti che restano
L'aggiornamento aggiunge un fallback per un file di istruzioni, ma non crea da solo una compatibilità universale con tutte le convenzioni degli agenti.
In particolare, la posizione documentata per le skill di progetto in Claude Code è .claude/skills/<nome>/SKILL.md. Il changelog della versione 2.1.277 riguarda le istruzioni di progetto in AGENTS.md e non annuncia la ricerca di una directory .agents/skills/. 1
37
Allo stesso modo, il fallback documentato non va interpretato come una regola di unione automatica tra CLAUDE.md e AGENTS.md. Se un repository necessita sia di regole portabili sia di comportamenti specifici di Claude, è meglio rendere esplicito il rapporto tra i due file anziché affidarsi al solo fallback.
Una struttura sensata per i progetti che usano già Claude Code
Per un progetto che dipende già da CLAUDE.md, una divisione pratica può essere questa:
- Inserire in
AGENTS.mdle regole generali del repository, valide per più strumenti. - Mantenere
CLAUDE.mdper le istruzioni specifiche di Claude Code. - Quando serve, fare riferimento o importare in modo esplicito la guida condivisa da
CLAUDE.md, senza presumere che entrambi i file vengano caricati automaticamente.
La versione 2.1.277 rappresenta quindi un passo concreto verso l'interoperabilità: rende praticabile un repository incentrato su AGENTS.md anche per Claude Code quando CLAUDE.md è assente, senza però affermare che tutte le convenzioni per istruzioni e skill siano ora gestite allo stesso modo.
Studio Global AI
Continue your research
This page includes a source-backed answer you can continue inside Studio Global.
People also ask
What is the short answer to "Claude Code apre ad AGENTS.md: una sola guida di progetto per più agenti"?
Claude Code 2.1.277, pubblicato il 18 settembre 2026, può leggere AGENTS.md come istruzioni di progetto se nel repository non esiste CLAUDE.md.
What are the key points to validate first?
Claude Code 2.1.277, pubblicato il 18 settembre 2026, può leggere AGENTS.md come istruzioni di progetto se nel repository non esiste CLAUDE.md. La novità semplifica l'uso di un unico file di istruzioni con più strumenti di coding assistito, ma non implica la fusione automatica di AGENTS.md e CLAUDE.md.
What should I do next in practice?
AGENTS.md contiene le regole permanenti del repository; SKILL.md serve invece a distribuire competenze e flussi di lavoro riutilizzabili, attivati quando necessari.