Claude Code to agent AI, który pracuje bezpośrednio w Twoim edytorze: czyta projekt, pisze kod, uruchamia polecenia i tłumaczy się z każdej zmiany. Ten przewodnik przeprowadzi Cię od instalacji w Visual Studio Code do pierwszego projektu ze skillami - krok po kroku, bez zakładania, że wiesz, czym jest terminal.

Zanim zaczniemy: VS Code to nie Visual Studio

Drobiazg, który oszczędzi Ci pół godziny szukania: Visual Studio Code (VS Code) to darmowy edytor od Microsoftu - i to w nim działa rozszerzenie Claude Code. Fioletowe „duże" Visual Studio to inny program dla programistów .NET; oficjalnego rozszerzenia Claude tam nie znajdziesz. Jeśli masz wątpliwości, którą wersję masz - VS Code ma niebieską ikonę i waży kilkaset megabajtów, nie kilkanaście gigabajtów.

Potrzebujesz jeszcze konta Claude - subskrypcja Pro albo Max (logowanie kontem z claude.ai) lub klucz API z konsoli Anthropic, jeśli wolisz rozliczenie za zużycie. Do samego testowania wystarczy Pro.

Krok 1: instalacja rozszerzenia

Otwórz VS Code i kliknij ikonę rozszerzeń na lewym pasku (cztery kwadraciki, skrót Cmd+Shift+X na Macu lub Ctrl+Shift+X na Windowsie). W wyszukiwarce wpisz „Claude Code", upewnij się, że wydawcą jest Anthropic, i kliknij Install. Po chwili na pasku pojawi się ikona Claude.

Krok 1: panel rozszerzeń w VS Code - szukasz „Claude Code" i klikasz Install.

Alternatywa dla lubiących terminal: Claude Code działa też jako samodzielne narzędzie CLI (instalacja komendą z oficjalnej dokumentacji na docs.anthropic.com), a rozszerzenie i CLI korzystają z tej samej konfiguracji - czego nauczysz się w jednym, działa w drugim.

Krok 2: logowanie

Przy pierwszym uruchomieniu Claude poprosi o zalogowanie: otworzy się przeglądarka, logujesz się kontem claude.ai (albo wklejasz klucz API) i wracasz do edytora. To jednorazowa czynność - sesja zostaje zapamiętana na komputerze. Jeśli kiedyś coś się rozjedzie, komenda /login w oknie czatu robi to od nowa.

Krok 3: otwórz projekt i odpowiedz na pytanie o zaufanie

Claude pracuje w kontekście otwartego folderu - to jego cały świat. Otwórz więc folder projektu (File → Open Folder), a przy pierwszym kontakcie zobaczysz pytanie, czy ufasz plikom w tym katalogu. To nie biurokracja: agent może czytać pliki i uruchamiać polecenia, więc pyta, zanim to zrobi.

Krok 3: okno zaufania - Claude zapyta, czy ufasz plikom w tym folderze, zanim cokolwiek przeczyta.

Zasada jest prosta: własne projekty i projekty zespołu - ufaj; kod ściągnięty z nieznanego źródła - najpierw przejrzyj. Osobne, podobne pytanie zadaje sam VS Code (Workspace Trust) - odpowiadasz raz na folder. Claude dodatkowo pyta o zgodę przy poszczególnych działaniach: uruchomieniu polecenia, edycji pliku poza projektem czy wysłaniu czegoś do internetu. Na początku czytaj te pytania uważnie - to najlepsza lekcja tego, co agent właściwie robi.

Krok 4: pierwszy projekt, krok po kroku

Scenariusz od zera, który polecam każdemu na start:

  1. Utwórz pusty folder (np. moja-strona) i otwórz go w VS Code.
  2. Uruchom Claude - ikona na pasku albo skrót Cmd+Esc (Mac) / Ctrl+Esc (Windows). Otworzy się panel rozmowy obok kodu.
  3. Zainicjuj pamięć projektu komendą /init - Claude utworzy plik CLAUDE.md, w którym opisuje projekt i zasady pracy. Ten plik czyta na starcie każdej sesji; z czasem dopisujesz tam własne reguły („nie ruszaj katalogu X", „commituj po polsku").
  4. Poproś o git: „załóż repozytorium git i zrób pierwszy commit". Kontrola wersji to Twoja siatka bezpieczeństwa - każdą zmianę agenta widzisz w git diff i możesz cofnąć.
  5. Opisz, co budujesz - normalnym zdaniem, po polsku: „Zbuduj prostą stronę wizytówkę dla warsztatu samochodowego: czarno-żółta, sekcja usług, formularz kontaktowy". Claude zaproponuje plan, a potem zacznie tworzyć pliki.
  6. Przeglądaj i poprawiaj: „przycisk ma być większy", „dodaj zakładkę cennik". Iteracja jest naturalnym trybem pracy - nie musisz mieć wszystkiego w głowie na starcie.
Krok 4: układ pracy - kod po lewej, rozmowa z Claude po prawej, zmiany widzisz na bieżąco.

Dwie komendy, które warto znać od pierwszego dnia: Shift+Tab przełącza tryb planowania (Claude najpierw pokazuje plan, potem dopiero działa - bezcenne przy większych zmianach), a /help wyświetla resztę możliwości.

Krok 5: skille, czyli gotowe procedury

Skill to folder z plikiem SKILL.md - spisaną procedurą, którą Claude wczytuje na żądanie: audyt SEO według checklisty, generowanie grafik w stylu projektu, firmowy proces code review. Zamiast tłumaczyć agentowi za każdym razem, jak coś robić, dajesz mu instrukcję raz.

Krok 5: skill to folder z plikiem SKILL.md - wrzucasz do ~/.claude/skills/ i restartujesz sesję.

Instalacja jest prozaiczna: kopiujesz folder skilla do ~/.claude/skills/ (skille osobiste, dostępne we wszystkich projektach) albo do .claude/skills/ wewnątrz projektu (skille zespołowe, wędrują z repozytorium). Po restarcie sesji skill jest widoczny - wywołasz go komendą /nazwa-skilla albo po prostu opisując zadanie, które on obsługuje.

Skąd brać skille? Oficjalne repozytorium Anthropic na GitHubie (anthropics/skills) zawiera m.in. skill do tworzenia własnych skilli; społecznościowe katalogi znajdziesz pod hasłem „agent skills". A że skill to zwykłe pliki - najlepsze często dostaje się od znajomych, zipem. Jedna zasada: skill spoza zaufanego źródła przejrzyj przed instalacją, tak jak każdy skrypt z internetu - to instrukcje, które agent będzie wykonywał.

Jakich skilli używam sam

Żeby nie było, że polecam teorię - oto zestaw, który mam zainstalowany i którym pracowałem między innymi nad tym serwisem:

Wniosek z praktyki: największą wartość dają skille pakietowe, które prowadzą cały proces (audyt → naprawa → monitoring), a nie pojedyncze triki. I te, które sam napiszesz pod własne, powtarzalne procedury - u mnie takim skillem stała się checklista publikacji artykułu.

Dobre praktyki na start

Commituj często. Po każdej skończonej funkcji - commit. Git to jedyny „undo", który zawsze działa.

Utrzymuj CLAUDE.md. Każda reguła, którą powtarzasz agentowi drugi raz, powinna wylądować w tym pliku. Dobrze prowadzony CLAUDE.md sprawia, że kolejne sesje zaczynają się od pełnego kontekstu, a nie od tłumaczenia wszystkiego od nowa.

Czytaj plany przed akceptacją. Tryb planowania + pięć sekund uwagi oszczędzają godziny sprzątania. Agent jest szybki - to Ty decyduj o kierunku.

Zacznij od małego, prawdziwego zadania. Nie „przepisz cały system", tylko „dodaj walidację do tego formularza". Zaufanie do narzędzia buduje się na zadaniach, których wynik umiesz ocenić.

Częste pytania

Czy Claude Code widzi wszystkie pliki na moim komputerze?

Nie - pracuje w kontekście otwartego folderu projektu. Dostęp poza niego (inne katalogi, internet, polecenia systemowe) wymaga Twojej zgody, o którą agent pyta w trakcie pracy. Dlatego pytanie o zaufanie do folderu pojawia się na samym początku.

Ile kosztuje Claude Code?

Samo rozszerzenie jest darmowe. Płacisz za dostęp do modelu: subskrypcją Claude Pro lub Max (stała opłata miesięczna, logowanie kontem claude.ai) albo kluczem API rozliczanym za zużycie. Do nauki i mniejszych projektów subskrypcja jest prostsza i przewidywalna.

Czy mogę używać Claude Code w istniejącym projekcie?

Tak - to najczęstszy scenariusz. Otwierasz folder projektu, potwierdzasz zaufanie, odpalasz /init, żeby Claude opisał sobie strukturę w CLAUDE.md, i od razu możesz prosić o zmiany. Warto tylko zacząć od zadań przeglądowych („wytłumacz mi, jak działa ten moduł"), zanim oddasz agentowi edycję.

Czym różni się skill od zwykłego promptu?

Skill to procedura zapisana w plikach - wersjonowana, powtarzalna i współdzielona z zespołem, często z własnymi skryptami pomocniczymi. Prompt piszesz za każdym razem od nowa; skill piszesz raz, a potem wywołujesz jedną komendą w każdym projekcie.