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: wrzesień 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ć.

Claude Code to jeden z najdojrzalszych agentów CLI na rynku (obok Codex CLI, Gemini CLI, Aider). We wrześniu 2026 działa z modelami Sonnet 5, Opus 5.5 i Haiku 4.5, 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 13+, Linux (m.in. Ubuntu 20.04+, Debian 10+, Alpine 3.19+), Windows 10 1809+ (natywnie albo w WSL)
• Sprzęt: 4 GB+ RAM, procesor x64 albo ARM64
• Node.js potrzebny tylko przy instalacji przez npm (wtedy Node 22+); natywny instalator go nie wymaga
• 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: płatny plan Claude (Pro, Max, Team, Enterprise) albo konto Console z API; darmowy plan claude.ai nie daje dostępu do Claude Code

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

Oficjalnie rekomendowana ścieżka to natywny instalator. Nie potrzebujesz do niego Node.js, a Claude Code sam aktualizuje się w tle.

Krok 1, zainstaluj Claude Code:

curl -fsSL https://claude.ai/install.sh | bash

Alternatywnie przez Homebrew (bez automatycznych aktualizacji, aktualizujesz ręcznie brew upgrade claude-code):

brew install --cask claude-code

Krok 2, zweryfikuj instalację:

claude --version
# wyświetli numer wersji, np. 2.1.x (Claude Code)
claude doctor
# diagnostyka instalacji i ustawień

Jeśli dostaniesz "command not found", sprawdź, czy ~/.local/bin jest w PATH (tam natywny instalator kładzie polecenie claude), i otwórz nowe okno terminala.

Instalacja na Linux

Na Ubuntu, Debianie i innych dystrybucjach ta sama komenda:

curl -fsSL https://claude.ai/install.sh | bash

# weryfikacja
claude --version

Anthropic publikuje też podpisane repozytoria apt, dnf i apk, jeśli wolisz systemowy menedżer pakietów (wtedy aktualizacje idą przez apt upgrade itd.). Instalacja przez npm (npm install -g @anthropic-ai/claude-code) nadal działa, ale od v2.1.198 wymaga Node.js 22+, a dokumentacja wprost odradza sudo npm install -g.

Instalacja na Windows

Claude Code działa na Windows 10 1809+ natywnie albo w WSL. Natywnie instalujesz go z PowerShella, bez uprawnień administratora:

irm https://claude.ai/install.ps1 | iex

Warto doinstalować Git for Windows: wtedy Claude Code używa Git Bash do komend powłoki, a bez niego korzysta z PowerShella.

Wariant WSL (gdy pracujesz z linuksowym toolchainem albo chcesz sandboxingu komend, którego natywny Windows nie obsługuje). Krok 1, włącz WSL (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):

curl -fsSL https://claude.ai/install.sh | bash
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), po prostu uruchom Claude Code i zaloguj się w przeglądarce:

claude
# przy pierwszym starcie otworzy przeglądarkę, zaloguj się kontem Claude
# w terminalu zobaczysz "Login successful", Enter i gotowe
# później: /login ponownie loguje, /logout wylogowuje

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. Przy starcie Claude Code raz zapyta, czy użyć tego klucza, i zapamięta wybór.

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ł jednorazowo, bez skreślonej ceny
- 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). Okno kontekstu jest duże (do 1M tokenów w aktualnych modelach), ale nie bez końca, więc i tak nie wczyta ci 1000-plikowego monorepo w całości. 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 przełączyłeś tryb na acceptEdits przez Shift+Tab albo --permission-mode acceptEdits, czego 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ć?

Na start najlepszy balans cena/jakość daje Sonnet (/model sonnet). Dla najtrudniejszych zadań (algorithm design, deep refactor) przełącz na Opus przez /model opus. Opus 5.5 w API jest 2x droższy od Sonnet 5, 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. Zainstaluj: curl -fsSL https://claude.ai/install.sh | bash (Windows: irm https://claude.ai/install.ps1 | iex)
2. claude --version jako weryfikacja
3. Kup Claude Pro albo załóż konto Console z API
4. Zaloguj się w przeglądarce przy pierwszym claude albo ustaw ANTHROPIC_API_KEY w ~/.zshrc
5. cd do projektu, claude i pierwszy prompt
6. Dodaj CLAUDE.md z konwencjami projektu
7. Stwórz .claude/commands/review.md jako pierwszy slash command
8. Commit .claude/ do gita, podziel się z teamem
9. Wróć do hooks jak będziesz miał pierwszych 5 sesji za sobą

Najczęściej zadawane pytania

Powiązane artykuły

Claude Code•12 min

Claude Code cena 2026: cennik w zł i czy jest darmowy

Ile kosztuje Claude Code: Pro 20 USD (ok. 78 zł), Max 100 i 200 USD, API od kilku dolarów. Czy jest darmowy, co dostajesz za 0 zł i co wybrać przy jakim użyciu.

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