Claude Code: poradnik od zera, instalacja i pierwsze zadanie

Ten Claude Code poradnik prowadzi od zera do pierwszej działającej sesji: jedna komenda instalacji, logowanie kontem Claude, pierwsze zadanie w Twoim projekcie i plik CLAUDE.md, dzięki któremu agent pamięta zasady projektu. Potrzebujesz terminala, dowolnego projektu z kodem i płatnego planu Claude (Pro, Max, Team albo Enterprise) lub konta w Claude Console z kredytami API. Całość zajmuje kwadrans.

Piszę to z pozycji użytkownika: tę stronę prowadzę z Claude Code, od kodu po publikację wpisów. Wszystkie komendy poniżej pochodzą z oficjalnej dokumentacji.

Czym jest Claude Code

Claude Code to agent do programowania od Anthropic, który działa w terminalu. W odróżnieniu od czatu nie tylko odpowiada: czyta pliki w repozytorium, edytuje je, uruchamia komendy, pisze testy i robi commity. Opisujesz, co chcesz osiągnąć, a Claude sam szuka właściwych plików i proponuje zmiany.

Ten sam silnik działa też poza terminalem: w VS Code i JetBrains, w aplikacji desktopowej, w przeglądarce na claude.ai/code i w aplikacji mobilnej. W tym poradniku zostaję przy terminalu, bo tam widać najwięcej.

Claude Code poradnik: instalacja w jednej komendzie

Zalecana metoda to natywny instalator, który sam aktualizuje się w tle.

macOS, Linux i WSL:

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

Windows PowerShell:

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

Windows CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Instalator nie pokazuje postępu. Gdy skończy, otwórz nowe okno terminala i sprawdź:

claude --version

Jeśli zobaczysz numer wersji z dopiskiem (Claude Code), wszystko działa. Komunikat, że claude nie jest rozpoznawane, oznacza zwykle brak katalogu instalacji w PATH; dokumentacja ma na to osobną sekcję.

Alternatywy: brew install --cask claude-code na macOS i winget install Anthropic.ClaudeCode na Windows. Te dwie metody nie aktualizują się same. Na Windows bez WSL warto doinstalować Git for Windows, żeby Claude miał dostęp do Basha.

Logowanie i pierwsza sesja

Wejdź do katalogu projektu i uruchom agenta:

cd /sciezka/do/projektu
claude

Przy pierwszym uruchomieniu Claude Code poprosi o zalogowanie w przeglądarce. Logujesz się kontem Claude (plan Pro, Max, Team albo Enterprise) albo kontem Claude Console, czyli dostępem do API z przedpłaconymi kredytami. Dane logowania są zapisywane, więc robisz to raz. Jeśli masz ustawioną zmienną ANTHROPIC_API_KEY, Claude zapyta, czy jej użyć, i pominie logowanie.

Po zalogowaniu zobaczysz prompt z numerem wersji, nazwą modelu i katalogiem roboczym. Wpisz /help, żeby zobaczyć dostępne komendy.

Pierwsze zadanie

Zacznij od pytań, zanim pozwolisz agentowi coś zmieniać. Claude sam czyta pliki, nie musisz ich wklejać:

co robi ten projekt?
gdzie jest główny punkt wejścia?
wyjaśnij strukturę katalogów

Potem mała zmiana:

dodaj funkcję hello world do głównego pliku

Claude znajdzie właściwy plik i pokaże diff. Jeśli zapyta o zgodę, zatwierdź. O tym, na co agent musi pytać, decyduje tryb uprawnień; przełączasz go klawiszami Shift+Tab. W nowszych wersjach domyślny jest tryb auto, w którym osobny model-klasyfikator sprawdza akcje i blokuje tylko te ryzykowne.

Git też obsłużysz zdaniami:

jakie pliki zmieniłem?
zrób commit z opisowym komunikatem
stwórz branch feature/quickstart

CLAUDE.md, czyli pamięć projektu

Każda sesja zaczyna się z pustym kontekstem. Żeby nie tłumaczyć za każdym razem, jak buduje się projekt i jakich konwencji używacie, zapisz to w pliku CLAUDE.md w katalogu głównym repozytorium. Claude czyta go na starcie każdej rozmowy.

Najszybciej zacząć od komendy /init: Claude przeanalizuje repozytorium i wygeneruje plik z komendami budowania, testami i konwencjami, które sam odkryje. Potem dopisujesz to, czego z kodu nie da się wyczytać.

Co warto tam trzymać według dokumentacji:

• komendy, których Claude nie zgadnie (build, testy, lint),
• zasady stylu, które odbiegają od domyślnych,
• etykieta repozytorium (nazwy branchy, konwencje PR),
• decyzje architektoniczne i pułapki specyficzne dla projektu.

Czego nie wpisywać: tego, co Claude sam wyczyta z kodu, i ogólników w stylu „pisz czysty kod”. Dokumentacja radzi trzymać plik poniżej 200 linii. Dłuższe pliki zjadają kontekst i są gorzej przestrzegane.

Kilka faktów, które oszczędzą Ci szukania:

• ~/.claude/CLAUDE.md to Twoje osobiste zasady dla wszystkich projektów, ./CLAUDE.md to zasady projektu dzielone z zespołem, a ./CLAUDE.local.md to prywatne notatki do danego repozytorium (dodaj go do .gitignore).
• Plik może dołączać inne pliki składnią @sciezka/do/pliku.
• Jeśli repozytorium ma już AGENTS.md dla innych agentów, Claude Code przeczyta go zamiast CLAUDE.md.
• /context pokazuje, które pliki pamięci zostały załadowane.

Komendy, które warto znać

Komenda	Co robi
claude	start sesji interaktywnej
claude "zadanie"	start od razu z pierwszym poleceniem
claude -p "pytanie"	jedno zapytanie bez sesji, wynik do terminala
claude -c	kontynuacja ostatniej rozmowy w tym katalogu
claude -r	wybór wcześniejszej rozmowy do wznowienia
/init	generuje startowy CLAUDE.md
/clear	czyści kontekst między niepowiązanymi zadaniami
/compact	streszcza rozmowę, żeby zwolnić kontekst
/rewind (lub dwa razy Esc)	cofa rozmowę i zmiany w plikach do wybranego punktu
/permissions	lista zaufanych narzędzi, mniej pytań o zgodę
Shift+Tab	przełączanie trybu uprawnień, w tym trybu planowania
/exit	wyjście

Tryb -p jest szczególnie przydatny w skryptach: cat error.log | claude -p "wyjaśnij ten błąd" wysyła plik prosto do modelu.

Pięć nawyków, które robią różnicę

Większość rad z oficjalnych dobrych praktyk sprowadza się do jednego ograniczenia: okno kontekstu szybko się zapełnia, a wraz z nim spada jakość.

1. Najpierw eksploracja i plan, potem kod. Przy większych zmianach włącz tryb planowania (Shift+Tab do pojawienia się plan mode on). Claude czyta pliki i proponuje plan, ale niczego nie zmienia, dopóki go nie zatwierdzisz. Przy jednozdaniowych poprawkach plan to zbędny narzut.
2. Bądź konkretny. Zamiast „napraw błąd logowania” napisz, jaki jest objaw, gdzie prawdopodobnie leży przyczyna i co znaczy „naprawione”. Pliki wskazuj przez @nazwa-pliku.
3. Daj agentowi sposób na sprawdzenie pracy. Testy, build, lint albo zrzut ekranu do porównania. Bez tego „wygląda na gotowe” jest jedynym sygnałem, a to Ty stajesz się testerem.
4. Czyść kontekst. /clear między niepowiązanymi zadaniami. Jeśli poprawiałeś Claude’a dwa razy w tej samej sprawie, zacznij od nowa z lepszym promptem.
5. Cofaj bez strachu. Każdy prompt tworzy punkt kontrolny. Gdy eksperyment nie wyjdzie, /rewind przywraca rozmowę i pliki. To nie zastępuje gita, ale zachęca do odważniejszych prób.

Najczęstsze pytania

Czy Claude Code jest darmowy?

Nie. Dokumentacja wymaga płatnego planu Claude (Pro, Max, Team lub Enterprise) albo konta Claude Console, w którym płacisz za tokeny API. Aktualne ceny planów są na claude.com/pricing.

Czy Claude Code działa na Windows?

Tak, natywnie (PowerShell lub CMD) i w WSL. Na natywnym Windows warto mieć Git for Windows, bo wtedy agent korzysta z Basha; bez niego używa PowerShella.

Czy muszę używać terminala?

Nie. Ten sam agent jest dostępny jako rozszerzenie do VS Code i JetBrains, aplikacja desktopowa oraz wersja w przeglądarce. Pliki CLAUDE.md, ustawienia i serwery MCP działają tak samo na każdej z tych powierzchni.

Czym Claude Code różni się od czatu Claude?

Czat odpowiada na pytania. Claude Code pracuje w Twoim repozytorium: czyta i edytuje pliki, uruchamia komendy i testy, robi commity i otwiera pull requesty. Dostaje więc zadanie, a nie pytanie.