کاهش ۴۰ درصدی هزینه استنتاج Claude Opus 5.5 برای توسعه‌دهندگان VS Code

اگر امروز برای استفاده از مدل‌های سطح بالا هزینه می‌پردازید، صورت‌حساب استنتاج شما با مدل جدید ۴۰٪ ارزان‌تر می‌شود. این کاهش قیمت، کف قیمتی را برای عامل‌های کدنویسی پیشرفته بازتعریف می‌کند. طبق گزارشی که در ۵ اکتبر ۲۰۲۶ منتشر شد، یک راهنمای فنی فاش کرد که مدل Claude Opus 5.5 نه‌تنها ارزان‌تر، بلکه ۳۰٪ سریع‌تر از نسل قبلی خود (Opus 5) است. اما یک نکته حیاتی وجود دارد: توسعه‌دهندگانی که از Microsoft Foundry در محیط VS Code استفاده می‌کنند، باید تنظیمات پیش‌فرض را به‌صورت دستی تغییر دهند تا مدل واقعاً فعال شود و سیستم از حالت پیش‌فرض خارج شود.

این تحول در حالی رخ می‌دهد که برنامه‌نویسان از چت‌های ساده به سمت گردش‌های کاری عامل‌محور (Agentic) — شبیه به داشتن یک دستیار متخصص که به‌جای پاسخ ساده، خودش مراحل اجرای پروژه را مدیریت می‌کند — حرکت می‌کنند. همان‌طور که در تحلیل قبلی ما درباره‌ی نحوه جلوگیری از نشت کلیدهای API در Claude Code اشاره کردیم، اکنون تمرکز از امنیت به سمت بهینه‌سازی هزینه‌ها جابه‌جا شده است. برای یک توسعه‌دهنده متوسط، این تغییر مثل جایگزینی یک اشتراک ماهانه گران‌قیمت با یک مدل «پرداخت به میزان مصرف» (Pay-as-you-go) است که در آن فقط برای «تفکر» واقعی مدل که عملاً استفاده می‌کنید، هزینه می‌پردازید.

شکاف پیکربندی

استقرار یک مدل در Foundry به این معنا نیست که Claude Code لزوماً از آن استفاده می‌کند. به‌صورت پیش‌فرض، Foundry مدل Claude Code را به سمت Sonnet 4.5 هدایت می‌کند. برای اجبار به استفاده از Opus 5.5، توسعه‌دهندگان باید فایل ~/.claude/settings.json خود را ویرایش کنند. این روش بر استفاده از دستور setx برای متغیرهای محیطی یا چسباندن آن‌ها در هر شل (Shell) ترجیح داده می‌شود، زیرا هم رابط خط فرمان (CLI) و هم افزونه VS Code مستقیماً این فایل را می‌خوانند.

دو متغیر محیطی خاص برای این کار مورد نیاز است: متغیر ANTHROPIC_MODEL مدلِ جلسه (Session) را تعیین می‌کند، در حالی که ANTHROPIC_DEFAULT_OPUS_MODEL تضمین می‌کند که نام مستعار 'opus' به استقرار نسخه ۵.۵ ارجاع داده شود. بدون تنظیم هر دو متغیر، عامل ممکن است به‌طور خاموش و بدون هشدار به Sonnet بازگردد. به‌طور مشخص، ANTHROPIC_MODEL باعث می‌شود Opus 5.5 به مدل اصلی جلسه تبدیل شود—خطی که اکثر راهنماهای موجود آن را نادیده می‌گیرند. در مقابل، ANTHROPIC_DEFAULT_OPUS_MODEL نام مستعار opus را که در تعاریف زیر-عامل‌ها (Subagents) و دستور /model استفاده می‌شود، بازنگری می‌کند.

جزئیات راه‌اندازی و الزامات

برای اجرای Claude Code روی Foundry، این مراحل فنی دقیق را دنبال کنید:

• استقرار (Deployment): مدل Claude Opus 5.5 را از کاتالوگ مدل‌های Foundry روی منبع (Resource) خود مستقر کنید.
• دسترسی‌ها (Permissions): نقش Azure AI User یا Cognitive Services User را به خود اختصاص دهید. هر یک از این دو نقش برای فراخوانی مدل کافی است.
• احراز هویت (Authentication): دستور az login را اجرا کنید. در صورتی که هیچ کلید API تنظیم نشده باشد، Claude Code به زنجیره اعتبارنامه‌های Azure بازمی‌گردد. اگر ترجیح می‌دهید از کلید API استفاده کنید، باید ANTHROPIC_FOUNDRY_API_KEY را در محیط سیستم یا فایل JSON خود تنظیم کنید.
• نام‌گذاری منبع (Resource Naming): برای ANTHROPIC_FOUNDRY_RESOURCE فقط از نام منبع استفاده کنید و از وارد کردن URL خودداری کنید. اگر به یک دامنه سفارشی یا نقطه انتهایی خصوصی (Private Endpoint) نیاز دارید، به‌جای آن از ANTHROPIC_FOUNDRY_BASE_URL استفاده کنید؛ هرگز هر دو را هم‌زمان تنظیم نکنید.
• یکپارچگی با VS Code: افزونه Claude Code را نصب کرده و عبارت "claudeCode.disableLoginPrompt": true را به فایل settings.json در VS Code اضافه کنید تا از تلاش افزونه برای هدایت شما به سمت ورود به حساب Anthropic جلوگیری شود.

تأیید اتصال

پس از پیکربندی، باید با استفاده از دستور /status در ترمینال یا پنل VS Code، مدل فعال را تأیید کنید. شما باید به دنبال سه نشانه خاص باشید: ارائه‌دهنده API باید روی Microsoft Foundry تنظیم شده باشد، نام منبع خاص شما ذکر شده باشد و استقرار Opus 5.5 به عنوان مدل فعال لیست شده باشد.

اگر خط مدل هنوز نام Sonnet را نشان می‌دهد، به این معنا است که خط ANTHROPIC_MODEL شناسایی نشده است. نکته کلیدی برای توسعه‌دهندگان این است که «استقرار در Foundry» و «استفاده توسط Claude Code» دو وضعیت کاملاً متفاوت هستند. بررسی /status یک تأیید پنج ثانیه‌ای است که مشخص می‌کند کدام یک از این دو وضعیت فعال است.

معیارهای هزینه و عملکرد

به نقل از گزارش dev.to، ساختار قیمت‌گذاری برای Opus 5.5 به شرح زیر است:

• ورودی (Input): ۴ دلار به ازای هر میلیون توکن
• خروجی (Output): ۲۰ دلار به ازای هر میلیون توکن
• خواندن از حافظه پنهان (Cache Reads): ۰.۲۰ دلار به ازای هر میلیون توکن

از آنجا که جلسات Claude Code به‌شدت به بازخوانی بستر متن (Context)—مانند ارسال دستورالعمل‌ها، فایل CLAUDE.md و تاریخچه گفتگو در هر نوبت—وابسته‌اند، قیمت ۰.۲۰ دلاری خواندن از حافظه پنهان، حیاتی‌ترین عامل برای بودجه‌های روزانه است. همچنین سرعت خروجی بیش از ۳۰٪ افزایش یافته است که این موضوع به‌ویژه هنگام اعمال تغییرات طولانی (Long Diff) در پنل VS Code کاملاً محسوس است.

مدیریت درجه تلاش (Effort)

مدل Opus 5.5 پارامتر خاصی به نام 'effort' معرفی کرده است که جایگزین دکمه تغییر وضعیت تفکر (Thinking Toggle) شده است. در این مدل، تفکر همیشه فعال است؛ هیچ دکمه‌ای برای جستجو و خاموش کردن آن وجود ندارد و متغیر MAX_THINKING_TOKENS هیچ تأثیری روی Opus 5.5 نمی‌گذارد. حالت Medium (متوسط) پیش‌فرض است، اما کاربران می‌توانند آن را از طریق دستور /effort یا لغزنده /model تغییر دهند.

سه راه برای تنظیم درجه تلاش وجود دارد:
۱. دستور /effort: استفاده از /effort high ،/effort low یا /effort auto (برای بازگشت به پیش‌فرض مدل) برای جلسه فعلی.
۲. انتخاب‌گر مدل (Model Picker): استفاده از فلش‌های چپ و راست در لغزنده effort. این تنظیم برای هر مدل به‌طور مجزا به خاطر سپرده می‌شود و به Opus 5.5 اجازه می‌دهد تنظیمات متمایز خود را حفظ کند.
۳. متغیرهای محیطی: متغیر CLAUDE_CODE_EFFORT_LEVEL در بلوک env بر همه چیز، از جمله دستور /effort اولویت دارد. این روش برای محیط‌های CI یا اجراهای اسکریپتی ایده‌آل است اما برای کارهای تعاملی باید از آن اجتناب کرد تا سردرگمی ایجاد نشود. (توجه: تنظیم کاربر effortLevel در سطح بالا نیز روی Opus 5.5 اعمال نمی‌شود).

در اینجا نحوه تطبیق سطوح تلاش با وظایف خاص Claude Code آمده است:

• Low (پایین): «این فایل را توضیح بده»، تغییر نام یک نماد (Symbol) یا نوشتن یک پیام کامیت.
• Medium (متوسط - پیش‌فرض): کارهای توسعه ویژگی‌های روزمره، رفع باگ‌ها و نوشتن تست‌ها.
• High / xhigh (بالا/بسیار بالا): بازسازی‌های گسترده در چندین فایل (Multi-file refactors)، مهاجرت‌های فریم‌ورک و باگ‌های پیچیده هم‌زمانی (Concurrency). این توانمندی در بازسازی‌های پیچیده، در گزارش‌های اخیر DevTools Review نیز تأیید شده است که Claude Code را در این زمینه پیشتاز مدل‌های مشابه می‌داند.
• Max (حداکثر): به‌ندرت و از طریق /effort max زمانی که حالت xhigh به‌وضوح پاسخگو نیست.

توکن‌های تفکر به عنوان خروجی با قیمت ۲۰ دلار در هر میلیون توکن محاسبه می‌شوند. بالا بردن درجه تلاش برای یک مسئله سخت و سپس کاهش سریع آن ارزان است، اما فعال نگه داشتن حالت High برای کل روز بسیار هزینه‌بر خواهد بود.

تخلیه پنهان توکن‌ها

یک ریسک بزرگ، «صورت‌حساب Opus» است؛ یعنی تمایل کارهای پس‌زمینه به مصرف توکن‌های گران‌قیمت. Claude Code کارهای کوچکی، مانند تولید عنوان جلسات را در پس‌زمینه اجرا می‌کند. در API استاندارد Anthropic، این کارها به مدل Haiku سپرده می‌شوند. اما در Foundry، این وظایف روی مدل اصلی شما (Opus 5.5) اجرا می‌شوند مگر اینکه یک مدل Haiku را مستقر کرده و ANTHROPIC_DEFAULT_HAIKU_MODEL را به آن ارجاع دهید.

عامل‌های فرعی (Subagents)، مانند عامل Explore که برای جستجو در مخزن (Repo) استفاده می‌شود، نیز مدل اصلی را به ارث می‌برند. برای جلوگیری از این اتفاق، توسعه‌دهندگان باید یک مدل ارزان‌تر را مستقر کرده و به‌طور صریح CLAUDE_CODE_SUBAGENT_MODEL را روی یک استقرار Sonnet یا Haiku تنظیم کنند. در این راستا، بررسی تأثیر پلاگین‌ها بر ارتقای مهارت مدل نشان می‌دهد که انتخاب مدل مناسب برای هر ابزار، تأثیر مستقیمی بر کیفیت خروجی نهایی دارد.

مثال پیکربندی برای مسیریابی مدل‌ها:

{
  "env": {
    "CLAUDE_CODE_USE_FOUNDRY": "1",
    "ANTHROPIC_FOUNDRY_RESOURCE": "your-foundry-resource-name",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-4-6"
  }
}

Foundry هیچ بررسی مدل در هنگام شروع (Startup) ندارد. اگر در نام استقرار غلط املایی داشته باشید، Claude Code تا اواسط جلسه به شما هشدار نمی‌دهد. ممکن است با خطایی مانند: "The model claude-sonnet-4-5 is not available on your foundry deployment." مواجه شوید. این اتفاق به این دلیل می‌افتد که سیستم سعی می‌کند مدلی را فراخوانی کند که منبع شما ندارد، در حالی که بقیه جلسه به‌درستی کار می‌کند و همین موضوع باعث می‌شود خطا به‌راحتی نادیده گرفته شود.

بهینه‌سازی عمر حافظه پنهان

عمر پیش‌فرض حافظه پنهان (Cache Lifetime) در Foundry تنها ۵ دقیقه است. اگر توسعه‌دهنده‌ای برای نوشیدن قهوه از سیستم فاصله بگیرد، در نوبت بعدی تمام بستر متن با قیمت کامل بازنویسی می‌شود. برای حل این مشکل، تنظیم ENABLE_PROMPT_CACHING_1H روی ۱ در بلوک env، عمر حافظه را به یک ساعت افزایش می‌دهد.

اگرچه نوشتن‌های یک‌ساعته با نرخ بالاتری نسبت به نوشتن‌های ۵ دقیقه‌ای محاسبه می‌شوند، اما برای جلساتی که دارای وقفه‌های زیاد هستند، به‌طور قابل‌توجهی ارزان‌ترند. نسخه‌های اخیر Claude Code همچنین از CLAUDE_CODE_PROMPT_CACHE_TTL=1h برای گفتگوی اصلی پشتیبانی می‌کنند.

برای به حداکثر رساندن بهره‌وری حافظه پنهان:

• روی یک مدل بمانید: جابه‌جایی بین Opus 5.5 و Sonnet در وسط جلسه، هر بار حافظه پنهان را پاک می‌کند.
• پیکربندی پیش‌فرض MCP: برخی از استقرارهای Azure جستجوی ابزارها را رد می‌کنند و تمام ابزارهای MCP را از ابتدا بارگذاری می‌کنند. افزودن یا حذف یک سرور MCP در وسط جلسه باعث ریست شدن حافظه پنهان می‌شود.

مدیریت پاسخ‌های امتناعی (Safety Refusals)

مدل Opus 5.5 از طبقه‌بندی‌های ایمنی گسترده‌تری استفاده می‌کند. این موضوع منجر به امتناع‌های مکرر در دسته‌هایی مانند امنیت سایبری، زیست‌شناسی و استخراج استدلال می‌شود. توسعه‌دهندگانی که ابزارهای امنیتی مانند Fuzzerها، اسکنرها یا قوانین شناسایی می‌سازند، ممکن است متوجه شوند که مدل درخواست‌های منطقی آن‌ها را رد می‌کند.

راهکار توصیه شده این است که درخواست را با ذکر صریح بستر دفاعی (Defensive Context) بازنویسی کنید، به‌جای اینکه سعی کنید از ترفندهای مهندسی پرامپت استفاده کنید. در یک منبع کاری، امتناع‌های مداوم باید با تیم امنیتی شما در میان گذاشته شود، نه اینکه از طریق ترفندهای پرامپت دور زده شود.

نظارت و عیب‌یابی

در داخل Claude Code، دستور /usage (یا نام مستعار /cost) را اجرا کنید تا تعداد توکن‌های جلسه، خطوط حافظه پنهان پرامپت و هزینه تخمینی بر اساس قیمت لیست را ببینید. توجه داشته باشید که این یک تخمین است؛ صورت‌حساب واقعی از طریق Azure Cost Management برای منبع Foundry مدیریت می‌شود. داشبوردهای استفاده خود Anthropic به‌طور کلی ترافیک Foundry را نمی‌بینند.

برای ردیابی در سطح تیم، Claude Code می‌تواند استفاده را از طریق OpenTelemetry صادر کند. برچسب‌گذاری (Tagging) منبع Foundry (مثلاً team=... یا env=dev) فرآیند بازگرداندن هزینه‌ها (Chargebacks) را ساده می‌کند.

چک‌لیست مشکلات رایج:

• /status مدل Sonnet را نشان می‌دهد: احتمالاً شما فقط ANTHROPIC_DEFAULT_OPUS_MODEL را تنظیم کرده‌اید. متغیر ANTHROPIC_MODEL را با نام استقرار خود اضافه کنید.
• خطای عدم دسترسی به مدل (Model not available): یک نام مستعار یا زیر-عامل به مدلی اشاره می‌کند که شما مستقر نکرده‌اید. آن را مستقر کنید یا خط مربوطه را از env حذف کنید.
• /effort هیچ اثری ندارد: بررسی کنید که آیا CLAUDE_CODE_EFFORT_LEVEL در متغیرهای محیطی شما تنظیم شده است یا خیر؛ برای استفاده تعاملی آن را حذف کنید.
• هزینه‌های بالا بعد از وقفه‌ها: مقدار ENABLE_PROMPT_CACHING_1H=1 را تنظیم کنید تا از انقضای ۵ دقیقه‌ای حافظه پنهان جلوگیری شود.
• خطاهای ۴۰۱/۴۰۳: نقش Azure AI User خود را تأیید کنید یا az login --tenant <id> را اجرا کنید. توجه داشته باشید که در Foundry دستور /logout وجود ندارد؛ برای تغییر حساب باید az login را مجدداً اجرا کنید.
• پنل VS Code از شما می‌خواهد وارد شوید: مطمئن شوید که "claudeCode.disableLoginPrompt": true در تنظیمات شما قرار دارد.

این انتقال به Opus 5.5 نخستین باری است که یک مدل کلاس Opus از نظر اقتصادی به عنوان یک پیش‌فرض تمام‌روز برای توسعه‌دهندگان انفرادی به‌صرفه است. بهای این دسترسی، یک فرآیند پیکربندی پیچیده‌تر برای جلوگیری از هزینه‌های تصادفی در کارهای پس‌زمینه است. برای تأیید تنظیمات فعلی خود، دستور /status را در ترمینال اجرا کنید. اگر خط مدل هنوز Sonnet را نشان می‌دهد، متغیرهای محیطی شما توسط افزونه VS Code شناسایی نشده‌اند.