--- title: "Jak używać AGENTS.md w Claude Code i Codex" description: "Codex domyślnie czyta AGENTS.md. Claude Code od wersji 2.1.277 czyta ten plik, gdy w projekcie nie ma CLAUDE.md. Aby zachować oba pliki, dodaj @AGENTS.md do CLAUDE.md." canonical: "https://logbrew.co/pl/guides/agents-md" last_updated: "2026-11-10" --- # Jak używać AGENTS.md w Claude Code i Codex Codex domyślnie czyta `AGENTS.md`. Claude Code od wersji 2.1.277 czyta ten plik, gdy w projekcie nie ma `CLAUDE.md`. Aby zachować oba pliki, dodaj `@AGENTS.md` do `CLAUDE.md`. Przetestowane 10 listopada 2026 z użyciem Claude Code 2.1.319 i Codex CLI 0.167.0 Autor [Furkan Erday](https://github.com/furkanerday). Furkan Erday jest założycielem LogBrew. Codziennie rozwija LogBrew z pomocą Claude Code i Codex. Canonical: https://logbrew.co/pl/guides/agents-md ## Kiedy każdy agent wczytuje `AGENTS.md` | W projekcie jest | Claude Code | Codex | | --- | --- | --- | | Tylko `AGENTS.md` | Wczytany | Wczytany | | `AGENTS.md` i `CLAUDE.md` | Pominięty | Wczytany | | `CLAUDE.md`, który importuje `@AGENTS.md` | Wczytany | Wczytany | | `CLAUDE.md` jako dowiązanie do `AGENTS.md` | Wczytany | Wczytany | | `AGENTS.md` i `CLAUDE.local.md` | Pominięty | Wczytany | Odczytaliśmy instrukcje, które każdy agent wysłał w pierwszym żądaniu. ## Jeden plik dla obu agentów ### Utwórz AGENTS.md w katalogu głównym projektu Zapisz polecenia budowania, polecenia testów i zasady pisania kodu w 1 pliku. Oba agenty czytają go od katalogu głównego repozytorium Git aż do bieżącego folderu. ### Zaktualizuj Claude Code Claude Code sam czyta `AGENTS.md` od wersji 2.1.277. Starsze wersje potrzebują importu z następnego kroku. ```bash claude update ``` ### Zaimportuj AGENTS.md w CLAUDE.md Gdy w bieżącym folderze lub wyżej jest `CLAUDE.md`, `.claude/CLAUDE.md` albo `CLAUDE.local.md`, Claude Code nie czyta `AGENTS.md`. Dodaj tę linię do `CLAUDE.md`, aby wczytać oba pliki. ```bash @AGENTS.md ``` ### Albo zrób z CLAUDE.md link do AGENTS.md Jeśli w `CLAUDE.md` byłby tylko import, zamień ten plik na dowiązanie symboliczne. ```bash ln -s AGENTS.md CLAUDE.md ``` ### Albo wczytaj oba pliki przez ustawienie Aby zachować `CLAUDE.local.md` i nadal wczytywać `AGENTS.md`, dodaj to do `~/.claude/settings.json`. W sesji tę samą wartość ustawia opcja instrukcji projektu w `/config`. ```bash { "pluginConfigs": { "cc-plugin-agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` ### Sprawdź, co wczytał Codex Uruchom to w folderze, w którym pracujesz. Dokumentacja Codex podaje to polecenie, aby Codex powtórzył wczytane instrukcje. ```bash codex --ask-for-approval never "Summarize the current instructions." ``` ## Co zobaczyliśmy podczas testu Skierowaliśmy oba agenty na lokalny serwer testowy i odczytaliśmy instrukcje, które każdy z nich wysłał w pierwszym żądaniu. Dzięki temu widać dokładnie, które pliki wczytuje każdy agent. Claude Code wczytał `AGENTS.md`, gdy projekt nie miał `CLAUDE.md`, a jego log debugowania pokazał `no CLAUDE.md found; AGENTS.md loaded`. Gdy obok leżał `CLAUDE.md`, Claude Code pominął `AGENTS.md`. Z importem `@AGENTS.md` albo z dowiązaniem tekst `AGENTS.md` pojawił się dokładnie raz. Ustawienie `pluginConfigs` opisane wyżej wczytało oba pliki, także gdy w projekcie był `CLAUDE.local.md`. Codex najpierw wczytał `~/.codex/AGENTS.md`, potem `AGENTS.md` z katalogu głównego, a na końcu plik z bieżącego folderu. Plik `AGENTS.override.md` zastąpił `AGENTS.md` w swoim folderze. Codex pomijał `CLAUDE.md`, dopóki nie dodaliśmy go do `project_doc_fallback_filenames`. Gdy istniały oba pliki, Codex wczytał tylko `AGENTS.md`, nawet z ustawioną nazwą zapasową. ## AGENTS.md czy CLAUDE.md Codex czyta `AGENTS.override.md` albo `AGENTS.md` w każdym folderze, a do tego globalny `~/.codex/AGENTS.md`, domyślnie łącznie do 32 KiB. `CLAUDE.md` czyta tylko wtedy, gdy dodasz go do `project_doc_fallback_filenames`. Claude Code najpierw czyta `CLAUDE.md`. Pliki `AGENTS.md` i `.claude/AGENTS.md` czyta tylko wtedy, gdy nie obowiązuje żaden projektowy `CLAUDE.md`. Osobisty `~/.claude/CLAUDE.md` się nie liczy, więc wczytuje się razem z `AGENTS.md`. ## Co mówią zgłoszenia na GitHubie W zgłoszeniu #6235, które ma 409 komentarzy, poproszono o obsługę AGENTS.md w Claude Code. 17 sierpnia 2026 inżynier Anthropic zamknął je, wskazując import i dowiązanie opisane wyżej. Teraz Claude Code sam czyta ten plik. Zgłoszenie #31005 prosi też o obsługę `.agents/skills/` i nadal jest otwarte. ## Najczęściej zadawane pytania ### Czy Claude Code czyta AGENTS.md? Tak, od wersji 2.1.277, gdy w bieżącym folderze ani wyżej nie ma `CLAUDE.md`, `.claude/CLAUDE.md` ani `CLAUDE.local.md`. Potwierdziliśmy to w wersji 2.1.319. ### Używać AGENTS.md czy CLAUDE.md? Użyj `AGENTS.md`, jeśli ktoś w zespole korzysta z Codex lub innego agenta. Zostaw `CLAUDE.md` tylko na zasady dotyczące samego Claude Code i zaimportuj w nim `@AGENTS.md`. ### Czy CLAUDE.md może być dowiązaniem do AGENTS.md? Tak. W naszym teście Claude Code wczytał podlinkowany plik raz, tak samo jak przy imporcie. ### Czy Codex czyta CLAUDE.md? Domyślnie nie. Dodaj `project_doc_fallback_filenames = ["CLAUDE.md"]` do `~/.codex/config.toml`. ## Daj agentowi dostęp do błędów z produkcji Połącz serwer MCP LogBrew, a Claude Code lub Codex odczyta błędy, logi i ślady zatwierdzonych projektów. Zacznij od hojnego darmowego planu, bez karty. [Połącz agenta](https://logbrew.co/pl/agents) ## Źródła - [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md) - [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md) - [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235) - [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005) ## Więcej poradników o agentach AI do kodowania - [Dodaj serwer MCP do Claude Code i Codex](https://logbrew.co/pl/guides/mcp-server-claude-code-codex) - [Napraw błąd Claude 529 overloaded i błąd 429 rate limit](https://logbrew.co/pl/guides/claude-overloaded-rate-limit-error) - [Jak naprawić błędy w Claude Code, Codex i JavaScript w przeglądarce](https://logbrew.co/pl/guides)