راهنمای همکاری Agent Teams در Claude Code
Agent Teams در Claude Code به چندین نمونه Claude امکان می‌دهد تا روی وظایف مهندسی پیچیده به‌صورت موازی همکاری کنند. یک عامل Lead هماهنگی می‌کند و چندین عامل Teammate زیروظیفه‌ها را به‌صورت موازی اجرا می‌کنند — افزایش بهره‌وری 3-5 برابری.
Agent Teams در برابر زیرعامل‌ها
دو حالت چندعاملی برای سناریوهای مختلف — درک کنید چه زمانی Agent Teams یا زیرعامل‌های سبک‌وزن را انتخاب کنید.
| معیار | Agent Teams | زیرعامل‌ها |
|---|---|---|
| حالت همکاری | موازی چندنشستی، با هماهنگی Lead | فراخوانی ترتیبی در همان نشست |
| مقیاس | پروژه‌های بزرگ (>1000 خط تغییر) | وظایف کوچک/متوسط، واگذاری سریع |
| ارتباط | فهرست وظایف مشترک + پیام‌های صندوق پیام | فراخوانی مستقیم توابع |
| نیازمندی مدل | Lead به Opus 4.6+ نیاز دارد | هر مدلی |
معماری همکاری
عامل Lead نقش مدیر پروژه را برای تجزیه وظایف و تجمیع نتایج ایفا می‌کند؛ عامل‌های Teammate زیروظیفه‌های مشخص را به‌صورت موازی اجرا می‌کنند.
Lead (هماهنگ‌کننده)
Lead Agent (Opus 4.8)
فهرست وظایف مشترک
همه عامل‌ها می‌خوانند/می‌نویسند
صندوق پیام
پیام‌رسانی میان عامل‌ها
Teammate 1
وظایف فرانت‌اند
Teammate 2
وظایف بک‌اند
Teammate 3
وظایف تست
عامل Lead
نقش «مدیر پروژه» تیم را دارد، از Opus 4.8 استفاده می‌کند و مسئول درک نیازمندی‌ها، تجزیه وظایف، تخصیص آن‌ها به Teammates و تجمیع نتایج است.
عامل Teammate
عامل‌های اختصاصی که زیروظیفه‌های مشخص را اجرا می‌کنند و می‌توانند برای صرفه‌جویی در هزینه از Sonnet 4.6 استفاده کنند. پس از تکمیل، نتایج را در فهرست وظایف مشترک می‌نویسند.
فهرست وظایف مشترک
چک‌لیست ساختاریافته‌ای از وظایف که میان همه عامل‌ها مشترک است. Lead وظایف را ایجاد می‌کند، Teammates آن‌ها را برمی‌دارند و وضعیت را به‌روزرسانی می‌کنند — هماهنگی بدون تعارض.
ارتباط از طریق صندوق پیام
سیستم پیام‌رسانی ناهم‌زمان میان عامل‌ها برای انتقال زمینه پیچیده، درخواست شفاف‌سازی یا گزارش نتایج میانی — با پرهیز از وابستگی فراخوانی مستقیم.
فعال‌سازی و پیکربندی
حالت کاری Agent Teams را در CLAUDE.md اعلام کنید تا Claude Code در سناریوهای مناسب به‌طور خودکار همکاری چندعاملی را فعال کند.
پیش‌نیازها
- Claude Code v2.1.32 یا بالاتر
- عامل Lead از مدل claude-opus-4-8 استفاده می‌کند
- کلید API در QCode.cc (از Fable 5 / Opus 4.8 پشتیبانی می‌کند)
استفاده از طریق QCode.cc
QCode.cc از همه مدل‌های لازم برای Agent Teams (Fable 5 / Opus 4.8 / Sonnet 4.6) کاملاً پشتیبانی می‌کند و محدودیتی برای درخواست‌های موازی چندنشستی ندارد.
نمونه پیکربندی CLAUDE.md
# CLAUDE.md — فعال‌سازی حالت Agent Teams
# به Claude بگویید که راه‌اندازی همکاری چندعاملی مجاز است
## پیکربندی Agent Teams
- وظایف پیچیده به‌طور خودکار به زیروظیفه‌ها تقسیم می‌شوند
- حداکثر 5 عامل Teammate موازی
- عامل Lead از claude-opus-4-8 استفاده می‌کند
- عامل Teammate از claude-sonnet-4-6 استفاده می‌کند
## اصول تخصیص وظایف
- فرانت‌اند/بک‌اند/تست می‌توانند به‌صورت موازی اجرا شوند
- در صورت نیاز به زمینه مشترک، از طریق صندوق پیام ارتباط برقرار کنید
- هر Teammate پس از اتمام کار، فهرست وظایف مشترک را به‌روزرسانی میکندزیرعاملهای سفارشی (اشاره با @)
Claude Code v2.1.32+ از تعریف و فراخوانی زیرعامل‌های متخصص از طریق نحو @ پشتیبانی می‌کند و به هر نوع وظیفه، هوش مصنوعی اختصاصی خودش را می‌دهد.
زیرعامل‌های سفارشی چیستند
برای تعریف نقش‌های اختصاصی، مرزهای توانمندی و دستورالعمل‌های رفتاری، فایل‌های Markdown را در .claude/agents/ ایجاد کنید. هنگام فراخوانی با @، زیرعامل آن نوع وظیفه را با شخصیت تخصصی خود مدیریت می‌کند تا خروجی متمرکزتر و حرفه‌ای‌تری ارائه دهد.
نمونه‌های استفاده
@security-auditor
ممیزی متمرکز آسیب‌پذیری‌های امنیتی
@perf-optimizer
تحلیل و بهینه‌سازی گلوگاه‌های عملکرد
@doc-writer
تولید مستندات و توضیحات API
تعریف زیرعامل سفارشی
# .claude/agents/security-auditor.md
---
name: security-auditor
description: عامل اختصاصی ممیزی امنیتی که کد را از نظر آسیب‌پذیری تحلیل می‌کند
model: claude-opus-4-8
tools: [read_file, bash]
---
شما یک مهندس امنیت ارشد هستید که بر این موارد تمرکز دارید:
- تشخیص آسیب‌پذیری‌های OWASP Top 10
- محافظت در برابر تزریق SQL و XSS
- بازبینی منطق احراز هویت و مجوزدهی
- اسکن امنیتی وابستگی‌ها
وقتی کدی دریافت می‌کنید، گزارش ساختاریافته‌ای از آسیب‌پذیری‌ها ارائه دهید.بهره‌وری مهندسی 10 برابری با Agent Teams
در QCode.cc ثبت‌نام کنید تا به پلتفرم پایدار توسعه‌دهندگان Fable 5 / Opus 4.8 دسترسی داشته باشید و قابلیت‌های کامل همکاری Agent Teams را فعال کنید.