Claude Code to terminalowy agent kodujący AI od Anthropic. Wpisujesz po prostu po angielsku, co chcesz, a on czyta twój kod źródłowy, pisze kod, uruchamia polecenia, naprawia błędy i commituje zmiany — wszystko z twojego terminala. Bez wtyczek IDE. Bez kart przeglądarki. Tylko ty i AI w oknie terminala.
W odróżnieniu od Cursor (który działa wewnątrz IDE) lub Codex (który działa w chmurze), Claude Code uruchamia się lokalnie w twoim rzeczywistym środowisku deweloperskim. Widzi twoje pliki, historię git i wyjście terminala. To czyni go szybszym w wielu przepływach pracy, ponieważ nie ma przełączania kontekstu między AI a twoim kodem.
Ten przewodnik omawia instalację, twój pierwszy projekt, kluczowe polecenia oraz przepływ pracy, który sprawia, że Claude Code działa idealnie.
| Narzędzie | Najlepsze dla | Gdzie działa | Przepływ pracy |
|---|---|---|---|
| Claude Code | Interaktywne agentyczne kodowanie | Lokalny terminal | Ty prowadzisz + ono wykonuje kroki na żywo |
| Cursor | Codzienne kodowanie + edycje inline | Wewnątrz IDE | Widoczne diffy + autouzupełnianie |
| Codex | Asynchroniczne delegowane zadania | Piaskownica w chmurze | Wyślij zadanie → przejrzyj PR później |
Jak zainstalować Claude Code
Musisz mieć Node.js 18+ i konto Claude (Pro lub API).
Krok 1: Zainstaluj globalnie za pomocą npm:
npm install -g @anthropic-ai/claude-code
Krok 2: Przejdź do katalogu swojego projektu:
cd your-project
Krok 3: Uruchom Claude Code:
claude
Pierwszy raz, gdy go uruchomisz, poprosi o uwierzytelnienie kontem Anthropic. Jeśli używasz Claude Pro (20 USD/miesiąc), otrzymujesz hojny limit tokenów. Jeśli korzystasz z API, płacisz za token (sprawdź aktualne stawki w naszym przewodniku po limitach stawek).
Szacowanie kosztów (żebyś nie był zaskoczony)
Jeśli używasz rozliczeń API, typowa sesja 30–60 minut na średnim repozytorium to często 2–10 USD w zależności od modelu i liczby iteracji. Używaj regularnie /cost i sprawdzaj długie sesje za pomocą Vibe Coding Cost Calculator.
Pierwsze 5 minut z Claude Code
Gdy Claude Code działa, jesteś w sesji interaktywnej. AI ma dostęp do całego katalogu projektu. Zacznij prosto:
Poproś o eksplorację: Wpisz „Co to za projekt? Daj mi ogólny przegląd.” Claude czyta kluczowe pliki (package.json, README, główne punkty wejścia) i podsumowuje, co znalazł. To dobry sposób, by sprawdzić, czy rozumie strukturę projektu.
Poproś o znalezienie czegoś: „Gdzie jest logika autentykacji?” Claude przeszukuje kod źródłowy i wskazuje odpowiednie pliki. Rozumie strukturę kodu, nie tylko dopasowanie tekstu.
Poproś o zmianę czegoś: „Dodaj walidację wejścia do formularza rejestracji. E-mail musi być w poprawnym formacie, hasło minimum 8 znaków.” Claude identyfikuje komponent formularza, pisze logikę walidacji i pokazuje diff przed zastosowaniem.
Kluczowe spostrzeżenie: Claude Code działa na twoich rzeczywistych plikach. Gdy wprowadza zmianę, zmiana jest realna — pliki są modyfikowane na dysku. Możesz zobaczyć zmiany w edytorze, uruchomić testy i commitować normalnie.
Niezbędne polecenia
Claude Code ma kilka poleceń slash, które kontrolują jego zachowanie:
| Polecenie | Co robi | Kiedy używać |
|---|---|---|
/init | Tworzy plik CLAUDE.md w głównym katalogu projektu | Przed pierwszą poważną pracą w repozytorium |
/compact | Skompresuj historię rozmowy blisko limitów kontekstu | Długie sesje; przed spadkiem jakości |
/cost | Pokazuje zużyte tokeny + szacowany koszt | Rozliczenia API, śledzenie budżetu |
/clear | Resetuje rozmowę, zachowując kontekst | Przełączanie między niezwiązanymi zadaniami |
Korzystasz z tego? Publikujemy cotygodniowe poradniki o narzędziach i workflowach do kodowania AI. Odbieraj je w skrzynce →
Plik CLAUDE.md — Kontekst AI twojego projektu
Plik CLAUDE.md to najważniejsza rzecz w przepływie pracy Claude Code. To plik markdown w głównym katalogu projektu, który Claude czyta na początku każdej sesji. Pomyśl o nim jak o niestandardowych instrukcjach dla twojego kodu źródłowego.
Dobry CLAUDE.md zawiera:
Przegląd projektu: Co robi projekt, stos technologiczny i architektura w 3-5 zdaniach.
Konwencje kodowania: Twoje preferencje formatowania, konwencje nazewnictwa i wzorce do naśladowania. „Używaj komponentów funkcyjnych z hookami. Preferuj eksport nazwany. Używaj Tailwind do stylizacji.”
Kluczowe pliki: Wskaż Claude najważniejsze pliki, które powinien zrozumieć. „Główne modele danych są w lib/models/. Trasy API są w app/api/.”
Rzeczy do uniknięcia: „Nie modyfikuj plików migracji bazy danych. Nie zmieniaj niczego w vendor/. Zawsze uruchamiaj testy po modyfikacji plików api/.”
Bez CLAUDE.md Claude Code produkuje generyczny kod, który może nie pasować do stylu projektu. Z nim wyniki wyglądają jak kod napisany przez kogoś, kto jest w zespole od miesięcy. To inżynieria kontekstu w praktyce.
Rzeczywisty przepływ pracy: Budowanie funkcji
Oto jak używam Claude Code w typowej sesji rozwijania funkcji:
1. Zacznij od celu: „Dodaj limiter zapytań do API. Użyj Redis. Zastosuj do endpointu /api/submit z limitem 10 zapytań na minutę na IP.”
2. Pozwól Claude zaplanować: Czyta istniejący kod API, sprawdza, czy Redis jest skonfigurowany, i proponuje podejście. Przejrzyj plan, zanim zacznie kodować.
3. Obserwuj pracę: Claude tworzy moduł limitera zapytań, integruje go z trasą API, dodaje zmienne środowiskowe dla połączenia Redis i pisze test.
4. Testuj: Claude uruchamia testy. Jeśli coś zawiedzie, czyta błąd, dostosowuje kod i próbuje ponownie. Ta pętla iteracyjna to miejsce, gdzie agenci błyszczą — radzi sobie z cyklem debugowania, który normalnie wymaga wielu rund ręcznej pracy.
5. Przejrzyj i commituj: Sprawdź diff. Wprowadź poprawki. Commituj. Claude może też napisać wiadomość commitu, jeśli poprosisz.
Dla takiej funkcji Claude Code zazwyczaj oszczędza 60-70% czasu w porównaniu do pisania ręcznie. Prawdziwe oszczędności są w boilerplate, kodzie integracyjnym i pisaniu testów — częściach, które są nużące, ale nie wymagają intelektualnego wyzwania.
Zarządzanie zużyciem tokenów
Claude Code zużywa tokeny przy każdej interakcji. Długie sesje na dużych bazach kodu mogą być drogie przy rozliczeniach API. Oto nawyki, które utrzymują koszty na rozsądnym poziomie:
Używaj /compact regularnie. Nie czekaj, aż kontekst się zapełni. Kompaktuj po ukończeniu każdego odrębnego zadania.
Bądź konkretny. „Napraw błąd w formularzu logowania” jest tańsze niż „Spójrz na całą aplikację i znajdź błędy.” Konkretne prośby oznaczają mniej czytania kodu.
Używaj /clear między niezwiązanymi zadaniami. Jeśli pracowałeś nad frontendem i przechodzisz do migracji bazy danych, wyczyść kontekst. Stary kontekst marnuje tokeny i może zmylić model.
Sprawdzaj /cost często. Ustal mentalny budżet na sesję i sprawdzaj go. Typowa 30-minutowa sesja z funkcją kosztuje 2-8 USD przy rozliczeniach API.
Dla szczegółowego porównania kosztów między Claude Code a Cursor zobacz nasze rzeczywiste porównanie kosztów po 30 dniach.
Claude Code vs Cursor vs Codex
Szybki przewodnik decyzyjny:
| Opcja | Najlepsza, gdy... | Kompromis |
|---|---|---|
| Claude Code | Chcesz interaktywne zmiany w całym repozytorium lokalnie | Wymaga ostrożnego przeglądu (edytuje prawdziwe pliki) |
| Cursor | Chcesz AI w swoim IDE + ścisłą pętlę edycji | Mniej autonomii bezobsługowej niż agenci terminalowi |
| Codex | Chcesz asynchroniczne delegowanie oparte na PR | Mniej interaktywny; kontekst może się rozmyć |
Claude Code: Najlepsze dla programistów, którzy chcą kontekstu całego projektu i workflow natywnych dla terminala. Interaktywne, w czasie rzeczywistym, działa na twoich rzeczywistych plikach. Najlepsze dla złożonych funkcji, refaktoryzacji i debugowania.
Cursor: Najlepsze dla programistów, którzy chcą AI w swoim IDE. Widzisz zmiany w czasie rzeczywistym z inline diffami. Najlepsze do codziennego kodowania z sugestiami AI. Pełne porównanie tutaj.
Codex: Najlepsze dla zespołów, które chcą asynchronicznych, partiami zadań kodowania. Prześlij zadanie, przejrzyj PR później. Najlepsze dla dobrze zdefiniowanych zadań, które chcesz całkowicie zdelegować. Pełne porównanie tutaj.
Wielu programistów używa dwóch lub więcej. Claude Code do złożonych funkcji, Cursor do codziennej edycji, Codex do zadań partiami.
Chcesz poprawić swoje prompty dla dowolnego narzędzia AI do kodowania? The Prompt Optimizer pomaga strukturyzować żądania, aby uzyskać klarowniejszy, bardziej precyzyjny wynik.
Chcesz więcej takich treści? Publikujemy cotygodniowo o narzędziach AI do kodowania i workflow deweloperskich. Zapisz się za darmo →
Często zadawane pytania
Czy Claude Code działa na Windows?
Tak, przez WSL (Windows Subsystem for Linux), PowerShell lub Command Prompt. WSL zapewnia najlepsze doświadczenie, ponieważ wiele narzędzi deweloperskich jest natywnych dla Linuksa.
Czy Claude Code ma dostęp do internetu?
Claude Code sam nie przegląda sieci, ale może uruchamiać polecenia, które to robią — curl, npm install, git clone. Może też używać serwerów MCP do dostępu do zewnętrznych usług jak GitHub, bazy danych i API.
Jak Claude Code radzi sobie z dużymi bazami kodu?
Okno kontekstu 200K tokenów Claude oznacza, że może ładować i przetwarzać tysiące plików źródłowych jednocześnie. W bardzo dużych monorepo czyta selektywnie istotne pliki zamiast wszystkiego. Plik CLAUDE.md pomaga mu wiedzieć, które części kodu są ważne dla każdego zadania.
Czy mój kod jest wysyłany na serwery Anthropic?
Tak, twój kod jest wysyłany do API Anthropic w celu przetworzenia. Anthropic domyślnie nie trenuje na danych wejściowych API, ale sprawdź aktualne warunki, jeśli pracujesz z wrażliwym lub własnościowym kodem. Rozważ użycie API z wyłączonym przechowywaniem danych dla maksymalnej prywatności.
Ujawnienie: Niektóre linki w tym artykule to linki afiliacyjne. Polecamy tylko narzędzia, które osobiście testowaliśmy i regularnie używamy. Zobacz naszą pełną politykę ujawniania.