Czym jest CLAUDE.md?
CLAUDE.md to plik instrukcji Claude Code. Wczytuje się na starcie sesji z katalogu głównego projektu i z ~/.claude/CLAUDE.md, a z podkatalogu wtedy, gdy agent w nim pracuje; zawiera polecenia, konwencje i pułapki, których Claude nie wywnioskuje z kodu. /init tworzy szkic, /memory go edytuje, a @ścieżka/do/pliku dołącza inny plik. Kieruje modelem, ale niczego nie wymusza.
- Po angielsku
- CLAUDE.md
- Pierwsze wdrożenie
- Poziom 2, darmowy przewodnik
- Szukane też jako
- plik CLAUDE.md, plik pamięci Claude Code
249,99 zł jednorazowo za 12 miesięcy dostępu. Nic się samo nie odnawia. Zwrot w ciągu 30 dni przy pierwszym zakupie.
Dlaczego to ważne.
Bez niego dwie sesje w tym samym repozytorium zachowują się różnie, bo tylko jedna dowiedziała się o konwencjach: model jest ten sam, kontekst nie. Z nim polecenia i konwencje ładują się za każdym razem i przechodzą review jak kod. Pozostaje jednak wskazówką: to, co ma się dziać zawsze, należy do hooka albo reguły uprawnień.
Jedna reguła, dwa sposoby
Ta sama instrukcja, wpisana w czat i zapisana w pliku, po kompakcji kontekstu.
- Wskazówka, którą waży model
- Mechanizm, który działa
- Na czym możesz polegać
Powiedziana raz, w czacie Nie zostaje
-
Reguła
Mówisz: używamy pnpm, nigdy npm
Wpisana w rozmowę, na początku sesji.
-
Sesja
Okno się zapełnia i jest kompaktowane
Starsze fragmenty są streszczane, a ograniczenie podane na początku może nie przetrwać streszczenia.
-
Na czym możesz polegać
Na niczym: żyła tylko w czacie
Instrukcje podane tylko w czacie przepadają po
/compact.
Zapisana w CLAUDE.md Czytana z dysku
-
Reguła
Linia w pliku:
we use pnpm, never npm or yarnNapisana tak konkretnie jak prompt, w repozytorium i sprawdzana jak kod.
-
Wczytanie
Claude Code wczytuje go przy starcie
/contextpokazuje go w sekcji Memory files; plik spoza tej listy dla Claude nie istnieje. -
Kompaktowanie
Plik z katalogu głównego jest czytany z dysku od nowa
Pliki z podkatalogów i reguły ze ścieżkami wracają, gdy Claude znowu czyta pasujący plik.
-
Na czym możesz polegać
Tekst wraca do kontekstu
Claude nadal może go zważyć z innymi instrukcjami: plik kieruje, ale niczego nie wymusza. Wymusza hook albo reguła
permissions.deny.
Jak robi to każde narzędzie.
Cursor, Claude Code i Codex nazywają to po swojemu. Każda notatka ma datę sprawdzenia.
Cursor
Stosuje instrukcje przez Rules w .cursor/rules/. Dokumentacja Cursora mówi, że czyta on CLAUDE.md tak samo jak AGENTS.md i zawsze go stosuje; środowisko uruchomieniowe agenta w @cursor/sdk 1.0.32 (sprawdzone 2026-09-26) ładuje CLAUDE.md i CLAUDE.local.md tylko przy włączonym ładowaniu konfiguracji zewnętrznej, a AGENTS.md ładuje bezwarunkowo.
Oba źródła różnią się w sprawie CLAUDE.md, więc jeśli twój zespół używa też Claude Code, załóż, że kosztuje tokeny przy każdym żądaniu w Cursorze. Żeby sprawdzić swoją wersję, zapytaj nowy czat Agent, jakie pliki instrukcji wczytał, i powtarzaj pytanie po każdej aktualizacji Cursora.
Przewodnik po zarządzaniu tokenami w Cursorze, 2026-10-12
Claude Code
Ładowany przy starcie z katalogu głównego projektu i z ~/.claude/, a z podkatalogu, gdy Claude czyta tam plik; pliki się sumują i żaden nie nadpisuje innego.
Starsze poradniki każą zacząć wiadomość od #, żeby zapisać wspomnienie. Claude Code usunął ten skrót w v2.0.70 (2025-12-15): poproś Claude o edycję CLAUDE.md albo otwórz plik przez /memory.
Przewodnik po inicjalizacji projektu, Claude Code 2.1.283, 2026-09-26
Codex
Czyta natywnie AGENTS.md; tworzy go /init.
Codex łączy jeden plik globalny z ~/.codex/ z co najwyżej jednym plikiem projektu na katalog, od katalogu głównego w dół, więc głębsze pliki trafiają później. Projekt oznaczony jako niezaufany nie dostarcza plików projektu.
Przewodnik po AGENTS.md w Codeksie, Codex CLI 0.157.1, 2026-09-26
Najczęstsze pytania.
Gdzie umieścić CLAUDE.md?
W katalogu głównym projektu (./CLAUDE.md albo ./.claude/CLAUDE.md) dla reguł wspólnych dla zespołu, w ~/.claude/CLAUDE.md dla twoich preferencji w każdym projekcie i w CLAUDE.local.md dla notatek o jednym checkoucie (ten plik dopisujesz do .gitignore sam). CLAUDE.md w podkatalogu ładuje się, gdy Claude czyta tam plik. Pliki się sumują i żaden nie nadpisuje innego, więc konflikt naprawiasz, usuwając regułę.
Czy CLAUDE.md to to samo co AGENTS.md?
To samo zadanie, inne narzędzia: Claude Code czyta CLAUDE.md, a Codex AGENTS.md. Od v2.1.277 (oba kanały wydań, stan na 2026-10-12) Claude Code czyta też AGENTS.md, ale domyślnie tylko gdy nie ma CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md, więc dodanie CLAUDE.md po cichu ukrywa twój AGENTS.md. Trzymaj reguły w AGENTS.md, a w CLAUDE.md dołącz go przez @AGENTS.md, albo ustaw Project instructions w /config na claude-md-and-agents-md, żeby ładować oba.
Czy CLAUDE.md coś wymusza?
Nie. Jego treść trafia jako wiadomość użytkownika po prompcie systemowym, więc kieruje Claude’em, ale niczego nie wymusza. To, co ma się dziać za każdym razem, na przykład lint po edycji albo zakaz dotykania migrations/, należy do hooka albo reguły permissions.deny.
Czy Cursor czyta CLAUDE.md?
Tak, według dokumentacji Cursora (sprawdzone 2026-10-12): czyta pliki CLAUDE.md tak samo jak AGENTS.md i zawsze je stosuje. Środowisko uruchomieniowe agenta w @cursor/sdk 1.0.32 (sprawdzone 2026-09-26) jest bardziej restrykcyjne: traktuje CLAUDE.md i CLAUDE.local.md jako instrukcje tylko przy włączonym ładowaniu konfiguracji zewnętrznej, a AGENTS.md ładuje bezwarunkowo. Zapytaj nowy czat Agent, jakie pliki instrukcji wczytał.
Czytaj dalej.
Przewodniki, które idą głębiej, oraz hasła i porównania obok tego.
W dokumentacji
Powiązane hasła
Czy ta strona odpowiada na Twoje pytania?
Jedno kliknięcie, bez logowania.
Czego tu szukasz?
Co Cię powstrzymuje?
Jak się to czyta?
Dzięki. Jeśli zostawiasz e-mail, odpisze Ci Michał.
Odpowiada na Twoje pytania?
Każde to jedno kliknięcie. Zamknij, kiedy chcesz.
bez logowania
Czytaj przewodniki w tych samych słowach.
Otwórz wszystkie przewodniki z Toolkitem. Każde hasło jest tu zdefiniowane raz, a przewodniki używają go tak samo.
249,99 zł jednorazowo za 12 miesięcy dostępu. Nic się samo nie odnawia. Zwrot w ciągu 30 dni przy pierwszym zakupie.
Odpisuje Michał, nie automat. Adres służy tylko tej odpowiedzi.