gik|iewicz

Firma Anthropic dodała do Claude Code kilkanaście mechanizmów, które zmieniają sposób pracy z kodem. Plik CLAUDE.md, umiejętności, subagenty, wtyczki, MCP – to składowe ekosystemu, który warto poznać.

TL;DR: Claude Code oferuje konfigurowalny ekosystem narzędzi: plik CLAUDE.md przechowuje kontekst projektu, umiejętności automatyzują powtarzalne zadania, subagenty pozwalają na delegowanie pracy, wtyczki rozszerzają funkcjonalność, a MCP standardizuje komunikację z zewnętrznymi serwerami. Zrozumienie tych mechanizmów pozwala na efektywniejszą codzienną pracę.

Jak działa plik CLAUDE.md i dlaczego jest fundamentem konfiguracji?

Plik CLAUDE.md to centralny punkt konfiguracji każdego projektu w Claude Code. Zgodnie z dokumentacją, działa jak plik .cursorrules znany z Cursor – definiuje zasady, konwencje i kontekst, które Claude stosuje podczas sesji. Moim zdaniem to najważniejszy element całego ekosystemu, ponieważ bez odpowiedniego kontekstu nawet najlepszy model generuje niepotrzebny kod.

Andrej Karpathy zidentyfikował cztery główne problemy Claude Code i zbudował plik CLAUDE.md, który je rozwiązuje. Jego zasady to: Think Before Coding (myśl przed kodowaniem), Simplicity First (prostota przede wszystkim), Surgical Changes (chirurgiczne zmiany) oraz Goal-Driven Execution (wykonywanie nastawione na cel). Instalacja tych zasad zajmuje mniej niż dwie minuty. Kod źródłowy jest dostępny w repozytorium andrej-karpathy-skills na GitHub.

Każda z tych zasad adresuje konkretny problem. Na przykład Think Before Coding wymusza na modelu analizę struktury przed generowaniem kodu. Simplicity First zapobiega przebudowanym rozwiązaniom. Surgical Changes gwarantuje minimalne diffy. To podejście rekomenduję przetestować w każdym projekcie.

Warto sprawdzić również podejście Borisa, opisane na blogu Arpana Patela. Boris tworzy CLAUDE.md w katalogu .claude, umieszczając tam konwencje kodowania, zależności i architekturę. Dodatkowo plik CLAUDE.local.md przechowuje konfigurację specyficzną dla maszyny, która nie trafia do repozytorium. Szczegóły znajdziesz w artykule How I use Claude Code.

Czym są umiejętności (Skills) w Claude Code i jak je tworzyć?

Umiejętności to mechanizm automatyzacji powtarzalnych zadań w Claude Code. Działają jak zapisane przepływy pracy, które można wywołać jednym poleceniem. Repozytorium andrej-karpathy-skills na GitHub pokazuje, jak jedna umiejętność może poprawić zachowanie Claude Code poprzez zastosowanie zasad programowania Karpathy’ego.

Tworzenie umiejętności polega na zdefiniowaniu pliku markdown z instrukcjami, które Claude interpretuje. Na przykład umiejętność może zawierać krok po kroku proces review kodu, deploy aplikacji albo generowanie testów. Umiejętność ładuje kontekst, wykonuje zadanie i zwraca wynik.

W praktyce wygląda to prosto. Tworzysz plik w katalogu .claude/skills, dodajesz instrukcje w formacie markdown i wywołujesz przez /skill nazwa. Claude czyta plik, interpretuje instrukcje i wykonuje zadanie zgodnie z zdefiniowanym przepływem.

Jak subagenty i wtyczki rozszerzają możliwości Claude Code?

Subagenty pozwalają Claude Code na delegowanie specjalistycznych zadań do osobnych instancji. Zamiast jednego agenta wykonującego wszystko, subagent specjalizuje się w konkretnej domenie – na przykład w analizie bezpieczeństwa albo generowaniu dokumentacji. Blog Arpana Patela opisuje, jak zespół Anthropic używa subagentów do podziału pracy na mniejsze, zarządzalne fragmenty.

Wtyczki działają podobnie jak w innych narzędziach – dodają nowe funkcjonalności bez modyfikacji rdzenia. Claude Code obsługuje wtyczki, które mogą dodawać nowe polecenia, integracje z zewnętrznymi usługami albo niestandardowe formaty wyjściowe. Więcej o wtyczkach w kontekście konkurencji znajdziesz w artykule OpenAI Codex dostaje wtyczki – dogania Claude Code i Gemini CLI.

Mechanizm subagentów jest użyteczny, gdy projekt ma wiele warstw. Na przykład jeden subagent może zarządzać frontendem, drugi backendem, a trzeci bazą danych. Każdy z nich ma własny kontekst i instrukcje, co zmniejsza ryzyko pomyłek wynikających z przeładowania kontekstem.

Warto sprawdzić, jak subagenty sprawdzają się w dużych projektach. Zamiast jednego długiego promptu, dzielisz pracę na specjalistyczne zadania. To podejście zmniejsza halucynacje i poprawia jakość wyników.

Jak MCP standardizuje komunikację z zewnętrznymi serwerami?

Model Context Protocol to protokół, który standaryzuje sposób komunikacji Claude Code z zewnętrznymi serwerami i źródłami danych. Zamiast pisać integracje dla każdej usługi osobno, MCP zapewnia jeden interfejs. Przewodnik po Claude Code CLI opisuje MCP jako jeden z głównych mechanizmów rozszerzania funkcjonalności narzędzia.

MCP działa jak warstwa pośrednia między Claude Code a zewnętrznymi serwerami. Na przykład serwer MCP może dostarczać dostęp do bazy danych, API firm trzecich albo narzędzi DevOps. Claude Code łączy się z serwerem, odkrywa dostępne narzędzia i używa ich w ramach sesji.

Konfiguracja MCP wymaga dodania wpisu do pliku konfiguracyjnego Claude Code. Każdy serwer ma własny endpoint i zestaw narzędzi. Po dodaniu serwera Claude automatycznie rozpoznaje dostępne funkcje i może z nich korzystać bez dodatkowej konfiguracji.

Jakie polecenia Claude Code są niedoceniane i jak ich używać?

Dokumentacja Claude Code wymienia polecenia, które większość użytkowników omija. Blog Arpana Patela zwraca uwagę na /goal i /insights jako narzędzia, które zmieniają sposób pracy. Polecenie /goal pozwala na zdefiniowanie celu sesji, co pomaga Claude utrzymać kierunek. Z kolei /insights generuje podsumowanie tego, czego Claude nauczył się podczas pracy nad projektem.

Inne użyteczne polecenia to /ultraplan, o którym więcej piszę w artykule claude code /ultraplan, oraz polecenia związane z zarządzaniem sesją. Pełny przegląd dostępnych poleceń znajdziesz w Przegląd Claude Code – Claude Code Docs.

Polecenie /goal warto ustawić na początku każdej sesji. Dzięki temu Claude wie, co jest celem i nie zbacza z toru. To szczególnie użyteczne przy długich sesjach, gdzie kontekst może ulec rozmyciu.

Jakie wzorce pracy z Claude Code rekomenduje zespół Anthropic?

Zespół Anthropic używa konkretnych wzorców pracy, które Arpan Patel opisuje na swoim blogu. Przede wszystkim zalecają trzymmanie kontekstu w pliku CLAUDE.md, używanie umiejętności do automatyzacji i subagentów do podziału pracy. Dodatkowo rekomendują regularne aktualizacje pliku CLAUDE.md, aby odzwierciedlał aktualny stan projektu.

Wzorce te opierają się na zasadzie, że lepszy kontekst daje lepsze wyniki. Zamiast polegać na domysłach modelu, zespół Anthropic dostarcza jasne instrukcje, konwencje i ograniczenia. To podejście zmniejsza liczbę iteracji i poprawia jakość generowanego kodu. Więcej o aktualizacjach narzędzia znajdziesz w Dziennik zmian – Dokumentacja Claude Code.

Praktycznym wzorcem jest trzymanie pliku CLAUDE.md w repozytorium, aby każdy członek zespołu miał dostęp do tego samego kontekstu. Plik CLAUDE.local.md służy do konfiguracji specyficznej dla maszyny, na przykład ścieżek do lokalnych narzędzi.

Kolejny wzorzec to użycie umiejętności do standaryzacji procesów w zespole. Na przykład umiejętność review kodu gwarantuje, że każdy członek zespołu stosuje te same kryteria. To podejście jest opisane w przewodniku Przewodnik po Claude Code CLI: instalacja, konfiguracja, polecenia i zmienne środowiskowe.

Zrozumienie tych mechanizmów pozwala na efektywniejsze wykorzystanie Claude Code w codziennej pracy.

Jakie błędy popełniają użytkownicy Claude Code najczęściej?

Najczęstszym błędem jest brak pliku CLAUDE.md lub jego zbyt ogólna treść. Karpathy zidentyfikował cztery główne problemy: model generuje kod bez analizy, tworzy przebudowane rozwiązania, wprowadza duże zmiany zamiast minimalnych diffów i traci cel z oczu. Te problemy dotyczą każdego projektu, niezależnie od skali.

Karpathy zauważył, że Claude Code ma tendencję do nadmiernego komplikowania rozwiązań. Zamiast prostego fixa, model dodaje nowe warstwy abstrakcji, zmienia nazewnictwo i modyfikuje pliki, których nie trzeba dotykać. Dlatego zasada Simplicity First jest tak istotna – wymusza na modelu minimalizm.

Kolejny częsty błąd to poleganie wyłącznie na promptach w locie. Użytkownik wpisuje polecenie, dostaje wynik i przechodzi dalej. Bez zapisanego kontekstu w CLAUDE.md każda nowa sesja zaczyna się od zera. To prowadzi do niespójności i powtarzania tych samych błędów.

• Brak pliku CLAUDE.md lub zbyt ogólna treść
• Ignorowanie zasady Think Before Coding
• Przebudowane rozwiązania zamiast chirurgicznych zmian
• Brak zapisanego kontekstu między sesjami
• Nieużywanie umiejętności do powtarzalnych zadań
• Pomijanie polecenia /goal na początku sesji
• Zbyt długie sesje bez podziału na subagenty
• Nieregularna aktualizacja pliku CLAUDE.md
• Brak konfiguracji CLAUDE.local.md dla środowiska lokalnego

Jakie są najlepsze praktyki konfiguracji pliku CLAUDE.md?

Boris, opisany na blogu Arpana Patela, tworzy CLAUDE.md w katalogu .claude z podziałem na sekcje: konwencje kodowania, zależności między modułami, architektura projektu i instrukcje testowe. Dodatkowo używa CLAUDE.local.md dla konfiguracji specyficznej dla maszyny. To podejście oddziela kontekst uniwersalny od lokalnego.

Praktyka Borisa polega na aktualizacji CLAUDE.md po każdej istotnej zmianie w projekcie. Na przykład dodanie nowej zależności lub zmiana architektury wymaga aktualizacji pliku. Dzięki temu Claude zawsze ma aktualny kontekst. Plik ten trafia do repozytorium, więc cały zespół korzysta z tych samych informacji.

Zasady Karpathy’ego stanowią dobry punkt wyjścia. Think Before Coding wymusza analizę przed kodowaniem. Simplicity First zapobiega przebudowie. Goal-Driven Execution trzyma fokus na celu.

Warto również dodać do CLAUDE.md informacje o testach. Karpathy rekomenduje określenie, jak uruchamiać testy, jakie ramy testowe są używane i jakie jest pokrycie kodu. Claude wtedy generuje kod zgodny z istniejącymi testami.

Jak zintegrować Claude Code z MCP w praktyce?

MCP (Model Context Protocol) standaryzuje komunikację Claude Code z zewnętrznymi serwerami.

W praktyce integracja MCP wygląda następująco. Najpierw konfigurujesz serwer MCP – może to być serwer dostarczający dostęp do bazy danych, API zewnętrznej usługi lub narzędzi DevOps. Następnie dodajesz wpis do konfiguracji Claude Code z adresem endpointu.

Przykładowo, serwer MCP może dostarczać dostęp do PostgreSQL. Claude Code łączy się z serwerem i może wykonywać zapytania SQL bezpośrednio z terminala. To eliminuje potrzebę przełączania się między narzędziami i zachowuje kontekst w jednej sesji.

Konfiguracja MCP wymaga znajomości endpointów i protokołu. Dokumentacja Claude Code zawiera przykłady konfiguracji popularnych serwerów. Warto zacząć od jednego serwera i stopniowo dodawać kolejne, zamiast konfigurować wszystko naraz.

• Dodaj wpis do pliku konfiguracyjnego Claude Code
• Określ endpoint serwera MCP
• Zdefiniuj dostępne narzędzia
• Przetestuj połączenie przed użyciem w produkcji
• Dodawaj serwery stopniowo, nie wszystkie naraz
• Dokumentuj konfigurację w CLAUDE.md
• Sprawdź logi połączenia przy problemach
• Używaj gotowych serwerów z dokumentacji

Jakie narzędzia open-source rozszerzają funkcjonalność Claude Code?

Ekosystem Claude Code rośnie dzięki narzędziom open-source tworzonym przez społeczność. Claude Code Companion pozwala sterować Claude Code z Telegrama, co umożliwia zdalne zarządzanie sesjami. Claw-code to reimplementacja Claude Code pisana od nowa, oferująca alternatywne podejście do architektury. Claude-warmup zarządza 5-godzinnym oknem użycia Claude Code.

Claude Code Companion działa jak most między Telegramem a Claude Code. Wysyłasz polecenie przez Telegrama, a Claude Code wykonuje je na Twoim komputerze. To użyteczne, gdy chcesz uruchomić zadanie zdalnie, na przykład deploy albo testy, bez dostępu do terminala.

Claw-code to projekt open-source, który przepisuje Claude Code od podstaw. Oferuje inną architekturę i podejście do zarządzania kontekstem. Choć jest we wczesnych etapach rozwoju, pokazuje, że społeczność aktywnie eksperymentuje z koncepcjami Claude Code.

Claude-warmup rozwiązuje problem 5-godzinnego okna użycia Claude Code. Narzędzie zarządza sesjami tak, aby maksymalnie wykorzystać dostępny czas. To szczególnie ważne dla użytkowników, którzy chcą utrzymać ciągłość pracy bez przerywania na ponowne logowanie.

Jakie są różnice między umiejętnościami a subagentami?

Umiejętności (Skills) to zapisane przepływy pracy wywoływane jednym poleceniem. Subagenty to osobne instancje Claude Code specjalizujące się w konkretnej domenie. Umiejętności działają w ramach jednej sesji, subagenty mogą działać niezależnie.

Umiejętności są prostsze w konfiguracji. Tworzysz plik markdown w katalogu .claude/skills i wywołujesz przez /skill nazwa. Subagenty wymagają bardziej złożonej konfiguracji – każdy subagent ma własny kontekst, instrukcje i zakres odpowiedzialności. Arpan Patel opisuje, jak zespół Anthropic używa subagentów do podziału pracy na frontend, backend i DevOps.

Wybór między umiejętnościami a subagentami zależy od złożoności zadania. Dla prostych, powtarzalnych procesów umiejętności wystarczają. Dla złożonych projektów wielomodułowych subagenty oferują lepszą organizację pracy. Można łączyć oba podejścia – umiejętności do automatyzacji, subagenty do specjalizacji.

Często zadawane pytania

Jak szybko skonfigurować CLAUDE.md w istniejącym projekcie?

Skopiuj plik CLAUDE.md z repozytorium andrej-karpathy-skills do katalogu .claude swojego projektu i dostosuj sekcje do własnych potrzeb. Instalacja zajmuje mniej niż dwie minuty.

Czy MCP działa z dowolnym zewnętrznym serwerem?

MCP wymaga serwera zgodnego z protokołem Model Context Protocol. Przewodnik po Claude Code CLI (Blake Crosley, 2025) wymienia kilkanaście gotowych serwerów MCP, w tym PostgreSQL, GitHub i Slack. Każdy serwer musi implementować standardowy interfejs narzędzi.

Ile umiejętności można zdefiniować w jednym projekcie?

Nie ma ograniczeń co do liczby umiejętności. Repozytorium andrej-karpathy-skills (GitHub, 2025) pokazuje, że nawet jedna umiejętność może znacząco poprawić zachowanie Claude Code. Warto zacząć od 2-4 umiejętności dla najczęstszych zadań i stopniowo dodawać kolejne.

Jak subagenty wpływają na zużycie tokenów?

Subagenty zwiększają zużycie tokenów, ponieważ każdy z nich ma własny kontekst. Blog Arpana Patela (2025) zaleca używanie subagentów tylko dla złożonych projektów wielomodułowych, gdzie podział pracy uzasadnia dodatkowy koszt. Dla prostych zadań umiejętności są bardziej ekonomiczne.

Podsumowanie

Claude Code to narzędzie, które wymaga świadomej konfiguracji. Zasady Karpathy’ego – Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution – stanowią solidny fundament.

Kluczowe wnioski:

• Plik CLAUDE.md to fundament – bez niego Claude Code działa w ciemno
• Umiejętności automatyzują powtarzalne zadania i standaryzują procesy
• Subagenty sprawdzają się w złożonych projektach wielomodułowych
• MCP standaryzuje komunikację z zewnętrznymi serwerami
• Narzędzia open-source rozszerzają funkcjonalność Claude Code
• Regularna aktualizacja konfiguracji poprawia jakość wyników
• Polecenia /goal i /insights pomagają zarządzać sesją

Zanim zaczniesz pracę z Claude Code, zainstaluj zasady Karpathy’ego z repozytorium andrej-karpathy-skills. To dwie minuty, które oszczędzą godziny frustracji. Następnie dodaj umiejętności dla najczęstszych zadań i przetestuj MCP z jednym serwerem.