Pliki CLAUDE.md są fundamentem efektywnego używania Claude Code. Zapewniają trwałą pamięć między sesjami, ustalają kontekst projektu i dramatycznie poprawiają jakość pomocy Claude. Te 10 wskazówek pomoże ci tworzyć pliki CLAUDE.md, które przekształcą twój przepływ pracy.
Pliki CLAUDE.md służą jako system trwałej pamięci Claude Code. W przeciwieństwie do historii konwersacji, która jest czyszczona, te pliki są automatycznie ładowane na początku każdej sesji, zapewniając spójny kontekst o twoim projekcie.
Kluczowe korzyści
Pliki CLAUDE.md mogą być umieszczone na wielu poziomach hierarchii twojego projektu. Claude Code automatycznie je odkrywa i priorytetyzuje na podstawie szczegółowości:
project-root/+-- CLAUDE.md # Globalny kontekst projektu+-- ~/.claude/CLAUDE.md # Osobiste globalne preferencje+-- frontend/| +-- CLAUDE.md # Wytyczne specyficzne dla frontendu+-- backend/| +-- CLAUDE.md # Wzorce specyficzne dla backendu+-- src/ +-- components/ +-- CLAUDE.md # Konwencje na poziomie komponentówKolejność priorytetów (najbardziej szczegółowy wygrywa):
# Przegląd projektu
To jest platforma e-commerce zbudowana z Next.js i Node.js.
## Architektura- Frontend: Next.js 14 z App Router- Backend: Node.js z Express- Baza danych: PostgreSQL z Prisma ORM- Uwierzytelnianie: JWT z tokenami odświeżania- Zarządzanie stanem: Zustand
## Kluczowe zasady- TypeScript dla całego nowego kodu- Komponenty funkcyjne z hookami- RESTful API design- Kompleksowa obsługa błędów# Wytyczne frontendu
## Struktura komponentów- Używaj komponentów funkcyjnych z TypeScript- Interfejsy Props zdefiniowane nad komponentem- Niestandardowe hooki w katalogu `/hooks`- Wspólne komponenty w `/components/shared`
## Stylowanie- Tailwind CSS do wszystkich stylów- Żadnych inline styles poza dynamicznymi wartościami- Wymagane wsparcie trybu ciemnego- Projektowanie mobile-first responsive# Osobiste preferencje
## Styl kodu- Preferuj wczesne zwroty nad zagnieżdzonych warunkach- Używaj opisowych nazw zmiennych (bez skrótów)- Komentarze dla "dlaczego", nie "co"- Maksymalna długość linii: 100 znaków
## Przepływ pracy Git- Format konwencjonalnych commitów- Squash commitów przed mergowaniem- Zawsze tworzenie gałęzi funkcjiClaude Code może automatycznie wygenerować kompleksowy plik CLAUDE.md analizując twój projekt:
claude/initTa komenda:
Po wygenerowaniu, dostosuj go dodając:
Dołącz często używane komendy i skrypty, aby zmniejszyć przełączanie kontekstu:
# Częste komendy
## Rozwój- `npm run dev` - Uruchom serwer deweloperski (port 3000)- `npm run build` - Buduj na produkcję- `npm run test` - Uruchom zestaw testów- `npm run test:watch` - Uruchom testy w trybie obserwacji- `npm run lint` - Uruchom ESLint z auto-fix- `npm run typecheck` - Uruchom sprawdzanie kompilatora TypeScript
## Baza danych- `npm run db:migrate` - Uruchom oczekujące migracje- `npm run db:seed` - Zasiej dane deweloperskie- `npm run db:reset` - Resetuj bazę danych (UWAGA: destrukcyjne)- `npm run db:studio` - Otwórz Prisma Studio
## Wdrażanie- `npm run deploy:staging` - Wdrażanie na staging (wymaga VPN)- `npm run deploy:prod` - Wdrażanie na produkcję (wymaga zatwierdzenia)
## Niestandardowe skrypty- `./scripts/generate-types.sh` - Generuj typy TypeScript z API- `./scripts/analyze-bundle.sh` - Analizuj rozmiar bundla webpack- `./scripts/update-deps.sh` - Interaktywny aktualizator zależnościProfesjonalna wskazówka
Dołącz kontekst o tym kiedy i dlaczego używać każdej komendy, nie tylko co robią.
Dokumentuj standardy kodowania twojego zespołu i preferencje jasno:
# Wytyczne stylu kodu
## TypeScript- **ZAWSZE** używaj jawnych typów zwracanych dla funkcji- **ZAWSZE** definiuj interfejsy dla propsów komponentów- **PREFERUJ** type nad interface dla unii i prymitywów- **UNIKAJ** typu any - używaj unknown i zawężania typów
Przykład:\`\`\`typescript// Dobrzeinterface ButtonProps { label: string; onClick: () => void; variant?: 'primary' | 'secondary';}
const Button: React.FC<ButtonProps> = ({ label, onClick, variant = 'primary' }) => { return <button className={styles[variant]} onClick={onClick}>{label}</button>;};
// Źleconst Button = ({ label, onClick, variant }: any) => { return <button onClick={onClick}>{label}</button>;};\`\`\`
## Organizacja importów1. Zewnętrzne zależności2. Wewnętrzne aliasy (~/)3. Importy relatywne (./)4. Importy stylów
Przykład:\`\`\`typescriptimport React, { useState, useEffect } from 'react';import { useRouter } from 'next/router';
import { api } from '~/lib/api';import { Button } from '~/components/ui';
import { formatDate } from './utils';import styles from './Component.module.css';\`\`\`
## Obsługa błędów- Używaj niestandardowych klas błędów- Zawsze loguj błędy z kontekstem- Dostarczaj przyjazne dla użytkownika komunikaty błędów- Dołączaj error boundaries dla komponentów ReactDokumentuj praktyki zespołu i przepływ pracy, aby zapewnić spójność:
# Etykieta repozytorium
## Przepływ pracy Git1. **Nazewnictwo gałęzi**: `feature/opis`, `fix/opis`, `chore/opis`2. **Komunikaty commitów**: Podążaj za konwencjonalnymi commitami - `feat:` Nowa funkcja - `fix:` Naprawa błędu - `docs:` Tylko dokumentacja - `style:` Zmiany stylu kodu - `refactor:` Refaktoryzacja kodu - `test:` Zmiany testów - `chore:` Zmiany procesu budowy lub narzędzi pomocniczych
## Proces Pull Request1. **Samodzielny przegląd**: Najpierw przejrzyj własne PR2. **Opis**: Użyj szablonu PR, podłącz do issue3. **Testy**: Wszystkie testy muszą przejść4. **Zrzuty ekranu**: Dołącz dla zmian UI5. **Rozmiar**: Utrzymuj PR poniżej 400 linii gdy to możliwe
## Wytyczne Code Review- Bądź konstruktywny i konkretny- Sugeruj ulepszenia, nie tylko krytykuj- Używaj "my" zamiast "ty" w komentarzach- Zatwierdzaj z "LGTM" (Looks Good To Me)
## Strategia merge- **Squash and merge** dla gałęzi funkcji- **Rebase** do aktualizacji gałęzi funkcji- **Bez merge commitów** w głównej gałęziPomóż Claude zrozumieć twoje środowisko deweloperskie:
# Środowisko deweloperskie
## Wymagania wstępne- Node.js 18.x lub wyżej (użyj nvm)- PostgreSQL 14.x- Redis 6.x (do cache)- Docker Desktop (opcjonalnie, dla kontenerów)
## Początkowa konfiguracja1. Klonuj repozytorium: `git clone <repo-url>`2. Zainstaluj zależności: `npm install`3. Skopiuj zmienne środowiskowe: `cp .env.example .env`4. Skonfiguruj plik .env: - DATABASE_URL: String połączenia PostgreSQL - REDIS_URL: String połączenia Redis - JWT_SECRET: Wygeneruj za pomocą `openssl rand -base64 32` - API_KEY: Uzyskaj od lidera zespołu5. Uruchom migracje: `npm run db:migrate`6. Zasiej bazę danych: `npm run db:seed`7. Uruchom rozwój: `npm run dev`
## Zmienne środowiskowe- **Rozwój**: Użyj .env.local (git-ignored)- **Testowanie**: Użyj .env.test- **Produkcja**: Ustaw na platformie wdrażania
## Znane problemy- Gorące przeładowanie może zawieść na Windows - uruchom ponownie serwer deweloperski- Port 3000 koliduje z innymi usługami - zmień w .env- Połączenia z bazą danych mogą się wyczerpać - zwiększ rozmiar puliDokumentuj pułapki i nieoczywiste zachowania:
# Ważne ostrzeżenia
## Względy wydajności- **Strona listy produktów**: Limit do 50 elementów ze względu na wydajność- **Przesyłanie obrazów**: Automatycznie kompresowane, max 5MB- **Indeksowanie wyszukiwania**: Działa asynchronicznie, może trwać 30 sekund- **Invalidacja cache**: Wymagane ręczne wyzwolenie dla niektórych operacji
## Uwagi bezpieczeństwa- **Klucze API**: Nigdy nie commituj do repozytorium- **Dane użytkowników**: PII musi być szyfrowane w spoczynku- **Przesyłanie plików**: Waliduj typy MIME po stronie serwera- **Zapytania SQL**: Używaj wyłącznie zapytań parametryzowanych
## Częste pułapki1. **Zarządzanie stanem** - Nie mutuj stanu Zustand bezpośrednio - Używaj immer do złożonych aktualizacji
2. **Wywołania API** - Zawsze obsługuj stany ładowania i błędu - Używaj AbortController do czyszczenia
3. **Zapytania do bazy danych** - N+1 zapytania częste w panelu użytkownika - Używaj includes dla powiązanych danych
4. **Testowanie** - Mockuj zewnętrzne usługi - Resetuj bazę danych między zestawami testówClaude Code zapewnia szybki sposób aktualizacji plików CLAUDE.md podczas rozwoju:
# Podczas sesji Claude Code, naciśnij # i wpisz:Always use Tailwind classes for styling, never inline styles
# Claude odpowiada:I'll add that to the most relevant CLAUDE.md file.Ta funkcja:
Częste zastosowania:
Traktuj treść CLAUDE.md jak prompty - bądź konkretny i używaj podkreśleń:
# Wytyczne
Używaj TypeScript dla plików.
Podążaj za style guide.
Pisz testy.# Krytyczne wytyczne
**ZAWSZE** używaj TypeScript ze strict mode włączonym dla WSZYSTKICH plików.
**MUSISZ** podążać za style guide Airbnb z naszymi modyfikacjami:- 2 spacje wcięcia (NIE tabulatory)- Wymagane średniki- Przecinki na końcu w wieloliniowych
**WYMAGANE** dla każdej funkcji:- Testy jednostkowe z >80% pokryciem- Testy integracyjne dla endpointów API- Testy E2E dla krytycznych ścieżek użytkownika
**NIGDY**:- Używaj słowa kluczowego var (użyj const/let)- Commituj instrukcji console.log- Wyłączaj reguły ESLint bez komentarzaSkuteczne wzorce instrukcji:
Okresowo optymalizuj swoje pliki CLAUDE.md używając technik ulepszania promptów Anthropic:
Wyeksportuj treść CLAUDE.md
cat CLAUDE.md > claude-md-content.txtUżyj Claude do ulepszenia
Improve this CLAUDE.md file to be more effective for Claude Code.Make instructions clearer, add helpful examples, and organize better:
[wklej treść]Skup się na ulepszeniach takich jak:
Przetestuj ulepszoną wersję
Lista kontrolna optymalizacji
Najbardziej skuteczne pliki CLAUDE.md mają wspólne cechy:
Z dobrze zoptymalizowanymi plikami CLAUDE.md zapewniającymi kontekst, jesteś gotowy opanować interfejs linii poleceń. Przejdź do Mistrzostwo w linii poleceń, aby nauczyć się istotnych komend i skrótów produktywności.