Claude Code tutorial po polsku, kompletny przewodnik 2026

Spis treści

• Czym jest Claude Code
• Claude Code vs Cursor vs Copilot
• Instalacja krok po kroku
• Konfiguracja API key i modeli
• Pierwszy projekt w Claude Code
• Plik CLAUDE.md, pamięć projektu
• Slash commands i custom skills
• Hooks, automatyzacja workflow
• MCP servers, rozszerzanie Claude
• Claude Agent SDK, własne agenty
• Koszty Anthropic API i jak je redukować
• Antywzorce, czego unikać
• Co dalej, plan nauki na 30 dni
• FAQ

Aktualizacja: maj 2026. Claude Code to oficjalne narzędzie CLI od Anthropic, które łączy moc modelu Claude (Opus 4.7, Sonnet 4.6, Haiku 4.5) z agentic loop, hooks, slash commands, MCP servers i Claude Agent SDK. W przeciwieństwie do GitHub Copilot (autocomplete) i Cursor (AI-first IDE), Claude Code działa jako CLI agent, który planuje i wykonuje wieloetapowe taski przy zachowaniu pełnego kontekstu projektu. W tym tutorialu pokazuję krok po kroku jak zacząć, jak skonfigurować workflow i jak nie przepalić budżetu w pierwszym tygodniu.

Czym jest Claude Code i dlaczego nie jest kolejnym Copilotem

Claude Code to interfejs CLI (command-line interface) wydany przez Anthropic na początku 2025 roku. Działa w terminalu, integruje się ze strukturą projektu, ma dostęp do plików i bash. W przeciwieństwie do narzędzi typu autocomplete (GitHub Copilot) i AI-first IDE (Cursor, Windsurf), Claude Code to agent, czyli system, który dostaje cel od użytkownika i sam planuje kroki potrzebne do jego realizacji.

Praktyczna różnica: zamiast wpisywać "wygeneruj funkcję sortującą", mówisz Claude Code "zrefaktoruj ten moduł na suspense + error boundary, dodaj testy, trzymaj backward compatibility". Claude analizuje pliki, robi plan w 3-5 kroków, edytuje wiele plików równolegle, uruchamia testy, weryfikuje, że nic się nie zepsuło, i robi commit. Wszystko w jednej sesji, ze spójnym kontekstem.

To różnica między narzędziem a kolegą. Copilot to lepsza klawiatura. Claude Code to junior developer z 200K context windowem i dostępem do całego stacka. W praktyce mojego workflow Claude Code wygrywa w 4 sytuacjach:

• Refactory wieloplikowe, gdzie trzeba zmienić sygnaturę funkcji i odbić w 20 miejscach
• Migracje stacku, np. z REST na GraphQL albo z Pages Router na App Router
• Bug investigation, gdy bug zachowuje się dziwnie i trzeba 5 prób żeby trafić w przyczynę
• Generowanie testów + dokumentacji, gdzie samo "więcej pisania niż myślenia" zajmuje 2-3h dziennie

Cursor i Copilot zostają silniejsze do "drobnych" zadań: szybki autocomplete, zamiana zmiennej, generowanie if-else. Pełne porównanie funkcji zrobiłem w Claude Code vs Cursor i Claude Code vs Copilot.

Claude Code vs Cursor vs GitHub Copilot, której używać

Trzy najpopularniejsze AI tools dla devów w 2026 nie są konkurentami, raczej warstwami stacka. Standardowy workflow seniora z mojej praktyki to równoległe użycie wszystkich trzech.

Decision matrix, kiedy używać którego narzędzia

Zadanie	Rekomendacja	Dlaczego
Autocomplete w edytorze	GitHub Copilot	Najszybsze sugestie inline, niski koszt
Chat z kontekstem pliku	Cursor (Composer)	Wbudowany w IDE, nie wymaga przełączania
Refactor wieloplikowy	Claude Code	Planuje, edytuje wiele plików, weryfikuje
Bug investigation w nieznanym repo	Claude Code	Agentic loop, czyta strukturę, formułuje hipotezy
Migracja legacy → modern	Claude Code	Wieloetapowy plan, atomic commits
Generowanie testów dla istniejącego kodu	Claude Code	Hooks + slash commands automatyzują workflow
Code review przed PR	Claude Code	Custom slash command, MCP do GitHub
Eksperymenty z nowymi API	Cursor lub Claude Code	Oba dobrze sobie radzą

W większości projektów używam Cursor jako głównego IDE z Copilotem włączonym do autocomplete, a Claude Code odpalam w drugim terminalu, gdy muszę zlecić zadanie agentic (refactor, debug, generation). Trzy narzędzia, trzy warstwy.

Instalacja Claude Code krok po kroku

Claude Code wspiera macOS, Linux i Windows (przez WSL2). Pełna instalacja zajmuje 5-10 minut.

macOS i Linux

Najszybsza ścieżka, instalator npm:

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

Jeśli używasz Homebrew, dostępna jest też wersja jako formula. W obu przypadkach polecenie claude staje się dostępne globalnie. Przy pierwszym uruchomieniu Claude poprosi o API key lub login do Claude Pro / Max.

Windows (WSL2 rekomendowane)

Najlepsze doświadczenie z Claude Code na Windowsie to przez WSL2 (Windows Subsystem for Linux). Powód: większość workflow Claude wymaga bashowych komend, a natywny terminal Windows zachowuje się odmiennie.

1. Otwórz PowerShell jako Admin, wpisz wsl --install
2. Po restarcie zaloguj się do Ubuntu (default distro)
3. W terminalu Ubuntu: curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
4. sudo apt-get install -y nodejs
5. npm install -g @anthropic-ai/claude-code
6. claude --version

Natywna instalacja na Windowsie (bez WSL) też istnieje przez ten sam npm install -g, ale rekomenduję WSL ze względu na spójność z resztą ekosystemu.

Konfiguracja API key i wybór modelu

Po instalacji Claude Code potrzebuje wiedzieć, czyim API kluczem ma się autoryzować. Dwie opcje:

1. Anthropic API key (rekomendowane dla pracy komercyjnej), kupujesz credits w console.anthropic.com, ustawiasz zmienną ANTHROPIC_API_KEY.
2. Claude Pro / Max subscription, logujesz się przez claude /login, używasz limitów z subskrypcji.

Dla developera komercyjnego rekomenduję pierwszą opcję, bo daje pełną kontrolę kosztów, dostęp do prompt cachingu i Batch API (oba dają -50% na fakturze). Subskrypcja jest dobra do nauki i hobby.

Konfiguracja jest globalna (per użytkownik) albo per-projekt w pliku .claude/settings.json. Przykład minimalny:

{
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": [
      "Bash(npm:*)",
      "Bash(git:*)",
      "Read(*)",
      "Edit(src/**)"
    ],
    "deny": [
      "Bash(rm -rf:*)"
    ]
  }
}

Który model wybrać

W 2026 Anthropic ma trzy główne modele rodziny Claude 4:

• Haiku 4.5, najtańszy, najszybszy. Do prostych zadań: format JSON, klasyfikacja, krótkie generowanie. ~$1/MTok input.
• Sonnet 4.6, default dla 80% pracy. Mocny w kodzie, refactor, debug. ~$3/MTok input.
• Opus 4.7, najmocniejszy. Złożone refactory, architektura, hard debug. ~$15/MTok input.

Realna strategia kosztowa w produkcji: 60% Sonnet (default), 30% Opus (gdy potrzeba głębi), 10% Haiku (batch jobs, klasyfikacja, format).

Twój pierwszy projekt w Claude Code

Najlepsza nauka to praktyka. Stwórzmy razem mini-projekt, prosta aplikacja TypeScript z testami.

mkdir hello-claude && cd hello-claude
git init
echo "node_modules" > .gitignore
claude

Po wpisaniu claude wchodzisz w interaktywną sesję. Daj Claude pierwszy task:

> Zainicjalizuj projekt TypeScript z testami Vitest.
> Stwórz funkcję capitalize(s: string): string która zwraca tekst z wielką pierwszą literą.
> Dodaj 5 testów pokrywających edge cases (empty string, single char, unicode).
> Zrób commit z opisem feat: capitalize util + tests.

Claude rozpisze plan, zapyta o ewentualne wątpliwości, wykona kroki: npm init, npm install -D vitest typescript @types/node, stworzy tsconfig.json, napisze funkcję, napisze testy, uruchomi npx vitest run, dopiero potem zrobi commit. Cała sesja, około 3 minuty.

Plik CLAUDE.md, pamięć projektu

Najważniejszy plik w projekcie z Claude Code to CLAUDE.md w root. To miejsce, gdzie opisujesz kontekst, którego Claude nie powinien zgadywać przy każdej sesji.

# Project: hello-claude

## Stack
- TypeScript 5.x, ESM modules only
- Vitest do testów, brak Jest
- Prettier z singleQuote: true, semi: false

## Conventions
- Funkcje czyste, bez side effects gdy to możliwe
- Naming kebab-case dla plików, camelCase dla funkcji
- Komentarze tylko dla nieoczywistego "dlaczego", nie "co"

## Workflow
- Każda zmiana = test + commit (atomic)
- Nigdy nie używaj 'any', wybierz dokładny typ
- Nie dodawaj zewnętrznych zależności bez potwierdzenia

Claude czyta CLAUDE.md na początku każdej sesji. Plik powinien być krótki (max 1-2 strony A4) i konkretny. To nie miejsce na dokumentację produktu, ale na zasady kolaboracji, których chcesz, żeby Claude trzymał się bez przypominania.

Slash commands i custom skills

Slash commands to predefiniowane prompty, które wywołujesz przez /nazwa. Claude Code ma kilka wbudowanych (/clear, /login, /model), ale prawdziwa moc to custom commands.

Stwórz plik .claude/commands/review.md:

---
description: Pełny code review nieskommitowanych zmian
---

Wykonaj pełny code review zmian, które są w git diff (uncommitted).

Sprawdź:
1. Konwencje nazewnicze (zgodne z CLAUDE.md)
2. Typowanie TypeScript (zero 'any')
3. Pokrycie testami nowego kodu
4. Brak hardcoded sekretów
5. Wpływ na performance (kompleksowość, allokacje)

Zwróć listę findings w 3 kategoriach:
- BLOCKER (musi być naprawione przed merge)
- WARNING (warto poprawić)
- NIT (kosmetyczna sugestia)

Od teraz w sesji Claude Code wpisujesz /review i Claude wykonuje pełny audit. Te same commands możesz mieć per projekt (w .claude/commands/) i globalnie (w ~/.claude/commands/).

Custom skills idą o krok dalej, to namespaced commandy z dodatkowymi plikami (Python scripts, dane, prompty), które Claude może wywołać. Pełny tutorial w nadchodzącym Claude Code skills po polsku (sprint 3 roadmapy).

Hooks, automatyzacja workflow

Hooki w Claude Code to programowalne triggery, które uruchamiają się w określonych momentach sesji. Pięć głównych typów:

• PreToolUse, przed użyciem narzędzia (np. blokuj rm -rf)
• PostToolUse, po użyciu (np. auto-format po Edit)
• UserPromptSubmit, gdy użytkownik wysyła prompt (np. dodawaj kontekst)
• Stop, na zakończenie sesji (np. uruchom testy)
• SessionStart, na początku sesji (np. ładuj env vars)

Przykład prostego hooka w .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "if echo \"$CLAUDE_TOOL_INPUT\" | grep -qE 'rm -rf|sudo rm'; then echo 'Blocked destructive command' && exit 1; fi"
          }
        ]
      }
    ]
  }
}

Pełny tutorial hooków, z 10 gotowymi przykładami i antywzorcami, jest w dedykowanym Claude Code hooks po polsku.

MCP servers, rozszerzanie Claude o własne narzędzia

Model Context Protocol (MCP) to standard otwarty Anthropic, który pozwala podłączyć Claude Code do zewnętrznych źródeł danych: bazy, GitHub, Linear, Notion, własnego API. Bez MCP musisz kopiować kontekst (np. schema bazy, ostatnie ticket'y, dokumentację) ręcznie. Z MCP Claude wywołuje to on-demand.

Przykład: chcesz, żeby Claude widział Twoje issue w Linear bez wklejania ich do prompta. Dodajesz do .claude/settings.json:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@linear/mcp-server"],
      "env": {
        "LINEAR_API_KEY": "lin_api_xxx"
      }
    }
  }
}

Od teraz w sesji Claude masz dostępne narzędzia linear_search_issues, linear_create_issue itd. Claude sam decyduje, kiedy ich użyć w trakcie zadania.

Pełny tutorial MCP, z architekturą, budową własnego servera w Pythonie i Node, security i deploymentem, jest w Claude Code MCP Server po polsku (sprint 2 roadmapy).

Claude Agent SDK, budowa własnych agentów

Claude Agent SDK (Python + TypeScript) to biblioteki, które pozwalają zbudować własnego agenta, czyli skrypt, który dostaje cel i sam planuje + wykonuje kroki. To podstawa automatyzacji, którą puszczasz na CI albo cronie.

Przykład w TypeScript, prosty agent który robi triage GitHub issues:

import { query } from "@anthropic-ai/claude-agent-sdk";

const result = await query({
  prompt: "Sprawdź nowe issues w repo X. Te z słowem 'crash' tag jako P0. Reszta P2.",
  options: {
    model: "claude-sonnet-4-6",
    allowedTools: ["mcp__github__list_issues", "mcp__github__update_issue"],
  },
});

for await (const message of result) {
  console.log(message);
}

Agent działa autonomicznie, podejmuje decyzje, wywołuje narzędzia. Pełny tutorial w Claude Agent SDK po polsku (sprint 2).

Koszty Anthropic API i jak je redukować

Główny powód, dla którego devsi rezygnują z Claude Code po pierwszym miesiącu, to nieprzewidywalna faktura. Bez optymalizacji bill rośnie do $200-500/miesiąc dla średnio intensywnego użytkowania. Z optymalizacją: $50-150/miesiąc przy tej samej intensywności.

Ceny modeli Claude 4 (2026)

Model	Input ($/MTok)	Output ($/MTok)	Use case
Haiku 4.5	$1	$5	Klasyfikacja, format, batch
Sonnet 4.6	$3	$15	80% pracy w kodzie
Opus 4.7	$15	$75	Złożone refactory, architektura

Trzy techniki, które redukują bill o 50-80%:

1. Prompt caching, jeśli powtarzasz ten sam system prompt (np. CLAUDE.md), Anthropic cache'uje go i liczy 90% off za odczyty. Dla mocnego CLAUDE.md (2000 tokens) to oszczędność $0.01 na każde wywołanie, miesięcznie kilkadziesiąt dolarów.
2. Batch API, dla zadań które mogą czekać 24h (generowanie dokumentacji, masowe code review, klasyfikacja). 50% off na wszystkie tokeny.
3. Wybór modelu, default Sonnet, ale przesuwaj prostsze taski na Haiku (np. format JSON, klasyfikacja), a tylko ciężkie na Opus.

Pełny artykuł o prompt cachingu w nadchodzącym Prompt caching Anthropic po polsku (sprint 4).

Antywzorce, czego unikać w Claude Code

Po roku pracy z Claude Code w komercyjnych projektach widzę 5 błędów, które ludzie powtarzają.

1. Brak CLAUDE.md, Claude zgaduje konwencje, robi inne stylistyczne wybory niż reszta zespołu, każda sesja zaczyna od briefingu od zera. CLAUDE.md to jeden plik, 30 minut pisania, godziny zaoszczędzone.
2. Promptowanie bez planu, "popraw ten bug" zamiast "popraw ten bug, ale najpierw rozpisz 3 hipotezy, wybierz najmniej kosztowną do weryfikacji". Im konkretniejszy prompt z metodologią, tym lepszy wynik.
3. Brak hooków, każdy projekt zaczynasz od zera. Te same checks, lint, format, deny destructive bash, są wszędzie potrzebne. .claude/settings.json z 5 hookami to godzina raz, oszczędność godzin tygodniowo.
4. Default Opus do wszystkiego, Opus 4.7 jest 5× droższy niż Sonnet 4.6 i 15× droższy niż Haiku 4.5. Większość zadań nie wymaga Opusa. Default Sonnet, Opus tylko gdy Sonnet zawodzi.
5. Brak MCP, dużo kopiowania, jeśli Claude potrzebuje schemy bazy, ostatnich issues, dokumentacji wewnętrznej, lepiej raz zbudować MCP server, niż 100 razy wklejać kontekst. Inwestycja w MCP zwraca się w 2-3 tygodnie.

Co dalej, plan nauki Claude Code na 30 dni

Jeśli przeczytałeś do tego momentu, masz fundament. Kompletny plan 30-dniowy z mojej praktyki:

• Tydzień 1, fundamenty: instalacja, CLAUDE.md, pierwsze 3 projekty, slash commands
• Tydzień 2, automatyzacja: hooks, MCP servers (1-2 instalacje), cost optimization
• Tydzień 3, customization: custom skills, własny MCP server, plugins
• Tydzień 4, agenty: Claude Agent SDK, pierwszy autonomiczny agent, deployment na cron

Jeśli chcesz to wszystko ułożone w jednym PDF, z 50+ gotowymi promptami, 10 hookami template, 3 MCP serverami starter kit i 5 projektami portfolio, to dokładnie to oferuje Kurs Claude Code po polsku (220 stron PDF, 349 zł brutto, dożywotni dostęp).

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