Claude Code: تفاوت /clear و /compact، هر کدام چه میکنند و کی باید از کدام استفاده کرد
/clear و /compact در Claude Code چه میکنند، هر کدام چه چیزی را نگه میدارند و چه چیزی را از دست میدهند، auto-compact چگونه کار میکند و چطور خاموش میشود، پنجرهی کانتکست چقدر بزرگ است و کی باید از کدام استفاده کرد. با مستندات تطبیق داده شده و روی Claude Code 2.1.319 آزمایش شده است.

پنجرهی کانتکست یعنی هر چیزی که Claude Code در یک لحظه میبیند: گفتگوی شما، فایلهایی که خوانده و دستورالعملهایی که بارگذاری کرده است. /clear آن را خالی میکند و گفتگوی تازهای شروع میکند، و /compact آن را به یک خلاصه فشرده میکند و همان گفتگو را ادامه میدهد. ما هر دستور و تنظیم زیر را با مستندات Anthropic تطبیق دادیم، سپس فشردهسازی و تنظیمات اصلی را روی Claude Code 2.1.319 آزمایش کردیم.
نگاه سریع به /clear و /compact
/clear | /compact | |
|---|---|---|
| چه میکند | گفتگوی جدید با پنجرهی خالی شروع میکند | گفتگوی تا اینجا را با یک خلاصه عوض میکند و ادامه میدهد |
| چه میماند | CLAUDE.md پروژه و auto memory که دوباره از دیسک بارگذاری میشوند | خلاصه، CLAUDE.md پروژه، auto memory، skills و حداکثر پنج فایل اخیر |
| چه میرود | همهی پیامها و همهی فایلهایی که Claude خوانده | عبارتبندی دقیق، خروجی ابزارها و جزئیات اولیه |
| گفتگوی قدیمی | ذخیره میشود، با /resume برمیگردد | با خلاصه جایگزین میشود |
| هزینه | هیچ | یک فراخوانی مدل که کل گفتگو را میخواند |
| کی استفاده کنیم | وقتی به کاری نامرتبط میروید | وقتی یک کار طولانی هنوز به تاریخچهاش نیاز دارد |
/clear چه میکند
/clear یک گفتگوی جدید با کانتکست خالی شروع میکند. گفتگوی قدیمی پاک نمیشود: ذخیره میشود و /resume آن را برمیگرداند. /reset و /new هم دقیقاً همین کار را میکنند. اگر اسمی بدهید، آن اسم روی گفتگویی که ترک میکنید مینشیند، نه گفتگوی جدید، پس /clear oauth-migration نشست قدیمی را با همان نام ذخیره میکند.
CLAUDE.md پروژه و auto memory، یادداشتهایی که Claude برای خودش نگه میدارد، دوباره بارگذاری میشوند، چون گفتگوی جدید مثل هر نشست تازهای شروع میشود. در آزمایش ما نشست جدید هیچکدام از ده واقعیتِ گفتگوی قبلی را نمیدانست و باز هم از قانون CLAUDE.md پیروی میکرد.
زیاد clear کنید، چون هر درخواست کل گفتگو را میفرستد. گفتگویی که سه کار نامرتبط در آن است، در هر نوبتِ کار چهارم هر سه را دوباره میخواند، با تخفیف تا وقتی prompt cache، یک انبار موقت که متن تکراری را ارزانتر میکند، گرم است و با قیمت کامل بعد از انقضای آن. مستندات API شرکت Anthropic دلیل کیفی هم اضافه میکند: با بالا رفتن تعداد توکنها دقت و یادآوری افت میکند، چیزی که اسمش را context rot گذاشتهاند. بعد از دو اصلاحِ ناموفق، توصیهی Anthropic این است که /clear بزنید و یک prompt بهتر بنویسید، نه اصلاح سوم.
/compact چه میکند
/compact گفتگوی تا اینجا را خلاصه میکند و در همان نشست ادامه میدهد. Claude هنوز برنامه و تصمیمها را دارد، اما با کلمات خلاصه نه کلمات شما. خالی اجرایش کنید تا Claude خودش تصمیم بگیرد چه چیزی مهم است، یا یک تمرکز اضافه کنید تا خلاصه چیزی را که نام میبرید حفظ کند: /compact keep the API changes and the test commands. برای تمرکز دائمی، یک بخش Compact instructions به CLAUDE.md پروژهتان اضافه کنید.
هشدار خود Anthropic: خلاصه درخواستها و قطعهکدهای کلیدی شما را نگه میدارد، اما دستورالعملهای مفصلِ ابتدای گفتگو ممکن است از دست بروند. هر چیزی که Claude نباید هرگز فراموش کند جایش CLAUDE.md است، نه گفتگو.
خلاصهسازی یک فراخوانی مدل است که کل گفتگو را میخواند. تا وقتی prompt cache گرم است ارزان است و بعد از انقضا قیمت کامل دارد، برای همین compact روی یک نشست قدیمیِ ازسرگرفتهشده گرانترین است. کش روی اشتراک حدود یک ساعت و روی کلید API پنج دقیقه دوام دارد. در یک وقفهی طبیعی compact کنید، مثلاً بین دو کار، نه وسط کار.
بعد از /compact چه میماند
مستندات میگویند برای هر نوع محتوا چه اتفاقی میافتد:
| چه | بعد از compact |
|---|---|
| CLAUDE.md در ریشهی پروژه، قوانین بدون محدوده، auto memory | دوباره از دیسک تزریق میشوند |
| Skills | توضیحات بازسازی میشوند؛ بدنهی skillهای فراخوانیشده دوباره تزریق میشود، تا 5,000 توکن برای هر کدام و در مجموع 25,000 |
| فایلهایی که Claude خوانده یا ویرایش کرده | تا پنج فایل دوباره خوانده میشود، تازهترینها اول؛ فایل بالای 5,000 توکن فقط به صورت مسیر برمیگردد |
| قوانین با محدودهی مسیر (فقط برای فایلهای خاص) و فایلهای CLAUDE.md تودرتو | در خلاصه محو میشوند و وقتی Claude به فایل مطابق دست بزند دوباره بارگذاری میشوند |
| پیامهای شما، پاسخهای Claude و خروجی ابزارها | با خلاصه جایگزین میشوند |
سطر بیسروصدا همان قوانین با محدودهی مسیر است. اگر قانونی باید از compact جان به در ببرد، فیلتر paths: آن را بردارید یا آن را به CLAUDE.md ریشهی پروژه ببرید.
آزمایش کردیم compact چه چیزی را نگه میدارد
ما Claude Code را از یک اسکریپت و بدون پنجرهی چت روی Sonnet 5.5 اجرا کردیم، با ابزارها و MCP (رابطهای اتصال به برنامههای دیگر) خاموش. به Claude دو سند ساختگیِ پروژه دادیم، هر کدام حدود 6,600 کلمه، با شش جزئیات پنهان در آنها: شمارهی فاکتور، شمارهی رهگیری، نام یک عکاس، داخلی تلفن، ساعت تحریم انتشار خبر و پیشوند بارکد. بعد چهار تصمیم را در گفتگو تایپ کردیم (یک رنگ هگز، یک فونت حذفشده، یک شعاع گوشه و یک نام فایل)، در مجموع حدود 25,000 توکن. /compact را اجرا کردیم، یک نشست جدید در همان پوشه شروع کردیم تا جای /clear باشد، و از هر کدام خواستیم هر ده واقعیت را از حافظه بگوید.
قبل، توکنهای گفتگو
بعد از /clear، نشست جدید
بعد از /compact، یک خلاصه
| چه اجرا کردیم | اندازهی گفتگو بعد از آن | واقعیتهایی که Claude میدانست، از 10 |
|---|---|---|
| هیچ | 25k توکن | 10، در هر دو اجرا |
نشست جدید، مثل بعد از /clear | 0 | 0، و قانون CLAUDE.md همچنان اعمال شد |
| نشست قدیمی، ازسرگرفتهشده | 25k توکن | 10، در هر دو اجرا |
/compact | 2.4k تا 2.8k | 10 در 5 اجرا از 7، و 4 در 2 اجرای دیگر |
/compact با تمرکز روی جزئیات | 2.6k تا 3.0k | 10 در هر 7 اجرا از 7 |
آزمایش چه نشان داد
- سریع و کوچک بود. در این گفتگوی 25k توکنی، compact بین 13 تا 20 ثانیه طول کشید و گفتگو را حدود 90 درصد کوچک کرد.
- compact ساده معمولاً کار میکند و گاهی چیزی را که چسباندهاید میاندازد. در دو شکست، چهار تصمیمی که تایپ کرده بودیم ماند و هر شش جزئیات سند از دست رفت.
- تمرکزی که جزئیات را نام ببرد از آنها محافظت میکند. تمرکز ما انواع جزئیاتی را که بعداً میپرسیدیم فهرست کرده بود، و هر ده واقعیت در هفت اجرا از هفت ماند. جزئیاتی را که فراموش کردهاید نام ببرید نجات نمیدهد.
- بخش شلخته. هر دو شکست از دستهی اول ما بودند، جایی که auto memory روشن بود و هر دو خلاصه از سیستم حافظه نام برده بودند. با auto memory خاموش، چهار compact ساده از چهار تا همهچیز را نگه داشتند. نمیتوانیم بگوییم علت همین بود، و این آزمایش کوچکی است: یک مدل، سندهای ساختگی، هفت اجرا برای هر حالت.
/compact ساده را احتمالاً خوب و ممکن است lossy بدانید. وقتی جزئیاتی مهم است، آن را در تمرکز نام ببرید یا در CLAUDE.md بگذارید.
auto-compact کی اجرا میشود
Claude Code وقتی پنجره پر میشود خودش فشرده میکند، با همان نوع خلاصهی /compact. به صورت پیشفرض روشن است، پس پنجرهی پر نشست شما را تمام نمیکند. روی مدلهای 1M از حدود 967K توکن شروع میشود و روی پنجرهی 200K در خود حد.
دو اتفاق دیگر هم خودبهخود میافتد:
- فشردهسازی در حالت بیکاری. بعد از حدود یک ساعت دوری، گفتگویی که از 200,000 توکن گذشته و کش یکساعته دارد، پیش از انقضای کش فشرده میشود، پس پیام بعدی شما یک خلاصه میفرستد. با تنظیم
idleCompactionروی false خاموشش کنید. - توقف thrashing. اگر یک فایل یا خروجی ابزار غولپیکر بعد از هر خلاصه دوباره پنجره را پر کند، Claude Code بعد از چند تلاش دست میکشد و
Autocompact is thrashingرا نشان میدهد. فایل را تکهتکه بخوانید،/compactرا با تمرکزی که خروجی را حذف کند اجرا کنید، آن را به یک subagent (یک کمکی با پنجرهی خودش) بسپارید، یا/clearبزنید.
چطور auto-compact را تغییر دهیم یا خاموش کنیم
سوییچهای اصلی که مستندات فهرست میکنند، و اینکه کدام برنده است:
/autocompact 500k(داخل نشست، Claude Code 2.1.221 یا بالاتر): یک پنجره برای مدل فعلی ذخیره میکند و همین حالا اعمالش میکند./autocompact autoآن را بازنشانی میکند.--autocompact 500k(فلگ اجرا): پنجره را فقط برای همان اجرا عوض میکند.autoCompactWindow(در settings.json): یک پنجره برای همهی مدلها، از 100000 تا 1000000.CLAUDE_CODE_AUTO_COMPACT_WINDOW(متغیر محیطی): از سه مورد بالا قویتر است. برای اسکریپتها و اجراهای ابری ساخته شده.autoCompactEnabled(در settings.json یا/config):falseیعنی auto-compact خاموش. پیشفرضtrueاست.DISABLE_AUTO_COMPACT=1(متغیر محیطی): برای یک نشست خاموشش میکند و از تنظیم قویتر است.DISABLE_COMPACT=1(متغیر محیطی): همهی فشردهسازیها را خاموش میکند،/compactهم شامل آن است.CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=50(متغیر محیطی): در 50 درصد پنجره فشرده میکند. میتواند آستانه را پایین بیاورد اما بالا نبرد، و فقط برای نشستهایی اعمال میشود که پیش از حد مدل فشرده میکنند.
یک پنجره را میتوان به صورت 200000، 200k یا 1M نوشت. برای خاموش کردن auto-compact این را در ~/.claude/settings.json بگذارید:
{ "autoCompactEnabled": false }
با خاموش بودن آن، /compact همچنان کار میکند، و پنجرهی پر با Context limit reached · /compact or /clear to continue تمام میشود، همراه با یادداشتی که میگوید auto-compact خاموش است.
بیشتر این نامها را روی Claude Code 2.1.319 با خواندن /context بررسی کردیم. فلگ، CLAUDE_CODE_AUTO_COMPACT_WINDOW، autoCompactWindow و CLAUDE_CODE_DISABLE_1M_CONTEXT=1 هرکدام پنجرهی نشاندادهشده را تغییر دادند، و خاموش کردن auto-compact بافر 33k Autocompact را با بافر 3k Compact عوض کرد. دستور /autocompact و CLAUDE_AUTOCOMPACT_PCT_OVERRIDE فقط از مستندات آمدهاند: دستور را اجرا نکردیم، و متغیر چیزی را که /context نشان میدهد تغییر نداد.
پنجرهی کانتکست چقدر بزرگ است؟
مدلهای فعلی Claude پنجرهی 1M توکنی دارند. هر توکن تکهای از متن است کمی بیشتر از نصف یک کلمه روی tokenizer فعلی، یعنی تقریباً 555,000 کلمه. در Claude Code اینکه کدام پنجره را بگیرید به مدل بستگی دارد:
| مدل | پنجره در Claude Code | شروع auto-compact |
|---|---|---|
| Opus 4.7 و بعدتر، از جمله Opus 5.5 | 1M توکن | حدود 967K |
| Sonnet 5 و بعدتر، از جمله Sonnet 5.5 | 1M توکن | حدود 967K |
| Haiku 5.5، Fable 5 و Fable 5.1 | 1M توکن | حدود 967K |
| Opus 4.6 و Sonnet 4.6 | 200K، یا 1M با نسخهی [1m] روی طرحهایی که اجازه میدهند | در خود حد |
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 را بگذارید تا همهی مدلها روی 200K بمانند.
با /context ببینید چه چیزی پنجره را پر میکند
/context را اجرا کنید تا ببینید چه چیزی پنجره را مصرف میکند: یک جدول رنگی با هشدار برای ابزارهای سنگین، پف حافظه و ظرفیت. این یک نشست تازه روی Opus 5.5 است، همانطور که claude -p "/context" روی Claude Code 2.1.319 چاپ کرد:
| دسته | توکن | سهم از 1M |
|---|---|---|
| System prompt | 1.8k | 0.2% |
| System tools | 6.6k | 0.7% |
| Skills | 2.3k | 0.2% |
| Messages | 10 | 0.0% |
| Free space | 956.3k | 95.6% |
| Autocompact buffer | 33k | 3.3% |
یک نشست تازه از همین ابتدا حدود 10.7k توکن دارد که تقریباً همهاش prompt و ابزارها و skills خود Claude Code است. /context روی هر پنجرهای که خواندیم یک بافر 33k Autocompact کنار میگذارد، و روی پنجرهی 1M، یک میلیون منهای 33k همان 967K است که مستندات میگویند auto-compact از آنجا شروع میشود. با خاموش بودن auto-compact، آن سطر به یک بافر 3k Compact کوچک میشود.
تعریف ابزارهای MCP به صورت پیشفرض به تعویق میافتند و فقط وقتی Claude از ابزاری استفاده کند بارگذاری میشوند، پس فهرست بلند سرورها در آغاز هزینهی کمی دارد. در دو اجرا روی ماشین خودمان، /context به ترتیب 259.6k و 544.1k توکن ابزار MCP را به عنوان deferred فهرست کرد، در حالی که MCP در آغاز زیر 5k حساب میشد: نام ابزارها و دستورالعملهای سرور.
نشست کند همیشه پنجرهی پر نیست: یک سطح effort بالا بیشتر فکر میکند. /usage هزینه و مصرف طرح را نشان میدهد، و /export پیش از clear کردن گفتگو را به متن ساده ذخیره میکند.
کدام دستور برای کدام لحظه
| موقعیت | اجرا کنید | چرا |
|---|---|---|
| کاری را تمام کردید و کار نامرتبطی شروع میکنید | /clear | گفتگوی قدیمی جای چیزی را که بعداً لازم دارید میگیرد و در هر پیام توکن خرج میکند |
| دو بار Claude را اصلاح کردید و هنوز اشتباه میکند | /clear، بعد یک prompt بهتر | اصلاح سوم روی دو تلاش ناموفق انبار میشود |
| یک کار طولانی هنوز به تاریخچهاش نیاز دارد | /compact با تمرکز | خلاصه چیزی را که نام ببرید نگه میدارد |
| پیچ اشتباهی پیچیدید | /rewind | گفتگو، کد یا هر دو را به یک prompt قبلی برمیگرداند |
| یک مرحلهی طولانی دیباگ گفتگو را غرق کرده | /rewind، بعد Summarize from here | همهچیز بعد از پیامی که انتخاب میکنید را فشرده میکند و دستورالعملهای اولیهی شما را نگه میدارد |
| گفتگوی قدیمی را برمیخواهید | /resume | هر گفتگوی ذخیرهشده را برمیگرداند، از جمله همان که همین الان clear کردید |
| هر نشست یک قانون را دوباره تایپ میکنید | CLAUDE.md پروژهتان، ویرایششده با /memory | هر دو دستور آن را دستنخورده میگذارند |
| یک خواندن بزرگ گفتگو را سیلزده میکند | یک subagent | در پنجرهی خودش میخواند و فقط خلاصه برمیگردد |
پیشفرض را بین کارها /clear بگذارید. وقتی تداوم داخل یک کار نکتهی اصلی است به /compact برسید و به آن تمرکز بدهید. اگر اول مبانی را میخواهید، اینجا است پنجرهی کانتکست واقعاً چیست.
سؤالات متداول
/clear در Claude Code چه میکند؟
یک گفتگوی جدید با پنجرهی کانتکست خالی شروع میکند. گفتگوی قدیمی ذخیره میشود، پس /resume آن را برمیگرداند، و CLAUDE.md و auto memory دوباره بارگذاری میشوند. /reset و /new همین کار را میکنند.
/compact در Claude Code به چه درد میخورد؟
با جایگزین کردن گفتگوی تا اینجا با یک خلاصه کانتکست آزاد میکند، پس در همان نشست به کار ادامه میدهید. دستورالعمل اضافه کنید، مثل /compact keep the API changes، تا هدایت کنید خلاصه چه چیزی را حفظ کند.
از /clear استفاده کنم یا /compact؟
وقتی به کار نامرتبطی میروید یا یک اصلاح دو بار شکست خورده، از /clear استفاده کنید. وقتی یک کار طولانی هنوز به تاریخچهاش نیاز دارد، از /compact با تمرکز استفاده کنید.
آیا میشود /clear را در Claude Code برگرداند؟
بله. /resume را اجرا کنید و گفتگوی قدیمی را انتخاب کنید، که به صورت پیشفرض 30 روز ذخیره میماند. در همان پنجرهی Claude Code، منوی /rewind هم نشست قبلی را بالای فهرست نشان میدهد.
چطور auto-compact را در Claude Code خاموش کنم (autoCompactEnabled)؟
autoCompactEnabled را در settings.json روی false بگذارید، Auto-compact را در /config خاموش کنید، یا DISABLE_AUTO_COMPACT=1 را برای یک نشست تنظیم کنید. متغیر محیطی از تنظیم قویتر است، و /compact در هر دو حالت همچنان کار میکند.
چطور زمان auto-compact در Claude Code را عوض کنم؟
/autocompact 500k را اجرا کنید تا پنجره را برای مدل فعلی تنظیم کنید، یا از --autocompact، autoCompactWindow یا CLAUDE_CODE_AUTO_COMPACT_WINDOW استفاده کنید. هر مقداری از 100K تا 1M توکن کار میکند، تا حد پنجرهی خود مدل، و /autocompact auto آن را بازنشانی میکند.
پنجرهی کانتکست در Claude Code چقدر بزرگ است؟
1M توکن روی Opus 4.7 و بعدتر، Sonnet 5 و بعدتر، Haiku 5.5 و Fable 5 و بعدتر. Opus 4.6 و Sonnet 4.6 با 200K اجرا میشوند مگر نسخهی [1m] را انتخاب کنید.
«Context limit reached» در Claude Code یعنی چه؟
گفتگو بهعلاوهی فایلهای پیوست دیگر در پنجرهی مدل جا نمیشود. برای یک خلاصه /compact را اجرا کنید یا برای شروع تازه /clear. اگر آن خط میگوید auto-compact خاموش است، /config دوباره روشنش میکند.
منابع
- مستندات Claude Code، Commands: همهی دستورها و نامهای مستعار بالا.
- مستندات Claude Code، Explore the context window: چه چیزی از فشردهسازی جان به در میبرد، وقتی کانتکست پر میشود چه اجرا میشود.
- مستندات Claude Code، Model configuration: اندازهی پنجرهها، پنجرهی auto-compact، آستانههای پیشفرض.
- مستندات Claude Code، Settings و Environment variables:
autoCompactEnabled،autoCompactWindow،idleCompactionو متغیرهای بالا. - مستندات Claude Code، Checkpointing و Sessions: منوی rewind، اینکه
/clearچطور نشست را نامگذاری و ذخیره میکند. - مستندات Claude Code، Best practices، Reduce token usage و Prompt caching: کی clear کنیم، compact چقدر هزینه دارد، Compact instructions.
- مستندات Claude Code، Error reference و Troubleshooting: خط
Context limit reachedو توقف thrashing. - مستندات Claude API، Context windows و Models overview: اندازهی پنجره به تفکیک مدل، context rot.
- اجراهای خودمان: Claude Code 2.1.319، headless با
claude -p، Sonnet 5.5 برای آزمایش فشردهسازی و Opus 5.5 برای خواندنهای/context، اجراشده در 6 نوامبر 2026. چهارده اجرای فشردهسازی، چهار کنترل، و/contextخواندهشده زیر هر تنظیمِ نامبردهشده در بالا.
Brainy helps designers put AI to work without losing the craft. See what we are building for creators.
Get Started




