# Claude Code odczytuje teraz AGENTS.md: zmiany w wersji 2.1.277 > 18 września 2026 r. Claude Code 2.1.277 zyskał bezpośrednią obsługę AGENTS.md: kiedy plik jest wczytywany, jak wybrać jeden z 4 trybów i co zrobić z importami. Source: https://ailoot.ai/blog/pl/claude-code-agents-md-support/ Canonical: https://ailoot.ai/blog/pl/claude-code-agents-md-support/ Language: pl Publisher: Ailoot (https://ailoot.ai/) Translation: guide-041 Revision: sha256-1be226a9b8edf1aea791db97127d169131796260d58f275773d00402ffa3a4d3 18 września 2026 r. w Claude Code 2.1.277 dodano obsługę `AGENTS.md`. Jeśli funkcja jest dostępna w sesji i katalogu roboczym, a w żadnym katalogu nadrzędnym nie ma `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`, Claude Code domyślnie odczytuje `AGENTS.md` bez ręcznego importu. Wcześniej trzeba było użyć importu `@AGENTS.md` w `CLAUDE.md` albo utworzyć dowiązanie symboliczne `CLAUDE.md` do `AGENTS.md` — więcej informacji znajdziesz w artykule [o jednym pliku instrukcji dla kilku agentów](https://ailoot.ai/blog/pl/agents-md-claude-md-one-instruction-file/). Jeśli w tym samym repozytorium używasz Claude Code i jednego lub dwóch innych narzędzi, wybrany tryb Project instructions określa, które pliki z instrukcjami odczyta Claude Code. Poniżej opisano warunki dotyczące każdego z czterech trybów oraz kroki przejścia ze starej konfiguracji. Więcej materiałów o konfigurowaniu narzędzi znajdziesz w [dokumentacji Ailoot](https://ailoot.ai/docs/).
[Przewodniki Ailoot](https://ailoot.ai/docs/)
## Co zmieniło się w wersji 2.1.277?
Najważniejsze informacje Od 18 września 2026 r. Claude Code domyślnie odczytuje `AGENTS.md`, jeśli w żadnym katalogu na ścieżce od katalogu roboczego w górę nie ma `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`. Jeśli taki plik istnieje, Project instructions nie włącza automatycznego odczytu `AGENTS.md`. Jawny import `@AGENTS.md` z `CLAUDE.md` nadal działa. Pliki użytkownika `~/.claude/CLAUDE.md`, zarządzany przez organizację `CLAUDE.md` oraz `.claude/rules/` są wczytywane niezależnie od wyboru plików projektu. Tryb można zmienić za pomocą `/config`. Funkcja nie jest jeszcze dostępna w Bedrock, Vertex ani Foundry.
Oficjalny plik CHANGELOG.md projektu Claude Code na GitHubie opisuje to tak:

Dodano obsługę AGENTS.md: w projekcie bez CLAUDE.md Claude Code odczytuje zamiast niego AGENTS.md; można to zmienić w sekcji „Project instructions” polecenia /config (funkcja nie jest jeszcze dostępna w Bedrock, Vertex ani Foundry)

— Anthropic, commit claude-code CHANGELOG.md, ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
Tłumaczenie: dodano obsługę `AGENTS.md` — w projekcie bez `CLAUDE.md` Claude Code odczytuje teraz zamiast niego `AGENTS.md`; można to zmienić w sekcji „Project instructions” polecenia `/config` (funkcja nie jest jeszcze dostępna w Bedrock, Vertex ani Foundry). Przed tą wersją sam brak `CLAUDE.md`, `.claude/CLAUDE.md` i `CLAUDE.local.md` w katalogu roboczym oraz jego katalogach nadrzędnych nie powodował odczytu `AGENTS.md`. Wymagany był jawny import, dowiązanie symboliczne albo ręczny hook. Teraz, gdy funkcja jest dostępna, agent automatycznie wczytuje plik. ## Które pliki blokują automatyczny odczyt AGENTS.md
Najważniejsze informacje W trybie domyślnym pliki `CLAUDE.md`, `.claude/CLAUDE.md` i `CLAUDE.local.md` są sprawdzane w katalogu roboczym i jego katalogach nadrzędnych. Pliki osobiste `~/.claude/CLAUDE.md`, zarządzany przez organizację `CLAUDE.md` oraz pliki z `.claude/rules/` nie blokują odczytu `AGENTS.md` i są wczytywane razem z nim.
Jeśli masz osobisty plik `~/.claude/CLAUDE.md` z ustawieniami stylu kodowania, nie uniemożliwi on Claude Code odczytania projektowego `AGENTS.md`. Jednak dowolny `CLAUDE.local.md` w katalogu roboczym — nawet taki, którego nie dodano do Git i który służy do osobistych notatek — blokuje automatyczny odczyt `AGENTS.md` w trybie domyślnym. Jawny import nadal działa; aby odczytywać bezpośrednio oba pliki, trzeba zmienić tryb. Jeśli w sekcji Project instructions wybrano tryb bezpośredniego odczytu (zobacz „4 tryby Project instructions — który wybrać” poniżej), a w katalogu roboczym ani jego katalogach nadrzędnych nie ma `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`, Claude Code wczytuje przy uruchomieniu sesji wszystkie pliki `AGENTS.md` i `.claude/AGENTS.md` znajdujące się w tych katalogach. Gdy nie ma plików blokujących, dokumentacja pokazuje w sesji interaktywnej wiersz podobny do tego: ``` no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md ``` Plik `AGENTS.md` w podkatalogu jest wczytywany, gdy Claude otwiera znajdujący się tam plik za pomocą narzędzia Read. W trybie `claude-md-or-agents-md` dzieje się tak tylko wtedy, gdy w tym podkatalogu nie ma własnego `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`. W przypadku trybu `claude-md-and-agents-md` dokumentacja opisuje ogólną zasadę: w każdym katalogu najpierw odczytywany jest `CLAUDE.md`, a następnie `AGENTS.md`. Pliki `AGENTS.local.md`, `AGENTS.override.md` ani żadne pliki w katalogu `.agents/` nie są odczytywane automatycznie. Materiały dotyczące konfigurowania obszaru roboczego agenta AI, w tym plików instrukcji zawierających kontekst projektu, znajdziesz w [dokumentacji Ailoot](https://ailoot.ai/docs/).
[Przewodniki Ailoot](https://ailoot.ai/docs/)
## 4 tryby Project instructions — który wybrać
Najważniejsze informacje W sekcji Project instructions polecenia `/config` dostępne są cztery wartości: `claude-md-or-agents-md` (domyślnie — jeden z dwóch plików), `claude-md-and-agents-md` (oba pliki razem), `claude-md` (automatycznie odczytywany jest tylko `CLAUDE.md`, nawet jeśli projekt zawiera wyłącznie `AGENTS.md`) oraz `managed-only` (przy uruchomieniu tylko zarządzany przez organizację `CLAUDE.md` i automatyczna pamięć, bez plików projektu ani użytkownika). Zmiana zaczyna obowiązywać od następnej wysłanej wiadomości i w każdej nowej sesji.
Działanie trybów w tabeli opisano w dokumentacji Anthropic. Prawa kolumna zawiera zalecenia dotyczące wyboru: | Wartość | Co odczytuje Claude Code | Kiedy używać | |----|----|----| | `claude-md-or-agents-md` | `CLAUDE.md` albo `AGENTS.md`, jeśli w katalogu roboczym ani jego katalogach nadrzędnych nie ma `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md` | Ustawienie domyślne, gdy repozytorium używa tylko jednego z tych plików i nie ma plików blokujących w katalogach nadrzędnych | | `claude-md-and-agents-md` | Oba pliki razem: w każdym katalogu najpierw `CLAUDE.md`, a potem `AGENTS.md` | Gdy potrzebujesz wspólnego pliku `AGENTS.md` dla wszystkich narzędzi oraz krótkiego pliku `CLAUDE.md` tylko dla Claude albo gdy potrzebujesz odczytywać `AGENTS.md`, mimo że istnieje `CLAUDE.local.md` | | `claude-md` | Tylko `CLAUDE.md`; automatyczny odczyt `AGENTS.md` przez Project instructions jest wyłączony, nawet jeśli `AGENTS.md` jest jedynym plikiem (jawny import `@AGENTS.md` z `CLAUDE.md` nadal działa) | Gdy `AGENTS.md` został napisany dla innego narzędzia i może wprowadzić Claude w błąd | | `managed-only` | Przy uruchomieniu sesji tylko zarządzany przez organizację `CLAUDE.md` i automatyczna pamięć; pliki projektu, lokalne i użytkownika `CLAUDE.md`, `.claude/rules/` oraz wszystkie pliki `AGENTS.md` są wykluczone z początkowego zestawu. Pliki `CLAUDE.md` i `.claude/rules/` w podkatalogach są jednak wczytywane później, gdy Claude otworzy znajdujący się tam plik. Ten tryb ogranicza początkowy zestaw, ale nie zapewnia pełnej izolacji od plików projektu | Dla organizacji, którym zależy na tym, jaki zestaw instrukcji otrzymuje Claude Code na początku sesji — niezależnie od tego, czy sam projekt zawiera `CLAUDE.md` lub `AGENTS.md` | Tryb można też wybrać bez interfejsu, w pliku `settings.json`: ```json { "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` Claude Code ignoruje tę wartość w ustawieniach `project` i `local`. Według dokumentacji Anthropic można ją ustawić w `~/.claude/settings.json`, pliku przekazanym przez `--settings` albo w ustawieniach zarządzanych przez organizację. Jeśli masz już skonfigurowany wspólny plik instrukcji dla kilku narzędzi AI w jednym repozytorium, [instrukcje dla wersji starszych niż 2.1.277](https://ailoot.ai/blog/pl/agents-md-claude-md-one-instruction-file/) wyjaśniają działanie importu `@`. Ta metoda nadal działa. ## Dlaczego w /config nie ma sekcji Project instructions
Najważniejsze informacje Według dokumentacji Anthropic sekcja Project instructions może być niewidoczna z następujących powodów: - Wersja Claude Code jest starsza niż 2.1.277. - Sesja nie otrzymuje od Anthropic flag funkcji — na przykład podczas korzystania z Bedrock, innego dostawcy zewnętrznego albo po wyłączeniu telemetrii. - To pierwsza sesja bezpośrednio po instalacji lub aktualizacji ze starszej wersji. Jeśli to jedyny powód, funkcja pojawi się w następnej sesji. Sam plik `AGENTS.md` zostanie wczytany tylko wtedy, gdy spełnione są warunki wybranego trybu. - Wbudowana wtyczka `agents-md` jest wyłączona w `/plugin`.
Najpierw sprawdź wersję poleceniem `claude --version`. Jeśli jest niższa niż 2.1.277, zaktualizuj Claude Code. Jeśli wersja jest odpowiednia, ale sekcja nadal się nie pojawia, sprawdź pozostałe wymienione powyżej przyczyny. Gdy funkcja jest niedostępna, import `@AGENTS.md` w `CLAUDE.md` pozostaje działającym rozwiązaniem zastępczym. ## Co zrobić ze starym importem @AGENTS.md
Najważniejsze informacje Możesz zachować import `@AGENTS.md` w `CLAUDE.md` i dowiązanie symboliczne: w żadnym trybie plik nie zostanie odczytany dwa razy. Jeśli zachowujesz `CLAUDE.md`, tekstową prośbę „odczytaj AGENTS.md” należy zastąpić importem. Przed usunięciem pliku zapisz wszystkie potrzebne instrukcje i sprawdź warunki wybranego trybu. Jeśli przechodzisz na bezpośredni odczyt, usuń hook `SessionStart`, który ręcznie wypisywał zawartość `AGENTS.md`; w przeciwnym razie druga kopia pliku trafi do kontekstu. Następnie sprawdź wczytywanie w nowej sesji; sposób sprawdzenia zależy od wersji i tego, czy istnieją pliki blokujące.
Dalsze kroki zależą od poprzedniej konfiguracji. Najpierw upewnij się, że funkcja jest dostępna w Twojej sesji, zgodnie z opisem w poprzedniej sekcji. - **`CLAUDE.md` z importem `@AGENTS.md`.** Możesz pozostawić go bez zmian — Claude Code nie odczyta pliku dwukrotnie przy żadnej wartości Project instructions. Usunięcie `CLAUDE.md` jest opcjonalne: import już zapewnia Claude dostęp do zawartości `AGENTS.md`. Nadal sprawdzaj wczytywanie przez import za pomocą `/memory`; bezpośrednie pytanie Claude o treść instrukcji jest tylko słabym testem. - **`CLAUDE.md` z tekstową prośbą o odczytanie `AGENTS.md`.** Taka prośba nie jest importem i sama w sobie nie gwarantuje wczytania pliku. Jeśli chcesz zachować `CLAUDE.md` (na przykład dlatego, że odczytują go również inne narzędzia), zastąp tekst importem `@AGENTS.md`. Jeśli zdecydujesz się całkowicie usunąć `CLAUDE.md` i wybrać tryb `claude-md-or-agents-md`, najpierw sprawdź, czy `CLAUDE.md` nie zawiera unikatowych instrukcji oraz czy w katalogu roboczym ani jego katalogach nadrzędnych nie ma innego `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`; w przeciwnym razie Claude Code będzie nadal odczytywać pozostały plik zamiast `AGENTS.md`. Po usunięciu upewnij się, że zmiana zaczęła obowiązywać: gdy nie ma już plików blokujących, w sesji interaktywnej pojawi się wiersz `AGENTS.md loaded`. Jeśli zachowasz `CLAUDE.md` i używasz trybu `claude-md-and-agents-md`, sprawdź `/memory` w wersji 2.1.280 lub nowszej. Bezpośrednie pytanie Claude nie pozwala odróżnić bezpośredniego odczytu od importu. - **`CLAUDE.md` jest dowiązaniem symbolicznym do `AGENTS.md`.** Możesz je zachować — w żadnym trybie nie dojdzie do podwójnego odczytu. Przed usunięciem dowiązania w trybie `claude-md-or-agents-md` sprawdź, czy potrzebne instrukcje zostały zachowane oraz czy w katalogu roboczym ani jego katalogach nadrzędnych nie ma innego `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`. Sprawdź wczytywanie w ten sam sposób: gdy nie ma plików blokujących, poszukaj wiersza `AGENTS.md loaded` przy uruchomieniu sesji albo użyj `/memory` w wersji 2.1.280 lub nowszej. Jeśli zachowasz `CLAUDE.md` w trybie `claude-md-and-agents-md`, bezpośrednie pytanie Claude jest tylko słabym testem. Brak błędu nie wystarcza, by potwierdzić wczytanie. - **Hook `SessionStart` ręcznie wypisuje zawartość `AGENTS.md`.** Gdy plik jest odczytywany bezpośrednio, taki hook dodaje drugą kopię do kontekstu. Gdy hook działa, pytanie „co zawierają twoje instrukcje?” nie potwierdza bezpośredniego wczytania: Claude może odpowiedzieć na podstawie tekstu dodanego przez hook. Przejdź na nową konfigurację w następującej kolejności: 1. Sprawdź, czy funkcja jest dostępna: wersja 2.1.277 lub nowsza, sesja otrzymuje flagi funkcji, wtyczka jest włączona, a pierwsza sesja po instalacji lub aktualizacji została zakończona. Wybierz tryb bezpośredniego odczytu — nie `claude-md` ani `managed-only`. W przypadku trybu domyślnego sprawdź też, czy nie ma plików blokujących. 2. Usuń hook. 3. Zamknij sesję i otwórz nową. Hook `SessionStart` dodaje tekst podczas uruchamiania, więc jego zawartość pozostaje w kontekście już otwartej sesji. Odpowiedź Claude o treści instrukcji w takiej sesji nie potwierdzi bezpośredniego wczytania. 4. Sprawdź wczytywanie w nowej sesji. W wersji 2.1.280 lub nowszej ścieżka do `AGENTS.md` jest widoczna w `/memory`. W wersjach 2.1.277–2.1.279, jeśli nie ma plików blokujących, poszukaj wiersza `AGENTS.md loaded` przy uruchomieniu: dokumentacja opisuje go konkretnie dla przypadku, w którym nie znaleziono `CLAUDE.md`. Jeśli zachowujesz `CLAUDE.md` i używasz trybu `claude-md-and-agents-md`, możliwości sprawdzenia są ograniczone: w tych wersjach `/memory` nie pokazuje `AGENTS.md`, dokumentacja nie opisuje wiersza informującego o wczytaniu w tym przypadku, a parafraza instrukcji nie pozwala odróżnić bezpośredniego odczytu od importu `@` w `CLAUDE.md`. W takiej sytuacji zaktualizuj Claude Code do wersji 2.1.280 lub nowszej i sprawdź `/memory`. ## Jak sprawdzić, czy AGENTS.md został wczytany
Najważniejsze informacje Od wersji 2.1.280 plik `AGENTS.md` wczytany przez Project instructions pojawia się w `/memory` oraz na liście Memory files polecenia `/context`. W wersjach 2.1.277–2.1.279 nie pojawia się tam, mimo że same polecenia działają i pokazują wczytane `CLAUDE.md` oraz inne pliki pamięci. W tych wersjach, jeśli nie ma plików blokujących, sprawdź, czy przy uruchamianiu sesji pojawia się wiersz `AGENTS.md loaded`. Pytanie Claude o treść instrukcji to tylko słaby test: odpowiedź nie pozwala odróżnić bezpośredniego odczytu od importu `@` i może opierać się na tekście dodanym przez hook `SessionStart`. Dlatego warto o to pytać dopiero w nowej sesji, po usunięciu takiego hooka.
Istnieją też dwie różnice względem zwykłego `CLAUDE.md`: hooki `InstructionsLoaded` nie są uruchamiane dla tego rodzaju `AGENTS.md` (działają natomiast dla `AGENTS.md` zaimportowanego składnią `@` z `CLAUDE.md` lub połączonego z nim dowiązaniem symbolicznym `CLAUDE.md`); katalogi dodane flagą `--add-dir` wraz ze zmienną `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` wczytują tylko `CLAUDE.md` z danego katalogu — jego `AGENTS.md` nie jest uwzględniany. Jeśli chcesz przejrzeć zawartość dużego pliku instrukcji projektu, zobacz osobną analizę [jak skonfigurować CLAUDE.md, żeby nie stał się zbyt obszerny](https://ailoot.ai/blog/pl/claude-md-template/). Omawia strukturę instrukcji, a opisane wyżej warunki dotyczą wczytywania `AGENTS.md`. Notatki między sesjami znajdziesz w analizie [drugiego mózgu w Claude Code](https://ailoot.ai/blog/pl/claude-code-second-brain/) — o osobistej pamięci nakładanej na instrukcje projektu. ## Co dalej Funkcja została udostępniona 18 września 2026 r. w wersji 2.1.277. Anthropic może doprecyzować szczegóły trybów w kolejnych wydaniach, dlatego przed zmianą ustawień ważnego projektu porównaj ten artykuł z aktualnym `/config` i oficjalnym dziennikiem zmian.
### Źródła - [Claude Code, commit CHANGELOG.md z wpisem o wersji 2.1.277 na GitHubie (18 września 2026 r.)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3) - [Dokumentacja Claude Code: Jak Claude zapamiętuje projekt — sekcja AGENTS.md](https://code.claude.com/docs/en/memory)
[Przewodniki Ailoot](https://ailoot.ai/docs/)
[Przejdź do Ailoot](https://ailoot.ai/)
## Pytania i odpowiedzi ### Dlaczego AGENTS.md się nie wczytuje mimo istnienia pliku? W trybie domyślnym CLAUDE.md, .claude/CLAUDE.md lub CLAUDE.local.md w katalogu roboczym albo nadrzędnym blokuje automatyczny wybór AGENTS.md. Sprawdź też wersję Claude Code, dostępność funkcji i tryb Project instructions w /config. ### Jak sprawdzić bezpośrednie wczytywanie po usunięciu ręcznego hooka? Otwórz nową sesję, aby nie było w niej starego wyjścia SessionStart. W wersji 2.1.280 lub nowszej sprawdź /memory albo listę Memory files w /context; w 2.1.277-2.1.279 wiersz ładowania na starcie ma zastosowanie przy braku blokujących plików CLAUDE.md. Sama parafraza Claude jest słabym dowodem. ## Ailoot · Firma i jej portfel projektów Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI. Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach. Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.