Claude Code - jak agent AI w terminalu zmienia sposób programowania

Pierwszy raz jak uruchomiłem Claude Code, podszedłem do tego z dystansem. Kolejne AI narzędzie, pomyślałem, kolejny chatbot w nowym opakowaniu. Po godzinie pracy wiedziałem, że to coś innego niż Copilot. Po tygodniu - zmieniłem sposób, w jaki programuję na co dzień.

W tym artykule pokażę Ci, czym jest Claude Code, jak wygląda z nim praca, do jakich zadań nadaje się najlepiej i jak zacząć w 30 minut. Plus wady i ograniczenia, bo nie wszystko jest tak różowe, jak na demo.

Czytanie: ~13 min

Czym właściwie jest Claude Code

Claude Code to narzędzie od Anthropic, które działa w terminalu. Nie w przeglądarce, nie jako rozszerzenie do IDE - w terminalu. Uruchamiasz je w katalogu ze swoim projektem i zaczynasz pisać polecenia w języku naturalnym.

Różnica w stosunku do ChatGPT czy Claude.ai jest zasadnicza. ChatGPT to czat - piszesz wiadomość, dostajesz odpowiedź, kopiujesz do kodu. Claude Code to agent. Sam czyta Twoje pliki, sam pisze kod, sam uruchamia komendy, sam sprawdza błędy. Ty mu mówisz, co chcesz osiągnąć, on to robi.

Najprostsza analogia: wyobraź sobie, że masz junior developera, który siedzi obok i reaguje na Twoje polecenia. "Znajdź bug w tym module", "dodaj test do tej funkcji", "zmień nazwę tej zmiennej wszędzie w projekcie". Tylko że ten junior nigdy nie śpi, nigdy się nie kłóci i pisze 10x szybciej niż człowiek.

Ale uwaga: jak junior, bywa pewny siebie tam, gdzie nie powinien. Dlatego praca z Claude Code to nie "odpal i idź na kawę". To ciągła współpraca.

Jak wygląda praca z Claude Code - pierwsze wrażenie

Instalujesz Claude Code przez npm. Odpalasz w katalogu projektu. Widzisz prompt:

Od tego momentu jesteś w sesji. Piszesz, co chcesz. Przykładowy dialog:

> znajdź wszystkie miejsca w kodzie, gdzie używamy setTimeout bez cleanupu

[Claude przeszukuje kod, znajduje 7 miejsc, pokazuje pliki i linie]

> napraw to, dodaj cleanup w każdym przypadku

[Claude edytuje 7 plików, uruchamia testy, pokazuje wynik]

Wszystko to bez wychodzenia z terminala. Claude sam decyduje, których narzędzi użyć - czy potrzebuje grep, czy read, czy edit, czy bash. Ty dajesz cel, on dobiera środki.

Tryb plan vs auto-execute

Claude Code ma dwa tryby pracy. Warto je znać od początku:

Tryb auto-execute. Claude dostaje zadanie i realizuje je krok po kroku. Edytuje pliki, uruchamia komendy, robi commity. Dobre do prostych, powtarzalnych zadań.

Tryb plan. Claude najpierw pisze plan działania (co zmieni, w jakiej kolejności, dlaczego), a Ty go zatwierdzasz. Dopiero potem zaczyna pracę. Dobre do złożonych zmian, gdzie chcesz mieć kontrolę.

Moja zasada: jeśli zmiana dotyczy więcej niż 3 plików albo modyfikuje logikę - tryb plan. Jeśli to rename, dodanie testu, formatowanie - auto-execute.

Jest jeszcze --dangerously-skip-permissions. Tryb, w którym Claude nie pyta o zgodę na żadną akcję. Realnie niebezpieczny, ale dla zaufanych workflowów w izolowanym środowisku - oszczędza czas.

Tools - co Claude Code potrafi zrobić sam

Claude Code ma zestaw wbudowanych narzędzi. To one robią różnicę między chatbotem a agentem:

Read - czyta plik (lub fragment)
Write - tworzy nowy plik
Edit - edytuje istniejący plik, precyzyjnie
Bash - uruchamia komendę w shellu (npm test, git commit, build)
Grep - wyszukuje wzorce w kodzie
Glob - znajduje pliki po nazwie/patternie
Task - deleguje zadania do subagentów
WebFetch - pobiera zawartość URL

Kluczowa sprawa: Claude sam decyduje, jakich narzędzi użyć. Nie mówisz mu "użyj grepa". Mówisz "znajdź wszystkie wywołania tej funkcji". On wybiera grep.

Pierwsze kroki - instalacja i setup

Najprostsza ścieżka na start:

Zainstaluj Node.js. Wersja 18+. Sprawdź: node --version.
Zainstaluj Claude Code globalnie:

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

Uruchom w katalogu projektu:

cd twoj-projekt
claude

Zaloguj się kontem Anthropic. Pierwsze uruchomienie poprosi o autoryzację przez przeglądarkę.
Stwórz plik CLAUDE.md. To instrukcja dla Claude - co to za projekt, jakie konwencje, czego unikać. Bez tego Claude będzie zgadywał.
Spróbuj prostego zadania. Np. "przeanalizuj ten projekt i powiedz, co robi".

Po 10 minutach będziesz miał pierwsze realne wrażenie. Po godzinie - pierwszą realną pracę.

Ważne na start: nie ufaj ślepo. Claude czasem halucynuje, czasem wymyśla API, które nie istnieje. Traktuj go jak bystrego, ale czasem przekomarzającego się juniora. Weryfikuj, co zrobił.

Kluczowe workflows - co realnie warto robić

Po kilku miesiącach pracy z Claude Code wyłonił mi się zestaw zadań, do których nadaje się świetnie, i zestaw, do których się nie nadaje. Zaczynamy od tych pierwszych.

Bug fixing

Tu Claude Code błyszczy najbardziej. Dajesz mu stack trace albo opis błędu, on przeszukuje kod, znajduje przyczynę, proponuje fix. Czasem nawet znajduje bugi, których nie prosiłeś.

Przykład: miałem dziwny błąd w production - co kilka godzin padał jeden endpoint. Stack trace nic nie mówił (async callback hell). Wrzuciłem logi do Claude, napisałem "znajdź przyczynę". Claude w 3 minuty znalazł race condition w jednym z handlerów. Sam bym szukał pół dnia.

Implementacja nowej funkcji

Opisujesz, co chcesz. Claude planuje, pisze, testuje. Dobrze działa, gdy funkcja jest logicznie wyodrębniona (nowy komponent, nowy endpoint, nowy moduł).

Słabiej działa przy funkcjach, które dotykają wielu warstw (frontend + backend + baza). Tu często musisz prowadzić Claude za rękę krok po kroku.

Refactoring

Tu Claude Code jest lepszy niż większość programistów. "Przerób ten moduł z class-based na functional", "wyciągnij tę logikę do osobnej funkcji", "zmień nazwy wszystkich zmiennych z camelCase na snake_case w tym pliku". Działa szybko, dokładnie, bez błędów copy-paste.

Generowanie testów

Claude czyta Twój kod i pisze do niego testy. Unit testy, integration testy, edge cases. Nie zawsze idealne - czasem halucynuje zachowanie funkcji - ale jako baza do startu świetne.

Dokumentacja

"Przeanalizuj ten moduł i napisz README". "Wygeneruj JSDoc do wszystkich publicznych funkcji". Działa szybko i dobrze, zwłaszcza gdy kod jest czytelny.

Code review

Wrzucasz PR (albo diff), Claude analizuje. Znajduje potencjalne bugi, security issues, style issues. Czasem nawet lepiej niż ludzki reviewer - bo ma cierpliwość sprawdzić każdy edge case.

MCP - otwieranie Claude Code na świat

MCP (Model Context Protocol) to protokół, który pozwala Claude Code łączyć się z zewnętrznymi narzędziami. Anthropic otworzył go jako standard, więc każdy może napisać MCP server dla swojego narzędzia.

Co to daje w praktyce? Claude Code może:

Łączyć się z Twoją bazą danych (PostgreSQL, SQLite) i odpytywać ją w naturalnym języku
Wchodzić do Jiry i tworzyć/czytać tickety
Wywoływać API GitHuba (tworzyć PR, czytać issues, sprawdzić CI)
Łączyć się z Slackiem i wysyć powiadomienia
Pobierać dane z dowolnego REST API

Lista dostępnych MCP serverów rośnie. Oficjalnie wspieranych jest kilkadziesiąt, community tworzy ich setki.

Moja ulubiona konfiguracja: MCP do Postgresa + MCP do GitHuba. Mogę napisać "znajdź wszystkich userów, którzy nie zalogowali się od 30 dni, utwórz dla nich issue na GitHubie z label retention". Claude sam odpytuje bazę, sam formatuje wyniki, sam tworzy issues.

To poziom automatyzacji, którego wcześniej wymagał dedykowany skrypt. Teraz to jedna wiadomość.

CLAUDE.md i pamięć projektu

CLAUDE.md to plik, który Claude Code czyta na początku każdej sesji. To Twoja instrukcja - co to za projekt, jakie zasady, czego unikać.

Przykładowy CLAUDE.md:

# Projekt: e-commerce backend

## Stack
- Node.js 20, TypeScript, Fastify
- PostgreSQL, Prisma ORM
- Redis dla cache

## Konwencje
- Funkcje piszemy w camelCase
- Typy w PascalCase
- Każdy endpoint ma mieć test integracyjny
- Nie używamy klas, preferujemy funkcje

## Czego unikać
- Nie dodawaj nowych zależności bez wyraźnej potrzeby
- Nie modyfikuj plików w /migrations bez pytania
- Nie commituj na main

Im lepszy CLAUDE.md, tym lepsze wyniki. Bez niego Claude zgaduje - czasem dobrze, czasem źle.

Możesz mieć też hierarchię plików CLAUDE.md - główny w katalogu projektu, dodatkowe w podkatalogach. Claude czyta je wszystkie i łączy kontekst.

Dodatkowo Claude ma swoją pamięć między sesjami - zapamiętuje, nad czym pracujesz, co lubisz, jakich narzędzi używasz. Po kilku sesjach zaczyna "znać" Twój workflow.

Slash commands i custom commands

Claude Code ma wbudowane komendy zaczynające się od /. Kilka wartych poznania od początku:

/help - pomoc i lista komend
/plan - przełącza w tryb planowania
/clear - czyści kontekst sesji (gdy się "zapcha")
/cost - pokazuje, ile tokenów zużyłeś
/compact - kompresuje historię rozmowy, zachowując sedno

Możesz tworzyć własne slash commands. W katalogu .claude/commands/ dajesz plik Markdown z instrukcją, np. deploy.md z opisem jak deployować. Potem /deploy odpala tę instrukcję. Świetne dla powtarzalnych workflowów zespołowych.

Hooks - automatyzacja wokół automatyzacji

Hooks to system, który pozwala reagować na zdarzenia w Claude Code. Możesz uruchomić skrypt:

Przed każdą edycją pliku (np. backup)
Po każdej komendzie bash (np. log)
Kiedy Claude pyta o pozwolenie (np. automatyczna zgoda na bezpieczne akcje)

Hooks piszesz w bash albo w Pythonie. Konfigurujesz w settings.json. To zaawansowana funkcja - na początku nie potrzebujesz. Ale warto wiedzieć, że istnieje, gdy zechcesz zintegrować Claude Code ze swoim procesem (pre-commit hooks, lint, deployment).

Subagenci i Task tool

Claude Code ma mechanizm subagentów. Działa tak: Claude główny dostaje złożone zadanie, dzieli je na mniejsze, deleguje do subagentów. Każdy subagent pracuje niezależnie, zwraca wynik. Claude główny łączy.

Przykład: "przeanalizuj ten projekt pod kątem security". Claude deleguje:

Subagent 1: sprawdza zależności pod kątem CVE
Subagent 2: przeszukuje kod w poszukiwaniu SQL injection
Subagent 3: sprawdza konfigurację (secret w repo?)
Subagent 4: analizuje autentykację

Działa równolegle, dużo szybciej niż sekwencyjnie.

Task tool jest ważny też z innego powodu - pozwala Claude Code działać "w tle". Możesz odpalić subagenta na długie zadanie (np. refaktoryzację całego modułu), a samemu pracować dalej. Kiedy subagent skończy, dostajesz powiadomienie.

Claude Code vs GitHub Copilot - różnice

Pytanie, które dostaję najczęściej. Krótka odpowiedź: to dwa różne narzędzia do różnych zadań.

Copilot to autocompletion. Piszesz kod, Copilot podpowiada następne linie. Działa w IDE, w czasie rzeczywistym, kontekstowo. Świetny do codziennej pracy - dopisywania funkcji, generowania boilerplate'u, szybkiego zamykania pomysłu w kodzie.

Claude Code to agent. Piszesz zadanie w terminalu, Claude realizuje je od A do Z. Może dotknąć wielu plików, uruchomić testy, zrobić commit. Działa w czasie "bursty" - dajesz duże zadanie, czekasz na wynik.

Kiedy Copilot:

Piszesz nowy kod i chcesz podpowiedzi w czasie rzeczywistym
Chcesz szybkiego dopełnienia myśli
Wolisz zostać w IDE

Kiedy Claude Code:

Masz złożone zadanie wieloplikowe
Chcesz zautomatyzować refactoring
Pracujesz nad bugiem, którego nie rozumiesz
Chcesz analizę codebase'a

Nie musisz wybierać. Używam obu - Copilot do pisania na bieżąco, Claude Code do większych zadań.

Trzy błędy początkujących

Widziałem je wielokrotnie, więc warto napisać o nich od razu:

Błąd 1: "Zrób wszystko". Dajesz Claude zadanie wielkie jak góra - "przepisz całą aplikację, dodaj testy, napraw bugi, zoptymalizuj". Claude próbuje, gubi się, jakość spada. Dziel na małe kawałki. Jedno zadanie na raz.

Błąd 2: brak CLAUDE.md. "Przecież Claude sam zobaczy kod". Zobaczy. Ale nie wie, że masz specyficzne konwencje, że nienawidzisz biblioteki X, że testy uruchamia się komendą Y. CLAUDE.md zajmuje 10 minut do napisania, oszczędza godziny frustracji.

Błąd 3: ślepa ufność. Claude popełnia błędy. Czasem halucynuje, czasem wymyśla API, czasem sugeruje antywzorce. Weryfikuj diff przed commit. Uruchamiaj testy. Code review to nadal Twoja praca.

Mini case study: migracja z JavaScriptu na TypeScript

Projekt: backend Node.js, 50k linii kodu w JavaScript. Cel: pełna migracja na TypeScript.

Podejście klasyczne (bez Claude Code):

2-3 tygodnie pracy programisty
Wiele błędów w trakcie
Sporo frustracji

Podejście z Claude Code:

Pierwszego dnia Claude przeanalizował codebase, zaproponował plan migracji (kolejność plików, zależności)
Każdy plik: Claude zmieniał rozszerzenie na .ts, dodawał typy, uruchamiał tsc, poprawiał błędy
Ja weryfikowałem logikę typów (Claude czasem dodawał any zamiast poprawnego typu)
Testy uruchamiał automatycznie po każdym pliku

Wynik: 4 dni zamiast 3 tygodni. Kilka bugów, które sam bym zrobił, unikniętych (bo Claude był konsekwentny w konwencjach). Część typów "luźna" (trzeba było dopracować ręcznie), ale działający TypeScript deployment.

Kluczowa obserwacja: Claude Code nie zastąpił mnie. Wykonywał 80% żmudnej pracy, ja robiłem 20% decyzyjnej. Ale to 80% żmudnej pracy to właśnie to, co zabiera najwięcej czasu.

Ile to kosztuje

Claude Code ma kilka modeli cenowych:

Claude Pro (20$/miesiąc) - daje dostęp do Claude.ai, ale nie do Code bezpośrednio. Działa przez OAuth, ale z limitami.

Claude Max (100-200$/miesiąc) - daje bezpośredni dostęp do Claude Code z dużymi limitami. To najpopularniejsza opcja dla profesjonalistów.

API (pay-per-token) - Claude Code może pracować z API kluczem. Płacisz za zużyte tokeny. Dla intensywnego użytkowania - drożej niż subskrypcja. Dla sporadycznego - taniej.

Rough estimate kosztów:

Sporadyczne użytkowanie (kilka razy w tygodniu): ~20-50$/miesiąc przez API
Codzienna praca: 100-200$/miesiąc (Max plan)
Intensywne (8h dziennie, duże codebase'y): 200-500$/miesiąc

Brzmi dużo? Tak. Ale gdy liczę oszczędność czasu (10-15 godzin tygodniowo), ROI jest szybkie. Dla freelancera z rate'em 50$/h - jeden zapisany dzień opłaca miesiąc.

Wady i ograniczenia

Żeby nie brzmieć jak ulotka marketingowa, lista rzeczy, które mnie frustrują:

Halucynacje API. Claude czasem wymyśla funkcje i metody, które nie istnieją. Szczególnie w mniej popularnych bibliotekach. Weryfikacja konieczna.

Kontekst. Claude ma limit kontekstu. W bardzo dużych codebase'ach (1M+ linii) nie ogarnia całości. Trzeba mu pokazywać konkretne pliki.

Przesada z zależnościami. Claude lubi dodawać nowe pakiety ("żeby to zadziałało, musimy zainstalować X"). Czasem słusznie, czasem nie. Miej na to oko.

Cena dla intensywnego użytkownika. 200$/miesiąc to nie drobnica. Dla kogoś, kto programuje okazjonalnie - overkill.

Lock-in na Anthropic. Claude Code działa tylko z modelami Claude. Nie możesz podpiąć GPT-4 albo Llama. Zmiana modelu = zmiana narzędzia.

Czasem się "zapętla". Przy trudnych bugach Claude czasem próbuje tej samej ścieżki kilka razy, zanim zrezygnuje. Człowiek szybciej by zmienił podejście.

Mimo tych wad - dla mnie to dziś narzędzie numer jeden w codziennej pracy. Nie idealne, ale realnie zmienia produktywność.

Jak zacząć - 5 kroków

Najprostsza ścieżka, jeśli chcesz spróbować:

Zainstaluj Claude Code (patrz sekcja wyżej - instalacja przez npm).
Stwórz CLAUDE.md w swoim projekcie. Przynajmniej podstawowe informacje: stack, konwencje, cel projektu. 10 minut pracy, ogromna różnica w jakości.
Zacznij od małego zadania. Nie "przepisz całą aplikację". Tylko "dodaj test do tej funkcji" albo "znajdź bug w tym module". Poczuj, jak Claude pracuje.
Używaj trybu plan do złożonych zmian. Wpisz /plan, opisz, co chcesz, zobacz propozycję. Zatwierdź albo popraw. Dopiero potem realizacja.
Weryfikuj. Po każdej zmianie Claude uruchom testy, zobacz diff, nie ufaj ślepo. Po kilku dniach poczujesz, kiedy można ufać bardziej, kiedy mniej.

Pierwszy tydzień to nauka. Drugi tydzień - już realna praca. Po miesiącu nie wyobrażam sobie powrotu do pracy bez Claude Code.

Chcesz się nauczyć Claude Code - szkolenie

Jeśli czytasz ten artykuł i myślisz "brzmi fajnie, ale nie mam czasu sam tego zgryzać" - rozumiem. Claude Code ma dużo funkcji, o których nie napisałem wyżej (hooks, slash commands, custom subagents, integracje z IDE). Wejście w to samemu zajmuje tygodnie.

Prowadzę szkolenia z Claude Code dla zespołów programistycznych i pojedynczych programistów. Przechodzimy od podstaw (instalacja, pierwsze kroki) do zaawansowanych workflowów (MCP, subagenci, custom tools, integracja z procesem CI/CD). Każde szkolenie dostosowuję do Twojego stacku - pracujemy na Twoim kodzie, nie na akademickich przykładach.

Po szkoleniu Twój zespół:

Wie, do jakich zadań używać Claude Code (a do jakich nie)
Ma skonfigurowane środowisko (CLAUDE.md, MCP, integracje)
Zna wzorce pracy, które realnie oszczędzają czas
Unika pułapek, które kosztują nerwów w pierwszych tygodniach

Jeśli chcesz wiedzieć więcej - napisz do mnie przez mwozniczka.net/kontakt. Powiem Ci wprost, czy szkolenie ma sens dla Twojego przypadku, czy wystarczy Ci sam artykuł i dokumentacja. Bez sprzedaży na siłę, bez combo ofert.