CLAUDE.md (Claude Code): lokalizacja i sposób odczytu przez narzędzia

CLAUDE.md to plik pamięci, który Claude Code wczytuje przy uruchomieniu z katalogu domowego, projektu i każdego katalogu nadrzędnego. Reguły zależne od ścieżki w .claude/rules/ dostarczają wskazówek wczytywanych tylko podczas odczytu pasujących plików.

Lokalizacja

• Projekt: ./CLAUDE.md lub ./.claude/CLAUDE.md — plik zatwierdzany w repozytorium i udostępniany zespołowi.
• Lokalnie: ./CLAUDE.local.md — na prywatne notatki, które nie mają trafić do gita.
• Użytkownik: ~/.claude/CLAUDE.md — stosowany we wszystkich projektach.
• Reguły: ./.claude/rules/**/*.md i ~/.claude/rules/**/*.md, opcjonalnie ograniczone do określonych ścieżek za pomocą front matter.
• Zarządzana polityka: /Library/Application Support/ClaudeCode/CLAUDE.md w systemie macOS, C:\Program Files\ClaudeCode\CLAUDE.md w systemie Windows lub klucz claudeMd w pliku managed-settings.json.

Format

Markdown. Pliki w .claude/rules/ mogą zaczynać się od YAML frontmatter, którego klucz paths zawiera listę wzorców glob. Dołączaj inne pliki za pomocą @path/to/file, maksymalnie 4 poziomy wgłąb. Nie udokumentowano twardego limitu rozmiaru, ale Anthropic zaleca, by każdy plik miał mniej niż 200 wierszy.

Klucze frontmatter: paths

@AGENTS.md

# Claude Code notes

- Run `pnpm test` after every change under src/.
- Use the `gh` CLI for issues and pull requests.
- Ask before adding a dependency.

## API

- Error format is described in @docs/api-errors.md.
- One handler file per route in src/api/.

Priorytety i scalanie

Żaden plik nie zastępuje innego — wszystkie znalezione pliki są łączone. Najpierw wczytywana jest zarządzana polityka, a następnie pliki od katalogu głównego systemu plików do katalogu uruchomienia, więc pliki z bardziej zagnieżdżonych katalogów są wczytywane później. W obrębie jednego katalogu CLAUDE.local.md jest wczytywany po CLAUDE.md. Pliki w podkatalogach są wczytywane na żądanie, gdy Claude odczytuje znajdujące się w nich pliki. Zarządzanej polityki nie można wykluczyć za pomocą claudeMdExcludes.

Narzędzia, które go odczytują

Wskazówki

• Jeśli używasz pliku CLAUDE.md, zacznij go od @AGENTS.md. W przeciwnym razie przy ustawieniach domyślnych Claude Code ignoruje AGENTS.md.
• Przenieś wskazówki dotyczące konkretnych obszarów do .claude/rules/ i dodaj frontmatter paths, aby były wczytywane tylko dla wskazanych plików.
• Importy porządkują plik, ale nadal zużywają kontekst, ponieważ importowany tekst również jest wczytywany.
• Uruchom /doctor, aby jednocześnie sprawdzić CLAUDE.md, CLAUDE.local.md, AGENTS.md, reguły i umiejętności.

Inne pliki z instrukcjami