gik|iewicz

Arpan Patel opublikował na swoim blogu kompleksowy przewodnik po Claude Code – narzędziu, które zmienia sposób pracy programistów. Ten tekst to nie kolejny poradnik „jak napisać prompt”, lecz zbiór praktycznych technik konfiguracyjnych i wzorców workflow. Jednak,

TL;DR: Arpan Patel przygotował przewodnik „Beyond the Prompt: Claude Code” opisujący konfigurację katalogu .claude, pliki CLAUDE.md, system Skills, subagentów, pluginów oraz komend /goal i /insights. Materiał zawiera wzorce workflow stosowane przez zespół Anthropic, a także praktyczne przykłady integracji z MCP i edytorami kodu. PONADTO,

Jakie 7 technik Claude Code opisuje Arpan Patel?

Przewodnik Arpana Patela skupia się na konfiguracji środowiska pracy, która pozwala lepiej wykorzystać możliwości Claude Code. Patel opisuje konkretne mechanizmy – od struktury katalogu .claude, przez pliki konfiguracyjne, aż po zaawansowane wzorce workflow. Materiał bazuje na doświadczeniach twórców Claude Code zebranych w wywiadach i dokumentacji Anthropic. dlatego,

Pierwszą techniką jest odpowiednia organizacja katalogu .claude, który przechowuje wszystkie pliki konfiguracyjne narzędzia. Druga dotyczy tworzenia pliku CLAUDE.md według wzorca, który stosuje Boris Cherny – twórca Claude Code. Trzecia technika to wykorzystanie CLAUDE.local.md do przechowywania konfiguracji specyficznej dla lokalnego środowiska. zatem,

Kolejne techniki obejmują system Skills z przykładami, tworzenie własnych subagentów, integrację pluginów oraz wykorzystanie rzadziej używanych komend takich jak /goal i /insights. Patel opisuje również wzorce workflow, które zespół Anthropic stosuje na co dzień. choć,

Czym jest katalog .claude i jak go skonfigurować?

Katalog .claude to centralne miejsce przechowywania konfiguracji Claude Code w projekcie. Zawiera pliki określające zachowanie narzędzia, preferencje kodowania oraz instrukcje specyficzne dla danego repozytorium. Struktura ta pozwala na spójną konfigurację w całym zespole.

Wewnątrz katalogu znajdują się m.in. pliki CLAUDE.md (główny plik konfiguracyjny), CLAUDE.local.md (konfiguracja lokalna, niecommitowana do repozytorium) oraz definicje Skills i subagentów. Ponadto katalog może zawierać pliki MCP (Model Context Protocol) definiujące integracje z zewnętrznymi narzędziami.

Konfiguracja katalogu .claude wymaga zrozumienia hierarchii plików i ich przeznaczenia. Na przykład CLAUDE.md powinien zawierać ogólne zasady projektu, natomiast CLAUDE.local.md – preferencje dewelopera, takie jak styl formatowania czy ulubione biblioteki.

Warto sprawdzić strukturę katalogu przed rozpoczęciem pracy z nowym projektem. Ułatwia to późniejsze dodawanie reguł i modyfikowanie zachowania Claude Code bez konieczności zmiany kodu.

Jak napisać CLAUDE.md według wzorca Borysa Cherny’ego?

Boris Cherny – twórca Claude Code – w wywiadzie dla Platformer opowiada o podejściu do konfiguracji narzędzia. Jego wzorzec CLAUDE.md opiera się na jasnych, zwięzłych instrukcjach, które kierują zachowaniem modelu bez niepotrzebnego rozszerzania kontekstu.

Plik CLAUDE.md powinien zawierać sekcje określające: stos technologiczny projektu, konwencje nazewnictwa, preferowane wzorce architektoniczne oraz zasady testowania. Cherny zaleca unikanie ogólników – zamiast „pisz czysty kod” lepiej napisać „używaj TypeScript strict mode, unikaj any, preferuj composables nad mixins”.

Struktura pliku według Cherny’ego:

• Stos technologiczny – konkretne wersje frameworków i bibliotek
• Konwencje kodu – zasady formatowania, lintingu, nazewnictwa
• Architektura – wzorce projektowe, struktura katalogów
• Testowanie – frameworki, pokrycie, preferowane podejście
• Zakazane praktyki – antywzorce specyficzne dla projektu
• Zależności – jakie pakiety używać, jakich unikać
• Workflow – proces review, branchowanie, CI/CD
• Kontekst biznesowy – domena, specyfika branży

Do czego służy CLAUDE.local.md?

Plik CLAUDE.local.md przechowuje konfigurację specyficzną dla lokalnego środowiska dewelopera. Nie jest commitowany do repozytorium – znajduje się w .gitignore. Pozwala każdemu członkowi zespołu dostosować Claude Code do własnych preferencji bez wpływu na konfigurację zespołową.

Typowe zawartości CLAUDE.local.md to: ścieżki do lokalnych narzędzi, preferencje edytora, aliasy używane w danym środowisku oraz tymczasowe instrukcje eksperymentalne. Patel podkreśla, że ten plik jest idealnym miejscem na iteracyjne testowanie nowych instrukcji przed przeniesieniem ich do głównego CLAUDE.md.

Wzorzec ten jest szczególnie przydatny w zespołach, gdzie deweloperzy pracują na różnych systemach operacyjnych lub z różnymi narzędziami. Na przykład jeden członek zespołu może używać macOS z Homebrew, podczas gdy inny pracuje na Ubuntu z apt – CLAUDE.local.md pozwala uwzględnić te różnice.

Podobne podejście do konfiguracji lokalnej opisuje dokumentacja na blogu gikiewicz.eu, gdzie znajdziesz przegląd funkcji Claude Code.

Czym są Skills w Claude Code i jak je tworzyć?

Skills to mechanizm Claude Code pozwalający na definiowanie wielokrotnie używalnych sekwencji instrukcji. Działają podobnie do funkcji w programowaniu – przyjmują parametry, wykonują określoną logikę i zwracają wynik. Patel opisuje je jako „receptury” dla powtarzalnych zadań programistycznych.

Każdy Skill składa się z nazwy, opisu, parametrów oraz sekwencji kroków do wykonania. Na przykład Skill „create-api-endpoint” może przyjmować parametry: nazwa zasobu, metoda HTTP, schemat bazy danych – a następnie generować kompletne endpointy z walidacją, testami i dokumentacją.

Przykłady Skills opisane przez Patela:

• generate-crud – tworzenie pełnego CRUD dla zasobu
• write-migration – generowanie migracji bazy danych
• add-test-suite – dodawanie zestawu testów dla modułu
• refactor-component – refaktoryzacja komponentu z zachowaniem zachowania
• create-docs – generowanie dokumentacji API
• setup-ci – konfiguracja pipeline CI/CD
• lint-fix – automatyczne naprawianie problemów lintingowych
• security-audit – skanowanie kodu pod kątem podatności

Tworzenie Skills wymaga zdefiniowania jasnych granic odpowiedzialności. Dobry Skill robi jedną rzecz dobrze, zamiast wielu rzeczy średnio. Patel zaleca testowanie Skills na różnych scenariuszach przed dodaniem ich do projektu.

Warto porównać to podejście z Claude Code /ultraplan, gdzie znajdziesz informacje o planowaniu zadań z Claude Code.

Jak tworzyć własnych subagentów w Claude Code?

Subageni to wyspecjalizowane instancje Claude Code wykonujące konkretne zadania w ramach głównego workflow. Arpan Patel opisuje ich architekturę – każdy subagent otrzymuje własny kontekst instrukcji, oddzielny od głównego CLAUDE.md. Dzięki temu można budować wieloagentowe systemy, gdzie jeden agent pisze kod, inny przeprowadza review, a kolejny generuje testy.

Patel podkreśla, że subageni sprawdzają się w scenariuszach wymagających separacji odpowiedzialności. Na przykład agent „security-reviewer” może analizować kod pod kątem podatności, nie mając dostępu do instrukcji agenta „feature-developer”. To zapobiega konfliktom kontekstu.

W praktyce subageni konfiguruje się w katalogu .claude/subagents/. Każdy subagent ma swój plik definicji z instrukcjami, dozwolonymi narzędziami oraz ograniczeniami. Patel zaleca, aby każdy subagent miał jedną odpowiedzialność.

Konfiguracja subagentów według Patela:

• feature-dev – tworzenie nowych funkcjonalności
• test-writer – generowanie testów jednostkowych i integracyjnych
• code-reviewer – przegląd kodu pod kątem jakości
• security-scanner – wyszukiwanie podatności w kodzie
• docs-generator – tworzenie dokumentacji technicznej
• refactor-agent – refaktoryzacja z zachowaniem zachowania
• migration-helper – asystent migracji bazy danych
• debugging-assistant – pomoc w diagnozowaniu błędów

Zarządzanie subagentami wymaga uwzględnienia kosztów tokenów. Każdy subagent uruchamia osobną sesję, co zwiększa zużycie API. Patel zaleca monitorowanie użycia przez komendę /costs.

Jakie pluginy rozszerzają możliwości Claude Code?

Anthropic opublikował security-guidance plugin dla Claude Code, który wykrywa 25 niebezpiecznych wzorców kodu w czasie rzeczywistym (Crypto Briefing, 2025). To przykład pluginu, który działa bezpośrednio w terminalu, oznaczając podatności, zanim trafią do repozytorium. Patel opisuje ten plugin jako jeden z najważniejszych elementów ekosystemu Claude Code.

Pluginy instaluje się przez katalog .claude/plugins/. Każdy plugin może modyfikować zachowanie Claude Code – od dodawania nowych komend, przez integrację z zewnętrznymi usługami, aż po modyfikację odpowiedzi modelu.

Anthropic rozwija pluginy jako warstwę rozszerzeń, która nie wymaga modyfikacji kodu Claude Code. Zewnętrzni deweloperzy mogą tworzyć własne pluginy, podobnie jak w ekosystemie VS Code.

Przykłady pluginów opisane przez Patela:

• security-guidance – skanowanie 25 wzorców podatności w czasie rzeczywistym
• linter-integration – łączenie Claude Code z konfiguracją ESLint/Prettier
• git-hooks – automatyzacja commitów i pre-push checks
• database-helper – asystent zapytań SQL z walidacją schematu

Instalacja pluginu polega na dodaniu jego konfiguracji do katalogu .claude/plugins/ i zrestartowaniu sesji. Niektóre pluginy wymagają dodatkowych zależności.

Więcej o aktualizacjach Claude Code znajdziesz w Dziennik zmian – Dokumentacja Claude Code.

Czym są komendy /goal i /insights?

Komendy /goal i /insights to rzadko używane funkcje Claude Code, które Patel opisuje jako „ukryte supermoce”. Komenda /goal pozwala zdefiniować cel sesji – na przykład „zaimplementuj autoryzację OAuth2” – a Claude Code trzyma się tego celu przez całą konwersację, unikając dygresji.

Z kolei /insights generuje podsumowanie tego, czego Claude Code dowiedział się o projekcie podczas sesji. To przydatne przy długich konwersacjach, gdzie model gromadzi kontekst o architekturze, zależnościach i wzorcach kodu. Insights można eksportować do CLAUDE.md.

Patel zaleca stosowanie /goal na początku każdej sesji roboczej. To skraca czas potrzebny na osiągnięcie wyniku, ponieważ model nie traci kontekstu na nieistotne zadania. Komenda /insights najlepiej sprawdza się pod koniec sesji.

Przykłady zastosowań komend:

• /goal implement-user-auth – sesja skupiona na autoryzacji
• /goal fix-memory-leak – diagnoza i naprawa wycieków pamięci
• /goal add-payment-webhook – integracja z systemem płatności
• /insights – eksport wiedzy o projekcie

Komendy te są dostępne domyślnie, ale wielu użytkowników o nich nie wie. Patel uważa, że /goal powinien być standardem w każdym workflow.

Jak MCP integruje Claude Code z zewnętrznymi narzędziami?

Model Context Protocol (MCP) to protokół łączący Claude Code z zewnętrznymi narzędziami – bazami danych, API, systemami plików. Patel opisuje MCP jako warstwę komunikacji, która pozwala modelowi czytać dokumentację, odpytywać bazy danych i wywoływać endpointy bez opuszczania terminala.

Konfiguracja MCP wymaga dodania pliku mcp.json do katalogu .claude/. Plik definiuje dostępne serwery MCP, ich parametry połączenia oraz dozwolone operacje. Patel podaje przykłady integracji z PostgreSQL, GitHub API i systemem plików.

MCP rozszerza możliwości Claude Code poza generowanie kodu. Dzięki temu model może sprawdzać status CI/CD, czytać logi produkcyjne, a nawet zarządzać tickietami w Jirze. Patel nazywa to „kontekstem bez granic”.

Przykładowe integracje MCP z przewodnika:

• PostgreSQL – odpytywanie bazy i analiza schematu
• GitHub – zarządzanie PR, issues i review
• Filesystem – czytanie i zapis plików poza projektem
• Slack – wysyłanie powiadomień o statusie zadań
• Jira – tworzenie i aktualizacja tickietów
• Docker – zarządzanie kontenerami lokalnymi
• Redis – inspekcja cache i sesji
• AWS S3 – odczyt i zapis obiektów

Więcej o integracjach terminalowych znajdziesz w Claude Code Companion: Jak sterować Claude Code z Telegrama?.

Jakie wzorce workflow stosuje zespół Anthropic?

Zespół Anthropic stosuje wzorce workflow opisane przez Borysa Cherny’ego w wywiadzie dla Platformer. Cherny opisuje podejście „plan-execute-verify”, gdzie Claude Code najpierw planuje zmiany, potem je realizuje, a na koniec weryfikuje wyniki przez testy.

Patel dodaje, że zespół Anthropic używa Claude Code w cyklu iteracyjnym. Każda zmiana kodu przechodzi przez fazę planowania z komendą /goal, realizacji z subagentami, i weryfikacji z pluginem security-guidance. Ten cykl powtarza się do osiągnięcia celu.

Cherny radzi 22-letnim absolwentom informatyki, aby zakładali startupy, nazywając obecną epokę „złotym wiekiem” (Business Insider, 2025). To wskazuje, że Claude Code jest projektowany z myślą o małych, zwrotnych zespołach.

Wzorce workflow Anthropic:

• Plan-execute-verify – główny cykl pracy z Claude Code
• Goal-first – każda sesja zaczyna się od /goal
• Subagent delegation – delegowanie zadań do wyspecjalizowanych agentów
• Continuous security – skanowanie podatności po każdej zmianie
• Insight harvesting – zapisywanie wiedzy z sesji przez /insights

Porównanie podejść workflow:

Więcej o planowaniu zadań z Claude Code znajdziesz w claude code /ultraplan.

Często zadawane pytania

Ile kosztuje używanie Claude Code z subagentami?

Każdy subagent uruchamia osobną sesję API, co oznacza, że zużycie tokenów rośnie proporcjonalnie do liczby aktywnych subagentów – Patel zaleca monitorowanie kosztów przez komendę /costs i ograniczenie do 2-3 subagentów na sesję.

Czy plugin security-guidance zastępuje audyt bezpieczeństwa?

Plugin security-guidance wykrywa 25 niebezpiecznych wzorców kodu w czasie rzeczywistym (Crypto Briefing, 2025), ale nie zastępuje pełnego audytu – stanowi warstwę ochronną podczas developmentu, nie narzędzie compliance.

Jak często aktualizuje się plik CLAUDE.md?

Plik CLAUDE.md aktualizuje się przy każdej zmianie architektury lub stosu technologicznego projektu – Patel zaleca dodawanie nowych reguł po każdej sesji z użyciem /insights, aby gromadzić wiedzę iteracyjnie.

Czy MCP wymaga dodatkowej infrastruktury?

MCP wymaga uruchomienia serwerów pośredniczących dla każdego integrowanego narzędzia – konfiguracja PostgreSQL MCP to dodanie connection stringa do mcp.json, natomiast GitHub MCP wymaga tokenu dostępu z odpowiednimi uprawnieniami.

Podsumowanie

Przewodnik Arpana Patela pokazuje, że efektywne korzystanie z Claude Code wykracza poza pisanie promptów. Kluczowe elementy to konfiguracja katalogu .claude, pliki CLAUDE.md i CLAUDE.local.md, system Skills, subagenci, pluginy, komendy /goal i /insights, integracje MCP oraz wzorce workflow zespołu Anthropic.

Główne wnioski:

• Katalog .claude to centralne miejsce konfiguracji – zorganizuj go według wzorca Borysa Cherny’ego
• Plik CLAUDE.md powinien zawierać konkretne instrukcje, bez ogólników
• Skills i subagenci pozwalają automatyzować powtarzalne zadania programistyczne
• Plugin security-guidance wykrywa 25 wzorców podatności w czasie rzeczywistym
• Komendy /goal i /insights to rzadko używane funkcje, które znacznie przyspieszają pracę

Pełny przewodnik Patela znajdziesz na jego blogu. Więcej materiałów o Claude Code publikuję na gikiewicz.eu – tam znajdziesz przegląd funkcji narzędzia, porównania z alternatywami i praktyczne poradniki konfiguracyjne.