Jak skonfigurować Claude Code CLI: 5-minutowy przewodnik
Ponad 29 000 programistów w ServiceNow korzysta dziś z Claude Code codziennie, a Allianz wdrożył go w całej firmie na początku 2026 roku. Krzywa adopcji tego narzędzia odzwierciedla pewien wzorzec: gdy programiści raz wypróbują agentowe kodowanie we własnym terminalu, nie wracają już do kopiowania i wklejania z okien czatu. Ten przewodnik pozwala przejść od zera do działającej sesji Claude Code w około pięć minut, z rzeczywistą konfiguracją, którą można wykorzystywać później.
W skrócie: Należy zainstalować Claude Code za pomocą npm install -g @anthropic-ai/claude-code, uwierzytelnić się przez przeglądarkę, utworzyć plik CLAUDE.md z kontekstem projektu i skonfigurować uprawnienia w .claude/settings.json. Następnie warto dodać hook Prettier do automatycznego formatowania plików po każdej edycji. Cała konfiguracja zajmuje mniej niż pięć minut, a ustawienia są zachowywane między sesjami.
Najważniejsze wnioski
- Samodzielni programiści: CLAUDE.md i hook do formatowania pokrywają 80% potrzeb. Warto zacząć od domyślnych uprawnień i stopniowo zatwierdzać narzędzia w miarę budowania zaufania.
- Liderzy zespołów: Warto dodać
.claude/settings.jsondo repozytorium, aby cały zespół korzystał z tych samych list dozwolonych uprawnień i hooków. - Inżynierowie bezpieczeństwa: Trójpoziomowy model uprawnień (domyślny, wstępnie zatwierdzony, pomiń) mapuje się bezpośrednio na poziomy zaufania. Tryb domyślny wymaga jawnej zgody na każdy zapis i każde polecenie.
Wymagania wstępne
Przed instalacją Claude Code potrzebne są trzy rzeczy:
Node.js 18 lub nowszy. Claude Code jest dystrybuowany jako pakiet npm. Sprawdzenie wersji:
node --version
# v18.0.0 or higher
Jeśli konieczna jest instalacja lub aktualizacja Node.js, można użyć nvm lub pobrać bezpośrednio z nodejs.org.
Konto Anthropic z dostępem do API. Klucz API można utworzyć na console.anthropic.com w sekcji Settings > API Keys. Claude Code rozlicza się z salda API lub planu subskrypcji Max. Klucz należy zachować na potrzeby kroku uwierzytelniania.
Terminal. Claude Code działa w dowolnym emulatorze terminala: Terminal.app, iTerm2, Windows Terminal, Alacritty lub zintegrowany terminal w VS Code. Zalecany jest terminal o szerokości co najmniej 120 kolumn, ponieważ Claude Code wyświetla różnice plików i wyniki narzędzi, które korzystają z dodatkowej przestrzeni poziomej.
Instalacja
Globalna instalacja Claude Code przez npm:
npm install -g @anthropic-ai/claude-code
Weryfikacja poprawności instalacji:
claude --version
Na wyjściu powinien pojawić się numer wersji. W przypadku błędu „command not found” należy upewnić się, że globalny katalog bin npm znajduje się w zmiennej PATH. Można uruchomić npm config get prefix i dodać podkatalog /bin tego wyniku do zmiennej PATH.
Przy pierwszym uruchomieniu Claude Code otwiera przeglądarkę na konsoli Anthropic w celu uwierzytelnienia OAuth. Po zalogowaniu i autoryzacji token jest przechowywany lokalnie w ~/.claude/. Alternatywnie można ustawić zmienną środowiskową ANTHROPIC_API_KEY przed uruchomieniem. W obu przypadkach dane uwierzytelniające pozostają na lokalnej maszynie i służą wyłącznie do uwierzytelniania żądań API.
Pierwsza sesja
Należy przejść do dowolnego katalogu projektu i uruchomić:
cd ~/Projects/my-app
claude
Claude Code uruchamia interaktywną sesję REPL. Przy pierwszym uruchomieniu w nowym projekcie automatycznie wykonuje kilka czynności:
- Skanuje strukturę katalogów, aby zrozumieć układ projektu
- Odczytuje pliki konfiguracyjne takie jak
package.json,pyproject.tomllubCargo.toml, aby zidentyfikować stos technologiczny - Szuka pliku CLAUDE.md w katalogu głównym projektu z instrukcjami specyficznymi dla projektu
Warto wypróbować prosty prompt, aby potwierdzić, że wszystko działa:
> Explain the structure of this project
Claude odczytuje pliki, syntetyzuje architekturę i odpowiada w terminalu. W czasie rzeczywistym widoczne są wywołania narzędzi (każdy odczyt pliku, każde wykonane polecenie) wraz z prośbą o zgodę przed każdą operacją zapisu.
Konfiguracja CLAUDE.md
CLAUDE.md to najważniejszy plik dla efektywnego korzystania z Claude Code. Znajduje się w katalogu głównym projektu i zawiera instrukcje, które Claude odczytuje na początku każdej sesji. Można go traktować jak README dla współpracownika AI.
Utworzenie pliku:
touch CLAUDE.md
Oto praktyczny szablon początkowy:
# My App
## Project Context
Express.js API with React frontend. PostgreSQL database.
## Stack
- Backend: Node.js 20, Express 4, TypeScript
- Frontend: React 18, Vite
- Database: PostgreSQL 16, Prisma ORM
- Testing: Vitest for unit tests, Playwright for e2e
## Code Standards
- Use async/await, never raw Promises
- All API endpoints need input validation with Zod
- Tests required for new endpoints before merging
## Commands
- `npm run dev` starts the dev server on port 3000
- `npm test` runs the test suite
- `npx prisma migrate dev` runs database migrations
Z doświadczenia wynika, że najcenniejsze sekcje zapobiegają powtarzającym się błędom. Jeśli Claude ciągle używa CommonJS, gdy projekt korzysta z ESM, warto to dodać do CLAUDE.md. Jeśli istnieje specyficzne polecenie testowe lub krok konfiguracji bazy danych, należy go udokumentować. Claude odczytuje CLAUDE.md w każdej sesji, więc wszystko, co się tam znajdzie, staje się trwałą instrukcją.
Plik CLAUDE.md można również umieścić w katalogu domowym (~/.claude/CLAUDE.md) jako globalne instrukcje obowiązujące we wszystkich projektach, a także w podkatalogach jako kontekst dotyczący tylko określonych części monorepo.
Podstawy uprawnień
Claude Code działa w trzech poziomach uprawnień, które określają stopień autonomii agenta:
Tryb domyślny prosi o zgodę przed każdym zapisem pliku, wykonaniem polecenia lub destrukcyjną akcją. Widać dokładnie, co Claude zamierza zrobić, i można zatwierdzić lub odrzucić każdy krok. Zalecane jest rozpoczęcie od tego trybu.
Wstępnie zatwierdzone uprawnienia pozwalają dodać określone narzędzia i wzorce do listy dozwolonych, aby Claude nie pytał za każdym razem. Konfiguracja odbywa się w pliku .claude/settings.json projektu:
{
"permissions": {
"allow": [
"Read",
"Glob",
"Grep",
"Bash(npm test)",
"Bash(npx prisma migrate dev)"
]
}
}
Ten przykład pozwala Claude odczytywać pliki, przeszukiwać bazę kodu oraz uruchamiać polecenia testowe i migracyjne bez pytania. Nadal wymaga zgody przed zapisem plików lub uruchomieniem innych poleceń bash.
Niebezpieczne pomijanie uprawnień (--dangerously-skip-permissions) wyłącza wszystkie monity o potwierdzenie. Ta flaga jest przeznaczona wyłącznie dla pipeline’ów CI/CD i zautomatyzowanych przepływów pracy, gdzie nie ma osoby mogącej zatwierdzić operację. Nigdy nie należy jej używać w sesjach interaktywnych na ważnej bazie kodu.
System uprawnień to powód, dla którego Claude Code jest bezpieczny w użyciu na rzeczywistych projektach. Warto zacząć od trybu domyślnego, obserwować, które zatwierdzenia stają się powtarzalne, i selektywnie wstępnie zatwierdzać tylko te konkretne operacje.
Pierwszy hook
Hooki to polecenia powłoki wykonywane w określonych momentach cyklu życia Claude Code. Zapewniają deterministyczne gwarancje na bazie probabilistycznego zachowania LLM. Oto praktyczny pierwszy hook: automatyczne formatowanie plików po ich edycji przez Claude.
Należy utworzyć lub edytować plik .claude/settings.json w projekcie:
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "npx prettier --write \"$FILE_PATH\" 2>/dev/null || true"
}
]
}
]
}
}
Ten hook uruchamia się po każdym wywołaniu narzędzia Edit lub Write. Claude Code ustawia $FILE_PATH na zmodyfikowany plik. Prettier formatuje go w miejscu, a || true zapewnia, że hook nie zablokuje Claude, jeśli Prettier nie jest zainstalowany lub typ pliku nie jest obsługiwany.
Inne praktyczne hooki na początek:
- PreToolUse na Bash: Blokowanie niebezpiecznych poleceń takich jak
rm -rf /lubgit push --force - SessionStart: Wstrzykiwanie aktualnej daty, aktywnej gałęzi Git lub zmiennych środowiskowych do kontekstu (stdout z hooków SessionStart trafia do kontekstu Claude)
- Stop: Automatyczne uruchamianie zestawu testów po zakończeniu zadania przez Claude
Hooki przekształcają Claude Code z narzędzia konwersacyjnego w kontrolowane środowisko programistyczne. Nawet jeden lub dwa dobrze dobrane hooki eliminują całe kategorie błędów.
Kolejne kroki
Ten przewodnik obejmuje podstawy: instalację, pierwszą sesję, konfigurację projektu, uprawnienia i pierwszy hook. Pełna dokumentacja obejmująca wszystkie 5 głównych systemów (hierarchia CLAUDE.md, pełny model uprawnień, architektura hooków, niestandardowe polecenia slash i wieloagentowe przepływy pracy) znajduje się w artykule Kompletny przewodnik po Claude Code.
Przewodnik omawia zarządzanie oknem kontekstu, delegowanie do subagentów, automatyczną aktywację umiejętności oraz wzorce, które pojawiają się po miesiącach codziennego korzystania z Claude Code. Jeśli ten przewodnik był pomocny, pełna wersja jest naturalnym kolejnym krokiem.
FAQ
Ile kosztuje Claude Code?
Claude Code obsługuje dwa modele rozliczeniowe. Model API pay-as-you-go nalicza opłaty za token według standardowych stawek Anthropic API. Typowa sesja trwająca 30-60 minut kosztuje od 0,50 do 3,00 USD w zależności od rozmiaru bazy kodu i ilości generowanego tekstu. Alternatywnie plan Max od Anthropic (100 USD/miesiąc dla osób indywidualnych, 200 USD/miesiąc dla zespołów) obejmuje korzystanie z Claude Code z wyższymi limitami zapytań. Zużycie API można monitorować na console.anthropic.com.
Czy mogę używać Claude Code z VS Code?
Tak. Claude Code działa w dowolnym terminalu, w tym w zintegrowanym terminalu VS Code. Wystarczy otworzyć panel terminala w VS Code, przejść do katalogu projektu i uruchomić claude dokładnie tak samo jak w samodzielnym terminalu. Claude Code odczytuje i edytuje pliki na dysku, więc zmiany pojawiają się natychmiast w otwartych kartach edytora VS Code. Nie jest wymagane żadne osobne rozszerzenie VS Code. Niektórzy programiści utrzymują dedykowany podział terminala dla Claude Code obok edytora, co dobrze sprawdza się przy przeglądaniu zmian w czasie rzeczywistym.
Czy Claude Code jest bezpieczny do użytku na kodzie produkcyjnym?
Domyślny tryb uprawnień Claude Code wymaga jawnej zgody przed każdym zapisem pliku i każdym wykonaniem polecenia. Nic nie zmienia się na dysku bez potwierdzenia użytkownika. System uprawnień w połączeniu z hookami, które mogą blokować niebezpieczne operacje takie jak force push czy destrukcyjne polecenia powłoki, sprawia, że narzędzie nadaje się do pracy produkcyjnej. Korzystam z Claude Code codziennie na projektach obsługujących rzeczywistych użytkowników. Kluczem jest rozpoczęcie w trybie domyślnym, zrozumienie każdego wywołania narzędzia przed jego zatwierdzeniem i stopniowe wstępne zatwierdzanie tylko tych operacji, którym się ufa. System kontroli wersji stanowi ostatnią siatkę bezpieczeństwa: warto utworzyć commit przed rozpoczęciem każdej znaczącej sesji Claude Code, aby zawsze móc cofnąć zmiany.