Przejdź do głównej treści

Everything Claude Code (ECC): otwartoźródłowy framework agentowy dla Claude Code

Everything Claude Code (ECC) to framework open source, który opakowuje Claude Code wielorazowymi umiejętnościami, wyspecjalizowanymi agentami, trwałą pamięcią i integracjami MCP.
Zaktualizowano 29 cze 2026  · 15 min Czytać

Odkąd agenci do kodowania weszli do gry, ile razy od nowa tłumaczyłeś swój stack, konwencje, preferencje i standardy przeglądów na początku każdej sesji?

Problem w tym, że każda nowa rozmowa startuje na zimno. Narzędzia takie jak Claude Code potrafią pisać kod, ale nie wiedzą, jak twój zespół pisze kod. Co miało oszczędzać czas, kończy się ręczną pracą: wklejaniem tego samego kontekstu projektu, korygowaniem modelu, gdy odpływa, dopieszczaniem instrukcji i przeglądaniem tych samych ogólnych sugestii za każdym razem.

Everything Claude Code (ECC) to framework open source, który ma to naprawić. Mimo nazwy nie jest powiązany z Anthropic. To system agentów i warstwa workflow, która działa na wierzchu Claude Code (to nie model ani IDE) i zamienia ogólnego agenta do kodowania w wyspecjalizowaną platformę inżynierską, która już zna twoje standardy.

W tym artykule wyjaśnię, czym jest ECC, jak jego elementy do siebie pasują, jak go zainstalować i kto powinien go używać.

Ale czym dokładnie jest Claude Code? Zapisz się na nasz kurs Claude Code 101, żeby nauczyć się używać go w codziennych workflowach deweloperskich.

Czym jest Everything Claude Code?

ECC to repozytorium open source, które opakowuje Claude Code predefiniowaną warstwą operacyjną do pracy inżynierskiej.

Projekt znajdziesz na affaan-m/ECC na GitHubie. Ma licencję MIT, jest utrzymywany przez Affaana Mustafę i powstał na bazie ponad 10 miesięcy codziennego użycia Claude Code przy prawdziwych produktach. Mimo nazwy nie jest powiązany z Anthropic.

Repo pakuje cztery rzeczy w jedną instalację:

  • Uprząż agentów: zestaw wyspecjalizowanych subagentów (planista, architekt, recenzent kodu, recenzent bezpieczeństwa, resolver błędów buildu i kilkanaście innych), do których Claude Code deleguje zadania zamiast próbować robić wszystko w jednym oknie kontekstu.
  • Ekosystem umiejętności: kilkaset małych definicji workflowów obejmujących TDD, przeglądy bezpieczeństwa, wzorce frameworków (Django, Spring Boot, Next.js i inne), językowe standardy kodowania oraz zadania ML-inżynieryjne.
  • Framework workflowów: hooki uruchamiane na zdarzeniach narzędzi, reguły zawsze obowiązujące, konfiguracje serwerów MCP i pamięć sesji, która przetrwa między rozmowami.
  • Warstwa komend: utrzymywane wpisy slash do uruchamiania typowych workflowów oraz folder zgodności wstecznej dla starszych nazw poleceń.

Ważne: silnikiem pozostaje Claude Code. On czyta kod i uruchamia narzędzia.

Zadaniem ECC jest wszystko dookoła: wskazanie, który subagent ma obsłużyć dane zadanie, jakich kroków workflow się trzymać, jakich konwencji używa twój stack i jaki kontekst przenieść z wczorajszej sesji.

W praktyce oznacza to, że nie musisz konfigurować Claude Code od zera dla każdego projektu. Instalujesz ECC raz, kopiujesz pakiety reguł dla swojego stacka i masz wyspecjalizowaną platformę inżynierską, która wie, jak działać dalej.

Dlaczego Everything Claude Code stał się tak popularny

Wzrost zaczął się od jednego wątku na X.

Na początku 2026 r. Mustafa opublikował The Shorthand Guide to Everything Claude Code. W kilka dni zebrał ponad 10 tys. zakładek. Potem otworzył repo, a ECC przekroczył 200 tys. gwiazdek i 34+ forków.

Dlaczego tak się stało:

  • Kodowanie agentowe przeszło z eksperymentu do codziennej praktyki: Gdy więcej deweloperów zaczęło używać Claude Code, dostrzegli ograniczenia stockowego systemu. Potrzebna była predefiniowana warstwa konfiguracji eliminująca zimny start kontekstu, niespójne wyniki przeglądu kodu i podobne problemy.
  • Pisanie dobrych promptów dla agentów jest trudniejsze, niż się wydaje: Solidny workflow TDD czy prompt recenzenta kodu filtrujący po pewności wymaga iteracji. Wiele zespołów nie chce budować i utrzymywać tego od zera wraz ze zmianami modeli, więc łatwiej wykorzystać czyjąś sprawdzoną wersję.
  • Naruszyły się kontrybucje: Ponad 270 kontrybutorów dodało pakiety reguł językowych (Java, Kotlin, Rust, Perl, PHP), wsparcie dla frameworków (Quarkus, Laravel), tłumaczenia, integracje IDE poza Claude Code (Cursor, OpenCode, Zed) i umiejętności.
  • ECC daje specjalizację bez fine-tuningu: Dla większości zespołów dostrajanie modelu do konwencji zespołu nie jest praktyczne. Struktura umiejętności i agentów w runtime daje zbliżony efekt, a ECC to jedna z pełniejszych prób opakowania tego podejścia.

Zaczęło się od wątku na X, a potem zamieniło się w efekt kuli śniegowej.

Jak działa Everything Claude Code

ECC to system warstwowy.

Między tobą a twoją bazą kodu jest pięć komponentów. Claude Code to runtime. Umiejętności, agenci, MCP i warstwa pamięci go opakowują. Każda część robi jedno zadanie i przekazuje pracę dalej podczas sesji.

Claude Code

Claude Code to bazowy interfejs modelu.

To oficjalne CLI Anthropic do uruchamiania Claude jako agenta do kodowania. Czyta pliki, zapisuje diffy, uruchamia komendy shellowe, wywołuje narzędzia i prowadzi rozmowę. ECC niczego z tego nie zastępuje. Wszystko, co dodaje ECC, jest ładowane do Claude Code na starcie sesji i działa przez istniejący system pluginów, hooków i komend.

Umiejętności

Umiejętności to wielokrotnego użytku instrukcje workflow przechowywane jako pliki Markdown.

Każda umiejętność to mały folder z plikiem SKILL.md, który mówi Claude Code, jak obsłużyć konkretny typ zadania. Umiejętność definiuje opis, kroki, oczekiwany wynik i ograniczenia. ECC ma około 260 umiejętności, które obejmują wzorce językowe, workflowy testowania, konwencje frameworków, inżynierię ML i zadania operacyjne.

Zapamiętaj: nie uruchamiasz umiejętności ręcznie. Claude Code wybiera je na podstawie tego, co robisz, albo odwołujesz się do nich w promptcie.

Agenci

Agenci to wyspecjalizowani subagenci, do których Claude Code deleguje zadania.

Każdy jest zdefiniowany w Markdown z nazwą, opisem, allowlistą narzędzi i promptem systemowym zawężającym jego zachowanie. Agent code-reviewer tylko czyta pliki i raportuje ustalenia. planner pisze plan implementacji, zanim dotknie się kodu. Wiesz, o co chodzi.

Sens tego podziału to izolacja kontekstu. Każdy subagent dostaje czyste okno kontekstu dla swojego zadania, więc główna sesja się nie zapycha. Główny agent koordynuje, a subagenci wykonują.

Integracje MCP

MCP (Model Context Protocol) to sposób, w jaki Claude Code rozmawia z narzędziami i źródłami danych zewnętrznych.

ECC ma konfiguracje do łączenia z GitHubem, Supabase, Vercel, Railway i innymi przez serwery MCP. Każdy serwer udostępnia narzędzia, które Claude Code może wywołać w trakcie sesji. ECC po prostu pakuje działające konfiguracje i reguły bezpieczeństwa dla nich.

Domyślnie ECC włącza jeden konektor (chrome-devtools). Reszta jest opt-in, co unika kolizji nazw narzędzi i zmniejsza powierzchnię ataku.

Warstwa pamięci

Warstwa pamięci sprawia, że ECC jest stanowy między sesjami.

Hooki uruchamiane są przy zdarzeniu Stop każdej rozmowy i zapisują podsumowanie sesji do ~/.claude/sessions/. Następna sesja ładuje istotny kontekst na starcie przez hook SessionStart. Umiejętności, których model się „uczy” z twoich wzorców, są wyodrębniane do systemu Continuous Learning v2, gdzie są przechowywane jako instynkty z poziomem pewności i mogą być ponownie użyte.

Aliasy sesji, wyuczone umiejętności i metryki żyją pod wspólnym katalogiem danych agenta (domyślnie ~/.claude, konfigurowalny per uprząż, jeśli uruchamiasz ECC zarówno w Claude Code, jak i w Cursorze).

Jak elementy współpracują

Typowa sesja wygląda tak:

  1. Start sesji: Hook ładuje kontekst z poprzedniej sesji oraz odpowiednie umiejętności i reguły dla bieżącego projektu.
  2. Prosisz o coś: na przykład „dodaj logowanie OAuth”.
  3. Najpierw działa agent planista: Pisze plan — bez kodu na tym etapie.
  4. Wchodzi umiejętność TDD: Claude Code realizuje workflow: najpierw test na czerwono, minimalna implementacja, potem refaktor.
  5. Wywoływane są narzędzia MCP: Może GitHub MCP pobiera powiązane PR-y, a Supabase MCP sprawdza schemat.
  6. Na koniec działa agent code-reviewer: Audytuje diff w swoim własnym oknie kontekstu i raportuje.
  7. Sesja się kończy: Hook Stop zapisuje podsumowanie, wyciąga nowe wzorce do instynktów i odkłada je na następny raz.

Modelem wciąż jest Claude Code. ECC tylko ustala, która umiejętność, który agent i które narzędzie są użyte na danym etapie.

Umiejętności w Everything Claude Code

Umiejętności to podstawowy sposób, w jaki ECC mówi Claude Code, co robić.

Umiejętność to folder z plikiem SKILL.md. Markdown definiuje opis, kroki, ograniczenia, oczekiwany wynik i konteksty, w których się stosuje. To po prostu plik tekstowy czytany przez model w runtime.

I tak ma być. ECC niczego nie „przetrenowuje”, tylko ładuje instrukcje, które Claude czyta i realizuje na bieżąco.

Umiejętności znajdują się w katalogu skills/ w rootcie repo. Po instalacji są kopiowane do ~/.claude/skills/. Claude Code ładuje je jako bezpośrednie dzieci tego folderu.

Każdy folder umiejętności ma ten sam układ:

  • SKILL.md — definicja workflowu
  • Opcjonalne pliki wspierające (szablony, skrypty, przykłady)
  • Opcjonalny metadata.yaml do tagowania i wyszukiwania

Umiejętności wpływają na zachowanie agentów na dwa sposoby. Po pierwsze, Claude Code czyta je na starcie sesji i trzyma pod ręką do referencji. Po drugie, model wybiera odpowiednią umiejętność na podstawie tego, o co prosisz. Jeśli mówisz „najpierw napisz test, który padnie”, aktywuje się umiejętność TDD. Jeśli mówisz „zrób przegląd pod kątem SQL injection”, aktywuje się umiejętność przeglądu bezpieczeństwa.

ECC dostarcza ok. 260 umiejętności. Oto kilka pokazujących rozpiętość:

  • frontend-patterns: Konwencje React i Next.js. Struktura komponentów, użycie hooków, decyzje server vs client component, wzorce zarządzania stanem.

  • django-patterns, django-tdd, django-security, django-verification: Pełny stack Django podzielony na cztery umiejętności. Jedna do architektury, jedna do cyklu testów, jedna do audytów w stylu OWASP, jedna do pętli weryfikacji przed wysyłką.

  • architect (sparowany z agentem architect): Przeglądy projektów systemów. Umiejętność definiuje, co obejmuje przegląd architektury, jakie artefakty powstają i jakie kompromisy uwidocznić.

  • tdd-workflow: Cykl red–green–refactor. Napisz test, który pada, napisz minimalny kod, żeby go przejść, zrefaktoruj, zweryfikuj pokrycie. Umiejętność wymusza kolejność.

  • security-review: Lista kontrolna audytu OWASP Top 10, wykrywanie zahardkodowanych sekretów, przegląd walidacji wejścia i sprawdzanie podatności zależności. Umiejętność definiuje, co skanować i co flagować.

Agenci w Everything Claude Code

Agenci to wyspecjalizowane persony z własnym oknem kontekstu.

Każdy to plik Markdown w folderze agents/ z nazwą, opisem, allowlistą narzędzi i promptem systemowym. Prompt systemowy definiuje zadanie agenta. Allowlista kontroluje, co może robić (czytać pliki, uruchamiać bash, wołać serwery MCP, pisać kod). Claude Code automatycznie deleguje zadanie do agenta.

ECC ma 66 agentów. Grupują się w kilka kategorii.

Agenci planujący działają, zanim powstanie jakikolwiek kod.

Agent planner rozbija prośbę o funkcję na plan implementacji: pliki do zmiany, interfejsy do zdefiniowania, testy do napisania, edge casy do obsłużenia. architect idzie wyżej: projekt systemu, decyzje o modelu danych, granice serwisów. Ci agenci tylko czytają kod i piszą plany.

Agenci kodujący wykonują implementację.

tdd-guide wymusza cykl test-first. Rozwiązywacze specyficzne dla języków, jak go-build-resolver, pytorch-build-resolver i kotlin-build-resolver naprawiają błędy buildu w swoich ekosystemach. refactor-cleaner usuwa nieużywany kod.

Agenci architektoniczni przeglądają decyzje strukturalne.

architect obejmuje projekt, database-reviewer obejmuje wzorce zapytań i wybory schematu, a mle-reviewer audytuje produkcyjne pipeline’y ML (kontrakty danych, pokrycie ewaluacji, serwowanie, monitoring).

Agenci QA weryfikują to, co zbudowano.

code-reviewer audytuje diffy pod kątem jakości i bezpieczeństwa z progiem pewności. security-reviewer robi przebieg w stylu OWASP. e2e-runner obsługuje testy end-to-end Playwright. Recenzenci językowi (typescript-reviewer, python-reviewer, go-reviewer, rust-reviewer i inni) robią kontrole specyficzne dla języka.

Powód rozdzielenia tego na osobnych agentów to izolacja kontekstu.

Gdy działa code-reviewer, dostaje świeże okno kontekstu tylko z diffem i załadowaną umiejętnością przeglądu. Nie widzi notatek z planowania ani historii rozmowy. Po prostu recenzuje. To skupienie daje lepszy output niż proszenie jednego ogólnego agenta o planowanie, kodowanie, testowanie i przegląd w tym samym kontekście, co dzieje się w większości ad hocowych konfiguracji Claude Code.

Zarządzanie kontekstem i pamięcią w ECC

ECC nie zapomina wszystkiego między sesjami tak jak Claude Code.

Pamięć w ECC to system hooków, które zapisują pliki w odpowiednich momentach i ładują je z powrotem we właściwym czasie. To zwykłe pliki Markdown i JSON na dysku.

Trzy rzeczy się utrwalają:

  1. Podsumowania sesji są zapisywane przy jej zakończeniu: Hook Stop działa po ostatniej wiadomości, bierze pełny transkrypt i zapisuje podsumowanie do ~/.claude/sessions/. Zawiera ono to, nad czym pracowano, co ustalono i co jest w toku. Następna sesja czyta je w trakcie hooka SessionStart, więc Claude wie, gdzie przerwano.
  2. Instynkty to wyodrębnione wzorce z twoich sesji: System Continuous Learning v2 obserwuje, co robisz i co działa, po czym zapisuje pojedyncze instynkty z poziomem pewności, akcją, dowodami i przykładami. Uruchom /instinct-status, by zobaczyć, czego się nauczył. Uruchom /evolve, by zgrupować powiązane instynkty w nową umiejętność.
  3. Pliki logów śledzą warstwę operacyjną: Wykonania hooków, uruchomienia umiejętności, wywołania MCP, koszty, błędy. Żyją pod ~/.claude/metrics/ i ~/.claude/session-data/. Przydatne do debugowania i dla dashboardu GUI dołączonego do repo.

Jeśli myślisz, że to drobiazg, oto parę powodów, które przekonają cię, że nie:

  • Długie projekty: Sześciomiesięczny refaktor nie resetuje się co poniedziałek. Ubiegłotygodniowe decyzje, kompromisy i znane problemy są w podsumowaniu ładowanym na starcie sesji.
  • Brak powtarzania wyjaśnień: Nie wklejasz za każdym razem swojego stacka, konwencji czy „pamiętaj, ustaliliśmy Postgresa, nie Oracle”.
  • Obejście limitów okna kontekstu: Nawet przy milionie tokenów nie zmieścisz historii sześciu miesięcy. Podsumowania kompresują to, co istotne. Pełna historia zostaje na dysku, model dostaje to, co ważne.

Możesz stroić ładowany kontekst zmiennymi środowiskowymi. ECC_SESSION_START_MAX_CHARS ogranicza, ile znaków podsumowania ładuje się na starcie (domyślnie 8000). ECC_SESSION_START_CONTEXT=off wyłącza to dla konfiguracji niskokontekstowych. ECC_SESSION_RETENTION_DAYS kontroluje, jak długo sesje są przechowywane przed czyszczeniem.

Jeśli uruchamiasz ECC zarówno w Claude Code, jak i w Cursorze na tej samej maszynie, ustaw ECC_AGENT_DATA_HOME, by rozdzielić ich pamięć. Inaczej nadpiszą sobie nawzajem pliki sesji.

Wsparcie MCP w Everything Claude Code

MCP to sposób, w jaki Claude Code wywołuje wszystko, co nie jest plikiem ani komendą shellową.

Model Context Protocol to standard Anthropic do łączenia modeli językowych z narzędziami zewnętrznymi. Serwer MCP działa jako osobny proces i udostępnia typowany zestaw operacji: „przeczytaj tę stronę Notion” albo „otwórz PR na GitHubie”. Claude Code wywołuje te operacje jak funkcje.

ECC ma konfiguracje MCP w mcp-configs/mcp-servers.json dla popularnych usług: GitHub, Supabase, Vercel, Railway, Linear i innych. Każdy wpis zawiera komendę uruchomienia serwera, wymagane zmienne środowiskowe i reguły bezpieczeństwa, jakie ECC stosuje.

Warto wiedzieć, że ECC nie włącza ich automatycznie.

Czerwcowa polityka konektorów MCP z 2026 r. zredukowała domyślnie włączone serwery do jednego (chrome-devtools). Reszta jest opt-in. Albo kopiujesz wpis do projektu .mcp.json, albo włączasz przez komendę /mcp w Claude Code. Powód jest częściowo praktyczny (długie nazwy narzędzi MCP psują niektóre bramki), a częściowo bezpieczeństwa (każdy serwer MCP to potencjalna powierzchnia ataku).

Jak wygląda to wsparcie w praktyce:

  • Integracje zewnętrzne: Wrzuć wpis GitHuba do .mcp.json, podaj token i Claude Code może czytać issue, otwierać PR-y i sprawdzać status CI bez kopiuj-wklej.
  • Wywoływanie narzędzi: Umiejętności i agenci referują narzędzia MCP po nazwie. Np. umiejętność deploymentu może wołać Vercel MCP, a agent przeglądu bazy — Supabase MCP.
  • Automatyzacja projektu: Możesz łączyć serwery MCP z hookami, by mieć automatyzację trwałą między sesjami. Hook „PR-opened” może uruchomić agenta przeglądu, który użyje GitHub MCP do pobrania diffu i Linear MCP do aktualizacji ticketa.

Jeśli już uruchamiasz własne kopie MCP zawartych w ECC, ustaw ECC_DISABLED_MCPS jako listę rozdzielaną przecinkami. ECC pominie je podczas instalacji i synchronizacji, więc nie skończysz z duplikatami walczącymi o tę samą nazwę serwera.

AgentShield i funkcje bezpieczeństwa

Bezpieczeństwo to coś, co wyróżnia ECC na tle konkurencji.

AgentShield to samodzielny audytor bezpieczeństwa dołączony do ECC. Skanuje konfiguracje Claude Code pod kątem podatności, błędnych konfiguracji, błędów i ryzyk iniekcji. Działa jako osobny pakiet npm (ecc-agentshield), ale jest spięty z ECC przez umiejętność /security-scan, więc możesz go uruchomić z poziomu sesji Claude Code.

Skan obejmuje pięć kategorii:

  • Wykrywanie sekretów: 14 wzorców na zahardkodowane dane uwierzytelniające, klucze API, tokeny.
  • Audyt uprawnień: jakie narzędzia i ścieżki może odwiedzać każdy agent i umiejętność oraz czy te granty nie są zbyt szerokie.
  • Analiza iniekcji przez hooki: czy hooki można wykorzystać do uruchamiania dowolnych komend.
  • Profilowanie ryzyka serwerów MCP: co każdy podłączony serwer MCP może czytać, pisać lub wywoływać i gdzie to tworzy ekspozycję.
  • Przegląd konfiguracji agentów: wektory prompt injection, nadmiernie szerokie allowlisty narzędzi, brakujące ograniczenia.

Uruchomisz to komendą, bez instalacji:

npx ecc-agentshield scan

Wynik to ocena literowa (od A do F) plus lista ustaleń, posortowanych wg wagi. Krytyczne ustalenia kończą się kodem wyjścia 2.

Oto kilka flag wartych uwagi:

  • -fix stosuje autofixy dla bezpiecznych kwestii (usuwanie ujawnionych sekretów, zawężanie zbyt szerokich uprawnień…)
  • -opus uruchamia skan przez trzech agentów Claude Opus 4.X w pipeline red-team / blue-team / audytor. Atakujący szuka łańcuchów exploitów. Obrońca ocenia zabezpieczenia. Audytor syntetyzuje oba w priorytetyzowany raport ryzyka.
  • -stream streamuje analizę na żywo, co jest użyteczne przy wolnych konfiguracjach.

Podejście z pipeline’em Opus odróżnia AgentShield od zwykłego lintera. Agenci adwersarialni próbują łączyć komponenty uznane za OK w coś eksploatowalnego — a stąd bierze się większość realnych ataków na agentów.

AgentShield raportuje 102 reguły analizy statycznej i 1282 testy wewnętrzne przy 98% pokryciu — według repo. Warto zweryfikować liczby względem najnowszego wydania, ale widać, że to nie 50-liniowy skrypt.

Formaty wyjścia obejmują terminal (z kolorami), JSON (do CI), Markdown i HTML. Jest też GitHub Action i osobna aplikacja GitHub ECC Tools, która uruchamia AgentShield na PR-ach.

Dla większości zespołów używających Claude Code w produkcji AgentShield jest najbardziej namacalnym powodem instalacji ECC — nawet jeśli nie korzystasz z reszty frameworku.

Instalacja Everything Claude Code

ECC ma dwie ścieżki instalacji.

Najczęstszy błąd to nałożenie instalacji pluginu na instalację ręczną. Obie kopiują te same pliki w te same miejsca i kończy się duplikatami. Więc najpierw: wybierz tylko jedną ścieżkę.

Przed instalacją upewnij się, że masz Claude Code w wersji v2.1.0 lub nowszej:

claude --version

Claude version

Wersja Claude

Instalacja przez menedżer pluginów

To rekomendowana ścieżka dla większości użytkowników.

Z poziomu Claude Code uruchom:

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

Instalacja pluginu

Pierwsza komenda rejestruje repo ECC jako marketplace. Druga instaluje plugin.

Jedna uwaga: system pluginów nie dystrybuuje reguł. Reguły to wytyczne zawsze obowiązujące (styl kodu, workflow gita, standardy testowania, wzorce specyficzne dla języka), a spec pluginów Claude Code ich nie zawiera. Po instalacji pluginu kopiujesz je ręcznie.

git clone https://github.com/affaan-m/ECC.git
cd ECC
mkdir -p ~/.claude/rules/ecc
cp -r rules/common ~/.claude/rules/ecc/
cp -r rules/python ~/.claude/rules/ecc/

Skopiuj rules/common plus jeden pakiet językowy, którego faktycznie używasz. W przykładzie powyżej skopiowałem reguły Pythona. Nie kopiuj wszystkiego — więcej reguł to większy kontekst ładowany do każdej sesji, a większość i tak nie będzie dotyczyć twojego projektu.

Instalacja przez pliki konfiguracyjne

Użyj tego podejścia, jeśli chcesz pełnej kontroli albo jeśli instalacja pluginu nie działa w twoim środowisku.

git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
./install.sh --profile full

Na Windowsie:

.\install.ps1 --profile full
# or
npx ecc-install --profile full

To kopiuje agentów, umiejętności, komendy, hooki i reguły do twojego katalogu ~/.claude/. Bez warstwy pluginu. Wszystko żyje jako pliki na dysku, które Claude Code czyta na starcie sesji.

Kilka profili wartych uwagi:

  • -profile minimal: Tylko reguły, agenci, komendy i rdzeniowe umiejętności, bez hooków.

  • -profile core: Domyślny zestaw roboczy. Z hookami.

  • -profile full: Wszystko z repo.

Możesz też instalować konkretne komponenty przez --modules lub --with:

./install.sh --target claude --modules hooks-runtime
npx ecc install --profile minimal --target claude --with capability:machine-learning

Jeśli nie wiesz, które komponenty pasują do twojej pracy, zapytaj dołączonego doradcę:

npx ecc consult "security reviews" --target claude

Zwróci pasujące komponenty i dokładne komendy instalacji.

Weryfikacja instalacji

Sprawdź, co się zainstalowało:

/plugin list ecc@ecc

Weryfikacja instalacji pluginu

To pokazuje agentów, komendy i umiejętności dostępne z pluginu. Dla instalacji ręcznych użyj wrappera lifecycle:

node scripts/ecc.js list-installed
node scripts/ecc.js doctor

doctor sprawdza brakujące pliki, popsute hooki i niezgodności wersji. Jeśli coś oflaguje, uruchom:

node scripts/ecc.js repair

Aby potwierdzić, że Claude Code widzi nowy plugin, otwórz sesję i spróbuj komendy ze slashem:

/ecc:plan "Add user authentication"

Wynik planu ECC

Dla instalacji pluginu prefiks z namespace’em /ecc: jest wymagany. Dla instalacji ręcznej działa krótka forma (/plan).

Jeśli coś wygląda na zduplikowane albo popsute, nie instaluj na wierzchu. Najpierw uruchom node scripts/uninstall.js --dry-run, by zobaczyć, co byłoby usunięte, potem node scripts/uninstall.js, by posprzątać. ECC usuwa tylko pliki, które zainstalował, więc niepowiązana konfiguracja zostaje nietknięta.

Praca z umiejętnościami, komendami i workflowami

Większość tego, co robisz w ECC, działa przez umiejętności, a nie komendy.

Powód jest taki, że folder commands/ jest utrzymywany dla zgodności wstecznej, ale rozwój nowych workflowów dzieje się najpierw w skills/.

Oto kilka wzorców użycia, które pokryją większość codziennej pracy.

Wywoływanie umiejętności jest głównie niejawne

Zwykle nie wołasz umiejętności po nazwie. Opisujesz, czego chcesz, a Claude Code dobiera pasującą umiejętność. Jeśli mówisz „najpierw napisz test, który pada”, aktywuje się tdd-workflow. Nazwy umiejętności pojawiają się w odpowiedzi, więc widzisz, co załadowano.

Gdy chcesz być jednoznaczny, wspomnij umiejętność w promptcie: „Użyj umiejętności django-tdd, by dodać nowy endpoint.” Albo uruchom komendę, która ją opakowuje:

/code-review
/security-scan

/ecc:plan "Add OAuth login"

Prefiks /ecc: jest wymagany przy instalacji pluginu. Instalacja ręczna używa krótkiej formy (/plan, /code-review).

Wynik fazy planowania ECC

Wskazywanie plików to część workflowu

Większość agentów i umiejętności działa na określonym zakresie: pliku, katalogu, diffie, PR-ze. Zakres wskazujesz, wspominając plik w promptcie, otwierając go w edytorze przed wywołaniem albo kierując agenta na ścieżkę:

/code-review src/auth/
/python-review services/billing/payment.py

Agent przejmuje zakres, ładuje tylko potrzebne pliki i działa we własnym oknie kontekstu.

Integracja z shellem działa przez narzędzie bash Claude Code

Umiejętności mogą wyjść do shella przy wszystkim, co wymaga realnego wykonania — uruchamianiu testów, buildowaniu, lintowaniu czy wywołaniach CLI. Umiejętność TDD uruchamia pytest lub go test. Agent naprawy builda odpala realny build, by zobaczyć prawdziwe błędy. Umiejętność security-scan uruchamia npx ecc-agentshield scan i parsuje wynik.

Umiejętność definiuje, jakie komendy shellowe i kiedy się uruchamiają. Hooki też mogą uruchamiać komendy przy zdarzeniach narzędzi (uruchom typecheck po każdej edycji, ostrzegaj o console.log przed zapisem).

Zarządzanie MCP jest głównie opt-in

Po instalacji ECC włącza domyślnie dokładnie jeden serwer MCP (chrome-devtools). Aby dodać więcej, skopiuj wpisy z mcp-configs/mcp-servers.json do .mcp.json w twoim projekcie, a potem włącz je przez komendę /mcp w Claude Code. Interfejs /mcp obsługuje włączanie, wyłączanie i ponowną autentykację.

Jeśli uruchamiasz własne kopie serwerów MCP dostarczanych przez ECC, ustaw:

export ECC_DISABLED_MCPS="github,supabase"

Instalator i flowy sync ECC pominą je, więc nie skończysz z dwiema instancjami tego samego serwera walczącymi o te same nazwy narzędzi.

Workflowy łączą się w łańcuchy

Nie uruchamiasz umiejętności pojedynczo. Typowy workflow funkcji wygląda tak:

/ecc:plan "Add OAuth login with Google"
# planner agent writes a blueprint

# tdd-workflow skill activates as you implement
# tests fail, code gets written, tests pass

/code-review
# code-reviewer agent audits the diff

/security-scan
# AgentShield checks the new code and config

Każdy krok używa innego agenta w świeżym oknie kontekstu. Główna sesja koordynuje, a podsumowanie sesji chwyta łańcuch na końcu i udostępnia go kolejnej sesji.

Everything Claude Code vs konkurencyjne frameworki konfiguracyjne

ECC nie jest jedyną warstwą konfiguracji dla Claude Code. Kilka innych robi podobne rzeczy z innymi kompromisami.

Warto doprecyzować kategorię. ECC konkuruje z innymi frameworkami konfiguracyjnymi działającymi na wierzchu Claude Code. Nie konkuruje z uprzężami, obok których działa (Cursor, Codex, OpenCode, Zed) ani ze standalone’owymi platformami agentowymi (OpenHands, LangGraph, CrewAI), które są inną kategorią narzędzi.

Najczęściej padają trzy alternatywy.

BMAD-Method to zwinny framework SDLC z agentami w rolach specjalistów (Analityk, PM, Architekt, Scrum Master, Developer, QA). Działa w Claude Code, Cursorze i Windsurfie przez npx bmad-method install. Błyszczy w fazie planowania — zamienia mglisty pomysł w PRD, dokument architektury i rozbite historie, zanim powstanie kod. Narzędzia wykonawcze są lżejsze niż w ECC. Brak skanera bezpieczeństwa i katalogu MCP. Mniej wzorców specyficznych dla języków.

SuperClaude to lekki, oparty na Markdown framework konfiguracyjny. Około 30 komend slash, 20 agentów i kilka trybów zachowania. Instalacja przez pip install SuperClaude. Z założenia prostszy niż ECC — nie ma skanowania bezpieczeństwa ani runtime’u orkiestracji. Nie ma też wbudowanej pamięci poza tą, którą zapewnia Claude Code. Jeśli chcesz działający CLAUDE.md plus zestaw dobrze przetestowanych promptów, SuperClaude będzie dobrym wyborem.

claude-flow / Ruflo (przemianowany z Claude Flow na początku 2026) to orkiestrator roju multiagentowego. Używa metodologii SPARC (specification, pseudocode, architecture, refinement, completion) i uruchamia hierarchie „królowej” 60–100+ wyspecjalizowanych agentów równolegle. Ma trwałą pamięć przez AgentDB i działa na Claude, GPT, Gemini i Ollamie. Infrastruktura jest cięższa niż w ECC i jest zbudowana do równoległej pracy agentów, nie do produktywności jednej sesji.

Jeśli chcesz przejrzeć więcej opcji przed decyzją, awesome-claude-code to kuratorowany katalog zasobów Claude Code (agenci, umiejętności, pluginy, serwery MCP, konfiguracje). Tam odbywa się większość odkryć społeczności.

Podsumowując: wybierz BMAD, jeśli chcesz planowania w stylu agile; SuperClaude, jeśli chcesz lekką warstwę konfiguracji; Ruflo, jeśli potrzebujesz równoległej pracy wielu agentów; a ECC, jeśli chcesz kompletną platformę inżynierską z narzędziami bezpieczeństwa i trwałą pamięcią.

Kto powinien używać Everything Claude Code?

ECC nie jest dla wszystkich. Jeśli używasz Claude Code kilka razy w tygodniu do małych zadań, framework będzie czuł się jak spory narzut przy małym zwrocie. Pojedynczy 100-liniowy CLAUDE.md pokryje większość faktycznych potrzeb.

ECC opłaca się, gdy jesteś już dalej.

Oto scenariusze, gdy jest lepszy niż goły Claude Code:

  • Inżynierowie AI budujący systemy agentowe: Jeśli projektujesz lub wdrażasz workflowy agentów, ECC to działający punkt odniesienia. Przeczytaj prompty agentów, definicje umiejętności, konfiguracje hooków i pożycz, co działa.
  • Entuzjaści produktywności deweloperskiej: Jeśli inwestujesz w narzędzia, dotfiles, konfigurację edytora, shella — ECC to analogiczna inwestycja dla Claude Code. Najwięcej zyskasz, jeśli używasz go często.
  • Zespoły używające Claude Code jako codziennej infrastruktury: Jeśli twój zespół używa Claude Code do przeglądu kodu, planowania, refaktoryzacji czy dostarczania funkcji każdego dnia, oszczędność czasu na spójności i onboardingu się kumuluje. Nowi członkowie dostają tych samych agentów i te same workflowy.
  • Każdy, kto buduje złożone workflowy agentowe: Wieloetapowe pipeline’y, orkiestracja subagentów, łańcuchy MCP, trwały kontekst — to tylko kilka przykładów. ECC rozwiązał większość z tych problemów i wzorce są wielorazowe, nawet jeśli nie instalujesz całości.

Kto nie powinien wybierać ECC:

  • Okazjonalni użytkownicy Claude Code: Kilka sesji tygodniowo typu „pomóż zdebugować ten skrypt” nie potrzebuje 60+ agentów, 260+ umiejętności i warstwy pamięci. Narzut na setup się nie zwróci.
  • Proste, jednorazowe zadania kodowe: Szybkie skrypty, małe poprawki, demo-apki, jednorazowe prototypy. Goły Claude Code radzi sobie z tym świetnie, a dodanie ECC tylko dokłada tarcia bez dużej wartości.
  • Zespoły, które już mają działające ustawienie: Jeśli twój CLAUDE.md jest dopracowany, a workflow stabilny, przejście na ECC wymaga czasu migracji. Pożycz to, co lubisz, resztę zostaw.

Jeśli nie wiesz, gdzie lądujesz, bezpieczna opcja to przeczytać repo, skopiować dwóch–trzech agentów i umiejętności, które cię ciekawią, i na razie pominąć pełną instalację.

Zalety i ograniczenia ECC

Przejdę teraz przez kilka mocnych i słabych stron ECC. Oba warto znać przed decyzją.

Zalety

  • Ogromna biblioteka umiejętności: Około 260 umiejętności obejmujących TDD, audyty bezpieczeństwa, wzorce frameworków, idiomy językowe, inżynierię ML, wdrożenia i więcej. Nawet jeśli nic nie instalujesz, repo to działający wzorzec, jak pisać dobre definicje umiejętności.
  • Reuse workflowów: Dostajesz przetestowane prompty do przeglądu kodu, planowania, refaktoryzacji i testowania. Agent code-reviewer jest szczególnie często cytowany przez osoby, które w ogóle nie używają ECC, ale pożyczyły prompt.
  • Trwała pamięć: Rzeczy jak podsumowania sesji i kontekst między sesjami działają out of the box. Większość innych konfiguracji Claude Code nie dotyka pamięci w ogóle.
  • Mocne wsparcie MCP: Predefiniowane konfiguracje dla GitHuba, Supabase, Vercel, Railway i innych.
  • AgentShield: Sam skaner bezpieczeństwa to powód, by zainstalować ECC, nawet jeśli niczego innego nie użyjesz. Tylko nieliczne konfiguracje Claude Code mają coś porównywalnego.
  • Open source na MIT: Brak paywalla w rdzeniu. Hostowana aplikacja GitHub i tier ECC Pro są osobne.
  • Wieloplatformowość: Działa z Claude Code, Cursorem, Codexem, OpenCode, Zedem, Geminim i innymi. Jeśli zmienisz narzędzie lub używasz kilku, nadal możesz używać tych samych agentów i umiejętności.

Ograniczenia

  • Krzywa nauki: 60+ agentów, 260+ umiejętności, trzy ścieżki instalacji, cztery typy profili i stos zmiennych środowiskowych. Pierwszy tydzień to głównie rozkminianie, co jest załadowane i co robi każdy komponent.
  • Złożoność setupu: Plugin vs instalacja ręczna, kwestia reguł niedostarczanych przez plugin, problem podwójnych hooków w starszych wersjach Claude Code, flowy włączania/wyłączania MCP, zmienna katalogu danych agenta przy multi-uprzęży. Większość z tego jest udokumentowana, ale to nadal sporo pracy.
  • Narzut utrzymaniowy: Repo często się aktualizuje. Liczby w katalogu zmieniają się między wydaniami, nazwy umiejętności też.
  • Zależność od ekosystemu Claude Code: ECC polega na specyfikacji pluginów, systemie hooków i wsparciu MCP Claude Code. Gdy Claude Code to zmienia, ECC musi nadążyć.
  • Przeinżynierowanie dla wielu przypadków: Dla większości zespołów dobrze napisany CLAUDE.md z 60–200 liniami pokrywa 80% tego, co daje ECC. Pozostałe 20% jest wartościowe, ale tylko jeśli to wykorzystasz.

Framework jest obecnie najbardziej kompletną warstwą konfiguracji Claude Code. Ale „najbardziej kompletny” nie znaczy „konieczny dla wszystkich”.

Zakończenie

Jeśli używasz Claude Code na co dzień, warto spojrzeć na ECC. Jeśli nie, repo i tak warto przeczytać jako działający wzorzec budowy workflowów agentowych, które nie rozsypują się w praktyce.

Tak czy inaczej, ECC jasno pokazuje, że rozwój oprogramowania zmierza w stronę programowalnych pipeline’ów agentów zamiast pojedynczych sesji czatowych. Frameworki, które robią to dobrze, są wciąż nowe, a ECC to jedna z najpełniejszych prób do tej pory. Nie będzie ostatnią — i o to chodzi.

Jeśli dopiero zaczynasz z generatywną AI i kodowaniem agentowym, zapisz się na nasz kurs Generative AI Concepts. Da ci solidne podstawy na przyszłość.

Tematy

Ucz się z DataCamp

course

Introduction to Claude Models

3 godz.
11K
Learn how to work with Claude using the Anthropic API to solve real-world tasks and build AI-powered applications.
Zobacz szczegółyRight Arrow
Rozpocznij kurs
Zobacz więcejRight Arrow