CLAUDE.md po Opus 5: jak skrócić instrukcje projektu

Informacje o korzystaniu z Ailoot znajdziesz w dokumentacji.

Co zmieniło się w Claude po premierze Opus 5?#

Opus 5 ukazał się 24 lipca 2026 r. i od razu stał się domyślnym modelem w Claude Code. Sam model — jego cena, benchmarki i tryby wysiłku — został szczegółowo omówiony w osobnym poradniku „Czy warto przejść na Claude Opus 5?”. Ten artykuł dotyczy czegoś innego: premiera modelu zmieniła również sposób skutecznego komunikowania się z nim.

Firma Anthropic opublikowała analizę na blogu Claude. Jej główna teza brzmi tak:

Kluczowe słowa to „zbytnio ograniczaliśmy”. Gdy modele były słabsze, potrzebowały rusztowania: zrób to, nie rób tamtego, oto przykład, powtórzmy go jeszcze raz. Opus 5 nie potrzebuje już takiego rusztowania, a co gorsza, może ono zacząć przeszkadzać. Anthropic prosto formułuje nową zasadę: pozwól Claude’owi korzystać z własnego osądu.

Co to oznacza dla Ciebie w praktyce?

• Twój CLAUDE.md to taki sam rodzaj promptu systemowego, tyle że dla Twojego projektu. Skoro Anthropic skróciło własny o 80 procent, Twój prawdopodobnie też jest przeładowany.
• Długie listy reguł nie gwarantują już stosowania się do instrukcji. Wręcz przeciwnie: im więcej wierszy, tym mniej dokładnie model ich przestrzega (więcej na ten temat poniżej, wraz z danymi z dokumentacji).
• Pojawiły się nowe mechanizmy — automatyczna pamięć i skills — które przejmują część zadań, które wcześniej trzeba było ręcznie opisywać w CLAUDE.md.

Najważniejsze jest to, że najistotniejsza praca odbywa się przed promptem — w tym, co umieszczasz w kontekście modelu, zanim wyślesz pierwsze żądanie. Aktualizacja Opus 5 to w zasadzie oficjalne potwierdzenie tej samej idei przez Anthropic. Tym razem jednak towarzyszą jej konkretne dane i nowe narzędzia. Omówię je po kolei.

Dlaczego długi CLAUDE.md teraz przeszkadza?#

Oto jak to działa. CLAUDE.md to plik z regułami, który Claude czyta na początku każdej sesji. Osobny poradnik, „Jak skonfigurować CLAUDE.md”, wyjaśnia, jak stworzyć taki plik od zera; ten artykuł dotyczy odwrotnego procesu: co teraz z niego usunąć. Wszystko, co tam zapiszesz, trafia do kontekstu przed Twoim pierwszym żądaniem i pozostaje w nim przez całą rozmowę. Kontekst nie jest nieskończony — każdy dodatkowy wiersz reguł zajmuje miejsce, które można by przeznaczyć na Twoje zadanie.

Dokumentacja Claude Code mówi wprost:

Drugi punkt jest ważniejszy niż pierwszy: długie pliki zmniejszają skłonność do przestrzegania instrukcji. Model zaczyna uważniej słuchać rzadziej. To pułapka, w którą wpada niemal każdy początkujący. Logika wydaje się niepodważalna: chcę, żeby Claude mnie słuchał, więc napiszę więcej reguł. W praktyce dzieje się odwrotnie. Im dłuższa lista, tym bardziej rozprasza się uwaga modelu i tym częściej pomija on którąś regułę.

Oto jak zmieniło się podejście:

Jest też drugi problem: sprzeczności. W miarę rozrastania się pliku niemal nieuniknione jest gromadzenie reguł, które sobie przeczą. W jednym miejscu widnieje „zawsze pisz testy”, a w innym „nie ruszaj folderu tests”. Dokumentacja ostrzega, że jeśli dwie reguły są sprzeczne, Claude może losowo wybrać jedną z nich. Innymi słowy, przeładowany plik sprawia, że zachowanie modelu jest mniej przewidywalne.

Prosta zasada: CLAUDE.md to krótka notatka o tym, czego Claude nie może sam wywnioskować. Wszystko poza tym jedynie zajmuje jego uwagę.

Co zachować w CLAUDE.md, a co usunąć?#

Dokumentacja podaje jasne kryteria, które pomagają zdecydować, czy dana reguła zasługuje na miejsce w CLAUDE.md. Dodaj ją, jeśli:

1. Claude popełnił ten sam błąd po raz drugi.
2. Kontrola kodu wykryła coś, co model powinien był wiedzieć o tym projekcie.
3. Po raz drugi wpisujesz tę samą poprawkę na czacie.
4. Nowa osoba w zespole potrzebowałaby tego samego kontekstu, aby nie zepsuć projektu.

Ogólna zasada to zachować pułapki specyficzne dla projektu, a usunąć to, co oczywiste. Claude Code ma nawet wbudowane sprawdzenie claude doctor, które sugeruje uporządkowanie przeładowanego CLAUDE.md. Usuwa ono szczegóły, które model może wywnioskować z bazy kodu — strukturę folderów, listę zależności, przegląd architektury — i zachowuje pułapki, uzasadnienia oraz konwencje różniące się od domyślnych.

Druga ważna zasada to konkretność. Niejasne sformułowania się nie sprawdzają. Porównaj:

Różnica jest prosta. Model może interpretować „sformatuj poprawnie” na dowolny sposób. „Używaj wcięcia o szerokości 2 spacji” można jednoznacznie sprawdzić. Każda reguła w CLAUDE.md powinna być czymś, co można zweryfikować i zobaczyć — czy została zastosowana, czy nie.

Po trzecie, usuń to, co oczywiste. Jeśli w CLAUDE.md napiszesz „pisz czysty kod” albo „stosuj najlepsze praktyki”, to tylko szum. Model już to wie, a taki wiersz zajmuje miejsce i rozprasza jego uwagę. Anthropic wyraźnie odradza poświęcanie kontekstu na oczywistości.

Gdzie przenieść reguły, które nie pasują do CLAUDE.md?#

W tym miejscu pojawia się najbardziej niedoceniane narzędzie. Dawniej wszystkie instrukcje musiały pozostawać w CLAUDE.md; teraz długie procedury mają własne miejsce: skills. Osobny poradnik, „Jak wybierać skills do Claude Code”, wyjaśnia, jak wybrać właściwe, nie dodając ich zbyt wiele.

Różnica jest zasadnicza. CLAUDE.md jest w całości ładowany na początku każdej sesji. Skill nie. Dokumentacja ujmuje to tak:

Nazywa się to progresywnym ujawnianiem — ładowaniem informacji w miarę potrzeb. Chodzi o to, by przekazywać modelowi kontekst porcjami, we właściwym momencie. Anthropic przeniosło szczegółowe instrukcje, na przykład dotyczące przeglądu kodu, do skills i usunęło je z promptu systemowego.

Kryterium przeniesienia czegoś do skill jest proste: fragment CLAUDE.md przekształcił się z faktu w procedurę. Jednowierszowa notatka „Budowanie odbywa się przez npm run build” to fakt i należy ją umieścić w CLAUDE.md. Dziesięć kroków opisujących „jak publikujemy projekt” to procedura i należy ją umieścić w skill.

Praktyczna zasada: przekazuj dalej wszystko, co robisz częściej niż kilka razy. Raz wyjaśnij, jak na przykład przygotowujesz cotygodniowy raport dla klienta, zamień to wyjaśnienie w skill i nie będziesz musiał opisywać tego ponownie. Skill pozostaje dostępny, nie zajmując kontekstu, i można go wywołać po nazwie poleceniem takim jak /otchet.

Warto przenieść do skills:

• Procedury wieloetapowe (publikowanie, przygotowywanie raportu, kontrole przed wydaniem).
• Długie instrukcje, które rzadko są potrzebne w całości.
• Wszystko, co kopiujesz z jednego czatu do drugiego po raz drugi lub trzeci.

Jest też opcja pośrednia: reguły dotyczące konkretnych folderów. Jeśli instrukcja dotyczy tylko jednej części projektu, możesz umieścić ją w .claude/rules/ i powiązać z odpowiednimi plikami. Wtedy jest ładowana tylko podczas pracy Claude’a z tymi plikami, zamiast przez cały czas pozostawać w kontekście.

Czym jest automatyczna pamięć i dlaczego warto jej używać w 2026 roku?#

Drugim nowym mechanizmem odciążającym CLAUDE.md jest automatyczna pamięć. Chodzi o to, że Claude pamięta teraz nie tylko to, co zapisałeś, lecz także to, co sam zauważył. Osobny poradnik „Pamięć Claude’a a CLAUDE.md” wyjaśnia, czym różnią się ich mechanizmy.

Różnice między tymi dwoma rodzajami pamięci:

Oto jak to działa: podczas pracy nad Twoim zadaniem Claude zauważa przydatne szczegóły — które polecenie uruchamia budowanie, gdzie pojawiły się problemy z debugowaniem, co poprosiłeś go zrobić inaczej — i zapisuje je w notatkach. Przywraca je w kolejnej sesji. Ważne: zapisuje informacje wybiórczo, zachowując tylko te, które uzna za przydatne w przyszłości.

Notatki znajdują się w osobnym folderze dla każdego projektu, z plikiem indeksu o nazwie MEMORY.md. Możesz je przeglądać i edytować poleceniem /memory. To zwykłe pliki tekstowe, więc w każdej chwili możesz je czytać, edytować lub usuwać.

Co to zmienia w praktyce? Claude zapisuje teraz część informacji, które wcześniej po każdym błędzie samodzielnie dodawałeś do CLAUDE.md. Dzięki temu plik z regułami jest jeszcze krótszy — i to dobrze.

Dlaczego Opus 5 sprzeciwia się Twoim instrukcjom?#

Jest też druga strona medalu.

Model, któremu pozwala się korzystać z własnego osądu, z definicji czasami sprzeciwi się sztywnemu poleceniu, jeśli w danym kontekście dostrzeże lepsze rozwiązanie.

Co to oznacza, jeśli przeszło się na Opus 5 i coś poszło nie tak:

1. Sprawdź ponownie stare skills i plugins. Konfiguracje stworzone dla poprzednich modeli mogą kolidować z nową logiką. Warto ponownie przetestować coś, co wcześniej działało bez zarzutu.
2. Usuń najbardziej sztywne sformułowania. Modele piątej generacji gorzej radzą sobie z poleceniami w rodzaju „nigdy nie rób X, zawsze rób tylko Y” niż z elastycznymi sformułowaniami, które wyjaśniają dlaczego.
3. Obserwuj, czy model nie kończy zbyt wcześnie. Czasami oznacza to, że instrukcje sobie przeczą albo kolidują z regułą w przeładowanym CLAUDE.md.

Jak przepisać CLAUDE.md dla Opus 5: krok po kroku#

Oto proces pracy z plikiem CLAUDE.md odziedziczonym po wcześniejszych modelach.

1. Uruchom wbudowane sprawdzenie

   Wpisz claude doctor w projekcie. Narzędzie zasugeruje, co usunąć z przeładowanego pliku, a co zachować.

2. Usuń oczywistości

   Usuń każdy wiersz, który Claude może wywnioskować z samego kodu: strukturę folderów, listę bibliotek oraz ogólne sformułowania, takie jak „pisz czysty kod”.

3. Usuń sprzeczności

   Przejrzyj plik od początku do końca i znajdź sprzeczne reguły. Zostaw jedną, a tę, która z nią koliduje, usuń.

4. Przenieś procedury do skills

   Przenieś do osobnego skill wszystko, co z faktu zmieniło się w instrukcję krok po kroku. W CLAUDE.md zostaw odnośnik w jednym wierszu.

5. Doprecyzuj pozostałe reguły

   Przeredaguj każdą regułę tak, aby można było ją sprawdzić: „poprawnie formatuj” zmień na „używaj wcięcia o szerokości 2 spacji”.

6. Włącz automatyczną pamięć i sprawdź długość

   Upewnij się, że automatyczna pamięć działa (/memory) i że plik ma mniej niż 200 wierszy. Jeśli nie, coś jeszcze trzeba przenieść.

Aby nie przeprowadzać pierwszej rundy ręcznie, możesz zlecić tę pracę Claude’owi. Oto prompt, od którego możesz zacząć — skopiuj go i wklej do sesji otwartej w projekcie:

Przeczytaj mój CLAUDE.md i mój kod. Twoim zadaniem jest skrócić CLAUDE.md i sprawić, by był bardziej przydatny dla modelu piątej generacji.

Przejrzyj plik i podziel wszystkie reguły na trzy grupy:

KEEP - pułapki specyficzne dla projektu i konwencje, których nie możesz wywnioskować samodzielnie z kodu.

DELETE - oczywiste rzeczy, które już znasz, oraz wszystko, co można wywnioskować z kodu.

MOVE TO A SKILL - wieloetapowe procedury, które obecnie są zapisane w CLAUDE.md jako tekst.

W przypadku grupy 1 przeredaguj niejasne reguły tak, aby były konkretne i możliwe do zweryfikowania.
Znajdź sprzeczne ze sobą reguły i pokaż je osobno.
Zwróć nową wersję CLAUDE.md, krótszą niż 200 wierszy, oraz listę elementów, których przeniesienie do skills proponujesz.
Nie zmieniaj żadnych plików, dopóki tego nie potwierdzę.

Zwróć uwagę na ostatni wiersz: „Nie zmieniaj niczego, dopóki tego nie potwierdzę”. W przypadku modelu, który teraz korzysta z własnego osądu, to ważne: najpierw poproś go o przedstawienie planu, a decyzję pozostaw sobie.

Dlaczego kontekst jest ważniejszy od promptu?#

Jeśli odłożysz na bok szczegóły dotyczące Opus 5 i spojrzysz na szerszy obraz, cała ta analiza dotyczy jednej idei: kontekst jest ważniejszy od promptu. Najistotniejsza praca odbywa się przed prośbą — podczas przygotowywania środowiska, w którym model będzie pracował.

CLAUDE.md, skills i automatyczna pamięć są częściami tej samej całości: tego, co Claude widzi przed Twoją pierwszą wiadomością. Możesz bez końca poprawiać brzmienie prośby, ale jeśli kontekst jest źle przygotowany — CLAUDE.md jest przeładowany, reguły są sprzeczne, brakuje struktury — wyniki nadal będą niespójne.

Prosty test: bez pierwszego mózgu drugi mózg nie pomoże. W tym artykule „drugi mózg” oznacza strukturę wiedzy o projekcie, którą model odczytuje przy każdym żądaniu. Działa ona jednak tylko wtedy, gdy sam dobrze rozumiesz zadanie. Narzędzie wzmacnia Twoje myślenie, a na tym kończy się jego rola.

Aktualizacja Opus 5 wyostrzyła tę logikę. Anthropic pokazało własną pracą, że gdy model jest wystarczająco inteligentny, dodatkowe reguły tylko szkodzą, a przewagę zyskuje osoba, która starannie przygotowała kontekst. Ta umiejętność przyda Ci się w przypadku każdego kolejnego modelu, Opus 6 czy innego.

Od czego zacząć już teraz?#

Nie odkładaj tego na „kiedyś”. Najprostszy pierwszy krok to otworzyć CLAUDE.md już teraz i szczerze zadać sobie pytanie przy każdym wierszu: czy to pułapka, której Claude nie może wywnioskować, czy oczywistość dodana na wszelki wypadek? Każda pozycja z drugiej grupy nadaje się do usunięcia.

Następnie uporządkuj plik za pomocą promptu z poprzedniej sekcji, przenieś długie procedury do skills i sprawdź, czy automatyczna pamięć jest włączona. Jeden wieczór pracy wystarczy, aby Twój kontekst stał się zwięzłą i precyzyjną podstawą dla modelu.

Możesz to zastosować na własnym, rzeczywistym projekcie: CLAUDE.md, drugi mózg i skills do swoich zadań.

Poznaj Ailoot.