فشردهسازی در حالت بی‌کار Claude Code: شرایط فعال‌سازی، آستانه و روش خاموش کردن آن
برای خاموش کردن فشردهسازی در حالت بی‌کار، "idleCompaction": false را در settings.json قرار دهید (این کلید به 2.1.290 یا بالاتر نیاز دارد)، یا از ردیف Idle compaction در /config استفاده کنید. فشردهسازی در حالت بی‌کار در Claude Code 2.1.299 (انتشار: 2026-10-14) به‌عنوان رفتار پیش‌فرض آمد: مکالمه‌ای که زمینه آن به آستانه توکن رسیده باشد (به‌طور پیش‌فرض 200,000) و حدود 54 دقیقه در حالی که رایانه بیدار است بی‌کار بماند، کمی پیش از منقضی شدن کش prompt آن فشرده میشود؛ با بازگشت، مکالمه `Compacted while idle, before the prompt cache expired` را نشان میدهد و پیام بعدی شما بهجای کل مکالمه یک خلاصه می‌فرستد. تا 2026-10-19، آخرین نسخه در npm، 2.1.303 است (انتشار: 2026-10-18).
به‌روزرسانی شده 2026-11-14
یک کلید برای Claude، GPT و مدل‌های پیشروی چینی، با صورتحساب به‌ازای توکن، آماده به کار در چند دقیقه.
- صورتحساب به‌ازای توکن — نرخ‌های زنده در /models
- پرداخت با کارت (Visa / Mastercard)، Apple Pay، Google Pay یا رمزارز
- بهصورت خودخدمت: شارژ حساب و فعال‌سازی فوری
شرایط فعال‌سازی، آستانه و روش خاموش کردن آن
رفتار پیش‌فرض از 2.1.299
مستندات بیان میکند که فشردهسازی در حالت بی‌کار برای مکالمه‌هایی که شرایط را برآورده می‌کنند به‌طور پیش‌فرض فعال است. کلید تغییر آن `idleCompaction` در settings.json است، به‌طور پیش‌فرض true، با دامنه Any file.
مدت زمانی که نشست باید بی‌کار بماند
معیار بیکاری این است که حدود 54 دقیقه از آخرین درخواست گذشته باشد و رایانه شما در آن لحظه بیدار باشد؛ زمینه باید به آستانه توکن رسیده باشد، به‌طور پیش‌فرض 200,000، که با متغیر محیطی `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` قابل تغییر است، و مقادیر کمتر از 100000 به 100000 افزایش می‌یابند.
پیش‌شرط‌هایی که مستندات فهرست میکند
پیششرطها عبارتاند از: یک نشست ترمینال تعاملی، اجرای مکالمه با عمر کش prompt یک‌ساعته، توانایی Claude Code برای دریافت پرچم‌های ویژگی، رسیدن زمینه به آستانه، و بیدار بودن ماشین پس از یک دوره بیکاری طولانی.
روش‌هایی که مستندات ارائه میدهد
"idleCompaction": false را در settings.json قرار دهید (2.1.290 یا بالاتر)؛ در نسخه‌های پیشین autoCompactEnabled: false را تنظیم کنید؛ متغیر محیطی `DISABLE_AUTO_COMPACT=1` فشردهسازی در حالت بی‌کار را همراه با فشردهسازی خودکار خاموش میکند، و /compact دستی همچنان در دسترس است. از 2.1.302 به بعد، یک ردیف Idle compaction نیز در /config وجود دارد.
فشردهسازی در حالت بی‌کار در عمل چه میکند
مکالمه‌ای را که از آن فاصله گرفته‌اید به یک خلاصه تبدیل میکند، و پیشوند کش قدیمی دیگر استفاده مجدد نمی‌شود. مستندات بیان میکند که فشردهسازی در حالت بی‌کار کمی پیش از منقضی شدن کش prompt رخ میدهد و پیام بعدی شما بهجای کل مکالمه یک خلاصه می‌فرستد. یادداشت دیگری در همان مستندات می‌گوید فشردهسازی یک پیشوند کش جدید میسازد، در حالی که /rewind به پیشوندی که از قبل در کش است برمی‌گردد. نوشتن در کش و خواندن از کش جداگانه محاسبه می‌شوند، هر یک با نرخ خودش؛ تفاوت بین نرخ‌های نوشتن کش در عمرهای مختلف در صفحه /prompt-caching-cost-2026 است.
فهرست تغییرات و مستندات رسمی تا 2026-10-19
در 2026-10-19، این مطلب با فهرست تغییرات Claude Code، مرجع تنظیمات و صفحه متغیرهای محیطی بررسی شد: 2.1.299 (انتشار: 2026-10-14) فشردهسازی در حالت بی‌کار را در ترمینال به‌همراه `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` برای تغییر آستانه افزود؛ 2.1.302 (انتشار: 2026-10-16) یک ردیف Idle compaction به /config افزود، و اعلان پس از فشردهسازی در حالت بی‌کار اکنون می‌گوید چگونه آن را خاموش کنید؛ آخرین نسخه در npm، 2.1.303 است (انتشار: 2026-10-18).
انتشارها و تاریخ‌ها
Claude Code 2.1.299 منتشر شد و لیست تغییرات، ورود فشردهسازی در حالت بی‌کار به ترمینال را ثبت کرده است: از این انتشار به بعد، گفتگویی که شرایط را برآورده کند بهصورت خودکار فشرده میشود.
Claude Code 2.1.302 منتشر شد و لیست تغییرات، ردیف Idle compaction را در /config ثبت کرده است؛ اعلان پس از فشردهسازی در حالت بی‌کار نیز نحوه خاموش کردن آن را بیان میکند.
تا تاریخ 2026-10-19، آخرین نسخه در npm برابر 2.1.303 است (منتشرشده در 2026-10-18) و کلید و شرایط فعال‌سازی در مرجع تنظیمات تغییر نکرده‌اند.
آنچه مستندات بیان می‌کنند و آنچه را بی‌پاسخ می‌گذارند
تأییدشده (واژه‌به‌واژه در صفحات رسمی)
① فشردهسازی در حالت بی‌کار به‌طور پیش‌فرض برای گفتگوهایی که شرایط را برآورده می‌کنند فعال است؛ ② حدود 54 دقیقه از آخرین درخواست گذشته است و رایانه شما در آن لحظه بیدار است؛ ③ زمینه به آستانه توکن رسیده است، به‌طور پیش‌فرض 200,000؛ ④ مقادیر کمتر از 100000 به 100000 افزایش می‌یابند؛ ⑤ نسخه‌های قدیمی‌تر کلید را نادیده می‌گیرند و مستندات به شما میگویند بهجای آن autoCompactEnabled را خاموش کنید؛ ⑥ اعلانی در گفتگو می‌گوید فشردهسازی پیش از انقضای کش رخ داده است؛ ⑦ فشردهسازی یک پیشوند کش جدید میسازد، در حالی که /rewind به پیشوندی که از قبل در کش ذخیره شده است بازمی‌گردد؛ ⑧ کش prompt دو عمر پنج‌دقیقه‌ای و یک‌ساعته دارد و نوشتن در کش با عمر یک‌ساعته هزینه بیشتری دارد
آنچه مستندات بی‌پاسخ می‌گذارند
مستندات نمی‌گویند فشردهسازی در حالت بی‌کار چگونه بر هزینه‌های دقیق کش اثر میگذارد، آیا آزمون بی‌کار بودن با نسخه تغییر میکند، یا کدام یک از فشردهسازی در حالت بی‌کار و فشردهسازی خودکار ابتدا رخ میدهد وقتی هر دو اعمال شوند: مرجع تنظیمات کلید و شرایط هر یک را میدهد، اما ترتیبی نمی‌دهد.
حالت پیش‌فرض را نگه دارید یا آن را خاموش کنید
حالت پیش‌فرض را نگه دارید
پیش‌فرض دقیقاً همین است: گفتگویی که شرایط را برآورده کند فشرده میشود، اعلانی در گفتگو می‌گوید فشردهسازی پیش از انقضای کش رخ داده است و پیام بعدی یک خلاصه می‌فرستد. آستانه را می‌توان با `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` جابه‌جا کرد. خود شرایط به عمر کش بستگی دارند: جدول رسمی TTL برای گفتگوی اصلی در ستون اعتبار مصرف، کلید API یا ارائه‌دهنده ابری، پنج دقیقه را فهرست میکند، بنابراین شرط یک‌ساعته در آنجا برقرار نیست (برای کش یک‌ساعته گفتگوی اصلی، خودتان promptCacheTtl را روی 1h تنظیم می‌کنید).
آن را خاموش کنید
چهار روش در بالا فهرست شده‌اند: کلید در settings.json، autoCompactEnabled در نسخه‌های قدیمی‌تر، متغیر محیطی که فشردهسازی خودکار را نیز خاموش میکند، و ردیف کلید در /config. با خاموش بودن آن، گفتگو تا زمانی که خودتان /compact را اجرا کنید یا زمینه به حد مجاز نزدیک شود، باقی می‌ماند.
ترتیب بررسی فشردهسازی در حالت بی‌کار
① نسخه را بررسی کنید: کلید «idleCompaction» فقط از 2.1.290 به بعد خوانده میشود. ② تأیید کنید که همین است: اعلان در گفتگو که می‌گوید فشردهسازی پیش از انقضای کش رخ داده است، نشانه فشردهسازی در حالت بی‌کار است، در حالی که /compact دستی چیز دیگری است. ③ شرایط را بررسی کنید: نشست ترمینال تعاملی، عمر کش یک‌ساعته، زمینه در آستانه، و بیدار بودن ماشین پس از یک دوره طولانی بیکاری — همه باید برقرار باشند. ④ برای خاموش کردن آن: کلید فشردهسازی در حالت بی‌کار در settings.json، یا ردیف Idle compaction در /config. ⑤ برای جابه‌جایی آستانه: `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` یک عدد صحیح مثبت می‌گیرد و مقادیر کمتر از 100000 به 100000 افزایش می‌یابند.
اتصال Claude Code با کلید QCode
همان‌طور که صفحه متغیرهای محیطی QCode می‌گوید: ANTHROPIC_BASE_URL تا پیشوند /api پر میشود (https://api.qcode.cc/api)، کلید در ANTHROPIC_AUTH_TOKEN قرار می‌گیرد (با cr_ شروع میشود و Claude Code آن را به‌عنوان توکن Bearer می‌فرستد)، و ابزارهایی که فقط ANTHROPIC_API_KEY را می‌پذیرند می‌توانند از همان کلید استفاده کنند. QCode.cc پیش‌پرداخت است: موجودی حساب را شارژ می‌کنید، سپس یک پلن یا بسته می‌خرید و خرید از همان موجودی پرداخت میشود؛ 5 درخواست هم‌زمان، همان مدل‌های پلن‌های شخصی؛ بر اساس توکن محاسبه میشود، نرخ‌های هر مدل در /models فهرست شده‌اند. برای پلن ماهانه آماده نیستید؟ بسته‌های پرداخت به‌ازای مصرف از $4 برای یک سهمیه یک‌باره که ظرف 7 روز مصرف می‌کنید شروع می‌شوند.
پرسش‌های متداول
کدام نسخه idle compaction را اضافه کرد؟
2.1.299. لیست تغییرات رسمی، ورود idle compaction به ترمینال را در آن انتشار ثبت کرده است، همراه با `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` برای تغییر آستانه. در npm، dist-tag پایدار هنوز به 2.1.292 اشاره میکند، بنابراین نصبی که از کانال پایدار انجام شود ممکن است هنوز این رفتار را نداشته باشد؛ آخرین نسخه 2.1.303 است (منتشرشده در 2026-10-18).
چرا وقتی بازمیگردم، بخشی از زمینه از بین رفته است؟
به احتمال زیاد فشردهسازی هنگام بیکاری: مستندات میگویند پیام بعدی شما بهجای کل گفتگو یک خلاصه ارسال میکند. پیششرطها عبارتاند از جلسه ترمینال تعاملی، رسیدن زمینه گفتگو به آستانه، و بیدار بودن دستگاه پس از مدت طولانی بیکاری. دستور دستی /compact نیز گفتگو را با یک خلاصه جایگزین میکند.
چگونه آن را خاموش کنم؟
برای خاموش کردن آن، در settings.json مقدار "idleCompaction": false را قرار دهید؛ در نسخه‌های قبلی autoCompactEnabled: false را تنظیم کنید. متغیر محیطی `DISABLE_AUTO_COMPACT=1` فشردهسازی هنگام بیکاری را همراه با فشردهسازی خودکاری که نزدیک سقف فعال میشود خاموش میکند، و /compact دستی همچنان در دسترس می‌ماند.
آیا بر هزینه پرداختی من اثر میگذارد؟
نحوه نوشتن و خواندن کش را تغییر میدهد: مستندات میگویند فشردهسازی یک پیشوند کش جدید میسازد، در حالی که /rewind تا پیشوندی که از قبل در کش است عقب میرود؛ کش prompt بهصورت جداگانه با cache_creation_input_tokens و cache_read_input_tokens محاسبه میشود؛ اولی با نرخ نوشتن در کش و دومی با نرخ خواندن از کش صورتحساب میشود. قیمتهای کش هر مدل در صفحه /prompt-caching-cost-2026 آمده است.
چرا وقتی با کلید API متصل می‌شوم، فشردهسازی هنگام بیکاری فعال نمی‌شود؟
جدول رسمی TTL برای گفتگوی اصلی در حالت اعتبار مصرف، کلید API یا ارائه‌دهنده ابری پنج دقیقه را فهرست میکند، در حالی که یکی از شرایط فشردهسازی هنگام بیکاری این است که گفتگو با عمر کش prompt یک‌ساعته اجرا شود — بنابراین با کلید API آن شرط معمولاً برقرار نیست. برای کش یک‌ساعته گفتگوی اصلی، مستندات از شما می‌خواهند خودتان promptCacheTtl را روی 1h تنظیم کنید (نیازمند 2.1.242 یا جدیدتر).
طرف رسمی اخیراً چه چیزی را تغییر داده است؟
اکنون ردیفی با عنوان Idle compaction در /config وجود دارد، بنابراین فشردهسازی هنگام بیکاری را می‌توان در هر زمان خاموش و دوباره روشن کرد، و تاریخچه تغییرات می‌گوید اعلان پس از فشردهسازی هنگام بیکاری اکنون به شما می‌گوید چگونه آن را خاموش کنید. بقیه سازوکار بدون تغییر است: آستانه، آزمون بیکاری و عمر کش همچنان همان شرایطی هستند که مستندات فهرست میکند.
منابع
منابع رسمی: changelog Claude Code (raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md، واکشی و بررسی‌شده در 2026-10-19)، مرجع رسمی تنظیمات، صفحه متغیرهای محیطی و صفحه کش prompt (code.claude.com/docs/en، واکشی و بررسی‌شده در 2026-10-19)، و سوابق انتشار @anthropic-ai/claude-code در npm (registry.npmjs.org، واکشی و بررسی‌شده در 2026-10-19: نسخه 2.1.299 منتشرشده در 2026-10-14). از سمت QCode: صفحه‌های Environment variables و Endpoints and API formats در docs.qcode.cc (واکشی و بررسی‌شده در 2026-10-19)، و صفحه پرداخت به‌ازای مصرف در qcode.cc به پنج زبان (واکشی و بررسی‌شده در 2026-10-19).
Claude Code را روی یک بسته اجرا کنید
آماده پلن ماهانه نیستید؟ بسته‌های پرداخت به‌ازای مصرف از $4 برای یک سهمیه یک‌باره شروع می‌شوند که آن را ظرف 7 روز مصرف می‌کنید.
مطالب مرتبط
بسته‌های پرداخت به‌ازای مصرف
بسته‌های سهمیه یک‌باره که به مدت 7 روز معتبرند، بدون اشتراک؛ بسته‌های اضافی به همان کلید اضافه می‌شوند.
ردیاب قیمت کش prompt 2026
قیمتهای خواندن و نوشتن کش، TTLها و حداقل طول کش برای Claude، GPT و DeepSeek، همراه با دو مثال قابل محاسبه مجدد (به تاریخ 2026-10-07).
راهنمای بهینه‌سازی هزینه
صرفه‌جویی توکن در Claude Code و راهبردهای مسیریابی هوشمند
راهنمای پرداخت با رمزارز
نه رمزارز، 56 شبکه، کارمزد پلتفرم صفر برای اعتبار API کدنویسی با هوش مصنوعی.
این صفحه در 2026-10-19 با تاریخچه تغییرات Claude Code، مستندات رسمی و سوابق انتشار npm بررسی شد؛ این سازوکارها با نسخه تغییر می‌کنند، انتشارهای بعدی ممکن است آن‌ها را تنظیم کنند، بنابراین مستندات رسمی مرجع است. دسترس‌پذیری مدل‌ها در QCode در /models فهرست شده است.