SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

رفع محدودیت استفاده از Claude و زمان بازنشانی آن

با مشاهده خطای You've hit your session limit یا محدودیت‌های هفتگی در Claude چه باید کرد؟ راهکارهای مدیریت توکن، استفاده از API یا تغییر مدل برای عبور از سقف مصرف را بیاموزید.

به کدام محدودیت Claude برخورد کرده‌اید

پیام رسیدن به محدودیت Claude، بازه زمانی که باید منتظر بمانید را مشخص می‌کند و همان بازه تعیین می‌کند که در ادامه چه کاری می‌توانید انجام دهید. در طرح‌های Pro و Max، محدودیت‌های نشست (session) و محدودیت کلی هفتگی، تمام مدل‌ها را به‌طور هم‌زمان شامل می‌شوند؛ بنابراین تغییر مدل، دسترسی شما را باز نمی‌گرداند. محدودیت کلی هفتگی Ultra نیز تمامی مدل‌ها را به‌طور هم‌زمان در بر می‌گیرد. محدودیت‌هایی که نام یک مدل خاص را ذکر می‌کنند، استثنا هستند: با تغییر مدل می‌توانید به کار خود ادامه دهید، در حالی که همان یک مدل خاص مسدود باقی می‌ماند. Anthropic همچنین به کاربران Enterprise که به محدودیت استفاده رسیده‌اند، توصیه می‌کند از یک مدل سبک‌تر با /model استفاده کنند.

Claude Code بازه زمانی و زمان بازنشانی (reset) آن را در همان خط چاپ می‌کند:

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm

بازه نشست، یک پنجره متحرک 5 ساعته است. بازه‌های هفتگی در یک زمان ثابت در هر هفته بازنشانی می‌شوند که به حساب شما اختصاص یافته است؛ بنابراین روز و ساعت بازنشانی از یک هفته به هفته بعد ثابت می‌ماند. طرح Pro دارای یک بازه نشست 5 ساعته به علاوه یک محدودیت هفتگی است که برای تمامی مدل‌ها اعمال می‌شود. طرح Max یک محدودیت هفتگی دوم اضافه می‌کند که به‌طور اختصاصی برای یک خانواده مدل خاص اعمال می‌شود. Ultra نیز دارای یک محدودیت کلی هفتگی و یک محدودیت هفتگی جداگانه برای Fable است، اما حساب‌های تاییدشده Ultra محدودیت 5 ساعته ندارند. حساب‌هایی که هنوز تایید نشده‌اند، تا زمانی که Anthropic به‌طور خودکار آن‌ها را تایید کند، دارای یک محدودیت موقت هستند. سقف‌های دقیق در شرح کامل محدودیت‌های استفاده از Claude قرار دارند. این صفحه از جایی شروع می‌شود که آن صفحه به پایان می‌رسد.

این بخشی است که کاربران را غافلگیر می‌کند. در جایی که محدودیت نشست اعمال می‌شود، هر درخواست به‌طور هم‌زمان هم در بازه نشست و هم در بازه هفتگی محاسبه می‌شود؛ بنابراین یک بعدازظهر پرکار می‌تواند سهمیه هفتگی را تمام کند، در حالی که هنوز در بازه 5 ساعته ظرفیت باقی مانده است. پیش از برنامه‌ریزی برای ادامه روز خود، زمان بازنشانی را بخوانید. بازنشانی در ساعت 3:45pm یک استراحت کوتاه است، اما بازنشانی در نیمه‌شب دوشنبه چنین نیست.

پیش از حدس زدن، میزان مصرف را بررسی کنید

در claude.ai، به بخش Settings و سپس Usage بروید. نوارهای پیشرفت نشان می‌دهند که چه مقدار از بازه زمانی 5 ساعته و هر بازه هفتگی را مصرف کرده‌اید؛ بنابراین به‌جای حدس زدن، می‌توانید ببینید کدام‌یک به پایان رسیده است. حساب‌های Ultra تاییدشده، نوار Current session را ندارند.

در Claude Code، دستور /usage را اجرا کنید. این دستور همان نوارهای برنامه‌ریزی را به همراه جزئیات تفکیکی از محل مصرف اخیر نشان می‌دهد که بر اساس مهارت‌ها، زیر-عامل‌ها (subagents)، پلاگین‌ها و سرورهای مجزای MCP (پروتکل زمینه مدل) به صورت درصدی از کل محاسبه شده است. برای مشاهده 24 ساعت گذشته کلید d و برای 7 روز گذشته کلید w را فشار دهید. این ابزار همچنین هر الگویی که 10 درصد یا بیشتر از مصرف اخیر را تشکیل دهد علامت‌گذاری می‌کند؛ دو موردی که بیش از همه خواهید دید، زمینه طولانی (long context) و خطاهای کش (cache misses) هستند.

دو نکته مهم وجود دارد. این تفکیک بر اساس تاریخچه نشست ذخیره‌شده روی همان دستگاه محاسبه می‌شود، بنابراین کاری که روی لپ‌تاپ دیگری یا در claude.ai انجام داده‌اید در آن لحاظ نمی‌شود، حتی اگر از همان سهمیه استفاده کرده باشد، زیرا Claude Code و چت‌های claude.ai شما از یک بازه اشتراک مشترک استفاده می‌کنند. همچنین، رقم دلاری در بلوک Session در بالا، یک تخمین برای کاربران API (رابط برنامه‌نویسی کاربردی) است. Claude Code قیمت‌گذاری را بر اساس نرخ‌های استاندارد لیست انجام می‌دهد، مگر اینکه مدیر سیستم یک جدول modelPricing در تنظیمات مدیریت‌شده سازمان شما تعیین کرده باشد که در آن صورت از آن نرخ‌های قراردادی استفاده می‌شود و خط Total cost عبارت at your organization's configured rates را نمایش می‌دهد. در هر صورت، وقتی اشتراک دارید، این رقم صورت‌حساب شما نیست.

آیا تغییر به یک مدل کوچک‌تر کمک می‌کند؟

بله، زمانی که پیام نام یک مدل را ذکر می‌کند، Anthropic نیز توصیه می‌کند که کاربران دارای Enterprise seat که به سقف استفاده رسیده‌اند، این کار را امتحان کنند. پس از You've hit your Opus limit، دستور /model را اجرا کنید، Sonnet یا Haiku را انتخاب کنید تا نشست با حفظ تمام محتوا ادامه یابد. در طرح‌های Pro، Max و Ultra، پس از You've hit your session limit یا You've hit your weekly limit، دستور /model سهمیه اشتراکی را بازیابی نمی‌کند. هنگامی که تنها Opus مسدود شده است، معنای اتمام سهمیه هفتگی Opus توضیح می‌دهد که Opus چه زمانی بازمی‌گردد و آیا اعتبار مصرف یا ارتقا به Max باعث بازگشت سریع‌تر آن می‌شود یا خیر.

این تغییر پیش از رسیدن به محدودیت، بسیار ارزشمندتر از پس از آن است. Sonnet بیشتر کارهای برنامه‌نویسی را با کسری از نرخ Opus انجام می‌دهد، بنابراین باقی گذاشتن Opus به عنوان پیش‌فرض، یکی از دو عادتی است که باعث مصرف غیرمنتظره می‌شود. عادت دیگر، نشست‌هایی است که هرگز پاکسازی نمی‌شوند. ویرایش‌های مکانیکی و بررسی لاگ‌ها را به Haiku بسپارید و Opus را برای تصمیمات طراحی که واقعاً در آن‌ها گیر کرده‌اید، نگه دارید. انتخاب بین Opus، Sonnet و Haiku بررسی می‌کند که هر مدل در چه زمینه‌ای ارزش هزینه خود را دارد.

هزینه زمینه‌ای که دیگر استفاده نمی‌کنید را نپردازید

Claude Code کل مکالمه شما را با هر درخواست ارسال می‌کند و هر بار که Claude از یک ابزار استفاده می‌کند، درخواست دیگری حاوی نتایج آن ابزار ارسال می‌شود. Prompt caching به این معنی است که تاریخچه با نرخ کش‌شده خوانده می‌شود، نه نرخ کامل ورودی؛ این کار هزینه را کمتر می‌کند، اما رایگان نیست. بنابراین، یک سوال یک‌خطی در نشستی که از صبح باز نگه داشته‌اید، همچنان هزینه کل مکالمه را مصرف می‌کند.

/context
/clear
/compact Focus on the failing tests and the files we changed

/clear هزینه‌ای ندارد، زیرا زمینه را به جای خواندن، دور می‌ریزد. /compact باید مکالمه‌ای که خلاصه می‌کند را بخواند، بنابراین فشرده‌سازی یک زمینه بسیار بزرگ، خود یک درخواست بزرگ محسوب می‌شود. زمانی که به کار نامرتبطی می‌پردازید از /clear استفاده کنید و تنها زمانی که در میان یک وظیفه هستید و نیاز دارید رشته گفتگو حفظ شود، از /compact استفاده کنید. پیش از پاک‌سازی، /rename را اجرا کنید تا بتوانید نشست را دوباره با /resume پیدا کنید.

طول عمر کش (Cache lifetime) بیش از آنچه اکثر افراد تصور می‌کنند اهمیت دارد. در حالت اشتراک، تا زمانی که در محدوده مصرف مجاز طرح خود هستید، کش مکالمه اصلی یک ساعت باقی می‌ماند. زیر-عامل‌ها و اکثر درخواست‌های پس‌زمینه حتی در حالت اشتراک، 5 دقیقه زمان دارند. هنگامی که از اعتبار مصرف (usage credits) استفاده می‌کنید، زمان کش مکالمه اصلی به 5 دقیقه کاهش می‌یابد؛ 5 دقیقه همچنین زمان پیش‌فرض روی یک API key است. اگر به طول عمر متفاوتی نیاز دارید، تنظیمات promptCacheTtl و subagentPromptCacheTtl این پیش‌فرض‌ها را نادیده می‌گیرند. اولین پیام شما پس از یک ناهار طولانی، کش را از دست می‌دهد، بنابراین کل زمینه دوباره پردازش شده و در کش نوشته می‌شود. در نرخ‌های لیست API، نوشتن در کش هزینه بیشتری نسبت به ورودی ساده دارد (1.25 برابر قیمت پایه ورودی برای کش 5 دقیقه‌ای و 2 برابر برای کش یک ساعته)؛ به همین دلیل است که مصرف اغلب بدون دلیل ظاهری جهش می‌کند. جایی که prompt caching هزینه خود را جبران می‌کند محاسبات مربوط به این موضوع را پوشش می‌دهد.

سه اهرم دیگر نیز در همان مکان قرار دارند. /mcp سرورهای پیکربندی‌شده شما را لیست می‌کند تا بتوانید مواردی که برای این وظیفه نیاز نیستند را خاموش کنید. یک فایل CLAUDE.md طولانی در شروع نشست بارگذاری می‌شود، چه کار به آن نیاز داشته باشد چه نه؛ بنابراین دستورالعمل‌های تخصصی را به مهارت‌ها (skills) منتقل کنید که فقط هنگام فراخوانی بارگذاری می‌شوند. همچنین extended thinking به عنوان توکن‌های خروجی محاسبه می‌شود که بخش گران‌قیمت ماجراست؛ بنابراین آن را با /effort کاهش دهید، در مدل‌هایی که اجازه می‌دهند آن را با /config خاموش کنید، یا در مدل‌هایی با بودجه تفکر ثابت، MAX_THINKING_TOKENS=8000 را تنظیم کنید. Claude Code نمی‌تواند تفکر را در مدل‌های Opus 5.5، Sonnet 5.5، Haiku 5.5 یا مدل‌های Fable خاموش کند، بنابراین برای آن‌ها /effort اهرم مناسب است. این یک قانون در Claude Code است، نه در مدل: در API، مدل Haiku 5.5 تفکر خاموش‌شده را در سطح high یا کمتر می‌پذیرد و Sonnet 5.5 می‌تواند تفکر اولیه خود را با تنظیم between_tools حذف کند، در حالی که Opus 5.5 و مدل‌های Fable تفکر خاموش‌شده را در همه جا رد می‌کنند.

تقسیم کار برای جای‌گیری در یک پنجره

پیش از انجام تغییرات بزرگ، کلیدهای Shift+Tab را فشار دهید تا وارد حالت plan mode شوید. Claude کدبیس را بررسی کرده و رویکردی را برای تأیید شما پیشنهاد می‌دهد. شناسایی یک مسیر اشتباه در این مرحله، تنها به اندازه یک طرح هزینه دارد، در حالی که اصلاح آن پس از دو ساعت ویرایش و دوباره‌کاری، بسیار پرهزینه‌تر خواهد بود.

عملیات‌های پرحجم را به subagentها محول کنید. اجرای یک مجموعه تست یا خواندن یک لاگ 10000 خطی درون یک subagent باعث می‌شود خروجی خام در context همان subagent باقی بماند و تنها خلاصه آن به گفتگوی اصلی شما بازگردد.

به محض اینکه Claude مسیر اشتباهی را در پیش گرفت، کلید Escape را فشار دهید. /rewind گفتگو و کد را به نقطه بازرسی قبلی بازمی‌گرداند تا هزینه‌ای برای لغو کارهایی که نمی‌خواستید انجام دهید، نپردازید.

آیا باید اعتبار مصرف بخرید یا از API استفاده کنید؟

اعتبار مصرف (Usage credits) به حساب‌های Pro، Max یا Ultra اجازه می‌دهد پس از اتمام سهمیه طرح خود، به کار ادامه دهند و هزینه‌ها با نرخ استاندارد API محاسبه می‌شود. این قابلیت را در بخش Settings و سپس Usage در claude.ai با متصل کردن یک روش پرداخت فعال کنید، سپس اعتبار اضافه کنید؛ چرا که اعتبارها پیش‌پرداخت هستند و تنها پس از خرید، هزینه‌ها را پوشش می‌دهند. همچنین می‌توانید /usage-credits را در Claude Code اجرا کنید که تنظیمات صورت‌حساب شما را در مرورگر باز می‌کند. اعتبارها هم برای گفتگوهای Claude و هم برای استفاده از ترمینال Claude Code اعمال می‌شوند و سقف آن‌ها یک محدودیت هزینه ماهانه است که خودتان با Adjust limit تعیین می‌کنید یا با Set to unlimited برمی‌دارید. این دستور به ورود به سیستم با اشتراک نیاز دارد، بنابراین هنگام احراز هویت با API key در دسترس نیست. در طرح رایگان، اعتباری ارائه نمی‌شود، بنابراین اولین گام تهیه طرح Pro با هزینه 20 دلار در ماه است و آنچه Pro اضافه می‌کند و محدودیت‌های آن کجا پایان می‌یابد مشخص می‌کند که این طرح تا کجا پاسخگو است. اگر در بیشتر هفته‌ها در حال شارژ مجدد اعتبار هستید، معمولاً داشتن سهمیه بالاتر عادت ارزان‌تری است. تفاوت بین طرح 100 دلاری Max و 200 دلاری Ultra عمدتاً در سهمیه است: Max در هر 5 ساعت و هر هفته 5 برابر طرح Pro استفاده ارائه می‌دهد، در حالی که Ultra در هر هفته 10 برابر طرح Pro استفاده ارائه می‌دهد و برای حساب‌های تأییدشده محدودیت 5 ساعته ندارد. هر دو قیمت‌های ماهانه وب هستند، قیمت‌گذاری موبایل متفاوت است و هر دو طرح فقط صورت‌حساب ماهانه ارائه می‌دهند. این طرح‌ها همچنین شامل اعتبار ماهانه Claude Platform API هستند، 100 دلار در Max و 200 دلار در Ultra، که محدودیت‌های شما را در Claude یا Claude Code افزایش نمی‌دهند.

مسیر دیگر، استفاده از یک API key ساده از Claude Console است که به ازای هر توکن محاسبه می‌شود و هیچ محدودیت نشست یا بازه هفتگی ندارد. یک تله در این مسیر وجود دارد: یک ANTHROPIC_API_KEY سرگردان در محیط شما می‌تواند جایگزین اشتراک‌تان شود. در یک نشست تعاملی، Claude Code یک بار می‌پرسد که آیا از کلید استفاده کند یا خیر و پاسخ شما را به خاطر می‌سپارد، بنابراین یک "بله" سریع از ماه‌های گذشته به راحتی فراموش می‌شود و گزینه Use custom API key در /config آن را به حالت قبل برمی‌گرداند. در یک اجرای غیرتعاملی -p، هیچ سوالی پرسیده نمی‌شود و هر زمان که کلید تنظیم شده باشد، از آن استفاده می‌کند. شما این موضوع را از صورت‌حساب یا از طریق زیر متوجه می‌شوید:

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

خطای 429 نرخ محدودیت (rate limit) روی کلید است، نه روی طرح شما. دستور /status را اجرا کنید و تأیید کنید که اعتبار فعال همان چیزی است که قصد استفاده از آن را داشتید. هنگامی که هم ورود به سیستم و هم یک API key پیکربندی شده باشند، /status موردی که در حال استفاده نیست را علامت‌گذاری می‌کند.

هزینه یک بعدازظهر کار با API چقدر است؟

مثال عملی زیر، حاصل یک بعدازظهر کدنویسی به سبک agent است: 200,000 توکن ورودی بدون کش، 1.8 میلیون خواندن از کش و 150,000 توکن خروجی. قیمت‌ها بر اساس نرخ‌های رسمی Anthropic در اکتبر 2026 هستند. تمامی این نرخ‌ها به ازای هر میلیون توکن اعلام شده‌اند؛ بنابراین اگر این واحد هنوز برایتان انتزاعی است، ارزش واقعی یک میلیون توکن آن را به حجم مشخصی از خواندن و نوشتن تبدیل می‌کند که درک آن آسان‌تر است.

نمودارOne afternoon of agent work priced at API list rates, October 2026
داده‌های پشت این نمودار
[
  {
    "label": "Opus 5",
    "input_usd_per_mtok": 5,
    "cache_read_usd_per_mtok": 0.5,
    "output_usd_per_mtok": 25,
    "afternoon_usd": 5.65
  },
  {
    "label": "Sonnet 5",
    "input_usd_per_mtok": 2,
    "cache_read_usd_per_mtok": 0.2,
    "output_usd_per_mtok": 10,
    "afternoon_usd": 2.26
  },
  {
    "label": "Haiku 4.5",
    "input_usd_per_mtok": 1,
    "cache_read_usd_per_mtok": 0.1,
    "output_usd_per_mtok": 5,
    "afternoon_usd": 1.13
  }
]

هزینه همان بعدازظهر با مدل Opus 5 برابر با $5.65 و با مدل Haiku 4.5 برابر با $1.13 است. خروجی عامل اصلی تغییر در مجموع هزینه است: با قیمت $25 به ازای هر میلیون توکن در Opus 5 در مقابل $5 در Haiku 4.5، هزینه 150,000 توکنی که Claude می‌نویسد، بیشتر از 2 میلیون توکنی است که می‌خواند. به همین دلیل است که کاهش بودجه فکری (thinking budget) بیش از حذف فایل‌ها باعث صرفه‌جویی می‌شود. اگر سوال این است که کدام ارائه‌دهنده را انتخاب کنید (نه کدام مدل)، هزینه سه پروژه روی هر دو API Claude و ChatGPT نشان می‌دهد که صورت‌حساب هر کدام در چه شرایطی به‌صرفه‌تر است.

تاریخی که بدون تغییر گذشت. مدل Sonnet 5 با قیمت 2 دلار برای ورودی و 10 دلار برای خروجی به ازای هر میلیون توکن عرضه شد و اعلام شده بود که این قیمت مقدماتی تا 31 اوت 2026 معتبر است و پس از آن در 1 سپتامبر 2026 به 3 و 15 دلار افزایش می‌یابد. Anthropic این افزایش قیمت را لغو کرد و همان نرخ‌های 2 و 10 دلار را به قیمت استاندارد تبدیل کرد، بنابراین هزینه همان بعدازظهر با Sonnet 5 همچنان $2.26 باقی می‌ماند.

جدیدترین مدل‌ها هزینه همان بعدازظهر را باز هم کاهش می‌دهند. مدل Opus 5.5 که در 22 سپتامبر 2026 منتشر شد، با قیمت 4 دلار برای ورودی و 20 دلار برای خروجی لیست شده است و نرخ خواندن از کش آن 5 درصد نرخ ورودی است که هزینه بعدازظهر را به 4.16 دلار می‌رساند. مدل Sonnet 5.5 نرخ‌های 2 و 10 دلار را حفظ کرده اما هزینه خواندن از کش را به 0.10 دلار کاهش داده است که مجموع را به 2.08 دلار می‌رساند. مدل Haiku 5.5 با قیمت 0.10 و 0.50 دلار شروع می‌شود، اما برای هر درخواستی که پرامپت آن از 100,000 توکن فراتر رود، پنج برابر این نرخ را محاسبه می‌کند؛ بنابراین هزینه نهایی آن به میزان رشد context شما بستگی دارد.

نحوه محاسبه هزینه هر بعدازظهر

Opus 5: 200,000 توکن ورودی بدون کش با نرخ $5 به ازای هر میلیون، برابر با 1.00 دلار است. 1.8 میلیون خواندن از کش با یک‌دهم نرخ ورودی، برابر با 0.90 دلار است. 150,000 توکن خروجی با نرخ $25 به ازای هر میلیون، برابر با 3.75 دلار است. مجموع: $5.65.

Sonnet 5: مبلغ 0.40 دلار برای ورودی بدون کش، 0.36 دلار برای خواندن از کش، 1.50 دلار برای خروجی. مجموع: $2.26.

Haiku 4.5: مبلغ 0.20 دلار برای ورودی بدون کش، 0.18 دلار برای خواندن از کش، 0.75 دلار برای خروجی. مجموع: $1.13.

Opus 5.5: مبلغ 0.80 دلار برای ورودی بدون کش، 0.36 دلار برای خواندن از کش با نرخ 0.20 دلار به ازای هر میلیون، 3.00 دلار برای خروجی. مجموع: 4.16 دلار. Sonnet 5.5: مبلغ 0.40 دلار برای ورودی بدون کش، 0.18 دلار برای خواندن از کش، 1.50 دلار برای خروجی. مجموع: 2.08 دلار.

تمامی 3 ردیف جدول فرض را بر تعداد توکن‌های یکسان گذاشته‌اند، بنابراین تفاوت بین آن‌ها صرفاً ناشی از قیمت است. در یک بعدازظهر واقعی، هزینه بسته به میزان context که در کش باقی می‌ماند، متغیر است.

برای مقیاس‌سنجی، مستندات خود Anthropic نشان می‌دهد که میانگین هزینه Claude Code در سازمان‌ها تا اکتبر 2026، نزدیک به 13 دلار به ازای هر توسعه‌دهنده در هر روز فعال بوده و برای 90 درصد کاربران کمتر از 30 دلار در هر روز فعال است. پرداخت به ازای توکن لزوماً ارزان‌تر از اشتراک نیست. این مدل زمانی برنده است که بار کاری شما نوسانی باشد (چون روزهای کم‌کار هزینه‌ای ندارند) و زمانی که هر روز کار می‌کنید، مدل اشتراکی به‌صرفه‌تر است. مقایسه API با اشتراک بر اساس اعداد واقعی نقطه سر‌به‌سر این دو را نشان می‌دهد.

اجرای پردازش‌های طولانی روی VPS در طول شب

برخی پردازش‌ها نیازی به نظارت شما ندارند: بازنویسی‌های گسترده، تست مهاجرت داده‌ها یا بررسی مستندات. این پردازش‌ها همچنین نیازی به استفاده از سهمیه اشتراک شما ندارند. آن‌ها را روی یک VPS (سرور مجازی خصوصی) با یک API key اجرا کنید تا از اعتبار مصرفی (per-token billing) استفاده کنند و سهمیه طرح شما برای کارهای تعاملی روز بعد دست‌نخورده باقی بماند. یک cloud session به‌طور پیش‌فرض Claude Code را روی سرورهای Anthropic اجرا می‌کند و نیازی به مدیریت سرور توسط شما ندارد، اما از محدودیت‌های طرح شما استفاده می‌کند؛ بنابراین اینکه اعتبار cloud session چه مواردی را پوشش می‌دهد و چه زمانی تمام می‌شود تعیین می‌کند که آیا واقعاً پردازش را از پنجره کاری شما خارج نگه می‌دارد یا خیر.

Claude Code را روی یک سیستم Ubuntu نصب کنید و اجرای آن را تأیید کنید:

curl -fsSL https://claude.ai/install.sh | bash
claude --version

claude --version باید یک رشته نسخه مانند 2.1.211 (Claude Code) را چاپ کند. مشاهده command not found در اینجا به این معنی است که ~/.local/bin هنوز در PATH شما قرار نگرفته است؛ بنابراین یک shell جدید باز کنید و دوباره امتحان کنید. همان نصب‌کننده، همان چیزی است که روی دسکتاپ لینوکسی اجرا می‌کنید، جایی که CLI در کنار اپلیکیشن دسکتاپ بتا و پلاگین‌های ویرایشگر قرار می‌گیرد.

کلید را به جای تاریخچه shell، در یک فایل قرار دهید. فایل ~/.claude-env را در یک ویرایشگر با یک خط محتوا یعنی export ANTHROPIC_API_KEY=sk-ant-your-key-here ایجاد کنید، سپس دسترسی آن را محدود کرده و بارگذاری کنید:

chmod 600 ~/.claude-env
. ~/.claude-env
printenv ANTHROPIC_API_KEY | cut -c1-10

خط آخر، ده کاراکتر اول را چاپ می‌کند که برای تأیید تنظیم شدن متغیر بدون نمایش کل کلید روی صفحه کافی است.

اکنون پردازش را داخل tmux شروع کنید تا با بستن لپ‌تاپ متوقف نشود:

tmux new -s overnight
claude --bare -p "Convert every test under ./tests from unittest to pytest, run the suite, and fix what fails" \
  --allowedTools "Read,Edit,Bash" \
  --append-system-prompt-file ./CLAUDE.md \
  --output-format json > ~/overnight.json

با فشردن Ctrl-b و سپس d از محیط جدا شوید و اتصال را ببندید. بعداً با tmux attach -t overnight دوباره متصل شوید. Claude Code در یک نشست tmux روی VPS مدیریت نشست را به‌طور کامل پوشش می‌دهد.

--bare در اینجا اهمیت دارد. این فلگ کشف خودکار هوک‌ها، مهارت‌ها، پلاگین‌ها و فایل CLAUDE.md را نادیده می‌گیرد و هرگز اعتبارنامه‌های OAuth را نمی‌خواند، بنابراین اجرا فقط از API key استفاده می‌کند و بس. این همان چیزی است که پردازش را از سهمیه اشتراک شما خارج نگه می‌دارد. این همچنین به این معنی است که قوانین پروژه اعمال نمی‌شوند، به همین دلیل --append-system-prompt-file آن‌ها را به‌صورت دستی بازمی‌گرداند. یک اجرای -p بدون پرسش از یک ANTHROPIC_API_KEY تنظیم‌شده استفاده می‌کند، بنابراین تفاوت زمانی مشخص می‌شود که بارگذاری کلید با شکست مواجه شود: بدون --bare، اجرا به لاگین اشتراک شما بازمی‌گردد، اما با آن، اجرا در مرحله احراز هویت متوقف شده و طرح شما را دست‌نخورده باقی می‌گذارد.

صبح روز بعد، نتیجه و هزینه را از فایل JSON بخوانید:

jq -r '.result' ~/overnight.json
jq -r '.total_cost_usd' ~/overnight.json

Claude Code در صورت موفقیت با کد 0 و در صورت شکست با کد غیر صفر خارج می‌شود، بنابراین یک اسکریپت wrapper می‌تواند بر اساس وضعیت خروج تصمیم‌گیری کرده و شکست را به شما ایمیل کند. پیش از رها کردن پردازش، یک سقف هزینه (spend limit) در Claude Console برای فضای کاری تعیین کنید: یک عامل (agent) در حلقه تکرار در ساعت 3 صبح، راهی واقعی برای خرج کردن پول واقعی است. کنترل هزینه برای عامل‌هایی که در حال اجرا رها می‌کنید سقف‌های مناسب برای تنظیم را بررسی می‌کند.

یک مزیت برای کاربران طرح‌های Max، Ultra یا Team: این طرح‌ها اکنون شامل اعتبار API ماهانه برای Claude Platform هستند: 100 دلار در ماه برای Max، 200 دلار برای Ultra، و برای Team مبلغ 20 دلار به ازای هر صندلی Standard و 100 دلار به ازای هر صندلی Premium که به‌صورت اشتراکی تا سقف 500 دلار جمع می‌شود. Claude Code تعاملی تحت پوشش نیست، اما اجرای claude -p که خودتان با یک API key از سازمان متصل به Console شروع کرده‌اید، تحت پوشش است و این پردازش می‌تواند از آن اعتبار استفاده کند. اعتبارهای استفاده‌نشده در پایان هر دوره صورت‌حساب منقضی می‌شوند و پس از اتمام آن‌ها، درخواست‌های API سازمان تا رسیدن اعتبارهای ماه بعد متوقف می‌شوند، مگر اینکه سازمان دارای اعتبارهای خریداری‌شده نیز باشد. اگر پردازش باید حتماً تمام شود، مقداری اعتبار خریداری‌شده در Console برای آن در نظر بگیرید، در غیر این صورت با خطای Credit balance is too low متوقف می‌شود.

برای پردازش، یک کاربر بدون دسترسی‌های ویژه (unprivileged) و یک شاخه (branch) گیت اختصاصی ایجاد کنید. عاملی که به‌صورت خودکار یک مخزن را ویرایش می‌کند، گاهی کاری انجام می‌دهد که شما جلوی آن را می‌گرفتید؛ استفاده از یک شاخه باعث می‌شود این اتفاق یک git checkout ساده باشد، نه یک حادثه امنیتی. اجرای ایمن یک عامل کدنویسی روی VPS این جداسازی را پوشش می‌دهد.

برای کارهای حجیم که اصلاً تعاملی نیستند، مانند طبقه‌بندی هزاران رکورد، Batch API درخواست‌ها را به‌صورت ناهمگام (asynchronous) با 50 درصد تخفیف روی توکن‌های ورودی و خروجی پردازش می‌کند. اکثر دسته‌ها در کمتر از یک ساعت تمام می‌شوند، اما پردازش ممکن است تا 24 ساعت طول بکشد.

چه چیزی دسترسی شما را باز نمی‌گرداند

به‌جز ارتقای اشتراک، دو مورد دسترسی شما را باز می‌گردانند: گذشت زمان و استفاده از قابلیت بازنشانی محدودیت (limit reset) در صورتی که Anthropic آن را برای شما فعال کرده باشد. بازنشانی محدودیت‌ها گهگاه به پلن‌های واجد شرایط ارائه می‌شود و استفاده از آن، بسته به نوع پیشنهاد، محدودیت 5 ساعته یا محدودیت هفتگی شما را بلافاصله به حالت کامل بازمی‌گرداند. لازم نیست تا زمان رسیدن به سقف محدودیت صبر کنید تا از آن استفاده کنید. در وب یا Claude Desktop، به بخش Settings و سپس Usage بروید و به دنبال گزینه Reset for free در قسمت Resets بگردید؛ این گزینه در پیام مربوط به محدودیت نیز نمایش داده می‌شود. این دکمه در Claude Code داخل ترمینال وجود ندارد، اما چون محدودیت‌ها مشترک هستند، بازنشانی در آنجا نیز اعمال می‌شود.

شروع یک گفتگوی جدید، سهمیه شما را بازیابی نمی‌کند. میزان استفاده بر اساس حساب کاربری شما محاسبه می‌شود، نه بر اساس یک گفتگو. البته شروع گفتگوی جدید باعث می‌شود پیام‌های بعدی ارزان‌تر محاسبه شوند، زیرا گفتگوی تازه فاقد تاریخچه برای بازخوانی است؛ بنابراین همچنان انجام آن توصیه می‌شود. این کار یک روش کاهش هزینه است، نه بازنشانی سهمیه.

حذف گفتگوهای قدیمی هیچ اعتباری را بازنمی‌گرداند. آن توکن‌ها در زمان پردازش مصرف شده‌اند.

در پلن‌های Pro، Max و Ultra، تغییر مدل پس از اتمام سهمیه نشست (session) یا سهمیه هفتگی، سهمیه مشترک را بازیابی نمی‌کند. پیامی که نام یک مدل را ذکر می‌کند به /model پاسخ می‌دهد و کاربران Enterprise نیز می‌توانند پس از رسیدن به سقف استفاده، مدل سبک‌تری را امتحان کنند.

تلاش مجدد در یک حلقه (loop)، هیچ کاری جز مشغول نگه داشتن ترمینال انجام نمی‌دهد. زمان بازنشانی که در پیام ذکر شده، پاسخ واقعی است و /usage همان زمان‌سنج را بدون نمایش خطا به شما نشان می‌دهد. در صورت داشتن اشتراک، نسخه Claude Code 2.1.234 یا بالاتر می‌تواند در نشست باز منتظر بماند و وظیفه متوقف‌شده را بلافاصله پس از بازنشانی ادامه دهد، بنابراین نیازی نیست پای سیستم بنشینید و منتظر بمانید.

ارتقای اشتراک تنها اقدامی است که سقف محدودیت را افزایش می‌دهد؛ بنابراین اگر پس از پرداخت، محدودیت‌ها همچنان باقی ماندند، پیش از آنکه تصور کنید سهمیه دچار مشکل شده است، بررسی کنید چرا پلن جدید ممکن است محدودیت‌های قبلی را تغییر ندهد.

FAQ

محدودیت Claude من چه زمانی بازنشانی می‌شود؟

پیام نمایش‌داده‌شده این موضوع را به شما می‌گوید. محدودیت‌های نشست (session) در یک بازه زمانی متغیر 5 ساعته محاسبه می‌شوند و پیام، زمان دقیق (مانند resets 3:45pm) را نشان می‌دهد. محدودیت‌های هفتگی در یک زمان ثابت در هر هفته که به حساب شما اختصاص یافته بازنشانی می‌شوند و پیام، روز مربوطه (مانند resets Mon 12:00am) را نمایش می‌دهد. برای مشاهده نمودارها و زمان‌های بازنشانی که پیش از رسیدن به محدودیت برای طرح شما اعمال می‌شود، دستور /usage را در Claude Code اجرا کنید یا به بخش Settings و سپس Usage در claude.ai بروید. حساب‌های Verified Ultra محدودیت نشست 5 ساعته ندارند. اگر Anthropic یک بازنشانی محدودیت برای حساب شما در نظر گرفته باشد، در همان صفحه دکمه Reset for free نمایش داده می‌شود که بلافاصله بازه زمانی شما را به حالت کامل بازمی‌گرداند.

آیا تغییر به Sonnet باعث می‌شود دوباره بتوانم کار کنم؟

بله، زمانی که پیام نام یک مدل خاص را ذکر می‌کند؛ همچنین Anthropic به کاربران Enterprise که به محدودیت استفاده رسیده‌اند، پیشنهاد می‌کند یک مدل سبک‌تر را امتحان کنند. پس از You've hit your Opus limit، دستور /model را اجرا کنید، مدل دیگری را انتخاب کنید تا نشست با حفظ context شما ادامه یابد. در طرح‌های Pro، Max و Ultra، پس از You've hit your session limit یا You've hit your weekly limit، تغییر مدل باعث بازگشت سهمیه اشتراکی نمی‌شود. تغییر به یک مدل ارزان‌تر پیش از رسیدن به سقف محدودیت، در واقع همان چیزی است که بازه زمانی شما را افزایش می‌دهد.

آیا شروع یک چت جدید محدودیت استفاده من را بازنشانی می‌کند؟

خیر. میزان استفاده بر اساس حساب شما محاسبه می‌شود، بنابراین یک چت جدید نیز از همان سهمیه خالی (تمام‌شده) استفاده می‌کند. البته این کار باعث می‌شود هر پیام بعدی ارزان‌تر باشد، زیرا گفتگوی جدید فاقد تاریخچه‌ای است که Claude بخواهد دوباره آن را بخواند. دستور /clear در Claude Code همین کار را انجام می‌دهد و هزینه‌ای ندارد، در حالی که /compact باید گفتگویی که خلاصه می‌کند را بخواند؛ بنابراین فشرده‌سازی یک نشست بسیار بزرگ، خود یک درخواست پرهزینه است.

آیا استفاده از API ارزان‌تر از ارتقای طرح اشتراک است؟

این موضوع به میزان پایداری استفاده شما بستگی دارد. کار انجام‌شده در یک بعدازظهر که در این صفحه آمده، با نرخ‌های اکتبر 2026، در مدل Sonnet 5 هزینه $2.26 و در مدل Haiku 4.5 هزینه $1.13 دارد. اشتراک یک هزینه ثابت برای یک سهمیه محدود است، بنابراین زمانی که اکثر روزها کار می‌کنید، به‌صرفه‌تر است. صورت‌حساب بر اساس توکن (Per token billing) زمانی به‌صرفه‌تر است که بار کاری شما نوسانی باشد، زیرا در روزهای کم‌کاری هیچ هزینه‌ای برای شما ندارد.

آیا می‌توانم در حین انتظار برای بازنشانی، یک کار را در حال اجرا نگه دارم؟

بله، اگر آن را از طرح اشتراک خود خارج کنید. آن را روی یک VPS با تنظیم ANTHROPIC_API_KEY در محیط اجرا کنید؛ در این صورت هزینه بر اساس توکن محاسبه می‌شود و از سهمیه طرح شما کسر نمی‌گردد، بنابراین این دو هرگز با هم تداخل نخواهند داشت. دستور claude --bare -p داخل tmux حتی پس از بستن لپ‌تاپ شما به کار خود ادامه می‌دهد و --output-format json یک فیلد total_cost_usd می‌نویسد که می‌توانید صبح روز بعد با jq آن را بررسی کنید.

آیا این مقاله مفید بود؟