Claude Code: Instalacja, konfiguracja i pierwsze kroki

Instalacja Claude Code zajmuje dosłownie jedną linijkę w terminalu. Konfiguracja pierwszego projektu – kolejne dwie minuty. A potem zaczyna się prawdziwa zabawa.

Ten poradnik przeprowadzi Cię przez cały proces: od instalacji, przez pierwsze logowanie, po uruchomienie pierwszego zadania. Na końcu będziesz wiedział, jak skonfigurować Claude Code pod specyfikę swojego projektu.

Wymagania systemowe
Instalacja krok po kroku
Pierwsze uruchomienie i logowanie
Konfiguracja CLAUDE.md
Podstawowe komendy
Rozwiązywanie problemów

## Wymagania systemowe

Zanim zaczniesz, upewnij się że Twój system spełnia wymagania:

Wymagania systemowe Claude Code

Komponent	Minimalne wymagania
System operacyjny	macOS 13+, Windows 10 1809+, Ubuntu 20.04+, Debian 10+
RAM	4 GB lub więcej
Sieć	Stałe połączenie z internetem
Shell	Bash, Zsh, PowerShell lub CMD
Konto	Claude Pro/Max/Teams/Enterprise lub Console

Uwaga dla Windows: Wymagany jest Git for Windows. Zainstaluj go przed Claude Code.

Uwaga o subskrypcji: Darmowy plan Claude.ai nie obejmuje Claude Code. Potrzebujesz płatnej subskrypcji (od 20 USD/mies.) lub konta Console z przedpłaconymi kredytami.

Instalacja krok po kroku

Claude Code oferuje trzy metody instalacji. Wybierz tę, która pasuje do Twojego systemu.

Metoda 1: Natywna instalacja (zalecana)

Dla macOS, Linux i WSL:

bash

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

Dla Windows PowerShell:

powershell

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

Dla Windows CMD:

batch

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

Natywna instalacja automatycznie aktualizuje się w tle. Nie musisz pamiętać o ręcznych aktualizacjach.

Metoda 2: Homebrew (macOS)

bash

brew install --cask claude-code

Instalacje przez Homebrew nie aktualizują się automatycznie. Uruchamiaj brew upgrade claude-code okresowo.

Metoda 3: WinGet (Windows)

powershell

winget install Anthropic.ClaudeCode

Podobnie jak Homebrew – wymaga ręcznych aktualizacji przez winget upgrade Anthropic.ClaudeCode.

Po instalacji sprawdź wersję poleceniem claude --version. Jeśli chcesz pełną diagnostykę instalacji, użyj claude doctor.

## Pierwsze uruchomienie i logowanie

Po instalacji otwórz terminal w katalogu swojego projektu i uruchom:

bash

cd /sciezka/do/projektu
claude

Przy pierwszym uruchomieniu zobaczysz ekran powitalny i prośbę o logowanie. Claude Code otworzy przeglądarkę, gdzie zalogujesz się na swoje konto Anthropic.

Po zalogowaniu Twoje dane uwierzytelniające są zapisywane lokalnie. Następnym razem Claude Code uruchomi się bez pytania o hasło.

Pierwszy kontakt z projektem

Gdy Claude Code się uruchomi, zacznij od poznania projektu:

co robi ten projekt?

Claude przeanalizuje pliki i poda podsumowanie. Możesz też zadać bardziej szczegółowe pytania:

jakie technologie używa ten projekt?

gdzie jest główny punkt wejścia?

wyjaśnij strukturę katalogów

Claude Code czyta pliki projektu w miarę potrzeby. Nie musisz ręcznie dodawać kontekstu.

## Konfiguracja CLAUDE.md

Plik CLAUDE.md to instrukcja dla agenta. Umieść go w głównym katalogu projektu, a Claude Code będzie go czytał przy każdej sesji.

Co warto tam wpisać:

Polecenia do budowania i testowania projektu
Konwencje nazewnictwa i stylu kodu
Architektura i kluczowe decyzje projektowe
Typowe pułapki i rzeczy, których unikać

Przykład dla projektu Next.js:

markdown

# Konwencje projektu

## Build i testy
- `npm run dev` - serwer deweloperski
- `npm test` - testy jednostkowe
- `npm run lint` - sprawdzenie stylu

## Styl kodu
- Używamy TypeScript strict mode
- Komponenty w PascalCase, funkcje w camelCase
- Każdy komponent ma plik .test.tsx

## Architektura
- /app - routing Next.js 14
- /components - komponenty UI
- /lib - logika biznesowa
- /hooks - custom hooks

Claude Code ma też funkcję auto-memory – automatycznie zapisuje wzorce i preferencje, które odkrywa podczas pracy. Nie musisz wszystkiego wpisywać ręcznie.

Więcej o konfiguracji agentów AI znajdziesz w artykule Co to jest OpenClaw? – OpenClaw używa podobnego systemu plików konfiguracyjnych.

## Podstawowe komendy

Najważniejsze komendy Claude Code

Komenda	Działanie	Przykład
claude	Uruchom tryb interaktywny	claude
claude "zadanie"	Wykonaj jednorazowe zadanie	claude "napraw błąd buildu"
claude -c	Kontynuuj ostatnią rozmowę	claude -c
claude -r	Wznów wybraną rozmowę	claude -r
/clear	Wyczyść historię rozmowy	/clear
/help	Pokaż dostępne komendy	/help
exit lub Ctrl+C	Wyjdź z Claude Code	exit

Przydatne skróty klawiszowe:

? – pokaż wszystkie skróty
Tab – autouzupełnianie komend
↑ – historia poleceń
/ – pokaż wszystkie komendy i skills

## Rozwiązywanie problemów

Claude Code nie uruchamia się

Sprawdź czy masz zainstalowany Git for Windows (na Windows) lub czy Twoja wersja systemu spełnia wymagania. Uruchom claude doctor dla pełnej diagnostyki.

Błędy logowania

Upewnij się, że masz aktywną subskrypcję Claude Pro/Max/Teams/Enterprise. Darmowy plan nie obejmuje Claude Code. Możesz też użyć konta Console z przedpłaconymi kredytami.

Problemy z wyszukiwaniem plików

Claude Code używa ripgrep do wyszukiwania. Jeśli wyszukiwanie nie działa, sprawdź czy ripgrep jest zainstalowany w systemie.

Aktualizacja nie działa

Przy instalacji przez Homebrew lub WinGet aktualizacje są ręczne. Użyj brew upgrade claude-code lub winget upgrade Anthropic.ClaudeCode.

Jeśli nadal masz problemy, uruchom claude doctor – to narzędzie diagnostyczne sprawdzi konfigurację i wskaże potencjalne problemy.

Podsumowanie

Claude Code jest gotowy do pracy w kilka minut. Instalacja to jedna linijka, logowanie to jedno kliknięcie w przeglądarce, a konfiguracja projektu to opcjonalny plik CLAUDE.md.

Jeśli szukasz więcej informacji o możliwościach Claude Code, przeczytaj poprzedni wpis z serii: Claude Code od Anthropic: Co potrafi AI, które samo koduje.

Dla alternatywnego podejścia do agentów AI – open-source i działającego lokalnie – sprawdź Agentic AI: przyszłość automatyzacji.

Umów się na szkolenie z AI