آیا Claude Code در اشتراک Claude Pro گنجانده شده است؟
بله، Claude Code برای کاربران Pro، Max، Ultra و Team فعال است. در این مطلب بررسی میکنیم که چگونه تنظیم ANTHROPIC_API_KEY باعث محاسبه هزینه جداگانه به جای اشتراک میشود.
آیا Claude Code در اشتراک Claude Pro گنجانده شده است؟
بله. Claude Code در اشتراکهای Claude Pro، Max، Ultra، تمامی اکانتهای Team و اکانتهای Enterprise فعلی گنجانده شده است؛ بنابراین یک اشتراک، هم اپلیکیشنهای چت و هم ابزار ترمینال را پوشش میدهد. در قراردادهای قدیمیتر Enterprise، این موضوع به نوع اکانت بستگی دارد: فقط اکانتهای Premium و اکانتهای Chat + Claude Code شامل آن میشوند، پس نوع اکانت خود را بررسی کنید. طرح رایگان Claude شامل این ابزار نمیشود. مستندات راهاندازی Anthropic صراحتاً بیان میکند که Claude Code نیازمند یک اکانت Pro، Max، Ultra، Team، Enterprise یا Console است و طرح رایگان دسترسی به Claude Code را فراهم نمیکند. اشتراک نیازی به API key (کلید رابط برنامهنویسی اپلیکیشن که هزینهاش بر اساس توکن محاسبه میشود) ندارد. استفاده از کلید اختیاری است: اگر ANTHROPIC_API_KEY تنظیم شده باشد و شما آن را تأیید کنید، آن نشست به جای اشتراک، بر اساس توکن محاسبه میشود که برای اجرای خودکار که میخواهید جدا از فعالیتهای تعاملیتان صورتحساب شود، یا نشستی که میخواهید هزینه آن به کلید خاصی اختصاص یابد، مناسب است. بدون اشتراک، استفاده از اکانت Console راهی است که در آن هزینهها بر اساس توکن محاسبه میشوند.
بخشی که معمولاً اشتباه برداشت میشود این است: Claude Code سهمیه جداگانهای ندارد. این ابزار از همان بودجه مصرفی اشتراک شما که برای گفتگوهای چت استفاده میشود، هزینه میکند؛ بنابراین یک نشست طولانی کدنویسی، ظرفیت چت بعدی شما را کاهش میدهد. Anthropic اعلام کرده است که طرحهای Pro، Max و Ultra محدودیتهای مصرفی ارائه میدهند که بین Claude و Claude Code مشترک است؛ به این معنی که تمام فعالیتها در هر دو ابزار، از سقف محدودیتهای مصرفی یکسانی کسر میشوند. تنها استثنا، طرحهای فعلی Enterprise مبتنی بر مصرف است که بودجه گنجاندهشدهای برای اشتراک ندارند: در این طرحها هیچ محدودیت مصرفی برای هر اکانت وجود ندارد و هر درخواست در هر یک از دو ابزار، با نرخهای API محاسبه میشود.
محتوای هر طرح اشتراک
- Free: بدون Claude Code. چت در وب و اپلیکیشنها، بدون دسترسی در ترمینال.
- Pro: شامل Claude Code با سطح استفاده Pro. هزینه آن تا نوامبر 2026 در ایالات متحده 20 دلار در ماه است و در صورت پرداخت سالانه کمتر خواهد بود.
- Max: همان Claude Code با پنج برابر سقف استفاده Pro در هر پنج ساعت و هر هفته، با هزینه 100 دلار در ماه در وب تا نوامبر 2026، که فقط بهصورت ماهانه صورتحساب میشود. شامل 100 دلار اعتبار API در ماه است.
- Ultra: همان Claude Code با ده برابر سقف استفاده Pro در هر هفته، با هزینه 200 دلار در ماه در وب تا نوامبر 2026، که فقط بهصورت ماهانه صورتحساب میشود. شامل 200 دلار اعتبار API در ماه است. قیمتهای موبایل برای Max و Ultra ممکن است متفاوت باشد.
- Team and Enterprise: در هر جایگاه (seat) Team گنجانده شده است، که در آن سهمیه به جایگاه تعلق دارد و یک جایگاه پریمیوم سهمیه بیشتری نسبت به جایگاه استاندارد دارد. طرحهای فعلی Enterprise از یک نوع جایگاه واحد استفاده میکنند که شامل Claude Code است، بدون سهمیه برای هر جایگاه: تمام استفاده با نرخ API و تحت محدودیتهای هزینهای که مدیر تعیین میکند، محاسبه میشود. قراردادهای قدیمیتر Enterprise از انواع جایگاههای مجزا استفاده میکنند: فقط جایگاههای Premium و جایگاههای Chat + Claude Code شامل Claude Code هستند و فقط قراردادهای مبتنی بر جایگاه دارای سهمیه هستند.
اینها تنها قیمتهای موجود در اینجا هستند، زیرا قیمت طرحها تغییر میکند اما این صفحه تغییر نمیکند. ارقام فعلی در تفکیک کامل هزینههای Claude Code موجود است، انتخاب بین طرحها در مقایسه طرحبهطرح اشتراکهای Claude بررسی شده است، و پیش از آنکه تصور کنید دسترسی شما مسدود شده، بررسی آنچه سطح رایگان Claude پوشش میدهد ارزشمند است.
چرا یک جلسه کدنویسی پنجره چت شما را کوتاه میکند
دو پنجره محدودیت برای اشتراکهای Pro، Max یا Team و همچنین برای هر صندلی در قراردادهای قدیمی Enterprise مبتنی بر صندلی وجود دارد. محدودیت جلسات هر پنج ساعت یکبار بازنشانی میشود. محدودیت هفتگی در یک زمان ثابت در هر هفته که به حساب شما اختصاص داده شده است بازنشانی میشود و شما میتوانید زمان بازنشانی خود را در صفحه میزان مصرف مشاهده کنید. حسابهای Ultra تأییدشده محدودیت پنجساعته ندارند؛ حسابهای تأییدنشده دارای یک محدودیت موقت هستند. Ultra همچنان دارای محدودیت هفتگی در تمام مدلها است و Max و Ultra سقف استفاده از Fable را به نصف سهمیه هفتگی عادی محدود میکنند که از همان بودجه برداشت شده و سریعتر از سایر مدلها مصرف میشود. طرحهای Enterprise فعلی که مبتنی بر میزان مصرف هستند، هیچکدام از این دو پنجره را ندارند: این طرحها بر اساس مصرف صورتحساب صادر میکنند و مدیران بهجای آن، سقف هزینهها را تعیین میکنند. هیچکدام از این پنجرهها تعداد پیام مشخصی نیستند که بتوانید از قبل محاسبه کنید، زیرا میزان پیشرفت شما به طول مکالمات و مدلی که اجرا میکنید بستگی دارد. به آنها بهعنوان رفتاری برای نظارت نگاه کنید، نه عددی برای بودجهبندی. مطالعه جزئیات مکانیسم محدودیتها پیش از رسیدن به سقف مصرف، ارزشمند است.
Claude Code به دلیل ماهیت هر نوبت کدنویسی، آن بودجه را سریعتر از چت تخلیه میکند. هر درخواست، کل مکالمه تا آن لحظه را ارسال میکند. هر فراخوانی ابزار، خواندن فایل یا اجرای تست، درخواست دیگری را ارسال میکند که نتایج درخواست قبلی را با خود حمل میکند. راهنمای خود Anthropic برای مدیران سیستم دقیقاً به همین دلیل توصیه میکند که برای یک صندلی کدنویسی، بودجه بیشتری نسبت به صندلی چت در نظر بگیرند: یک جلسه دیباگ میتواند بیش از یک روز چت مصرف کند.
کش کردن پرامپت (Prompt caching) این موضوع را تعدیل میکند اما آن را از بین نمیبرد. محتوای تکراری با نرخ کش خوانده میشود، بنابراین یک سوال یکخطی در جلسهای که تمام روز باز بوده است، همچنان میزان مصرف کل مکالمه پشت آن را در بر میگیرد. در اشتراکها، تا زمانی که در محدوده مصرف مجاز طرح خود هستید، مکالمه اصلی دارای عمر کش یکساعته است؛ زیر-عاملها (subagents)، فشردهسازی و اکثر درخواستهای دیگری که Claude Code خارج از آن مکالمه انجام میدهد، بهطور پیشفرض دارای عمر پنجدقیقهای هستند. اگر بیش از یک ساعت از سیستم دور بمانید، اولین پیام شما پس از بازگشت، کش را از دست میدهد؛ این یعنی کل محتوای شما دوباره با نرخ نوشتن در کش (cache-write rate) در کش نوشته میشود. آن نرخ بالاتر از نرخ ورودی عادی است، نه برابر با آن: Anthropic قیمت نوشتن در کش یکساعته را 2 برابر قیمت ورودی پایه و نوشتن در کش پنجدقیقهای را 1.25 برابر تعیین کرده است. همان یک پیام میتواند بیش از بیست پیام قبل از خود هزینه داشته باشد.
نشانههای عملی برای تشخیص اتمام بودجه اشتراکی
دستور /usage را داخل Claude Code اجرا کنید. در یک طرح پولی، این دستور نمودارهای استفاده از سقف طرح شما را رسم میکند، همراه با تفکیکی از آنچه باعث مصرف آنها شده است. برای مشاهده 24 ساعت گذشته d و برای 7 روز گذشته w را فشار دهید.
این تفکیک، هر رفتاری را که مسئول 10 درصد یا بیشتر از استفاده اخیر باشد (مانند context طولانی یا cache misses) مشخص میکند و استفاده را به مهارتها، subagentها، پلاگینها و سرورهای مجزای MCP (پروتکل context مدل) نسبت میدهد. یک نکته مهم است: این ارقام از تاریخچه نشست محلی روی دستگاهی که با آن کار میکنید محاسبه میشوند، بنابراین کاری که روی دستگاه دیگری یا در claude.ai انجام دادهاید در این تفکیک لحاظ نمیشود. نمودارهای طرح جهانی هستند، اما انتساب (attribution) محلی است.
هنگامی که سهمیه شما تمام شود، پیام خطا مشخص میکند که به کدام سقف رسیدهاید:
You've hit your session limit
You've hit your weekly limitهر دوی این پنجرهها برای تمام مدلها اعمال میشوند، بنابراین تغییر مدل با /model دسترسی شما را باز نمیگرداند. یک پیام خاصِ مدل مانند You've hit your Opus limit موضوع متفاوتی است و در آنجا /model به شما اجازه میدهد با مدل دیگری به کار خود ادامه دهید. هشدار context یا اعلان auto-compact به هیچ وجه محدودیت استفاده نیستند: به این معنی است که گفتگو به پنجره context نشست نزدیک شده و تاریخچه قدیمیتر در حال خلاصهسازی است. راهنمای هزینه Anthropic مدیریت context را در اولویت قرار میدهد و کوتاه نگه داشتن پنجره context بیشترین تأثیر را بر سرعت تخلیه بودجه دارد. /clear بین وظایف نامرتبط هزینهای ندارد و درخواست بعدی را با بار کمتری شروع میکند. اگر قبلاً مسدود شدهاید، گزینههای موجود هنگام رسیدن به محدودیت شامل انتظار، ارتقای طرح یا فعالسازی اعتبار مصرف است. اگر Anthropic یک بازنشانی رایگان محدودیت به حساب شما اختصاص داده باشد، این گزینه چهارم است: آن را از بخش Settings > Usage در وب، در Claude Desktop یا در اپلیکیشن موبایل Claude (نه از Claude Code در ترمینال یا IDE) استفاده کنید. از آنجا که محدودیتهای شما در کل حساب مشترک است، استفادهای که بازگردانده میشود در Claude Code نیز اعمال خواهد شد. آنچه بازگردانده میشود به نوع بازنشانی بستگی دارد. بازنشانی پنجساعته یا هفتگی، آن محدودیت را به حالت کامل برمیگرداند. بازنشانی محدودیت Fable فقط استفاده هفتگی صرفشده برای مدلهای Fable را بازمیگرداند، بنابراین استفاده صرفشده برای مدلهای دیگر همچنان در محدودیت هفتگی شما لحاظ میشود، اگرچه اگر حساب شما دارای محدودیت پنجساعته باشد، آن را بهطور کامل پر میکند.
چرا یک API key میتواند هزینهها را به حساب شما بگذارد
این موضوع در سرور بیشترین آسیب را میزند. اگر متغیر محیطی ANTHROPIC_API_KEY تنظیم شده باشد و شما آن را تأیید کنید، Claude Code بهجای اشتراک شما، با آن کلید احراز هویت میشود و هزینهٔ کار بر اساس توکن به حساب API شما منظور میگردد. در یک نشست تعاملی، برنامه یکبار میپرسد که آیا از کلید استفاده شود یا خیر و پاسخ را به خاطر میسپارد؛ بنابراین کلیدی که ماهها پیش تأیید کردهاید، بدون پرسش مجدد به کار خود ادامه میدهد. برای تغییر این انتخاب در آینده، از گزینه "Use custom API key" در /config استفاده کنید که تنها زمانی ظاهر میشود که متغیر تنظیم شده باشد. در حالت غیرتعاملی (claude -p)، برنامه از هر کلیدی که موجود باشد، بدون هیچ پرسشی استفاده میکند. در این حالت، سهمیه Pro، Max یا Ultra شما دستنخورده باقی میماند در حالی که صورتحساب افزایش مییابد. هیچ سهمیه رایگانی هم در آن سمت وجود ندارد، زیرا Claude API هیچ سطح رایگانی ندارد (بهجز اعتبار اندکی که هنگام ثبتنام داده میشود) و اعتبارات ماهانه API که با طرحهای Max، Ultra و Team ارائه میشوند، Claude Code تعاملی را پوشش نمیدهند. این اعتبارات فقط برای اجراهای claude -p و کارهای Agent SDK که خودتان با یک API key از سازمان Console مرتبط با طرحتان شروع میکنید، معتبر هستند.
روی یک VPS، این اتفاق بیشتر از لپتاپ بهصورت تصادفی رخ میدهد، زیرا معمولاً همان پروفایل shell حاوی کلیدهایی برای ابزارهای دیگر است. توصیه خود Anthropic این است که اگر میخواهید هزینه از اشتراک شما کسر شود، ANTHROPIC_API_KEY را تنظیم نکنید و کلید را فقط برای نشست ترمینالی که به آن نیاز دارد، تنظیم نمایید. پس از ورود به سیستم، Claude Code هنگام فعال بودن همزمان ورود با اشتراک و یک API key، هشداری نمایش میدهد. پیش از شروع بررسی کنید:
printenv ANTHROPIC_API_KEYاگر چیزی چاپ نشد، یعنی هیچ API key در این shell تنظیم نشده است. این بهتنهایی ثابت نمیکند که Claude Code از اشتراک شما استفاده خواهد کرد: اعتبار ممکن است از ANTHROPIC_AUTH_TOKEN، یک اسکریپت apiKeyHelper یا بلوک env در یک فایل تنظیمات (شامل تنظیماتی که مدیر سیستم مدیریت میکند) بیاید و هر کدام از اینها بر ورود با claude.ai اولویت دارند. برای مشاهده اینکه کدامیک فعال است، داخل Claude Code دستور /status را اجرا کنید. اگر کلیدی چاپ شد، یعنی اگر قبلاً آن کلید را تأیید کردهاید یا دستور claude -p را اجرا کنید، نشست بعدی هزینه را از API کسر میکند؛ در غیر این صورت، Claude Code ابتدا میپرسد و رد کردن آن باعث میشود روی اشتراک باقی بمانید. برای پاک کردن آن از این shell و یافتن فایلی که مدام آن را تنظیم میکند، از دستور زیر استفاده کنید:
unset ANTHROPIC_API_KEY
grep -rn ANTHROPIC_API_KEY ~/.bashrc ~/.profile ~/.bash_profile 2>/dev/nullاکنون Claude Code را شروع کرده و با حساب اشتراک وارد شوید:
claudeاولین اجرا، ورود از طریق مرورگر را آغاز میکند. داخل یک نشست، /login حسابها را تغییر میدهد، /status روش احراز هویت در حال استفاده را نام میبرد و /usage تأیید میکند که از کدام روش پرداخت استفاده میکنید: یک مشترک، نوارهای استفاده از طرح را میبیند، در حالی که یک حساب API، بلوک نشست هزینههای توکن را میبیند و نوارهای طرح را مشاهده نمیکند. بقیه تنظیمات سمت سرور، از جمله نحوه زنده نگه داشتن نشست پس از قطع اتصال، در اجرای Claude Code روی VPS داخل tmux و بخش مجوزها در اجرای ایمن Claude Code روی سروری که مالک آن هستید پوشش داده شده است.
یک تله مرتبط: وقتی سهمیه طرح تمام میشود، میتوانید اعتبار مصرف (usage credits) را فعال کنید تا فراتر از سهمیه کار کنید که هزینه آن علاوه بر اشتراک محاسبه میشود. هنگامی که از اعتبار استفاده میکنید، Claude Code طول عمر کش پرامپت (prompt cache) نشست اصلی را از یک ساعت به پنج دقیقه کاهش میدهد؛ بنابراین وقفههای بیکاری که قبلاً رایگان بودند، شروع به هزینه انداختن میکنند، مگر اینکه خودتان تنظیمات promptCacheTtl را روی 1h قرار دهید. /usage-credits بخش Settings > Usage را برای مشترکین Pro، Max یا Ultra باز میکند.
کدامیک ارزش هزینه کردن را دارد؟
همهٔ این موارد بر این فرض استوار است که شما تصمیم گرفتهاید هزینهای پرداخت کنید، و اینکه آیا Claude Code با نرخ ساعتی شما، هزینهاش را جبران میکند، محاسباتی است که پشت این تصمیم قرار دارد. اگر آنچه میسنجید خودِ اشتراک است و نه ابزار ترمینال، اینکه آیا Claude Pro برای نحوهٔ استفادهٔ واقعی شما از Claude ارزش دارد، از پرسش متفاوتی آغاز میشود: اینکه محدودیت نسخهٔ رایگان، چند بار در وهلهٔ اول مانع کار شما میشود.
- برنامهنویسی تفننی یا گاهبهگاه: طرح Pro. یک ابزار، یک صورتحساب، کافی برای چند جلسه در هفته. جزئیات مربوط به سهمیه در قیمت و محدودیتهای طرح Pro آمده است.
- برنامهنویسی مداوم روزانه: طرح Max یا Ultra. طرح Max پنج برابر استفادهٔ Pro در هر دو پنجره (window) ارائه میدهد؛ طرح Ultra ده برابر استفادهٔ Pro در هر هفته ارائه میدهد و محدودیت پنجساعته را برای حسابهای تأییدشده حذف میکند. انتخاب بین Max و Ultra به این بستگی دارد که چند بار به محدودیت هفتگی میرسید و آیا نیاز دارید بدون سقف پنجساعته کار کنید یا خیر.
- چندین نفر: طرحهای Team یا Enterprise، که در آنها سهمیه به ازای هر صندلی (seat) تخصیص مییابد (یا در طرحهای Enterprise فعلی که مبتنی بر میزان استفاده هستند، هر درخواست با نرخ API و تحت محدودیتهای هزینهکردِ مدیر سیستم محاسبه میشود) و مدیر میتواند هزینهکرد هر کاربر را مشاهده کند. هزینهٔ یک صندلی در مقایسه با هزینهٔ همان کار به ازای هر توکن، مقایسهای است که باید پیش از خرید عمدهٔ صندلیها انجام دهید.
- اجراهای متناوب یا خودکار: پرداخت بر اساس API. یک وظیفهٔ شبانه یا یک مرحلهٔ CI (یکپارچهسازی مداوم) دلیلی ندارد که برای همان سهمیه با کار تعاملی شما رقابت کند.
این دو مورد آخر بهخوبی با هم ترکیب میشوند. اشتراک را برای کاری که شخصاً انجام میدهید حفظ کنید و به اتوماسیون، کلید API اختصاصی خود را بدهید تا یک اجرای شبانه، پنجرهای را که صبح روز بعد به آن نیاز دارید، خالی نکند. مقایسهٔ هزینهٔ API و اشتراک، نقطهٔ تلاقی این دو را بررسی میکند.
FAQ
آیا میتوانم از Claude Code در طرح رایگان Claude استفاده کنم؟
خیر. Claude Code به یک حساب Pro، Max، Ultra، Team، Enterprise یا Console نیاز دارد. مستندات راهاندازی Anthropic بیان میکند که طرح رایگان Claude شامل دسترسی به Claude Code نمیشود، بنابراین اجرای claude از شما میخواهد که به یک حساب پولی وارد شوید یا با استفاده از یک API key احراز هویت کنید. طرح رایگان همچنان شامل چت در وب و اپلیکیشنهای دسکتاپ است که برای تست اینکه آیا Claude به نوع سوالات شما پاسخ میدهد یا خیر، پیش از پرداخت هرگونه هزینه کافی است.
آیا Claude Code از همان محدودیتهای استفاده Claude chat استفاده میکند؟
بله، در طرحهای Pro، Max و Ultra. Anthropic اعلام کرده است که محدودیتهای استفاده بین Claude و Claude Code مشترک هستند، بنابراین تمام فعالیتها در هر دو ابزار از سقف محدودیتهای یکسان کسر میشوند. طرحهای Pro و Max دارای محدودیت نشست (session) هستند که هر 5 ساعت بازنشانی میشود و هر سه طرح دارای یک محدودیت هفتگی هستند که در زمان مشخصی در هر هفته برای حساب شما بازنشانی میشود. حسابهای تاییدشده Ultra محدودیت 5 ساعته ندارند؛ حسابهای تاییدنشده دارای یک محدودیت موقت هستند. طرحهای Max و Ultra سقف استفاده از Fable را به نصف سهمیه هفتگی عادی محدود کردهاند که از همان بودجه کسر شده و سریعتر از سایر مدلها مصرف میشود. در عمل، یک بعدازظهرِ بازنویسی کد سنگین میتواند باعث شود که در آن شب پنجره چت کوتاهی داشته باشید. برای مشاهده نمودارها و زمان بازنشانی بعدی، /usage را اجرا کنید.
چرا میزان استفاده من در طول یک نشست کدنویسی به این سرعت کاهش یافت؟
زیرا یک نوبت کدنویسی، زمینه (context) بسیار بیشتری نسبت به یک پیام چت معمولی دارد. هر درخواست، کل تاریخچه گفتگو را ارسال میکند و هر نتیجه ابزار (tool result)، یک درخواست دیگر اضافه میکند که دوباره همان محتوا را حمل میکند. /usage را اجرا کنید و پرچمهای رفتاری (behaviour flags) را بخوانید: هر چیزی که مسئول 10 درصد یا بیشتر از استفاده اخیر باشد علامتگذاری میشود و مقصران معمول، زمینه طولانی و cache misses هستند. نشستی که تمام روز باز بماند، مدام کل تاریخچه خود را بازنشر میکند و یک وقفه بیکار (idle gap) طولانیتر از طول عمر کش (یک ساعت برای گفتگوی اصلی در یک اشتراک فعال، پنج دقیقه برای subagentها و زمانی که از اعتبار استفاده میکنید) باعث میشود پیام بعدی همه چیز را دوباره با نرخ cache-write در کش بنویسد که بالاتر از نرخ ورودی عادی است: 2 برابر ورودی پایه برای یک cache write یکساعته و 1.25 برابر برای یک cache write پنجدقیقهای. استفاده از /clear بین کارهای نامرتبط، هر دو مشکل را برطرف میکند.
چه زمانی یک API key ارزانتر از اشتراک Pro یا Max است؟
زمانی که کارها بهصورت انفجاری (bursty) یا خودکار باشند. صورتحساب API بر اساس هر توکن محاسبه میشود و کف هزینه ماهانه ندارد، بنابراین اسکریپتی که دو بار در هفته اجرا میشود، فقط هزینه همان توکنها را دارد و نه بیشتر، در حالی که اشتراک، هزینه یک ماه ظرفیت را میپردازد که ممکن است از آن استفاده نکنید. کدنویسی مداوم روزانه برعکس است: اشتراک یک قیمت ثابت برای سهمیه بزرگ است و پرداخت به ازای هر توکن برای همان حجم، هزینه بیشتری خواهد داشت. تنظیم ANTHROPIC_API_KEY روی دستگاهی که در آن بهصورت دستی هم کد میزنید، اشتباهی است که باید از آن اجتناب کنید، زیرا به محض اینکه کلید را در اعلان (prompt) تایید کنید یا claude -p را در حالی که کلید موجود است اجرا کنید، Claude Code هزینه را از طریق API محاسبه کرده و سهمیه اشتراک شما را بلااستفاده میگذارد.