CLAUDE.md przykłady. Cztery szablony do skopiowania, także dla folderu bez kodu
Gotowe pliki CLAUDE.md dla strony firmowej, aplikacji Laravel z Vue, folderu z ofertami i ustawień osobistych. Do tego reguły w .claude/rules, importy i CLAUDE.local.md.
Część przewodnikaClaude Code. Kompletny przewodnik od instalacji po własne skille i pluginy
W tym tekście
W skrócie
Na tej stronie są cztery gotowe szablony pliku CLAUDE.md dla strony firmowej, aplikacji Laravel z Vue, folderu z ofertami i ustawień osobistych. Do tego przykład reguły w folderze .claude/rules, importu przez znak @ i pliku CLAUDE.local.md, wszystko sprawdzone w dokumentacji Anthropic.
Programista wpisuje /init i dostaje pierwszy CLAUDE.md. Jest długi, opisuje rzeczy, które Claude i tak widzi w kodzie, a brakuje w nim tego jednego zdania, przez które Claude co tydzień robi ten sam błąd. Łatwiej zacząć od gotowego przykładu CLAUDE.md i przerobić go pod siebie.
Czym jest ten plik i dlaczego nie jest blokadą, opisaliśmy w osobnym tekście o CLAUDE.md. Tutaj są same szablony. Każdy jest dużo krótszy niż 200 linii, bo tyle dokumentacja Anthropic podaje jako górną granicę dla jednego pliku. Ta strona należy do przewodnika po Claude Code, a wszystkie ścieżki sprawdziliśmy w dokumentacji, stan na 10 listopada 2026.
Gdzie położyć każdy plik
Claude Code czyta kilka plików z instrukcjami i skleja je w jeden kontekst. Nic się nie nadpisuje. Plik bliżej folderu, w którym uruchomiliście Claude Code, trafia do kontekstu później.
| Plik | Gdzie leży | Kto go widzi |
|---|---|---|
CLAUDE.md albo .claude/CLAUDE.md | Główny folder projektu | Cały zespół przez repozytorium |
CLAUDE.local.md | Główny folder, dopisany do .gitignore | Tylko Wy, w tym projekcie |
~/.claude/CLAUDE.md | Folder domowy | Tylko Wy, we wszystkich projektach |
.claude/rules/*.md | Folder projektu | Zespół, zawsze albo przy pasujących plikach |
Po zapisaniu pliku wpiszcie w sesji /context all i sprawdźcie listę Memory files. Jeśli plik tam jest, Claude go wczytał.
Przykład CLAUDE.md dla strony firmowej
Mała strona na Astro z treściami w Markdown. Plik mówi Claude, jak zbudować stronę i czego nie ruszać. Nie opisuje, czym zajmuje się firma, bo to Claude przeczyta w samych tekstach.
# Strona firmy Remonty Nowak
Statyczna strona na Astro. Treści w Markdown w `src/content/`.
## Polecenia
- `npm run dev` uruchamia podgląd na komputerze
- `npm run build` buduje stronę do folderu `dist/`
- Przed oddaniem zmian uruchom `npm run build` i sprawdź, czy nie ma błędów
## Zasady
- Teksty dla klientów po polsku, zwracamy się do klienta per Wy
- Telefon, adres i godziny bierz z `src/data/firma.json`, nie wpisuj ich w kod
- Nowe zdjęcia zapisuj jako WebP w `public/img/`, każde z opisem w alt
- Nie zmieniaj adresów istniejących podstron, bo są już w Google
## Nie ruszaj bez pytania
- `public/robots.txt`
- `src/data/firma.json`Najwięcej daje tu zdanie o adresach podstron. Claude chętnie porządkuje nazwy plików, a na stronie firmowej zmiana nazwy pliku zmienia adres, który Google już zna.
Przykład dla aplikacji Laravel i Vue
Większy projekt z backendem i frontendem w osobnych folderach. Główny plik trzyma polecenia i zasady architektury, a zasady pisania komponentów idą do osobnej reguły.
# Panel zamówień
Laravel w `backend/`, Vue 3 z TypeScript w `frontend/`. Baza MySQL.
## Polecenia
- `php artisan test` w `backend/` uruchamia testy PHP
- `npm run test` w `frontend/` uruchamia testy frontendu
- `npm run lint` w `frontend/` sprawdza styl, puść przed commitem
- `php artisan migrate` tylko na lokalnej bazie
## Architektura
- Logika biznesowa w `backend/app/Services/`, kontrolery tylko przyjmują i oddają dane
- Każda zmiana w bazie przez nową migrację, nigdy edycja starej
- Teksty interfejsu w `frontend/src/i18n/`, po polsku i angielsku
## Git
- Jedna gałąź na zadanie, nazwa `feature/krotki-opis`
Opis API w @docs/api.mdOstatnia linijka to import. Claude Code wczyta docs/api.md razem z tym plikiem. Import porządkuje tekst, ale nie oszczędza kontekstu, bo zaimportowany plik i tak ładuje się na starcie.
Zasady dla jednej części projektu lepiej trzymać w folderze .claude/rules/. Reguła z polem paths wczytuje się dopiero wtedy, gdy Claude czyta albo zmienia pasujący plik.
---
paths:
- "frontend/src/**/*.{ts,vue}"
---
# Frontend
- Komponenty w Composition API z `<script setup lang="ts">`
- Nowa biblioteka tylko po pytaniu
- Kolory tylko ze zmiennych w `frontend/src/styles/tokens.css`paths to jedyne pole, które Claude Code czyta z nagłówka reguły. Reguła bez paths ładuje się na starcie, tak jak sam CLAUDE.md.
Przykład dla folderu bez kodu
Claude Code pracuje na plikach, więc nie musi to być kod. Folder z ofertami w Markdown też może mieć swój CLAUDE.md. Jeśli w biurze nikt nie używa terminala, podobną pracę da się zrobić w Cowork, o którym piszemy w tekście Claude Cowork w praktyce.
# Oferty dla klientów
Folder z ofertami firmy. Bez kodu.
## Jak pracujemy
- Nowa oferta to kopia `szablony/oferta.md` zapisana w `oferty/2026/`
- Nazwa pliku to data i klient, na przykład `2026-11-10-piekarnia-klos.md`
- Dane firmy bierz z `dane/firma.md`
- Cen nie wymyślaj. Gdy brakuje ceny, wpisz DO UZUPEŁNIENIA
- Piszemy krótko, po polsku, do klienta per Państwo
## Nigdy
- Nie usuwaj i nie nadpisuj plików w `oferty/`, twórz tylko noweSekcja Nigdy to nadal prośba. Prawdziwą blokadę ustawia się regułą w uprawnieniach Claude Code albo hookiem, który odrzuca edycję wybranych plików.
Plik osobisty i CLAUDE.local.md
Plik w folderze domowym działa we wszystkich projektach. To miejsce na Wasze przyzwyczajenia, a nie na zasady zespołu.
# Moje zasady
- Odpowiadaj po polsku, kod i commity po angielsku
- Przed większą zmianą pokaż plan i poczekaj na zgodę
- Nie instaluj pakietów globalnieCLAUDE.local.md w głównym folderze projektu to notatki tylko dla Was. Claude Code czyta go zaraz po CLAUDE.md z tego samego folderu. Dopiszcie go do .gitignore, żeby nie trafił do repozytorium.
# Tylko u mnie
- Lokalna wersja działa pod `http://localhost:8000`
- Testowe konto to `test@example.com`, hasło jest w menedżerze hasełKto pracuje na kilku worktree tego samego repozytorium, ten ma CLAUDE.local.md tylko w jednym z nich. Dokumentacja radzi wtedy import z folderu domowego, na przykład @~/.claude/moj-projekt.md. Przy pierwszym imporcie spoza folderu projektu Claude Code pyta o zgodę.
Importy, komentarze i przegląd plików
Import to ścieżka po znaku @. Ścieżka względna liczy się od pliku, w którym stoi import, a nie od folderu, w którym uruchomiliście Claude Code. Zaimportowany plik może importować kolejne, najwyżej na głębokość czterech kroków. Ścieżka w odwrotnych apostrofach, czyli zapisana jako kod, nie jest importowana.
Jeśli w repozytorium jest już AGENTS.md dla innych narzędzi, najprostszy CLAUDE.md zaczyna się od linijki @AGENTS.md, a pod nią są tylko zasady dla Claude. Więcej o tym w tekście o AGENTS.md i CLAUDE.md.
Blokowe komentarze HTML w CLAUDE.md są wycinane, zanim treść trafi do modelu. Można w nich zostawić notatkę dla ludzi i nie płacić za nią kontekstem.
Gdy plików przybywa, pomaga polecenie /doctor prompt-audit. Claude szuka w nich instrukcji, które są nieaktualne, wskazują na nieistniejące pliki albo sobie przeczą, i proponuje poprawki. Niczego nie zmienia, dopóki o to nie poprosicie. Polecenie wymaga Claude Code w wersji 2.1.283 lub nowszej.
Skopiujcie jeden szablon, usuńcie wszystko, czego Claude dowie się z samego kodu, i dopisujcie po zdaniu, gdy ten sam błąd wróci drugi raz. Jeśli chcecie wiedzieć, w których miejscach Waszej firmy AI może zdjąć z ludzi powtarzalną pracę, zamówcie bezpłatny audyt AI.
Co chcecie zmienić w swojej firmie?
Zostawcie numer. Porozmawiamy o Waszym procesie i sprawdzimy, czy możemy pomóc. Pierwsza rozmowa jest bezpłatna.
Usługa, o której jest ten tekst
Automatyzacja i AI / OCRAutomatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.