Praca z dużymi bazami kodu wymaga innych strategii niż małe projekty. Te 15 wskazówek pomoże ci wykorzystać unikalne możliwości Claude Code dla rozwoju na skalę przedsiębiorstwa, od milionów linii monorepo po złożone architektury mikrousług.
Claude Code używa agentowego wyszukiwania do automatycznego zrozumienia całej struktury twojego projektu:
# Zamiast ręcznego wyjaśniania struktury projektu"Wyjaśnij jak działa system uwierzytelniania"
# Claude automatycznie:# 1. Wyszukuje pliki związane z auth# 2. Identyfikuje kluczowe komponenty# 3. Śledzi zależności# 4. Rozumie przepływ# 5. Dostarcza kompleksowe wyjaśnienieMożliwości wyszukiwania agentowego
Przykład z rzeczywistego świata od zespołu infrastruktury danych Anthropic:
# Wprowadzanie nowego pracownika"Pomóż mi zrozumieć jak dane płyną z naszego API do dashboardów"
# Odpowiedź Claude obejmuje:# - Identyfikację endpointów API# - Pipeline transformacji danych# - Relacje schematu bazy danych# - Wzorce zapytań dashboardu# - Odpowiednią dokumentację CLAUDE.mdClaude Code doskonale radzi sobie tam, gdzie inne narzędzia zawodzą z masywymi plikami:
# Przykład komponentu React Builder.io"Zaktualizuj obsługę zdarzeń w naszym komponencie 18,000 linii"
# Claude pomyślnie:# - Ładuje cały plik# - Znajduje konkretną funkcję# - Wprowadza precyzyjne zmiany# - Utrzymuje kontekst# - Obsługuje złożony stan# Dla optymalnej wydajności z dużymi plikami:
# 1. Bądź konkretny co do lokalizacji"Zaktualizuj funkcję handleSubmit około linii 8500"
# 2. Używaj wzorców wyszukiwania"Znajdź wszystkie wystąpienia przestarzałych wywołań API"
# 3. Pracuj inkrementalnie"Najpierw pokaż mi logikę uwierzytelniania""Teraz zaktualizuj obsługę błędów"Pozwól Claude nawigować po złożonych bazach kodu za ciebie:
# Znajdowanie wzorców"Pokaż mi wszystkie miejsca gdzie obsługujemy uprawnienia użytkowników"
# Zrozumienie architektury"Jak nasze mikrousługi się komunikują?"
# Lokalizacja funkcjonalności"Gdzie jest logika walidacji email?"
# Analiza zależności"Co zależy od klasy UserService?"
# Problemy przekrojowe"Znajdź wszystkie zapytania do bazy danych, które mogą mieć problemy N+1"Przykłady zaawansowanego wyszukiwania:
# Złożone dopasowywanie wzorców"Znajdź wszystkie komponenty React, które bezpośrednio dostają się do localStorage"
# Walidacja architektury"Sprawdź czy jakiekolwiek komponenty frontendu importują z modułów backendu"
# Audyt bezpieczeństwa"Zlokalizuj wszystkie miejsca gdzie konstruujemy zapytania SQL"
# Analiza wydajności"Znajdź wszystkie synchroniczne operacje plikowe w naszych async handlerach"Strukturyzuj duże projekty refaktoryzacji efektywnie:
Początkowa analiza
"Przeanalizuj aktualny system uwierzytelniania i zidentyfikuj obszary do ulepszenia"Stwórz plan
"Stwórz plan krok po kroku migracji z uwierzytelniania opartego na sesji na JWT"Implementuj inkrementalnie
"Krok 1: Stwórz nowe funkcje narzędziowe JWT""Krok 2: Zaktualizuj model użytkownika o obsługę refresh tokenów""Krok 3: Zmodyfikuj endpoint logowania"Weryfikuj każdy krok
"Napisz testy dla narzędzi JWT""Zweryfikuj kompatybilność wsteczną"Strategia rozbijania zadań
Optymalizuj wydajność Claude’a z ukierunkowanym kontekstem:
# Mniej efektywne: Niejasna prośba"Optymalizuj naszą aplikację"
# Bardziej efektywne: Skupiona prośba"Optymalizuj zapytania do bazy danych w klasie UserRepository"
# Jeszcze lepiej: Konkretny kontekst"Metoda getUsersWithOrders w UserRepository ma problemy zapytań N+1. Zoptymalizuj ją używając eager loading."Strategie kontekstu dla dużych baz kodu:
Uruchom równoległe instancje Claude Code dla maksymalnej efektywności:
# Terminal 1: Rozwój frontenduclaude --add-dir ./frontend"Zaimplementuj nowy dashboard użytkownika"
# Terminal 2: API backenduclaude --add-dir ./backend"Stwórz endpointy REST dla danych dashboardu"
# Terminal 3: Migracje bazy danychclaude --add-dir ./database"Zaprojektuj schemat dla funkcji dashboardu"
# Terminal 4: Testowanieclaude --add-dir ./tests"Napisz testy integracyjne dla nowych funkcji"Korzyści z równoległych instancji:
Używaj systemu plików do współpracy między instancjami:
# Instancja 1: Generuj typy"Wygeneruj interfejsy TypeScript z naszych odpowiedzi API"# Instancja 2: Używaj wygenerowanych typów"Stwórz hooki React używając typów w shared/types/"
# Instancja 3: Dokumentacja"Udokumentuj typy w shared/types/ z przykładami"Wzorce współdzielonego workspace
project/├── .claude/│ ├── generated/ # Kod wygenerowany przez AI│ ├── templates/ # Implementacje referencyjne│ └── workspace/ # Współdzielone pliki robocze├── docs/│ └── ai-sessions/ # Dokumentacja sesjiPrzepływ pracy z życia codziennego:
# Pobierz implementację referencyjną"Skopiuj logikę uwierzytelniania z tego popularnego pakietu npm do .claude/templates/ żebyśmy mogli referencjonować ich wzorce"
# Użyj jako referencji"Zaimplementuj podobne uwierzytelnianie ale dostosowane do naszych wzorców"Strukturyzuj dokumentację dla dużych monorepo:
monorepo/├── CLAUDE.md # Globalne reguły i wzorce├── packages/│ ├── frontend/│ │ ├── CLAUDE.md # Specyficzne dla frontendu│ │ └── src/│ │ └── components/│ │ └── CLAUDE.md # Wytyczne komponentów│ ├── backend/│ │ ├── CLAUDE.md # Wzorce backendowe│ │ └── src/│ │ ├── services/│ │ │ └── CLAUDE.md # Wzorce serwisów│ │ └── models/│ │ └── CLAUDE.md # Reguły modeli danych│ └── shared/│ └── CLAUDE.md # Reguły współdzielonego koduPrzykład hierarchicznej dokumentacji:
# Przegląd monorepo
## Zasady architektury- Mikrousługi z współdzielonymi bibliotekami- Komunikacja sterowana zdarzeniami- TypeScript w całości
## Globalne standardy- Conventional commits- 100% pokrycie testami dla współdzielonego kodu- Brak zależności cyklicznych# Serwis użytkowników
## Odpowiedzialności- Uwierzytelnianie użytkowników- Zarządzanie profilami- Obsługa uprawnień
## Zależności- Biblioteka współdzielonego auth- Serwis bazy danych- Magistrala zdarzeń
## Wzorce- Wzorzec Repository dla dostępu do danych- JWT do uwierzytelniania- Event sourcing do audytuPomóż Claude zrozumieć projekt twojego systemu:
# Dokumentacja architektury
## Przegląd systemu```mermaidgraph TD A[API Gateway] --> B[User Service] A --> C[Product Service] A --> D[Order Service] B --> E[PostgreSQL] C --> F[MongoDB] D --> E D --> G[Redis Cache] B --> H[Event Bus] C --> H D --> H### Wskazówka 45: Używaj zapytań świadomych kontekstu
Zadawaj zaawansowane pytania o relacje w kodzie:
```bash# Analiza zależności"Pokaż mi wszystkie serwisy zależne od modelu User""Co by się zepsuło, gdybym zmienił sygnaturę metody authenticate?""Znajdź zależności cykliczne w naszej strukturze importów"
# Analiza wydajności"Zidentyfikuj wszystkie zapytania do bazy danych w gorących ścieżkach kodu""Znajdź operacje synchroniczne, które mogłyby być async""Pokaż mi wszystkie niebuforowane kosztowne obliczenia"
# Audyt bezpieczeństwa"Znajdź wszystkie wejścia użytkownika, które nie są walidowane""Pokaż mi wszędzie gdzie konstruujemy dynamiczne SQL""Zidentyfikuj eksponowane wrażliwe dane w odpowiedziach API"
# Walidacja architektury"Zweryfikuj czy wszystkie serwisy podążają za naszym wzorcem repository""Znajdź bezpośredni dostęp do bazy danych poza repozytoriami""Sprawdź czy jakikolwiek kod frontendu importuje moduły backendowe"Zarządzaj użyciem tokenów w dużych projektach:
# 1. Często czyść/clear
# 2. Skupiaj rozmowy"Pracuj tylko nad modułem uwierzytelniania"
# 3. Używaj konkretnych referencji plików@auth/login.service.ts# Zamiast: "plik serwisu logowania"
# 4. Kompresuj kontekst/compact
# 5. Usuń niepotrzebne pliki"Ignoruj pliki testowe dla tego zadania"Typowe użycie tokenów według zadań:
- Prosta naprawa błędu: 2K-5K tokenów- Implementacja funkcji: 10K-20K tokenów- Duża refaktoryzacja: 50K-100K tokenów- Analiza architektury: 20K-50K tokenów
Optymalizacja kosztów:- Używaj Sonnet do rutynowych zadań- Zarezerwuj Opus do złożonych prac- Czyść między niepowiązanymi zadaniami- Skupiaj się na konkretnych modułachDokumentuj każdy główny moduł kompleksowo:
# Dokumentacja modułu płatności
## PrzeglądObsługuje całe przetwarzanie płatności włączając karty kredytowe,PayPal i płatności kryptowalutami.
## Kluczowe pliki- `payment.service.ts` - Główny orchestrator serwisu- `processors/` - Implementacje procesorów płatności- `models/transaction.model.ts` - Model danych transakcji- `webhooks/` - Webhooki dostawców płatności
## Krytyczna logika biznesowa1. **Logika ponownych prób**: 3 próby z wykładniczym backoff2. **Idempotentność**: Używaj transaction_id aby zapobiec duplikatom3. **Ścieżka audytu**: Każda operacja logowana do tabeli audit_log4. **Zwroty**: Max 90 dni, wymaga zatwierdzenia managera
## Punkty integracji- User Service: Do danych klientów- Order Service: Do realizacji zamówień- Notification Service: Do paragonów płatności- Audit Service: Do logowania compliance
## Wymagania testowe- Testy jednostkowe: Mockuj wszystkich zewnętrznych dostawców- Testy integracyjne: Używaj środowisk sandbox- Testy obciążeniowe: Minimum 1000 TPS- Testy bezpieczeństwa: Wymagana zgodność PCI
## Częste problemy1. Timeout webhooków - implementuj przetwarzanie async2. Konwersja walut - buforuj kursy na 1 godzinę3. Nieudane płatności - jasna komunikacja z użytkownikiem4. Częściowe zwroty - złożone zarządzanie stanemPodchodź do dużej refaktoryzacji systematycznie:
Przeanalizuj aktualny stan
"Przeanalizuj system uwierzytelniania i stwórz plan refaktoryzacji"Stwórz sieć bezpieczeństwa
"Napisz kompleksowe testy dla aktualnego zachowania uwierzytelniania"Refaktoryzuj małymi krokami
"Krok 1: Wyodrębnij logikę uwierzytelniania do oddzielnego serwisu""Krok 2: Stwórz interfejsy dla dostawców uwierzytelniania""Krok 3: Zaimplementuj dostawcę JWT""Krok 4: Dodaj dostawców OAuth"Utrzymuj kompatybilność wsteczną
"Stwórz warstwę adaptera dla starego API uwierzytelniania"Strategia migracji
"Stwórz plan migracji dla istniejących sesji"Reguły refaktoryzacji inkrementalnej
Używaj Claude do znajdowania wzorców i niespójności:
# Znajdź niespójne wzorce"Znajdź wszystkie różne wzorce obsługi błędów w naszej bazie kodu""Pokaż mi wszystkie różne sposoby walidacji adresów email""Zidentyfikuj niespójne konwencje nazewnictwa"
# Zlokalizuj zduplikowany kod"Znajdź podobne wzorce kodu, które mogłyby być zrefaktoryzowane""Pokaż mi zduplikowaną logikę biznesową między serwisami"
# Naruszenia architektury"Znajdź wszystkie miejsca gdzie warstwa prezentacji bezpośrednio dostaje się do bazy danych""Pokaż mi serwisy wywołujące inne serwisy synchronicznie"
# Wzorce wydajności"Znajdź wszystkie wzorce zapytań N+1""Zlokalizuj wszystkie synchroniczne I/O w obsłudze żądań""Pokaż mi wszystkie niebuforowane zapytania do bazy danych"Przykład z życia:
# Użycie zespołu bezpieczeństwa Anthropic"Znajdź wszystkie różne sposoby konstruowania zapytań SQL i zidentyfikuj które mogą być podatne na injection"
# Claude identyfikuje:# - 15 różnych wzorców zapytań# - 3 potencjalnie podatne konstrukcje# - Sugeruje refaktoryzację do zapytań sparametryzowanychOpracuj systematyczne podejścia do zrozumienia dużych baz kodu:
# 1. Zrozumienie wysokiego poziomu"Co robi ten projekt? Wyjaśnij główny cel i architekturę"
# 2. Zidentyfikuj punkty wejścia"Pokaż mi główne punkty wejścia dla tej aplikacji"
# 3. Śledź krytyczne ścieżki"Prześledź przepływ żądania logowania użytkownika"
# 4. Zrozum model danych"Wyjaśnij główne modele danych i ich relacje"
# 5. Zidentyfikuj kluczowe wzorce"Jakie wzorce projektowe są używane w tej bazie kodu?"# 1. Zlokalizuj kod funkcji"Gdzie jest zaimplementowane przetwarzanie płatności?"
# 2. Zrozum zależności"Od czego zależy system płatności?"
# 3. Znajdź powiązane testy"Pokaż mi wszystkie testy dla przetwarzania płatności"
# 4. Sprawdź dokumentację"Czy jest dokumentacja dla systemu płatności?"
# 5. Zidentyfikuj przypadki graniczne"Jakie przypadki graniczne obsługuje system płatności?"# 1. Odtwórz zrozumienie"Wyjaśnij jak działa przepływ uwierzytelniania użytkownika"
# 2. Zlokalizuj obszar problemu"Gdzie może wystąpić błąd logowania?"
# 3. Sprawdź ostatnie zmiany"Co zmieniło się ostatnio w uwierzytelnianiu?"
# 4. Znajdź podobne problemy"Czy są podobne wzorce, które mogą mieć ten sam błąd?"
# 5. Zaproponuj poprawki"Zasugeruj poprawki dla problemu z timeout uwierzytelniania"Lista kontrolna dużych baz kodu
/costKluczowe zasady sukcesu:
Po opanowaniu strategii dla dużych baz kodu, jesteś gotowy zoptymalizować swój ogólny przepływ pracy rozwoju. Przejdź do Optymalizacja przepływu pracy, aby przekształcić sposób podejścia do rozwoju oprogramowania z asystą AI.