Jak używać Claude Code? Praktyczny przewodnik

Wyobraź sobie, że otwierasz terminal, piszesz „napraw ten błąd w logowaniu”, a program sam analizuje kod, znajduje przyczynę, wprowadza poprawkę, uruchamia testy i commituje zmianę. Nie science fiction — to Claude Code, narzędzie od Anthropic, które zmienia sposób pracy programistów.

Czym jest Claude Code?

Claude Code to agentyczne narzędzie do kodowania, które działa w terminalu. Rozumie Twój projekt, potrafi czytać i edytować pliki, uruchamiać komendy, zarządzać gitem i integrować się z zewnętrznymi narzędziami — wszystko sterowane poleceniami w naturalnym języku.

W odróżnieniu od wtyczek typu „podpowiadacz kodu” (jak GitHub Copilot), Claude Code jest agentem — potrafi samodzielnie wykonywać wieloetapowe zadania. Opisujesz cel, a on planuje kroki, wykonuje je i weryfikuje wynik. Dokładnie tak, jak opisywałem w artykule Co to agenci AI?

Claude Code jest dostępny jako narzędzie CLI (wiersz poleceń), rozszerzenie do VS Code i JetBrains, aplikacja desktopowa, a nawet przez przeglądarkę na claude.ai/code.

Instalacja

Instalacja trwa dosłownie minutę. Otwórz terminal i wklej odpowiednią komendę:

macOS / Linux:

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

Windows (PowerShell):

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

Instalator tworzy samodzielny plik wykonywalny bez zewnętrznych zależności i automatycznie się aktualizuje. Nie potrzebujesz Node.js ani żadnych dodatkowych narzędzi (choć warto mieć zainstalowanego git).

Alternatywnie możesz użyć Homebrew na macOS (brew install --cask claude-code) lub WinGet na Windows (winget install Anthropic.ClaudeCode).

Pierwsze uruchomienie

Wejdź do katalogu swojego projektu i wpisz:

cd twoj-projekt
claude

Przy pierwszym uruchomieniu Claude poprosi o zalogowanie. Masz dwie opcje:

• Konto Claude (subskrypcja Pro/Max) — logujesz się przez przeglądarkę. Claude Code jest wliczony w cenę subskrypcji.
• Klucz API (Anthropic Console) — rozliczenie za użycie. Ustawiasz zmienną ANTHROPIC_API_KEY lub podajesz klucz przy logowaniu. Nowe konto dostaje $5 darmowych kredytów.

Po zalogowaniu zobaczysz interfejs czatu w terminalu. Możesz od razu pisać polecenia w normalnym języku.

Co potrafi Claude Code? Praktyczne przykłady

Zrozumienie projektu

Właśnie dołączyłeś do nowego zespołu i masz przed sobą nieznany projekt? Zapytaj:

> Opisz strukturę tego projektu. Jakie technologie są używane
  i jak jest zorganizowany kod?

> Jak działa system autentykacji w tym projekcie?

> Znajdź wszystkie miejsca, gdzie jest obsługiwana płatność.

Claude przeczyta pliki, prześledzenie importy i zależności, a potem wyjaśni Ci architekturę projektu tak, jakby opowiadał Ci kolega z zespołu.

Pisanie i edycja kodu

Opisujesz, co chcesz osiągnąć — Claude planuje podejście i pisze kod w wielu plikach jednocześnie:

> Dodaj formularz rejestracji z walidacją emaila i hasła.
  Użyj istniejących komponentów UI z katalogu /components.

> Dodaj endpoint API /api/users, który zwraca listę użytkowników
  z paginacją. Napisz testy.

> Zmień nazwę funkcji getUserData na fetchUserProfile we wszystkich plikach.

Naprawianie błędów

Masz błąd? Wklej treść errora albo opisz symptom:

> Dostaję ten błąd przy logowaniu:
  TypeError: Cannot read property 'email' of undefined
  Znajdź przyczynę i napraw.

> Testy w auth.test.ts nie przechodzą. Sprawdź dlaczego i napraw.

Claude przeanalizuje stos wywołań, znajdzie źródło problemu, naprawi kod, a potem uruchomi testy, żeby upewnić się, że poprawka działa.

Git i pull requesty

Claude Code głęboko integruje się z gitem. Nie musisz ręcznie pisać commit messages ani tworzyć PR-ów:

> Zrób commit z opisem tego, co zmieniłem.

> Stwórz pull request z tymi zmianami. Opisz, co zostało dodane.

> Pokaż, co się zmieniło od ostatniego commita.

Claude analizuje diff, pisze czytelny opis commita, tworzy branch, pushuje i otwiera PR na GitHubie — używając pod spodem komendy gh.

Uruchamianie komend

Claude potrafi uruchamiać komendy terminala w ramach swojej pracy. Możesz też szybko odpalić komendę bezpośrednio, używając prefiksu !:

> ! npm test
> ! docker compose up -d
> ! python manage.py migrate

Analiza obrazów i screenshotów

Claude Code rozumie obrazy. Możesz wkleić screenshot (Ctrl+V) i poprosić o analizę:

> [wklejony screenshot błędu]
  Co oznacza ten błąd i jak go naprawić?

> [wklejony mockup UI]
  Zaimplementuj ten interfejs w React, używając Tailwind CSS.

Tryb planowania — myśl, zanim zrobisz

Przy złożonych zadaniach warto najpierw poprosić Claude’a o plan, zanim zacznie pisać kod. Włącz tryb planowania skrótem Shift+Tab lub komendą /plan.

W tym trybie Claude analizuje projekt, proponuje podejście, listuje pliki do zmiany i opisuje kroki — ale nic jeszcze nie zmienia. Dopiero po Twojej akceptacji przechodzi do implementacji. To świetny sposób na uniknięcie sytuacji, w której AI idzie w złym kierunku i trzeba cofać zmiany.

Najważniejsze komendy

Claude Code ma wbudowane komendy zaczynające się od /. Oto najczęściej używane:

Skróty klawiszowe

Kilka skrótów, które warto zapamiętać od razu:

Wieloliniowe polecenia wpisujesz przez + Enter (backslash na końcu linii) lub Option+Enter na macOS.

CLAUDE.md — pamięć projektu

Plik CLAUDE.md to coś w rodzaju instrukcji obsługi projektu dla AI. Claude czyta go na początku każdej sesji i stosuje zawarte w nim wytyczne. Możesz wygenerować go automatycznie komendą /init albo napisać ręcznie.

Co warto w nim umieścić:

• Komendy do budowania i testowania (npm run test, make build)
• Standardy kodowania i konwencje nazewnictwa
• Architektura projektu i ważne decyzje techniczne
• Preferowane biblioteki i narzędzia
• Typowe workflow (jak deployujemy, jak robimy code review)

Przykładowy CLAUDE.md:

# Mój Projekt

## Komendy
- Build: `npm run build`
- Testy: `npm run test`
- Lint: `npm run lint`
- Dev server: `npm run dev`

## Konwencje
- TypeScript, strict mode
- Używaj funkcyjnych komponentów React z hookami
- Nazwy plików: kebab-case (np. user-profile.tsx)
- Commity w stylu Conventional Commits (feat:, fix:, docs:)

## Architektura
- Frontend: React + Vite + Tailwind CSS
- Backend: Express.js + Prisma + PostgreSQL
- Testy: Vitest + React Testing Library

## Ważne
- NIE modyfikuj plików w katalogu /generated — są autogenerowane
- Zawsze uruchom testy przed commitem

Wskazówka: Staraj się, żeby CLAUDE.md miał poniżej 200 linii. Badania Anthropic pokazują, że przy krótszych instrukcjach Claude stosuje się do nich w 92% przypadków, a przy ponad 400 liniach — spada do 71%.

Pliki CLAUDE.md mają hierarchię — możesz mieć osobny plik globalny (~/.claude/CLAUDE.md) dla swoich preferencji we wszystkich projektach, projektowy (./CLAUDE.md) współdzielony z zespołem, i lokalny (./CLAUDE.local.md) tylko dla siebie.

Ile to kosztuje?

Claude Code możesz używać na dwa sposoby:

Subskrypcja (stała opłata)

Claude Code jest wliczony w cenę każdego planu — nie płacisz nic dodatkowego.

API (płatność za użycie)

Typowy koszt dla programisty korzystającego z modelu Sonnet to około $6 dziennie (90% programistów wydaje mniej niż $12/dzień). Nowe konto na Anthropic Console dostaje $5 darmowych kredytów — wystarczy na kilka dni testowania.

Claude Code vs Cursor vs GitHub Copilot

Krótkie porównanie, bo to pytanie pada najczęściej:

Wielu programistów używa dwóch narzędzi naraz: Claude Code do ciężkich zadań i automatyzacji, a Cursor lub Copilot do szybkich podpowiedzi podczas pisania kodu.

10 porad na dobry start

1. Bądź konkretny. „Dodaj walidację emaila w formularzu w auth.tsx” jest lepsze niż „popraw kod”.
2. Planuj przed wykonaniem. Przy złożonych zadaniach użyj Shift+Tab (tryb planowania), żeby Claude najpierw zaproponował podejście.
3. Używaj /init na starcie. Wygeneruj CLAUDE.md, żeby Claude znał kontekst projektu od pierwszej sesji.
4. Czyść kontekst między zadaniami. /clear po zakończeniu tematu zapobiega myleniu kontekstów.
5. Kompresuj długie rozmowy. /compact zmniejsza zużycie tokenów o 50–70% bez utraty istotnych informacji.
6. Dawaj przykłady. „Napisz testy w stylu tych z user.test.ts” — Claude podpatrzy format i zachowa spójność.
7. Dobieraj model do zadania. Sonnet na codzienną pracę (tańszy), Opus na złożone decyzje architektoniczne. Przełączaj przez /model.
8. Używaj prefiksu @ do wskazywania konkretnych plików: @src/auth/login.ts popraw obsługę błędów.
9. Przerywaj wcześnie. Jeśli widzisz, że Claude idzie w złym kierunku, naciśnij Esc i doprecyzuj polecenie.
10. Sprawdzaj koszty. Komenda /cost pokazuje, ile tokenów zużyłeś w sesji.

Automatyzacja z trybem headless

Claude Code potrafi pracować bez nadzoru — w trybie headless (flaga -p). To otwiera drzwi do integracji z CI/CD:

# Jednorazowe polecenie — wynik na stdout
claude -p "Opisz, co robi ta funkcja" --format text

# Automatyczny code review w GitHub Actions
claude -p "Przejrzyj zmiany w tym PR i zgłoś potencjalne problemy"

# Analiza logów
tail -f app.log | claude -p "Powiadom mnie, jeśli zobaczysz anomalie"

Możesz użyć formatów wyjścia text, json lub stream-json, co ułatwia parsowanie wyników w skryptach.

Integracja z VS Code i JetBrains

Jeśli wolisz pracować w edytorze niż w czystym terminalu, Claude Code ma oficjalne rozszerzenia:

• VS Code — szukaj „Claude Code” w Extensions. Daje inline diffy, możliwość zaznaczania kodu i przesyłania do Claude’a, podgląd historii rozmów i cofanie zmian do checkpointów.
• JetBrains (IntelliJ, PyCharm, WebStorm) — plugin z JetBrains Marketplace. Wymaga zainstalowanego CLI w tle.

W obu przypadkach Claude Code CLI działa pod spodem — IDE dodaje wygodny interfejs graficzny.

MCP — podłącz Claude’a do swoich narzędzi

MCP (Model Context Protocol) to otwarty standard, który pozwala podłączyć Claude Code do zewnętrznych źródeł danych i narzędzi. Pomyśl o nim jak o „USB-C dla AI” — jednym uniwersalnym złączu.

Przykłady serwerów MCP, które możesz podpiąć:

• Google Drive — Claude czyta Twoje dokumenty
• Jira / Linear — Claude sprawdza i aktualizuje tickety
• Slack — Claude wysyła powiadomienia
• Bazy danych — Claude odpytuje SQL-em
• Własne API — możesz napisać swój serwer MCP

Konfiguracja odbywa się w pliku .mcp.json w katalogu projektu. Zarządzasz serwerami komendą /mcp.

Podsumowanie

Claude Code to jedno z najpotężniejszych narzędzi AI dla programistów dostępnych dziś na rynku. W odróżnieniu od klasycznych asystentów kodu, Claude Code to pełnoprawny agent — samodzielnie czyta, pisze, testuje, commituje i wdraża.

Najważniejsze, co warto zapamiętać:

• Instalacja w minutę — jeden curl i gotowe.
• Naturalny język — opisujesz cel, Claude planuje i wykonuje.
• CLAUDE.md — daj Claude’owi kontekst projektu, a będzie pracował znacznie lepiej.
• Tryb planowania — przy złożonych zadaniach najpierw plan, potem implementacja.
• Elastyczne cenniki — od $20/mies. (subskrypcja) po płatność za tokeny (API).

Zainstaluj, wpisz claude w terminalu i zacznij od prostego pytania o swój projekt. Reszta przyjdzie naturalnie.

Autor

Ollie