Claude Code od zera

Claude Code to Claude w terminalu. Nie jest to czat, do którego wklejasz kod, tylko agent, który pracuje na plikach w folderze, w którym go uruchomisz. Czyta pliki, edytuje je, uruchamia polecenia (skrypty, testy, git), a przed ryzykownymi krokami pyta cię o zgodę. Ty opisujesz, co chcesz osiągnąć, on planuje i wykonuje, a ty patrzysz i zatwierdzasz.

Claude Code zmienia się szybko. Komendy z tego poradnika są aktualne w chwili pisania, ale zanim coś zainstalujesz, zajrzyj do oficjalnej dokumentacji na docs.claude.com. Tam zawsze jest najświeższa wersja.

Czego potrzebujesz

Płatny plan Claude albo klucz API. Przy pierwszym uruchomieniu logujesz się kontem Claude albo kontem w Claude Console.
Terminal. Na Macu i Linuksie jest wbudowany. Na Windowsie najprościej przez WSL, a o innych sposobach przeczytasz w dokumentacji.
Podstawy terminala. Wystarczy cd (przejście do folderu) i ls (lista plików). Nie musisz umieć programować, ale musisz wiedzieć, gdzie leży twój folder.
Git. Nie jest wymagany, ale bardzo go polecam. Niżej wyjaśniam dlaczego.

Instalacja

Na macOS, Linuksie i w WSL oficjalny instalator to jedna linijka:

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

Druga droga to npm, jeśli masz Node.js w wersji 18 lub nowszej:

npm install -g @anthropic-ai/claude-code

Nie dopisuj sudo do polecenia npm. Jeśli pojawi się błąd uprawnień, poszukaj rozwiązania w dokumentacji. Na koniec sprawdź, czy wszystko działa:

claude --version

Gdy coś jest nie tak, polecenie claude doctor sprawdza instalację i podpowiada, co poprawić.

Pierwsze uruchomienie

Załóż pusty folder, wejdź do niego i uruchom Claude Code:

mkdir pierwszy-projekt
cd pierwszy-projekt
claude

Za pierwszym razem przeglądarka poprosi cię o zalogowanie. Potem widzisz pole, w które piszesz zwykłym językiem, także po polsku.

Kilka rzeczy, które warto wiedzieć od razu:

Claude widzi folder, w którym go uruchomisz. Dlatego uruchamiaj go w folderze projektu, nigdy w katalogu domowym ani na całym dysku.
Plik wskażesz znakiem @, na przykład @notatki.txt.
Esc przerywa to, co Claude właśnie robi. Możesz wtedy poprawić polecenie.
claude -c wraca do ostatniej rozmowy w tym folderze.

Uprawnienia: Claude pyta, ty decydujesz

Domyślnie Claude Code może czytać pliki w folderze, ale zanim zmieni plik albo uruchomi polecenie, pyta o zgodę. Widzisz dokładnie, co chce zrobić, i wybierasz: zgoda, zgoda bez pytania przy podobnych krokach albo odmowa z wyjaśnieniem, co ma zrobić inaczej.

Na początek jedna zasada: czytaj, co zatwierdzasz. Jeśli nie rozumiesz polecenia, odmów i zapytaj: „Co robi ta komenda?”. Nie wyłączaj pytań o zgodę, dopóki nie znasz dobrze narzędzia. Komenda /permissions pokazuje, na co już pozwolono.

Tryb planu

Skrót Shift+Tab przełącza tryby pracy. Jeden z nich to tryb planu: Claude czyta pliki i przygotowuje plan, ale niczego nie zmienia, dopóki go nie zaakceptujesz.

Używaj go przy wszystkim, co jest większe niż drobna poprawka. Przeczytaj plan, dopytaj o niejasne miejsca, popraw to, co ci nie pasuje, i dopiero wtedy zatwierdź. Poprawka planu kosztuje jedno zdanie, a poprawka gotowego kodu znacznie więcej.

CLAUDE.md, czyli pamięć projektu

Plik CLAUDE.md w folderze projektu Claude Code czyta na początku każdej sesji. To miejsce na wszystko, co ma obowiązywać zawsze: czym jest projekt, jak go uruchomić, jakich zasad pilnować. Komenda /init przegląda folder i tworzy pierwszą wersję, którą potem uzupełniasz.

# Porządek w plikach
- Skrypt: `zmien_nazwy.py`, uruchamiasz `python3 zmien_nazwy.py <folder>`.
- Nigdy nie usuwaj plików, tylko zmieniaj nazwy.
- Komunikaty i komentarze po polsku.
- Po każdej zmianie przetestuj skrypt na folderze `przyklady/`.

Najlepszy nawyk: gdy Claude drugi raz popełnia ten sam błąd, dopisz zasadę do CLAUDE.md. Następna sesja zacznie już z tą wiedzą.

Komendy, które warto znać

/help pokazuje wszystkie komendy.
/init tworzy plik CLAUDE.md dla projektu.
/clear czyści rozmowę. Używaj przy przejściu do nowego zadania, CLAUDE.md zostaje.
/compact streszcza dotychczasową rozmowę, żeby zrobić miejsce, gdy robi się długa.
/permissions pokazuje i zmienia zasady zgód.

Git jako siatka bezpieczeństwa

Claude Code zmienia pliki naprawdę, na dysku. Git pozwala cofnąć każdą zmianę. Zanim poprosisz o cokolwiek, zapisz punkt startowy:

git init
git add -A
git commit -m "Punkt startowy"

Po każdym działającym kroku rób kolejny commit albo poproś Claude: „Zrób commit z krótkim opisem zmian”. Gdy coś pójdzie źle, git diff pokaże, co się zmieniło, a git restore . cofnie zmiany w śledzonych plikach, których jeszcze nie zapisano w commicie.

Pierwszy projekt: porządek w nazwach plików

Mały, ale prawdziwy projekt, który przyda się od razu.

W folderze pierwszy-projekt załóż podfolder przyklady i skopiuj do niego kilka plików o bałaganiarskich nazwach. Kopie, nie oryginały.
Zrób commit z punktem startowym.
Uruchom claude, przełącz się na tryb planu (Shift+Tab) i wpisz:

Napisz skrypt w Pythonie, który zmienia nazwy plików w podanym folderze
na format RRRR-MM-DD_nazwa.rozszerzenie, gdzie data to data modyfikacji.
Polskie znaki zamień na łacińskie, spacje na myślniki, wszystko małymi literami.
Domyślnie tylko wypisz, co zostałoby zmienione. Zmieniaj naprawdę dopiero
z flagą --zmien. Przetestuj na folderze przyklady.

Przeczytaj plan i dopytaj: „Co się stanie, jeśli dwa pliki dostaną tę samą nazwę?”. Claude poprawi plan.
Zatwierdź plan i obserwuj pytania o zgodę: utworzenie pliku, uruchomienie Pythona.
Uruchom skrypt w terminalu, już bez Claude: najpierw python3 zmien_nazwy.py przyklady, a gdy lista zmian wygląda dobrze, dodaj --zmien.
Zrób commit i wpisz /init, żeby projekt dostał swój CLAUDE.md.

Tryb próbny z punktu 3 to nawyk wart przeniesienia do każdego skryptu, który dotyka plików: najpierw pokaż, potem zrób.

Jeśli wolisz coś bez Pythona, poproś o jednostronicową stronę w jednym pliku HTML z twoim imieniem, trzema zdaniami o tobie i linkiem do kontaktu. Otwierasz ją w przeglądarce dwuklikiem.

Co dalej

Gdy pierwszy projekt działa, naucz Claude Code twoich powtarzalnych zadań za pomocą skilli: Skille do Claude, których naprawdę używam. Jeśli chcesz zobaczyć, gdzie jesteś na całej drodze od czatu do automatyzacji, zajrzyj do Mapy startu z AI.