AI for Designers12 min read

Claude Code: تفاوت /clear و /compact، هر کدام چه می‌کنند و کی باید از کدام استفاده کرد

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

By Boone
XLinkedIn
Claude Code /clear vs /compact: What Each Does and When to Use It

پنجره‌ی کانتکست یعنی هر چیزی که 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 باشد، و از هر کدام خواستیم هر ده واقعیت را از حافظه بگوید.

25k

قبل، توکن‌های گفتگو

0

بعد از /clear، نشست جدید

2.5k

بعد از /compact، یک خلاصه

اندازه‌ی گفتگو در نشست آزمایشی، خوانده‌شده از /context. عدد /compact میانه‌ی هفت اجراست که بین 2.4k تا 2.8k بود.
چه اجرا کردیماندازه‌ی گفتگو بعد از آنواقعیت‌هایی که Claude می‌دانست، از 10
هیچ25k توکن10، در هر دو اجرا
نشست جدید، مثل بعد از /clear00، و قانون CLAUDE.md همچنان اعمال شد
نشست قدیمی، ازسرگرفته‌شده25k توکن10، در هر دو اجرا
/compact2.4k تا 2.8k10 در 5 اجرا از 7، و 4 در 2 اجرای دیگر
/compact با تمرکز روی جزئیات2.6k تا 3.0k10 در هر 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 بگذارید:

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.51M توکنحدود 967K
Sonnet 5 و بعدتر، از جمله Sonnet 5.51M توکنحدود 967K
Haiku 5.5، Fable 5 و Fable 5.11M توکنحدود 967K
Opus 4.6 و Sonnet 4.6200K، یا 1M با نسخه‌ی [1m] روی طرح‌هایی که اجازه می‌دهنددر خود حد

CLAUDE_CODE_DISABLE_1M_CONTEXT=1 را بگذارید تا همه‌ی مدل‌ها روی 200K بمانند.

با /context ببینید چه چیزی پنجره را پر می‌کند

/context را اجرا کنید تا ببینید چه چیزی پنجره را مصرف می‌کند: یک جدول رنگی با هشدار برای ابزارهای سنگین، پف حافظه و ظرفیت. این یک نشست تازه روی Opus 5.5 است، همان‌طور که claude -p "/context" روی Claude Code 2.1.319 چاپ کرد:

دستهتوکنسهم از 1M
System prompt1.8k0.2%
System tools6.6k0.7%
Skills2.3k0.2%
Messages100.0%
Free space956.3k95.6%
Autocompact buffer33k3.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

More from Brainy Papers

Keep reading