Cursor Rules vs CLAUDE.md vs AGENTS.md: abbiamo testato una config su tutti e tre (2026)

Cursor Rules vs CLAUDE.md vs AGENTS.md: abbiamo testato una config su tutti e tre (2026)

La domanda cursor rules vs claude md nasconde una trappola: non sono due opzioni tra cui scegliere. Sono due file, letti da due strumenti diversi, che per caso fanno lo stesso lavoro. Metti un CLAUDE.md in un progetto Cursor e Cursor lo ignora. Metti un AGENTS.md in Claude Code e non succede nulla nemmeno lì. Ha sorpreso anche noi. AGENTS.md oggi vive in oltre 60.000 repository come standard aperto, gestito dalla Agentic AI Foundation sotto la Linux Foundation, eppure Claude Code non lo legge ancora da solo. Ecco la mappa di compatibilità, testata sul nostro repo.

Punti Chiave

• Cursor legge .cursor/rules/*.mdc e AGENTS.md, non CLAUDE.md.
• Claude Code legge solo CLAUDE.md, non AGENTS.md nativamente.
• Per condividere un solo file: crea un symlink da AGENTS.md a CLAUDE.md, oppure importalo con @AGENTS.md.
• Standardizza su AGENTS.md (standard aperto, 60k+ repo), poi aggiungi override specifici per ogni tool.

Quale Formato di Configurazione Dovresti Usare? La Decisione in 30 Secondi

Scegli il formato in base alla struttura del team, non alle mode. Se usi un solo tool, usa il suo file nativo. Se ne usi due o più, adotta AGENTS.md come fonte di verità e aggiungi override per singolo tool solo dove serve qualcosa che gli altri non offrono. Questa regola risolve la maggior parte della confusione.

Stai ancora decidendo quale assistente usare prima di preoccuparti della sua configurazione? Parti dalla nostra guida su come scegliere quale agente AI di coding usare, poi torna qui per l'impostazione dei file.

L'asse decisionale che conta davvero è la portabilità. Un file .cursor/rules è potente dentro Cursor e inutile ovunque altrove. Un AGENTS.md invece viaggia. Quindi, a meno che tu non sia legato per sempre a un solo tool, il file tool-agnostico è la scelta più sicura.

Cosa Sono Davvero Questi Formati (in 30 Secondi Ciascuno)

Questi tre file fanno tutti la stessa cosa: passano a uno strumento AI di coding le regole, le convenzioni e le insidie del tuo progetto prima che scriva una riga. La differenza sta in chi li legge e come li applica. Ecco la versione breve. L'approfondimento per ciascuno vive nella sua guida dedicata.

Le Cursor Rules sono file .mdc dentro .cursor/rules/. Cursor supporta quattro tipi di regola (sempre attiva, richiesta dall'agente, scoping su glob e menzione manuale con @), quindi puoi legare una regola solo ai tuoi file *.tsx o solo alle migrazioni. Per frontmatter, glob e budget di token, leggi la nostra guida su come scrivere davvero i file .cursor/rules.

CLAUDE.md è il file di memoria di Claude Code. Claude risale l'albero delle directory dalla cartella di lavoro e concatena ogni CLAUDE.md che trova. È Markdown puro, senza frontmatter obbligatorio. Per la struttura e le regole che impediscono a Claude di ignorarlo, vedi cosa rende un CLAUDE.md che Claude non ignora.

AGENTS.md è lo standard aperto. Un solo file Markdown alla radice del repo, letto nativamente da Cursor, Codex, Copilot, Windsurf, Zed, Aider e decine di altri. È gestito dalla Agentic AI Foundation e vive già in oltre 60.000 progetti.

Ecco il modo giusto di pensarci: AGENTS.md, CLAUDE.md e .cursor/rules non sono concorrenti, sono la stessa istruzione indirizzata a lettori diversi.

Cursor Rules vs CLAUDE.md vs AGENTS.md: Il Confronto Completo

Il modo più veloce per vedere la differenza è metterli a confronto uno accanto all'altro. La colonna decisiva è la portabilità: quali tool leggono il file senza configurazione extra. AGENTS.md vince per copertura, le Cursor Rules vincono per precisione di scoping, e CLAUDE.md vince per chi lavora esclusivamente con Claude Code.

Nota la riga di .cursorrules. Quel singolo file alla radice funziona ancora in Cursor, ma è sparito dalla documentazione, quindi trattalo come legacy. I nuovi progetti dovrebbero usare .cursor/rules/*.mdc oppure AGENTS.md.

Quale Tool Legge Quale File? (Sfatiamo il Mito di AGENTS.md)

Ecco il fatto che metà internet sbaglia: Claude Code non legge nativamente AGENTS.md, e Cursor non legge CLAUDE.md. Cursor legge .cursor/rules/*.mdc più AGENTS.md. Claude Code legge CLAUDE.md e nient'altro. Non esiste un fallback automatico in nessuna delle due direzioni, e questo manda in confusione i team che danno per scontato che un unico file standard copra tutto.

Ce lo chiedono continuamente, quindi diciamolo senza giri di parole. Mettere un AGENTS.md in un progetto Claude Code non fa nulla da solo. Claude Code legge CLAUDE.md e solo CLAUDE.md. La documentazione sulla memoria di Claude Code di Anthropic descrive il comportamento di caricamento dei file senza mai menzionare AGENTS.md, la specifica di AGENTS.md elenca Cursor e Codex tra i lettori nativi ma non Claude Code, la documentazione ufficiale delle rules di Cursor conferma la separazione, e le issue GitHub di Claude Code sono piene di sviluppatori che sbattono contro esattamente questo muro.

Quindi Cursor legge claude.md? No. Claude Code legge agents.md? Non senza un aiuto. Quell'"aiuto" è il motivo per cui esiste questo articolo, e sono due comandi brevi che vedrai tra poco.

Come Funzionano Precedenza e Annidamento, a Confronto

Ogni tool risolve i conflitti in modo diverso, e sbagliare qui è la prima causa del classico "perché la mia regola viene ignorata?". Cursor unisce le regole per priorità di sorgente. Claude Code concatena per profondità di directory. AGENTS.md sceglie il file più vicino nell'albero. Una buona gestione del claude md parte dal capire in quale modello mentale ti trovi.

Nella nostra configurazione, la conseguenza pratica è semplice: metti le regole generali in alto (radice del repo) e quelle specifiche in basso (dentro una cartella di pacchetto). Sia per Claude Code sia per AGENTS.md, il file più vicino a dove stai lavorando ha priorità, quindi un packages/api/AGENTS.md prevale su quello alla radice per tutto ciò che è dentro quella cartella. Cursor è l'eccezione, perché risolve per livello di sorgente e non per profondità di cartella.

Abbiamo Testato una Config su Cursor + Claude Code, Ecco Cosa ha Caricato Ogni Tool

Abbiamo testato tutto questo su un repository client Techsy reale (un backend Next.js 15) usando Cursor 3.7 (build del 17 giugno 2026) e Claude Code v2.1.x (inizio luglio 2026). Un solo AGENTS.md, tre configurazioni di condivisione, lo stesso prompt aperto in entrambi i tool. Ecco esattamente cosa ha caricato ciascuno.

Siamo partiti da un file minimale:

# AGENTS.md
- Package manager: pnpm, never npm.
- Tests: Vitest. Run `pnpm test` before any commit.
- DB access goes through `lib/db.ts` only, no inline SQL.

Setup 1: solo AGENTS.md. Cursor lo ha rilevato subito. Il file compariva nel suo contesto e ha correttamente rifiutato di suggerire npm install. Claude Code non ha fatto nulla con quel file. Eseguendo /memory in Claude Code, il risultato era zero file di memoria di progetto: nessun CLAUDE.md trovato, e AGENTS.md non era nemmeno riconosciuto. Confermato: nessun fallback nativo.

Setup 2: symlink. Abbiamo puntato CLAUDE.md allo stesso file:

ln -s AGENTS.md CLAUDE.md

A quel punto /memory in Claude Code elencava ./CLAUDE.md come memoria di progetto, e il contenuto caricato era il nostro AGENTS.md byte per byte. Cursor continuava a leggere AGENTS.md direttamente. Un solo file fisico, entrambi i tool soddisfatti. Su Windows serve la modalità Amministratore o Sviluppatore attiva, altrimenti ln/mklink fallisce silenziosamente.

Setup 3: @import. Abbiamo eliminato il symlink e messo invece una singola riga in cima a un vero CLAUDE.md:

@AGENTS.md

/memory a quel punto mostrava CLAUDE.md come file caricato, con AGENTS.md importato sotto come riferimento incorporato. È il percorso che Anthropic documenta davvero, e non richiede permessi speciali del sistema operativo.

Il verdetto del nostro test: il symlink fa leggere a Claude Code AGENTS.md byte per byte; l'import @AGENTS.md è la versione compatibile con Windows che Anthropic consiglia davvero. Entrambi ti danno un'unica fonte di verità. Scegli il symlink su macOS/Linux per zero indirezione, o la riga di import se qualcuno del team usa Windows.

Migrare tra Formati: .cursorrules → .cursor/rules → AGENTS.md

Molti team arrivano qui con un vecchio file .cursorrules e vogliono uscire dalla trappola del file unico. La migrazione è breve in entrambe le direzioni, e i passaggi sono un copia-incolla. L'unica insidia che frega tutti: un file .md dentro .cursor/rules senza frontmatter viene ignorato silenziosamente, quindi deve essere .mdc.

Per modernizzare un vecchio .cursorrules, hai due percorsi puliti:

• Verso .cursor/rules/*.mdc: crea .cursor/rules/general.mdc, aggiungi il frontmatter (alwaysApply: true per una regola globale) e incolla sotto il vecchio contenuto. Elimina .cursorrules una volta verificato che funzioni.
• Verso AGENTS.md (consigliato per i team multi-tool): per convertire cursorrules in agents.md, copia il corpo di .cursorrules in un nuovo AGENTS.md alla radice del repo. Non serve frontmatter, è Markdown puro. Poi aggiungi il symlink o l'import @AGENTS.md così anche Claude Code lo legge.

Se resti dentro Cursor e vuoi sfruttarlo al meglio, la nostra guida su come ottenere di più da Cursor ogni giorno copre lo scoping delle regole in pratica.

Andare nella direzione opposta (AGENTS.md → CLAUDE.md) è semplicemente il symlink o l'import visti nella sezione precedente. Non c'è conversione con perdita di dati perché tutti e tre sono Markdown sotto il cofano.

Dove si Collocano SKILL.md e le Istruzioni di Copilot?

Altri due formati entrano in questa conversazione, e skills md è una ricerca in forte crescita in questo momento, quindi vale la pena una collocazione rapida. Nessuno dei due sostituisce i tre file principali; convivono accanto a loro.

SKILL.md è il formato Skills di Anthropic: istruzioni specifiche per task raggruppate in .claude/skills/*/SKILL.md che Claude carica su richiesta quando un task corrisponde, invece di essere sempre attivo come CLAUDE.md. Pensalo come un manuale specializzato a cui Claude attinge, non un file di memoria valido per l'intero progetto. L'ambito è ancora in evoluzione, quindi non investirci troppo per ora. Per capire come si inserisce in un flusso di lavoro reale, vedi dove si colloca CLAUDE.md in un vero flusso di lavoro Claude Code.

Le istruzioni di Copilot vivono in .github/copilot-instructions.md per GitHub Copilot. Buona notizia: Copilot legge anche AGENTS.md, quindi se hai già standardizzato sullo standard aperto, Copilot è già coperto senza bisogno di un file separato.

Quale Dovresti Usare? (In Base alla Struttura del Team)

Fai corrispondere il formato al modo in cui lavora davvero il tuo team:

• Utente singolo di Claude Code: usa semplicemente CLAUDE.md. Nessun motivo per aggiungere AGENTS.md a meno che tu non pensi di introdurre Cursor o Codex più avanti.
• Utente singolo di Cursor: .cursor/rules/*.mdc per lo scoping su glob, oppure un unico AGENTS.md se vuoi portabilità fin dal primo giorno.
• Team con tool misti: un AGENTS.md come fonte di verità, con symlink o import verso CLAUDE.md. Aggiungi un piccolo file .cursor/rules solo per comportamenti specifici di Cursor.
• Monorepo: AGENTS.md alla radice più file annidati per pacchetto, così ogni sottoprogetto si descrive da sé e vince il file più vicino.

Da Techsy standardizziamo la configurazione AI-coding su team con tool misti, di solito con un AGENTS.md come fonte di verità e override per singolo tool dove servono. Se il tuo team sta gestendo a mano tre file di configurazione, richiedi una consulenza gratuita e ti aiutiamo a mapparli.

Un ultimo appunto: questo articolo confronta i file di configurazione. Se stai davvero cercando di decidere tra gli strumenti stessi, leggi il confronto diretto tra gli assistenti, non tra le loro configurazioni.

Domande Frequenti

Cursor legge CLAUDE.md?

No. Cursor legge nativamente .cursor/rules/*.mdc e AGENTS.md, ma CLAUDE.md non è mai menzionato nella documentazione di Cursor e non viene caricato. Se usi Cursor e vuoi condividere la configurazione con chi usa Claude Code, metti le tue regole in AGENTS.md (che Cursor legge) invece che in CLAUDE.md.

Claude Code legge AGENTS.md?

Non nativamente. Claude Code legge solo CLAUDE.md, senza fallback automatico verso AGENTS.md. Per farlo funzionare, crea un symlink tra i due file (ln -s AGENTS.md CLAUDE.md) così Claude legge AGENTS.md byte per byte, oppure aggiungi @AGENTS.md alla riga 1 di un CLAUDE.md per importarlo. L'import è l'opzione consigliata da Anthropic e compatibile con Windows.

Posso usare un solo file per tutti e tre i tool?

Sì. Adotta AGENTS.md come unica fonte di verità: Cursor e Codex lo leggono direttamente. Per Claude Code aggiungi un solo ponte: symlink AGENTS.md verso CLAUDE.md, oppure metti @AGENTS.md in cima a un CLAUDE.md. Mantieni un solo file, e ogni tool carica le stesse regole. Questa è l'intera ricetta per condividere una sola configurazione.

.cursorrules è deprecato?

Soft-deprecato. Il file unico .cursorrules alla radice del repo funziona ancora in Cursor, ma non è più nella documentazione ufficiale, il segnale tipico che un formato sta uscendo di scena. I nuovi progetti dovrebbero usare .cursor/rules/*.mdc per regole con scoping o AGENTS.md per la portabilità.

Come converto .cursorrules in AGENTS.md?

Copia il corpo del tuo file .cursorrules in un nuovo AGENTS.md alla radice del repo. È Markdown puro, quindi non serve frontmatter né riformattazione. Poi aggiungi un symlink o un import @AGENTS.md così anche Claude Code lo legge, ed elimina il vecchio .cursorrules una volta confermato che Cursor carica il nuovo file.

Qual è la differenza tra CLAUDE.md e AGENTS.md?

CLAUDE.md è il file di memoria proprietario di Claude Code, letto solo da Claude Code. AGENTS.md è uno standard aperto letto da Cursor, Codex, Copilot e oltre 20 altri tool, ma non nativamente da Claude Code. Stesso formato Markdown, stesso lavoro. La differenza è la copertura. AGENTS.md viaggia tra i tool; CLAUDE.md resta dentro Claude Code.

Su quale formato dovrebbe standardizzare un team che usa più strumenti AI?

Su AGENTS.md. È lo standard aperto, letto nativamente dalla maggior parte dei tool e già presente in oltre 60.000 repository. Standardizza lì le regole condivise, collega Claude Code con un symlink o un import, e aggiungi piccoli file specifici per tool (come .cursor/rules) solo dove uno strumento ha bisogno di un comportamento che gli altri non offrono.

Come funziona la precedenza con file di configurazione annidati?

Sia per Claude Code sia per AGENTS.md, vince il file più vicino alla directory di lavoro, quindi una regola in packages/api/AGENTS.md prevale sul file alla radice del repo per tutto ciò che è dentro quella cartella. Cursor è diverso: unisce le regole Team, Progetto e Utente per livello di sorgente invece che per profondità di cartella, con le sorgenti precedenti che vincono i conflitti.

Dove si colloca SKILL.md?

SKILL.md è il formato emergente Skills di Anthropic: istruzioni specifiche per task in .claude/skills/*/SKILL.md che Claude carica su richiesta quando un task corrisponde, invece di essere sempre attivo come CLAUDE.md. Completa CLAUDE.md invece di sostituirlo. L'ambito è ancora in evoluzione nel 2026, quindi trattalo come un componente specializzato, non come un quarto file necessario per ogni progetto. </content>