نقاط الالتقاط في Claude Code: كيف تُرجع الكود والمحادثة إلى الخلف
كل مطالبة في Claude Code نقطة التقاط يمكنك استعادتها. تعلّم /rewind والنقر المزدوج على Esc، وخيارات الاستعادة الثلاثة، وما تلتقطه نقاط الالتقاط (وما تعجز عنه)، وحدود الاحتفاظ، وكيف تكمل git — موثّق من الوثائق الرسمية.
TL;DR
- نقاط الالتقاط تلقائية: كل مطالبة تبدأ دورة تلتقط كودك أولًا، فلا شيء يحتاج إعدادًا — كل ما عليك أن تعرف كيف ترجع إلى الخلف.
- شغّل /rewind (أو اضغط Esc مرتين والمطالبة فارغة) تحصل على قائمة نقاط استعادة، كل واحدة تعرض: استعادة الكود والمحادثة معًا، أو المحادثة فقط، أو الكود فقط.
- الإرجاع استعادة على مستوى الجلسة لا إدارة إصدارات: الآثار الجانبية لأوامر Bash (rm وmv وcp)، ومعظم تعديلات الوكلاء الفرعيين، وتعديلاتك اليدوية أنت، لا تُلتقط. واصل الإيداع في git.
- يحتفظ Claude Code بأحدث 100 نقطة التقاط في الجلسة نحو 30 يومًا (اضبطه بـ cleanupPeriodDays)، ونقاط الالتقاط تنجو من /resume فيمكنك إرجاع جلسة الأمس اليوم.
12 Claude Code Features Every Engineer Should Know: Subagents, CLAUDE.md, Checkpoints, MCP, and more
القناة: ByteByteAI7:30
Claude Code Checkpoints Are Here (First Look)
القناة: Build at Scale8:16
Checkpointing — official documentation
الوثائق الرسمية: code.claude.com/docs
كل خيار استعادة وحد واحتفاظ ورقم احتفاظ في هذه الصفحة موثّق من وثائق نقاط الالتقاط الرسمية؛ والفيديوهات أعلاه هي المصدر البصري والمعلوماتي.
تُنسب لقطات الشاشة إلى صانعيها بروابط مباشرة إلى الطوابع الزمنية الدقيقة. لا تُستخدم لقطات للوجوه.
أرجِع عبر نقاط الالتقاط في Claude Code خطوة بخطوة
الجزء 1 — ما يُلتقط
- 1
اعرف ما هي نقطة الالتقاط
نقطة الالتقاط لقطة تلقائية لحالة كودك تُلتقط قبل كل مطالبة تبدأ دورة جديدة. وجودها كي يبقى الـ refactor السيئ أو التعديل المتحمي أو الاتجاه الخاطئ على بعد أمر واحد من التراجع — بلا stashing ولا إيداع ولا طقوس.

وعد نقاط الالتقاط: لقطة قبل كل تعديل، وإرجاع الكود والمحادثة كلما انحرفت تجربة عن مسارها.شاهد عند 2:15 - 2
كل مطالبة تبدأ دورة تنشئ واحدة
لا تنشئ نقاط الالتقاط يدويًا — كل مطالبة تشغّل Claude تلتقط الملفات التي سيمسها. والجلسة الطويلة تبني سلسلة من نقاط الاستعادة، واحدة لكل مطالبة، كحالات حفظ تلقائية لمستودعك.

حلقة التعديل: يعدّل Claude، وتهبط لقطة في سلسلة نقاط الالتقاط، والمطالبة التالية تبدأ دورة جديدة.شاهد عند 2:33 - 3
افتح قائمة الإرجاع بـ /rewind
اكتب /rewind عند المطالبة لتسرد نقاط الالتقاط في الجلسة الحالية. طريق لوحة المفاتيح أسرع: اضغط Esc مرتين وصندوق الإدخال فارغ. (إن كان في الإدخال نص فالنقر المزدوج يمحوه فقط — اضغط السهم أعلى لاسترجاع ما كتبته.)

/rewind مكتوبة عند مطالبة Claude Code — تفتح قائمة نقاط الالتقاط داخل الجلسة نفسها.شاهد عند 2:40 - 4
اختر نقطة الاستعادة
تسرد القائمة كل نقطة التقاط مع المطالبة التي أنشأتها — «أعِد الكود و/أو المحادثة إلى النقطة السابقة على…». تنقّل إلى اللحظة التي سارت فيها الأمور خطأ، واضغط Enter، واختر ما تريد استعادته.

قائمة الاستعادة: اختر المطالبة السابقة على الخطأ — المدخلات المميزة بالأحمر أسئلة سابقة في هذه الجلسة.شاهد عند 2:45
الجزء 2 — قائمة الإرجاع
- 5
استعد الكود والمحادثة معًا
الإرجاع الكامل: تعود الملفات إلى حالة اللقطة وتتفرع المحادثة راجعة إلى تلك النقطة. استخدمها حين كان الاتجاه كله خاطئًا — يعود الكود وذاكرة Claude للمهمة معًا إلى نقطة الصفر.
- 6
استعد الكود فقط — وأبقِ المحادثة
استعادة الكود وحده تعيد الملفات بينما تبقى المحادثة حيث هي. مثالية لحالة «النهج صائب والنتيجة خاطئة»: يتذكر Claude كل ما ناقشتهما، لكن التعديلات المعطوبة تزول.
- 7
استعد المحادثة فقط — وفرّع المحادثة
الخيار الثالث يُرجع المحادثة إلى نقطة سابقة ويرفع يده عن ملفاتك — سلوك التفريع نفسه الذي كان للنقر المزدوج على Esc قبل نقاط الالتقاط. استخدمها حين يكون الكود سليمًا لكن النقاش انزلق إلى حفر أرنب.
- 8
لخّص من هنا بدل الإرجاع
تعرض القائمة أيضًا «Summarize from here» و«Summarize up to here» — /compact موجه يكثف مقطعًا من المحادثة في ملخص مع الإبقاء على تعليماتك الأولية. وللتفريع الحقيقي استخدم /branch أو claude --continue --fork-session.
الجزء 3 — الحدود وعادة git
- 9
اعرف ما لا يستطيع الإرجاع التراجع عنه
تتتبع نقاط الالتقاط تعديلات الملفات التي يجريها Claude لا كل شيء: التغييرات عبر Bash (rm وmv وcp)، ومعظم تعديلات الوكلاء الفرعيين، وتعديلاتك اليدوية، وتغييرات الجلسات الأخرى لا تُلتقط. والروابط الرمزية تُتجاهل — تقول الاستعادة «Restored the code, but skipped N files».
- 10
نقاط الالتقاط مقابل git: قسّما العمل
نقاط الالتقاط للاستعادة السريعة على مستوى الجلسة: أرجِع هذه المطالبة، وجرّب تلك الفكرة من جديد. وgit للتاريخ الدائم: أودِع الحالات العاملة، وافرّع، وادفع. الإيقاع الموصى به: ارجع بحرية أثناء الاستكشاف، وأودِع بوعي حين يستحق التغيير.
- 11
راقب نافذة الاحتفاظ
يحتفظ Claude Code بأحدث 100 نقطة التقاط لكل جلسة ويكنس اللقطات القديمة بعد نحو 30 يومًا — إعداد cleanupPeriodDays نفسه الذي يحكم تاريخ النصوص. مدّده في settings.json إن أردت أن يبلغ /rewind و/resume أبعد إلى الوراء.
نقاط الالتقاط مقابل git مقابل /branch مقابل النقر المزدوج على Esc مقابل /compact
يمنحك Claude Code خمس طرق للعودة — وكل واحدة تحل مشكلة مختلفة:
- 1نقاط الالتقاط (/rewind) — فورية وتلقائية وعلى مستوى الجلسة: أرجِع الكود أو المحادثة أو كليهما إلى أي حدود مطالبة. بلا إعداد، ولا دائمة، ولا مشتركة.
- 2git — التاريخ الحقيقي: إيداعات صريحة تجريها حين يستحق العمل البقاء. لا تحل نقاط الالتقاط محله أبدًا؛ بل تقبع قبله في سلسلة الأمان.
- 3/branch و--fork-session — ابدأ خطًا زمنيًا موازيًا من المحادثة الحالية دون لمس الملفات. حين تريد استكشاف بديل والإبقاء على الخطين.
- 4النقر المزدوج على Esc — طريق لوحة المفاتيح إلى قائمة الإرجاع نفسها حين تكون المطالبة فارغة؛ ومع نص في الصندوق يمحو الإدخال فقط (التاريخ يحفظه، واضغط السهم أعلى لاسترجاعه).
- 5/compact و«Summarize from here» — اقبض المحادثة بدل أن تتحرك فيها: استرجع السياق مع الإبقاء على القرارات، مقابل التنازل عن التفاصيل.
نموذج ذهني بسيط: الإرجاع للأخطاء، وgit للتقدم، والتفريع للبدائل، والتلخيص للمساحة.
الإرجاع لم يفعل ما توقعت؟ الإسعافات الأولى
أربع مفاجآت شائعة في نقاط الالتقاط وما تفعله حيال كل منها:
- 1«No files were restored». كُنسَت اللقطات — تجاوزت سقف 100 نقطة التقاط أو الاحتفاظ بنحو 30 يومًا. مدّد cleanupPeriodDays في settings.json لتُبقي ذيلًا أطول.
- 2«Restored the code, but skipped N files». الروابط الرمزية والصلبة تُتجاهل عمدًا. شغّل /debug وافحص ~/.claude/debug/<session-id>.txt للمسارات المتجاهَلة بالضبط، ثم أعدها يدويًا.
- 3الملفات المتغيرة عبر Bash لم تتغير. يعمل rm وmv وcp في الـ shell خارج نظام اللقطات — أرجِعها بـ git checkout أو استعد من النسخ الاحتياطية.
- 4المطالبة التي تريدها ليست في القائمة. الرسائل المصطفة في منتصف الدورة لا تنشئ نقاط التقاط — أرجِع إلى أقرب مطالبة تبدأ دورة، وتعديلات الوكلاء الفرعيين قد تحتاج git revert.
- 5لا يوجد أمر /rewind أصلًا. جاءت نقاط الالتقاط مع Claude Code 2.0 — شغّل claude update (أو claude doctor) لتتحقق من إصدارك، وانتبه أن الجلسات الأقدم قدمًا، السابقة على الميزة، لا تملك لقطات يُرجع إليها.
القاعدة الذهبية: إن كان التغيير مهمًا فأودِعه. نقاط الالتقاط هي الوسادة الهوائية وgit هو حزام الأمان — ضعهما كليهما.
