محدودیت Claude Code؛ سقف مصرف Pro و Max و رفع Rate Limit

محدودیت Claude Code یک تعداد پیام ثابت برای همه نیست. میزان مصرف به مدل، طول context، اندازهٔ فایل‌ها، پیچیدگی task، قابلیت‌های فعال و سطح effort بستگی دارد. علاوه بر این، Claude.ai، برنامهٔ دسکتاپ و Claude Code از ظرفیت مشترک پلن شما استفاده می‌کنند؛ مصرف یکی می‌تواند دیگری را زودتر به سقف برساند.

در پلن‌های فردی، پیام رسیدن به usage limit معمولاً زمان بازنشانی را نشان می‌دهد و ظرفیت جلسه طبق راهنمای فعلی هر پنج ساعت باز می‌شود. اما این به معنی پنج ساعت استفادهٔ نامحدود نیست و Anthropic عدد ثابت پیام یا توکن برای همهٔ کاربران تضمین نمی‌کند.

سه نوع محدودیت را از هم جدا کنید

کاربران معمولاً هر توقفی را rate limit می‌نامند، در حالی که علت‌ها متفاوت‌اند:

نوع محدودیت	کجا دیده می‌شود؟	معنی	اقدام اصلی
Usage limit اشتراک	Pro، Max و برنامه‌های Claude	ظرفیت شامل پلن تمام شده	صبر تا reset، کاهش مصرف یا اعتبار اضافه
Rate limit API	Claude Console/API	تعداد درخواست یا توکن در بازه کوتاه زیاد است	backoff، صف، کاهش concurrency یا tier مناسب
Spend limit / credit	API یا usage credits	سقف هزینه یا موجودی تمام شده	بررسی Billing، افزایش کنترل‌شدهٔ سقف یا اعتبار

پیام خطا و صفحهٔ Billing مشخص می‌کند با کدام مورد روبه‌رو هستید. بالا بردن پلن همیشه rate limit API را حل نمی‌کند و خرید اعتبار نیز لزوماً capacity اشتراک را بیشتر نمی‌کند.

سقف Claude Pro و Max چقدر است؟

Anthropic در راهنمای مصرف و طول گفتگو توضیح می‌دهد که تعداد پیام قابل ارائه به چند عامل وابسته است. بنابراین جدول‌هایی که یک عدد قطعی برای همهٔ کاربران می‌دهند قابل اتکا نیستند.

Max 5x حدود پنج برابر و Max 20x حدود بیست برابر ظرفیت Pro ارائه می‌کند، اما واحد تبلیغ‌شده «ظرفیت نسبی» است، نه تعداد پیام تضمینی. صفحهٔ مقایسه Claude Pro و Max قیمت و زمان مناسب ارتقا را بررسی می‌کند.

چه چیزهایی ظرفیت را سریع‌تر مصرف می‌کنند؟

• گفت‌وگوی بسیار طولانی که در هر turn context زیادی حمل می‌کند؛
• مخزن بزرگ و خواندن فایل‌های نامرتبط؛
• مدل قوی‌تر یا effort بالاتر برای کار ساده؛
• تولید خروجی‌های بلند و بازنویسی کامل فایل‌ها؛
• اجرای چند task عامل‌محور پشت سر هم؛
• استفادهٔ هم‌زمان از Claude.ai، Desktop و Claude Code؛
• تکرار یک خطا بدون محدودکردن علت و دادهٔ ورودی.

این عوامل فقط هزینه نیستند؛ کیفیت را هم پایین می‌آورند. context بزرگ و مبهم به مدل اجازه نمی‌دهد هدف و معیار پایان را واضح ببیند.

سه سناریوی مصرف واقعی Claude Code

به‌جای پرسیدن «چند پیام دارم؟»، شکل task را بررسی کنید. سناریوهای زیر عدد تضمینی نیستند؛ مقایسهٔ نسبی‌اند تا بفهمید چه چیزی ظرفیت را سریع‌تر مصرف می‌کند.

برای مقایسهٔ سریع مدل، اندازهٔ مخزن، طول جلسه و تعداد درخواست‌ها، تخمین‌گر رایگان مصرف Claude Code را امتحان کنید. این ابزار سهمیهٔ رسمی یا تعداد پیام تضمین‌شده اعلام نمی‌کند و ورودی‌ها را ذخیره نمی‌کند.

سناریو	فشار نسبی روی ظرفیت	علت اصلی	اولین اقدام
اصلاح یک تابع در جلسهٔ تازه، با فایل و تست مشخص	کمتر	context محدود و معیار پایان روشن	همان session کوتاه را نگه دارید
refactor چندفایلی همراه build، تست و چند دور اصلاح	بیشتر	فایل‌ها، خروجی ابزار و تاریخچه در هر turn حمل می‌شوند	ابتدا plan بگیرید و task را به مرحله‌های مستقل بشکنید
debugging طولانی با log بزرگ و تکرار command ناموفق	زیاد	تاریخچه و خروجی خطا پیوسته بزرگ‌تر می‌شود	علت را محدود و پس از تغییر موضوع از /clear استفاده کنید
چند agent یا session موازی همراه استفاده از Claude.ai	بسیار زیاد	چند جریان هم‌زمان از pool مشترک پلن کم می‌کنند	concurrency را کم و کارهای غیرضروری را زمان‌بندی کنید

راهنمای رسمی مدل و مصرف Claude Code توضیح می‌دهد که تاریخچهٔ گفتگو، context پروژه و prompt تازه در هر turn برای مدل ارسال می‌شوند. به همین دلیل یک سؤال کوتاه در انتهای جلسهٔ طولانی لزوماً مصرف کمی ندارد.

محدودیت هر چند ساعت ریست می‌شود؟

طبق راهنمای usage credits پلن‌های فردی، session limit طبق روال هر پنج ساعت بازنشانی می‌شود. وقتی به سقف نزدیک شوید یا آن را رد کنید، Claude هشدار و زمان reset را نشان می‌دهد. زمان دقیق نمایش‌داده‌شده در خود حساب را مرجع قرار دهید.

ممکن است کنترل‌های دیگری غیر از پنجرهٔ پنج‌ساعته نیز وجود داشته باشد. سیاست ظرفیت با تقاضا و حساب تغییر می‌کند. به همین دلیل نباید workflow production را بر فرض «هر پنج ساعت دقیقاً X پیام» طراحی کنید.

usage credits پس از سقف چه می‌کند؟

در صورت فعال‌بودن برای حساب شما، می‌توانید اعتبار پیش‌پرداخت اضافه کنید. پس از تمام‌شدن ظرفیت پلن، ادامهٔ مصرف با نرخ استاندارد API از آن اعتبار کم می‌شود. این هزینه جدا از Pro یا Max است و باید برای آن spend limit بگذارید. با شروع پنجرهٔ بعدی، ظرفیت شامل پلن دوباره در دسترس قرار می‌گیرد.

این گزینه برای عبور گاه‌به‌گاه مناسب است. اگر هر روز اعتبار زیادی مصرف می‌کنید، مجموع هزینه را با ارتقا به Max یا رفتن به API مستقیم مقایسه کنید.

درخت تشخیص یک‌دقیقه‌ای محدودیت

1. پیام «limit reached» همراه زمان reset می‌بینید؟ این به احتمال زیاد usage limit اشتراک است. با /status وضعیت را ببینید و تا reset صبر کنید، مصرف را کاهش دهید یا با تأیید خودتان از اعتبار اضافه استفاده کنید.
2. هشدار پرشدن context یا افت کیفیت در جلسهٔ طولانی دارید؟ این با تمام‌شدن سهمیه یکی نیست. /context را بررسی کنید؛ برای ادامهٔ همان task از /compact و برای task تازه از /clear استفاده کنید.
3. با API key خطای 429 گرفته‌اید؟ header مربوط به retry-after را بخوانید، concurrency را کم کنید و backoff بگذارید. ارتقای Pro یا Max این rate limit سازمان API را تغییر نمی‌دهد.
4. موجودی یا spend cap تمام شده است؟ Billing و Limits را بررسی کنید. خرید ظرفیت اشتراک، اعتبار Console را شارژ نمی‌کند.
5. هیچ‌کدام نیست؟ وضعیت سرویس، نسخهٔ Claude Code، روش ورود و متن کامل خطا را بررسی کنید؛ مشکل ممکن است شبکه یا احراز هویت باشد.

اگر متغیر ANTHROPIC_API_KEY روی سیستم فعال باشد، Claude Code ممکن است به‌جای ظرفیت اشتراک از API استفاده و هزینهٔ مصرفی ایجاد کند. راهنمای رسمی اتصال Pro و Max توصیه می‌کند روش ورود را کنترل کنید؛ برای تشخیص هزینهٔ session API نیز فرمان /cost قابل استفاده است.

روش‌های واقعی کاهش مصرف Claude Code

۱. task را کوچک و قابل پایان کنید

به‌جای «کل اپ را refactor کن» بنویسید: «در فایل X تابع Y را طوری تغییر بده که خطای Z رفع شود؛ API عمومی عوض نشود و تست A پاس شود.» محدودهٔ روشن تعداد فایل و دورهای رفت‌وبرگشت را کم می‌کند.

۲. فایل‌های لازم را مشخص کنید

اگر Claude برای یافتن مسئله مجبور به پیمایش کل مخزن باشد، context بیشتری مصرف می‌کند. مسیر فایل، stack trace، command تست و رفتار مورد انتظار را بدهید. فایل‌های build، vendor و دادهٔ حجیم را از context خارج کنید.

۳. جلسهٔ قدیمی را بی‌دلیل ادامه ندهید

وقتی موضوع کاملاً عوض شده، با /clear جلسهٔ تازه شروع کنید تا تاریخچهٔ نامرتبط در turnهای بعدی حمل نشود. اگر همان task ادامه دارد و فقط context بزرگ شده، /compact خلاصه‌ای از مسیر فعلی می‌سازد. قبل از پاک‌کردن، تصمیم‌ها و تغییرات مهم را در فایل پروژه ثبت کنید؛ /clear قابل بازگشت نیست.

۴. مدل را با task هماهنگ کنید

با /model مدل‌های قابل استفادهٔ حساب خود را ببینید. برای جست‌وجوی ساده، formatting یا اصلاح کوچک همیشه قوی‌ترین مدل لازم نیست. راهنمای Anthropic، Sonnet را انتخاب معمول بیشتر کارهای کدنویسی و Opus را مناسب debugging دشوار، refactor گسترده یا تصمیم معماری معرفی می‌کند. انتخاب مدل باید با آزمون کیفیت همراه باشد و نام‌های موجود در خود /model مرجع حساب شما هستند.

۵. خروجی را محدود کنید

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

۶. loop را متوقف کنید

اگر یک command سه بار با خطای مشابه شکست خورده، اجرای دوباره احتمالاً مصرف را زیاد می‌کند. علت، permission، dependency و environment را جدا بررسی کنید. برای عامل‌ها حداکثر دور و شرط توقف تعیین کنید.

Rate limit در API چگونه کار می‌کند؟

مستندات رسمی rate limits دو محدودیت را جدا می‌کند: spend limit حداکثر هزینهٔ ماهانه و rate limit حداکثر درخواست یا توکن در یک بازه. سازمان‌ها بر اساس usage tier و سابقهٔ حساب ظرفیت متفاوتی دارند. حساب تازه ممکن است پایین‌تر از جدول استاندارد شروع کند.

API از الگوریتم token bucket استفاده می‌کند؛ ظرفیت به‌مرور دوباره پر می‌شود. یک burst کوتاه می‌تواند خطا بدهد حتی اگر میانگین دقیقه‌ای شما پایین باشد. پاسخ مناسب فنی معمولاً این‌هاست:

• concurrency را محدود کنید؛
• درخواست‌ها را در صف قرار دهید؛
• exponential backoff با jitter اجرا کنید؛
• headerهای مربوط به limit و retry را بخوانید؛
• retry بی‌نهایت نداشته باشید؛
• برای افزایش tier از مسیر رسمی Console یا پشتیبانی اقدام کنید.

تعویض IP یا ساخت حساب‌های متعدد راه‌حل مهندسی rate limit نیست و می‌تواند کنترل‌های ضدسوءاستفاده را درگیر کند.

خطاهای مشابه محدودیت

گاهی مشکل از capacity نیست. راهنمای خطاهای Claude پیشنهاد می‌کند وضعیت سرویس، اتصال، نسخهٔ برنامه و ورود را بررسی کنید. برای خطاهای عمومی login، راهنمای رسمی حتی خاموش‌کردن VPN را در عیب‌یابی ذکر می‌کند؛ بنابراین توصیهٔ عمومی فروشنده‌ها درباره «همیشه VPN روشن» با راهنمای رسمی یکسان نیست.

این ترتیب را انجام دهید:

1. متن کامل خطا و زمان وقوع را ثبت کنید.
2. صفحهٔ وضعیت و حساب Billing/Usage را بررسی کنید.
3. اگر زمان reset نمایش داده شده، تا همان زمان صبر کنید.
4. اگر خطا 429 API است، نرخ و header پاسخ را بررسی کنید.
5. اگر اعتبار یا spend cap تمام شده، Billing را اصلاح کنید.
6. اگر ورود یا region خطا دارد، از مسیر رسمی پشتیبانی اقدام کنید و روش دورزدن پیشنهاد ندهید.

برنامه‌ای برای جلوگیری از توقف کار

• taskهای بزرگ را پیش از شروع به بخش‌های مستقل تقسیم کنید.
• تست و build را خودکار کنید تا مدل خروجی کوتاه و قابل سنجش بگیرد.
• زمان reset را ثبت و کارهای بدون مدل را برای بازهٔ انتظار آماده کنید.
• روی یک حساب فردی مشترک برای تیم حساب نکنید.
• برای API سقف هزینه، صف و backoff از ابتدا بسازید.
• promptها و دستورالعمل پروژه را در مخزن خود نگه دارید.
• اگر کار حیاتی است، provider جایگزین و امکان تغییر endpoint داشته باشید.

برای مقایسهٔ هزینهٔ مسیرها، راهنمای خرید Claude Code را بخوانید. راهنمای مادر خرید اکانت Claude AI نیز محدودیت منطقه و مالکیت حساب را جدا بررسی می‌کند.

پرسش‌های متداول

محدودیت Claude Code چند پیام است؟

عدد ثابت و تضمین‌شده‌ای وجود ندارد. مدل، طول context، پیچیدگی، effort و استفادهٔ شما از سایر برنامه‌های Claude روی ظرفیت اثر دارند.

محدودیت Claude Code هر چند ساعت ریست می‌شود؟

راهنمای فعلی Anthropic برای پلن‌های فردی از بازنشانی جلسه هر پنج ساعت می‌گوید. زمان دقیق نمایش‌داده‌شده در حساب خود را مرجع قرار دهید.

آیا Max 20x محدودیت ندارد؟

دارد. Max 20x ظرفیت بیشتری نسبت به Pro می‌دهد، اما نامحدود نیست و محدودیت‌های سرویس همچنان اعمال می‌شوند.

خطای 429 یعنی اشتراکم تمام شده؟

نه لزوماً. در API معمولاً rate limit است؛ در برنامهٔ اشتراکی ممکن است پیام usage limit جداگانه ببینید. متن خطا و صفحهٔ Usage/Billing را بررسی کنید.

چگونه مصرف Claude Code را کم کنم؟

task را محدود کنید، فایل‌های لازم را مشخص کنید، جلسهٔ نامرتبط را ادامه ندهید، مدل مناسب‌تر انتخاب کنید، خروجی را کوتاه نگه دارید و loopهای تکرار خطا را متوقف کنید.

از کجا بفهمم context پر شده یا usage limit تمام شده است؟

usage limit معمولاً پیام توقف و زمان reset دارد؛ پرشدن context به طول همان جلسه مربوط است و با /context دیده می‌شود. برای context از /compact یا /clear استفاده کنید، اما برای usage limit باید تا reset صبر کنید، مصرف را کاهش دهید یا مسیر اعتبار اضافه را آگاهانه انتخاب کنید.

روش تهیه و بازبینی این راهنما

این مقاله در ۷ اوت ۲۰۲۶ با راهنمای مدل، مصرف و محدودیت Claude Code، راهنمای مصرف و طول، اتصال Claude Code به Pro و Max، usage credits، مستندات rate limits و راهنمای خطاها بازبینی شده است. تمام منابع خارجی رسمی و غیرایرانی‌اند. ظرفیت و سیاست‌ها جاری‌اند و باید هنگام مشاهدهٔ خطا دوباره بررسی شوند.