Pe proiecte medii și mari, trimiterea agentului principal să caute prin sute de fișiere de cod poluează rapid fereastra de context și crește vertiginos costurile tokenilor. Arhitectura de Subagenți din Claude Code permite agentului principal (Orchestrator) să lanseze procese secundare independente (Workers) în background.
Fiecare subagent primește o misiune îngustă și clară (de exemplu: ‘Investighează toate fișierele de configurare pentru rute API’ sau ‘Rulează suita de teste Cypress și identifică motivul eșecului’). Subagentul rulează într-un spațiu izolat, citește zeci de fișiere și returnează agentului părinte doar sinteza concluzivă.
Această paradigmă păstrează sesiunea principală curată, rapidă și concentrată pe deciziile strategice de arhitectură, permițând rezolvarea de sarcini care altfel ar depăși chiar și un context de 200.000 de tokeni.
Sintaxă, opțiuni și concepte cheie
| Opțiune / Concept | Descriere practică |
|---|---|
Orchestrator Agent |
Procesul principal de dialog cu utilizatorul care descompune problema și coordonează execuția. |
Worker Subagent |
Instanță de execuție efemeră care rulează sarcini de citire, căutare cu ripgrep sau execuție de teste. |
Context Isolation |
Garanția că miile de tokeni de loguri sau fișiere secundare inspectate de subagent nu sunt salvate în istoricul principal. |
Delegation Hand-off |
Formatul structurat de raportare prin care subagentul predă concluziile către firul principal. |
Exemple practice de terminal și cod
Exemplul 1: Exemplu de delegare automată pentru auditarea dependențelor în consolă
Cum orchestrează Claude Code o echipă de investigare în fundal.
> /plan Auditează securitatea tuturor dependențelor npm și propune versiuni actualizate.
[Claude Code lansează subagentul #1: 'npm-audit-worker']
• Subagentul citește package-lock.json (15.000 linii izolate)
• Verifică vulnerabilitățile cunoscute împotriva bazei CVE
[Subagentul finalizează și raportează doar 3 pachete vulnerabile]
Claude Code principal: 'Subagentul a finalizat auditul. Am găsit 3 dependențe critice (lodash, axios, tar). Iată planul de actualizare...'Rezultat & Impact
Sesiunea principală rămâne compactă și gata de editare directă.Greșeli frecvente și bune practici
- Încercarea de a delega sarcini de scriere concurentă pe aceleași fișiere către subagenți paraleli, riscând conflicte de suprascriere.
- Neutilizarea comenzii /compact înainte de lansarea unor sarcini majore de delegare.