Czym jest AGENTS.md?
AGENTS.md to otwarty format Markdown dla instrukcji agenta: polecenia budowania, konwencje i granice, trzymane w katalogu głównym repozytorium, a zawężone szczegóły w podkatalogach. Codex czyta go przed rozpoczęciem pracy. Claude Code domyślnie czyta go tylko wtedy, gdy projekt nie ma CLAUDE.md (od v2.1.277), a Cursor czyta go w katalogu głównym projektu i w podkatalogach.
- Po angielsku
- AGENTS.md
- Pierwsze wdrożenie
- Poziom 2, darmowy przewodnik
- Szukane też jako
- plik AGENTS.md, konwencja agents.md
249,99 zł jednorazowo za 12 miesięcy dostępu. Nic się samo nie odnawia. Zwrot w ciągu 30 dni przy pierwszym zakupie.
Dlaczego to ważne.
Dwa narzędzia, dwa pliki, a skopiowana między nimi polityka się rozjeżdża. W przykładzie z przewodnika jeden plik dostaje nowe polecenie testów, a drugi zostaje ze starym, więc sesja Codeksa uruchamia je, widzi błąd i „naprawia” go, przepisując test. Jeden krótki AGENTS.md, który importują pozostałe pliki, trzyma politykę w jednym miejscu, a sprawdzenie wczytania w każdym narzędziu pokazuje, co agent naprawdę przeczytał.
Jedna polityka, dwa sposoby jej trzymania
Polecenie testów się zmienia. Czy dowie się o tym każdy agent?
- Plik, który agent czyta i waży
- Mechanizm, który działa
- Na czym możesz polegać
Dwie kopie Rozjeżdża się
-
Zmiana
Zmieniasz polecenie testów w
CLAUDE.mdZ
npm testnapnpm test:unit, w zeszłym sprincie. -
Drugi plik
AGENTS.mdwciąż mówinpm testNic nie pilnuje, żeby dwie kopie polityki były zgodne.
-
Start Codeksa
Czyta
AGENTS.mdi uruchamia stare poleceniePolecenie kończy się błędem.
-
Efekt
„Naprawia” błąd, przepisując test
Scenariusz z przewodnika. Nikt nie umiał powiedzieć, który plik czytał który agent, bo nikt tego nie sprawdził.
Jeden plik, jeden import Jedno źródło
-
Polityka
Jeden krótki
AGENTS.mdtrzyma regułyUkład, dokładne polecenia, granice i to, co znaczy „skończone”.
-
Adapter
CLAUDE.mdto jedna linia:@AGENTS.mdImport działa w każdej wersji i nigdy nie wczytuje pliku dwa razy. Codex adaptera nie potrzebuje.
-
Sprawdzenie
/contexticodex debug prompt-inputKażde pokazuje, które pliki dane narzędzie naprawdę wczytało.
-
Na czym możesz polegać
Jedna zmiana trafia do obu narzędzi
Oba wczytują ten sam tekst. To, czy agent go przestrzega, nadal jest wskazówką: zakazy przewodnik przenosi do hooków, uprawnień i CI.
Jak robi to każde narzędzie.
Cursor, Claude Code i Codex nazywają to po swojemu. Każda notatka ma datę sprawdzenia.
Cursor
Cursor obsługuje AGENTS.md w katalogu głównym projektu i w podkatalogach (zagnieżdżone pliki łączą się z nadrzędnymi, a bardziej szczegółowy ma pierwszeństwo); drugim mechanizmem są Rules w .cursor/rules/.
Dokumentacja Cursora (sprawdzona 2026-10-12) mówi, że czyta on CLAUDE.md tak samo i zawsze go stosuje, a środowisko uruchomieniowe agenta w @cursor/sdk 1.0.32 (sprawdzone 2026-09-26) ładuje główny i zagnieżdżone AGENTS.md bezwarunkowo, a CLAUDE.md tylko przy włączonym ładowaniu konfiguracji zewnętrznej. Ż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
Domyślnie czyta AGENTS.md tylko wtedy, gdy nie ma CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md (od v2.1.277). Ustawienie Project instructions w /config, czyli claude-md-and-agents-md, ładuje oba pliki, a CLAUDE.md zawierający @AGENTS.md importuje go w każdej wersji.
Sesje na Amazon Bedrock, Google Cloud, Microsoft Foundry, przez bramkę LLM albo z wyłączoną telemetrią potrzebują v2.1.281. Obie wersje są na kanałach wydań latest i stable od czasu, gdy stable doszedł do v2.1.287 (sprawdzone 2026-10-12), więc import @AGENTS.md, który działa w każdej wersji, nadal jest potrzebny tylko współpracownikowi na starszej wersji.
Przewodnik po pamięci Claude Code, Claude Code 2.1.283, 2026-09-26
Codex
Plik natywny: Codex czyta AGENTS.md przed rozpoczęciem pracy, po jednym pliku na katalog od katalogu głównego w dół; tworzy go /init.
Projekt oznaczony jako niezaufany nie dostarcza plików projektu (od 0.150.0). Łączny limit to project_doc_max_bytes, domyślnie 32 KiB, a Codex obcina najgłębszy plik jako pierwszy, bez komunikatu; AGENTS.override.md ukrywa AGENTS.md z tego samego katalogu. codex debug prompt-input wypisuje prompt widziany przez model, więc możesz sprawdzić, co się wczytało.
Przewodnik po AGENTS.md w Codeksie, Codex CLI 0.157.1, 2026-09-26
Najczęstsze pytania.
Które narzędzia czytają AGENTS.md?
Codex czyta go natywnie. Claude Code domyślnie czyta go tylko wtedy, gdy projekt nie ma CLAUDE.md, .claude/CLAUDE.md ani CLAUDE.local.md: od v2.1.277 (oba kanały wydań, odkąd stable doszedł do v2.1.287, sprawdzone 2026-10-12), a w sesjach Bedrock, Google Cloud, Microsoft Foundry i przez bramkę od v2.1.281; ustawienie Project instructions w /config, czyli claude-md-and-agents-md, ładuje oba pliki. Cursor obsługuje AGENTS.md w katalogu głównym projektu i w podkatalogach (dokumentacja Cursora, sprawdzone 2026-10-12); uruchom sondę wykrywania w nowym czacie Agent, żeby zobaczyć, co wczytała twoja wersja.
Co powinno znaleźć się w AGENTS.md?
Tylko linie prawdziwe dla każdego zadania, których agent nie odkryje, czytając kod: układ, dokładne polecenia, granice i to, co znaczy „skończone”, w około 40 liniach. Procedury wieloetapowe należą do skilli, a reguły, które muszą obowiązywać, do hooków, uprawnień i CI, bo instrukcje sterują, ale niczego nie wymuszają.
Czy repozytorium może mieć i AGENTS.md, i CLAUDE.md?
Tak, a bezpieczny układ trzyma politykę raz: reguły w AGENTS.md, a CLAUDE.md to jedna linia @AGENTS.md plus ewentualne linie tylko dla Claude. Domyślnie dodanie CLAUDE.md bez importu ukrywa AGENTS.md przed Claude Code, a dwie kopie reguł się rozjeżdżają.
Jak sprawdzić, że Codex go wczytał?
Uruchom codex debug prompt-input: wypisuje prompt widziany przez model jako JSON bez wywoływania modelu, więc skrypt może go przeszukać. Wyłapuje trzy ciche awarie: obcięcie przy limicie 32 KiB, AGENTS.override.md, który przesłania właściwy plik, i zagnieżdżony plik, który przestał się wczytywać.
Czytaj dalej.
Przewodniki, które idą głębiej, oraz hasła i porównania obok tego.
W dokumentacji
Powiązane hasła
Czy ta strona odpowiada na Twoje pytania?
Jedno kliknięcie, bez logowania.
Czego tu szukasz?
Co Cię powstrzymuje?
Jak się to czyta?
Dzięki. Jeśli zostawiasz e-mail, odpisze Ci Michał.
Odpowiada na Twoje pytania?
Każde to jedno kliknięcie. Zamknij, kiedy chcesz.
bez logowania
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.
Odpisuje Michał, nie automat. Adres służy tylko tej odpowiedzi.