← Wróć do bloga

Pierwsze kroki z Claude Code — instalacja, konfiguracja i pierwsze komendy

Claude Code to agentyczne narzędzie programistyczne od Anthropic, które działa bezpośrednio w Twoim terminalu. Rozumie strukturę projektu, pisze i edytuje kod, uruchamia polecenia, obsługuje Git — i robi to wszystko na podstawie poleceń w języku naturalnym. W tym poradniku przeprowadzę Cię krok po kroku przez instalację, konfigurację i pierwsze użycie Claude Code na polskim rynku.

---

📑 Spis treści

1. Czym jest Claude Code i czym różni się od Claude.ai?
2. Wymagania systemowe i plany cenowe
3. Instalacja krok po kroku (macOS, Windows, Linux)
4. Autoryzacja i wybór metody płatności
5. Konfiguracja — CLAUDE.md, ustawienia, MCP
6. Pierwsze komendy — co wpisać w terminalu
7. Integracja z VS Code i JetBrains
8. Narzędzia i zasoby przydatne na polskim rynku
9. Najczęstsze problemy i FAQ

---

1. Czym jest Claude Code i czym różni się od Claude.ai?

Claude Code to narzędzie CLI (Command Line Interface), które uruchamiasz w terminalu — nie w przeglądarce. Podczas gdy Claude.ai to chatbot do rozmów i analizy dokumentów, Claude Code jest agentem programistycznym, który:

• Czyta i rozumie cały Twój projekt — analizuje strukturę plików, zależności, konfigurację
• Edytuje pliki bezpośrednio — pisze kod, poprawia błędy, refaktoryzuje
• Uruchamia polecenia w terminalu — testy, build, linting, deploy
• Obsługuje Git — commituje, tworzy pull requesty, analizuje historię zmian
• Pracuje z kontekstem do 200K tokenów — potrafi analizować jednocześnie dziesiątki plików

Kluczowa różnica?

Twoje pliki zostają na Twoim komputerze. Claude Code nie kopiuje kodu na żaden serwer — wykonuje operacje lokalnie, a do chmury wysyła jedynie zapytania do modelu AI. To ważne, jeśli pracujesz z kodem klientów lub wewnętrznymi projektami firmowymi.

2. Wymagania systemowe i plany cenowe

Wymagania systemowe

Claude Code działa na trzech platformach:

• macOS — natywny instalator (zalecane) lub Homebrew
• Windows — natywny instalator (PowerShell lub CMD) albo WSL
• Linux — natywny instalator (Ubuntu, Debian, Fedora i inne)

Natywny instalator nie wymaga Node.js — to samodzielny plik binarny. Jedynie starsza metoda instalacji przez npm wymaga Node.js 18+.

Plany cenowe (kwiecień 2026)

Claude Code nie jest darmowy. Potrzebujesz co najmniej planu Pro. Oto aktualne opcje:

Plan	Cena (USD/mies.)	Cena (PLN ~)	Claude Code	Dla kogo
Free	$0	0 zł	❌ Brak dostępu	—
Pro	$20	~80 zł	✅ Tak	Początkujący, nauka, małe projekty
Max 5x	$100	~400 zł	✅ Tak + Opus	Programiści pracujący 4-6h dziennie
Max 20x	$200	~800 zł	✅ Tak + Opus	Full-time, duże projekty, agenci
API	Pay-per-use	Zmienny	✅ Tak	Automatyzacja, CI/CD, zmienne obciążenie

Moja rekomendacja na start: zacznij od planu Pro za $20/mies. Jeśli już płacisz za Claude.ai Pro, masz dostęp do Claude Code w ramach tej samej subskrypcji — nie płacisz nic extra.

3. Instalacja krok po kroku

Anthropic oferuje natywne instalatory jako zalecaną metodę. Jedna komenda — bez zależności, bez Node.js.

macOS

Otwórz Terminal (Cmd + Spacja → wpisz „Terminal”) i wklej:

curl -fsSL https://cli.claude.com/install.sh | sh

Alternatywnie przez Homebrew:

brew install claude-code

Windows

Opcja 1: Natywna instalacja (zalecane)

Otwórz PowerShell (wyszukaj „PowerShell” w menu Start) i wklej:

irm https://cli.claude.com/install.ps1 | iex

Jeśli używasz CMD zamiast PowerShell:

curl -fsSL https://cli.claude.com/install.bat | cmd

Opcja 2: Przez WinGet

winget install Anthropic.ClaudeCode

Opcja 3: WSL (Windows Subsystem for Linux) — otwórz terminal WSL i użyj komendy linuxowej powyżej.

Linux (Ubuntu / Debian / Fedora)

curl -fsSL https://cli.claude.com/install.sh | sh

Sprawdź, czy instalacja się powiodła

Po instalacji wpisz w terminalu:

claude --version

Jeśli widzisz numer wersji (np. 1.0.xx) — wszystko działa. Jeśli terminal mówi „command not found”, zamknij go i otwórz ponownie — PATH musi się odświeżyć.

4. Autoryzacja i wybór metody płatności

Po zainstalowaniu przejdź do katalogu swojego projektu i uruchom Claude Code:

cd ~/moj-projekt
claude

Przy pierwszym uruchomieniu pojawi się proces autoryzacji. Masz dwie opcje:

Opcja A: Subskrypcja (Pro / Max) — zalecane

1. Claude Code otworzy przeglądarkę z ekranem logowania
2. Zaloguj się na swoje konto Claude (to samo co na claude.ai)
3. Zatwierdź autoryzację OAuth
4. Wróć do terminala — Claude Code jest gotowy

Claude Code korzysta z tego samego limitu tokenów co Twój chat na claude.ai — to jeden wspólny pool.

Opcja B: Klucz API (pay-per-use)

1. Wejdź na console.anthropic.com
2. Utwórz konto i dodaj metodę płatności (karta Revolut / Wise działa)
3. Przejdź do sekcji API Keys → wygeneruj nowy klucz (zaczyna się od sk-)
4. Ustaw zmienną środowiskową w terminalu:

# Dodaj do ~/.bashrc lub ~/.zshrc żeby działało na stałe
export ANTHROPIC_API_KEY="sk-ant-twoj-klucz-tutaj"

5. Konfiguracja — CLAUDE.md, ustawienia, MCP

Plik CLAUDE.md — kontekst dla projektu

Stwórz plik CLAUDE.md w katalogu głównym projektu. To „briefing”, który Claude Code czyta przy każdym uruchomieniu. Przykład:

# CLAUDE.md

## Projekt
Aplikacja e-commerce dla polskiego rynku (sklep z odzieżą).

## Stack technologiczny
- Framework: Next.js 14 (App Router)
- Język: TypeScript (strict mode)
- Styl: Tailwind CSS v3
- Baza danych: PostgreSQL via Prisma
- Płatności: Przelewy24, BLIK (integracja pay-by-link)
- Hosting: Vercel (frontend) + Railway (backend)

## Konwencje
- Używaj named exports, nie default exports
- Komunikaty commitów po angielsku (conventional commits)
- Komentarze w kodzie po angielsku
- Testy: Vitest + React Testing Library
- Nazwy zmiennych: camelCase, komponenty: PascalCase

## Ważne
- NIE modyfikuj plików w prisma/migrations/ bezpośrednio
- NIE instaluj nowych zależności bez informowania
- Zawsze uruchom `pnpm lint` przed zakończeniem zadania
- Waluty w PLN, format: 1 234,56 zł

Dlaczego to takie ważne?

Bez CLAUDE.md Claude Code zgaduje kontekst projektu. Z nim — zna Twój stack, konwencje i ograniczenia od pierwszej komendy. Im lepszy briefing, tym lepsze wyniki.

Plik .claudeignore — co wykluczyć

Analogicznie do .gitignore, stwórz .claudeignore żeby Claude Code nie czytał niepotrzebnych plików:

# .claudeignore
node_modules/
.next/
dist/
*.lock
.env
.env.local
coverage/
*.log

To zmniejsza ryzyko odczytania wrażliwych danych (klucze API w .env) i utrzymuje okno kontekstowe na ważnych plikach.

Globalne ustawienia

Wpisz w terminalu /settings podczas sesji Claude Code lub edytuj plik ~/.claude/settings.json:

{
  "permissions": {
    "allow": ["Read", "Write", "Bash(git *)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

To pozwala kontrolować, jakie operacje Claude Code może wykonywać bez pytania o zgodę.

6. Pierwsze komendy — co wpisać w terminalu

Po uruchomieniu claude w katalogu projektu jesteś w trybie interaktywnym. Oto komendy na dobry start:

Poznaj swój projekt

> Przeanalizuj strukturę tego projektu i opisz, co robi każdy główny katalog

> Znajdź wszystkie pliki konfiguracyjne i podsumuj ustawienia projektu

> Jakie zależności ma ten projekt? Czy któreś są przestarzałe?

Pisz kod

> Dodaj nowy endpoint API /api/products z paginacją i filtrowaniem po kategorii

> Stwórz komponent React do formularza kontaktowego z walidacją (react-hook-form + zod)

> Napisz middleware sprawdzający nagłówek Authorization z tokenem JWT

Testuj i naprawiaj

> Uruchom testy i napraw te, które nie przechodzą

> Przejrzyj moje ostatnie zmiany i zasugeruj poprawki

> Znajdź potencjalne problemy z bezpieczeństwem w tym projekcie

Git i workflow

> Podsumuj zmiany od ostatniego commita i zaproponuj commit message

> Stwórz nowy branch feature/user-auth i zaimplementuj rejestrację użytkownika

> Przejrzyj różnice między develop a main i przygotuj release notes

Przydatne komendy slash

Komenda	Co robi
/help	Wyświetla listę dostępnych komend
/compact	Kompresuje historię konwersacji (oszczędza tokeny)
/clear	Czyści historię konwersacji
/settings	Otwiera ustawienia
/bug	Zgłasza błąd do Anthropic
/doctor	Diagnostyka — sprawdza konfigurację
Ctrl+C	Przerywa bieżące zadanie
Ctrl+D	Kończy sesję Claude Code

7. Integracja z VS Code i JetBrains

Claude Code działa natywnie w terminalu, ale możesz go zintegrować z edytorem kodu, którego używasz na co dzień.

VS Code

1. Zainstaluj rozszerzenie Claude Code z VS Code Marketplace
2. Otwórz terminal w VS Code (Ctrl + `) i wpisz claude
3. Claude Code automatycznie wykryje projekt otwarty w edytorze

Możesz też uruchomić Claude Code z panelu bocznego — rozszerzenie dodaje dedykowany widok w sidebarze.

JetBrains (IntelliJ, WebStorm, PHPStorm, PyCharm)

Zainstaluj plugin Claude Code z JetBrains Marketplace. Działa analogicznie — panel boczny z interaktywną sesją zintegrowaną z Twoim projektem.

Aplikacja desktopowa

Jeśli nie chcesz używać terminala, Anthropic oferuje Claude Code Desktop — graficzny interfejs dostępny na macOS i Windows. Pobierzesz go ze strony code.claude.com.

8. Narzędzia i zasoby przydatne na polskim rynku

Claude Code nie żyje w próżni. Oto ekosystem narzędzi, które warto znać jako polski developer:

Płatności i konfiguracja konta

• Revolut / Wise / ZEN — karty wielowalutowe do płatności w USD bez prowizji za przewalutowanie. Revolut jest najpopularniejszy w Polsce i oferuje kurs międzybankowy
• Fakturowanie: Anthropic wystawia faktury w USD. Dla polskiej firmy (B2B) to import usług — rozliczasz VAT w ramach odwrotnego obciążenia (reverse charge). Skonsultuj się z biurem rachunkowym w kwestii PKWiU

Hosting i infrastruktura

• Vercel / Netlify — deploy frontendowy (Next.js, Nuxt). Claude Code potrafi generować konfiguracje deploymentu
• Railway / Render — backend i bazy danych. Serwery w Europie (Frankfurt), niska latencja z Polski
• OVH / Hetzner — VPS-y w Europie, popularne wśród polskich devów. Możesz uruchamiać Claude Code na zdalnym serwerze przez SSH
• mikr.us — polskie tanie VPS-y (od 29 zł/rok) do eksperymentów i małych projektów

Polskie integracje, które Claude Code obsłuży

• Przelewy24 / PayU / Stripe (PL) — Claude Code potrafi wygenerować integrację płatności z tymi bramkami. Wystarczy podać dokumentację API
• InPost / DPD / Poczta Polska API — generowanie integracji z API kurierów do systemów e-commerce
• GUS REGON API / KRS — walidacja NIP, pobieranie danych firm. Claude Code napisze klienta API w kilka minut
• JPK / e-Faktura (KSeF) — generowanie struktur XML zgodnych z polskimi wymogami podatkowymi

Społeczność i nauka

• Discord „Polski AI Dev” — polska społeczność programistów korzystających z narzędzi AI
• just-join.it / No Fluff Jobs — oferty pracy, gdzie znajomość narzędzi AI (w tym Claude Code) jest wymieniana jako atut
• Dokumentacja Anthropic — docs.claude.com (po angielsku, ale Claude Code rozumie polecenia po polsku)

9. Najczęstsze problemy i FAQ

„command not found” po instalacji

Zamknij terminal i otwórz go ponownie. Instalator dodaje Claude Code do PATH, ale wymaga to odświeżenia sesji. Jeśli problem nie znika, sprawdź ścieżkę ręcznie: which claude (macOS/Linux) lub where claude (Windows).

Czy mogę pisać polecenia po polsku?

Tak. Claude Code rozumie polski. Możesz pisać „dodaj walidację formularza” zamiast „add form validation”. Jednak komendy slash (/help, /compact) pozostają po angielsku.

Czy moje dane są bezpieczne?

Pliki zostają na Twoim komputerze. Do serwerów Anthropic wysyłane są jedynie fragmenty kodu potrzebne do wygenerowania odpowiedzi — nie cały projekt. Mimo to, nie powinieneś używać Claude Code na plikach zawierających dane osobowe (RODO) bez wcześniejszej analizy prawnej.

Limit tokenów — co robić, gdy się skończą?

Na planie Pro/Max limity resetują się co 5 godzin. Użyj komendy /compact żeby skompresować historię konwersacji i zwolnić tokeny. Możesz też włączyć „extra usage” w ustawieniach konta — płacisz wtedy za nadwyżkę po stawkach API.

Czy Claude Code nadaje się do WordPressa / PHP?

Tak. Claude Code obsługuje PHP, WordPress, WooCommerce, Laravel i inne frameworki PHP. Potrafi edytować szablony, pisać wtyczki, debugować i optymalizować zapytania do bazy danych.

---

Podsumowanie

Claude Code to potężny asystent programistyczny, który po kilku minutach konfiguracji staje się Twoim codziennym narzędziem pracy. Oto najważniejsze kroki na start:

1. Zainstaluj natywnym instalatorem (jedna komenda)
2. Autoryzuj się kontem Claude Pro/Max lub kluczem API
3. Stwórz plik CLAUDE.md z kontekstem projektu
4. Dodaj .claudeignore żeby chronić wrażliwe dane
5. Wpisz claude w terminalu i zacznij wydawać polecenia po polsku
6. Płać kartą wielowalutową (Revolut/Wise) żeby oszczędzić na kursie

Zacznij od prostych zadań — analiza projektu, generowanie testów, automatyzacja commitów — i stopniowo przechodź do bardziej zaawansowanych operacji.

---

---

Ostatnia aktualizacja: 21 kwietnia 2026 · Czas czytania: 12 min · Kategoria: Narzędzia AI, Programowanie · Tagi: Claude Code, Anthropic, AI dla programistów, terminal, instalacja, konfiguracja