Claude Code

Sprawdzone w Claude Code 2.1.283

Zweryfikowano 26 września 2026 r. na kanale latest; stable był wtedy na 2.1.274, więc funkcje z v2.1.280+ działają na razie tylko na latest. Brakuje funkcji? Uruchom claude --version i sprawdź changelog.

Claude Code to agentowe narzędzie do programowania od Anthropic: czyta repozytorium, uruchamia polecenia, edytuje pliki i sprawdza własną pracę — w terminalu, IDE, aplikacji desktopowej, przeglądarce albo CI. Od v2.1.280 (kanał latest) domyślnym modelem w płatnych planach i w API Anthropic jest Claude Opus 5.5 (domyślne modele u dostawców). O wiarygodności wyników decydują konfiguracja i bramki jakości repozytorium, nie model.

Ten przegląd jest dla programistów, którzy zaczynają pracę z Claude Code, i tech leadów, którzy go standaryzują. Zwykle agent już pierwszego dnia pisze działający kod, ale każda sesja od nowa odkrywa polecenia budowania, a ty dalej czytasz każdy diff.

Co daje ci ten przewodnik po Claude Code

• Pierwszą zmianę od worktree, przez plan tylko do odczytu, do zielonych bramek, tryb uprawnień dla każdego rodzaju sesji i warstwy weryfikacji, dzięki którym sprawdzasz dowody, a nie linijki.

Jak dostarczyć pierwszą zweryfikowaną zmianę w Claude Code?

Potrzebujesz repozytorium Git z czystym drzewem roboczym i krótkiej specyfikacji zacommitowanej w docs/specs/login-rate-limit.md; claude -w tworzy gałąź od domyślnej gałęzi zdalnej, więc ją też wypchnij, chyba że w kroku 3 ustawisz baseRef.

1. Zainstaluj Claude Code i uruchom go w katalogu głównym repozytorium (terminal):

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

2. Uruchom /init, żeby wygenerować CLAUDE.md, i popraw plik tak, żeby wymieniał dokładne polecenia typecheck, lint i testów.

3. Zacommituj poprawiony CLAUDE.md, a potem wypchnij go do domyślnej gałęzi albo ustaw "worktree": { "baseRef": "head" } w .claude/settings.json, żeby nowy worktree startował od bieżącego HEAD (kontrola wersji).

4. Otwórz sesję w nowym worktree Git od razu w trybie planowania, który proponuje, ale niczego nie edytuje: claude -w login-rate-limit --permission-mode plan. Wklej prompt planistyczny. Gdy pojawi się pytanie o zatwierdzenie planu, odrzuć je, bo po zatwierdzeniu Claude od razu zaczyna implementację. Kiedy plan jest gotowy, wyjdź z trybu planowania klawiszami Shift+Tab, poproś Claude’a, żeby zapisał plan w docs/plans/login-rate-limit.md i zacommitował go na gałęzi worktree, a potem wklej prompt implementacyjny.

5. Sprawdź listę poleceń i kody wyjścia z raportu końcowego promptu implementacyjnego, a potem uruchom /code-review --fix, żeby drugi raz przejrzeć diff. Zrób commit, wypchnij gałąź i otwórz PR; scalenie blokują wymagane kontrole i recenzent.

Prompt do wklejenia: plan przed jakąkolwiek edycją

Read CLAUDE.md and docs/specs/login-rate-limit.md, then inspect the code that handles POST /api/login.
Propose an implementation plan: the files you will change, the tests you will write first,
the commands that prove the change (typecheck, lint, unit, integration), the risks, and how to roll back.
Do not edit any file. Stop and wait for my approval.

Prompt do wklejenia: jeden kamień milowy i raport z dowodami

Implement milestone 1 of docs/plans/login-rate-limit.md and nothing else.
Write the failing tests first, then the code. Run every typecheck, lint and test command CLAUDE.md lists.
If a check fails, fix the implementation; never delete, skip or loosen a test.
Finish with: files changed, each command you ran with its exit status, and the risks you did not cover.

Jakiego trybu uprawnień używać w sesji Claude Code?

Tryby przełączasz klawiszami Shift+Tab albo flagą --permission-mode (wartości w 2.1.283: acceptEdits, auto, bypassPermissions, manual, dontAsk, plan).

Tryb	Kiedy go używać	Na co uważać
plan	Rozpoznanie i planowanie	Do implementacji zmień tryb
Manual (default)	Nieznane repozytoria, wszystko w pobliżu sekretów	Zmęczenie pytaniami: zatwierdzanie bez czytania
acceptEdits	Implementacja w worktree z testami	Edycje plików przestają wymagać zgody; rób commity często
auto	Tryb startowy interaktywnych sesji w terminalu i VS Code od v2.1.283 (latest); każdą akcję ocenia klasyfikator	claude -p, Agent SDK i nieobsługiwane modele (np. Haiku) startują w trybie Manual; ustawienia projektu nie mogą go włączyć
dontAsk	Skryptowe uruchomienia, w których każde narzędzie jest z góry dozwolone	Wszystko, czego nie ma w permissions.allow ani --allowedTools, jest odrzucane bez pytania
bypassPermissions	Wyłącznie jednorazowy sandbox z ograniczoną siecią	Nigdy w głównej kopii roboczej repozytorium ani z produkcyjnymi poświadczeniami

Skąd wiesz, że wynik Claude Code jest poprawny, bez czytania każdej linijki?

Ułóż kontrole warstwami, tak żeby każda egzekwowała to, o co poprzednia tylko prosi:

• CLAUDE.md wymienia bramki. Wyjaśnia, ale niczego nie egzekwuje (pamięć i CLAUDE.md).

• Hooki egzekwują. Hook może zablokować wywołanie narzędzia albo uruchomić formatter po każdej edycji, niezależnie od treści promptu.

• /code-review ponownie czyta diff (--fix lub --comment).

• CI powtarza bramki. Wymagane kontrole powtarzają bramki, a przegląd tylko do odczytu w trybie print dodaje drugą opinię:

  claude -p --permission-mode plan --output-format json \
    "Review the diff between origin/main and HEAD against docs/specs/login-rate-limit.md. Report only blocking findings, each with file, line, and the behaviour that fails."

• Człowiek zatwierdza na podstawie dowodów. Recenzent czyta pakiet dowodów, nie każdą linijkę (dlaczego dowody, a nie diffy).

Niezaufane pull requesty w CI

Nigdy nie uruchamiaj kodu kontrybutora w zadaniu, które ma dostęp do sekretu. Zaufane skrypty pobierz z domyślnej gałęzi, commit kontrybutora umieść w osobnym katalogu, który Claude tylko czyta, i dodaj --bare --setting-sources "" --strict-mcp-config, żeby hooki, .mcp.json i ustawienia kontrybutora nie mogły się uruchomić. Szczegóły: Claude Code w CI/CD.

Co psuje się najpierw, gdy wdrażasz Claude Code?

• Każda sesja uczy się repozytorium od nowa. Zostaw w CLAUDE.md tylko polecenia i reguły; długie procedury przenieś do skilli.
• Claude edytuje, zanim plan zostanie uzgodniony. Planuj w trybie plan już w worktree i zacommituj uzgodniony plan przed promptem implementacyjnym.
• Testy przechodzą, bo zostały osłabione. Diff testów przeglądaj jako pierwszy i dodaj kontrole z sekcji o wychwytywaniu osłabiania testów.
• Równoległe sesje wchodzą sobie w drogę. Jeden worktree na zadanie (claude -w) izoluje pliki, ale nie porty, bazy danych ani zasoby w chmurze.
• Limit użycia kończy się w połowie tygodnia. Sprawdź /usage i obniż wysiłek przez /effort, zanim zmienisz model (kontrola kosztów).

Gdzie co jest w przewodniku po Claude Code

Sekcja	Zajrzyj tam, gdy chcesz
Szybki start	Zainstalować, skonfigurować, podłączyć MCP
Planowanie	Przeanalizować kod, zaplanować funkcję
Budowanie	Prowadzić codzienną pętlę, zarządzać pamięcią
Testowanie i debugowanie	Prowadzić pętle red-green, debugować
Code review i wdrożenie	Zautomatyzować review, podłączyć CI/CD, wdrażać
Eksploatacja	Rozwiązywać problemy, kontrolować koszty
Automatyzacja	Pisać hooki, subagentów i skille
Zespół i firma	Współdzielić konfigurację, uruchamiać serwery proxy i bramy LLM (LLM gateway)
Materiały referencyjne	Sprawdzić changelog i kroki aktualizacji

Dokąd dalej z Claude Code

• Programiści: instalacja, potem funkcje, których jeszcze nie znasz.
• Tech leadzi: praca zespołowa i ścieżka tech leada.
• Łączenie narzędzi: Cursor i Claude Code i mapa narzędzi.