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
  1. Gdzie położyć każdy plik
  2. Przykład CLAUDE.md dla strony firmowej
  3. Przykład dla aplikacji Laravel i Vue
  4. Przykład dla folderu bez kodu
  5. Plik osobisty i CLAUDE.local.md
  6. Importy, komentarze i przegląd plików

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.

PlikGdzie leżyKto go widzi
CLAUDE.md albo .claude/CLAUDE.mdGłówny folder projektuCały zespół przez repozytorium
CLAUDE.local.mdGłówny folder, dopisany do .gitignoreTylko Wy, w tym projekcie
~/.claude/CLAUDE.mdFolder domowyTylko Wy, we wszystkich projektach
.claude/rules/*.mdFolder projektuZespół, 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.

CLAUDE.md
# 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.

CLAUDE.md
# 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.md

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

.claude/rules/frontend.md
---
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.

CLAUDE.md
# 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 nowe

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

~/.claude/CLAUDE.md
# Moje zasady

- Odpowiadaj po polsku, kod i commity po angielsku
- Przed większą zmianą pokaż plan i poczekaj na zgodę
- Nie instaluj pakietów globalnie

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

CLAUDE.local.md
# 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.

Kiedy najlepiej zadzwonić?
Administrator: Oleksandr Bondarenko (BondSoft)Polityka prywatnościRegulamin
Szczegóły prawne

Administratorem danych jest Oleksandr Bondarenko, prowadzący działalność gospodarczą pod firmą Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Dane przetwarzamy wyłącznie w celu kontaktu w sprawie Twojego zapytania i przedstawienia oferty — na podstawie Twojej zgody (art. 6 ust. 1 lit. a RODO oraz art. 398 ustawy Prawo komunikacji elektronicznej) oraz naszego prawnie uzasadnionego interesu polegającego na obsłudze zapytania (art. 6 ust. 1 lit. f RODO).

Podanie danych jest dobrowolne, ale niezbędne do kontaktu zwrotnego. Zgodę możesz wycofać w każdej chwili, pisząc na office@bondsoft.pl — nie wpływa to na zgodność z prawem przetwarzania sprzed wycofania.

Masz prawo dostępu do danych, ich sprostowania, usunięcia, ograniczenia przetwarzania, przenoszenia oraz wniesienia skargi do Prezesa Urzędu Ochrony Danych Osobowych.

Pełna informacja: Polityka prywatności.

Napiszcie e-mail

Usługa, o której jest ten tekst

Automatyzacja i AI / OCR

Automatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.