Masz code review do zrobienia. Zamiast sam przeglądać 500 linii zmian, mówisz Claude Code: „Użyj agenta code-reviewer". Claude deleguje zadanie do wyspecjalizowanego subagenta, który zna tylko narzędzia do czytania kodu i ma prompt skupiony na bezpieczeństwie i jakości.
To Subagenci – wyspecjalizowani asystenci AI działający wewnątrz Claude Code. Każdy z własnym kontekstem, narzędziami i instrukcjami.
- Czym są Subagenci
- Wbudowani: Explore, Plan, general-purpose
- Tworzenie własnych Subagentów
- Przykład: security-reviewer z Opus
- Kiedy używać Subagentów
Czym są Subagenci
Subagenci to specjalizowani asystenci AI wewnątrz Claude Code. Każdy subagent ma:
- Własny kontekst – nie zanieczyszcza głównej rozmowy
- Własne narzędzia – możesz ograniczyć dostęp do edycji plików
- Własny prompt – instrukcje dostosowane do zadania
- Własny model – tańszy Haiku do eksploracji, droższy Opus do security review
Gdy Claude napotka zadanie pasujące do opisu subagenta, automatycznie deleguje pracę. Subagent pracuje niezależnie i zwraca wynik.
Subagenci pomagają zachować kontekst. Zamiast zaśmiecać główną rozmowę setkami przeszukanych plików, subagent robi research w swojej przestrzeni i zwraca tylko wyniki.
Wbudowani: Explore, Plan, general-purpose
Claude Code zawiera kilka wbudowanych subagentów:
| Subagent | Model | Narzędzia | Zastosowanie |
| Explore | Haiku (szybki) | Tylko odczyt | Wyszukiwanie, analiza kodu |
| Plan | Dziedziczony | Tylko odczyt | Research przed planowaniem |
| general-purpose | Dziedziczony | Wszystkie | Złożone zadania wieloetapowe |
Explore to szybki agent do przeszukiwania kodu. Używa tańszego modelu Haiku i ma dostęp tylko do narzędzi odczytu. Idealny gdy potrzebujesz zrozumieć strukturę projektu bez modyfikacji.
Plan włącza się w trybie planowania. Zbiera kontekst z kodu zanim Claude przedstawi plan działania.
general-purpose obsługuje złożone zadania wymagające zarówno eksploracji jak i modyfikacji – wiele zależnych kroków, złożone rozumowanie.
Tworzenie własnych Subagentów
Możesz tworzyć własnych subagentów na dwa sposoby:
Metoda 1: Komenda /agents
Wpisz /agents w Claude Code → „Create new agent" → wybierz zakres (projekt lub użytkownik) → opisz agenta → Claude wygeneruje konfigurację.
Metoda 2: Plik Markdown
Stwórz plik w .claude/agents/ (projekt) lub ~/.claude/agents/ (globalny):
---
name: code-reviewer
description: Recenzuje kod pod kątem jakości i bezpieczeństwa
tools: Read, Glob, Grep
model: sonnet
---
Jesteś recenzentem kodu. Analizuj zmiany i dawaj konkretne,
praktyczne uwagi dotyczące jakości, bezpieczeństwa i best practices.Frontmatter definiuje metadane, body to system prompt dla subagenta.
| Pole | Opis | Wymagane |
| name | Nazwa subagenta | Tak |
| description | Kiedy używać (dla Claude) | Tak |
| tools | Dozwolone narzędzia | Nie |
| model | Model AI (haiku/sonnet/opus) | Nie |
| permissionMode | Tryb uprawnień | Nie |
Przykład: security-reviewer z Opus
Oto subagent do security review, używający najmocniejszego modelu i ograniczony do odczytu:
Plik ~/.claude/agents/security-reviewer.md:
---
name: security-reviewer
description: Analizuje kod pod kątem podatności bezpieczeństwa
tools: Read, Glob, Grep
model: opus
permissionMode: plan
---
Jesteś ekspertem od bezpieczeństwa aplikacji. Analizujesz kod szukając:
1. **Injection** - SQL, XSS, command injection
2. **Autentykacja** - słabe hasła, brak MFA, session hijacking
3. **Autoryzacja** - IDOR, privilege escalation
4. **Kryptografia** - słabe algorytmy, hardcoded secrets
5. **Walidacja** - brak sanityzacji inputów
Dla każdego problemu podaj:
- Lokalizację (plik:linia)
- Opis podatności
- Poziom ryzyka (krytyczny/wysoki/średni/niski)
- Sugerowaną naprawę z przykładem koduUżycie:
Użyj security-reviewer do przeanalizowania modułu authClaude deleguje do subagenta, który przeszukuje kod z perspektywy bezpieczeństwa i zwraca raport z podatnościami.
Subagent security-reviewer używa modelu Opus (najlepsze rozumowanie) ale ma tylko narzędzia odczytu. Nie może przypadkowo zmodyfikować kodu podczas analizy.
Kiedy używać Subagentów
Używaj subagentów gdy:
- Zadanie wymaga dużo eksploracji (setki plików do przeszukania)
- Potrzebujesz specjalistycznej perspektywy (security, performance, accessibility)
- Chcesz ograniczyć uprawnienia (tylko odczyt dla review)
- Zależy Ci na kosztach (Haiku do rutynowych zadań)
Nie używaj subagentów gdy:
- Zadanie jest proste i jednokrokowe
- Potrzebujesz kontynuacji rozmowy z poprzednim kontekstem
- Subagent musiałby spawać kolejne subagenty (nie jest wspierane)
Podsumowanie
Subagenci to wyspecjalizowani asystenci wewnątrz Claude Code. Pozwalają delegować zadania do agentów z własnym kontekstem, narzędziami i promptem. Wbudowane Explore i Plan obsługują typowe scenariusze, a własni subagenci pozwalają dostosować behavior do potrzeb projektu.
Jeśli chcesz zautomatyzować reakcje na zdarzenia (zamiast delegować zadania), sprawdź poprzedni wpis: Hooks w Claude Code: automatyczny linting i walidacja.
Więcej o multi-agentowych systemach znajdziesz w artykule Agentic AI: przyszłość automatyzacji.