CLAUDE.md vs AGENTS.md:który agent czyta który plik.

Czym jest każdy z plików

Oba to zwykły Markdown, który agent wczytuje do kontekstu na początku sesji. Zapisujesz w nich polecenia budowania i testów, styl kodu, układ projektu i reguły takie jak "nigdy nie edytuj wygenerowanych plików". To instrukcje, a nie wymuszone ustawienia: agent traktuje je jako wskazówki.

• CLAUDE.md jest specyficzny dla Claude Code. Może leżeć w katalogu głównym projektu (./CLAUDE.md lub ./.claude/CLAUDE.md), w ~/.claude/CLAUDE.md dla wszystkich twoich projektów oraz w podfolderach. CLAUDE.local.md zawiera prywatne notatki do jednego projektu.
• AGENTS.md to otwarty format opisany na agents.md, README dla agentów. Czytają go Codex, Cursor, agent do kodowania GitHub Copilot, Gemini CLI, Zed i wielu innych. W monorepo AGENTS.md w podfolderze obowiązuje dla tej części, a wygrywa najbliższy plik.

Treść jest tego samego rodzaju. Różni się to, które narzędzie plik podchwytuje.

Co Claude Code robi z AGENTS.md

Dokumentacja Claude Code opisuje trzy przypadki, dla wersji 2.1.277 lub nowszej:

• Tylko AGENTS.md w projekcie, bez CLAUDE.md: Claude Code czyta AGENTS.md.
• Oba pliki w projekcie: Claude Code czyta tylko pliki CLAUDE.md.
• CLAUDE.md, który importuje AGENTS.md przez @AGENTS.md: Claude czyta CLAUDE.md wraz z dołączonym AGENTS.md.

Ten drugi przypadek zaskakuje ludzi. Jeśli dodasz CLAUDE.md, nawet maleńki, do repozytorium, które ma AGENTS.md, Claude przestaje czytać AGENTS.md, chyba że CLAUDE.md go importuje. To samo dotyczy CLAUDE.local.md. Starsze wersje Claude Code czytały tylko CLAUDE.md, dlatego import nadal jest bezpiecznym wyborem. Dokumentacja opisuje też ustawienie Project instructions w /config, które sprawia, że Claude czyta oba pliki razem.

Utrzymanie jednego zestawu instrukcji

Wybierz jeden plik jako źródło prawdy. Udokumentowano dwa sposoby:

1. Import AGENTS.md z CLAUDE.md

   Utwórz CLAUDE.md obok AGENTS.md, którego pierwsza linia to @AGENTS.md, a poniżej dodaj instrukcje tylko dla Claude. Importy używają składni @ścieżka, ścieżki względne rozwiązują się od pliku, który je zawiera, a importowane pliki mogą importować kolejne do czterech poziomów w głąb.

2. Dowiązanie symboliczne CLAUDE.md do AGENTS.md

   Uruchom ln -s AGENTS.md CLAUDE.md, jeśli nie masz nic specyficznego dla Claude do dodania. Dokumentacja ostrzega, że narzędzia edycji Claude nie zapisują przez dowiązanie symboliczne, a w Windows zatwierdzone dowiązanie może zostać pobrane jako jednoliniowy plik tekstowy, więc import jest bezpieczniejszym wyborem dla wspólnego repozytorium.

Unikaj trzeciego podejścia: CLAUDE.md, który słowami mówi "przeczytaj AGENTS.md". Claude widzi plik tylko wtedy, gdy zdecyduje się go otworzyć, a import wczytuje go za każdym razem.

Wspólny AGENTS.md

Umieść w AGENTS.md to, czego potrzebuje każdy agent:

# AGENTS.md

## Commands
- Install: `npm ci`
- Test: `npm test`
- Lint: `npm run lint`

## Conventions
- TypeScript, strict mode. No default exports.
- Update the tests with every change.

## Do not
- Edit files under `generated/`.
- Commit without running the tests.

Niech będzie krótki i konkretny. Dokumentacja Claude Code sugeruje zostać poniżej około 200 linii na CLAUDE.md, ponieważ dłuższe pliki kosztują kontekst i są mniej niezawodnie przestrzegane.

Częste błędy

• Dwa pliki, które się rozjeżdżają. Jedna kopia jest aktualizowana, druga nie. Użyj importu.
• Dodanie CLAUDE.md i utrata AGENTS.md. Patrz wyżej: zaimportuj go.
• Sekrety w którymś z plików. Są zatwierdzane i wczytywane do każdej sesji.
• Niejasne reguły. "Pisz czysty kod" nic nie daje. "Uruchom npm test, zanim powiesz, że skończyłeś" daje.
• Sprzeczne reguły w pliku folderu nadrzędnego i pliku podfolderu.

Czytanie i przeglądanie tych plików

Oba to zwykły Markdown, więc DotMD otwiera CLAUDE.md i AGENTS.md jak każdy plik .md, ze spisem treści i historią każdej zmiany, i pokazuje, co agent w nich zmienił. Czytanie jest bezpłatne. Zobacz też Claude Code i Codex z DotMD.

Pytania o CLAUDE.md i AGENTS.md

Więcej pytań