SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor

كيفية استئناف جلسة Claude Code والعثور على سجلها

استأنف جلسة Claude Code باسمها أو من أداة الاختيار، وتعرّف على مكان حفظ النصوص العادية للجلسات على الجهاز الذي شغّلت عليه الوكيل.

كيفية استئناف جلسة Claude Code

لاستئناف جلسة Claude Code، شغّل claude --continue لفتح أحدث محادثة في الدليل الحالي، أو claude --resume لاختيار جلسة أقدم من قائمة. ومن داخل جلسة قيد التشغيل، ينقلك الأمر /resume إلى محادثة أخرى من دون إنهاء الجلسة. والصيغتان المختصرتان هما -c و-r.

claude --continue
claude --resume
claude --resume auth-refactor

إذا كنت تعرف اسم الجلسة أو معرّفها، فمرّره كوسيطة، وسينتقل Claude Code مباشرةً إليها من دون عرض أداة الاختيار.

يتوافق كل ما يلي مع الوثائق الرسمية للجلسات حتى November 2026. يُصدر Claude Code تحديثات باستمرار، كما تتغير أسماء الخيارات واختصارات لوحة المفاتيح بين الإصدارات. لذلك، اعتبر claude --help وتلك الصفحة المرجع المعتمد إذا لم يتطابق ما يرد هنا مع ما يعرضه الطرفية لديك.

ماهيّة الجلسة فعلياً

الجلسة هي محادثة محفوظة واحدة مرتبطة بدليل مشروع. وتحتفظ بسجل الرسائل الكامل، بما في ذلك استدعاءات الأدوات التي أجراها Claude والنتائج التي أعادتها هذه الاستدعاءات. يكتب Claude Code هذه البيانات على القرص باستمرار أثناء عملك، وليس مرة واحدة في النهاية، لذلك تستمر المحادثة بعد إغلاق الطرفية أو انقطاع اتصال SSH.

تستعيد عملية الاستئناف أكثر من النص. يعود سجل المحادثة كاملاً، إلى جانب النموذج الذي كانت الجلسة تستخدمه والوكيل الفرعي الذي بدأت به إذا استخدمت --agent. ويعود وضع الأذونات أيضاً عند الاستئناف من الصدفة باستخدام --continue أو معرّف جلسة، مع استثناء واحد لأسباب تتعلق بالسلامة: لا يُستعاد وضع تجاوز الأذونات أبداً، لذلك تُستأنف الجلسة التي انتهت بهذا الوضع في الوضع الذي تبدأ به جلسة جديدة. ويُستعاد وضع التخطيط أيضاً، بما في ذلك عند اختيار الجلسة من أداة الاختيار أو التبديل إليها باستخدام /resume، وهما مساران لا ينقلان الوضع المحفوظ عادةً. تدعم عمليات الاستئناف من الطرفية استعادة هذا الوضع منذ v2.1.290، كما تدعمه أداة الاختيار و/resume منذ v2.1.292؛ أما الإصدارات الأقدم فكانت تُسقط وضع التخطيط عند الاستئناف أيضاً. ومن الصدفة، يتجاوز --permission-mode أي وضع تتم استعادته.

لا تعود بعض العناصر لأنها كانت أعلاماً تُمرَّر عند التشغيل وليست حالة محفوظة. يجب تمرير الأدلة التي أُضيفت باستخدام --add-dir، والخيارات مثل --mcp-config و--settings و--plugin-dir، مرة أخرى عند الاستئناف. وتُعاد قراءة ملفات الإعداد مثل settings.json عند التشغيل، لذلك لا يلزم تكرار أي إعداد موجود فيها. وتندرج بيانات الاعتماد ضمن الفئة نفسها: يحدد Claude Code طريقة المصادقة عند التشغيل، اعتماداً على تسجيل دخولك وبيئتك، بدلاً من استعادتها مع المحادثة. لذلك ستواجه جلسة مستأنفة على VPS تسلّل فيه ANTHROPIC_API_KEY غير مقصود إلى الصدفة خطأ مفتاح API غير الصالح، حتى لو عملت بشكل صحيح في المرة السابقة.

لماذا يزداد أثر سجل الجلسات على VPS

إليك حقيقة تفاجئ كثيراً من المستخدمين. يُكتب النص الكامل للجلسة على الجهاز الذي شغّل عليه الوكيل. ولا يُحفظ في حسابك ولا تتم مزامنته مع خدمة سحابية. بل يكون ملفاً على قرص ذلك الجهاز.

لذلك، لا تظهر الجلسة التي تركتها داخل نافذة tmux على VPS في أداة اختيار الجلسات على حاسوبك المحمول، كما لا تظهر جلسة حاسوبك المحمول على VPS. لا تنتقل أي بيانات بينهما. إذا كنت تعمل بالطريقة الشائعة عند تشغيل Claude Code في tmux على VPS، فإن الخادم هو المكان الذي يتراكم فيه سجل محادثتك الفعلي، بينما تعرض أداة الاختيار التي تراها محلياً مجموعة مختلفة وأصغر بكثير.

وينطبق هذا الفصل نفسه على الواجهات المختلفة. يحتفظ تطبيق سطح المكتب وامتداد VS Code كلٌّ منهما بسجل جلساته الخاص، ولا يمثّل أيٌّ منهما سجل CLI، مع أن تطبيق سطح المكتب يستطيع أيضاً استئناف جلسة CLI. ويحتفظ Claude Code على الويب بسجله الخاص كذلك. أما Cowork فيختلف أكثر: تعمل جلساته في سحابة Anthropic افتراضياً، وتُحفظ في حساب Claude الخاص بك بدلاً من حفظها على أجهزة تملكها، ولا يُستخدم التنفيذ المحلي إلا مع عمليات النشر الحالية لتطبيق سطح المكتب. لذلك، إذا كنت تقارن بين Cowork وClaude Code، فإن المكان الذي ينتهي إليه النص الكامل للجلسة جزء من القرار.

داخل الجهاز نفسه، يكون نطاق البحث أوسع مما قد تتوقع. يبحث claude --resume <session-id> أولاً في دليل المشروع الحالي وفي git worktrees التابعة له، ثم يبحث في كل مشروع آخر على ذلك الجهاز. العبارة المهمة هنا هي «على ذلك الجهاز». لا يعثر Claude Code على أي شيء عند استخدام معرّف جلسة من مضيف آخر، ويخبرك بذلك عبر No conversation found with session ID: <session-id>.

أين يخزّن Claude Code سجل الجلسات

بشكل افتراضي، تُخزَّن النصوص المفرَّغة ضمن دليل إعداد Claude Code، في مسار من الشكل ~/.claude/projects/<project>/<session-id>.jsonl.

يمثل <project> مسار دليل العمل لديك، بعد استبدال كل محرف غير أبجدي أو رقمي بشرطة، ولذلك تُخزَّن جلسة بدأت في /home/deploy/apps/api ضمن دليل اسمه -home-deploy-apps-api. إذا تجاوز الاسم الناتج 200 محرف، يقتصر Claude Code على هذا الحد ويضيف تجزئة للمسار الكامل، بحيث يبقى اسم الدليل ضمن حدود نظام الملفات.

الملف بتنسيق JSONL: يحتوي كل سطر على كائن JSON واحد. ويمثل كل سطر رسالة، أو استخداماً لأداة أو نتيجته، أو سجلاً لطلب أرسله Claude Code إلى النموذج، أو إدخالاً للبيانات الوصفية. وهو نص قابل للقراءة، ولا مشكلة في قراءته.

لكن لا يُنصح بكتابة محلّل يعتمد عليه. تنسيق الإدخالات داخلي في Claude Code ويتغير بين الإصدارات، ولذلك قد يتعطل أي script يقرأ هذه الملفات مباشرة بعد أي تحديث. توصي وثائق Anthropic نفسها باستخدام /export أو واجهات script الموثقة بدلاً من ذلك، وهذا مناسب تحديداً لهذا السبب.

يغيّر إعدادان مكان التخزين ومدة الاحتفاظ. ينقل CLAUDE_CONFIG_DIR دليل الإعداد بالكامل، وهي الطريقة المناسبة لوضع النصوص المفرغة على وحدة تخزين منفصلة أو مشفّرة. ويتحكم cleanupPeriodDays في settings.json في مدة الاحتفاظ بها، وتكون المدة الافتراضية 30 يوماً، والحد الأدنى 1.

ما الذي يوجد فعلياً داخل ملفات النصوص المفرغة

يُسجَّل كل ناتج لأداة، ما يعني أن النص المفرغ يحتوي على محتويات الملفات التي قرأها Claude، وعلى ناتج الأوامر التي شغّلها Claude. توضّح صفحة استخدام البيانات لدى Anthropic ذلك صراحةً: يخزّن Claude Code نصوص الجلسات المفرغة محلياً بنص عادي ضمن ~/.claude/projects/. وبما أن النص المفرغ يسجّل أيضاً ما يرسله Claude Code إلى النموذج، فقد يحتوي على مطالبة النظام، وتعريفات الأدوات، ومعلمات الطلب، وملفات CLAUDE.md التي جرى تحميلها.

فكّر في معنى ذلك على خادم. إذا قرأ Claude ملف .env لمعرفة سبب عدم بدء خدمة، فستكون محتويات ذلك الملف موجودة الآن في ملف JSONL ضمن دليلك المنزلي. وإذا طبع أحد الأوامر سلسلة اتصال، فستكون هذه السلسلة موجودة فيه أيضاً. لم يحدث أي تسريب. لقد سجّل النص المفرغ ما حدث، وهذا هو الغرض منه أساساً، ولذلك تحديداً يجب أن تضعه ضمن نموذج التهديد لديك.

  • النسخ الاحتياطية: ينسخ النسخ الاحتياطي العادي لـ /home أو /root النصوص المفرغة إلى المكان الذي تُخزَّن فيه النسخ الاحتياطية. أضف استثناءً، أو تقبّل أن نسخاً من مطالباتك ومحتويات ملفاتك أصبحت موجودة الآن في مخزن النسخ الاحتياطية لديك.
  • اللقطات والصور: تحتوي لقطة VPS تُنشأ لأي سبب على الدليل بأكمله. وينطبق الأمر نفسه على صورة تستنسخها لإنشاء خادم ثانٍ منها.
  • الحسابات الأخرى على الخادم: افحص الأذونات بنفسك باستخدام ls -ld ~/.claude ~/.claude/projects بدلاً من افتراض أنها مقيّدة بما يكفي.
  • عمليات الرفع المتعمدة: يرسل الأمر /feedback سجل المحادثة إلى Anthropic عن قصد، كما يرسل /bug و/share التقارير عبر المسار نفسه. وقد يتضمن مربع حوار الملاحظات أيضاً جلسات أخرى من المشروع نفسه خلال آخر 24 ساعة أو 7 أيام، وليس الجلسة الحالية فقط. هذه إجراءات تختار تنفيذها، لذلك اعرف ما الذي توافق عليه قبل التأكيد.

إذا كنت تفضّل عدم إنشاء أي نص مفرغ، فإن CLAUDE_CODE_SKIP_PROMPT_HISTORY يمنع كتابة النصوص المفرغة، بينما يمنع --no-session-persistence كتابتها في تشغيل واحد غير تفاعلي للأمر claude -p. افهم المفاضلة بوضوح قبل ضبط أي منهما. تعتمد عملية الاستئناف على قراءة النصوص المفرغة، لذلك يعني عدم وجود نص مفرغ عدم إمكانية الاستئناف.

كيف تعثر على محادثة قديمة

افتح أداة الاختيار باستخدام claude --resume، أو باستخدام /resume من داخل جلسة قيد التشغيل. يعرض كل صف اسم الجلسة إذا عيّنت اسماً لها، أو عنواناً مُنشأً تلقائياً إذا لم تفعل، بالإضافة إلى المدة منذ آخر نشاط، وفرع git، وحجم الملف.

تدعم أداة الاختيار البحث. اضغط /، أو ابدأ الكتابة مباشرةً، لتصفية القائمة. الاختصارات المفيدة هي التي توسّع نطاقها: يعرض Ctrl+A الجلسات من كل مشروع على هذا الجهاز، ويعرض Ctrl+W كل worktree للمستودع الحالي، بينما يقتصر Ctrl+B على فرع git الحالي. اضغط Space لمعاينة محتوى الجلسة قبل اختيارها، واضغط Ctrl+R لإعادة تسمية الجلسة المحددة.

تسمية الجلسات تجعل كل ذلك أسهل بكثير. ابدأ جلسة باستخدام claude -n auth-refactor، أو شغّل /rename auth-refactor أثناء الجلسة، عندما تدرك أن المحادثة تحولت إلى عمل فعلي. بعد ذلك، يمكنك استئناف الجلسة المسماة باستخدام اسمها مباشرةً من shell.

تحصل الجلسة غير المسماة أيضاً على عنوان مُنشأ تلقائياً. يُكتب هذا العنوان عبر طلب في الخلفية إلى نموذج صغير وسريع يلخّص مطالبتك الأولى. يساعدك العنوان على التعرّف إلى الصف في أداة الاختيار، ويعمل أيضاً كمعرّف للاستئناف: يحل claude --resume هذا العنوان بالطريقة نفسها التي يحل بها اسماً عيّنته. لكن اسم العرض الافتراضي، مثل my-app-3f، الذي تحمله الجلسة التفاعلية غير المسماة في قوائم الجلسات قيد التشغيل، لا يعمل. مرّر ذلك الاسم إلى claude --resume، ولن يعثر Claude Code على الجلسة.

البحث في السجلات النصية للعثور على الجلسة الصحيحة

أحياناً تتذكر عبارة ولا تتذكر أي شيء آخر. السجلات النصية عبارة عن نص، لذلك يمكنك البحث فيها.

grep -rl "nftables" ~/.claude/projects/

يطبع هذا الأمر مسارات السجلات النصية المطابقة. يمثّل اسم الملف من دون الامتداد .jsonl معرّف الجلسة، ويقبل claude --resume <session-id> هذا المعرّف. ويقبل claude --resume أيضاً المسار المطلق للسجل النصي مباشرةً. استخدم grep لتحديد الجلسة التي تريدها، ثم استأنفها أو صدّرها لقراءة محتواها فعلياً.

هناك تنبيهان مهمان. المحتوى مُهَرَّب بصيغة JSON، لذلك قد لا تطابق العبارة حرفياً إذا احتوت على علامات اقتباس أو انقسمت بين سطرين. كما أن العثور على تطابق داخل نتيجة أداة يعني أن Claude رأى ذلك النص، ولا يعني أن أحداً كتبه.

قراءة محادثة وتصديرها

يعرض /export المحادثة الحالية كنص عادي، مع كتابة الرسائل ومخرجات الأدوات بصيغة مقروءة بدلاً من عرضها كـJSON. عند استخدامه دون وسيطة، يفتح قائمة تتيح اختيار الحافظة أو ملف. وعند تحديد اسم ملف، يكتب /export handover.txt مباشرةً إلى ذلك المسار. هذه هي الطريقة المناسبة لنقل محادثة من خادم إلى حاسوبك المحمول أو لإرفاقها بتذكرة.

لأي عملية مؤتمتة، استخدم الواجهات المصممة لتكون مستقرة. تتلقى Hooks وأوامر status line حقلاً باسم transcript_path كإدخال، لذلك يمكن لـSessionEnd أن يؤرشف نص محادثة عند انتهاء الجلسة. ويمكنك أيضاً طرح سؤال على جلسة محفوظة دون فتحها:

claude -p --resume <session-id> --output-format json "summarize what we changed" | jq -r '.result'

يرسل ذلك مطالبة متابعة إلى المحادثة القديمة ويعيد JSON منظماً. وهذا أساس أفضل بكثير من تحليل تنسيق JSONL قد يتغير في الإصدار التالي.

عندما يكون البدء من جديد أفضل من الاستئناف

يعيد الاستئناف السجل الكامل، وهذا السجل هو ما تحمله كل طلباتك اللاحقة. إن متابعة محادثة استمرت أربع ساعات أمس مكلفة اليوم، وتوضح كيفية تراكم استخدام الرموز المميزة عبر جلسة طويلة مصدر هذه التكلفة فعلياً.

يتولى Claude Code أحياناً اختيار حل وسط. إذا تركت محادثة طويلة خاملة في جلسة طرفية تفاعلية، وكانت تستخدم ذاكرة التخزين المؤقت للمطالبات لمدة ساعة، وهي المدة التي يوفّرها اشتراك Claude للمحادثة الرئيسية افتراضياً ضمن حدود استخدام خطتك، فإن الضغط التلقائي أثناء الخمول يضغطها بعد نحو 54 دقيقة، أي قبل انتهاء ذاكرة التخزين المؤقت بقليل. يحدث ذلك عندما يصل سياق المحادثة إلى حد للرموز المميزة، وقيمته الافتراضية 200,000، مع تفعيل الضغط التلقائي وبقاء الجهاز قيد التشغيل في تلك اللحظة. قبل v2.1.314، كان Claude Code يحتاج أيضاً إلى جلب أعلام الميزات من Anthropic، لذلك لم يستفد منه المشتركون الذين عطّلوا القياس عن بُعد. ومنذ v2.1.314، يعمل لديهم أيضاً، وكذلك في لوحة الدردشة ضمن إضافة VS Code وعلامة Code في تطبيق سطح المكتب. لا يظهر أي مربع حوار لطلب التأكيد أولاً. عند عودتك، تعرض المحادثة سطراً يبدأ بـ Compacted while idle, before the prompt cache expired، ويرسل طلبك التالي ملخصاً بدلاً من السجل الكامل.

  • اتركه مفعّلاً لتصبح الطلبات اللاحقة أقل تكلفة، لكن ما يحذفه الملخص لن يعود متاحاً. يمكنك خفض الحد باستخدام CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS، مع رفع القيم الأقل من 100,000 إلى 100,000.
  • عطّله بتعيين idleCompaction إلى false في settings.json، أو من صف Idle compaction في /config على v2.1.302 أو الإصدارات الأحدث. عندئذٍ تبقى المحادثة كاملة، وتكون تكلفة كل طلب متناسبة مع حجمها. إذا انتهت صلاحية ذاكرة التخزين المؤقت قبل إرسال طلبك التالي، فسيعيد ذلك الطلب معالجة السجل الكامل مرة واحدة.

في خطتي Pro وMax، أضاف v2.1.304 فحصاً آخر، وتدرج الوثائق الحالية خطط Ultra أيضاً. عند استئناف محادثة طويلة بعد انقطاع طويل، أو باستخدام نموذج مختلف، إذا كان ذلك سيستهلك حصة ملحوظة من حد استخدامك لمدة 5 ساعات، يعرض مربع حوار Resume this conversation? هذه الحصة المقدّرة ويتيح لك الاستئناف رغم ذلك أو بدء محادثة جديدة. عندما يوضح خيار المحادثة الجديدة ذلك، يستطيع Claude البحث عن المحادثة السابقة إذا أشرت إليها.

القرار أبسط مما يبدو. استأنف عندما يعتمد الشيء التالي الذي ستكتبه على ما قيل سابقاً. وابدأ من جديد عندما لا يعتمد عليه. يسهل اكتشاف انجراف السياق عندما تبحث عنه: كأن يشير Claude إلى ملف حذفته قبل ساعة، أو يعيد مناقشة قرار حسمته في بداية الجلسة. هذا سياق قديم، وحمله إلى الأمام يستهلك الرموز المميزة ويقلل الدقة في الوقت نفسه.

إذا كان الجزء المفيد من محادثة قديمة قراراً أو حقيقة ستحتاج إليها مرة أخرى، فلا تعتمد على الاستئناف لحمله. دوّنه في مكان يمكن لكل جلسة الوصول إليه، فهذا هو الغرض من ملفات ذاكرة Claude Code.

يجدر بك معرفة /branch هنا أيضاً. فهو ينسخ المحادثة حتى النقطة الحالية وينقلك إلى النسخة، مع إبقاء النسخة الأصلية سليمة ومتاحة في أداة الاختيار. استخدمه لتجربة نهج ثانٍ من دون فقدان النهج الأول.

كيف يختلف الاستئناف عن ضغط السياق وعن الذاكرة

غالباً ما يحدث خلط بين هذه المفاهيم، مع أنها تعالج مشكلات مختلفة.

يتعلق الاستئناف بإعادة فتح محادثة بعد الخروج منها أو إعادة التشغيل أو الانتقال إلى مهمة أخرى. أما ضغط السياق فيتعلق بنافذة السياق داخل محادثة نشطة: يستبدل /compact السياق الذي يحتفظ به Claude بملخص، ولذلك ترسل الطلبات اللاحقة عدداً أقل من الرموز. إذا كانت مشكلتك هي امتلاء نافذة السياق، فاستخدم ضغط السياق، ويشرح إدارة نافذة سياق Claude Code ذلك بالتفصيل.

الذاكرة مختلفة أيضاً. تحتوي ملفات CLAUDE.md والذاكرة التلقائية على تعليمات وحقائق تُحمَّل في بداية كل جلسة، ولذلك فهي ليست محادثة تعود إليها. إنها المعلومات التي تدوّنها حتى لا تحتاج إلى العودة إلى محادثة واحدة.

إذا كنت تريد تشغيل محادثتين في الوقت نفسه وتنسيقهما، فهذه آلية منفصلة. يمكن لـجلسات Claude Code مراسلة بعضها بعضاً أثناء نشاط الجلستين، وهذه مشكلة مختلفة عن استعادة جلسة الأمس من القرص.

FAQ

أين يخزّن Claude Code سجل جلساتي؟

يخزّنه افتراضياً ضمن دليل الإعدادات لديك، في ~/.claude/projects/<project>/<session-id>.jsonl، حيث يمثّل <project> مسار دليل العمل بعد استبدال الأحرف غير الأبجدية الرقمية بشرطات. كل ملف بتنسيق JSONL: كائن JSON واحد في كل سطر لرسالة، أو لاستخدام أداة أو نتيجتها، أو لسجل طلب أُرسل إلى النموذج، أو لإدخال بيانات وصفية. ينقل CLAUDE_CONFIG_DIR دليل الإعدادات إلى موقع آخر، وتحدد cleanupPeriodDays في settings.json مدة الاحتفاظ بالنصوص، وتكون المدة الافتراضية 30 يوماً والحد الأدنى 1.

لماذا لا أرى جلسة VPS الخاصة بي في أداة الاختيار على حاسوبي المحمول؟

لأن النصوص تُكتب على قرص الجهاز الذي شُغّل عليه العامل، ولا تُزامَن بين الأجهزة. توجد المحادثة التي أجريتها داخل tmux على VPS في VPS فقط. استأنفها هناك عبر SSH، أو شغّل /export داخلها وانسخ الملف النصي إلى جهازك إذا أردت الاحتفاظ بسجل محلي.

هل يمكنني استئناف جلسة بدأتُها في دليل مختلف؟

نعم، إذا كان لديك معرّف الجلسة. يبحث claude --resume <session-id> أولاً في دليل المشروع الحالي وأشجار عمل git الخاصة به، ثم في كل مشروع آخر على الجهاز نفسه. داخل أداة الاختيار، يوسّع Ctrl+A القائمة لتشمل كل مشروع على الجهاز، ويوسّع Ctrl+W القائمة لتشمل كل شجرة عمل للمستودع الحالي. إذا لم يُعثر على تطابق، يعرض Claude Code الرسالة No conversation found with session ID: <session-id>.

هل ينبغي أن أستأنف جلسة قديمة أم أبدأ جلسة جديدة؟

استأنف الجلسة عندما تعتمد رسالتك التالية على ما قيل سابقاً في تلك المحادثة. ابدأ جلسة جديدة عندما لا تعتمد عليه، لأن الاستئناف يعيد تحميل السجل بأكمله، وتحمل كل جلسة لاحقة ذلك السجل. انتبه إلى انحراف السياق: إذا واصلت الجلسة الإشارة إلى ملفات حذفتها، فهي تحمل سياقاً قديماً، وهذا السياق يستهلك الرموز ويقلل الدقة في كل دور.

هل يمكنني منع Claude Code من كتابة النصوص على القرص؟

نعم. يمنع CLAUDE_CODE_SKIP_PROMPT_HISTORY كتابة النصوص، ويمنع --no-session-persistence كتابتها في تشغيل واحد غير تفاعلي لـ claude -p. افهم المقايضة أولاً، لأن الاستئناف يقرأ النصوص؛ لذلك يعني تعطيلها أن --continue و--resume لن يجدا شيئاً لتحميله. إذا كان مصدر القلق هو مكان وجود الملفات لا وجودها بحد ذاته، فاجعل CLAUDE_CONFIG_DIR يشير إلى وحدة تخزين مشفّرة، وخفّض cleanupPeriodDays بدلاً من ذلك.

هل كان هذا المقال مفيدًا؟