Claude Code jak zacząć, instalacja i pierwszy projekt 2026

Spis treści

• Co to jest Claude Code
• Wymagania
• Instalacja na macOS
• Instalacja na Linux
• Instalacja na Windows (WSL2)
• API key albo Claude Pro
• Pierwszy projekt
• Pierwszy custom slash command
• Plik CLAUDE.md
• 5 pierwszych pytań
• Co dalej
• FAQ

Aktualizacja: maj 2026. Ten przewodnik to najkrótsza droga od zera do działającej sesji Claude Code. Bez teorii, bez lania wody, bez zakładania że znasz angielską dokumentację. Idziemy: instalacja per OS, konfiguracja API key, pierwszy projekt hello-world, pierwszy custom slash command, plik CLAUDE.md. W 30 minut masz w terminalu agenta, który pisze za ciebie kod. Jedziemy.

Co to jest Claude Code

Claude Code to CLI od Anthropic, który zamienia terminal w interaktywnego agenta programistycznego. Mówisz po polsku albo angielsku, co ma zrobić, a Claude czyta kod, edytuje pliki, uruchamia komendy, pisze testy i commituje zmiany. Wszystko w twoim repo, na twoim komputerze, z twoimi narzędziami.

To nie jest inline-completion (jak GitHub Copilot, który podpowiada w trakcie pisania). To agent zorientowany zadaniowo: "zrefaktoruj cały moduł auth", "dodaj testy do tej funkcji", "znajdź skąd bierze się ten bug". Claude sam decyduje, jakie pliki przeczytać, co zmienić, co odpalić.

W maju 2026 Claude Code jest najbardziej dojrzałym agentem CLI na rynku (ahead Cursor CLI, Aider, Continue). Działa z modelem Claude Sonnet 4 albo Opus 4, ma własny system hooków, slash commands, MCP servers do integracji. Patrz kompletny tutorial jeśli chcesz głębszy deep dive.

Wymagania systemowe

Zanim cokolwiek zainstalujesz, sprawdź czy masz:

• System operacyjny: macOS 11+, Linux (Ubuntu 20.04+, Debian, Arch), Windows 10/11 z WSL2
• Node.js 18 lub nowszy (sprawdź: node --version), zalecane Node 20 LTS
• npm 9+ (sprawdź: npm --version)
• Terminal: dowolny (Terminal.app, iTerm2, Windows Terminal, Konsole, GNOME Terminal)
• Git (sprawdź: git --version), do diff/commit Claude'a
• Internet, Claude Code zawsze rozmawia z chmurą Anthropic, offline nie działa
• Konto Anthropic, na console.anthropic.com (darmowe założenie)

Nie potrzebujesz znać Python ani konkretnego frameworka. Podstawy bash (cd, ls, git) wystarczą. Jeśli nigdy nie pracowałeś z terminalem, najpierw 30 minut z dowolnym tutorialem "bash for beginners".

Instalacja na macOS

Na Macu najszybciej przez Homebrew (jeśli masz) plus npm.

Krok 1, zainstaluj Node 20 LTS:

# jeśli masz Homebrew
brew install node@20

# alternatywnie przez nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 20
nvm use 20

Krok 2, zainstaluj Claude Code globalnie:

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

Krok 3, zweryfikuj instalację:

claude --version
# powinno wyświetlić np. 1.2.3 (maj 2026)

Jeśli dostaniesz "command not found", sprawdź echo $PATH, czy zawiera ścieżkę npm global (zwykle /usr/local/bin albo ~/.npm-global/bin). W razie problemów: npm config get prefix i dodaj $(npm config get prefix)/bin do PATH w ~/.zshrc.

Instalacja na Linux

Na Ubuntu/Debian:

# Node 20 z NodeSource
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Claude Code
sudo npm install -g @anthropic-ai/claude-code

# weryfikacja
claude --version

Na Arch Linux:

sudo pacman -S nodejs npm
sudo npm install -g @anthropic-ai/claude-code
claude --version

Jeśli nie chcesz sudo npm globalnie (best practice), użyj nvm albo skonfiguruj npm prefix do user dir:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g @anthropic-ai/claude-code

Instalacja na Windows (WSL2)

Native Windows nie jest oficjalnie wspierany w maju 2026. Instalujesz WSL2 z Ubuntu i tam Claude Code. To brzmi groźnie, w praktyce 15 minut.

Krok 1, włącz WSL2 (PowerShell jako admin):

wsl --install -d Ubuntu-22.04
# restart komputera
# po restarcie WSL Ubuntu pyta o user/password

Krok 2, w Ubuntu (otwórz "Ubuntu" z menu Start):

# update
sudo apt update && sudo apt upgrade -y

# Node 20
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Claude Code
sudo npm install -g @anthropic-ai/claude-code
claude --version

Krok 3, otwórz projekt w VS Code z WSL extension:

# w Ubuntu shell
cd /mnt/c/Users/TwojaNazwa/projekty/moj-projekt
code .
# VS Code otworzy się z poprawnym WSL backend

Od tego momentu Claude Code działa z poziomu terminala VS Code (Ctrl+grawis) tak samo jak na Linuxie. Pliki dostępne też w Eksploratorze Windows pod \\wsl$\Ubuntu\home\twoj-user.

Konfiguracja, API key albo Claude Pro login

Masz dwie ścieżki. Wybierz jedną.

Opcja A, Claude Pro (rekomendowane na start)

Jeśli kupiłeś Claude Pro (20 USD/mc na claude.ai), zaloguj się przez OAuth:

claude login
# otworzy przeglądarkę, zaloguj się kontem Claude
# wróć do terminala, "Successfully logged in"

To wszystko. Claude Code używa twojego Pro limitu. Brak konfiguracji env vars, brak API key na dysku.

Opcja B, API key (pay-as-you-go)

Idź na console.anthropic.com, zaloguj się, sekcja "API Keys", "Create Key". Skopiuj klucz (zaczyna się od sk-ant-). Dodaj do shell:

# w ~/.zshrc albo ~/.bashrc
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxxxxxxxxx"

# przeładuj
source ~/.zshrc
# albo
source ~/.bashrc

Zweryfikuj: echo $ANTHROPIC_API_KEY powinno wyświetlić klucz. Claude Code automatycznie go wykryje przy starcie.

Bezpieczeństwo: nigdy nie commituj klucza do git. Dodaj .env do .gitignore. Najlepiej trzymaj klucz w ~/.zshrc (per-user), nie per-projekt.

Pierwszy projekt, hello-world

Zrobimy mały projekt Astro od zera, żeby zobaczyć Claude Code w akcji.

Krok 1, utwórz folder i zainicjuj projekt:

mkdir ~/claude-hello && cd ~/claude-hello
git init
echo "# Claude Hello World" > README.md
git add . && git commit -m "init"

Krok 2, odpal Claude Code:

claude
# Claude Code wyświetli welcome + pyta "What would you like to do?"

Krok 3, pierwszy prompt:

Stwórz prostą stronę w Astro z nagłówkiem "Hello from Claude Code"
i listą 3 punktów. Dodaj package.json i podstawową konfigurację Astro.

Claude napisze plan, poprosi o akceptację każdego pliku (Edit/Write), pokaże diff, ty zaakceptujesz lub odrzucisz. Po 1 do 2 minutach masz działający projekt. Uruchom:

npm install
npm run dev
# otwórz http://localhost:4321

Gratulacje, masz pierwsze hello-world wygenerowane przez Claude Code. Workflow który właśnie przeszedłeś (prompt, review, accept, run) to 80% codziennej pracy z Claude.

Pierwszy custom slash command (3 minuty)

Slash commands to skróty, które wpisujesz w sesji Claude jako /nazwa. Domyślne masz kilka (/help, /clear, /init), ale możesz dodawać własne.

Stwórz folder commands i pierwszy command "review":

mkdir -p .claude/commands
cat > .claude/commands/review.md << 'EOF'
# Code Review

Przeczytaj wszystkie zmiany w stosunku do branch main
(git diff main...HEAD) i napisz code review:

1. Bugi i security issues (top priority)
2. Code style i naming
3. Testy, czy są wystarczające
4. Performance concerns

Odpowiadaj po polsku. Bądź konkretny, podawaj linie kodu.
EOF

Teraz w sesji Claude Code wpisz:

/review

Claude wykona instrukcje z pliku. To samo co długi prompt, tylko 7 znaków zamiast 200. W realnym projekcie powinieneś mieć 5 do 15 slash commands (review, test, plan, refactor, audit, etc.).

Slash commands per-projekt są w .claude/commands/, globalne w ~/.claude/commands/. Per-projekt nadpisują globalne. Commituj .claude/commands/ do gita, dzielisz workflow z teamem.

Plik CLAUDE.md, jak go napisać

CLAUDE.md to plik konwencji projektu, który Claude czyta automatycznie na początku każdej sesji. Tam piszesz: jak wygląda twój stack, jakie są konwencje nazewnictwa, czego unikać, jak uruchamiać testy. To jest twoja "constitution" dla agenta.

Przykładowy CLAUDE.md:

# Projekt: kursvideoai.pl

## Stack
- Astro 5 + React islands + Tailwind 4
- Hosting: Vercel
- Domena: kursvideoai.pl

## Konwencje
- Komponenty Astro w src/components/, jeden plik = jeden komponent
- Komponenty React (islands) w src/components/, sufix .react.tsx
- Strony w src/pages/
- Stałe w src/lib/constants.ts (cały copy tutaj)
- Wszystkie style przez Tailwind classes, brak custom CSS poza globals
- Nie używaj em-dash, zamiast tego przecinek lub kropka

## Komendy
- Dev: npm run dev (port 4321)
- Build: npm run build
- Testy: npm test (Playwright)

## Czego NIE robić
- Nie modyfikuj package-lock.json ręcznie
- Nie commituj .env
- Nie dodawaj nowych dependencies bez zapytania
- Nie używaj GSAP/Lenis (usunięte z projektu)

## Persona
- Jeśli piszesz copy, target = przedsiębiorca chcący video AI
- Cena kursu: 249 zł (regular 399 zł)
- Bez gwarancji 30 dni (usunięto)

Zasady pisania CLAUDE.md: krótko (do 200 linii), konkretnie, bez lania wody. Każda linia ma być akcjonowalna. Aktualizuj gdy robisz duże zmiany w projekcie. Trzymaj w roocie repo, commituj do gita.

5 najczęstszych pierwszych pytań

1. Czy Claude widzi mój cały projekt?

Nie automatycznie. Claude na start widzi tylko CLAUDE.md i strukturę katalogów. Pliki czyta dopiero, gdy zapyta (przez tool Read). Context window jest ograniczony (200k tokenów dla Sonnet, około 500 stron tekstu), więc nie wczyta ci 1000-plikowego monorepo. Dla dużych projektów potrzebujesz strategii (np. pracuj per-katalog).

2. Czy mogę cofnąć zmiany Claude'a?

Tak. Każda edycja idzie przez git, więc git diff pokazuje co się zmieniło. git checkout . cofa wszystko. W trakcie sesji Claude przed każdą edycją pyta o akceptację (chyba że uruchomiłeś z flagą --auto-accept, co nie polecam na start).

3. Co jeśli Claude zrobi coś głupiego?

Odrzuć diff, napisz feedback "nie tak, popraw bo X". Claude poprawia. Dla powtarzających się problemów dodaj regułę do CLAUDE.md. Dla destrukcyjnych komend (rm -rf, drop database) skonfiguruj hooks, które blokują takie operacje.

4. Jakie modele wybrać?

Domyślnie Claude Code używa Sonnet (najlepszy balans cena/jakość). Dla najtrudniejszych zadań (algorithm design, deep refactor) przełącz na Opus przez /model opus. Opus jest 5x droższy ale ma lepszy reasoning. Dla prostego boilerplate Sonnet wystarczy.

5. Czy stracę kontrolę nad kodem?

Nie, jeśli używasz dobrego workflow: każdy commit czytasz, każdy diff reviewujesz, nie auto-acceptujesz. Claude to pair programmer, nie senior engineer. Ty jesteś code reviewerem. Trzymaj się tej zasady, a Claude Code zwiększy ci produktywność 2x do 5x bez utraty jakości.

Co dalej

Masz setup. Co teraz robić, żeby z amatora przejść do power usera:

• Claude Code tutorial po polsku, kompletny przewodnik, deeper dive w workflow
• Claude Code hooks po polsku, automatyzacja sesji, blokady, audit log
• Claude Code MCP Server po polsku, integracja z GitHub/Linear/PostgreSQL
• Claude Code vs Cursor, kiedy które narzędzie

Twój checklist startu

1. Sprawdź node --version (potrzebne 18+)
2. npm install -g @anthropic-ai/claude-code
3. claude --version jako weryfikacja
4. Załóż konto na console.anthropic.com lub kup Claude Pro
5. Skonfiguruj ANTHROPIC_API_KEY w ~/.zshrc lub claude login
6. cd do projektu, claude i pierwszy prompt
7. Dodaj CLAUDE.md z konwencjami projektu
8. Stwórz .claude/commands/review.md jako pierwszy slash command
9. Commit .claude/ do gita, podziel się z teamem
10. Wróć do hooks jak będziesz miał pierwszych 5 sesji za sobą

Najczęściej zadawane pytania

Powiązane artykuły

Claude Code•9 min

Claude Code cena 2026, ile kosztuje i czy jest darmowy

Claude Code cena w PLN i USD, plany Pro i Max, API pay-as-you-go, darmowe kredyty i alternatywy. Najtańsza legalna ścieżka. Stan maj 2026.

Czytaj

Claude Code•9 min

Claude Max plan po polsku, ceny i limity 2026

Plan Claude Max po polsku: ceny Max 5x i 20x, ile zapytań daje, Claude Pro vs Max, Max vs API. Limity sesji i tygodniowe. Stan maj 2026, dla kogo warto.

Czytaj

Claude Code•15 min

Claude Code Skills po polsku, tutorial Agent Skills 2026

Pierwszy polski tutorial Agent Skills w Claude Code. SKILL.md, frontmatter, progressive disclosure, jak tworzyć skille krok po kroku, vs subagents i MCP.

Czytaj