AGENTS.md i CLAUDE.md. Claude Code czyta AGENTS.md sam, dopóki nie dodacie CLAUDE.md

Czym różnią się AGENTS.md i CLAUDE.md, kiedy Claude Code czyta AGENTS.md bez niczyjej pomocy i jak trzymać jedno źródło zasad dla wszystkich agentów.

Część przewodnikaClaude Code. Kompletny przewodnik od instalacji po własne skille i pluginy

W tym tekście
  1. Czym różnią się AGENTS.md i CLAUDE.md
  2. Kiedy Claude Code czyta AGENTS.md
  3. Jedno źródło dla obu, czyli import @AGENTS.md
  4. Dowiązanie symboliczne zamiast importu
  5. Stare obejścia do posprzątania

W skrócie

Claude Code od wersji 2.1.277 czyta AGENTS.md sam, ale tylko wtedy, gdy w projekcie nie ma CLAUDE.md ani CLAUDE.local.md. Gdy potrzebujecie obu plików, jednym źródłem zostaje AGENTS.md, a CLAUDE.md zaczyna się od linijki @AGENTS.md. Na Windowsie zamiast dowiązania symbolicznego używajcie importu.

W repozytorium leżą dwa pliki o prawie tej samej treści. AGENTS.md dla Codex i Cursora, CLAUDE.md dla Claude Code. Ktoś zmienił polecenie do testów w jednym, a w drugim zostało stare. Od tej chwili dwa agenty pracują według dwóch różnych zasad i nikt tego nie widzi. Da się tego uniknąć, bo AGENTS.md i CLAUDE.md można prowadzić jako jedno źródło.

Tekst należy do przewodnika po Claude Code. Opieramy się na dokumentacji Anthropic o pamięci Claude Code, stan na 10 listopada 2026.

Czym różnią się AGENTS.md i CLAUDE.md

Oba to zwykłe pliki Markdown z instrukcjami dla agenta, który pracuje na kodzie. Różnica polega na tym, kto je czyta i gdzie mogą leżeć.

AGENTS.mdCLAUDE.md
Formatotwarty, opisany na agents.mdplik Claude Code
Kto czytaCodex, Cursor, Copilot i inneClaude Code
Claude Codeczyta, gdy nie ma CLAUDE.mdczyta zawsze
Pliki osobistew Codex ~/.codex/AGENTS.md~/.claude/CLAUDE.md i CLAUDE.local.md

CLAUDE.md ma też rzeczy, których inne narzędzia nie znają. Na przykład sekcję Compact Instructions, która mówi, co zachować przy streszczaniu rozmowy, albo reguły w .claude/rules/, wczytywane dopiero przy pracy na pasujących plikach. Czym jest sam AGENTS.md i jak czyta go Codex, opisaliśmy w tekście AGENTS.md, co to jest.

Kiedy Claude Code czyta AGENTS.md

Od wersji 2.1.277 Claude Code czyta AGENTS.md bez importu i bez dodatkowych ustawień. Dokumentacja Anthropic opisuje to tabelą.

W repozytorium jestClaude czyta
AGENTS.md bez CLAUDE.md i CLAUDE.local.mdAGENTS.md
AGENTS.md oraz CLAUDE.md albo CLAUDE.local.mdtylko CLAUDE.md
CLAUDE.md z importem @AGENTS.mdCLAUDE.md razem z AGENTS.md

Liczy się CLAUDE.md, .claude/CLAUDE.md i CLAUDE.local.md w folderze, w którym uruchamiacie Claude Code, i w każdym folderze nad nim. Wasz osobisty ~/.claude/CLAUDE.md, firmowy plik od działu IT i reguły z .claude/rules/ się nie liczą, więc wczytują się razem z AGENTS.md. Gdy Claude wczyta AGENTS.md na starcie, w rozmowie widać linijkę zaczynającą się od no CLAUDE.md found ze ścieżką do pliku.

Jest tu pułapka. Wystarczy, że ktoś doda sobie CLAUDE.local.md na prywatne notatki, i Claude przestaje dla niego czytać AGENTS.md. Do tego Claude Code w ogóle nie czyta plików AGENTS.local.md i AGENTS.override.md ani niczego w folderze .agents/. Plik override zna Codex, ale do Claude nie trafi.

Domyślne zachowanie zmienia się w ustawieniach. Wpiszcie /config w sesji i ustawcie pole Project instructions.

WartośćCo Claude czyta
claude-md-or-agents-mdCLAUDE.md, a AGENTS.md tylko bez CLAUDE.md, ustawienie domyślne
claude-md-and-agents-mdoba, w każdym folderze najpierw CLAUDE.md
claude-mdtylko CLAUDE.md
managed-onlytylko firmowy plik od działu IT i automatyczną pamięć

Czasem AGENTS.md nie wczyta się wcale. Dzieje się tak w wersjach starszych niż 2.1.277, po wyłączeniu wbudowanej wtyczki, która go czyta, i czasem w pierwszej sesji po aktualizacji. Wtedy pola Project instructions w /config po prostu nie ma.

Jedno źródło dla obu, czyli import @AGENTS.md

Najpewniejszy układ wygląda tak. Wszystkie wspólne zasady trzymacie w AGENTS.md. Obok leży krótki CLAUDE.md, który zaczyna się od importu, a pod nim ma tylko to, co dotyczy samego Claude Code.

CLAUDE.md
@AGENTS.md

## Claude Code

Zmiany w `src/billing/` zaczynaj w trybie planowania.

Claude czyta najpierw zaimportowany plik, potem resztę. Według dokumentacji import nigdy nie sprawia, że AGENTS.md trafi do kontekstu dwa razy, niezależnie od ustawienia Project instructions. Taki układ działa więc także w sesjach, które nie czytają AGENTS.md bezpośrednio.

Przejście z dwóch plików na jeden zajmuje kilka minut.

  1. Przenieście wspólne zasady z CLAUDE.md do AGENTS.md. Polecenia do testów, styl kodu, zasady pull requestów.
  2. W CLAUDE.md zostawcie w pierwszej linijce @AGENTS.md, a pod nią tylko rzeczy dla Claude Code.
  3. Uruchomcie nową sesję i wpiszcie /context all.
  4. Sprawdźcie, czy na liście Memory files jest CLAUDE.md.

Jeśli w CLAUDE.md nie zostało nic poza importem, możecie go usunąć i pozwolić Claude czytać AGENTS.md bezpośrednio. Dokumentacja radzi go jednak zostawić, gdy część Waszych sesji nie umie wczytać AGENTS.md sama. Gotowe wzory plików są w tekście przykłady CLAUDE.md.

Dowiązanie symboliczne zamiast importu

Jeśli nie macie żadnych zasad tylko dla Claude, wystarczy dowiązanie symboliczne.

bash
ln -s AGENTS.md CLAUDE.md

Gdy się uda, polecenie niczego nie wypisuje. Dokumentacja wymienia dwa ograniczenia. Claude czyta CLAUDE.md przez dowiązanie, ale jego narzędzia do edycji odmawiają zapisu przez nie i każą zmieniać AGENTS.md.

Drugie dotyczy Windowsa. Utworzenie dowiązania wymaga tam uprawnień administratora albo trybu dewelopera. Git bez włączonego core.symlinks zapisuje takie dowiązanie jako zwykły plik tekstowy z jedną linijką. Claude dostaje wtedy tę linijkę zamiast Waszych zasad. Jeśli ktokolwiek w projekcie pracuje na Windowsie, wybierzcie import.

Stare obejścia do posprzątania

Kto przed wersją 2.1.277 ustawiał Claude Code do czytania AGENTS.md, może mieć w projekcie jedno z obejść. CLAUDE.md, który słowami każe przeczytać AGENTS.md, zostawia decyzję modelowi, bo Claude zobaczy plik tylko wtedy, gdy sam zdecyduje się go otworzyć. Zamieńcie to zdanie na import albo usuńcie CLAUDE.md. Hook SessionStart, który wypisywał AGENTS.md do rozmowy, trzeba usunąć, bo teraz dokłada drugą kopię.

W drugą stronę jest prościej. Codex domyślnie CLAUDE.md nie czyta. Inne nazwy plików można mu dopisać do listy project_doc_fallback_filenames, ale przy jednym źródle w AGENTS.md nie ma takiej potrzeby. Jak w ogóle pisać takie instrukcje, opisaliśmy w tekście CLAUDE.md, jak go napisać.

Jeśli dziś macie w repozytorium dwa pliki, zacznijcie od porównania ich treści i przeniesienia wspólnej części do AGENTS.md. Potem sprawdźcie /context all, czy Claude widzi to, co trzeba.

Jeśli chcecie wiedzieć, gdzie AI może zdjąć pracę z Waszej firmy, zamówcie bezpłatny audyt AI. Przejrzymy Wasze zadania i powiemy, od czego zacząć.

Co chcecie zmienić w swojej firmie?

Zostawcie numer. Porozmawiamy o Waszym procesie i sprawdzimy, czy możemy pomóc. Pierwsza rozmowa jest bezpłatna.

Kiedy najlepiej zadzwonić?
Administrator: Oleksandr Bondarenko (BondSoft)Polityka prywatnościRegulamin
Szczegóły prawne

Administratorem danych jest Oleksandr Bondarenko, prowadzący działalność gospodarczą pod firmą Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Dane przetwarzamy wyłącznie w celu kontaktu w sprawie Twojego zapytania i przedstawienia oferty — na podstawie Twojej zgody (art. 6 ust. 1 lit. a RODO oraz art. 398 ustawy Prawo komunikacji elektronicznej) oraz naszego prawnie uzasadnionego interesu polegającego na obsłudze zapytania (art. 6 ust. 1 lit. f RODO).

Podanie danych jest dobrowolne, ale niezbędne do kontaktu zwrotnego. Zgodę możesz wycofać w każdej chwili, pisząc na office@bondsoft.pl — nie wpływa to na zgodność z prawem przetwarzania sprzed wycofania.

Masz prawo dostępu do danych, ich sprostowania, usunięcia, ograniczenia przetwarzania, przenoszenia oraz wniesienia skargi do Prezesa Urzędu Ochrony Danych Osobowych.

Pełna informacja: Polityka prywatności.

Napiszcie e-mail

Usługa, o której jest ten tekst

Automatyzacja i AI / OCR

Automatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.