CLAUDE.md — jeden plik, który robi z AI prawdziwego inżyniera

Większość ludzi używa AI jak automat do kawy. Wrzucasz monetę — prompt — i czekasz. Problem: każda sesja zaczyna się od zera. AI nie pamięta, że dwa tygodnie temu powiedziałeś mu, że wolisz tRPC od REST. CLAUDE.md to rozwiązuje.

Co to jest CLAUDE.md

CLAUDE.md to plik tekstowy w katalogu głównym projektu. Claude Code czyta go automatycznie przy każdym uruchomieniu. Staje się stałym kontekstem — instrukcją, którą AI ma zawsze w głowie.

Stack projektu, zasady kodowania, znane pułapki. I od tej chwili AI wie to wszystko. Zawsze. Bez przypominania.

Efekt procentu składanego

Boris Cherny, twórca Claude Code, nazwał to "compounding engineering". Widzisz błąd? Dopisujesz do CLAUDE.md. Następnym razem AI go nie powtórzy. I za miesiąc też nie.

Wiedza się kumuluje. Błędy nie wracają. Po 3 miesiącach jakość kodu rośnie iteracyjnie.

Co warto wpisać do CLAUDE.md — checklista startowa

Stack i architektura: framework, biblioteki, baza danych, autentykacja, hosting.

Zasady kodowania: styl TypeScripta, konwencje, czego unikać.

Specyfika projektu: znane pułapki, co w trakcie refaktoringu.

Workflow: testy, deploy, weryfikacja.

Jak zacząć — dosłownie 10 minut

Wejdź do projektu, stwórz CLAUDE.md, wpisz 5-10 rzeczy które tłumaczysz AI za każdym razem. Reszta to iteracja.

Czy to działa tylko z Claude Code?

CLAUDE.md jest specyficzny dla Claude Code. Ale ten sam princip działa wszędzie: w Cursor IDE (.cursorrules), w ChatGPT (Custom Instructions), w API (system prompt).

Napisz do mnie — podzielę się swoim szablonem CLAUDE.md.

Czego AI nie pamięta bez CLAUDE.md

Bez CLAUDE.md każda sesja z Claude Code to rozmowa z kimś, kto właśnie wszedł do projektu. Nie wie że używasz Prisma zamiast TypeORM. Nie wie że nazwy komponentów są po angielsku, a komentarze po polsku. Nie wie że tabela users ma softDelete zamiast hard delete.

Więc wyjaśniasz. Znowu. I znowu. CLAUDE.md to odpowiedź na pytanie: "co chcę żeby AI wiedziało zawsze, zanim zada mi pierwsze pytanie?"

Przykład — jak wygląda dobry CLAUDE.md

Elementy które wpisuję do CLAUDE.md na każdym projekcie:

Stack: Next.js 14 App Router, TypeScript strict, Prisma ORM, PostgreSQL, Tailwind CSS.

Konwencje: komponenty w PascalCase, hooki w camelCase z prefiksem 'use', typy w osobnym pliku types.ts per feature.

Pułapki: nie używaj useEffect do fetching danych — tylko React Query. Server Components domyślnie, Client Components tylko gdy trzeba interaktywności.

Aktualnie w trakcie: migracja z Pages Router do App Router — nie dotykaj folderu /pages.

Taki plik sprawia, że AI rozumie projekt bez wyjaśnień. Od pierwszego komentarza.

Kluczowe wnioski

• CLAUDE.md = stały kontekst projektu — AI nie zaczyna od zera każdej sesji
• Boris Cherny nazwał to 'compounding engineering' — wiedza kumuluje się z sesji na sesję
• Co wpisać: stack, konwencje, znane pułapki, workflow, co jest w trakcie refaktoringu
• Czas stworzenia: 10 minut. Zwrot: każda kolejna sesja lepsza od poprzedniej
• Zasada: AI powtórzył błąd? Dopisz go do CLAUDE.md — już nie wróci

Najczęstsze pytania