Definicja
CLAUDE.md
CLAUDE.md to plik markdown, który Claude Code odczytuje automatycznie jako kontekst projektu. Leży w katalogu głównym albo w podkatalogach dla reguł o węższym zakresie i definiuje standardy kodowania, typowe polecenia i notatki architektoniczne. Tworzy go /init, aktualizuje /memory albo skrót #.
Dlaczego to ważne
Bez niego każda sesja zaczyna się od tłumaczenia projektu od nowa. Z nim standardy, polecenia i notatki architektoniczne są już wczytane — a to różnica między agentem, który zgaduje twoje konwencje, a takim, który ich przestrzega.
Jak radzi sobie z tym każde narzędzie
- Cursor
- Używa zamiast tego
.cursor/rulesi.cursorignore. - Claude Code
- Format natywny, czytany hierarchicznie od katalogu głównego w dół.
- Codex
- Używa zamiast tego AGENTS.md, w tym samym celu.
Najczęstsze pytania
Gdzie umieścić CLAUDE.md?
W katalogu głównym dla reguł obejmujących cały projekt i w podkatalogach, gdy reguła ma dotyczyć tylko części repozytorium. Claude Code czyta hierarchię, więc plik zagnieżdżony zawęża zakres, zamiast zastępować ten z katalogu głównego.
Czy CLAUDE.md to to samo co AGENTS.md?
Ten sam cel, inna konwencja. AGENTS.md jest rozpoznawany przez Codex i coraz częściej przez inne narzędzia; CLAUDE.md czyta Claude Code. Projekty używane przez oba zwykle trzymają oba pliki.
Czy Cursor czyta CLAUDE.md?
Nie. Cursor czyta .cursor/rules i .cursorignore, a Codex AGENTS.md. Te trzy konwencje robią to samo pod różnymi nazwami plików, dlatego repozytorium obsługiwane przez kilku agentów zwykle zawiera więcej niż jeden z nich.