Claude Code CLI — konfiguracja 2026: szybki start w 5 minut

Jak skonfigurować Claude Code? Należy zainstalować CLI globalnie poleceniem npm install -g @anthropic-ai/claude-code, uwierzytelnić się przez przeglądarkę, a następnie utworzyć plik CLAUDE.md w katalogu głównym projektu zawierający informacje o stosie technologicznym i konwencjach kodowania. Uprawnienia konfiguruje się w pliku .claude/settings.json, a hook formatujący dodaje się w celu automatycznego poprawiania stylu po każdej edycji. Cała konfiguracja zajmuje mniej niż pięć minut. {.answer-block}

Ponad 29 000 programistów w firmie ServiceNow korzysta obecnie z Claude Code codziennie¹, a firma Allianz wdrożyła to narzędzie w całej organizacji na początku 2026 roku². Krzywa adopcji tego narzędzia odzwierciedla pewien wzorzec: gdy programiści raz spróbują agentowego kodowania we własnym terminalu, nie wracają już do kopiowania i wklejania z okien czatu. Ten szybki start stanowi część mojej serii AI engineering — praktycznych przewodników dla programistów budujących z Claude. Poniższy przewodnik prowadzi od zera do działającej sesji Claude Code w około pięć minut, wraz z rzeczywistą konfiguracją, z której można korzystać później.

TL;DR: Należy zainstalować Claude Code poleceniem 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. Warto dodać hook Prettier, aby automatycznie formatować pliki 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 oraz hook formatujący pokrywają 80% potrzeb. Warto zacząć od domyślnych uprawnień i zatwierdzać narzędzia z wyprzedzeniem w miarę budowania zaufania.
• Liderzy zespołów: Należy dodać plik .claude/settings.json do repozytorium, aby cały zespół współdzielił te same listy dozwolonych uprawnień oraz hooki.
• Inżynierowie bezpieczeństwa: Trójpoziomowy model uprawnień⁴ (Ask, Allowlisted, --dangerously-skip-permissions) odpowiada bezpośrednio poziomom zaufania. Tryb Ask wymaga jawnej zgody na każdy zapis i każde polecenie.

Wymagania wstępne

Przed instalacją Claude Code potrzebne są trzy rzeczy:

Node.js w wersji 18 lub nowszej. Claude Code dostarczany jest jako pakiet npm³. Sprawdzenie wersji:

node --version
# v18.0.0 or higher

W przypadku konieczności instalacji lub aktualizacji Node.js można użyć narzędzia nvm lub pobrać bezpośrednio ze strony nodejs.org.

Konto Anthropic z dostępem do API. Klucz API tworzy się pod adresem console.anthropic.com w sekcji Settings > API Keys. Claude Code rozlicza się za tokeny w ramach salda API, alternatywnie można skorzystać z planu subskrypcji Max (100 USD/miesiąc indywidualnie, 200 USD/miesiąc dla zespołów według stanu na marzec 2026)⁶. Klucz należy zachować dostępny do etapu uwierzytelniania.

Terminal. Claude Code działa w dowolnym emulatorze terminala: Terminal.app, iTerm2, Windows Terminal, Alacritty lub zintegrowanym terminalu w VS Code. Zalecany jest terminal o szerokości co najmniej 120 kolumn, ponieważ Claude Code wyświetla diffy plików oraz wyjście narzędzi, które korzystają z przestrzeni poziomej.

Instalacja

Instalacja Claude Code globalnie przez npm:

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

Weryfikacja powodzenia instalacji:

claude --version

Powinien zostać wyświetlony numer wersji na stdout. W przypadku błędu „command not found” katalog globalnych binariów npm nie znajduje się w zmiennej PATH. Należy uruchomić npm config get prefix i dodać podkatalog /bin do zmiennej PATH powłoki. Na systemie macOS z Node zainstalowanym przez Homebrew prefiks to zazwyczaj /usr/local, zatem należy dodać /usr/local/bin, jeśli jeszcze tam nie występuje.

Typowy problem instalacyjny: W przypadku błędów uprawnień EACCES podczas npm install -g nie należy używać sudo. Zamiast tego warto skonfigurować npm tak, by używał katalogu zapisywalnego przez użytkownika⁷:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# Add to your shell profile (~/.zshrc or ~/.bashrc):
export PATH="$HOME/.npm-global/bin:$PATH"

Przy pierwszym uruchomieniu Claude Code otwiera przeglądarkę z konsolą Anthropic w celu uwierzytelnienia OAuth. Po zalogowaniu i autoryzacji Claude Code przechowuje token lokalnie w ~/.claude/. Alternatywnie można ustawić zmienną środowiskową ANTHROPIC_API_KEY przed uruchomieniem. W obu przypadkach dane uwierzytelniające pozostają na komputerze i służą do uwierzytelniania wyłącznie żą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 Claude wykonuje kilka czynności automatycznie:

1. Skanuje strukturę katalogów, aby zrozumieć układ projektu
2. Odczytuje pliki konfiguracyjne takie jak package.json, pyproject.toml czy Cargo.toml, aby zidentyfikować stos technologiczny
3. 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. Wywołania narzędzi widoczne są w czasie rzeczywistym (każdy odczyt pliku, każde wykonane polecenie) wraz z prośbą o pozwolenie przed jakąkolwiek operacją zapisu.

Na co zwrócić uwagę podczas pierwszej sesji. Warto zwrócić uwagę na dwie rzeczy: wywołania narzędzi (pokazywane w czasie rzeczywistym przed każdą akcją) oraz monity o uprawnienia. Wywołania narzędzi ujawniają, jak Claude nawiguje po bazie kodu. Można zauważyć, że odczytuje pliki, których samodzielnie można by nie sprawdzić, co często ujawnia przydatny kontekst. Monity o uprawnienia pokazują dokładnie, co Claude zamierza zmienić, zanim cokolwiek zostanie zapisane na dysku. Jeśli proponowana edycja wygląda błędnie, należy ją odrzucić i dostarczyć wyjaśnienie. Claude dostosowuje swoje podejście na podstawie informacji zwrotnej w ramach sesji⁸.

Konfiguracja pliku CLAUDE.md

CLAUDE.md to pojedynczy najważniejszy plik dla efektywnego korzystania z Claude Code. Bez niego Claude wnioskuje o stosie technologicznym na podstawie zawartości plików i formułuje rozsądne przypuszczenia. Z jego obecnością Claude stosuje dokładne konwencje od pierwszego promptu. Różnica ma znaczenie, ponieważ zachowanie oparte na wnioskowaniu dryfuje: Claude może użyć CommonJS w projekcie ESM, wybrać niewłaściwy runner testów lub zignorować przepływ migracji bazy danych. CLAUDE.md eliminuje ten dryf.

Utworzenie pliku w katalogu głównym projektu:

touch CLAUDE.md

Oto praktyczny szablon początkowy dla projektu Python:

# My App

## Project Context
FastAPI backend with HTMX frontend. PostgreSQL database.

## Stack
- Backend: Python 3.11, FastAPI, SQLAlchemy 2.0 (async)
- Frontend: HTMX + Alpine.js, Jinja2 templates
- Database: PostgreSQL 16, Alembic migrations
- Testing: pytest with pytest-asyncio

## Code Standards
- Type hints on all function signatures
- Pydantic v2 models for request/response validation
- Async database operations only (no sync SQLAlchemy)

## Commands
- `source venv/bin/activate` before any Python command
- `uvicorn app.main:app --reload` starts the dev server
- `python -m pytest -v` runs the test suite
- `alembic upgrade head` applies database migrations

Dla projektu JavaScript/TypeScript struktura wygląda podobnie:

# My App

## Stack
- Backend: Node.js 20, Express 4, TypeScript
- Frontend: React 18, Vite
- Database: PostgreSQL 16, Prisma ORM
- Testing: Vitest for unit, Playwright for e2e

## Code Standards
- ESM imports only (no require())
- 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

Najbardziej wartościowe sekcje CLAUDE.md to te, które zapobiegają powtarzającym się błędom. Jeśli Claude nadal importuje za pomocą require() zamiast import, warto dodać „ESM imports only” do Code Standards. Jeśli polecenie testowe wymaga wcześniejszej aktywacji virtualenv, należy udokumentować tę sekwencję. Claude odczytuje CLAUDE.md na początku każdej sesji, zatem każda linia staje się trwałą instrukcją, która kumuluje się przez setki interakcji. Wzorce sprawiające, że pliki CLAUDE.md są skuteczne, omawiam w AGENTS.md Patterns, a szerszą zasadę dotyczącą tego, jak context is architecture. Otwarta specyfikacja AGENTS.md⁹ stosuje podobny wzorzec dla innych narzędzi agentowych, jednak CLAUDE.md obsługuje bogatsze funkcje, takie jak katalogi skills i rules.

Hierarchia ma znaczenie. Plik CLAUDE.md można umieścić w trzech lokalizacjach, a Claude scala je w kolejności od najbardziej ogólnego do najbardziej specyficznego:

1. ~/.claude/CLAUDE.md: globalne instrukcje dla wszystkich projektów (osobiste preferencje kodowania)
2. ./CLAUDE.md: instrukcje na poziomie projektu (dodawane do repozytorium, współdzielone z zespołem)
3. ./src/CLAUDE.md: instrukcje na poziomie katalogu (ograniczone do modułu lub podsystemu monorepo)

CLAUDE.md na poziomie projektu to ten plik, który dodaje się do kontroli wersji. Członkowie zespołu korzystający z Claude Code dziedziczą konwencje automatycznie.

Podstawy uprawnień

Claude Code działa w trzech poziomach uprawnień⁴, które określają, jak dużą autonomię ma agent. Wybrany poziom kontroluje fundamentalny kompromis: większa autonomia oznacza szybsze sesje, ale mniejszą widoczność dokonywanych zmian.

Tryb Ask (domyślny) wymaga zatwierdzenia przed każdym zapisem pliku, wykonaniem polecenia lub czynnością destrukcyjną. Widać dokładnie, co Claude zamierza zrobić, i można zatwierdzić lub odrzucić każdy krok. Zaleca się rozpoczęcie od tego trybu, ponieważ monity o zatwierdzenie uczą, jak działa Claude Code. Po kilku sesjach rozwija się intuicja co do tego, które operacje można bezpiecznie zatwierdzić z wyprzedzeniem, a które zasługują za każdym razem na uważną analizę.

Uprawnienia z listy dozwolonych (Allowlisted) pozwalają na zatwierdzenie z wyprzedzeniem konkretnych narzędzi i wzorców, aby Claude nie pytał za każdym razem. Konfiguruje się je w pliku .claude/settings.json projektu:

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(python -m pytest*)",
      "Bash(alembic upgrade head)"
    ]
  }
}

Powyższa konfiguracja pozwala Claude odczytywać pliki, przeszukiwać bazę kodu oraz uruchamiać polecenia testowe i migracyjne bez pytania. Nadal pyta przed zapisem plików lub uruchomieniem dowolnych innych poleceń bash. Wzorzec jest następujący: operacje odczytu oraz polecenia znane jako bezpieczne trafiają na listę dozwolonych. Operacje zapisu pozostają w trybie Ask, ponieważ warto przeglądać to, co Claude zapisuje, zanim trafi to na dysk.

Niebezpieczne pominięcie uprawnień (--dangerously-skip-permissions) wyłącza wszystkie monity potwierdzające. Flaga istnieje wyłącznie dla potoków CI/CD oraz zautomatyzowanych przepływów pracy, gdzie nie ma człowieka do zatwierdzania. Nigdy nie należy jej używać w sesjach interaktywnych na bazie kodu, na której zależy użytkownikowi.

System uprawnień sprawia, że Claude Code jest bezpieczny w rzeczywistych projektach. Progresja jest zamierzona: zacząć w trybie Ask, aby zbudować zrozumienie, dodać do listy dozwolonych operacje, które stają się powtarzalne, i pozostawić zabezpieczenia operacji zapisu, aby zawsze przeglądać zmiany przed ich wprowadzeniem.

Pierwszy hook

Hooki to polecenia powłoki wykonywane w określonych punktach cyklu życia Claude Code⁵. Napisałem pełny hooks tutorial, który buduje pięć produkcyjnych hooków od zera, a mój wpis o building custom skills obejmuje następny poziom automatyzacji. Hooki rozwiązują fundamentalny problem narzędzi opartych na LLM: model przestrzega zasad formatowania przez większość czasu, ale „przez większość czasu” oznacza, że co dziesiąta edycja pliku wprowadza niespójność stylu. Hooki dostarczają gwarancji deterministycznych tam, gdzie model dostarcza probabilistycznych. Hook formatujący uruchamia formatter po każdym zapisie pliku, za każdym razem, niezależnie od tego, co zdecydował model. Oto praktyczny pierwszy hook: automatyczne formatowanie plików po edycjach dokonanych 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"
          }
        ]
      }
    ]
  }
}

Hook PostToolUse⁵ uruchamia się po każdym wywołaniu narzędzia Edit lub Write. Claude Code ustawia $FILE_PATH na ścieżkę zmodyfikowanego pliku. Prettier formatuje go w miejscu, a || true zapewnia, że niezerowy kod wyjścia nie zablokuje Claude, jeśli Prettier nie jest zainstalowany lub typ pliku nie jest obsługiwany⁵.

Inne praktyczne hooki początkowe, które polecam:

• PreToolUse na Bash: Blokowanie niebezpiecznych poleceń takich jak rm -rf / lub git push --force
• SessionStart: Wstrzykiwanie bieżącej 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, gdy Claude kończy zadanie

Hooki przekształcają Claude Code z narzędzia konwersacyjnego w zarządzane środowisko deweloperskie. Nawet jeden lub dwa dobrze dobrane hooki eliminują całe kategorie błędów.

Gdy coś pójdzie nie tak

Trzy sytuacje pojawiają się wielokrotnie w pierwszym tygodniu korzystania z Claude Code. Świadomość ich istnienia z wyprzedzeniem oszczędza czas debugowania.

Claude ignoruje instrukcje z CLAUDE.md. Najczęstsza przyczyna: Claude już odczytał plik i zapisał jego zrozumienie w pamięci podręcznej przed jego edycją. Należy uruchomić /clear, aby zresetować kontekst, lub rozpocząć nową sesję. Claude ponownie odczytuje CLAUDE.md na początku sesji, a nie przy każdym prompcie. Jeśli Claude nadal ignoruje instrukcje po świeżej sesji, warto sprawdzić, czy CLAUDE.md o wyższym priorytecie (na poziomie użytkownika w ~/.claude/CLAUDE.md) nie jest w konflikcie z plikiem na poziomie projektu.

Claude wprowadza zmianę, której użytkownik nie zatwierdził. Jeśli wzorzec został dodany do listy dozwolonych zbyt szeroko (np. Bash(*) zamiast Bash(python -m pytest*)), Claude może uruchamiać polecenia bez pytania. Należy zawęzić wzorce listy dozwolonych. Najbezpieczniejsze podejście: dodawać do listy dozwolonych jedynie operacje odczytu oraz konkretne nazwane polecenia. Jeśli Claude już wprowadził niechcianą zmianę, git diff pokaże dokładnie, co się zmieniło, a git checkout -- <file> cofa tę zmianę.

Okno kontekstu zapełnia się podczas długiej sesji. Claude Code kompresuje wcześniejsze wiadomości, gdy okno kontekstu 200K się zapełnia, ale kompresja może usunąć ważne szczegóły z wczesnej części rozmowy. W przypadku sesji dłuższych niż 30 minut warto okresowo commitować działające zmiany i rozpoczynać nową sesję poleceniem /clear. Świeży kontekst ponownie odczytuje CLAUDE.md i startuje czysto. Ja commituję po każdym ukończonym podzadaniu, co daje mi zarówno punkt wycofania, jak i naturalną granicę sesji.

Claude edytuje niewłaściwy plik lub wprowadza niepotrzebne zmiany. Gdy Claude zaczyna „ulepszać” kod, którego nie poproszono go o ruszanie, problem zwykle tkwi w niejednoznaczności promptu. Zamiast „clean up the auth module”, lepiej powiedzieć „in app/auth/handlers.py, rename verify_user to verify_user_credentials and update all callers”. Specyficzność zmniejsza niepożądane skutki uboczne. Jeśli Claude dokonał już niechcianych edycji, git diff pokaże dokładnie, co się zmieniło, a git checkout -- <file> przywraca poszczególne pliki bez utraty innej pracy.

Kolejne kroki

Powyższy przewodnik obejmuje podstawy: instalację, pierwszą sesję, konfigurację projektu, uprawnienia oraz hook początkowy. Dla porównania Claude Code z innymi narzędziami agentowymi zobacz Claude Code vs Codex. Dla pełnej referencji obejmującej wszystkie 5 podstawowych systemów (hierarchia CLAUDE.md, pełny model uprawnień, architektura hooków, niestandardowe polecenia slash oraz przepływy pracy wieloagentowe) zalecam lekturę The Complete Guide to Claude Code.

Ten przewodnik obejmuje zarządzanie oknem kontekstu, delegowanie do subagentów, automatyczną aktywację umiejętności oraz wzorce, które wyłaniają się po miesiącach codziennego korzystania z Claude Code. Jeśli ten szybki start okazał się użyteczny, pełny przewodnik stanowi naturalny kolejny krok. Dla szybkiej referencji każdego polecenia, flagi i skrótu zobacz Claude Code Cheat Sheet.

Źródła

FAQ

Jakie są wymagania, aby zainstalować Claude Code?

Potrzebny jest Node.js 18 lub nowszy (Claude Code dostarczany jest jako pakiet npm), konto Anthropic z dostępem do API lub subskrypcja Max oraz dowolny emulator terminala. Claude Code działa na macOS, Linux i Windows (przez WSL lub natywnie). Poza Node.js nie są wymagane żadne dodatkowe zależności, kontenery Docker ani środowiska uruchomieniowe języków. Polecenie instalacji to npm install -g @anthropic-ai/claude-code.

Czym jest CLAUDE.md i dlaczego jest potrzebny?

CLAUDE.md to plik w formacie markdown w katalogu głównym projektu, który informuje Claude Code o stosie technologicznym, konwencjach kodowania oraz typowych poleceniach. Bez niego Claude wnioskuje o konfiguracji z zawartości plików i formułuje rozsądne przypuszczenia — jednak te przypuszczenia dryfują między sesjami. Z plikiem CLAUDE.md Claude stosuje dokładne konwencje od pierwszego promptu, w każdej sesji. Plik obsługuje trójpoziomową hierarchię: na poziomie użytkownika (~/.claude/CLAUDE.md), na poziomie projektu (./CLAUDE.md) oraz na poziomie katalogu (./src/CLAUDE.md), scalane w kolejności od ogólnej do szczegółowej.

Ile kosztuje Claude Code?

Claude Code obsługuje dwa modele rozliczeniowe. Model API pay-as-you-go nalicza opłaty za tokeny według standardowych stawek API firmy Anthropic⁶. Typowa sesja trwająca 30–60 minut kosztuje 0,50–3,00 USD w zależności od rozmiaru bazy kodu oraz wolumenu generowania. Alternatywnie plan Max⁶ firmy Anthropic (100 USD/miesiąc indywidualnie, 200 USD/miesiąc dla zespołów według stanu na marzec 2026) obejmuje korzystanie z Claude Code z wyższymi limitami. Wykorzystanie API można monitorować pod adresem console.anthropic.com.

Czy można 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, jak w samodzielnym terminalu. Claude Code odczytuje i edytuje pliki na dysku, zatem zmiany pojawiają się natychmiast w kartach edytora VS Code. Nie jest wymagane osobne rozszerzenie dla VS Code. Niektórzy programiści utrzymują dedykowany podział terminala dla Claude Code obok edytora, co dobrze sprawdza się przy przeglądaniu zmian na bieżąco.

Czy Claude Code można bezpiecznie używać na produkcyjnych bazach kodu?

Tryb Ask narzędzia Claude Code wymaga jawnego zatwierdzenia 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, czyni Claude Code praktycznym do pracy produkcyjnej. Używam Claude Code codziennie w projektach obsługujących rzeczywistych użytkowników. Kluczem jest rozpoczęcie w trybie Ask, zrozumienie działania każdego wywołania narzędzia przed jego zatwierdzeniem oraz stopniowe dodawanie do listy dozwolonych jedynie tych operacji, którym się ufa. Kontrola wersji stanowi ostateczną siatkę bezpieczeństwa: warto commitować przed rozpoczęciem każdej znaczącej sesji Claude Code, aby zawsze móc cofnąć zmiany.

Jaki jest najczęstszy błąd popełniany przez nowych użytkowników?

Przekazywanie Claude zbyt wiele kontekstu w prompcie zamiast umieszczania go w CLAUDE.md. Nowi użytkownicy mają tendencję do wklejania całych standardów kodowania w każdy prompt, co marnuje przestrzeń okna kontekstu i prowadzi do niespójnych wyników między sesjami. Warto raz przenieść powtarzające się instrukcje do CLAUDE.md, a promptów używać do żądań specyficznych dla danej sesji. Drugim najczęstszym błędem jest dodawanie Bash(*) do listy dozwolonych zamiast konkretnych poleceń. Symbol wieloznaczny na liście dozwolonych dla Bash pozwala Claude uruchamiać dowolne polecenie powłoki bez pytania, co niweczy sens systemu uprawnień.