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
claudew katalogu projektu i poleceniem/initwygeneruj plikCLAUDE.mdz 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ędzie | Producent | Rodzaj | Udział (październik 2026) | Zmiana od stycznia 2026 |
|---|---|---|---|---|
| Claude Code | Anthropic | agent w terminalu | 30,1% | +11,6 pkt proc. |
| GitHub Copilot | Microsoft/GitHub | rozszerzenie do IDE | 22,2% | −8,3 pkt proc. |
| Cursor | Anysphere | edytor oparty na AI | 12,8% | −5,2 pkt proc. |
| Codex | OpenAI | agent w terminalu i chmurze | 12,1% | +7,9 pkt proc. |
| Antigravity i Gemini Code Assist | edytor oparty na AI | 5,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.
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.
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.
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.
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:
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.
| Tryb | Co robi agent | Kiedy go używać |
|---|---|---|
| Domyślny (Manual) | pyta o zgodę przy edycjach i nowych poleceniach | na początku pracy z nowym projektem |
| Akceptacja edycji | edytuje pliki i wykonuje proste operacje na plikach w katalogu projektu bez pytania, o pozostałe polecenia pyta | gdy ufasz kierunkowi zmian i przeglądasz diff |
| Planowanie | analizuje kod i przygotowuje plan bez edycji plików źródłowych | przed każdym większym zadaniem |
| Automatyczny | klasyfikator ocenia działania przed wykonaniem, ograniczając rutynowe pytania; może też blokować operacje | gdy 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
| Plan | Cena miesięcznie | Dla kogo |
|---|---|---|
| Pro | 20 USD lub 200 USD za rok z góry (ok. 17 USD/mies.) | okazjonalna praca, mniejsze projekty |
| Max | 100 USD | intensywniejsza praca, wyższe limity niż Pro |
| Ultra | 200 USD | dłuższe zadania i większe zapotrzebowanie na użycie |
| Team, Enterprise | cena za stanowisko | zespoły z centralnym zarządzaniem i rozliczeniem |
| API | za zużyte tokeny | automatyzacje, 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.


