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.

Ostatnia aktualizacja
Autor:
Opublikowano
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.

Na tej stronie Dlaczego to ważneJak robi to każde narzędziePytania

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

  1. Reguła

    Mówisz: używamy pnpm, nigdy npm

    Wpisana w rozmowę, na początku sesji.

  2. Sesja

    Okno się zapełnia i jest kompaktowane

    Starsze fragmenty są streszczane, a ograniczenie podane na początku może nie przetrwać streszczenia.

  3. 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

  1. Reguła

    Linia w pliku: we use pnpm, never npm or yarn

    Napisana tak konkretnie jak prompt, w repozytorium i sprawdzana jak kod.

  2. Wczytanie

    Claude Code wczytuje go przy starcie

    /context pokazuje go w sekcji Memory files; plik spoza tej listy dla Claude nie istnieje.

  3. 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.

  4. 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.

Treść CLAUDE.md trafia jako wiadomość użytkownika po prompcie systemowym. To mechaniczny powód, dla którego jest tylko wskazówką. Źródło: Przewodnik po pamięci Claude Code, Claude Code 2.1.283, 2026-09-26.

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ł.

Czy ta strona odpowiada na Twoje pytania?

Jedno kliknięcie, bez logowania.

wcale w pełni

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.