Katalog .claude
Projektowy katalog .claude/ przechowuje pliki Claude Code należące do repozytorium, podczas gdy część plików, takich jak CLAUDE.md, znajduje się w katalogu głównym. Możesz umieścić w nim między innymi instrukcje, reguły, ustawienia, definicje agentów i umiejętności. Wiele z tych plików ma zakres projektowy i może być współdzielonych przez zespół przez zapisanie ich w repozytorium.
Plik settings.json służy do przechowywania uprawnień, hooków, zmiennych środowiskowych i domyślnych ustawień modelu. Reguły w rules/ pozwalają umieszczać instrukcje dotyczące konkretnych tematów, a opcjonalnie także ograniczać je do wskazanych ścieżek. Katalog może też zawierać umiejętności i pojedyncze pliki promptów, które korzystają z tego samego mechanizmu.
Do prywatnych ustawień projektu służy settings.local.json, a Claude Code dodaje ten plik do .gitignore, gdy samo zapisuje w nim ustawienie. Ustawienia projektu nie zawsze rozstrzygają o zachowaniu sesji, ponieważ flagi CLI, takie jak --permission-mode lub --settings, mogą nadpisywać settings.json. Ustawienia wymuszone przez organizację mają pierwszeństwo przed plikami ustawień i wartościami przekazanymi przez --settings, poza wąskimi wyjątkami.
Nie należy mylić projektowego .claude/ z globalnym ~/.claude/, który przechowuje także dane zapisywane podczas pracy, takie jak transkrypcje, historię promptów, migawki plików, cache i logi. Globalny katalog zawiera również ustawienia i pliki o zakresie globalnym, które mogą obowiązywać we wszystkich projektach. Przed usuwaniem danych z ~/.claude/ zachowaj pliki stanu wymienione jako wymagające pozostawienia, w tym poświadczenia i pamięć agentów podrzędnych.
.claude/ plik ustawień dotyczących uprawnień, hooków, zmiennych środowiskowych i domyślnego modelu..claude/settings.json
settings.local.json na własne, osobiste nadpisania ustawień..claude/settings.local.json
Zastosowanie w praktyce
Gdy zespół chce współdzielić uprawnienia, hooki lub domyślny model projektu, może umieścić te ustawienia w settings.json w repozytorium. Gdy potrzebujesz osobistych nadpisań ograniczonych do jednego projektu, wybierz settings.local.json zamiast współdzielonego pliku ustawień. Gdy instrukcje mają dotyczyć określonych tematów lub ścieżek, użyj plików reguł rules/*.md. Jeśli porządkujesz dane globalne, odróżnij pliki konfiguracyjne od danych aplikacji, takich jak transkrypcje, migawki plików i logi.
settings.local.json; pamiętaj jednak, że flagi CLI i ustawienia zarządzane przez organizację mogą mieć nad nim pierwszeństwo.