Claude Code odczytuje teraz AGENTS.md: zmiany w wersji 2.1.277

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.

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.

Co zmieniło się w wersji 2.1.277?#

Oficjalny plik CHANGELOG.md projektu Claude Code na GitHubie opisuje to tak:

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#

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.

4 tryby Project instructions — który wybrać#

Działanie trybów w tabeli opisano w dokumentacji Anthropic. Prawa kolumna zawiera zalecenia dotyczące wyboru:

Tryb można też wybrać bez interfejsu, w pliku settings.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 wyjaśniają działanie importu @. Ta metoda nadal działa.

Dlaczego w /config nie ma sekcji Project instructions#

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#

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#

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