أداة الذاكرة في Claude API تتيح للتطبيق حفظ معلومات في ملفات وقراءتها في محادثات لاحقة، بدل إبقاء كل التفاصيل داخل نافذة السياق. هذا شرح للتحضير لعام 2027 وفق الواجهة الموثقة في 27 أكتوبر 2026، ولا يصف إعدادات تطبيق بعينه.
التخزين مسؤولية التطبيق
الأداة تعمل من جهة العميل: يطلب Claude عملية على ملف، وينفذ التطبيق الطلب على مخزن يتحكم فيه ثم يعيد النتيجة. وليست الخدمة مخزن ملفات تديره تلقائيًا بدل المطور. ويستمر استخدام المعلومات في محادثة لاحقة عندما يرسل التطبيق إعداد الأداة نفسه ويخدم المعالج مخزن الذاكرة نفسه.
المسار /memories بادئة يربطها المعالج بتخزين فعلي، مثل مجلد خاص بالمستخدم أو مفاتيح في قاعدة بيانات. لذلك يلزم تحديد نطاق البيانات وهوية صاحب المخزن في التطبيق؛ فاسم المسار وحده لا ينشئ عزلًا بين المستخدمين.
عمليات القراءة والتحرير
يتيح view عرض دليل أو ملف، ويدعم view_range لاختيار نطاق أسطر في النص. وتوجد عمليات create للإنشاء، وstr_replace للاستبدال، وinsert للإدراج بعد رقم سطر، وdelete للحذف، وrename للنقل أو تغيير الاسم. على المعالج تنفيذ العمليات وإرجاع نجاحها أو أخطائها، لا الاكتفاء بتلقي الطلب.
في السلوك المرجعي، يفشل الاستبدال إن لم يوجد النص أو تكرر أكثر من مرة، ويرجع تغيير الاسم خطأ إذا كانت الوجهة موجودة. ولعملية create تفصيل مهم: السلوك المرجعي يرفض الملف الموجود، بينما يمكن للتطبيق اختيار الكتابة فوقه. احسم هذا السلوك قبل الاعتماد على الأداة لحماية ملفات قائمة.
حماية المسارات والبيانات
تحقق من كل مسار في كل عملية، وحوّله إلى صيغة معيارية ثم تأكد أنه باق داخل نطاق الذاكرة. لا يكفي اختبار بداية النص؛ فقد تحمل المسارات انتقالًا إلى مجلد أعلى أو تسلسلات مرمزة. ويجب رفض حذف جذر الذاكرة أو إعادة تسميته.
أضف فحصًا يمنع تخزين البيانات الحساسة، وحدودًا لحجم الملفات وللنص المعاد عند القراءة، وسياسة لتنظيف الملفات القديمة. رفض النموذج المعتاد لبعض البيانات الحساسة ليس ضمانًا يغني عن تحقق التطبيق.
الذاكرة ليست ملخص السياق
الملفات تحفظ ما يلزم الرجوع إليه عبر الجلسات، بينما تلخيص السياق يصغر المحادثة النشطة. يمكن الجمع بينهما، لكن استمرار المعلومات يعتمد على المخزن الذي يديره التطبيق وعلى تحديثه. اختبر الإنشاء والقراءة والتعديل والأخطاء والعزل قبل الاعتماد على معلومات محفوظة في محادثة جديدة.
