Claude Code: pierwsze kroki. Instalacja i pierwszy projekt bez bycia programistą

Claude Code to agent do kodowania, który działa w terminalu: opisujesz mu po ludzku, co ma powstać, a on sam czyta pliki, pisze kod i uruchamia polecenia. Ten poradnik przeprowadzi Cię od zera do pierwszego działającego projektu. Zakładamy, że nie jesteś programistą i nie masz nic zainstalowane. Całość zajmuje kwadrans, z czego większość to czekanie na instalator.

Jedno wyjaśnienie na start: „w terminalu“ brzmi groźnie, ale w praktyce oznacza okno, w którym piszesz polecenia tekstem. Jeżeli to Twój pierwszy kontakt z takim oknem, zajrzyj najpierw do naszego hasła CLI, gdzie tłumaczymy podstawy. Do samego Claude Code wystarczy umiejętność wklejenia jednej komendy i pisania po polsku.

Czego potrzebujesz przed startem

Lista jest krótka. Po pierwsze, komputer z systemem Windows, macOS albo Linux. Po drugie, konto Claude z planem płatnym: narzędzie jest wliczone w abonament Pro za 20 dolarów miesięcznie, czyli około 92 zł z VAT. W planie darmowym Claude Code nie działa. Szczegółowe rozbicie planów, limitów i przeliczenia na złotówki znajdziesz w naszym cenniku Claude Code po polsku. Po trzecie, dowolny pomysł na projekt. Może być zupełnie prosty, na przykład strona z wizytówką albo lista zadań.

Nie potrzebujesz za to: znajomości żadnego języka programowania, edytora kodu ani konta na GitHubie. To wszystko może przyjść później.

Krok 1: instalacja

Anthropic udostępnia jeden oficjalny instalator, który sam dba o aktualizacje. Otwórz terminal (na macOS aplikacja Terminal, na Windows PowerShell) i wklej jedną linijkę.

Na macOS i Linuksie:

curl -fsSL https://claude.ai/install.sh | bash

Na Windows w PowerShell:

irm https://claude.ai/install.ps1 | iex

Instalator pobiera program i dodaje go do systemu. Gdy skończy, zamknij terminal, otwórz go ponownie i sprawdź, czy wszystko działa:

claude --version

Jeżeli zobaczysz numer wersji, masz gotowe. Jeżeli terminal odpowiada, że nie zna polecenia claude, najczęstszy powód to stare okno terminala: zamknij je i otwórz nowe, żeby system załadował świeżą konfigurację.

Dwie uwagi dla porządku. Na Windows warto doinstalować Git for Windows, z nim agent dostaje pełnoprawną powłokę Bash i pracuje sprawniej. Użytkownicy Homebrew na macOS mogą wybrać brew install --cask claude-code, ale wtedy aktualizacje robisz ręcznie, więc dla większości osób lepszy jest instalator oficjalny.

Krok 2: logowanie

Wpisz w terminalu po prostu:

claude

Przy pierwszym uruchomieniu program poprosi o zalogowanie i otworzy przeglądarkę. Wybierz logowanie kontem Claude (to samo, którego używasz na claude.ai) i potwierdź. Dane logowania zapisują się na komputerze, więc robisz to raz. Gdybyś kiedyś chciał zmienić konto, w trakcie sesji służy do tego komenda /login.

Jest też druga ścieżka, logowanie przez konto Console z kluczem API, gdzie płacisz za faktyczne zużycie tokenów zamiast abonamentu. Na początek odradzamy: abonament Pro daje przewidywalny rachunek, a próg opłacalności obu wariantów policzysz później w naszym narzędziu API kontra subskrypcja.

Krok 3: pierwszy projekt

Claude Code pracuje w folderze, w którym go uruchomisz, i widzi tylko jego zawartość. Utwórz więc folder na projekt i wejdź do niego:

mkdir moja-strona
cd moja-strona
claude

Zobaczysz znak zachęty, nad nim wersję, model i bieżący katalog. Od tej chwili rozmawiasz. Napisz po polsku, co ma powstać, na przykład:

Zbuduj prostą stronę-wizytówkę: imię i nazwisko, krótki opis,
trzy linki do social mediów. Ciemne tło, czytelna typografia.
Jeden plik HTML, bez zewnętrznych bibliotek.

Agent zaproponuje zmiany i poprosi o zgodę przed utworzeniem pliku. Zatwierdzasz, a po chwili masz na dysku gotową stronę, którą otworzysz w przeglądarce. Kolejne poprawki zgłaszasz normalnym językiem: „powiększ nagłówek“, „dodaj sekcję z projektami“, „zmień kolory na jaśniejsze“. Ta pętla, opis, wynik, poprawka, to serce całej pracy, o którym więcej piszemy w haśle vibe coding.

Warto wiedzieć, że o zgodę na zmiany pyta domyślnie przy każdej ingerencji w pliki. Klawiszami Shift+Tab przełączasz tryby uprawnień: od pytania o wszystko, przez automatyczne akceptowanie edycji, po tryb planowania, w którym agent najpierw przedstawia plan działania, a dopiero po Twoim zatwierdzeniu rusza do pracy. Na początek zostań przy domyślnym pytaniu, zobaczysz dzięki temu, co dokładnie robi.

Krok 4: praca na istniejącym projekcie

Prawdziwa siła agenta ujawnia się w projekcie, który już istnieje. Wejdź do dowolnego folderu z kodem (może być pobrany szablon albo projekt od znajomego) i zacznij od pytań zamiast poleceń:

Co robi ten projekt?

Wyjaśnij strukturę folderów tak, żeby zrozumiał laik.

Claude Code sam przeczyta pliki, których potrzebuje, nie musisz mu nic wklejać. Dopiero gdy rozumiesz teren, poproś o zmianę. Dobre pierwsze zadanie jest małe i konkretne: „popraw literówkę na stronie głównej“, „zmień kolor przycisku na zielony“. Zasada jest taka sama jak przy rozmowie z człowiekiem: im konkretniej opiszesz problem, tym lepszy wynik. Zamiast „napraw błąd“ napisz „po wysłaniu pustego formularza strona się zawiesza, napraw to i dodaj walidację“.

W nowym projekcie warto od razu wydać komendę /init. Agent przejrzy pliki i utworzy CLAUDE.md, plik z zasadami projektu, który wczytuje na starcie każdej sesji. Dzięki temu nie tłumaczysz w kółko tych samych rzeczy. To pierwszy krok w stronę pracy, którą opisujemy w haśle agentic engineering.

Komendy, które wystarczą na pierwszy tydzień

Pełną ściągę znajdziesz w tekście 10 komend, które przyspieszą Twój workflow, ale na start wystarczą cztery. /help pokazuje wszystkie dostępne polecenia. /clear czyści rozmowę, używaj między niezwiązanymi zadaniami, agent pracuje lepiej bez balastu starej historii (dlaczego, tłumaczymy w haśle okno kontekstu). Z terminala claude -c wznawia ostatnią rozmowę w bieżącym folderze, przydatne po przerwie na kawę. A /exit kończy sesję.

Ile to kosztuje w praktyce

Abonament Pro ma limity zużycia odnawiane w kilkugodzinnych oknach. Przy nauce i wieczornych sesjach zwykle wystarczają, przy całodziennej pracy agenta potrafią się skończyć przed czasem. Wtedy masz wybór: poczekać na odnowienie, przejść na wyższy plan albo dokładać klucz API. Zanim cokolwiek zmienisz, przeczytaj nasze rozbicie cennika w złotówkach, a swój scenariusz przelicz w kalkulatorze kosztów.

Najczęstsze potknięcia na starcie

Trzy rzeczy wracają w pytaniach czytelników. Pierwsza: uruchamianie claude w folderze domowym zamiast w folderze projektu. Agent widzi wtedy tysiące niezwiązanych plików i pracuje gorzej, zawsze wchodź najpierw do właściwego katalogu. Druga: zbyt duże pierwsze zadanie. „Zbuduj mi sklep internetowy“ w jednym zdaniu skończy się frustracją, rozbijaj pracę na etapy, jeden etap na jedną rozmowę. Trzecia: bezrefleksyjne zatwierdzanie wszystkiego. Agent bywa pewny siebie także wtedy, gdy się myli (pisaliśmy o tym przy haśle halucynacje AI), więc zanim klikniesz „tak“ przy usuwaniu plików albo zmianach w płatnościach, przeczytaj, co proponuje.

Najczęstsze pytania na start

Czy Claude Code rozumie polecenia po polsku? Tak, i to dobrze. Możesz pisać polecenia, zadawać pytania i czytać wyjaśnienia po polsku, agent odpowiada w języku, w którym piszesz. Kod i nazwy plików powstają po angielsku, zgodnie z konwencją branży, ale cała rozmowa o tym, co budujesz, może iść w naszym języku.

Czy potrzebuję edytora kodu, na przykład VS Code? Nie na start. Claude Code sam edytuje pliki, a efekt oglądasz w przeglądarce. Edytor przydaje się później, gdy chcesz podejrzeć, co dokładnie zmienił agent. Jest też oficjalna wtyczka do VS Code i JetBrains, wersja przeglądarkowa oraz aplikacja desktopowa, ale terminal pozostaje wariantem podstawowym i najbardziej dopracowanym.

Czy agent może coś zepsuć na komputerze? Domyślne ustawienia są ostrożne: przed każdą zmianą pliku i każdym poleceniem systemowym agent pyta o zgodę, a pracuje tylko w folderze, w którym go uruchomisz. Ryzyko rośnie dopiero wtedy, gdy sam wyłączysz pytania i zostawisz go bez nadzoru, czego na początku po prostu nie rób.

Windows, macOS czy Linux? Bez różnicy, narzędzie działa tak samo na wszystkich trzech systemach. Na Windows masz do wyboru pracę w PowerShell albo w WSL, przy czym dla początkujących PowerShell z doinstalowanym Gitem jest prostszy do ogarnięcia.

Co dalej

Masz zainstalowane narzędzie i pierwszy projekt za sobą. Naturalne następne kroki: nasza recenzja Claude Code pokazuje, jak agent radzi sobie na dużym, prawdziwym projekcie, ściąga z komend przyspieszy codzienną pracę, a jeżeli zastanawiasz się, czy to na pewno narzędzie dla Ciebie, porównanie Claude Code kontra Codex zestawia je z głównym rywalem. Kartę narzędzia z cenami i ocenami trzymamy w katalogu.

Dane i komendy w tym poradniku sprawdziliśmy 4 lipca 2026 na aktualnej wersji Claude Code i oficjalnej dokumentacji Anthropic. Jeśli coś u Ciebie działa inaczej, napisz przez stronę kontaktu, poprawimy.