Importy w CLAUDE.md (@ścieżka)
Plik CLAUDE.md może włączać dodatkowe pliki za pomocą składni @ścieżka/do/pliku. Zaimportowane pliki są rozwijane i ładowane do kontekstu razem z plikiem CLAUDE.md, który zawiera odwołanie. Odwołania można umieszczać w dowolnym miejscu CLAUDE.md, także obok instrukcji dotyczących pracy z projektem.
Ścieżki do importowanych plików mogą być względne albo bezwzględne. Ścieżka względna jest rozwiązywana względem pliku zawierającego import, a nie względem katalogu roboczego. Zaimportowany plik może importować kolejne pliki, ale maksymalna głębokość wynosi cztery skoki.
Jeśli ścieżka zawiera spacje, poprzedź każdą z nich ukośnikiem odwrotnym. Bez tych ukośników ścieżka kończy się na pierwszej spacji, nawet jeśli import znajduje się w osobnym wierszu. Ujęcie ścieżki w cudzysłów nie importuje pliku, a zapis @README w backtickach pozostaje tekstem literalnym.
Import z pliku pamięci projektu jest zewnętrzny, gdy jego ścieżka prowadzi poza katalog roboczy, na przykład do katalogu domowego. Przy pierwszym napotkaniu takich importów w projekcie Claude Code pokazuje okno zatwierdzenia z listą plików; po odmowie importy pozostają wyłączone, a okno nie pojawia się ponownie. Aby współdzielić osobiste instrukcje między worktree, można importować plik z katalogu domowego; w sesjach Cowork na desktopie importy z pamięci użytkownika są traktowane inaczej niż w pozostałych sesjach.
Design Docs, którego nazwa zawiera spację.- API conventions @Design\ Docs/api-conventions.md
@ w jednym fragmencie CLAUDE.md.See @README for project overview and @package.json for available npm commands for this project.
# Individual Preferences - @~/.claude/my-project-instructions.md
Zastosowanie w praktyce
Gdy instrukcje dotyczące projektu znajdują się w osobnym pliku, odwołaj się do niego przez @ w CLAUDE.md, aby jego zawartość została załadowana do kontekstu. Jeśli pracujesz na wielu worktree tego samego repozytorium i chcesz współdzielić osobiste instrukcje, możesz importować je z katalogu domowego. Przy imporcie spoza katalogu roboczego w projekcie uwzględnij okno zatwierdzenia, które pojawia się przy pierwszym napotkaniu takich plików.