Claude Code zmienia sposób pisania oprogramowania, zapewniając inteligentnego programistę AI bezpośrednio w terminalu. Ten przewodnik poprowadzi cię od zera do produktywności w 2 godziny, obejmując wszystko od początkowej konfiguracji po budowanie pierwszej funkcji z pomocą AI.
Przed rozpoczęciem upewnij się, że posiadasz:
Po ukończeniu tego przewodnika będziesz w stanie:
Zainstaluj Claude Code globalnie
Zalecana metoda instalacji używa npm:
npm install -g @anthropic-ai/claude-codeUżytkownicy macOS i Linux powinni unikać używania sudo, ponieważ może to prowadzić do problemów z uprawnieniami. Jeśli napotkasz błędy, zobacz sekcję rozwiązywania problemów.
Użytkownicy Windows mają dwie opcje:
Dla natywnego Windows:
$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"Zweryfikuj instalację
Przejdź do katalogu projektu i uruchom Claude Code:
cd twoj-projektclaudePowinieneś zobaczyć wiadomość powitalną Claude Code i interaktywny prompt.
Wybierz metodę uwierzytelniania
Claude Code oferuje trzy opcje uwierzytelniania:
Do użycia API i rozliczeń
To rozwiązanie idealne dla programistów, którzy chcą bezpośredni dostęp do API i rozliczenia oparte na użytkowaniu.
Zjednoczona subskrypcja (zalecana dla osób prywatnych)
Dla zespołów używających dostawców chmury
Zobacz przewodnik wdrażania enterprise dla szczegółowej konfiguracji.
Przetestuj konfigurację
Uruchom prostą komendę, aby zweryfikować, że wszystko działa:
> utwórz plik hello.js który wypisuje "Hello from Claude Code!"Claude powinien utworzyć plik i pokazać ci zmiany.
Teraz skonfigurujmy Claude Code dla optymalnej produktywności.
System uprawnień Claude Code równoważy bezpieczeństwo z efektywnością. Wybierz preferowany tryb:
Claude pyta o pozwolenie na każdą modyfikację pliku i komendę. To najbezpieczniejsza opcja dla początkujących.
# Nie jest potrzebna specjalna konfiguracjaclaudeDla doświadczonych użytkowników, którzy chcą nieprzerwany przepływ pracy:
claude --dangerously-skip-permissionsTen tryb omija wszystkie prośby o pozwolenia. Claude może edytować pliki i uruchamiać komendy bez pytania. Używaj tylko w zaufanych środowiskach lub kontenerach.
Rozwiązanie pośrednie - automatycznie akceptuje edycje plików, ale nadal pyta o komendy:
claude --permission-mode acceptEditsClaude Code używa inteligentnego wyboru modelu domyślnie:
Możesz przesłonić domyślne ustawienie:
# Wymuś konkretny modelclaude --model opusclaude --model sonnet
# Lub skonfiguruj w ustawieniach/configZainstaluj rozszerzenie Claude Code
Rozszerzenie instaluje się automatycznie, gdy uruchomisz claude z zintegrowanego terminala.
Funkcje:
Cmd+Esc (Mac) lub Ctrl+Esc (Windows/Linux)Zainstaluj wtyczkę Claude Code z marketplace:
Do zdalnego rozwoju zainstaluj na zdalnym hoście.
Skonfiguruj terminal dla optymalnego doświadczenia
Uruchom tę komendę, aby skonfigurować odpowiednie przypisania klawiszy:
> /terminal-setupTo włącza:
Shift+Enter dla wprowadzania wieloliniowegoClaude Code używa plików CLAUDE.md do utrzymania kontekstu projektu między sesjami. To kluczowe dla spójnej, wysokiej jakości pomocy.
Wygeneruj początkowy CLAUDE.md
> /initClaude analizuje twój projekt i tworzy dostosowany plik CLAUDE.md zawierający:
Dostosuj do swoich potrzeb
Edytuj wygenerowany CLAUDE.md, aby zawierał:
# Przegląd projektuTo jest aplikacja e-commerce Next.js używająca TypeScript i Tailwind CSS.
# Kluczowe komendy- `npm run dev` - Uruchom serwer deweloperski- `npm run build` - Zbuduj dla produkcji- `npm test` - Uruchom pakiet testów- `npm run lint` - Sprawdź jakość kodu
# Standardy kodowania- Używaj komponentów funkcyjnych z hooks- Implementuj właściwe typy TypeScript (bez `any`)- Podążaj za zasadami Airbnb ESLint- Pisz testy dla wszystkich nowych funkcji
# Notatki architektoniczne- Trasy API w /app/api- Komponenty w /components z rozszerzeniem .tsx- Używaj komponentów serwera domyślnie- Komponenty klienta tylko gdy potrzebneUżyj skrótu # do szybkich aktualizacji
Podczas pracy szybko dodawaj wspomnienia:
> # Zawsze używaj Prisma do zapytań bazy danych, nigdy surowego SQLClaude poprosi cię o wybór pliku pamięci do aktualizacji.
To jest serce efektywnego używania Claude Code - systematyczne podejście do budowania funkcji.
Dlaczego zaczynać od PRD? Jasne wymagania prowadzą do lepszych implementacji. Claude doskonale radzi sobie, gdy otrzymuje konkretny kontekst i cele.
Utwórz PRD funkcji
> Utwórz PRD dla systemu uwierzytelniania użytkowników z logowaniem> email/hasło, rejestracją, resetem hasła i zarządzaniem sesjamiClaude generuje kompleksowy PRD zawierający:
Dopracuj wymagania
Przejrzyj i dostosuj PRD:
> Dodaj obsługę OAuth dla Google i GitHub do PRD uwierzytelniania> Uwzględnij wymagania ograniczania szybkości dla bezpieczeństwaPrzechowaj w pamięci projektu
> Zapisz ten PRD do docs/features/authentication.md> # Ten projekt używa tokenów JWT z 24-godzinnym wygaśnięciemTryby myślenia Claude odblokują potężne planowanie architektoniczne:
Do typowych funkcji:
> Utwórz szczegółowy plan implementacji dla systemu uwierzytelnianiaDo złożonych decyzji architektonicznych:
> Pomyśl głęboko nad najlepszym podejściem do implementacji bezpiecznego> zarządzania sesjami, które skaluje się do 1M użytkownikówTo wywołuje ~5,000 tokenów rozumowania.
Do krytycznego projektowania systemów:
> Ultrathink o migracji naszego monolitycznego uwierzytelniania do> mikrousług przy zachowaniu kompatybilności wstecznejTo może użyć do 128,000 tokenów na rozbudowaną analizę.
Przykład sesji planowania:
> Na podstawie naszego PRD uwierzytelniania, pomyśl głęboko nad> podejściem do implementacji. Rozważ:> - Najlepsze praktyki bezpieczeństwa> - Projekt bazy danych> - Strukturę API> - Strategię testowania> - Potencjalne przypadki brzegoweClaude będzie:
Przekształć plany w wykonalne zadania:
Wygeneruj strukturalne todos
> Przekształć plan uwierzytelniania w szczegółową listę todo> z podzadaniami i zależnościamiClaude tworzy:
## Zadania implementacji uwierzytelniania
### 1. Konfiguracja bazy danych- [ ] Utwórz tabelę users z email, password_hash, created_at- [ ] Dodaj indeksy dla email (unique) i created_at- [ ] Utwórz tabelę sessions z user_id, token, expires_at- [ ] Napisz skrypty migracji
### 2. Endpointy API- [ ] POST /api/auth/register - [ ] Walidacja wejścia - [ ] Hashowanie hasła z bcrypt - [ ] Sprawdzenie unikalności email - [ ] Utwórz rekord użytkownika- [ ] POST /api/auth/login - [ ] Waliduj poświadczenia - [ ] Wygeneruj token JWT - [ ] Ustaw bezpieczne ciasteczko HTTP-only...Wykonuj zadania systematycznie
> Zacznijmy od zadania 1 - utwórz schemat bazy danychClaude:
Śledź postęp
> Oznacz konfigurację bazy danych jako ukończoną i przejdź do endpointów APIKontynuuj przez listę todo, z Claude utrzymującym kontekst i zaznaczającym ukończone elementy.
Serwery MCP (Model Context Protocol) rozszerzają możliwości Claude o zewnętrzne narzędzia.
Rozszerzone operacje na plikach
{ "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."] } }}Włącza zaawansowane wyszukiwanie plików i operacje masowe.
Integracja repozytorium
{ "mcpServers": { "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" } } }}Dostęp do issues, PR-ów i danych repozytorium.
Dokumentacja bibliotek
{ "mcpServers": { "context7": { "command": "npx", "args": ["-y", "@context7/mcp-server"] } }}Otrzymuj aktualną dokumentację dla dowolnej biblioteki.
Utwórz konfigurację MCP
Dodaj do .claude/mcp.json w twoim projekcie:
{ "mcpServers": { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."] }, "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" } } }}Zweryfikuj połączenia MCP
> /mcpTo pokazuje:
Uwierzytelnij jeśli potrzebne
Niektóre serwery wymagają OAuth:
> /mcp# Wybierz "Authenticate" dla serwerów tego wymagającychZbudujmy prawdziwą funkcję używając Claude Code:
Zacznij od wymagań
> Potrzebujemy strony profilu użytkownika, która pokazuje:> - Informacje użytkownika (imię, email, awatar)> - Ustawienia konta> - Ostatnią aktywność> Zaplanuj implementację, ale nie pisz jeszcze koduUtwórz branch funkcji
> Utwórz nowy branch git o nazwie feature/user-profileImplementuj UI
> Utwórz komponent UserProfile używając naszego systemu projektowego> Podążaj za makietą w designs/user-profile.pngClaude:
Dodaj pobieranie danych
> Implementuj trasę API do pobierania danych profilu użytkownika> Uwzględnij właściwą obsługę błędów i stany ładowaniaNapisz testy
> Napisz kompleksowe testy dla komponentu UserProfile> Uwzględnij testy jednostkowe i integracyjneNapraw wszelkie problemy
> Uruchom testy i napraw wszelkie niepowodzeniaClaude iteruje, aż wszystkie testy przejdą.
Commit i push
> Commit wszystkich zmian z opisową wiadomością i pushClaude doskonale radzi sobie z debugowaniem:
> TypeError: Cannot read property 'name' of undefined at UserProfile.tsx:34> Napraw ten błądClaude będzie:
Claude Code zapewnia wyrafinowaną integrację Git:
> Jakie pliki zmieniłem?# Claude uruchamia git status i podsumowuje
> Commit tych zmian z opisową wiadomością# Claude analizuje zmiany i pisze wiadomość commita
> Zmiany auth powinny być osobnym commitem# Claude tworzy wiele logicznych commitów> Utwórz pull request dla tej funkcji# Claude:# - Pushuje obecny branch# - Tworzy PR z kompleksowym opisem# - Linkuje powiązane issues# - Dodaje reviewerów jeśli skonfigurowane> Pomóż mi rozwiązać te konflikty merge# Claude:# - Pokazuje konflikty jasno# - Sugeruje rozwiązania# - Zachowuje zamierzoną funkcjonalność# - Uruchamia testy po rozwiązaniuJeśli masz zainstalowane gh CLI:
> Jakie są otwarte issues oznaczone 'bug'?> Implementuj poprawkę dla issue #234> Utwórz PR, który naprawia #234Utwórz wielokrotnego użytku komendy w .claude/commands/:
Przykład: .claude/commands/test-component.md
Proszę utwórz kompleksowe testy dla: $ARGUMENTS
Wymagania:- Użyj React Testing Library- Testuj wszystkie warianty props- Uwzględnij testy dostępności- Mockuj zewnętrzne zależności- Osiągnij >90% pokryciaUżycie:
> /test-component UserProfileSkonfiguruj w .claude/settings.json:
{ "hooks": [ { "matcher": "Edit", "hooks": [ { "type": "command", "command": "prettier --write \"$CLAUDE_FILE_PATHS\"" } ] } ]}To automatycznie formatuje pliki po edycji przez Claude.
Pracuj nad wieloma funkcjami jednocześnie:
# Terminal 1git worktree add ../feature-auth auth-featurecd ../feature-authclaude
# Terminal 2git worktree add ../feature-profile profile-featurecd ../feature-profileclaudeKażda instancja Claude pracuje niezależnie bez konfliktów.
> Napraw błąd> Zrób to lepiej> Dodaj trochę testów> Napraw błąd uwierzytelniania, gdzie użytkownicy nie mogą się zalogować ze> znakami specjalnymi w hasłach
> Popraw wydajność komponentu UserList implementując> wirtualne przewijanie dla list ponad 100 elementów
> Dodaj testy jednostkowe dla funkcji calculateTax pokrywając wszystkie> progi podatkowe i przypadki brzegoweWyczyść między niepowiązanymi zadaniami
> /clearUżywaj skoncentrowanych zapytań
# Zamiast: "przeanalizuj całą bazę kodu"> Przeanalizuj moduł uwierzytelniania w src/auth/Odwołuj się do konkretnych plików
> Wyjaśnij jak działa @src/utils/validation.ts| Zadanie | Komenda |
|---|---|
| Rozpocznij nową funkcję | > Utwórz plan dla [opis funkcji] |
| Napraw błąd | > [wklej błąd] Napraw ten błąd |
| Napisz testy | > Napisz testy dla @src/components/Button.tsx |
| Refaktoryzuj kod | > Refaktoryzuj moduł auth, aby używał hooks |
| Aktualizuj dokumentację | > Aktualizuj README o nowe zmiany API |
| Przegląd kodu | > Przejrzyj moje zmiany i zasugeruj ulepszenia |
| Operacje Git | > Utwórz PR dla tej funkcji |
Jeśli widzisz błędy uprawnień npm:
claude migrate-installerTo przenosi Claude Code do ~/.claude/local/
Debuguj problemy MCP:
claude --mcp-debugSprawdź logi serwera i konfigurację.
Dla plików ponad 10k linii, skup się na konkretnych sekcjach:
> Przeanalizuj logikę uwierzytelniania w @large-file.js#L1000-L1500Teraz, gdy opanowałeś podstawy:
Pamiętaj: Claude Code to twój programista AI w parze. Im więcej kontekstu i jasności zapewnisz, tym lepiej może ci asystować. Zacznij od prostych zadań i stopniowo podejmuj bardziej złożone wyzwania, budując pewność siebie.
Wskazówka pro: Kontynuuj iterację nad swoim plikiem CLAUDE.md. Im lepiej udokumentujesz wzorce i preferencje swojego projektu, tym bardziej spójny i pomocny staje się Claude.