Cursor Rules проти CLAUDE.md проти AGENTS.md: я прогнав один конфіг через усі три (2026)
У питанні cursor rules проти claude md є вбудована пастка: це не два варіанти, між якими обирають. Це два файли, які читають два різні інструменти і які випадково роблять ту саму роботу. Підкиньте CLAUDE.md у проєкт Cursor — і Cursor його проігнорує. Підкиньте AGENTS.md у Claude Code — і теж нічого не станеться. Нас це теж здивувало. AGENTS.md тепер є у понад 60 000 репозиторіїв як відкритий стандарт під опікою Agentic AI Foundation у складі Linux Foundation, проте Claude Code досі не читає його самотужки. Ось мапа сумісності, перевірена на нашому репо.
Ключові висновки
- Cursor читає
.cursor/rules/*.mdcтаAGENTS.md, а неCLAUDE.md. - Claude Code читає лише
CLAUDE.md, а неAGENTS.mdнативно. - Щоб спільно використовувати один файл: зробіть симлінк
AGENTS.mdнаCLAUDE.mdабо імпортуйте його через@AGENTS.md. - Стандартизуйтеся на
AGENTS.md(відкритий стандарт, понад 60 тис. репо), а потім додайте специфічні для інструменту перевизначення.
Який формат конфігу обрати? Рішення за 30 секунд
Обирайте формат за формою команди, а не за хайпом. Якщо ви використовуєте один інструмент — користуйтеся його рідним файлом. Якщо два чи більше — візьміть AGENTS.md як єдине джерело правди й додавайте перевизначення для окремого інструменту лише там, де йому потрібно щось, чого немає в інших. Це одне правило розв'язує більшу частину плутанини.
| Ваш сетап | Використовуйте це | Чому |
|---|---|---|
| Сам, лише Cursor | .cursor/rules/*.mdc | Glob-скоупи, чотири типи правил, нативно |
| Сам, лише Claude Code | CLAUDE.md | Єдиний файл, який завантажує Claude Code |
| Змішані інструменти (Cursor + Claude Code + Codex) | AGENTS.md + симлінк/імпорт | Один файл, читає кожен інструмент |
| Монорепо, багато підпроєктів | AGENTS.md, вкладений у кожен пакет | Перемагає найближчий файл, тож підтеки самоопишуються |
Ще вирішуєте, якого асистента запустити, перш ніж перейматися його конфігом? Почніть з нашого гіда з вибору AI-агента для кодингу, а потім повертайтеся до налаштування файлів.
Вісь рішення, яка має значення, — це портативність. Файл .cursor/rules потужний усередині Cursor і ніде більше не корисний. AGENTS.md мандрує. Тож якщо ви не прив'язані до одного інструменту назавжди, файл, незалежний від інструменту, — безпечніша ставка.
Що насправді являє собою кожен формат (по 30 секунд кожен)
Усі три файли роблять одне: передають AI-інструменту для кодингу правила, конвенції та підводні камені вашого проєкту, перш ніж він напише хоч рядок. Різниця в тому, хто їх читає і як вони обмежують скоуп. Ось коротка версія. Детальний how-to для кожного живе у власному гіді.
Cursor Rules — це файли .mdc всередині .cursor/rules/. Cursor підтримує чотири типи правил (завжди увімкнені, на запит агента, з glob-скоупом та ручні через @-згадку), тож ви можете прикріпити правило лише до файлів *.tsx або лише до ваших міграцій. Щодо frontmatter, glob та бюджету токенів — читайте наш гід про те, як насправді писати файли .cursor/rules.
CLAUDE.md — це файл пам'яті Claude Code. Claude піднімається деревом каталогів від вашої робочої теки й конкатенує кожен знайдений CLAUDE.md. Це звичайний Markdown, frontmatter не потрібен. Щодо структури та правил, які не дають Claude ігнорувати його, дивіться що робить CLAUDE.md таким, який Claude не ігнорує.
AGENTS.md — це відкритий стандарт. Один файл зі звичайного Markdown у корені репо, який нативно читають Cursor, Codex, Copilot, Windsurf, Zed, Aider та десятки інших. Він під опікою Agentic AI Foundation і вже живе у понад 60 000 проєктів.
Ось переосмислення, яке варто запам'ятати: AGENTS.md, CLAUDE.md та .cursor/rules — не конкуренти, це та сама інструкція, адресована різним читачам.
Cursor Rules проти CLAUDE.md проти AGENTS.md: головне порівняння
Найшвидший спосіб побачити різницю — поруч. Вирішальна колонка — портативність: які інструменти читають файл без додаткового налаштування. AGENTS.md виграє в охопленні, Cursor Rules — у точності скоупу, а CLAUDE.md — для тих, хто повністю на Claude Code.
| Формат | Шлях файлу | Інструменти, що читають | Скоуп | Модель пріоритету | Портативність |
|---|---|---|---|---|---|
| Cursor Rules | .cursor/rules/*.mdc | Лише Cursor | Glob-скоуп, чотири типи правил | Team → Project → User, злито | Низька (лише Cursor) |
| CLAUDE.md | CLAUDE.md (будь-який каталог) | Лише Claude Code | Обхід каталогів, конкатенація | Адитивна, перемагає найближчий файл | Низька (лише Claude) |
| AGENTS.md | AGENTS.md (корінь + підкаталоги) | Cursor, Codex, Copilot, Windsurf, Zed, Aider та 20+ | Увесь проєкт або вкладений | Перемагає найближчий файл у дереві | Висока (відкритий стандарт) |
| .cursorrules (застарілий) | .cursorrules (корінь) | Cursor (недокументовано) | Один кореневий файл | Лише корінь | Низька, м'яко застарілий |
| SKILL.md (новий) | .claude/skills/*/SKILL.md | Claude (Skills) | На вимогу, за тригером задачі | Завантажується при виклику | Специфічний для Claude, розвивається |
Зверніть увагу на рядок .cursorrules. Цей один кореневий файл досі працює в Cursor, але він зник з документації, тож вважайте його застарілим. Нові проєкти мають використовувати .cursor/rules/*.mdc або AGENTS.md.
Який інструмент який файл читає? (Розвінчуємо міф про AGENTS.md)
Ось факт, щодо якого половина інтернету помиляється: Claude Code не читає AGENTS.md нативно, а Cursor не читає CLAUDE.md. Cursor читає .cursor/rules/*.mdc плюс AGENTS.md. Claude Code читає CLAUDE.md і нічого більше. Автоматичного фолбеку немає в жодному напрямку, і це підводить команди, які вважають, що один стандартний файл покриває все.
Це питають постійно, тож скажемо прямо. Якщо підкинути AGENTS.md у проєкт Claude Code, саме по собі це нічого не дасть. Claude Code читає CLAUDE.md і тільки CLAUDE.md. Документація Anthropic про пам'ять Claude Code описує поведінку завантаження файлів без жодної згадки про AGENTS.md, специфікація AGENTS.md називає Cursor і Codex серед нативних читачів, але не Claude Code, власна документація Cursor про правила підтверджує цей поділ, а GitHub-іш'ю Claude Code повні розробників, які натрапляють саме на цю стіну.
Тож чи читає Cursor claude.md? Ні. Чи читає Claude Code agents.md? Не без допомоги. Ця «допомога» — вся причина існування цього посту, і це дві короткі команди, які ви побачите далі.
Як працюють пріоритет і вкладеність, пліч-о-пліч
Кожен інструмент розв'язує конфлікти по-різному, і помилка тут — головне джерело плутанини «чому моє правило ігнорується?». Cursor зливає правила за пріоритетом джерела. Claude Code конкатенує за глибиною каталогу. AGENTS.md обирає найближчий файл у дереві. Добрий claude md management починається з розуміння, в якій ментальній моделі ви перебуваєте.
| Інструмент | Як завантажує | Переможець конфлікту |
|---|---|---|
| Cursor | Правила Team, Project та User злиті разом | Раніше джерело (Team) перемагає |
| Claude Code | Піднімається від cwd, конкатенує кожен CLAUDE.md | Перемагає найближчий/найспецифічніший файл; керований файл завантажується першим |
| AGENTS.md | Читає найближчий AGENTS.md у дереві каталогів | Перемагає найближчий до робочого каталогу файл |
У нашому сетапі практичний підсумок простий: широкі правила кладіть високо (корінь репо), а специфічні — низько (всередині теки пакета). І для Claude Code, і для AGENTS.md файл, найближчий до місця вашої роботи, має пріоритет, тож packages/api/AGENTS.md перевизначає кореневий для всього всередині тієї теки. Cursor — виняток: він розв'язує за рівнем джерела, а не за глибиною теки.
Ми прогнали один конфіг через Cursor + Claude Code: ось що насправді завантажив кожен інструмент
Ми протестували це на живому репо клієнта Techsy (бекенд на Next.js 15), використовуючи Cursor 3.7 (збірка від 17 червня 2026) та Claude Code v2.1.x (початок липня 2026). Один AGENTS.md, три сетапи спільного використання, той самий промпт відкрито в обох інструментах. Ось точно, що кожен підтягнув.
Ми почали з мінімального файлу:
# 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.Сетап 1: лише AGENTS.md. Cursor підхопив його одразу. Файл відобразився в його контексті, і він коректно відмовився пропонувати npm install. Claude Code нічого з ним не зробив. Запуск /memory у Claude Code показав нуль файлів пам'яті проєкту: CLAUDE.md не знайдено, а AGENTS.md навіть не згадано. Підтверджено: нативного фолбеку немає.
Сетап 2: симлінк. Ми спрямували CLAUDE.md на той самий файл:
ln -s AGENTS.md CLAUDE.mdТепер /memory у Claude Code показував ./CLAUDE.md як пам'ять проєкту, а завантажений вміст був нашим AGENTS.md байт-у-байт. Cursor досі читав AGENTS.md напряму. Один фізичний файл — обидва інструменти задоволені. На Windows для цього потрібно увімкнути режим адміністратора або режим розробника, інакше ln/mklink мовчки не спрацює.
Сетап 3: @import. Ми видалили симлінк і натомість поставили один рядок на самому верху справжнього CLAUDE.md:
@AGENTS.mdПісля цього /memory показував CLAUDE.md як завантажений файл, а AGENTS.md підтягувався як імпортоване посилання під ним. Це шлях, який Anthropic насправді документує, і він не потребує спеціальних дозволів ОС.
Вердикт нашого тесту: симлінк змушує Claude Code читати AGENTS.md байт-у-байт; імпорт @AGENTS.md — це безпечна для Windows версія, яку Anthropic насправді рекомендує. Обидва дають вам єдине джерело правди. Оберіть симлінк на macOS/Linux для нульового опосередкування, або рядок імпорту, якщо хтось у команді на Windows.
Міграція між форматами: .cursorrules → .cursor/rules → AGENTS.md
Більшість команд приходять сюди із застарілим файлом .cursorrules і хочуть вибратися з пастки одного файлу. Міграція коротка в будь-якому напрямку, а кроки — копіпаст. Одна пастка, яка кусає людей: файл .md всередині .cursor/rules без frontmatter мовчки ігнорується, тож він має бути .mdc.
Щоб модернізувати старий .cursorrules, у вас є два чисті шляхи:
- До
.cursor/rules/*.mdc: створіть.cursor/rules/general.mdc, додайте frontmatter (alwaysApply: trueдля глобального правила) і вставте старий вміст під ним. Видаліть.cursorrules, щойно перевірите. - До
AGENTS.md(рекомендовано для мультиінструментних команд): щоб конвертувати cursorrules в agents.md, скопіюйте тіло.cursorrulesу новийAGENTS.mdу корені репо. Frontmatter не потрібен; це звичайний Markdown. Потім додайте симлінк або імпорт@AGENTS.md, щоб Claude Code теж його читав.
Якщо ви залишаєтеся в Cursor і хочете витиснути з нього більше, наш гід про те, як отримати більше з Cursor щодня розкриває скоупинг правил на практиці.
У зворотному напрямку (AGENTS.md → CLAUDE.md) — це просто симлінк або імпорт з попереднього розділу. Втратної конверсії немає, бо всі три — Markdown під капотом.
Де місце SKILL.md та інструкцій Copilot?
У цій розмові з'являються ще два формати, і skills md зараз — пошуковий прорив, тож варто швидко розкласти їх по поличках. Жоден не замінює три головні файли; вони стоять поруч.
SKILL.md — це формат Skills від Anthropic: специфічні для задачі інструкції, упаковані в .claude/skills/*/SKILL.md, які Claude завантажує на вимогу, коли задача збігається, а не завжди увімкнені, як CLAUDE.md. Думайте про це як про спеціалізований плейбук, до якого Claude тягнеться, а не про файл пам'яті на весь проєкт. Скоуп досі розвивається, тож поки не інвестуйте забагато. Як це вписується у реальний робочий процес, дивіться де CLAUDE.md вписується у реальний робочий процес Claude Code.
Інструкції Copilot живуть у .github/copilot-instructions.md для GitHub Copilot. Хороша новина: Copilot теж читає AGENTS.md, тож якщо ви стандартизувалися на відкритому стандарті, Copilot уже покритий без окремого файлу.
Що використовувати? (За формою команди)
Підберіть формат під те, як насправді працює ваша команда:
- Самотній користувач Claude Code: просто використовуйте
CLAUDE.md. Немає причин додавати AGENTS.md, хіба що ви плануєте пізніше підключити Cursor або Codex. - Самотній користувач Cursor:
.cursor/rules/*.mdcдля glob-скоупу, або одинAGENTS.md, якщо хочете портативність з першого дня. - Команда зі змішаними інструментами: один
AGENTS.mdяк джерело правди, з симлінком або імпортом уCLAUDE.md. Додайте невеликий файл.cursor/rulesлише для специфічної для Cursor поведінки. - Монорепо:
AGENTS.mdу корені плюс вкладені файли для кожного пакета, тож кожен підпроєкт описує себе, а найближчий файл перемагає.
У Techsy ми стандартизуємо конфіг AI-кодингу в командах зі змішаними інструментами — зазвичай один AGENTS.md як джерело правди з перевизначеннями для інструменту там, де він їх потребує. Якщо ваша команда вручну жонглює трьома файлами конфігу, отримайте безкоштовну консультацію, і ми все розкладемо.
Остання підказка: цей пост порівнює файли конфігу. Якщо ви насправді намагаєтеся обрати між самими інструментами, читайте порівняння самих асистентів, а не їхнього конфігу.
Про автора
Mert Batur Gurbuz — співзасновник Techsy.io, де команда доставляє AI-агентів, системи автоматизації та voice/SDR-пайплайни для B2B-клієнтів. Він навчається в Бірмінгемському університеті й пише про стек інструментів LLM, який команда Techsy насправді використовує в продакшні.
Співзасновник, Techsy.io · Бірмінгемський університет · LinkedIn
Часті запитання
Чи читає Cursor CLAUDE.md?
Ні. Cursor нативно читає .cursor/rules/*.mdc та AGENTS.md, але CLAUDE.md ніде не згадується в документації Cursor і не завантажується. Якщо ви на Cursor і хочете ділитися конфігом з користувачами Claude Code, кладіть правила в AGENTS.md (який Cursor читає), а не в CLAUDE.md.
Чи читає Claude Code AGENTS.md?
Не нативно. Claude Code читає лише CLAUDE.md, без автоматичного фолбеку на AGENTS.md. Щоб це запрацювало, або зробіть симлінк файлів (ln -s AGENTS.md CLAUDE.md), щоб Claude читав AGENTS.md байт-у-байт, або додайте @AGENTS.md у рядок 1 CLAUDE.md, щоб імпортувати його. Імпорт — рекомендований Anthropic, безпечний для Windows варіант.
Чи можу я просто використовувати один файл для всіх трьох інструментів?
Так. Візьміть AGENTS.md як єдине джерело правди, і Cursor та Codex читатимуть його напряму. Для Claude Code додайте один місток: або симлінк AGENTS.md на CLAUDE.md, або поставте @AGENTS.md на верх CLAUDE.md. Ви підтримуєте один файл, а кожен інструмент завантажує ті самі правила. Це й є весь рецепт спільного конфігу.
Чи .cursorrules застарілий?
М'яко застарілий. Один файл .cursorrules у корені репо досі працює в Cursor, але його більше немає в офіційній документації, що є звичним сигналом, що формат відходить. Нові проєкти мають використовувати .cursor/rules/*.mdc для правил зі скоупом або AGENTS.md для портативності.
Як конвертувати .cursorrules в AGENTS.md?
Скопіюйте тіло вашого файлу .cursorrules у новий AGENTS.md у корені репо. Це звичайний Markdown, тож frontmatter чи переформатування не потрібні. Потім додайте симлінк або імпорт @AGENTS.md, щоб Claude Code теж його читав, і видаліть старий .cursorrules, щойно переконаєтеся, що Cursor підхоплює новий файл.
У чому різниця між CLAUDE.md і AGENTS.md?
CLAUDE.md — це пропрієтарний файл пам'яті Claude Code, який читає лише Claude Code. AGENTS.md — це відкритий стандарт, який читають Cursor, Codex, Copilot та понад 20 інших інструментів, але не Claude Code нативно. Той самий формат Markdown, та сама робота. Різниця — в охопленні. AGENTS.md мандрує між інструментами; CLAUDE.md лишається всередині Claude Code.
На якому форматі має стандартизуватися команда, що використовує кілька AI-інструментів?
AGENTS.md. Це відкритий стандарт, який нативно читає більшість інструментів і який уже є у понад 60 000 репо. Стандартизуйте спільні правила там, з'єднайте з Claude Code через симлінк або імпорт і додавайте невеликі специфічні для інструменту файли (як-от .cursor/rules) лише там, де один інструмент потребує поведінки, якої немає в інших.
Як працює пріоритет, коли у мене вкладені файли конфігу?
І для Claude Code, і для AGENTS.md перемагає файл, найближчий до вашого робочого каталогу, тож правило в packages/api/AGENTS.md перевизначає файл у корені репо для всього всередині тієї теки. Cursor інакший: він зливає правила Team, Project та User за рівнем джерела, а не за глибиною теки, і раніші джерела перемагають у конфліктах.
Де місце SKILL.md?
SKILL.md — це новий формат Skills від Anthropic: специфічні для задачі інструкції в .claude/skills/*/SKILL.md, які Claude завантажує на вимогу, коли задача збігається, а не завжди увімкнені, як CLAUDE.md. Він доповнює CLAUDE.md, а не замінює його. Скоуп досі розвивається у 2026, тож вважайте його спеціалізованим доповненням, а не четвертим файлом, який потрібен кожному проєкту.