Instalacja i konfiguracja - krok po kroku

3 metody instalacji

Metoda 1: Native Installer (zalecana)

Nie wymaga Node.js. Automatycznie konfiguruje PATH.

macOS / Linux:

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

Windows:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Metoda 2: npm (wymaga Node.js 18+)

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

Weryfikacja: claude --version

Metoda 3: VS Code Extension

1. Otwórz VS Code → Ctrl+Shift+X (Windows/Linux) lub Cmd+Shift+X (Mac)
2. Wyszukaj "Claude Code" → Install

Rozszerzenie zapewnia: inline diffs, @-mentions, plan review, historia konwersacji.

Wymagania systemowe

OS	Wersja	Uwagi
macOS	10.15+ (Catalina)	Pełne wsparcie
Ubuntu	20.04+	Pełne wsparcie
Debian	10+	Pełne wsparcie
Windows	10+	Wymaga WSL 2 (zalecane), WSL 1 lub Git Bash

Windows: Claude Code działa przez WSL 2 (najlepsza kompatybilność) lub Git for Windows (Git Bash).

Autentykacja

OAuth (logowanie przez claude.ai) - zalecane

claude
# Przy pierwszym uruchomieniu otwiera przeglądarkę
# Logujesz się na konto claude.ai
# Autoryzacja wraca do terminala

Zalety: nie trzeba zarządzać kluczami API, używa limitu z subskrypcji (Pro/Max).

API Key

export ANTHROPIC_API_KEY="sk-ant-..."
claude

Lub interaktywnie: claude /login → wybierz "API Key" → wklej klucz.

Zalety: pay-per-use, pełna kontrola kosztów, idealne do CI/CD.

Pierwszy prompt

Po instalacji i autentykacji przejdź do katalogu swojego projektu:

cd ~/moj-projekt
claude

Claude Code otworzy interaktywną sesję. Wpisz:

Opisz strukturę tego projektu. Jakie technologie są użyte?

Claude przeanalizuje cały codebase i odpowie. To Twój pierwszy prompt w Claude Code.

Pro tip: Claude Code najlepiej działa w katalogu z repozytorium Git. Automatycznie rozpoznaje strukturę projektu, .gitignore i historię commitów.

Rozwiązywanie problemów - 6 typowych przypadków

1. "command not found: claude" → Zrestartuj terminal lub dodaj ręcznie do PATH:

source ~/.bashrc  # lub ~/.zshrc

2. "Node.js version too old" → Zainstaluj Node.js 18+: nvm install 18

3. Problemy z autentykacją OAuth → Spróbuj: claude /login → wybierz ponownie metodę logowania

4. Timeout podczas instalacji npm → Spróbuj: npm install -g @anthropic-ai/claude-code --registry https://registry.npmjs.org

5. Permission denied na macOS/Linux → Nie używaj sudo npm install -g. Zamiast tego skonfiguruj npm prefix lub użyj nvm.

6. Windows: "not recognized" → Upewnij się, że używasz WSL 2 lub Git Bash, nie PowerShell.

Ćwiczenie praktyczne: Zainstaluj Claude Code na swoim systemie:

1. Wybierz metodę instalacji (native installer lub npm)
2. Zainstaluj i zweryfikuj: claude --version
3. Zaloguj się: claude (OAuth) lub ustaw API key
4. Przejdź do dowolnego projektu z kodem
5. Uruchom: claude i wpisz "Opisz ten projekt"
6. Zapisz wynik - to Twój pierwszy prompt w Claude Code

Co dalej

W następnej lekcji skonfigurujesz CLAUDE.md - plik, który sprawia, że Claude Code rozumie Twój projekt.