Jak w pełni wykorzystać Claude Code — gotowy zestaw agentów, hooków i reguł od zwycięzcy hackathonu Anthropic

Gdy Anthropic uruchomił Claude Code, większość programistów zaczęła używać tego narzędzia jako zwykłego interaktywnego czatu w terminalu. Zadaj pytanie — otrzymaj odpowiedź, poproś o naprawę pliku — otrzymaj łatkę. Jednak to podejście szybko ujawnia fundamentalne ograniczenia LLM-ów. Okno kontekstowe zapełnia się niepotrzebnymi logami, model zapomina o przyjętych decyzjach architektonicznych, a zużycie tokenów rośnie z każdym żądaniem.

Affaan Mustafa, zwycięzca hackathonu Anthropic x Forum Ventures i współautor zenith.chat, podszedł do tego problemu systematycznie. Przez dziesięć miesięcy ciągłej komercyjnej pracy nad produktem z użyciem Claude Code, zbudował ujednolicony system ustawień, subagentów i automatyzacji. Wszystkie te rozwiązania zostały zebrane w otwartym repozytorium everything-claude-code.

Autor udostępnia dwa wizualne przewodniki dotyczące podstawowych zasad i głębokiej optymalizacji workflow:

Co zawiera repozytorium

Projekt jest zaprojektowany jako wtyczka do Claude Code, choć komponenty można łatwo kopiować ręcznie. Wewnątrz znajduje się gotowa infrastruktura do zarządzania zachowaniem asystenta neuronalnego.

Struktura repozytorium dzieli workflowy na kilka logicznych warstw:

• Agenci (Subagenci). Pliki z wąskim kontekstem i zadaniami. Zamiast uniwersalnego prompta używane są tutaj wąskie role: architect.md do projektowania, code-reviewer.md do zapewnienia jakości, e2e-runner.md do testów Playwright i security-reviewer.md do skanowania podatności.
• Polecenia (Slash Commands). Szybkie wywołania skryptów bezpośrednio w CLI. Wpisanie /tdd uruchamia cykl test-driven development, natomiast /build-fix zmusza model do systematycznej analizy błędów kompilacji.
• Umiejętności (Skills). Szczegółowe instrukcje dla konkretnych technologii i metodologii: od wzorców Next.js po reguły czyszczenia legacy code.
• Reguły. Instrukcje, które Claude Code traktuje jako stałe. Określają wymagania dotyczące pokrycia testami, format commitów i zabraniają bezpośredniej mutacji danych.
• Hooki. Skrypty Node.js powiązane z zdarzeniami. Uruchamiają się przy wywołaniu narzędzi i pozwalają na automatyzację utrwalania stanu lub walidację kodu przed zapisem.

Subagenci i wąska specjalizacja

Głównym problemem dużych modeli językowych jest degradacja jakości odpowiedzi wraz z rozszerzaniem się kontekstu. Jeśli poprosisz model o jednoczesne projektowanie bazy danych, pisanie kodu frontendowego i sprawdzanie kodu pod kątem podatności, zaczyna się gubić.

W everything-claude-code ten problem jest rozwiązywany poprzez dekompozycję. Na przykład subagent code-reviewer jest skonfigurowany do używania modelu Claude 3.5 Opus i ma dostęp tylko do odczytu do plików i terminala.

---
name: code-reviewer
description: Reviews code for quality, security, and maintainability
tools: Read, Grep, Glob, Bash
model: opus
---

You are a senior code reviewer...

Gdy główny czat wywołuje tego agenta, tworzona jest oddzielna izolowana sesja. Wykonuje on sprawdzenie według ścisłej checklisty, wydaje werdykt i zwraca wynik do głównego przepływu bez zaśmiecania historii dialogu pośrednim rozumowaniem.

Automatyzacja przez hooki i skrypty

Interesującym elementem repozytorium jest wykorzystanie hooków Node.js do zarządzania cyklem życia sesji. Wszystkie hooki są wieloplatformowe i działają identycznie na Windows, macOS i Linux.

Jeden z hooków monitoruje wywołania edycji plików. Jeśli programista lub sam model przypadkowo zostawi w kodzie wyjście debugowe jak console.log, hook przechwytuje operację i wyświetla ostrzeżenie w konsoli.

Innym ważnym zadaniem hooka jest utrwalanie i przywracanie kontekstu sesji. Po uruchomieniu sesji skrypt session-start.js ładuje uprzednio zapisany kontekst projektu, a przy wyjściu session-end.js zapisuje bieżący stan. Eliminuje to potrzebę ponownego wyjaśniania modelowi, gdzie skończyliśmy wczoraj wieczorem.

Repozytorium zawiera również system automatycznego wykrywania menedżera pakietów. Skrypt analizuje pliki projektu w określonej kolejności:

1. Zmienna środowiskowa CLAUDE_PACKAGE_MANAGER
2. Konfiguracja projektu .claude/package-manager.json
3. Pole packageManager w package.json
4. Obecność plików blokady (pnpm-lock.yaml, yarn.lock, bun.lockb)

Dzięki temu polecenia slash uruchamiają buildy przez bun lub pnpm jeśli są używane w projekcie, bez ryzyka przypadkowego wygenerowania package-lock.json.

Pułapka MCP i okna kontekstowego

Repozytorium zawiera zestaw gotowych konfiguracji MCP (Model Context Protocol) — protokołu pozwalającego Claude Code na interakcję z zewnętrznymi serwisami jak GitHub, Supabase, Vercel i Railway.

Autor repozytorium przestrzega przed ważnym zagrożeniem związanym z używaniem MCP. Każdy podłączony serwer dodaje swoje schematy narzędzi bezpośrednio do system prompta. Jeśli włączysz 20-30 serwerów MCP na raz, dostępna objętość kontekstu zmniejsza się z 200 000 tokenów do 70 000, zanim jeszcze dialog się rozpocznie.

Praktyczna zasada z opisu repozytorium: możesz mieć skonfigurowanych tyle serwerów, ile chcesz, ale dla każdego konkretnego projektu powinieneś mieć aktywnych nie więcej niż 10 (do 80 aktywnych narzędzi łącznie). Wszystko inne najlepiej wyłączyć przez sekcję disabledMcpServers w lokalnej konfiguracji.

Jak zainstalować i wypróbować

Najprostsza ścieżka to podłączenie repozytorium jako wtyczki bezpośrednio przez interfejs Claude Code:

/plugin marketplace add affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-code

Jeśli nie chcesz używać wtyczek, komponenty można kopiować ręcznie do katalogu domowego:

git clone https://github.com/WorldFlowAI/everything-claude-code.git

cp everything-claude-code/agents/*.md ~/.claude/agents/
cp everything-claude-code/rules/*.md ~/.claude/rules/
cp everything-claude-code/commands/*.md ~/.claude/commands/
cp -r everything-claude-code/skills/* ~/.claude/skills/

Hooki z pliku hooks/hooks.json trzeba będzie ręcznie przenieść do ~/.claude/settings.json, a wymagane klucze API dla MCP dodać do ~/.claude.json.

Podsumowanie

everything-claude-code warto sprawdzić każdemu, kto planuje aktywnie używać Claude Code w codziennej pracy. Nawet jeśli nie weźmiesz całego repozytorium, możesz zaczerpnąć z niego świetne pomysły: podział zadań na subagentów, wieloplatformową integrację z menedżerami pakietów i staranne zarządzanie pamięcią sesji.

Projekt jest cenny, ponieważ nie powstał z abstrakcyjnych teorii inżynierii promptów, ale z realnego doświadczenia pisania kodu komercyjnego przy ciągłym monitorowaniu zużycia tokenów.