Przejdź do treści

Jak zacząć z Claude Code i do czego go używać w projekcie

Maciej Sala

Founder StriveLab

12 min czytaniaAktualizacja

Szybka odpowiedź: jak zacząć z Claude Code?

  • Zainstaluj Claude Code jednym poleceniem w terminalu i użyj obsługiwanego płatnego planu, dostępu organizacyjnego lub API.
  • Uruchom claude w katalogu projektu i poleceniem /init wygeneruj plik CLAUDE.md z opisem repozytorium.
  • Zacznij od trybu planowania, w którym agent czyta kod i proponuje zmiany, zanim cokolwiek edytuje.
  • Zapisz punkt wyjścia w Git, żeby przejrzeć i w razie potrzeby cofnąć zmiany w śledzonych plikach.
  • Darmowy plan Claude nie obejmuje Claude Code. Możesz użyć płatnego planu albo dostępu API rozliczanego osobno.

Claude Code: co to jest i czym różni się od czatu z AI

Claude Code to bardzo popularny agent kodujący od Anthropic, który wysunął się na prowadzenie wśród narzędzi AI do programowania, przynajmniej według badania opisanego niżej. Narzędzie działa bezpośrednio w Twoim projekcie, inaczej niż czat, do którego wklejasz fragmenty kodu – przeszukuje repozytorium, czyta pliki, wprowadza zmiany, uruchamia testy i polecenia w terminalu, a potem sprawdza wynik i poprawia to, co nie działa. Czym agent AI różni się od asystenta i zwykłej automatyzacji, opisałem w tekście o tym, czym jest agent AI.

Claude Code działa w kilku miejscach. Najbardziej znany jest terminal, ale ten sam agent pracuje w rozszerzeniach do VS Code i JetBrains, w aplikacji desktopowej i w przeglądarce na claude.ai/code, gdzie sesja działa w chmurze na kopii repozytorium z GitHuba. Osobiście preferuję pracę w VS Code oraz w chmurze na kopii repozytorium, szczególnie że pracę w chmurze mogę wykonywać przy pomocy smartfona, np. w pociągu czy autobusie. Trzeba tylko pamiętać, że wersjonowany CLAUDE.md pomaga przenosić instrukcje między środowiskami, ale lokalne ustawienia, sekrety, zależności i uprawnienia nie przenoszą się automatycznie do sesji w chmurze.

Popularność Claude Code na tle innych asystentów AI

W badaniu First Page Sage z listopada 2026 roku Claude Code jest najczęściej wybieranym głównym narzędziem AI do programowania. Spośród 2514 zawodowych programistów z Ameryki Północnej i Europy 30,1% wskazało go jako asystenta, z którego najczęściej korzystają przy kodzie produkcyjnym. W trzecim kwartale 2025 roku ten udział wynosił 7,9%, a w połowie 2026 roku Claude Code wyprzedził GitHub Copilota, który wcześniej prowadził w zestawieniu.

NarzędzieProducentRodzajUdział (październik 2026)Zmiana od stycznia 2026
Claude CodeAnthropicagent w terminalu30,1%+11,6 pkt proc.
GitHub CopilotMicrosoft/GitHubrozszerzenie do IDE22,2%−8,3 pkt proc.
CursorAnysphereedytor oparty na AI12,8%−5,2 pkt proc.
CodexOpenAIagent w terminalu i chmurze12,1%+7,9 pkt proc.
Antigravity i Gemini Code AssistGoogleedytor oparty na AI5,7%+1,2 pkt proc.

Badanie mierzy wybór głównego narzędzia, a nie samo korzystanie, a wielu programistów używa równolegle dwóch lub nawet trzech asystentów. Dane pokazują też szerszą zmianę nawyków, ponieważ agenty uruchamiane w terminalu w ciągu dziesięciu miesięcy zwiększyły udział z 21,3% do 38,8%, głównie kosztem rozszerzeń do IDE.

Jak zainstalować Claude Code na macOS, Linuxie i Windowsie

Na macOS i Linuxie instalujesz Claude Code jednym poleceniem.

Terminal (macOS, Linux)
Code
curl -fsSL https://claude.ai/install.sh | bash

Na Windowsie komendę instalacyjną wywołujesz w PowerShellu. Warto zainstalować Git for Windows dla dostępu do powłoki Bash, ale bez niego aktualny Claude Code również obsłuży operacje bezpośrednio przez PowerShell. Alternatywnie możesz użyć podsystemu WSL i wdrożyć tam natywny instalator dla Linuksa.

PowerShell (Windows)
Code
irm https://claude.ai/install.ps1 | iex

Natywny instalator nie wymaga instalowania Node.js tylko na potrzeby Claude Code; sam projekt nadal może go potrzebować. Sprawdź instalację poleceniem claude --version, a przy problemach uruchom claude doctor. Instalacja natywna aktualizuje się automatycznie, o ile nie zmienisz tego w ustawieniach.

Po instalacji przejdź do katalogu projektu i uruchom agenta.

Terminal
Code
cd moj-projekt
claude

Przy pierwszym uruchomieniu Claude Code poprosi o zalogowanie. Możesz użyć konta Claude z planem Pro, Max, Ultra, Team lub Enterprise albo klucza API z Claude Console, rozliczanego za zużycie. W organizacji dostęp może wymagać przydzielenia go przez administratora. Plan decyduje o limitach i modelach, a przy API koszt zależy m.in. od modelu, tokenów wejściowych, wyjściowych i cache.

Jeśli masz ustawioną zmienną ANTHROPIC_API_KEY, sprawdź, czy sesja korzysta z API, czy z abonamentu. W sesji interaktywnej zaakceptowanie użycia klucza może skierować rozliczenie do API zamiast limitu planu. W trybie nieinteraktywnym claude -p ustawiony ANTHROPIC_API_KEY jest używany bez tego pytania, zgodnie z kolejnością wyboru danych uwierzytelniających. Sprawdź więc konfigurację środowiska CI przed uruchomieniem zadania. Klucza nie zapisuj w repozytorium ani w CLAUDE.md. Stan konta sprawdzisz przez /status, a zużycie przez /usage.

Claude Code w Visual Studio Code: rozszerzenie i praca w edytorze

Jeśli na co dzień pracujesz w Visual Studio Code, nie musisz przełączać się między edytorem a osobnym oknem terminala. Anthropic udostępnia rozszerzenie Claude Code (identyfikator anthropic.claude-code), które znajdziesz w widoku rozszerzeń po wpisaniu nazwy albo zainstalujesz jednym poleceniem. Wymaga VS Code w wersji 1.94 lub nowszej i działa też w Cursorze. Logujesz się tym samym kontem co w terminalu, czyli płatnym planem Claude albo kontem Claude Console.

Terminal
Code
code --install-extension anthropic.claude-code

Panel otworzysz ikoną iskry w prawym górnym rogu edytora (pojawia się, gdy masz otwarty plik), pozycją Claude Code na pasku stanu albo skrótem Cmd+Esc na macOS lub Ctrl+Esc na Windowsie i Linuxie, który przełącza fokus między kodem a rozmową. Rozmowę możesz też otworzyć w osobnej karcie edytora i prowadzić kilka wątków równolegle.

Największa różnica w porównaniu z terminalem dotyczy przeglądania zmian i właśnie dlatego wolę taki sposób pracy. W trybie ręcznym rozszerzenie pokazuje proponowaną edycję jako diff obok siebie, a Ty akceptujesz albo odrzucasz zmianę, zanim agent pójdzie dalej. Zaznaczony fragment kodu trafia do rozmowy automatycznie, znakiem @ wskazujesz konkretne pliki lub katalogi, a skrót Option+K (Alt+K) wstawia odwołanie do zaznaczonych linii. Plan przygotowany w trybie planowania otwiera się jako dokument Markdown, w którym przed akceptacją dopiszesz własne komentarze. Gdy agent pójdzie w złą stronę, przycisk przy wiadomości pozwala cofnąć do wybranego punktu rozmowę, kod albo jedno i drugie.

Rozszerzenie korzysta z tych samych ustawień co wersja terminalowa, w tym z reguł uprawnień, hooków i serwerów MCP zapisanych w ~/.claude/settings.json. Ma jednak wbudowany własny Claude Code i nie dodaje polecenia claude do systemowej ścieżki. Jeśli chcesz uruchamiać agenta także w zintegrowanym terminalu VS Code, zainstaluj go osobno, tak jak w poprzedniej sekcji. Panel obsługuje też tylko część poleceń dostępnych w terminalu, więc przy bardziej zaawansowanych przepływach terminal nadal bywa wygodniejszy.

Pierwsza sesja w repozytorium i plik CLAUDE.md

Najpierw sprawdź git status i zapisz własną pracę w commicie lub osobnej kopii. Dla zadania możesz utworzyć osobną gałąź. Następnie użyj /init, a Claude Code przejrzy repozytorium i wygeneruje plik CLAUDE.md z opisem projektu, czyli stosem technologicznym, poleceniami do budowania i testowania, strukturą katalogów i konwencjami. W sytuacji, kiedy plik już istnieje, /init proponuje jego ulepszenia. Warto pamiętać, że główny plik instrukcji agent wczytuje na początku sesji, więc nie musisz za każdym razem tłumaczyć, jak uruchomić testy.

Wygenerowany plik przejrzyj i uzupełnij o rzeczy, których agent nie wyczyta z kodu, takie jak zasady pisania commitów, polecenia walidujące, miejsca, których nie wolno zmieniać, czy odnośniki do dokumentacji zespołu. Najbardziej przydają się krótkie, konkretne instrukcje, które możesz sprawdzić. Pamiętaj o właściwej higienie pliku i o tym, by usuwać nieaktualne polecenia i sprzeczne reguły – to bardzo ważne i najlepiej robić to przynajmniej raz na kilka tygodni albo według potrzeby. Pamiętaj tylko, że to kontekst, a blokady i ograniczenia działań musisz ustawiać w uprawnieniach, hookach i środowisku wykonania. Nie polegaj wyłącznie na instrukcji tekstowej, bo model działa probabilistycznie i zawsze jest szansa, że może się pomylić.

Jeśli to Twoje pierwsze zadanie, wybierz małe i sprawdzalne, przykładowo „wyjaśnij, jak działa routing w tym projekcie”, „znajdź, gdzie generujemy mapę witryny” albo „dodaj test dla tej funkcji i uruchom go”. Zobaczysz, jak agent szuka w kodzie, o co pyta i jak raportuje wynik, zanim powierzysz mu coś większego. Kiedy wystarczy prosty prompt, a kiedy zadanie naprawdę wymaga agenta, opisałem w matrycy decyzyjnej AI.

Przy pierwszej zmianie określ zakres i kryterium ukończenia, na przykład:

Przykład zadania
Code
Znajdź walidację formularza kontaktowego. Najpierw opisz, co dzieje się,
gdy pole e-mail jest puste. Po uzgodnieniu planu popraw walidację bez zmiany
wyglądu formularza i dodaj test tego przypadku. Uruchom testy związane
ze zmianą. Na końcu pokaż zmienione pliki, wyniki kontroli i to,
czego nie udało się sprawdzić. Nie publikuj zmian.

Po zakończeniu sesji przeanalizuj stan repozytorium przez git status i git diff, nie pomijając nowo utworzonych plików. Zweryfikuj historię wykonanych przez agenta poleceń, zamiast polegać wyłącznie na komunikacie o ukończeniu zadania. Commita zrób dopiero po pełnej weryfikacji rezultatów. Miej na uwadze, że system wersjonowania kodu chroni pliki, ale nie zadziała jak backup bazy danych, nie cofnie wywołań API ani nie odwoła opublikowanego wdrożenia.

Tryby pracy i uprawnienia w Claude Code, w tym tryb planowania

W trybie domyślnym Claude Code prosi o potwierdzenie każdej operacji, która wymaga zgody według aktualnie obowiązujących reguł. Przeglądanie plików oraz wybrane komendy działające wyłącznie w trybie odczytu wykonują się automatycznie, natomiast jednorazowe zatwierdzenie danej akcji nie zapisuje jej na stałe w wyjątkach. W trakcie trwającej sesji możesz swobodnie przełączać się między dostępnymi trybami za pomocą skrótu Shift+Tab.

TrybCo robi agentKiedy go używać
Domyślny (Manual)pyta o zgodę przy edycjach i nowych poleceniachna początku pracy z nowym projektem
Akceptacja edycjiedytuje pliki i wykonuje proste operacje na plikach w katalogu projektu bez pytania, o pozostałe polecenia pytagdy ufasz kierunkowi zmian i przeglądasz diff
Planowanieanalizuje kod i przygotowuje plan bez edycji plików źródłowychprzed każdym większym zadaniem
Automatycznyklasyfikator ocenia działania przed wykonaniem, ograniczając rutynowe pytania; może też blokować operacjegdy jest dostępny w Twoim planie i znasz już rytm pracy agenta

Tryb planowania warto włączyć zwłaszcza na samym początku pracy nad zadaniem. Agent analizuje wtedy kod i przedstawia propozycję wdrożenia, a Ty decydujesz, czy zaakceptować ten kierunek, czy może dokonać w nim korekt. Na tym etapie modyfikacja założeń jest najprostsza, ponieważ sam tryb planowania nie służy do edycji plików źródłowych. Pamiętaj jednak, że analiza kodu również zużywa tokeny i podlega standardowym regułom dostępu, które zweryfikujesz komendą /permissions.

Polecenia, które uruchamiasz regularnie, na przykład testy czy linter, możesz odblokować na stałe w ustawieniach projektu (.claude/settings.json), żeby agent nie pytał o nie za każdym razem. Wspólne reguły trzymaj w .claude/settings.json, a lokalne wyjątki w .claude/settings.local.json. Dopuszczaj konkretne polecenia zamiast całej powłoki; testy i skrypty projektu również mogą mieć skutki uboczne. Nie utożsamiaj braku pytań z pomijaniem zabezpieczeń: w auto działania ocenia klasyfikator, a dontAsk zasadniczo odrzuca operacje, które wymagałyby potwierdzenia, pozostawiając wcześniej dozwolone działania. Tryb bypassPermissions, który pomija pytania o uprawnienia, zostaw dla odizolowanych środowisk, takich jak odpowiednio ograniczony kontener lub maszyna wirtualna, bez dostępu do produkcyjnych danych i sekretów.

Do czego używać Claude Code: 5 zastosowań w projekcie

  • Poznawanie cudzego kodu, czyli pytania o architekturę, przepływ danych i to, gdzie coś jest zaimplementowane.

  • Zmiany w wielu plikach naraz, takie jak zmiana nazwy, migracja API biblioteki czy dodanie pola w kilku warstwach aplikacji.

  • Testy, od napisania brakujących po naprawę tych, które przestały przechodzić.

  • Audyt i poprawki w repozytorium, na przykład sprawdzenie adresów kanonicznych czy metadanych w szablonach, co opisałem w tekście o agentach AI i audycie SEO w repozytorium.

  • Automatyzacja w CI, gdzie Claude Code w trybie nieinteraktywnym (np. claude -p "Przejrzyj zmiany i wskaż możliwe błędy") może analizować zmiany po przygotowaniu uwierzytelniania, uprawnień i kontekstu w workflow, co pokazuję w artykule o agentach AI w GitHub Actions.

Gdy projekt rośnie, przydają się bardziej zaawansowane funkcje. Możesz wprowadzić subagenty, które przejmują wydzielone zadania, na przykład przegląd zmian, bez zaśmiecania głównej rozmowy, a hooki uruchamiają Twoje skrypty przy określonych zdarzeniach, choćby formatowanie po każdej edycji. Do zewnętrznych narzędzi i danych agenta podłączysz przez serwery MCP, którym poświęciłem przewodnik po Model Context Protocol.

Ograniczenia i ryzyka pracy z Claude Code

Claude Code potrafi się pomylić i robi to z pełnym przekonaniem. Bez testów i przeglądu kodu łatwo przepuścić zmianę, która wygląda poprawnie, a psuje coś obok. Trzeba pamiętać, że praca bez czytania wygenerowanego kodu to już vibe coding ze wszystkimi jego ryzykami. W dużych repozytoriach agent nie widzi całego kodu naraz, dlatego im precyzyjniej wskażesz mu właściwe katalogi lub pliki, tym trafniejszy będzie wynik. Podczas długich sesji okno kontekstowe modelu stopniowo się zapełnia. Gdy przechodzisz do zupełnie nowego zadania, wyczyść historię poleceniem /clear, a jeśli kontynuujesz ten sam wątek, użyj /compact, aby skompresować dotychczasowy przebieg rozmowy. Ważne ustalenia warto zapisywać w plikach projektu lub w CLAUDE.md, ponieważ skompresowana historia może pominąć istotne detale.

Praca w lokalnym terminalu odbywa się z udziałem modelu w chmurze, więc wybrane wycinki kodu i rezultaty działania narzędzi trafiają na zewnątrz. W przypadku repozytoriów firmowych upewnij się, jakie zasady prywatności i przetwarzania danych obowiązują na Twoim planie. Pamiętaj także, że wpisanie pliku do .gitignore wyklucza go tylko z repozytorium Git, a nie z dostępu dla agenta operującego na lokalnym systemie plików.

Nie jest też jedynym narzędziem tego typu. Przy dużych refaktoryzacjach coraz częściej pierwszy krok wykonuję w Codexie, a Claude Code daje mi drugie, niezależne spojrzenie na zmianę, choć to też zależy od problemu. Porównanie Claude Code z Codexem i Gemini CLI, razem z wyborem modelu, opisałem w przewodniku po programowaniu z AI w 2026 roku.

Ile kosztuje Claude Code: ceny planów i API

PlanCena miesięcznieDla kogo
Pro20 USD lub 200 USD za rok z góry (ok. 17 USD/mies.)okazjonalna praca, mniejsze projekty
Max100 USDintensywniejsza praca, wyższe limity niż Pro
Ultra200 USDdłuższe zadania i większe zapotrzebowanie na użycie
Team, Enterprisecena za stanowiskozespoły z centralnym zarządzaniem i rozliczeniem
APIza zużyte tokenyautomatyzacje, CI, nieregularne użycie

Ceny w tabeli podano bez ewentualnych podatków, według stanu na 15 listopada 2026. Plan abonamentowy nie oznacza nielimitowanej pracy: obowiązują limity, a użycie Claude i Claude Code może korzystać ze wspólnej puli. Przy intensywnej pracy na planie Pro możesz szybko osiągnąć limity, zwłaszcza z najmocniejszym modelem. API jest rozliczane za zużycie, ale ma własne limity tempa żądań i wydatków. Długie sesje oraz równoległe zadania mogą zwiększyć koszt; nie traktuj API jako dostępu bez ograniczeń. Ceny i limity zmieniają się, więc przed zakupem sprawdź aktualny cennik Claude.

Raporty, treści i monitoring SEO w n8n, z agentami AI i kontrolą człowieka.
Automatyzacja SEO i marketingu

Często zadawane pytania

Ile kosztuje Claude Code i czy jest darmowy?

Korzystanie z Claude Code wymaga płatnej subskrypcji lub rozliczenia przez API, ponieważ darmowy plan nie obejmuje tego narzędzia. Do wyboru masz wariant Pro za 20 USD miesięcznie (lub 200 USD przy płatności za rok z góry, co daje około 17 USD na miesiąc), plan Max w cenie 100 USD oraz Ultra za 200 USD miesięcznie. Wyższe pakiety różnią się limitami i zakresem użycia, dlatego Ultra nie jest jedynie droższą kopią planu Max. Alternatywnie możesz rozliczać się wyłącznie za realne zużycie tokenów w API, bez stałego abonamentu. Wszystkie kwoty to ceny netto według stanu na 15 listopada 2026 roku.

Czy Claude Code działa na Windowsie?

Tak. Claude Code działa na macOS, Linuxie i Windowsie, w terminalu, w edytorach VS Code i JetBrains, w aplikacji desktopowej i w przeglądarce na claude.ai/code. Na Windowsie instalujesz go poleceniem w PowerShellu, a do pełnej pracy w terminalu przyda się Git for Windows.

Jak używać Claude Code w Visual Studio Code?

Zainstaluj rozszerzenie Claude Code od Anthropic (anthropic.claude-code) z widoku rozszerzeń. Wymaga VS Code 1.94 lub nowszego i działa też w Cursorze. Panel otworzysz ikoną iskry w rogu edytora albo skrótem Cmd+Esc (Ctrl+Esc na Windowsie i Linuxie). Proponowane zmiany widzisz jako diff do zaakceptowania lub odrzucenia, a ustawienia, uprawnienia i serwery MCP są wspólne z wersją terminalową.

Co to jest plik CLAUDE.md w Claude Code?

Plik CLAUDE.md to instrukcja startowa, którą Claude Code wczytuje automatycznie na początku każdej sesji. Najlepiej wygenerować go poleceniem /init, a następnie uzupełnić o informacje, których agent nie wyczyta samodzielnie ze struktury projektu: komendy do testów i walidacji, konwencje commitów oraz pliki lub katalogi wyłączone z edycji. Pamiętaj jednak, że plik ten służy do przekazywania kontekstu, a nie do egzekucji twardych blokad – to bardzo ważne. Jeśli zależy Ci na prawdziwych ograniczeniach uprawnień, należy je konfigurować w systemie autoryzacji oraz za pomocą hooków.

Czy Claude Code może zepsuć mój projekt?

Tak, agent może zmodyfikować kod w sposób niepożądany. Domyślny tryb blokuje ryzykowne operacje do momentu zatwierdzenia przez użytkownika, jednak część odczytów i autoryzowanych wcześniej akcji przechodzi bez pytania. Zawsze zapisuj stan roboczy w Gicie przed startem pracy, regularnie weryfikuj diff i sprawdzaj uważnie testy. Miej na uwadze, że Git chroni pliki w repozytorium, ale nie naprawi bazy danych ani nie cofnie operacji w zewnętrznych API.

O autorze

Maciej Sala

Maciej Sala — konsultant technologiczny produktów cyfrowych i web developer z bogatym doświadczeniem w marketingu internetowym oraz SEO. Na co dzień pracuje z Reactem, Next.js i TypeScriptem, a ostatnio także z Astro i narzędziami do automatyzacji procesów AI. Sprawnie łączy perspektywę produktową z praktycznym podejściem do kodu. Przez kilka lat był związany z branżą gier wideo jako project manager i game designer. Absolwent historii na Uniwersytecie Jagiellońskim oraz studiów podyplomowych z marketingu internetowego na AGH w Krakowie. Po godzinach trenuje na siłowni, maluje figurki i rozwija własne projekty.

Pomagam przekładać takie tematy na konkretne wdrożenia w frontendzie, SEO, analityce i procesie produktowym.

Skontaktuj się ze mną
LH.pl – Hosting Mango

Biblioteka wiedzy na temat AI

Czytaj dalej

Zobacz więcej wpisów
Jak zacząć z Codex i jak używać go w projekcie

Codex od OpenAI to agent programistyczny zaprojektowany do pracy bezpośrednio na repozytorium kodu. Potrafi pracować zarówno lokalnie w terminalu, jak i w izolowanym środowisku w chmurze. Narzędzie potrafi analizować strukturę projektu, wprowadzać zmiany w wielu plikach jednocześnie, uruchamiać testy oraz przygotowywać gotowe pull requesty. W tym artykule dowiesz się, jak dokładnie działa Codex, jak skonfigurować go w obu trybach pracy oraz jak ustawić poziomy uprawnień, aby bezpiecznie włączyć go w codzienny proces wytwarzania oprogramowania.

Maciej Sala

Maciej Sala

Founder StriveLab

Najlepsze AI do programowania w 2026: Claude Code, Codex czy Gemini?

Dyskusja o najlepszym AI do programowania najczęściej krąży wokół trzech nazw: Claude, ChatGPT i Gemini. Po wielu miesiącach codziennego pisania kodu z udziałem asystentów AI realnie polegam na dwóch z nich, natomiast trzecie narzędzie sprawdza się u mnie w zupełnie innej roli. Wyjaśniam, jak dzielę zadania między Claude Code a Codexem, gdzie przydaje się Gemini i jak zweryfikować ten zestaw na własnym repozytorium.

Maciej Sala

Maciej Sala

Founder StriveLab

Czym jest Claude Design i jak projektować interfejsy z AI

Claude Design pozwala błyskawicznie zamienić surowy brief w działający prototyp interfejsu, zestawić alternatywne warianty UX i precyzyjnie przekazać go deweloperom. Przygotowanie pierwszych propozycji interfejsu odbywa się tak szybko, że trudno nie pochylić się nad tym narzędziem bardziej. W tym artykule prześledzimy ten proces krok po kroku na przykładzie modułu rezerwacji wizyty.

Maciej Sala

Maciej Sala

Founder StriveLab

LH.pl – Cloud Server 1C4G