Co to jest Claude Code i do czego służy?
Claude Code to narzędzie Anthropic działające w terminalu, które pracuje na plikach Twojego projektu. Zgodnie z dokumentacją Anthropic otwiera w terminalu interaktywną sesję, w której zlecasz zadania w naturalnym języku.
W praktyce Claude Code potrafi:
- generować kod na podstawie opisu w naturalnym języku
- refaktoryzować istniejące fragmenty - poprawiać strukturę, wydajność i czytelność
- ogarniać cały projekt naraz - czytać pliki, zależności i strukturę repozytorium
- automatyzować powtarzalne zadania - od testów po dokumentację, a jak wpiąć to w firmę opisuję przy automatyzacji marketingu
- pomagać poza kodem - słowo “Code” w nazwie myli, bo narzędzie równie dobrze obsłuży pracę nad marketingiem, SEO czy porządkowaniem dokumentów
Wymagania przed instalacją Claude Code
Zgodnie z dokumentacją Anthropic wymagania są konkretne i warto je sprawdzić przed pobraniem czegokolwiek:
| Element wg dokumentacji Anthropic | Wymaganie wg tej samej dokumentacji |
|---|---|
| System | macOS 13.0+, Windows 10 1809+ lub Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ |
| Sprzęt | 4 GB pamięci lub więcej, procesor x64 albo ARM64 |
| Powłoka | Bash, Zsh, PowerShell albo CMD |
| Sieć | wymagane połączenie z internetem |
| Konto | plan Pro, Max, Team, Enterprise albo konto Console |
Tu trzeba sprostować rzecz powtarzaną w polskich poradnikach. Instalator natywny nie wymaga Node.js. Zgodnie z dokumentacją Anthropic Node.js dotyczy wyłącznie instalacji przez npm i jest to wersja 22 lub nowsza, a nie 16.
Zgodnie z dokumentacją Anthropic darmowy plan Claude.ai nie obejmuje Claude Code. Potrzebujesz planu Pro, Max, Team, Enterprise albo konta Console, ewentualnie dostawcy zewnętrznego takiego jak Amazon Bedrock, Google Cloud albo Microsoft Foundry.
Instalacja Claude Code krok po kroku
Zgodnie z dokumentacją Anthropic zalecaną metodą jest instalator natywny. To jedna komenda, po której narzędzie samo aktualizuje się w tle.
macOS, Linux i WSL:
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell:
irm https://claude.ai/install.ps1 | iexZgodnie z dokumentacją Anthropic na natywnym Windowsie warto doinstalować Git for Windows, bo dzięki niemu Claude Code korzysta z Git Bash. Bez niego poleceniami powłoki zajmuje się PowerShell.
Ta sama dokumentacja Anthropic wymienia alternatywy dla osób, które wolą menedżer pakietów:
| Metoda wg dokumentacji Anthropic | Komenda wg tej samej dokumentacji |
|---|---|
| Homebrew | brew install --cask claude-code |
| WinGet | winget install Anthropic.ClaudeCode |
| npm | npm install -g @anthropic-ai/claude-code |
Zwróć uwagę na dwa szczegóły, na których łatwo się potknąć. W Homebrew to cask, a nie zwykła formuła, a pakiet npm nazywa się @anthropic-ai/claude-code, nie claude-code.
Zgodnie z dokumentacją Anthropic Homebrew udostępnia dwie paczki: claude-code śledzi kanał stabilny, opóźniony o mniej więcej tydzień, a claude-code@latest dostaje nowe wersje od razu.
Ta sama dokumentacja Anthropic ostrzega wprost przed sudo npm install -g, bo prowadzi to do problemów z uprawnieniami i ryzyka bezpieczeństwa. Na Linuksie dostępne są też podpisane repozytoria apt, dnf i apk.
Logowanie i weryfikacja
Zgodnie z dokumentacją Anthropic logujesz się po prostu uruchamiając claude i przechodząc przez okno przeglądarki. Żadnego wklejania klucza API do terminala.
claudeZgodnie z tą samą dokumentacją Anthropic klucz API wchodzi do gry tylko wtedy, gdy masz ustawioną zmienną ANTHROPIC_API_KEY. Wtedy Claude Code raz poprosi o zatwierdzenie klucza zamiast otwierać przeglądarkę.
Po instalacji sprawdź, czy wszystko działa:
claude --versionZgodnie z dokumentacją Anthropic działająca instalacja wypisze numer wersji w formacie 2.1.211 (Claude Code). Jeśli komenda nie zostanie rozpoznana, zrestartuj terminal.
Jest jeszcze jedna komenda, o której mało kto wie, a ratuje przy diagnozie:
claude doctorZgodnie z dokumentacją Anthropic claude doctor wypisuje diagnostykę instalacji i ustawień bez uruchamiania sesji. Pokazuje stan instalacji, błędy w plikach konfiguracyjnych i ostrzeżenia z sugerowanymi poprawkami.
Praca w edytorze
Zgodnie z dokumentacją Anthropic poza terminalem dostępne są rozszerzenie do Visual Studio Code oraz wtyczka do środowisk JetBrains. Ta sama dokumentacja wymienia też aplikację desktopową jako sposób na korzystanie z Claude Code bez terminala.
Według dokumentacji Anthropic rozszerzenie VS Code, wtyczka JetBrains i aplikacja desktopowa zapisują dane w tym samym katalogu ~/.claude/. Ustawienia i historia sesji są więc wspólne, niezależnie od tego, skąd uruchamiasz narzędzie.
Zarządzanie kontekstem - plik CLAUDE.md
Jedną z najważniejszych funkcji jest plik CLAUDE.md, który przekazuje modelowi stały kontekst projektu. Zgodnie z dokumentacją Anthropic plik jest czytany na starcie sesji, a zalecana długość to poniżej 200 linii.
Utwórz CLAUDE.md w katalogu głównym repozytorium i umieść w nim:
- konwencje kodu - nazewnictwo, formatowanie, zasady lintowania
- opis architektury - jakich frameworków używasz i jak zorganizowany jest projekt
- wymagania projektowe - standardy bezpieczeństwa i wydajności
- wzorce do naśladowania - fragmenty kodu referencyjnego
Przykładowy plik CLAUDE.md:
# Kontekst projektu
## Stack technologiczny
- Frontend: React + TypeScript
- Backend: Node.js + Express
- Baza danych: PostgreSQL
- Testy: Jest + React Testing Library
## Konwencje
- Nazwy zmiennych: camelCase
- Komponenty React: PascalCase
- Każda funkcja publiczna wymaga JSDoc
- Commitowanie wg Conventional CommitsLimit 200 linii ma sens praktyczny, nie estetyczny. Im dłuższy plik, tym więcej kontekstu zjada na starcie każdej sesji, a instrukcje na końcu i tak działają słabiej.
Aktualizacja Claude Code
Zgodnie z dokumentacją Anthropic instalacje natywne aktualizują się same w tle. Reszta metod wymaga ręcznej komendy:
| Metoda instalacji wg dokumentacji Anthropic | Aktualizacja wg tej samej dokumentacji |
|---|---|
| natywna | automatycznie w tle, ręcznie przez claude update |
| Homebrew | brew upgrade claude-code |
| WinGet | winget upgrade Anthropic.ClaudeCode |
| npm | npm install -g @anthropic-ai/claude-code@latest |
Uwaga na pułapkę przy npm. Zgodnie z dokumentacją Anthropic nie należy używać npm update -g, bo respektuje zakres wersji z pierwotnej instalacji i może nie przenieść Cię na najnowsze wydanie.
Zgodnie z dokumentacją Anthropic można też wybrać kanał wydań ustawieniem autoUpdatesChannel. Wartość latest to domyślne nowości od razu, a stable to wersja starsza o mniej więcej tydzień, z pominięciem wydań z poważnymi regresjami.
Kontrola kosztów
Claude Code rozlicza się dwojako i warto wiedzieć, w którym trybie jesteś. Na planie Pro, Max, Team albo Enterprise działasz w ramach limitów subskrypcji. Na koncie Console płacisz za zużyte tokeny.
Kilka nawyków, które realnie ograniczają zużycie:
- Trzymaj CLAUDE.md krótki - stały kontekst wchodzi do każdej sesji, więc każda zbędna linia kosztuje
- Zadawaj konkretne pytania - ogólnikowy opis wymusza na modelu czytanie większej części projektu
- Zamykaj sesję po skończonym zadaniu - długa sesja niesie ze sobą cały wcześniejszy kontekst
- Sprawdzaj zużycie w panelu - anomalie widać najszybciej w statystykach, nie na fakturze
Podsumowanie
Instalacja Claude Code sprowadza się do jednej komendy i zalogowania przez przeglądarkę. Klucz API, Node.js i menedżer pakietów to opcje, nie wymagania.
Największą różnicę robi nie sama instalacja, tylko plik CLAUDE.md z kontekstem projektu. Bez niego powtarzasz te same informacje w każdej sesji. Jak wpiąć takie narzędzia w procesy firmy, opisuję przy wdrażaniu AI.
