# Claude Code-alügynökök: felépítés, öt szerepkör és vezénylés > Az ügynökfájl, a leírás, öt teljes sablon, a párhuzamos végrehajtás, a Managed Agents, a korlátozások és a költség példákkal együtt. Source: https://ailoot.ai/blog/hu/claude-code-alugynokok/ Canonical: https://ailoot.ai/blog/hu/claude-code-alugynokok/ Language: hu Publisher: Ailoot (https://ailoot.ai/) Translation: guide-222 Revision: sha256-4650951779210c3c0d04cbc7ed4d5a592c9097c371c91c67f2d9e5dc33b18692
Főbb tudnivalók A Claude Code alügynöke egy specializált AI-asszisztens, amely saját kontextussal, eszközkészlettel és rendszerprompttal rendelkezik. A fő beszélgetés önállóan dönti el, hogy delegál-e neki egy feladatot, de név szerint is meghívhatod az `@agent-` használatával. Az alügynök szűk körű feladatot végez el anélkül, hogy telezsúfolná a fő beszélgetést, és csak egy végső összefoglalót ad vissza. Ebben az útmutatóban elmagyarázom, miben különbözik az alügynök a Skillektől, hogyan írj olyan leírást, amely alapján Claude valóban meghívja, és hogyan állíts össze 5 működő szerepkört 30 perc alatt.
Az Ailoot használatáról szóló gyakorlati útmutatót a [dokumentációban](https://ailoot.ai/docs/) találod.
## Mi az alügynök a Claude Code-ban, és miért nem „csak egy újabb Skill”?
Főbb tudnivalók Az alügynök specializált AI-asszisztens, amely saját kontextussal, rendszerprompttal és eszközkészlettel rendelkezik. Az Anthropic hivatalos dokumentációja olyan asszisztensként írja le, amely egy külön kontextusban végez el egy mellékfeladatot, és csak az eredmény összefoglalóját adja vissza. A [Skillekkel](https://ailoot.ai/blog/hu/claude-code-skills-library/) ellentétben, amelyek betöltődnek a fő beszélgetésbe, és annak memóriájával dolgoznak, az alügynök elszigetelten működik – és éppen ez a legfőbb értéke.
A Claude Code dokumentációja így határozza meg:

Az alügynökök meghatározott feladattípusokra szakosodott AI-asszisztensek. Akkor használj alügynököt, ha egy mellékfeladat keresési eredményekkel, naplókkal vagy olyan fájltartalmakkal töltené meg a fő beszélgetést, amelyekre később nem lesz szükséged: az alügynök a saját kontextusában végzi el a munkát, és csak az eredményt adja vissza.

— Claude Code-dokumentáció, https://code.claude.com/docs/en/sub-agents
Vállalkozók számára érthető megfogalmazásban: képzelj el egy ingatlanirodát. Van egy igazgató, egy marketinges, egy ügyvéd és néhány értékesítési vezető. Ha egyetlen alkalmazott váltogat ezek között a szerepek között, az nem csapat, hanem egy túlterhelt ember. Akkor alakul ki csapat, ha mindenkinek saját kontextusa és felelősségi köre van, az igazgató pedig csak kiosztja a feladatokat és összefogja az eredményeket. A Claude Code alügynökei ugyanígy működnek. A fő beszélgetés az igazgató. Az alügynök olyan szakértő, akinek szűk körű feladata, saját kontextusa és eszközkészlete van. Ha egy feladat megfelel a szakértő leírásának, az igazgató delegálja neki – anélkül, hogy belemerülne a részletekbe. ### 5 cél, amelyre az Anthropic az alügynököket tervezte Az Anthropic dokumentációja pontosan öt okot sorol fel arra, hogy saját alügynököt hozz létre:

Az alügynökök segítenek megőrizni a kontextust azáltal, hogy a kutatást és a megvalósítást a fő beszélgetésen kívül tartják; érvényesítik a korlátozásokat az alügynök által használható eszközök korlátozásával; lehetővé teszik a konfigurációk projektek közötti újrafelhasználását felhasználói szintű alügynökök révén; célzott rendszerpromptokkal specializálják a viselkedést egyes területekre; valamint a feladatok gyorsabb és olcsóbb modellekhez, például a Haikuhoz irányításával szabályozzák a költségeket.

— Claude Code-dokumentáció, https://code.claude.com/docs/en/sub-agents
A listából a nem programozók számára a **költségszabályozás** a leggyakorlatiasabb szempont. Egy összetett kutatási feladatot elküldhetsz az olcsó Haiku modellnek, miközben a fő beszélgetést Sonnettel vagy Opusszal folytatod. A tokenmegtakarítás egyenesen arányos. ### Ellenőrizd a telepített verzió beágyazási támogatását Az útmutató sablonjaiban egy fő munkamenet közvetlenül delegál a dolgozóknak. A régebbi dokumentáció „az alügynökök nem indíthatnak másik alügynököt” mondatát ne kezeld időtlen szabályként: a beágyazás a telepített verziótól és engedélyezett eszközöktől függ. A [külön beágyazottalügynök-útmutató](https://ailoot.ai/blog/hu/claude-code-nested-subagents/) verzióhoz kötött receptet tárgyal. Mélyebb delegálás tervezése előtt a saját telepítéseden igazold a támogatást. ## Miben különbözik az alügynök a Skillektől, a Slash Commandoktól és a Hookoktól?
Főbb tudnivalók A Claude Code-nak négy bővítési mechanizmusa van, és ezek nem cserélhetők fel egymással. A CLAUDE.md állandó tudás, amely mindig betöltődik. A Skillek kész módszertanok, amelyek aktiváláskor betöltődnek a fő beszélgetésbe. A Slash Commandok kifejezett `/command` gombok egyszeri műveletekhez. Az alügynökök saját kontextussal rendelkező szakértők, akiknek a fő beszélgetés delegál feladatokat. A leggyakoribb hiba, hogy valaki alügynököt hoz létre, holott Skillre lenne szüksége.
A [Skillsről](https://ailoot.ai/blog/hu/claude-code-skills-library/) szóló korábbi útmutató elmagyarázza, hogy a Claude Code-ban a skillek és a slash commandok lényegében egyetlen formátumba olvadtak össze. Az alügynök azonban másfajta entitás – nem egyszerűen „egy nagyobb skill”. A négy mechanizmus összefoglaló táblázata: | Funkció | CLAUDE.md | Skill | Slash command | Alügynök | |----|----|----|----|----| | Mikor töltődik be | Mindig | Ha aktiválódik a leírás | Kifejezett `/name` paranccsal | Delegáláskor vagy `@agent-name` használatakor | | Hol működik | A fő kontextusban | A fő kontextusban | A fő kontextusban | A saját, elkülönített kontextusában | | Modell | Ugyanaz, mint a fő beszélgetésben | Ugyanaz | Ugyanaz | Bármelyik – Haiku, Sonnet, Opus, örökölt | | Eszközök | Minden elérhető eszköz | Örökölt | Örökölt | A `tools:` mezővel korlátozható | | Mit ad vissza | \- | A fő beszélgetésbe illesztve | Beillesztve | Csak a végső összefoglaló | | Párhuzamosság | \- | Nem | Nem | Igen – több is párhuzamosan | | Munkamenetek közötti memória | Közeli fájlok | Közeli fájlok | Közeli fájlok | `memory: user/project/local` mező | Egy angol nyelvű útmutatóban jól hangzik így: a Skillek receptek; az alügynökök specializált kollégák. Egyszerűen: a skillek olyanok, mint a receptek; az alügynökök pedig olyanok, mint a specializált kollégák. A gyakorlatban így működik: a Skillek automatikusan aktiválódnak, ha a leírásuk illik a feladatra, az alügynököket viszont kifejezetten hívják meg – vagy a fő beszélgetés dönt úgy, hogy delegál, vagy te hívod meg az alügynököt név szerint. ### Döntési fa: „Melyiket válasszam?” Ha arra gondolsz, hogy „Szeretném, ha Claude megcsinálná X-et”, válaszolj erre a négy kérdésre: 1. **Olyan tudásról van szó, amelynek mindig elérhetőnek kell lennie?** Például: „a felhasználó által választott nyelvre lokalizálunk” vagy „nem használunk em dash jeleket”. Tedd a `CLAUDE.md` fájlba. 2. **Olyan aktiválható módszertanról van szó, amelyet most manuálisan végzel?** Például: „Minden hétfőn értékesítési jelentést írok.” Készíts belőle **Skillt**. 3. **Olyan feladatról van szó, amely elhasználja a fő beszélgetés kontextusát, vagy párhuzamosan is futtatható?** Például: „alapos kutatás 30 forrás alapján” vagy „biztonsági audit, miközben egy új funkciót írok”. Készíts belőle **alügynököt**. 4. **Automatikus választ szeretnél egy Claude Code-eseményre?** Például: „minden Edit után futtasd a lintert”. Írj egy **Hookot**. A vállalkozók feladatainak 90%-a az első két kategóriába esik. Az alügynökök haladó szintű eszközök: akkor jönnek jól, amikor az „egyszerre egy feladat” módról áttérsz a vezénylésre. ## Hol találhatók az alügynökök, és melyik élvez elsőbbséget?
Főbb tudnivalók A Claude Code alügynökei öt helyen találhatók, eltérő prioritással – a szervezet által felügyelt beállításoktól a pluginokig. Ha két fájlnak azonos a neve, a magasabb prioritású érvényesül. Az egyéni vállalkozók leggyakoribb beállítása a `~/.claude/agents/` mappa az általános személyes ügynökökhöz, valamint a `.claude/agents/` mappa egy adott projekten belül a projektspecifikus ügynökökhöz.
Az alügynökhierarchia öt szintből áll, a legmagasabbtól a legalacsonyabb prioritásig rendezve: | Szint | Elérési út | Mire vonatkozik | Prioritás | |----|----|----|----| | Enterprise | Szervezeti felügyelt beállítások | A vállalat összes dolgozója | 1 (legmagasabb) | | Munkamenet | CLI-flag `--agents` JSON-nal | Csak az aktuális munkamenet | 2 | | Projekt | `.claude/agents/name.md` | Csak ez a projekt | 3 | | Személyes | `~/.claude/agents/name.md` | Minden projekted | 4 | | Plugin | `/agents/name.md` | A plugin minden engedélyezett használati helyén | 5 (legalacsonyabb) | A prioritási logika megegyezik a Skillek és a CLAUDE.md esetében alkalmazottal: a szervezet felülírja a CLI-t, a CLI a projektet, a projekt a személyes beállítást, a személyes beállítás pedig a plugint. ### Tudnivalók a betöltésről Az alügynökök a Claude Code-munkamenet indításakor töltődnek be. Ha manuálisan szerkesztesz egy ügynökfájlt a lemezen, a módosítások csak a munkamenet újraindítása után lépnek életbe. Az interaktív `/agents` felületen végzett szerkesztések azonnal érvénybe lépnek. Hatókörönként egy alügynök egy fájlt jelent. Ha a `.claude/agents/` mappa tartalmaz egy `code-reviewer.md` fájlt, és van mellette egy másik `code-reviewer.md` is (például egy régi biztonsági másolatból), a Claude Code csendben figyelmen kívül hagyja az egyiket. Értesítés nem jelenik meg. A pluginokhoz tartozó alügynökök külön esetet jelentenek. Biztonsági korlátozások vonatkoznak rájuk: a `hooks`, `mcpServers` és `permissionMode` mezőket **nem támogatják**. Ez megakadályozza, hogy egy harmadik féltől származó plugin engedélyt kapjon tetszőleges kód futtatására a gépeden. ## Az alügynökfájl felépítése: frontmatter és törzs
Főbb tudnivalók Az alügynök egyetlen Markdown-fájl, amelynek tetején YAML-frontmatter, alatta pedig rendszerprompt található. A minimum két mező: `name` (kisbetűk + kötőjelek) és `description` (mikor delegáljon Claude). A teljes séma 16 mezőt tartalmaz: tools, disallowedTools, model, permissionMode, maxTurns, skills, mcpServers, hooks, memory, background, effort, isolation, color, initialPrompt. Az Anthropic azt javasolja, hogy a leírás legyen tömör – minél egyértelműbb az aktiválási feltétel, annál pontosabban aktiválja Claude az ügynököt.
Példa a hivatalos dokumentációból a minimális változatra – mindössze 9 sor: ```markdown --- name: code-reviewer description: Reviews code for quality and best practices tools: Read, Glob, Grep model: sonnet --- You are a code reviewer. When invoked, analyze the code and provide specific, actionable feedback on quality, security, and best practices. ``` Ennyi elég. Ha egy felhasználó azt írja a fő beszélgetésben, hogy „nézd át a PR-emet”, Claude a „reviewer / code / quality” kifejezéseket a leírással egyezteti, és delegálja a feladatot az alügynöknek. Az alügynök elolvassa a diffet, megjegyzéseket készít, majd összefoglalót küld vissza a fő beszélgetésnek. A fő beszélgetést nem zsúfolják tele a naplók és a köztes elemzések. ### A teljes frontmatter-séma | Mező | Kötelező | Funkciója | |----|----|----| | `name` | Igen | Egyedi azonosító, kisbetűk + kötőjelek. A fájlnévnek NEM kell megegyeznie vele | | `description` | Igen | Mikor delegál Claude. Ez az automatizálás aktiválási feltétele | | `tools` | Nem | Az engedélyezett eszközök listája. Ha kimarad, az összes eszközt örökli a szülőtől | | `disallowedTools` | Nem | Tiltólista. Először ezt alkalmazza, utána a `tools` mezőt | | `model` | Nem | `haiku` / `sonnet` / `opus` / teljes ID / `inherit` (alapértelmezett) | | `permissionMode` | Nem | `default` / `acceptEdits` / `auto` / `dontAsk` / `bypassPermissions` / `plan` | | `maxTurns` | Nem | A leállás előtti lépések korlátja | | `skills` | Nem | A rendszerindításkor az alügynök kontextusába betöltendő Skillek | | `mcpServers` | Nem | Kizárólag ennek az alügynöknek elérhető MCP-szerverek | | `hooks` | Nem | PreToolUse / PostToolUse / Stop, az alügynökre korlátozva | | `memory` | Nem | `user` / `project` / `local` – mappa a munkamenetek közötti memóriához | | `background` | Nem | `true` – mindig a háttérben fusson. Alapértelmezés: `false` | | `effort` | Nem | `low` / `medium` / `high` / `xhigh` / `max` – a gondolkodás szintje | | `isolation` | Nem | `worktree` – külön git worktree-ben fusson | | `color` | Nem | UI-szín: red / blue / green / yellow / purple / orange / pink / cyan | | `initialPrompt` | Nem | Az első mondat, amelyet az alügynök a `--agent` használatával történő indításkor lát | A `model: haiku` mező testesíti meg a listában említett „költségszabályozást”. Ha van egy kutatási ügynököd, amely 50 oldalnyi dokumentációt olvas, futtasd Haikuval, így az Opushoz képest 5–7-szeres megtakarítást érhetsz el. Az `isolation: worktree` mező egy fontos problémát kezel: egy alügynök potenciálisan veszélyes módosításokat végez (refaktorálás, migráció), te viszont nem szeretnéd, hogy a munkapéldányodhoz nyúljon. Állítsd be az `isolation: worktree` értéket, és a Claude Code ideiglenes git-másolatot készít a projektből; az alügynök ott dolgozik, majd egy diffet ad vissza ellenőrzésre. ### A fájl törzse a rendszerprompt A frontmatter után hagyományos Markdown következik – ez az alügynök rendszerpromptja. Nincs szükség különleges szerkezetre, de ez a minta bevált: 1. **Ki vagy te** – egy mondat: „te kódellenőr vagy”, „te biztonsági auditor vagy”, „te dokumentációkarbantartó vagy”. 2. **Mikor hívnak meg, és mit teszel először** – az első 2–3 művelet a feladat kézhezvétele után. 3. **Ellenőrzési vagy lépéslista** – 5–10 pont, amelyet az alügynök követ. 4. **Mit adsz vissza** – a végső jelentés formátuma. Ez döntő fontosságú: ha nem adsz meg formátumot, az alügynök strukturált összefoglaló helyett „esszét” készít. 5. **Mit NEM teszel** – kifejezett korlátozások. E szakasz nélkül az alügynök rögtönözni kezd. A fájl törzse legfeljebb 200–500 sor legyen. Ha hosszabb, helyezd át a terjedelmes hivatkozásokat külön, közeli fájlokba, és hivatkozz rájuk a promptban. ## Hogyan írj olyan leírást, amely alapján Claude biztosan meghívja az alügynököt?
Főbb tudnivalók A Claude a munkamenet kezdetén csak a description mezőt látja, és ezt használja annak eldöntésére, hogy delegáljon-e. A fórumokon a leggyakoribb panasz így hangzik: „Írtam egy alügynököt, de Claude nem hívja meg.” A megoldás egy háromrészes képlet: mit csinál + idézőjelek közé tett aktiváló kifejezések + mikor NE használd. Az Anthropic kifejezetten azt javasolja, hogy az alügynök leírásában szerepeljenek olyan kifejezések, mint a „use proactively” vagy a „use immediately after”, mert ezek arra ösztönzik Claude-ot, hogy meghívja az alügynököt.
Gyakori probléma, hogy valaki beállít egy alügynököt kódellenőrzéshez, de Claude mindent maga végez el, anélkül, hogy az ügynököt használná. Ennek rendszerint egyetlen oka van: a leírás például így szól: „Helper for code review.” Claude nem érti, mikor kell aktiválnia. ### A hatékony leírás képlete (3 rész) **1. rész – mit csinál.** Egy mondat az eredményről, nem a folyamatról. Ne azt írd, hogy „kódot elemez”, hanem azt, hogy „sebezhetőségeket keres a kódban, és súlyosságot, valamint javítási javaslatot tartalmazó listát ad vissza”. **2. rész – mikor aktiválódjon.** 3–5 idézőjelbe tett kifejezés úgy, ahogy a felhasználók ténylegesen kérni szokták. Ne találgasd – nézd meg a beszélgetési előzményeket és a valós megfogalmazásokat. **3. rész – mikor NE aktiválódjon.** 1–2 kifejezés a hasonló feladatokról, amelyekre ennek az alügynöknek nem kell reagálnia. E szakasz nélkül két hasonló ügynök folyamatosan összeakad. ### A varázskifejezés: „Use Proactively” Az Anthropic hivatalos dokumentációja közvetlen ajánlást tesz:

Claude automatikusan delegál feladatokat a kérésedben szereplő feladatleírás, az alügynök konfigurációjának description mezője és az aktuális kontextus alapján. A proaktív delegálás ösztönzéséhez olyan kifejezéseket adj az alügynök leírásához, mint a „use proactively”.

— Claude Code-dokumentáció, https://code.claude.com/docs/en/sub-agents
Más szóval, ha a leírásból hiányoznak az egyértelmű jelzések, Claude alapértelmezés szerint **nem** szívesen hívja meg az alügynököt. Add hozzá a „use proactively” vagy a „use immediately after writing code” kifejezést, és az aktiválás jelentősen gyakoribbá válik. ### Így néz ki egy jó leírás ```yaml description: | Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code. Returns prioritized list of issues with severity and fix recommendations. Do not invoke for documentation changes, README edits, or commit message rewrites - these are handled by doc-maintainer. ``` Mi működik ebben: - A „reviews” + „returns” igék konkrét eredményt határoznak meg, nem folyamatot. - A „Proactively” és az „immediately after” kifejezések egyértelmű aktiválási feltételek. - A „Do not invoke for...” kizárja az ütközést egy hasonló alügynökkel. - A description angol nyelve megszokott. Claude angolul jobban illeszti hozzá a feladatokat. ## 5 használatra kész alügynökszerep, amely 10 perc alatt bevethető
Főbb tudnivalók Ha nem szeretnéd az első alügynöködet a nulláról megírni, használj bevált mintákat, és szabd őket a saját igényeidre. Öt tipikus feladatokat lefedő szerepet vázoltam fel: code-reviewer (módosítások utáni kódellenőrzés), security-auditor (sebezhetőségek és kiszivárgások felderítése), research-agent (alapos kutatás 8+ forrásból), doc-maintainer (a dokumentáció és a kód összehangolása), valamint refactor-agent (biztonságos refaktorálás git worktree-n keresztül). Mindegyikhez tartozik egy használatra kész sablon, amelyet bemásolhatsz és testre szabhatsz.
Az alábbi szerepek mindegyike egyetlen fájl, `.claude/agents/.md`. A fájl létrehozása után indítsd újra a Claude Code-ot, nyisd meg az `/agents` felületet, és ellenőrizd, hogy az új ügynök megjelenik-e a listában. Ezután az `@agent-name` használatával hívhatod meg. ### 1. code-reviewer – kódellenőrzés minden módosítás után Ez az Anthropic dokumentációjának hivatalos példája, munkafolyamatra szabva: ```markdown --- name: code-reviewer description: | Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code. tools: Read, Grep, Glob model: inherit color: blue --- You are a senior code reviewer ensuring high standards of code quality. When invoked: 1. Read the diff and changed-file list supplied by the main session. If missing, ask the main session to provide them. 2. Use Read, Grep, and Glob to inspect the relevant files. 3. Return findings without changing files or running shell commands. Review checklist: - Code is clear and readable - Functions and variables are well-named - No duplicated code - Proper error handling - No exposed secrets or API keys - Input validation implemented - Test coverage adequate - Performance considerations addressed Provide feedback organized by priority: - Critical issues (must fix before merge) - Warnings (should fix) - Suggestions (consider improving) Format: for each issue - file:line + 1 sentence why it's a problem + concrete fix. ``` A kulcs a `tools: Read, Grep, Glob`: az ellenőr fájlolvasó és kereső eszközöket kap, Bash-, Write- és Edit-hozzáférés nélkül. A diffet a fő munkamenet készíti elő és adja át. A puszta utasítás, hogy csak `git diff` fusson, nem korlátoz egy teljesen megadott Bash eszközt. ### 2. security-auditor – sebezhetőségek és kiszivárgások felderítése Ez a szerep az `opus` modellt használja alaposabb gondolkodáshoz, ugyanazzal a Read, Grep és Glob eszközkorláttal. A tartós memória kimarad ebből a csak olvasó sablonból, mert az ügynökmemória bekapcsolása memóriaírási képességet is ad: ```markdown --- name: security-auditor description: | Security audit specialist. Use proactively to find OWASP Top 10 vulnerabilities, exposed secrets, injection risks, broken auth. Run before any deploy or merge to main. tools: Read, Grep, Glob model: opus color: red --- You are a security auditor. Find exploitable vulnerabilities, not style issues. Audit checklist: - SQL / NoSQL injection - XSS (stored, reflected, DOM-based) - CSRF / SSRF risks - Hardcoded secrets (API keys, tokens, passwords) - Broken auth / session management - Insecure deserialization - Missing input validation - Path traversal - Open redirects - Insecure direct object references (IDOR) For each finding: - Severity: Critical / High / Medium / Low - File:line - Attack scenario in 1–2 sentences - Fix recommendation with code example Skip linter or style noise. Report only exploitable issues. ``` Eszközhasználat szempontjából ez csak olvasható szerep, `model: opus` beállítással az összetett ellenőrzésekhez, például a sebezhetőségek láncolatához. ### 3. research-agent – alapos kutatás 8+ forrásból Ezt a mintát maga az Anthropic ismerteti a többügynökös kutatási rendszeréről szóló cikkében. A kulcs a kifejezett kimeneti formátum és a nyers eredmények kiírásának tiltása: ```markdown --- name: research-agent description: | Deep web research specialist. Use proactively for fact-finding, competitive analysis, gathering external documentation, comparing approaches across multiple sources. tools: WebFetch, WebSearch, Read, Write model: sonnet maxTurns: 30 color: purple --- You are a research analyst. Goal: synthesized brief, not raw search dumps. Process: 1. Decompose the question into 3–5 sub-queries 2. WebSearch each sub-query, fetch top 3–5 sources per query 3. Cross-verify claims across at least 2 independent sources 4. Reject SEO-farm and aggregator content; prefer primary sources 5. Quote verbatim with URL attribution for any specific claim 6. Return: TL;DR (3 bullets) + Findings + Sources (8+ domains minimum) Anti-patterns to avoid: - Don't cite a fact from a single source - Don't paraphrase quotes as if they were verbatim - Don't return raw search result dumps to the parent - Don't include filler intro / outro ("Hope this helps") ``` A `maxTurns: 30` védelemként szolgál, hogy a kutatás ne fajuljon végtelen iterációvá. Az Anthropic ezt az értéket a többügynökös rendszeréről szóló cikkében közli:

Az a többügynökös rendszer, amelyben a vezető ügynök Claude Opus 4, az alügynökök pedig Claude Sonnet 4 modelleket használtak, 90.2%-kal felülmúlt egyetlen Claude Opus 4-et.

— Anthropic Engineering, https://www.anthropic.com/engineering/multi-agent-research-system
A kilencven százalékos különbség a kutatási benchmarkfeladatokra vonatkozik. A gyakorlatban az üzleti feladatoknál a növekedés kisebb, de az általános mérték hasonló. ### 4. doc-maintainer – a dokumentáció és a kód szinkronban tartása Ez a szerep `model: haiku` modellt használ – tipikus példa a „költségszabályozásra”. A dokumentációhoz nincs szükség Opusra; Haiku harmadakkora költségért elvégzi a munkát: ```markdown --- name: doc-maintainer description: | Documentation sync specialist. Use after merging features to update README, API docs, CHANGELOG. Reads recent commits, identifies undocumented changes, updates docs proactively. tools: Read, Write, Edit, Glob, Grep, Bash model: haiku memory: project color: green --- You maintain documentation in sync with code. When invoked: 1. Run `git log --since="last release"` to see recent changes 2. Read README.md, docs/, CHANGELOG.md 3. Identify gaps: new features without docs, removed APIs still documented, version mismatches Output: - Updated files (use Edit, not Write - preserve existing structure) - CHANGELOG.md entry in Keep-A-Changelog format - List of changes you made (actual diff summary, not paraphrase) Style rules: - Active voice, present tense - Code examples must be copy-pasteable - No marketing language ("powerful", "robust", "seamless") - No filler ("This guide will help you...") ``` ### 5. refactor-agent – biztonságos refaktorálás worktree-n keresztül Ez a szerep az `isolation: worktree` beállítást használja – az alügynök a repository külön példányában dolgozik, és csak akkor olvasztod össze a változtatásait, ha jóváhagyod: ```markdown --- name: refactor-agent description: | Safe refactor specialist. Use for renames, extracts, inlines that shouldn't touch your working copy until reviewed. Runs in a temporary git worktree. tools: Read, Edit, Write, Bash, Grep, Glob model: sonnet isolation: worktree permissionMode: acceptEdits color: yellow --- You refactor code without changing behavior. Strict rules: 1. Tests must pass BEFORE and AFTER the refactor. If pre-refactor tests fail, STOP and report. 2. One atomic refactor per commit (extract, rename, inline). 3. Never change public APIs without explicit instruction. 4. Never modify tests unless they test the refactored implementation directly. Process: - Run test suite -> baseline - Make atomic refactor - Run test suite -> verify - Commit with conventional message: refactor(scope): what Return: summary of changes + worktree path so user can diff and merge. ``` Ezzel a szereppel megszűnik a legfájdalmasabb refaktorálási probléma: „Elrontottam valamit, és nem tudom visszacsinálni”. Az eredeti példány érintetlen marad, az alügynök pedig elszigetelt worktree-ben dolgozik. Nemcsak a használatra kész alügynököket szeretnéd másolni, hanem **olyan kombinációt összeállítani, amely stabil eszközzé teszi Claude-ot**? Az alügynökök az **AI-klónod** részei: így adhatsz Claude-nak olyan specializált csapatot, amely a te logikád szerint dolgozik. A módszertan három pillére: **AI-klón** (Skills + Subagents) + **[Second Brain](https://ailoot.ai/blog/hu/claude-code-second-brain/)** + **Context Engineering**. Ez a kombináció találgató asszisztensből olyan eszközzé alakítja Claude-ot, amely a te logikád szerint gondolkodik. ## 5 alügynök párhuzamos indítása: vezénylő + végrehajtók
Főbb tudnivalók Az alügynökök legnagyobb erőssége a párhuzamos végrehajtás. Egyetlen fő beszélgetés tartja kézben a tervet, miközben öt (vagy tíz) specializált alügynök dolgozik egyszerre a különböző fázisokon, mindegyik a saját kontextusában. A fő beszélgetés összegyűjti és ellenőrzi az eredményeket. Ez a soros munkához képest 3–5-szörös gyorsulást jelent, és megszünteti a „kontextusszennyezést” is, amikor a fő beszélgetés megtelik naplókkal és köztes elemzésekkel.
A párhuzamos vezénylés olyan, mint „a karmester és a zenekar”. A karmester kezében van a terv, nem ő írja a kottát, és ellenőrzi, hogyan játszanak a zenészek. Ha valaki rossz hangot játszik, a karmester arra kéri, hogy játssza újra, nem pedig megpróbálja helyette befejezni a művet. A vállalkozóknak közelebb álló hasonlat egy marketingügynökség, amely egy új ügyfél stratégiáját készíti elő. Az egyik elemző SWOT-elemzést készít, egy másik versenytárselemzést végez, egy harmadik közönségprofilt állít össze, egy vezető elemző kiszűri a költségkeretbe nem illő hipotéziseket, a projektmenedzser pedig összeállítja a végső prezentációt. A Claude Code-ban ez a munkafolyamat egyetlen mondattal indul – és a kritikus már a folyamat része, nem utólag érkezik. ### Minimális vezénylőprompt A fő beszélgetésben egy mondat is elég: ``` Launch five subagents in parallel: three research-agents on different sources (Anthropic docs, GitHub repos, AI bloggers), one critic-agent to filter out weak conclusions, and one summary-agent for the final document. Context: I am writing a guide about X. Target length: 2,000 words with sources. Before starting, each one reads CLAUDE.md. ``` Claude ezután delegálja a munkát az öt ügynöknek. Mindegyik a saját kontextusában dolgozik: a kutatóügynökök a nekik kijelölt forrásokat használják, a kritikus szűr, az összefoglaló ügynök pedig összeállítja a dokumentumot. Csak a végső összefoglalók kerülnek vissza a fő beszélgetésbe. ### Mikor éri meg a párhuzamosítás? Nem minden esetben. A párhuzamos végrehajtás csak akkor indokolt, ha: 1. A feladatok **függetlenek**. Ha a research-agent #2 a research-agent #1 eredményére vár, nincs párhuzamosság – lényegében egymás után dolgoznak. 2. A feladatok **hosszú ideig tartanak**. A „záró szóközök eltávolításának” párhuzamosítása értelmetlen; az alügynökök indításának költsége felemészti a nyereséget. 3. **Megfelelő keretekkel rendelkezel**. Erről részletesebben az alábbi külön szakasz szól – a párhuzamos alügynökök gyorsan fogyasztják a tokeneket. ### Az Anthropic Multi-Agent v2 rendszere: a következő lépés 2026 májusában az Anthropic kiadta a Multi-Agent Orchestration v2-t, amely három fontos szempontban különbözik a párhuzamos alügynökök indításának klasszikus megközelítésétől. Erről bővebben a következő szakaszban. ## Újdonságok a Multi-Agent v2-ben: Orchestration, Outcomes, Dreaming
Főbb tudnivalók 2026. május 6-án, a San Franciscó-i Code with Claude konferencián az Anthropic bejelentette a Managed Agents v2 három funkcióját – mindhárom nyilvános béta állapotban van. A Multi-Agent Orchestration lehetővé teszi, hogy egy vezető ügynök felbontsa a munkát, és párhuzamosan delegálja a feladatokat a szakértőknek egy megosztott fájlrendszer használatával. Az Outcomes segítségével sikerkritériumokat írhatsz, az eredményt pedig egy külön értékelő ügynök ellenőrzi. A Dreaming olyan, mint a REM-alvás: egy ütemezett folyamat elolvassa a korábbi munkameneteket, mintákat keres, majd frissíti az ügynök memóriáját.
### Multi-Agent Orchestration: megosztott fájlrendszer + munkafolyamat közbeni bejelentkezések Az Anthropic így írja le ezt a funkciót:

Ha a munka túl nagy egyetlen ügynöknek, a többügynökös vezénylés lehetővé teszi, hogy a vezető ügynök részekre bontsa a feladatot, és minden részt egy saját modellel, prompttal és eszközökkel rendelkező szakértőnek delegáljon. Ezek a szakértők párhuzamosan dolgoznak egy megosztott fájlrendszeren, és eredményeiket a vezető ügynök megosztott kontextusába továbbítják.

— Anthropic – Újdonságok a Claude Managed Agentsben, https://claude.com/blog/new-in-claude-managed-agents
A klasszikus alügynökökhöz képest a fő különbség a **megosztott fájlrendszer**. Korábban minden alügynök teljes elszigeteltségben dolgozott, az információcsere pedig kizárólag a visszaküldött összefoglalón keresztül történt. Most a szakértők egy megosztott mappába írhatnak, a vezető ügynök pedig a munka előrehaladtával olvassa az eredményeket, nem csak a végén. Ez megoldja azt a problémát, hogy „mindenki egész nap dolgozott, a végén pedig kiderült, hogy két ember össze nem egyeztethető megközelítést alkalmazott”. A második újítás a **munkafolyamat közbeni bejelentkezés**. A vezető ügynök megállhat, és bármelyik szakértőtől megkérdezheti, hogy „hogy halad”, majd módosíthatja az átfogó tervet. Ez hasonló ahhoz, ahogyan egy valódi csapatvezető dolgozik. ### Outcomes: rubrika lépésről lépésre szóló utasítások helyett Az Outcomes használatakor sikerkritériumokat írsz, az ügynök pedig megtalálja az elérésükhöz vezető utat. Egy külön értékelő a saját kontextusában ellenőrzi az eredményt, így azt nem „szennyezi be” a fő ügynök gondolatmenete.

Ez a szokásos promptolási ciklushoz képest akár 10 ponttal is javította a feladatmegoldás sikerességét, a legnagyobb növekedést pedig a legnehezebb feladatoknál érte el.

— Anthropic – Újdonságok a Claude Managed Agentsben, https://claude.com/blog/new-in-claude-managed-agents
A kihívást jelentő feladatoknál elért tízszázalékos javulás komoly eredmény. Különösen akkor, ha a feladat úgy szól, hogy „állíts össze egy hosszú cikket, amely megfelel ezeknek a minőségi kritériumoknak”, nem pedig úgy, hogy „kövesd az 1–7. lépést”. ### Dreaming: az ügynökök a munkamenetek között is tapasztalatot gyűjtenek Ez a leginkább újszerű koncepciójú funkció. Az ügynök átnézi a korábbi munkameneteket, mintákat keres a sikeres és a hibás esetekben, majd frissíti a memóriatárat. Beállíthatod, hogy a változtatások alkalmazása előtt kézi ellenőrzésre legyen szükség, vagy az ügynök önállóan is módosíthatja a memóriát. Az Anthropic beszámolója szerint a jogi technológiával foglalkozó Harvey a Dreaming bevezetése után körülbelül hatszoros növekedést ért el a jogi szövegezési feladatok sikerességében. Ez már éles környezetben működik, nem csupán bemutatóban. ### Mit jelent ez a programozni nem tudó vállalkozók számára? A Multi-Agent Orchestration jelenleg a Claude Agent SDK-n keresztül érhető el, közvetlenül a Claude Code CLI-ben nem. Az irány azonban egyértelmű: a vezénylés a „kézzel indítasz el N alügynököt” módról afelé halad, hogy „leírod a feladatot, a vezető ügynök pedig eldönti, kinek és hogyan delegálja”. Ha most ismerkedsz az alügynökökkel, még ne aggódj a v2 miatt. Tanuld meg a klasszikus „1 fő beszélgetés + 3–5 különböző szerepű alügynök” mintát, és 3–6 hónap múlva természetesen áttérhetsz a Managed Agents használatára. ## 7 hiba, amely megbénítja az alügynököket
Főbb tudnivalók A leggyakoribb alügynökproblémákat nem Claude hibái, hanem maguknak az alügynököknek a hibás beállításai okozzák. Ilyen a aktiváló kifejezések nélküli leírás, az alügynök használata olyan feladathoz, amelyre Skill való, 60 ügynök párhuzamos futtatása „mert menő”, az összes eszköz átadása minden ügynöknek, a kimeneti formátum megadásának hiánya, a homályos meghívás, valamint a feladatalapú helyett szerepközpontú architektúra. Mindegyik hiba vagy az aktiválást, vagy az alügynök eredményét rontja el.
### 1. hiba. A „Helper for X” leírások nem indítják el az ügynököt Tünet: megírtál egy alügynököt, ellenőrizted a szerkezetét, minden érvényes, de Claude nem hívja meg a felhasználói kérésekre. Ennek szinte mindig ugyanaz az oka: a leírás túl elvont, például „Helper for code review.” A megoldás: írj 3–5 valódi felhasználói kifejezést idézőjelben közvetlenül a leírásba, és add hozzá a „use proactively” / „use immediately after” kifejezést. ### 2. hiba. Alügynök készítése Skill helyett Az alügynök többe kerül, mint a Skill: saját kontextust hoz létre, betölti a saját rendszerpromptját, és több tokent használ. Ha a feladat rövid, nem foglalja el a fő kontextust, és egy menetben elvégezhető, akkor Skillt érdemes használni, nem alügynököt. Példa a kerülendő mintára: a `format-validator` alügynök, amely 20 szabály alapján ellenőriz egy JSON-sémát. Ez Skill legyen: egy modell, nincs szükség elszigetelésre, nem kell külön kontextust betölteni. ### 3. hiba. Azonnal „60 párhuzamos ügynök” indítása Ez a legelterjedtebb illúzió. Látsz egy bejegyzést, amely szerint „1,500 ügynököm dolgozik”, és arra gondolsz, hogy „nekem is ezt kellene csinálnom”. A gyakorlatban 60 ügynök egy óra alatt felemészti a Pro csomag korlátait, egymásnak ellentmondó eredmények halmát állítja elő, a nap végére pedig semmi sem készül el. Egy Mediumon publikáló szakember így fogalmaz: A megoldás: kezdj egyetlen alügynökkel és egyetlen feladattal. Ha már magabiztosan használod, adj hozzá egy második, eltérő szerepű ügynököt. Ha a két ügynök vezénylését is elsajátítottad, lépj tovább egy 3–5 fős csapatra. Ha tegnap telepítetted a Claude Code-ot, ma pedig már „20 ügynököt futtatsz párhuzamosan”, az biztosan kódhibákhoz és a használati korlátok kimerítéséhez vezet. ### 4. hiba. Minden eszköz megadása minden ügynöknek Ha a kódellenőr hozzáfér a Bashhez, a Write-hoz és a WebFetchhez, az komoly biztonsági és költségkockázat. Egy ellenőrnek ne legyen írási jogosultsága, és az internethez való hozzáférésre még kevésbé van szüksége. A megoldás: korlátozd szigorúan a `tools` mezőt. A kódellenőr csak a `Read, Grep, Glob` eszközöket kapja meg. A biztonsági auditor ugyanezeket az olvasó- és keresőeszközöket, valamint a fő munkamenettől kapott diffet használja. A Bash hozzáadása shellképességet ad; nem korlátozza automatikusan az ügynököt a `git diff` használatára. A kutatóügynök a `WebFetch, WebSearch, Read, Write` eszközöket kapja. Egyetlen alügynöknek se adj több jogosultságot annál, mint amennyire az adott feladathoz szüksége van. ### 5. hiba. Az alügynök nyers eredményekkel tölti meg a fő kontextust Ha egy kutatóügynök ezt küldi vissza a fő beszélgetésbe: „itt van mind a 30 oldal, amit találtam, majd döntsd el te”, akkor elvesztetted az alügynökök legfőbb előnyét: a zaj elkülönítését. A megoldás: írd elő kifejezetten a kimeneti formátumot az alügynök rendszerpromptjában. „CSAK ezt add vissza: 3 pontos TL;DR + 5 forrás listája. NE legyen benne kódhalmaz, és NE legyen benne nyers keresési eredmény.” A formátum legyen **szigorú** – az alügynök ne alakíthassa „esszévé”. ### 6. hiba. Homályos meghívás: nem egyértelmű delegálási kérés Az alügynök **nem látja** a fő párbeszéd előzményeit. Tiszta kontextussal + CLAUDE.md-vel + mindazzal indul, amit kifejezetten megírtál neki. Ha csak annyit írsz, hogy „javítsd ki a hitelesítést”, az alügynök találgatni fog. Ehelyett ezt írd: „Javítsd ki azt az OAuth-átirányítási hurkot, amely miatt a felhasználó sikeres bejelentkezés után a /dashboard helyett a /login oldalra kerül. Fájl: src/lib/auth.ts.” Egyszerű szabály: delegáláskor annyi kontextust adj az alügynöknek, amennyit egy frissen a projekthez csatlakozó új vállalkozónak adnál. ### 7. hiba. Feladat-alapú ügynökök helyett szerepkör-alapú ügynökök Csábító lehet a következő minta: „hozzunk létre egy frontend-developer, backend-developer és qa-engineer ügynököt, és dolgozzanak csapatként”. Nem működik. Minden „szerep” elveszíti a teljes projekt kontextusát, és nem tudnak megegyezni a részletekben, mert nem látják egymás munkáját. A megoldás: az alügynök visszatérő **feladatot** végezzen jól meghatározott kimenettel, ne egy **szerepkört** töltsön be. Ne „frontend-developer” legyen, hanem „explore-ui-tree”, „refactor-component” vagy „audit-accessibility”. Minden feladatalapú alügynök egy konkrét munkát végez, és egy konkrét eredményt ad vissza. ## Mennyibe kerülnek a párhuzamos alügynökök, és mikor érik meg?
Főbb tudnivalók A párhuzamos alügynökök 3–5-ször gyorsabban fogyasztják a tokeneket, mint a soros munka. Egy Pro csomaggal (\$20/hónap) öt párhuzamos alügynök indítása egy óra alatt felhasználja a keretet. A Max 5x (\$100/hónap) reális minimum a rendszeres párhuzamos munkához. Az alügynök legalább 10 percnyi összpontosított munkát igénylő feladatoknál éri meg – egy README elírásának kijavításához indítva több tokent használ el, mint amennyi időt megtakarít.
| Konfiguráció | Napi használat aktív munkavégzés mellett | |----|----| | 1 Claude Code-munkamenet | ~\$13 | | 3 párhuzamos alügynök | ~\$30-40 | | 5–10 párhuzamosan | \$50-130 | | 30 ügynök (10 fejlesztő × 3 alügynök) | \$300-400 | Ha összetett feladatokon öt párhuzamos alügynököt indítasz, egy órán belül elfogy a Pro csomag kerete. A Max 5x ($100) reális minimum a rendszeres párhuzamos munkához. A csapatoknál és az Enterprise csomagnál a költség kérdését már az eszközkeret szintjén kezelik. Ha többet szeretnél megtudni a Claude Code-ban való tokenmegtakarításról, olvasd el a [használati korlátokról szóló külön útmutatót](https://ailoot.ai/blog/hu/claude-code-token-limits-saving/). Az alügynököknél az a legfontosabb szabály, hogy legalább **10 percnyi** összpontosított munkát igénylő feladatra éri meg alügynököt használni. Ha a feladat ennél rövidebb, ne hozz létre alügynököt; végezd el a fő beszélgetésben vagy egy Skillel. ## Hogyan illesztheted be az alügynököket az AI-klónodba és a Second Brainbe?
Főbb tudnivalók Az alügynökök jelentik a Claude Code-módszertan negyedik lépését. A logikus sorrend: először a [CLAUDE.md](https://ailoot.ai/blog/hu/claude-md-template/) (állandó kontextus), aztán a [Skills](https://ailoot.ai/blog/hu/claude-code-skills-library/) (kész módszertanok), majd a [Second Brain](https://ailoot.ai/blog/hu/claude-code-second-brain/) (a projekt tudásstruktúrája), végül pedig az alügynökök (specializált végrehajtók). Ha megfordítod a sorrendet, eredmények helyett csak felhajtást kapsz. A CLAUDE.md nélküli alügynök találgat; Skills nélkül mindig az elejéről ismétli ugyanazt a munkát; tudásstruktúra nélkül pedig átlagos választ ad.
Az alügynök három dologra támaszkodik, amelyeknek már a projektben kell lenniük, mielőtt létrehozod az első szakértőt: 1. **A megfelelő [CLAUDE.md](https://ailoot.ai/blog/hu/claude-md-template/).** Az alügynök indulás előtt elolvassa a CLAUDE.md-t – ez a „munkaszerződése”. Enélkül nem ismeri a projekt kontextusát, korlátozásait és hangvételét. Találgatni fog. 2. **Alapvető [Skills](https://ailoot.ai/blog/hu/claude-code-skills-library/).** A Skill egy csomagba foglalt módszertan. Az alügynök csak azokat a Skilleket tölti be, amelyekre szüksége van, nem mindet egyszerre. Skillek nélkül minden alkalommal az elejéről kezdi ugyanazt a munkát. 3. **[Second Brain](https://ailoot.ai/blog/hu/claude-code-second-brain/): tudásstruktúra.** A `business/` mappa (vagy a szakterületednek megfelelője) olyan könyvtár, amelyet az összes alügynök használ. Enélkül az alügynök átlagos ChatGPT-választ ad, amely nem különbözik mások válaszaitól. Ha megfordítod a sorrendet, eredmények helyett csak felhajtást kapsz. A „60 párhuzamos alügynököm van” egy üres `business/` mappával valójában 60 átlagos ChatGPT-munkamenetet jelent, ugyanazzal a megközelítéssel. A teljes kombináció – **AI-klón + Second Brain + Context Engineering** – alkotja azt a **három pillért**, amely következetessé teszi Claude-ot. Az alügynökök az AI-klón részei: olyan módon adhatsz Claude-nak specializált csapatot, hogy az a te logikád szerint dolgozzon.
### Források - [Egyéni alügynökök létrehozása – Claude Code-dokumentáció](https://code.claude.com/docs/en/sub-agents) - [A Claude Code önállóbb működésének lehetővé tétele – Anthropic News](https://www.anthropic.com/news/enabling-claude-code-to-work-more-autonomously) - [Hogyan építettük fel többügynökös kutatási rendszerünket – Anthropic Engineering](https://www.anthropic.com/engineering/multi-agent-research-system) - [Az Agent Skills segítségével felkészítjük az ügynököket a valós világra – Anthropic Engineering](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) - [Újdonságok a Claude Managed Agentsben (Multi-Agent v2, Outcomes, Dreaming) – Anthropic blog](https://claude.com/blog/new-in-claude-managed-agents)
A leggyorsabban úgy kezdheted, ha az első példából a `code-reviewer` fájlt bemásolod a `.claude/agents/code-reviewer.md` útvonalra, újraindítod a Claude Code-ot, majd a következő commitnál meghívod az `@agent-code-reviewer` ügynököt. 5 perc alatt kiderül, hogy szükséged van-e alügynökökre, vagy elegendő a fő beszélgetés.
Az Ailoot felfedezését az [ailoot.ai](https://ailoot.ai/) oldalon folytathatod.
## Kérdések és válaszok: Claude Code-alügynökök: felépítés, öt szerepkör és vezénylés ### Egy ellenőr csak git diffet futtathat attól, hogy ezt írja a promptja? Nem. A Bash eszköz megadása shellképességet ad; a prompt nem parancsengedélylista. A csak olvasó ellenőrsablon kihagyja a Bash, Write és Edit eszközöket, a diffet pedig a fő munkamenettől kapja. ### Hogyan nézi meg az ellenőr a friss változásokat Bash nélkül? A fő munkamenet a delegálásban megadja a diffet és a módosított fájlok listáját. Az ellenőr ezután Read, Grep és Glob segítségével olvassa és keresi a fájlokat, és szerkesztés nélkül ad megállapításokat. ## Ailoot · A vállalat és projektportfóliója Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít. A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben. Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.