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.

Ostatnia aktualizacja
Autor:
Opublikowano
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.

Na tej stronie Dlaczego to ważneJak robi to każde narzędziePytania

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ę

  1. Zmiana

    Zmieniasz polecenie testów w CLAUDE.md

    Z npm test na pnpm test:unit, w zeszłym sprincie.

  2. Drugi plik

    AGENTS.md wciąż mówi npm test

    Nic nie pilnuje, żeby dwie kopie polityki były zgodne.

  3. Start Codeksa

    Czyta AGENTS.md i uruchamia stare polecenie

    Polecenie kończy się błędem.

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

  1. Polityka

    Jeden krótki AGENTS.md trzyma reguły

    Układ, dokładne polecenia, granice i to, co znaczy „skończone”.

  2. Adapter

    CLAUDE.md to jedna linia: @AGENTS.md

    Import działa w każdej wersji i nigdy nie wczytuje pliku dwa razy. Codex adaptera nie potrzebuje.

  3. Sprawdzenie

    /context i codex debug prompt-input

    Każde pokazuje, które pliki dane narzędzie naprawdę wczytało.

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

Instrukcje sterują, ale nie są granicą bezpieczeństwa. Reguła, która musi obowiązywać, przechodzi do reguły deny, hooka albo CI, a zdanie zostaje tylko jako wyjaśnienie. Źródło: Przewodnik po kontekście repozytorium, 2026-09-26.

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

Czy ta strona odpowiada na Twoje pytania?

Jedno kliknięcie, bez logowania.

wcale w pełni

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.