CLAUDE.md to plik, który kształtuje sposób, w jaki Claude rozumie Twój projekt. Dobrze napisany oznacza mniej poprawek, lepszy kod i agentów, którzy faktycznie wiedza, nad czym pracują.
Ten poradnik przeprowadzi Cię przez każdą sekcję pliku CLAUDE.md: od deklaracji stosu technologicznego po wskazówki dla poszczególnych agentów. Postępuj krok po kroku i stwórz własny plik.
CLAUDE.md to plik Markdown umieszczony w katalogu głównym projektu. Gdy Claude Code rozpoczyna sesję, czyta ten plik jako pierwszy. Wszystko w nim staje się częścią kontekstu Claude: Twój stos technologiczny, struktura plików, konwencje zespołu i wszelkie konkretne instrukcje, których ma przestrzegać każdy agent.
Traktuj to jako dokument briefingowy. Bez niego Claude musi zgadywać, jak zorganizowany jest Twój projekt. Z dobrym plikiem CLAUDE.md Claude już wie, gdzie co się znajduje, jakich wzorców używać i czego unikać. Różnica w jakości wyników jest znacząca.
“10 minut pracy nad CLAUDE.md oszczędza godziny poprawiania kodu wygenerowanego przez AI, który nie pasuje do wzorców Twojego projektu.”
Na podstawie obserwacji setek projektów Claude Code
Struktura i dokładność pliku CLAUDE.md bezpośrednio wpływają na jakość pracy Claude w Twojej bazie kodu.
Dobrze skonstruowany plik CLAUDE.md obejmuje te sześć obszarów. Każdy dostarcza Claude konkretnych informacji, z którymi może natychmiast pracować.
Wymień jawnie swoje frameworki, biblioteki i ich wersje. Podaj menedżera pakietów, wersję Node i wszelkie wymagania środowiska uruchomieniowego. Claude używa tego do generowania kompatybilnego kodu bez zgadywania.
Opisz kluczowe katalogi i co się w każdym znajduje. Komponenty, store, serwisy, trasy API, typy. Krótki diagram drzewa z jednoliniowym opisem każdego folderu sprawdza się dobrze.
Udokumentuj konwencje nazewnictwa (camelCase dla plików, PascalCase dla komponentów), podejście do obsługi błędów, kolejność importów i wszelkie reguły specyficzne dla projektu. Dzięki temu wyniki Claude pozostają spójne z istniejącym kodem.
Dołącz komendy dev, build, test i lint. Gdy Claude musi coś zweryfikować lub zaproponować skrypt, użyje dokładnie tych komend, których oczekuje Twój projekt.
Jeśli używasz wielu agentów (QA, Frontend, Backend, DevOps), dodaj sekcję opisującą, na czym powinna skupić się każda rola. Jest to szczególnie przydatne przy konfiguracji wieloagentowej AgentsRoom.
Powiedz Claude, czego NIE robić. Nie modyfikować plików konfiguracyjnych, nie zmieniać systemu autoryzacji, nie refaktoryzować warstwy bazy danych. Jawne granice zapobiegają niepożądanym zmianom ze strony agentów.
Nie musisz pisać wszystkiego naraz. Zacznij od podstaw i rozszerzaj w miarę odkrywania, co Claude musi wiedzieć.
Otwórz package.json i wymień każdy framework, bibliotekę i narzędzie używane w projekcie. Zapisz wersje. Sprawdź wymagania środowiska (wersja Node, wersja Python, baza danych). Z tego powstanie sekcja stosu technologicznego.
package.json + wersje środowiska + baza danych
Zrób szybki przegląd drzewa katalogu src. Zidentyfikuj foldery najwyższego poziomu i napisz jednoliniowy opis każdego z nich. Skup się na lokalizacji komponentów, store, serwisów, typów i tras API.
Drzewo src/ z opisami przeznaczenia
Przejrzyj istniejący kod i zanotuj wzorce: jak nazywasz pliki, jak obsługujesz błędy, jak strukturyzujesz importy, czy używasz default czy named exports. Zapisz je jako krótkie reguły.
Nazewnictwo, importy, obsługa błędów, eksporty
Jeśli pracujesz ze specjalistycznymi agentami, dodaj obszary fokusa dla każdej roli. Agent Frontend powinien znać Twoją bibliotekę komponentów. Agent DevOps powinien znać pipeline wdrożeń. Agent QA powinien znać framework testowy.
Obszary fokusa i unikania dla każdej roli
AgentsRoom został zbudowany z CLAUDE.md jako centralnym elementem, nie dodatkiem.
Edytuj CLAUDE.md bezpośrednio w AgentsRoom z podświetlaniem składni i automatycznym zapisem. Bez przełączania do edytora tekstu czy IDE.
Obserwuj w czasie rzeczywistym, jak każdy agent interpretuje Twój CLAUDE.md. Śledź wyjście terminala, aby upewnić się, że agenci przestrzegają konwencji i respektują obszary do unikania.
Każdy projekt w AgentsRoom ma własny plik CLAUDE.md. Przełączaj się między projektami, a każdy agent automatycznie załaduje odpowiedni plik kontekstowy dla danej bazy kodu.
14 ról agentów w AgentsRoom jest bezpośrednio powiązanych z sekcjami CLAUDE.md. Zdefiniuj obszary fokusa i unikania dla każdej roli, a każdy agent pobierze dokładnie te instrukcje, które są dla niego przeznaczone.
CLAUDE.md is prepended to every Claude turn. A bloated CLAUDE.md silently inflates Claude Code token usage on every message. AgentsRoom puts a per-session token meter on each agent so you can see exactly how much your CLAUDE.md is costing you, with a live cache hit rate to confirm it stays cached.
See the Claude Code token usage trackerAGENTS.md to przenośny plik z instrukcjami, który twoje agenty kodujące czytają, zanim dotkną kodu. Co w nim umieścić, czym różni się od CLAUDE.md i jak utrzymać jeden kontekst dla Codex, Antigravity i Claude.
Kod przestał być wąskim gardłem, teraz to komunikacja decyduje o wszystkim. Dowiedz się, jak rozmawiać z agentami AI Claude, Codex, Antigravity i Grok Build, żeby dostarczać szybciej, precyzyjniej i taniej.
Twoja subskrypcja Claude nie jest wyrażona w tokenach, więc żaden ekran nie pokazuje salda tokenów. Oto co naprawdę jest mierzone, dwa ekrany, które faktycznie to pokazują, dlaczego limit topnieje, kiedy nic nie piszesz, oraz co zmiana okna tygodniowego z września 2026 robi z Twoim tygodniem.
Pobierz AgentsRoom i użyj wbudowanego edytora CLAUDE.md, aby dać agentom potrzebny kontekst. Lepsze instrukcje, lepszy kod.
Aplikacja towarzysząca: monitoruj agentów w podróży
Użyj Claude, Codex, Antigravity CLI lub innego dostawcy AI.
Wysyłaj bugi i prośby bezpośrednio do swojego publicznego backlogu.