Claude Code: استفاده از مدلهای Sonnet و Opus برای بهینهسازی هزینهها
قابلیت “مشاور” (advisor) در Claude Code به کاربران اجازه میدهد تا مدل Sonnet 5.5 را برای اجرای وظایف اصلی به کار گیرند و در مواقع تصمیمگیریهای کلیدی، مدل قدرتمندتر Opus 5.5 را به عنوان مشاور فراخوانند. این امر از طریق دستوراتی مانند /advisor opus یا claude –advisor opus امکانپذیر است. در این مقاله، سه روش برای فعالسازی این قابلیت با هدف کاهش هزینههای استفاده از Opus، قوانین تطابق مدلها، الگوریتم محاسبه مصرف و دو نمونه فایل زیرمجموعه (subagent) ارائه میشود.
راهنمای رسمی Anthropic: انتخاب مدل Claude
(پیشزمینه: راهنمای رسمی Anthropic: کدام مدل Claude را انتخاب کنیم؟ اکثر کارها با Opus 5.5 شروع میشوند.)
(پیشزمینه تکمیلی: Anthropic مدل Claude Haiku 5.5 را معرفی کرد: ارزانترین و سریعترین مدل کوچک.)
فهرست مطالب
فعالسازی قابلیت مشاور در Claude Code
برای اجرای برنامهنویسی با Sonnet 5.5 و دریافت بازخورد از Opus 5.5 در تصمیمگیریهای مهم، قابلیت داخلی “مشاور” در Claude Code این امکان را فراهم میکند. این مقاله با استناد به مستندات رسمی، نحوه فعالسازی، مدلهای قابل تطابق، الگوریتم محاسبه مصرف و روشهای تأیید فعالسازی را شرح میدهد تا کاربران بتوانند به راحتی آن را پیکربندی کنند.
هدف این مقاله آموزش نحوه راهاندازی ترمینال با دستور claude --model sonnet --advisor opus است.
بر اساس مستندات رسمی Claude Code، قابلیت مشاور به Claude اجازه میدهد تا در طول اجرای یک وظیفه، با مدل دوم و معمولاً قویتر مشورت کند. مشاور به کل مکالمه، از جمله هر فراخوانی ابزار و نتایج آن، دسترسی دارد و پس از بررسی، توصیههایی را برای مدل اصلی ارسال میکند تا مدل اصلی با در نظر گرفتن آنها به کار خود ادامه دهد. این قابلیت در حال حاضر به عنوان “آزمایشی” (experimental) طبقهبندی شده است و رفتار، قیمت و دامنه دسترسی آن ممکن است تغییر کند.
مستندات رسمی استفاده از این قابلیت را برای وظایف طولانی که شامل مراحل متعدد هستند، بیشتر آنها کارهای روتین بوده و کیفیت نهایی به تصمیمات کلیدی بستگی دارد، توصیه میکند. مثالهای ذکر شده در مستندات شامل بازسازی (refactor) در مقیاس بزرگ، رفع اشکالاتی که به طور مکرر رخ میدهند، و کارهایی که نیاز به بازبینی مستقل قبل از اتمام دارند، میباشد. برای وظایف کوتاه که نیاز به برنامهریزی پیچیده ندارند، یا وظایفی که در هر مرحله به قویترین مدل نیاز دارند، مستندات پیشنهاد میکنند که مستقیماً مدل اصلی را به Opus تغییر دهید.
مستندات رسمی، قابلیت مشاور را با سه روش دیگر استفاده از مدلهای ترکیبی مقایسه میکند:
روشهای فعالسازی قابلیت مشاور
روش اول: فعالسازی درون جلسه (session)
با تایپ دستور /advisor در جلسه، منوی انتخاب مدل ظاهر میشود. همچنین میتوانید نام مدل را مستقیماً پس از آن وارد کنید.
پس از این کار، صفحه با پیام “Advisor set to” به همراه نام مدل نمایش داده میشود. این انتخاب در تنظیمات کاربر (advisorModel) ذخیره شده و در جلسات بعدی نیز اعمال خواهد شد. از نسخه v2.1.260 به بعد، در نسخه دسکتاپ، Remote Control و حالت غیرتعاملی -p نیز میتوان از نسخه متنی /advisor استفاده کرد.
روش دوم: ویرایش فایل تنظیمات (settings.json)
این روش بدون نیاز به شروع جلسه فعال میشود.
روش سوم: استفاده از پرچم (flag) هنگام راهاندازی
این روش فقط بر روی جلسه فعلی تأثیر میگذارد و تنظیمات ذخیره شده را تغییر نمیدهد.
نکات مهم در استفاده از پرچم مشاور
در این مرحله، ممکن است با مشکل پیدا نکردن پرچم مواجه شوید. مستندات رسمی ذکر کردهاند که --advisor در خروجی دستور claude --help لیست نمیشود. در نسخه 2.1.326، با اجرای claude --help، واقعاً هیچ اثری از “advisor” دیده نمیشود. با این حال، پرچم همچنان کار میکند. در تست انجام شده، وارد کردن نام مدل ناموجود به عنوان مشاور با دستور --advisor منجر به خطای Error: The model "zzzbad" cannot be used as an advisor. شد.
پس از فعالسازی، پیامی مبنی بر “Advisor Tool (experimental) is on and may use more tokens · /advisor” نمایش داده میشود. برای غیرفعال کردن آن، دستور /advisor off را تایپ کنید یا در منو گزینه “No advisor” را انتخاب کنید. برای غیرفعال کردن کامل، میتوانید متغیر محیطی CLAUDECODEDISABLEADVISORTOOL=1 را تنظیم کنید. با این کار، دستور /advisor ناپدید شده و advisorModel در فایل تنظیمات نادیده گرفته میشود.
پیشنیازهای استفاده از قابلیت مشاور
قبل از استفاده، سه شرط زیر را بررسی کنید:
قوانین تطابق مدلها
Claude Code مدلها را رتبهبندی میکند و رتبه مشاور باید برابر یا بالاتر از مدل اصلی باشد. در جدول سازگاری رسمی، ردیفهای مربوط به نسل 5.5 به شرح زیر است؛ مدل Fable توسط سازنده به عنوان مدل برای سختترین و طولانیترین وظایف تعیین شده است.
بر اساس این جدول، Sonnet 5.5 نمیتواند مشاور Opus 5.5 باشد و Haiku 5.5 نیز نمیتواند مشاور Sonnet 5.5 باشد.
به عنوان مشاور میتوان از نامهای مستعار fable، opus، sonnet یا مدل کامل مانند claude-opus-5-5 استفاده کرد.
در اینجا لازم به ذکر است که نامهای مستعار بسته به ارائهدهنده به نسخههای متفاوتی اشاره دارند. در Anthropic API، opus، sonnet و haiku به ترتیب به Opus 5.5، Sonnet 5.5 و Haiku 5.5 اشاره دارند.
در Claude Platform on AWS، sonnet به Sonnet 4.6 و haiku به Haiku 4.5 اشاره دارد. برای اطمینان از نسخه مورد نظر، از نام مدل کامل استفاده کنید.
دو نوع واکنش در صورت تطابق نادرست وجود دارد: اگر مدل مشخص شده با --advisor خود نتواند به عنوان مشاور عمل کند (مانند Haiku 4.5)، Claude Code با خطا خاتمه مییابد. اگر مدل بتواند به عنوان مشاور عمل کند اما رتبه آن پایینتر از مدل اصلی باشد، جلسه به طور عادی آغاز میشود، اما مدل اصلی بدون مشاور کار خواهد کرد.
هنگامی که Claude مشاور را فراخوانی میکند، خطی با عنوان “Advising” به همراه نام مدل مشاور در تاریخچه مکالمه ظاهر میشود. نتایج به سه دسته تقسیم میشوند:
زمانبندی فراخوانی مشاور
زمان فراخوانی توسط مدل تعیین میشود. متن اصلی مستندات بیان میکند که Claude “تمایل به مشورت” (tends to consult) در سه زمان دارد: قبل از تصمیمگیری در مورد رویکرد، هنگام مواجهه با خطاهای مکرر، و قبل از اعلام اتمام کار. مستندات همچنین تأکید میکنند که “زمانبندی مبتنی بر مدل است نه قوانین ثابت” (the timing is model-driven rather than rule-based).
مستندات همچنین ذکر میکنند که هیچ تنظیماتی برای محدود کردن یا اجبار تعداد فراخوانیها وجود ندارد. اگر میخواهید بیشتر یا کمتر مشورت شود، در دستورالعملها ذکر کنید، به عنوان مثال: “consult the advisor before you continue”.
Claude معمولاً توصیههای مشاور را دنبال میکند. مستندات توضیح میدهند که اگر مراحل توصیهشده توسط مشاور قابل اجرا نباشند، یا اگر محتوای فایل با توصیهها مغایرت داشته باشد، Claude این تضادها را بیان کرده و توصیهها را کورکورانه نمیپذیرد.
محاسبه مصرف و هزینهها
هر بار که مشاور فراخوانی میشود، مدل مشاور کل مکالمه را دوباره میخواند. این توکنها با نرخ مدل مشاور محاسبه میشوند و علاوه بر مصرف خود مدل اصلی، هزینه اضافی دارند. حسابهای API هزینه ورودی و خروجی مدل مشاور را پرداخت میکنند؛ در طرحهای اشتراک، این هزینه در سقف مصرف طرح لحاظ میشود و استفاده از مشاور Fable در برخی طرحها باعث کسر اعتبار مصرف (usage credits) میشود.
طبق گفته رسمی، مشاور فقط در نقاط تصمیمگیری فراخوانی میشود، بنابراین ترکیب یک مدل اصلی سریع با یک مشاور قوی، معمولاً ارزانتر از استفاده تمام وقت از مدل قویتر است. با این حال، بخش خواندن مکالمه توسط خود مشاور، کش نمیشود و هر بار کل مکالمه مجدداً پردازش میشود. هرچه مکالمه طولانیتر باشد، توکنهای بیشتری برای هر مشاوره خوانده میشود. تغییر وضعیت مشاور در میانه کار، حافظه پنهان دستورالعمل (prompt cache) مدل اصلی را باطل نمیکند.
برای اطلاع از میزان مصرف واقعی، دستور /usage را تایپ کنید. مستندات رسمی میگویند که مصرف مشاور در مجموع مصرف جلسه که توسط /usage نمایش داده میشود، لحاظ میگردد.
مثال: زیرمجموعههای Haiku 5.5 برای وظایف تخصصی
در یک پروژه، میتوان سه زیرمجموعه Haiku 5.5 ایجاد کرد که هر کدام مسئولیتهای مشخصی مانند پردازش کتابخانهها، تعیین نقاط فراخوانی و بررسی تفاوتهای کد (diff) را بر عهده داشته باشند. این یک الگوی تقسیم کار خودساخته است که در مستندات Anthropic وجود ندارد، اما مطابق با فرمت مستندات زیرمجموعه قابل پیادهسازی است.
زیرمجموعهها در فایلهای Markdown در پوشه .claude/agents/ قرار میگیرند. در ابتدای فایل، تنظیمات با استفاده از YAML frontmatter و سپس دستورالعمل سیستمی برای زیرمجموعه نوشته میشود. فیلدهای اجباری فقط name و description هستند. فیلد model میتواند مقادیر haiku، sonnet، opus، fable، نام مدل کامل یا inherit را بپذیرد.
فایل اول با نام .claude/agents/search.md ذخیره میشود و فقط به ابزارهای خواندنی دسترسی دارد.
فایل دوم با نام .claude/agents/audit.md ذخیره میشود و علاوه بر دسترسی به Bash برای مشاهده تاریخچه git، در محیط worktree اجرا میشود.
در اینجا سه نقطه وجود دارد که ممکن است با مشکل مواجه شوید:
استفاده از زیرمجموعه Explore با مدل ارزانتر
زیرمجموعه داخلی Explore به طور پیشفرض از همان مدل جلسه اصلی استفاده میکند. مستندات رسمی اشاره میکنند که با تعریف یک زیرمجموعه سفارشی به نام Explore در پروژه و تنظیم model: haiku، میتوان از مدل ارزانتری برای کاوش استفاده کرد.
علاوه بر این، زیرمجموعهها تنظیمات مشاور را به ارث میبرند و ممکن است با تطابق مدل خود، دوباره آن را بررسی کنند. بر اساس جدول سازگاری، Haiku 5.5 میتواند Opus 5.5 را به عنوان مشاور داشته باشد، بنابراین زیرمجموعه Haiku نیز ممکن است از Opus سوال بپرسد.
اگر میخواهید Claude Code وظایف مربوط به انتخاب ابزار، انتخاب مسیر و تلاش مجدد را به Jev بسپارد تا تشخیص دهد کدام سطح از Agent باید فراخوانی شود، به ادامه مطلب توجه کنید.
ادغام با Jev برای تصمیمگیریهای پیچیده
Jev که به صورت Jev نوشته میشود، یک مدل تصمیمگیری است که توسط TypeSafe AI در سپتامبر 2026 عرضه شده و ارتباطی با Anthropic ندارد. قبلاً مقالهای اختصاصی در مورد آن منتشر کردهایم.
برای استفاده از Jev، ابتدا در وبسایت TypeSafe AI ثبتنام کرده، پلاگین آن را کپی و در Claude نصب کنید. سپس کلید API را وارد نمایید. پس از آن، با افزودن یک قانون در CLAUDE.md، هر زمان که Claude Code نیاز به استفاده از Jev داشته باشد، آن را فراخوانی خواهد کرد.
پرسش و پاسخ متداول
س۱. مشاور را فعال کردهام، اما هیچگاه پیام “Advising” را نمیبینم.
پاسخ: ابتدا تطابق مدل اصلی و مشاور را در جدول سازگاری بررسی کنید. همچنین مطمئن شوید که ارائهدهنده Bedrock، Agent Platform یا Foundry نباشد. تنظیم متغیرهایی مانند DISABLE_TELEMETRY نیز مانع دریافت پرچمهای قابلیت در جلسه میشود. مشاور فقط در نقاط تصمیمگیری فراخوانی میشود و در وظایف کوتاه ممکن است اصلاً استفاده نشود.
س۲. با دستور /advisor مشاور را تغییر دادم، اما اعمال نشد.
پاسخ: اگر API در این مکالمه قبلاً تطابق مشاور فعلی را رد کرده باشد، مشاور جدید پس از اجرای /clear یا /compact اعمال خواهد شد. شروع یک جلسه جدید نیز این مشکل را حل میکند.
س۳. آیا میتوان کاری کرد که Claude در هر مرحله از Opus بپرسد؟
پاسخ: هیچ تنظیماتی برای اجبار یا محدود کردن تعداد فراخوانیها وجود ندارد؛ این امر فقط از طریق دستورالعملها امکانپذیر است. برای وظایفی که در هر مرحله به قویترین مدل نیاز دارند، مستندات پیشنهاد میکنند که مستقیماً مدل اصلی را به Opus تغییر دهید.
س۴. آیا Haiku 4.5 میتواند مشاور باشد؟
پاسخ: خیر. Haiku 4.5 میتواند به عنوان مدل اصلی برای فراخوانی مشاور استفاده شود، اما خود نمیتواند مشاور باشد. اگر با --advisor آن را مشخص کنید، Claude Code با خطا خاتمه مییابد.
س۵. آیا استفاده از این قابلیت در شرکتهایی که از دروازه LLM (gateway) استفاده میکنند، امکانپذیر است؟
پاسخ: این بستگی به این دارد که آیا دروازه درخواستها را به طور کامل به Anthropic API منتقل میکند یا خیر. اگر دروازه advisor_20260301 را تشخیص ندهد، نسخههای قدیمی در هر دور پاسخ 400 خطا برمیگردانند. در نسخه v2.1.280 این مشکل رفع شده است. در حال حاضر، Claude Code بدون مشاور مجدداً ارسال میکند تا مکالمه قطع نشود، اما مشاور نیز استفاده نخواهد شد.
نحوه فعالسازی حالت مشاور در Claude Code
با دستور /advisor opus در حین مکالمه، پیشفرض ذخیره میشود. همچنین میتوانید advisorModel را در فایل تنظیمات بنویسید، یا با --advisor opus هنگام راهاندازی، فقط برای آن جلسه فعال کنید. این پرچم در claude --help لیست نمیشود.
آیا فعالسازی مشاور در Claude Code باعث صرفهجویی در اعتبار میشود؟
سازنده میگوید معمولاً ارزانتر از استفاده تمام وقت از مدل قویتر است، اما مشاور هر بار کل مکالمه را مجدداً میخواند و کش نمیشود. کاهش 11.9 درصدی هزینهها که Anthropic اعلام کرده، مربوط به مدلهای نسل 4.6 در API است.
مقالات مرتبط:
- Claude Code قابلیت سفارشیسازی تم custom-theme را فعال کرد: تغییر رنگبندی با یک جمله + پسزمینه متحرک (آموزش استفاده)
- مدل پرطرفدار Jev چیست؟ هوش مصنوعی که فقط تصمیمگیری میکند، ساخته شده توسط پیشکسوتان OpenAI: تا 200 برابر سریعتر و 400 برابر ارزانتر برای وظایف مشابه
- مقایسه Cloudflare با مدل تصمیمگیری متنباز Clef در مقابل Jev: تأخیر نصف شد، اما هزینه واحد 5.7 برابر بیشتر است.



