Monorepo i duże projekty

Duży codebase może oznaczać jedno repozytorium z milionami linii albo monorepo z wieloma pakietami. Wraz ze wzrostem projektu domyślna konfiguracja może zapełniać okno kontekstu instrukcjami i odczytami plików niezwiązanymi z zadaniem, co kosztuje tokeny i pogarsza działanie Claude’a. Konfigurację warto więc ukierunkować na tę część drzewa kodu, której dotyczy zadanie, zamiast ładować konwencje wszystkich obszarów naraz.

Miejsce uruchomienia claude wpływa na dostęp do plików, instrukcje CLAUDE.md ładowane na starcie i stosowane ustawienia projektu. Uruchomienie z katalogu głównego sprawdza się przy zadaniach obejmujących wiele pakietów, a start z podkatalogu ogranicza pracę do jego drzewa, dopóki nie przyznasz dalszego dostępu. Instrukcje można rozdzielić na reguły wspólne w głównym CLAUDE.md oraz konwencje specyficzne dla podkatalogów; pliki podrzędne ładują się na żądanie.

Ustawienie claudeMdExcludes pozwala pomijać wskazane pliki CLAUDE.md według ścieżki lub wzorca glob, na przykład dla pakietu, nad którym nie pracujesz. Wykluczenia są stałe, a nie przełączane zależnie od zadania, więc przy rotacji między pakietami lepiej uruchamiać Claude’a z katalogu aktualnie używanego pakietu. Dla zatwierdzonych w repozytorium artefaktów, takich jak vendored SDK lub wygenerowany kod, reguły Read w permissions.deny blokują otwieranie tych plików.

W dużym repozytorium worktree.sparsePaths używa git sparse-checkout, aby worktree zawierał tylko wskazane katalogi i pliki z katalogu głównego, co przyspiesza jego start i ogranicza zajęte miejsce. W sparsePaths podaje się katalogi, nie pojedyncze pliki; pliki głównego poziomu, takie jak manifesty i lockfile, są dołączane automatycznie. Gdy lokalizowanie symboli wymagałoby wielu odczytów i wyszukiwań, plugin code intelligence łączy Claude’a z serwerem językowym, który znajduje definicje i referencje oraz pokazuje błędy typów.

{
  "claudeMdExcludes": [
    "**/packages/web/**"
  ]
}

{
  "worktree": {
    "sparsePaths": [
      ".claude",
      "packages/api",
      "packages/shared"
    ]
  }
}

{
  "permissions": {
    "deny": [
      "Read(./**/dist/**/*)",
      "Read(./**/build/**/*)",
      "Read(./**/*.generated.*)",
      "Read(./**/vendor/**/*)"
    ]
  }
}