Claude Code to agent AI, który sam czyta pliki w Twoim folderze, zmienia je i sprawdza efekt swojej pracy. Żeby zacząć, nie musisz umieć programować. Musisz umieć opisać, co ma być zrobione i jak poznasz, że jest zrobione dobrze. W tym tekście przechodzę przez wszystko, czego potrzebuje osoba, która nie programuje: kilka pojęć, bez których reszta nie ma sensu, instalację, pierwsze uruchomienie i pierwsze zadanie. Po lekturze usiądziesz do własnego folderu i zlecisz coś prawdziwego.
Sam nie jestem programistą, a od pół roku pracuję wyłącznie w Claude Code. Czym agent różni się od czatu, który już znasz, opisałem w artykule agent AI a czat. Tu skupiam się na praktyce. Jedno zastrzeżenie: to nie jest vibe coding, czyli programowanie na czuja, w którym akceptujesz wszystko, co wygeneruje model. To zlecanie pracy z jasnym celem i kryterium sukcesu, tak jak zlecasz ją ludziom.
Wszystko pokazuję na Macu.
Cztery pojęcia na start: terminal, projekt, markdown i VS Code
Co to jest terminal?
Okno, w którym piszesz do komputera zdaniami, zamiast klikać. Na Macu jest zainstalowany fabrycznie.
Najlepiej tłumaczy to porównanie: Finder to sklep samoobsługowy, w którym chodzisz między półkami i sam wybierasz. Terminal to lada z ekspedientem: mówisz, czego chcesz, i dostajesz to od razu. Szybciej, ale trzeba wiedzieć, jak poprosić.
Otwierasz go tak: Cmd + spacja, wpisujesz „Terminal”, Enter. Zobaczysz linijkę zakończoną znakiem %, który znaczy „słucham”.
Terminal wygląda groźnie, bo jest czarny i pusty. W praktyce robisz w nim jedną rzecz: wchodzisz do folderu z pracą. Wystarczą trzy komendy:
pwd # gdzie jestem?
ls # co tu leży?
cd nazwa-folderu # wejdź do folderuSkrót, który oszczędza pisanie: wpisz cd, spację, a potem przeciągnij folder z Findera prosto do okna terminala. Ścieżka wpisze się sama. Nie da się nic zepsuć, wpisując pwd czy ls. Resztę komend napisze za Ciebie Claude.
Co to jest projekt?
Zwykły folder na Twoim dysku. Nic więcej. Claude Code pracuje zawsze wewnątrz jednego folderu i widzi wszystko, co w nim leży.
To jak biurko, przy którym sadzasz nowego współpracownika. Wszystko, co położysz na tym biurku, może przeczytać. Czego nie położysz, tego nie zobaczy. I to nie musi być kod. Projektem może być:
- folder z ofertami w PDF
- folder z notatkami i arkuszami
- folder ze zdjęciami do opisania
- folder z materiałami szkoleniowymi
Ważna jest granica widoczności. Claude Code widzi folder, w którym go uruchomisz, i wszystko poniżej niego. Dlatego nie uruchamiaj go w katalogu domowym ani na pulpicie, gdzie leży wszystko naraz. Im węższy folder, tym lepsze wyniki i mniejsze ryzyko.
Co to jest markdown?
Sposób pisania tekstu, w którym formatowanie robisz znakami z klawiatury, a nie przyciskami. Plik zostaje zwykłym tekstem, więc otworzy go każdy program, także za dwadzieścia lat, a Claude czyta go bez żadnej konwersji. Jeśli piszesz w Notion, Slacku albo WhatsAppie, prawdopodobnie już to znasz.
Wystarczy pięć znaków:
# Nagłówek
## Mniejszy nagłówek
- punkt listy
**pogrubienie**
[opis odnośnika](adres)Markdown jest ważny z jednego powodu: w nim pisze się plik CLAUDE.md, czyli pamięć projektu, o której za chwilę. Litery md na końcu nazwy pliku to właśnie skrót od markdown.
Co to jest VS Code?
Darmowy edytor od Microsoftu, do pobrania z code.visualstudio.com. Dla osoby, która nie programuje, to przede wszystkim czytnik, a nie edytor. Nie będziesz w nim pisać kodu, tylko oglądać, co zrobił Claude:
- drzewo plików - cały folder po lewej stronie, klikasz i czytasz
- podgląd zmian - zielone linie to dodane, czerwone to usunięte
- Claude Code w bocznym panelu - przez rozszerzenie, obok podglądu plików
VS Code nie jest obowiązkowy, bo Claude Code działa w samym terminalu. Ale gdy chcesz zobaczyć, co powstało, jest dużo wygodniejszy niż otwieranie plików pojedynczo.
Git i GitHub bez jednej komendy
To najbardziej mylące pojęcia w całej branży. Warto je poznać nie po to, żeby wpisywać komendy, tylko żeby rozumieć, co się dzieje, gdy Claude o nich pisze.
Git, czyli historia zmian w folderze
Git to program, który zapisuje kolejne stany Twojej pracy. Możesz zobaczyć, co się zmieniło, i wrócić do wcześniejszej wersji, gdy coś pójdzie źle. To jak historia wersji w Dokumentach Google, tylko dla całego folderu naraz. I to Ty decydujesz, kiedy zrobić zapis.
Git działa na Twoim komputerze, offline. Nic nie wysyła do chmury. To najczęstsze nieporozumienie. Na Macu nie musisz go szukać ani pobierać: jeśli nie ma go jeszcze w systemie, przy pierwszym użyciu macOS sam zaproponuje doinstalowanie potrzebnych narzędzi, wystarczy się zgodzić.
Commit, czyli jeden zapis
Commit to jeden zapis w tej historii: zestaw zmian plus zdanie, co się zmieniło i dlaczego. Dobry opis brzmi „dodaj cennik warsztatów na IV kwartał”. Bezużyteczny brzmi „poprawki 2 final FINAL” i za trzy miesiące nie powie Ci nic, dokładnie jak plik oferta_v3_ostateczna.docx.
Nawyk wart wyrobienia: commit po każdej skończonej rzeczy, a nie raz w tygodniu. Małe zapisy oznaczają łatwy powrót.
Gałąź, czyli kopia robocza na boku
Gałąź (ang. branch) to kopia, na której pracujesz swobodnie, a główna wersja, nazywana main, stoi nietknięta. Jeśli zmiany wyjdą dobrze, scalasz je z powrotem (to jest merge). Jeśli nie, kasujesz kopię i nic się nie stało. Przydaje się, gdy chcesz spróbować czegoś ryzykownego. Sam pracuję bez gałęzi, prosto na main, bo nad swoimi projektami pracuję sam. W zespole gałęzie mają sens.
GitHub, push i pull
GitHub to strona internetowa, na której trzymasz kopię projektu razem z całą historią. Daje trzy rzeczy: kopię zapasową (laptop ginie, projekt zostaje), współpracę (widać, kto co zmienił) i automatyzację (moje strony internetowe same się budują i publikują po wysłaniu zmian). Jeden projekt na GitHubie to repozytorium, krótko „repo”. W pracy repozytorium powinno być zawsze prywatne.
Push wysyła Twoje zapisy na GitHub, pull pobiera to, co zrobili inni. Najczęstsza pomyłka początkującego: „zrobiłem commit, więc jest na GitHubie”. Nie jest. Commit to zapis na Twoim dysku, dopiero push wysyła go na serwer. Jeśli pracujesz sam na jednym komputerze, pull praktycznie nie będzie Ci potrzebny.
Jest jeszcze pull request: prośba o zatwierdzenie zmian, zanim trafią do głównej wersji, jak dokument wysłany w trybie recenzji. Jeśli pracujesz sam nad swoim folderem, nie potrzebujesz go. Warto znać słowo, bo pada często.
Jedno zdanie do zapamiętania: git to aparat, GitHub to album w chmurze. Aparatem robisz zdjęcia, czyli commity. Album służy do przechowywania ich i pokazywania innym.
Co mówisz do Claude Code zamiast komend?
Wszystko z tej sekcji robisz zdaniem po polsku:
| Zamiast wpisywać | Mówisz do Claude Code |
|---|---|
git status | „co się zmieniło od ostatniego zapisu?” |
git add . && git commit -m "..." | „zapisz zmiany z sensownym opisem” |
git push origin main | „wyślij na GitHuba” |
git checkout -b nowa-galaz | „zrób gałąź i tam spróbuj tej zmiany” |
git revert HEAD | „cofnij ostatnią zmianę” |
gh pr create | „otwórz pull request z opisem” |
Dlatego uczyłem słów, a nie składni. Gdy Claude napisze „zrobiłem commit i wypchnąłem na main”, masz wiedzieć, co się właśnie stało i czy tego chciałeś.
Jak zainstalować Claude Code na Macu?
Potrzebujesz konta Claude z planem Pro, Max, Team albo Enterprise. Darmowy plan nie obejmuje Claude Code.
- Wklej do terminala i naciśnij Enter:
curl -fsSL https://claude.ai/install.sh | bash - Sprawdź, że się udało:
claude --versionwypisze numer wersji. - Zaloguj się: wpisz
claude. Przy pierwszym starcie otworzy się przeglądarka, w której logujesz się tym samym kontem co na claude.ai.
Uwaga na kopiowanie. Weź komendę z oficjalnej dokumentacji Claude Code i nie szukaj jej w Google. Fałszywe skrypty instalacyjne to znany sposób ataku, a wklejanie komendy do terminala to dokładnie ten gest, który atakujący wykorzystują.
Wolisz bez terminala? Jest aplikacja na Maca, która wygląda i działa jak każdy inny program. Jest też wersja w przeglądarce na claude.ai/code, ale z ważnym zastrzeżeniem: działa w chmurze i wymaga projektu na GitHubie. Folderu z ofertami z Twojego dysku nie otworzy.
Dlaczego trzeba pilnować aktualizacji?
Claude Code zmienia się co kilka dni. Stara wersja nie psuje się z hukiem, tylko po cichu nie ma funkcji, o których czytasz w instrukcjach.
Przykład z mojego Maca, sprawdzony w sierpniu: rozszerzenie w VS Code miało wersję 2.1.241, a osobna instalacja w terminalu, zrobiona kiedyś przez Homebrew, 2.1.168 z czerwca. Jeden komputer, 65 wydań różnicy, i nic tego nie zgłaszało. Mnie to akurat nie przeszkadzało, bo pracuję w VS Code, a rozszerzenie wozi własną kopię Claude Code i aktualizuje się samo, prawie codziennie. Wniosek jest prosty: sprawdzaj wersję tam, gdzie naprawdę pracujesz.
- instalacja z komendy powyżej aktualizuje się sama w tle, a ręcznie wymusisz to komendą
claude update - instalacja przez Homebrew nie aktualizuje się sama, trzeba uruchamiać
brew upgrade claude-code claude --versionpokazuje, co faktycznie masz
Prosta zasada: gdy coś działa dziwnie, najpierw sprawdź wersję i zaktualizuj, dopiero potem szukaj przyczyny.
Pierwsze uruchomienie: co zobaczysz na ekranie?
Zasada, która się nie zmienia: najpierw wejdź do folderu, potem uruchom Claude.
cd ~/Dokumenty/oferty # wejdź do folderu z pracą
claude # uruchom Claude Code w tym folderzePrzy pierwszym uruchomieniu w danym folderze Claude zapyta, czy ufasz jego zawartości. Potwierdź, jeśli to Twój folder. To mechanizm bezpieczeństwa, a nie formalność, więc nie klikaj go odruchowo w cudzym katalogu.
Potem zobaczysz pole do wpisania polecenia i pasek stanu. Nie ma menu ani przycisków. Pasek stanu to Twój licznik: pokazuje tryb uprawnień, model i zużycie kontekstu, czyli ile pamięci bieżącej rozmowy już wykorzystałeś. Im wyższy procent, tym bliżej do automatycznego streszczenia rozmowy. Który model wybrać i jak nie przepalić limitu, opisałem w artykule o limitach Claude Code i wyborze modelu.
Pierwsze zdanie, jakie warto napisać:
co jest w tym folderze i do czego służy?
Claude przeczyta zawartość i opowie, co znalazł. Nic nie zmieni, to samo czytanie. Wychodzisz komendą /exit, a rozmowa zostaje zapisana. claude -c wraca do ostatniej rozmowy w tym folderze, a claude -r pokazuje listę wcześniejszych rozmów do wyboru.
Czy Claude Code zmienia pliki bez pytania?
Na planach Pro, Max i Team domyślnym trybem jest dziś auto: Claude zmienia większość plików i uruchamia większość komend bez pytania, a jego działania w tle sprawdza osobny mechanizm kontroli. Tryb zmieniasz klawiszami Shift + Tab, a aktywny widać na pasku stanu.
Na pierwsze dni polecam tryb, w którym Claude pyta o zgodę przed zmianami. Czytaj te pytania, zamiast klikać na ślepo. Obserwowanie zgód to darmowa nauka: szybko zobaczysz, co narzędzie faktycznie robi w Twoim imieniu, i dopiero z tą świadomością oddasz mu więcej swobody.
Czy Claude Code rozumie po polsku?
Tak. U mnie wszystko jest po polsku: polecenia, pliki CLAUDE.md, plany i dokumentacja projektów. Nie tłumaczę niczego na angielski, żeby Claude lepiej zrozumiał.
Ważniejsze od języka jest to, jak formułujesz zadanie. Pisz pełnym zdaniem, z celem i kryterium sukcesu, tak jak opisałbyś je nowej osobie w zespole. Nie „popraw ofertę”, tylko „popraw literówki i ujednolić ceny w ofercie”. Nie „zrób krótko”, tylko „ma się zmieścić na jednej stronie A4”. Kryterium sukcesu to coś, co Claude może sam sprawdzić.
Pierwsze zadanie w kwadrans
Siedem kroków, po których masz działające środowisko i pierwszy efekt:
- Zainstaluj Claude Code i zaloguj się - jedna komenda i logowanie w przeglądarce
- Zainstaluj VS Code - żeby widzieć, co dzieje się w folderze
- Wybierz folder na próbę - kopię czegoś prawdziwego, nie oryginał
- Uruchom
claudei zapytaj o zawartość - „co tu jest i do czego służy?” - Wpisz
/init- Claude przejrzy folder i sam napisze plik CLAUDE.md, z którego będzie korzystał w kolejnych sesjach. Przeczytaj go i popraw (co warto tam wpisać, opisałem w artykule o pliku CLAUDE.md) - Zleć pierwsze prawdziwe zadanie - pełnym zdaniem, z kryterium sukcesu
- Obejrzyj wynik w VS Code - i oceń go tak, jak oceniłbyś pracę współpracownika
Pomysły na pierwsze zadanie, celowo bez programowania:
- „Przejrzyj te 40 ofert w folderze i zrób tabelę: klient, kwota, data, status. Zapisz jako arkusz.”
- „Streść te notatki ze spotkań w jedną stronę z decyzjami i terminami.”
- „Sprawdź, czy w tych dokumentach ceny są spójne.”
- „Weź ten raport PDF i zrób z niego prezentację.”
Dwie zasady na początek: pracuj na kopii folderu, dopóki nie nabierzesz zaufania, i czytaj, o co Claude pyta.
Jak wygląda zwykły dzień pracy z Claude Code?
U mnie każdy projekt ma plik z planem prac. Pomysły zbieram na bieżąco, w trakcie pracy, i dopisuję je do tego planu. Kiedy siadam do danego projektu, zaczynam od jednego pytania: „co dziś w projekcie robimy?”. Claude czyta plan i od razu wiemy, od czego zacząć. Nie muszę niczego trzymać w głowie między sesjami, nawet po kilku tygodniach przerwy.
Nie musisz znać komend, musisz rozumieć słowa
Z całego tekstu wystarczy zapamiętać trzy rzeczy. Projekt to zwykły folder, git zapisuje jego historię, a GitHub trzyma kopię w chmurze. Nie musisz znać komend, ale musisz rozumieć słowa, żeby wiedzieć, co się właśnie stało. I nic nie jest nieodwracalne, jeśli zapisujesz często, więc eksperymentuj.
Kiedy podstawy wejdą Ci w nawyk, warto dołożyć skille, czyli gotowe instrukcje, które robią z Claude specjalistę od jednej rzeczy. Przykładem są moje skille do promptów dla modeli wideo i obrazu, a jeśli wolisz zacząć bez instalowania czegokolwiek, ta sama wiedza działa w przeglądarce jako generator promptów. Jak z takiego sposobu pracy wyrósł cały produkt, opisałem w artykule o tym, jak zbudowałem API, nie pisząc kodu.
Jeśli chcesz wprowadzić zespół w pracę z Claude Code krok po kroku, zobacz szkolenia AI dla firm albo umów się na konsultacje.