Witaj. To podręcznik praktyka do Claude Code w stanie na październik 2026 roku: sto krótkich rozdziałów, z których każdy ma cię nauczyć jednej rzeczy, którą wykorzystasz, zanim zagotuje się czajnik. Napisano go dla programistów i dla tych technicznych nie-programistów, którzy coraz częściej siedzą obok nich i zastanawiają się, czy wolno im dotknąć repozytorium. Wolno. Ostrożnie.
Zacznijmy od prostego opisu. Claude Code to agentowe narzędzie Anthropic do programowania. Czyta bazę kodu, edytuje pliki, uruchamia polecenia i sprawdza własną pracę, a ty kierujesz tym wszystkim rozmową. Ta ostatnia część brzmi jak chatbot. Pierwsza już nie. Chatbot mówi ci, co można by wpisać. Claude Code to wpisuje, uruchamia, czyta komunikat błędu i próbuje jeszcze raz.
Ta różnica znaczy więcej, niż się na pierwszy rzut oka wydaje. Autouzupełnianie kończy twoje zdanie; agent kończy twoje zadanie. Powiedzmy, że w katalogu projektu wpisujesz claude, a potem: testy dat padają w każdy poniedziałek, sprawdź dlaczego. Agent nie zgaduje z kształtu pytania. Szuka testów narzędziem Grep, otwiera pliki narzędziem Read, uruchamia zestaw testów przez Bash, zauważa, że funkcja pomocnicza zakłada, iż tydzień zaczyna się w niedzielę, poprawia ją i znowu uruchamia testy, żeby sprawdzić, czy tym razem przechodzą. Ty się przyglądasz; może zatwierdzasz krok czy dwa; poprawki nie piszesz. Wciąż jednak to ty musisz zdecydować, czy jest słuszna. Zapamiętaj tę myśl. To kręgosłup tej książki.
Terminal jest miejscem, w którym wszystko się zaczęło i w którym wielu ludzi wciąż go poznaje, ale agent nie mieszka już tylko tam. Ten sam agent siedzi w aplikacji desktopowej z wizualnymi diffami, w przeglądarce pod adresem claude.ai/code, gdzie działa w kontenerze w chmurze, w VS Code i JetBrains, w twoim telefonie, w Slacku i w GitHubie. Kolejne części przeprowadzą cię przez każde z tych drzwi. Na razie wystarczy wiedzieć, że wszystkie prowadzą do tego samego pokoju: model, zestaw narzędzi i pętla, która trwa, dopóki praca nie zostanie skończona albo agent nie będzie cię potrzebował.
Agent to nie mądrzejsza klawiatura. To współpracownik, który nigdy się nie męczy i od czasu do czasu źle zrozumie.
Czego to od ciebie wymaga? Mniej pisania, więcej osądu. Będziesz spędzać czas na mówieniu z pewną precyzją, czego chcesz, na przyglądaniu się pracy w toku i na ocenianiu tego, co wraca. To stare umiejętności, które zawsze mieli dobrzy redaktorzy i dobrzy menedżerowie, zastosowane do nowego rodzaju współpracownika. Niektórzy czytelnicy czują ulgę. Inni lekki niepokój, jakby odkryli, że zmywarka ma poglądy. Obie reakcje są rozsądne. Żadna nie jest powodem, by trzymać się z dala od kuchni. Otwórz terminal w projekcie, który dobrze znasz, wpisz claude i zadaj pytanie, na które znasz już odpowiedź. Potem zobacz, czy agent dojdzie do niej tą samą drogą co ty. To najtańsza kalibracja, jaką kiedykolwiek kupisz. Terminal nauczył się mówić. Twoim zadaniem jest nauczyć się, kiedy słuchać.
Ryc. 1 · Terminal nauczył się mówić. Agent kończy zadanie.
Rozdział 2 · Część I
Krótka historia szybkiego roku
Historia jest krótka, bo nie było na nią wiele czasu. Claude Code pojawił się w lutym 2025 roku jako wersja poglądowa (research preview): narzędzie wiersza poleceń dla ludzi gotowych wypuścić model luzem we własnym terminalu. Ogólną dostępność osiągnął w maju 2025 roku, razem z modelami Claude 4. W październiku 2026 roku jest już nie tyle narzędziem, ile rodziną drzwi do tego samego agenta: CLI, aplikacja desktopowa, web, rozszerzenia IDE, aplikacje mobilne, Slack, rozszerzenie do Chrome, GitHub Actions i Remote Control, dzięki któremu telefon może sterować sesją działającą na twoim własnym komputerze.
To sporo zmian jak na krótki odcinek kalendarza, a takie tempo rodzi szczególny rodzaj niepokoju. W poniedziałek uczysz się jakiegoś sposobu pracy, a w czwartek czytasz, że ktoś ma lepszy. Polecenie, na którym polegasz, dostaje rodzeństwo. Wybrany model ma nowszego kuzyna. Jeśli należysz do ludzi, którzy lubią skończyć naukę czegoś, zanim zaczną tego używać, to tempo jest umiarkowanie okrutne.
Stoicka odpowiedź brzmi: oddziel to, co się rusza, od tego, co stoi w miejscu. Rusza się powierzchnia: polecenia, menu, drzwi, którymi wchodzisz, nazwy najnowszych modeli. Nie rusza się kształt pod spodem. Agent zbiera kontekst, wykonuje działanie, weryfikuje wynik i powtarza. Ty mówisz mu, jak wygląda „gotowe”, i sprawdzasz, czy tam dotarł. Uprawnienia decydują, co wolno mu robić bez pytania. Pliki pamięci mówią mu, co powinien już wiedzieć. Te idee były prawdziwe w wersji poglądowej i są prawdziwe teraz. Naucz się ich porządnie, a reszta to słownictwo.
Jest też kilka praktycznych nawyków, dzięki którym tempo przestaje być zagrożeniem, a staje się pogodą. Jeśli instalujesz natywnym instalatorem, Claude Code aktualizuje się sam, więc rzadko jesteś daleko w tyle. Gdy pojawia się coś nowego, wpisz w sesji /help, zamiast przekopywać wątki pełne cudzego entuzjazmu. Gdy po aktualizacji coś zachowuje się dziwnie, /doctor przejrzy twoją konfigurację i powie, co znalazł. A gdy czytasz pewny siebie wpis na blogu o jakiejś funkcji, sprawdź, czy wpis nie jest starszy niż ostatnia zmiana tej funkcji. Wiele jest.
Szybkie narzędzia nagradzają powolne zasady.
W szybkim roku kusi, żeby przyjąć wszystko. Oprzyj się. Każda nowa powierzchnia komuś się przydaje, ale nie każda przyda się tobie w tym miesiącu. Wybierz drzwi, przez które naprawdę będziesz codziennie przechodzić, poznaj ich zwyczaje, a kolejne dodaj dopiero wtedy, gdy poczujesz konkretny brak. Programista, który dobrze używa CLI, zrobi więcej niż taki, który zainstalował wszystkie rozszerzenia i żadnemu nie ufa.
Tempo się utrzyma. To nie prognoza, tylko obserwacja ostatnich dwudziestu miesięcy. Nie możesz go spowolnić i nie musisz nadążać za całością. Musisz nadążać za tą częścią, która dotyka twojej pracy, i wiedzieć, gdzie zapisano resztę, na wypadek gdyby była potrzebna. Nowość jest tania. Procentuje biegłość.
Ryc. 2 · Krótka historia szybkiego roku. Co się zmienia, a co zostaje.
Rozdział 3 · Część I
Zbierz, działaj, sprawdź
Każda sesja Claude Code, wielka czy błaha, kręci się w tej samej pętli. Agent zbiera kontekst, wykonuje działanie, weryfikuje wynik i powtarza, dopóki zadanie nie jest skończone albo dopóki czegoś od ciebie nie potrzebuje. Gdy widzisz tę pętlę, możesz nią sterować. Dopóki jej nie widzisz, agent wygląda jak magik, a magików trudno poprawiać.
Zbieranie to cicha część. Poproś o dodanie limitowania żądań (rate limiting) do API, a agent nie zacznie od pisania. Użyje Glob, żeby znaleźć pliki tras, Grep, żeby znaleźć miejsca obsługi żądań, i Read, żeby otworzyć middleware, które już masz. Może zajrzeć do manifestu pakietów, żeby sprawdzić, jakie biblioteki są zainstalowane. To agent robiący to, co rozsądny nowy pracownik robi pierwszego ranka: rozgląda się, zanim czegokolwiek dotknie. Jeśli zbieranie jest płytkie, praca będzie pewna siebie i błędna. Możesz pomóc, wskazując rzeczy wprost wzmianką @path, na przykład @src/middleware/auth.ts, żeby zaczął we właściwym pokoju.
Działanie to ta część, dla której ludzie przychodzą. Claude edytuje plik narzędziem Edit, tworzy go narzędziem Write albo uruchamia polecenie przez Bash. W zależności od trybu uprawnień niektóre z tych kroków zatrzymają się i najpierw zapytają. W trybie domyślnym, wyświetlanym jako Manual (ręczny), agent pyta przed edycjami, poleceniami i dostępem do sieci. Ta pauza to nie biurokracja. To twoja szansa, żeby zobaczyć działanie, zanim nastąpi, czyli w najtańszym momencie na sprzeciw.
Weryfikacja to część, która odróżnia agenta od oczytanego autouzupełniania. Po edycji Claude uruchomi testy, odpali build, wywoła endpoint albo przeczyta plik z powrotem, żeby sprawdzić, czy zmiana trafiła tak, jak miała. Jeśli coś się nie powiedzie, czyta błąd i rusza na kolejne okrążenie. Jakość tego kroku zależy w dużej mierze od tego, czy weryfikacja w ogóle jest możliwa. Projekt z zestawem testów daje agentowi lustro. Projekt bez testów daje mu tylko własną opinię, mniej więcej tak wiarygodną jak twoja o drugiej w nocy.
Powiedz mu więc, jak sprawdzać. Dodaj limitowanie żądań do trasy logowania, potem uruchom npm test i pokaż mi wynik to lepsza instrukcja niż dodaj limitowanie żądań, bo wskazuje linię mety. Zdziwisz się, jak często różnica między dobrą sesją a mętną sprowadza się do jednego zdania o weryfikacji.
Pętla jest tak uczciwa jak jej ostatni krok.
Możesz wejść w pętlę w dowolnym momencie. Naciśnij Esc, a Claude przerwie to, co robi; możesz zmienić mu kierunek bez utraty sesji. Możesz też pisać, gdy pracuje, a twoja wiadomość poczeka w kolejce, aż następnym razem podniesie wzrok. Jeśli zawędrował tam, gdzie nie miał iść, naciśnij dwa razy Esc albo użyj /rewind, żeby cofnąć kod i rozmowę do wcześniejszego punktu kontrolnego. Nie ma w tym nic niegrzecznego. Tak właśnie ma działać ta współpraca. Obejrzyj trzy czy cztery sesje z pętlą w głowie, a zaczniesz zauważać, gdzie twoje się sypią. Zwykle na pierwszym kroku albo na ostatnim. Środek, o dziwo, przeważnie radzi sobie sam.
Ryc. 3 · Zbierz, działaj, sprawdź. Każda sesja to jedna pętla.
Rozdział 4 · Część I
Instalacja bez ceremonii
Instalacja to najmniej ciekawa część Claude Code i powinna zająć ci najmniej czasu. Dróg jest kilka, wszystkie krótkie, a właściwa to ta, o której potem nie trzeba będzie myśleć.
Zalecana droga to natywny instalator. Na macOS, Linuksie lub WSL otwórz terminal i uruchom curl -fsSL https://claude.ai/install.sh | bash. Na Windowsie w oficjalnej dokumentacji znajdziesz analogiczną jednolinijkówkę dla PowerShella. Zaletą instalacji natywnej nie jest szybkość, tylko utrzymanie: aktualizuje się sama, w tle. Przy tempie, w jakim to narzędzie się zmienia, jest to warte więcej, niż brzmi. Nieaktualna instalacja to najczęstszy powód, dla którego rozdział taki jak ten zdaje się nie pasować do tego, co widzisz na ekranie.
Jeśli wolisz menedżer pakietów, są dwie wydeptane ścieżki. Na Macu brew install --cask claude-code działa tak, jak się spodziewasz. Na Windowsie to samo zrobi WinGet. To całkiem dobre wybory dla ludzi, którzy zarządzają wszystkim jednym narzędziem i lubią, gdy tak jest. Miej tylko jasność, kto odpowiada za aktualizacje, bo cask, którego nigdy nie zaktualizujesz, będzie się po cichu starzał, a dokumentacja pójdzie dalej bez niego.
Wybierz instalację, o której zapomnisz, a potem o niej zapomnij.
Po instalacji przejdź do katalogu projektu i wpisz claude. Przy pierwszym uruchomieniu pojawi się prośba o zalogowanie. Potrzebujesz albo subskrypcji Claude, takiej jak Pro, Max, Team czy Enterprise, albo rozliczeń API przez klucz Anthropic lub dostawcę chmury. Wybierz to, co pasuje do sposobu, w jaki ty lub twoja organizacja już płacicie; w następnej części tej książki jest rozdział o różnicach. Gdy to załatwisz, kursor czeka i prawdziwa praca może się zacząć.
Teraz część, o której nikt nie wspomina, dopóki coś nie pójdzie źle. Czasem narzędzie się dąsa. Polecenie nie zostaje znalezione, albo startuje, ale nie może się uwierzytelnić, albo zachowuje się tak, jakby twoje ustawienie nie istniało. Zanim zaczniesz przeszukiwać internet, uruchom w sesji /doctor. Diagnozuje instalację i konfigurację i mówi, co znalazł, a zwykle jest to coś przyziemnego: dwie kopie zainstalowane dwiema różnymi drogami, ścieżka, która nie obejmuje pliku binarnego, plik ustawień z zabłąkanym przecinkiem. /status to jego łagodniejszy towarzysz, warty zerknięcia, gdy podejrzewasz, że sesja nie jest skonfigurowana tak, jak sądzisz.
Odrobina higieny tu się opłaca. Instaluj tylko jedną drogą; jeśli ją zmieniasz, usuń starą instalację. Dbaj o porządek w ścieżce powłoki. Jeśli pracujesz na kilku maszynach, używaj tej samej metody na każdej, żeby problem na jednej miał tę samą odpowiedź na pozostałych. A jeśli konfigurujesz to dla zespołu, wpisz krok instalacji do notatek wdrożeniowych projektu, w jednej linijce, żeby następna osoba nie wymyśliła szóstej metody. Nic w tym efektownego. I właśnie o to chodzi. Najlepsza instalacja to ta, której nie trzeba pamiętać.
Ryc. 4 · Instalacja bez ceremonii. Zainstaluj raz i zapomnij.
Rozdział 5 · Część I
Pierwsze pięć minut
Wybierz repozytorium, które znasz dość dobrze. Nie najważniejsze w firmie i nie zabawkę skleconą wczoraj wieczorem; coś pośrodku, gdzie rozpoznasz złą odpowiedź. Otwórz tam terminal i wpisz claude. Jesteś teraz w sesji, a kursor czeka, aż powiesz coś sensownego.
Zacznij od prośby o wyjaśnienie bazy kodu. Na przykład: Wyjaśnij, jak zorganizowany jest ten projekt, tak jak nowej osobie, która zaczyna tu w poniedziałek. Gdzie wchodzi żądanie i gdzie zapisywane są dane? Zanim agent odpowie, obserwuj, co robi. Wylistuje pliki, poszuka, otworzy kilka z nich. Odpowiedź, która wróci, to przydatny test dwóch rzeczy naraz: czy agent dobrze czyta i czy twój projekt jest czytelny. Jeśli pomyli strukturę, może to wina agenta; może też być tak, że twoja struktura jest naprawdę zagmatwana, a to warto wiedzieć.
Następnie wprowadź jedną malutką zmianę. Nie funkcję; małe, sprawdzalne usprawnienie. Popraw mylący komunikat błędu, dodaj brakujący opis --help, popraw krok konfiguracji w README, który wszyscy po cichu pomijają. Mów konkretnie: W @README.md sekcja instalacji każe uruchomić make setup, ale Makefile nie ma takiego celu. Popraw instrukcję, żeby zgadzała się z Makefile. Konkretne prośby dają małe diffy, a małe diffy to te, które naprawdę da się przejrzeć.
Gdy agent zechce coś edytować, zapyta. W domyślnym trybie uprawnień, wyświetlanym jako Manual, każda edycja i każde polecenie czekają na twoją zgodę. Przy pierwszej sesji to dokładnie to, czego chcesz. Czytaj każdą proponowaną zmianę, gdy się pojawia. Jeśli sformułowanie jest złe, powiedz to zwykłymi słowami i pozwól mu poprawić. To nie wybredność. To kalibracja.
Pierwszy zatwierdzony diff uczy więcej niż pierwsze dziesięć przejrzanych po łebkach.
Potem przejrzyj zmianę jako całość. W terminalu poproś o pokazanie diffa albo po prostu uruchom git diff. Jeśli wolisz coś bardziej wizualnego, aplikacja desktopowa i rozszerzenie VS Code pokazują zmiany bezpośrednio w pliku. Szukaj edycji, o które chodziło, a potem tych, o które nikt nie prosił. Agent, który chce pomóc, czasem przy okazji porządkuje sąsiednią linijkę. To może być w porządku. Nigdy nie powinno być niespodzianką. Na koniec zrób commit. Możesz poprosić o to Claude'a, a on napisze rozsądny opis, albo zrobić to samodzielnie, żeby ceremonia została w twoich rękach. Tak czy inaczej, zmiana jest teraz w gicie, co ma znaczenie, bo to git jest twoją prawdziwą siatką bezpieczeństwa. Claude Code przechowuje własne punkty kontrolne edycji, ale to wygoda, nie historia.
Pięć minut, jedno wyjaśnienie, jedna mała zmiana, jedna uczciwa recenzja, jeden commit. To cały kształt tej pracy w miniaturze. Większe zadania mają w gruncie rzeczy ten sam kształt, tylko więcej cierpliwości w środku. Jeśli sesja poszła dobrze, jutro spróbuj nieco większej zmiany. Jeśli poszła źle, zobacz gdzie: zwykle prośba była bardziej mglista, niż się wydawała przy pisaniu. Zaczynaj od małego. Agent się nie obrazi, twoi koledzy też nie.
Ryc. 5 · Pierwsze pięć minut. Pięć minut, jeden uczciwy przegląd.
Rozdział 6 · Część I
Narzędzia to ręce
Sam model potrafi tylko produkować tekst. Agentem czyni go zestaw narzędzi: nazwanych, wąskich zdolności, które pozwalają mu dotykać świata. Narzędzia Claude Code mają proste nazwy i warto je poznać, bo te nazwy są zarazem uchwytami, za które chwytasz, przyznając i odbierając uprawnienia.
Najpierw narzędzia do czytania. Read otwiera plik. Glob znajduje pliki według wzorca, więc może odpowiedzieć na pytanie gdzie są wszystkie pliki testów?, niczego nie otwierając. Grep przeszukuje zawartość plików i w ten sposób Claude znajduje każde wywołanie funkcji, zanim zmieni jej sygnaturę. Te trzy narzędzia służą agentowi do zbierania kontekstu i są w większości nieszkodliwe: patrzenie to nie dotykanie. Narzędzia do pisania to Edit, które zmienia fragment istniejącego pliku, i Write, które tworzy plik albo zastępuje go w całości. To rozróżnienie jest praktyczne. Edit to chirurgiczna zmiana, którą przejrzysz linijka po linijce. Write to zupełnie nowa strona i zasługuje na nieco surowsze spojrzenie.
Jest jeszcze Bash, który uruchamia polecenia powłoki. Bash to najpotężniejsze narzędzie w skrzynce, a zatem to, nad którym warto się zastanowić. Dzięki niemu Claude uruchamia twoje testy, odpala build, instaluje zależność albo sprawdza git status. Teoretycznie dzięki niemu mógłby też usunąć katalog. Większość mechanizmów uprawnień, które poznasz później, istnieje właśnie z powodu Basha.
Dwa narzędzia sięgają poza twój komputer. WebFetch pobiera konkretną stronę, na przykład aktualną dokumentację biblioteki, której API zmieniło się w zeszłym miesiącu. WebSearch szuka, gdy Claude nie zna adresu. Wreszcie Agent uruchamia subagenta: osobnego pracownika z własnym kontekstem, który odchodzi na bok, wykonuje kawałek researchu albo pracy i wraca tylko z raportem. Subagentów poznasz porządnie w jednej z dalszych części. Na razie wiedz, że chronią główną rozmowę przed zapchaniem się każdym plikiem, którego dotknęło wyszukiwanie.
Reguła uprawnień jest tak precyzyjna jak nazwa narzędzia w jej środku.
Oto dlaczego nazwy mają znaczenie. Reguły uprawnień w pliku ustawień zapisuje się właśnie za ich pomocą. "allow": ["Bash(npm test)"] pozwala Claude'owi uruchamiać polecenie testów bez pytania. "allow": ["WebFetch(domain:github.com)"] pozwala mu swobodnie czytać strony GitHuba. "deny": ["Bash(rm -rf *)"] z góry zakazuje pewnego rodzaju katastrofy, a deny wygrywa z allow w każdym trybie. Te reguły obejrzysz i zmienisz przez /permissions. Narzędzia pochodzące z serwerów MCP też mają swój wzorzec, pojawiają się jako mcp__<server>__<tool>, więc można na nie zezwalać albo ich zakazywać tą samą metodą.
Gdy pojawia się prośba o zgodę, podaje nazwę narzędzia i pokazuje, co chce ono zrobić. Przeczytaj tę linijkę. W ciągu tygodnia zauważysz, że w kółko zatwierdzasz tych samych kilka rzeczy, zwykle uruchomienia testów i odczyty, a to dobrzy kandydaci na regułę allow. Prośby, które widujesz rzadko, warto zostawić jako prośby. Poznaj ręce, a będziesz wiedzieć, które związać, a które zostawić wolne.
Ryc. 6 · Narzędzia to ręce. Nazwy narzędzi to uchwyty uprawnień.
Rozdział 7 · Część I
Wybór umysłu
Claude Code działa na modelach Claude, a ty wybierasz, na którym. Pod koniec 2026 roku rodzina obejmuje Opus 5.5, Sonnet 5.5, Haiku 4.5 i Fable 5.1. Dokumentacja opisuje, do czego służy każdy z nich, i zmienia się wraz z rozrostem rodziny, więc każde streszczenie, łącznie z moim, traktuj jako punkt wyjścia, a nie prawo. Przełączanie jest proste. Wpisz w sesji /model i wybierz z listy. Wybór obowiązuje w tej sesji i możesz go zmienić w połowie, jeśli praca zmieni charakter. Możesz też ustawić model domyślny w pliku ustawień pod kluczem model, żeby każda nowa sesja zaczynała tam, gdzie zwykle chcesz zacząć.
Drugie pokrętło to wysiłek. /effort ustawia, jak głęboko model rozumuje, zanim zacznie działać, a poziomy mają nazwy takie jak low, medium, high, xhigh i max. Większy wysiłek to więcej myślenia: staranniejsze plany, więcej uwagi dla przypadków brzegowych, a po drodze więcej tokenów i czasu. Mniejszy wysiłek jest żwawy. Żaden nie jest lepszy w abstrakcji. Zmiana nazwy zmiennej nie wymaga głębokiej myśli, a błąd współbieżności w obsłudze płatności nie zasługuje na pobieżną.
Przydatny nawyk to wybierać według zadania, nie według próżności. Silnie ciągnie, żeby zawsze używać największego modelu na najwyższym wysiłku, w myśl teorii, że na inteligencji się nie oszczędza. Teoria brzmi szlachetnie i działa słabo. Ciężki model na maksymalnym wysiłku, poproszony o poprawienie literówki, poprawi ją po pauzie tak długiej, że zaczniesz się zastanawiać, czy przypadkiem nie umarł. Tymczasem twój limit topnieje na nic. Dopasuj umysł do roboty: wszechstronny model do codziennej pracy, więcej głębi, gdy problem jest naprawdę trudny albo niejednoznaczny, coś lżejszego i szybszego do mechanicznych obowiązków.
Właściwy model to najtańszy, który dobrze wykona robotę.
Jest jeszcze kwestia kontekstu. Obsługiwane modele oferują okno do miliona tokenów, co wystarcza, by zmieścić pokaźną bazę kodu i długą rozmowę. Kusi, żeby uznać to za pozwolenie, by w ogóle przestać myśleć o kontekście. Nie rób tego. Duże okno oznacza mniej przerw, a nie nieskończoną uwagę. Model, który dostał wszystko, wciąż musi znaleźć to, co ważne, a sesja zagracona trzema porzuconymi podejściami jest trudniejsza do sterowania niż świeża. Używaj /context, żeby zobaczyć, co wypełnia okno, i /clear, gdy zmieniasz temat.
Dobry wzorzec pracy wygląda tak. Zacznij dzień na swoim zwykłym modelu z umiarkowanym wysiłkiem. Gdy zadanie stawia opór, gdy agent dwa razy obchodzi pętlę bez postępu, podnieś wysiłek, zanim zmienisz cokolwiek innego, bo często brakowało właśnie głębi. Gdy trafisz na serię rutynowych zmian, znów go obniż. Traktuj pokrętła jak przerzutki w rowerze: zmieniasz je pod górkę, a nie dla wizerunku.
Nikt nie da ci medalu za użycie największego modelu do poprawki w README. Wybierz umysł, jakiego potrzebuje zadanie, a ciężkie myślenie zachowaj dla problemów, które na nie zasłużyły.
Ryc. 7 · Wybór umysłu. Dobierz umysł do zadania.
Rozdział 8 · Część I
Płacenie za przywilej
Claude Code kosztuje pieniądze i lepiej zrozumieć jak, zanim rachunek albo limit sam się przedstawi. Nie będę tu podawać cen. Zmieniają się, a książka, która je podaje, starzeje się szybciej niż mleko. Niewiele zmienia się natomiast struktura.
Są dwa sposoby płacenia. Pierwszy to subskrypcja Claude: Pro, Max, Team lub Enterprise. Logujesz się kontem Claude, a korzystanie z Claude Code czerpie z tego planu. Drugi to rozliczenia API, kluczem API Anthropic albo przez dostawcę chmury, z którego twoja organizacja już korzysta. Tu płacisz za to, co zużyjesz. Subskrypcje pasują osobom i zespołom, które chcą przewidywalności. Rozliczenia API pasują organizacjom, które i tak prowadzą wydatki przez konto w chmurze, oraz zautomatyzowanej pracy, którą trzeba precyzyjnie opomiarować. Wiele zespołów używa obu: subskrypcji dla ludzi, rozliczeń API dla pipeline'ów.
Tak czy inaczej, istnieją limity użycia. Subskrypcja to nie bufet bez dna; plany mają przydziały, a intensywne dni potrafią je wyczerpać. Rozliczenia API mają własne ograniczenia. Dokładne liczby należą do dokumentacji, która będzie aktualna wtedy, gdy ten rozdział już nie będzie. Liczy się to, że limit istnieje i że możesz zobaczyć, jak blisko niego jesteś.
Pomagają dwa polecenia. /cost pokazuje, ile wydała bieżąca sesja. /usage pokazuje, ile już masz zużyte. Zerkaj na nie przez tydzień pod koniec każdej długiej sesji, a wyrobisz sobie wyczucie, które rodzaje pracy są drogie. Rzadko są to te, których się spodziewasz. Sesja, która dwanaście razy przeczytała ten sam ogromny plik logu, wyda więcej niż sesja, która napisała całą funkcję.
Najpierw wydawaj uwagę, potem tokeny. Uwaga jest tańsza i procentuje.
To zdanie jest praktycznym sercem tego rozdziału. Większość marnotrawstwa nie bierze się z dużego modelu ani z wysokiego wysiłku. Bierze się z mglistych próśb. Ulepsz dashboard zaprasza agenta, żeby przeczytał wszystko, spróbował kilku rzeczy i zapytał, o co ci chodziło. Niech spinner ładowania na dashboardzie pojawia się dopiero po 300 milisekundach, w @src/components/Dashboard.tsx kosztuje ułamek tego i daje coś, co przejrzysz w minutę. Trzydzieści sekund twojego myślenia zastępuje wiele minut jego szperania.
Pomaga też kilka innych nawyków. Używaj /clear, gdy zmieniasz temat, żeby następne zadanie nie ciągnęło za sobą kontekstu poprzedniego. Pozwól, by /compact streścił długą sesję, zamiast nieść dalej każdą wymianę. Wybieraj wysiłek świadomie, jak radził poprzedni rozdział. A jeśli łapiesz się na powtarzaniu tego samego wyjaśnienia w każdej sesji, zapisz je raz w pliku CLAUDE.md, któremu obszernie poświęcona jest jedna z dalszych części. Nic z tego nie jest skąpstwem. To ta sama dyscyplina, z której bierze się dobre zlecenie dla wykonawcy: jasny zakres, znana linia mety i żadnego płacenia komuś za błąkanie się po budynku w poszukiwaniu usterki. Agentowi błąkanie się nie przeszkadza. Twojemu budżetowi owszem. Pieniądze wydane na jasność to jedyne, których nigdy się nie żałuje.
Ryc. 8 · Płacenie za przywilej. Wydaj uwagę przed tokenami.
Rozdział 9 · Część I
W czym jest słaby
Każdy uczciwy podręcznik ma rozdział o porażkach i to jest właśnie ten. Claude Code jest bardzo dobry w wielu rzeczach. W kilku jest też słaby, a kłopot w tym, że często bywa w nich słaby tym samym spokojnym, płynnym głosem, którym mówi, gdy ma rację. Znajomość kształtów jego porażek to początek dobrego korzystania z niego.
Pierwsza to pewna siebie pomyłka. Agent czasem powie ci, że funkcja robi coś, czego nie robi, albo zamelduje, że testy przechodzą, choć uruchomił nie te testy, albo wyjaśni błąd historią spójną i fałszywą. To nie kłamstwo. Taka jest natura systemu, który produkuje wiarygodnie brzmiący tekst, a wiarygodność to inna właściwość niż prawdziwość. Obroną nie jest podejrzliwość wobec wszystkiego; to byłoby wyczerpujące. Obroną są dowody. Poproś, żeby pokazał ci wynik testów, a nie go opisał.
Druga to przestarzałe założenia. Model uczył się na danych z datą graniczną, a biblioteki się zmieniają. Może sięgnąć po API, które zeszłej wiosny zmieniło nazwę, albo po opcję konfiguracji, którą od tamtej pory usunięto. Gdy coś pada w sposób, który pachnie rozjazdem wersji, wskaż mu aktualną dokumentację przez WebFetch albo powiedz, której wersji używasz. Gdy już wie, szybko się dostosowuje. Nie może wiedzieć tego, czego mu nie pokazano.
Trzecia to mgliste zadania. Posprzątaj ten moduł nie ma linii mety, więc agent ją wymyśli, i niekoniecznie będzie to twoja. Może zmienić nazwy połowy zmiennych, wydzielić trzy funkcje pomocnicze i przepisać działającą pętlę dla elegancji. Każdą zmianę da się obronić; suma to diff, którego nikt nie chce przeglądać. Mgliste zadania to nie tyle porażka agenta, ile porażka wspólna, ale sprzątać i tak będziesz po agencie.
Płynność to nie trafność. Traktuj gładką odpowiedź jak szkic.
Czwarta to gust. Claude potrafi ci powiedzieć, że projekt jest niespójny, i potrafi z prawdziwą starannością trzymać się przewodnika stylu. Nie potrafi natomiast niezawodnie wiedzieć, które z trzech rozsądnych podejść twój zespół nadal będzie lubił za rok, ani że twoi użytkownicy nie znoszą pewnego rodzaju okienek modalnych, ani że elegancka abstrakcja jest błędem, bo produkt zaraz zmieni kierunek. Gust to nagromadzony kontekst o ludziach i konsekwencjach. Masz go więcej niż jakikolwiek model i warto go dalej ćwiczyć.
Antidotum na wszystkie cztery jest to samo: weryfikacja. Zadbaj, żeby istniał sposób sprawdzenia pracy, i korzystaj z niego. Testy, działający build, prawdziwe żądanie do endpointu, uważna lektura diffa. Pomaga też tryb plan. Naciskaj Shift+Tab, aż się pojawi, a Claude będzie czytać i proponować bez edytowania, więc poprawisz błędne założenie, zanim zamieni się w czterdzieści zmienionych linijek. A gdy odpowiedź wydaje się zbyt zgrabna, poproś, żeby pospierał się sam ze sobą. Zaskakująco dobrze znajduje dziurę we własnej historii, gdy się go do tego zaprosi. Agent nie jest zawodny. Jest niezawodny tak, jak niezawodny bywa kompetentny nieznajomy: przydatny od pierwszej godziny, a zaufanie dostaje w takiej mierze, w jakiej go sprawdzono.
Ryc. 9 · W czym jest słaby. Płynnie nie znaczy dobrze.
Rozdział 10 · Część I
Delegowanie, nie autouzupełnianie
Wszystko w tej części sprowadza się do jednej zmiany w tym, jak widzisz własną rolę. Przy autouzupełnianiu wciąż jesteś autorem; narzędzie podsuwa następne słowo, a ty je przyjmujesz albo odrzucasz. Przy Claude Code jesteś kimś innym. Jesteś osobą, która decyduje, co trzeba zrobić, przekazuje to dalej i ocenia, co wraca. Stajesz się redaktorem.
To nie degradacja. Redaktorzy zawsze byli tymi, którzy wiedzą, czemu tekst służy. Nie piszą każdego zdania, ale decydują, które zdania przetrwają. W kategoriach oprogramowania to ty definiujesz zadanie, ograniczenia i przede wszystkim to, jak wygląda „gotowe”. Potem czytasz diff tak, jak redaktor czyta szkic: czy robi to, o co proszono, czy robi coś, o co nie proszono, i czy za pół roku nie przyniesie nikomu wstydu.
Definiowanie „gotowego” to umiejętność, która zwraca się najbardziej. Dobra definicja wskazuje sprawdzian, który naprawdę da się uruchomić. Import obsługuje pliki ze znacznikiem BOM; dodaj test z takim plikiem; zestaw testów przechodzi to zadanie z linią mety. Zrób importy bardziej odporne to nastrój. Gdy dajesz agentowi linię mety, może w pętli zweryfikować własną pracę, a twoja recenzja staje się potwierdzeniem, a nie śledztwem.
Delegowanie to sztuka powiedzenia dokładnie, czego chcesz, a potem sprawdzenia, czy właśnie to wróciło.
Pewne rzeczy zostają przy tobie. Decyzje trudne do odwrócenia, takie jak usuwanie danych, publikacja wydania czy zmiana interfejsu, od którego zależą inne zespoły, pozostają twoje. Osądy gustu pozostają twoje. Podobnie ostatnia lektura wszystkiego, co wychodzi pod twoim nazwiskiem. System uprawnień, któremu poświęcona jest jedna z dalszych części, istnieje po to, by te granice były jawne: agent może uruchomić testy bez pytania, ale musi zapytać, zanim zrobi push.
Są też rzeczy, które warto odpuścić, i wielu ludziom przychodzi to trudniej. Nie musisz wpisywać boilerplate'u, polować na każde wywołanie funkcji ani pamiętać flagi do tego jednego polecenia. Nie musisz śledzić każdego kroku, gdy już ufasz pętli w danym rodzaju zadań. Wiszenie nad kimś, komu coś się zleciło, to znana porażka w ludzkich zespołach i tutaj jest dokładnie tak samo: kosztuje twoją uwagę i niczego nowego cię nie uczy.
Postawa robocza na resztę tej książki jest więc prosta do wypowiedzenia, a jej przećwiczenie trochę trwa. Powiedz precyzyjnie, czego chcesz. Powiedz, jak to zostanie sprawdzone. Pozwól agentowi pracować. Przejrzyj to, co odda, tak jak redaktor: uczciwie i z własnym nazwiskiem na szali. Z czasem poszerzysz zakres tego, co delegujesz, nie dlatego, że agent się zmienił, ale dlatego, że wiesz już, gdzie jest niezawodny. Parter gotowy. Wiesz, czym jest to narzędzie, jak kręci się jego pętla, jak nazywają się jego ręce, jaki umysł wybrać, ile to kosztuje i gdzie się potyka. Wszystko powyżej tego piętra to szczegóły i dźwignia. Klawiatura przestała być twoim zadaniem. Ale to wciąż ty, i zawsze ty, mówisz: skończone.
Ryc. 10 · Delegowanie, nie autouzupełnianie. Od autora do redaktora.
Darmowy fragment · Część I
Czytaj dalej
Przeczytałeś pierwsze 10 z 100 rozdziałów książki Claude Code: kompletny przewodnik 2026. Pełne wydanie zawiera wszystkie rozdziały i plansze, w PDF i EPUB, po angielsku, francusku, polsku i hiszpańsku.