الإعدادات

يحمل settings.json إعداد إطار العمل Claude Code: توصيل الخطّافات، وأذونات الأدوات، ومتغيّرات البيئة، وإعدادات سطر الحالة.

يوجد المرجع المعتمد الكامل في settings-reference.md. تُلخِّص هذه الصفحة العقد وتُحيل إلى المرجع الأعمق.

الأقسامCopy Anchor Link

ثابت القالب الواحدCopy Anchor Link

يشحن محوّل Claude Code قالب settings.json واحدًا. تستخدم أوامر الخطّافات صيغة exec (command إضافةً إلى args) بدلًا من سلاسل أوامر خاصة بصدفة معيّنة، فيُراجَع السلوك عبر أنظمة التشغيل داخل ملف واحد. وتصل مدخلات الأذونات الجديدة وأحداث الخطّافات الجديدة إلى ذلك الملف دفعةً واحدة.

الدمج في ملف إعداداتك الخاصCopy Anchor Link

settings.json ملفك أنت أيضًا. يدمج التثبيت القالب فيه بدلًا من استبداله، ويُسجِّل في سجلّ التثبيت (~/.apothem/state/<harness>/ledger.jsonl) بالضبط المفاتيح ومدخلات القوائم التي أضافها:

• يُدمَج permissions.allow وpermissions.deny بوصفهما اتّحادًا: تبقى قواعدك أولًا وتُلحَق قواعد Apothem بعدها. وقاعدة الحظر التي كتبتها تبقى دائمًا، ويطبّق Claude Code قواعد الحظر قبل قواعد السماح.
• تبقى معالِجات الخطّافات الخاصة بك في مكانها. ولا يُعَدّ المعالِج تابعًا لـ Apothem إلا حين يُشغِّل برنامجًا نصيًا ثبّته Apothem تحت جذر إطار العمل، لذا فالمعالِج الذي يستدعي hooks/dispatch.py آخر هو معالِجك.
• لا تستبدل إعادة التثبيت إلا ما أضافه Apothem في المرة السابقة، لذا يُزال المُدخَل الذي يُسقِطه القالب ويُحتفَظ بالمُدخَل الذي أضفته.
• لا يُزيل إلغاء التثبيت إلا المدخلات التي يُسجِّلها السجلّ بوصفها تابعة لـ Apothem. وتبقى القاعدة التي تصادف أنها تساوي إحدى قواعد Apothem (مثل Read في قائمة allow الخاصة بك قبل التثبيت الأول). ولا يُحذَف الملف إلا حين يكون Apothem قد أنشأه ولم يتبقَّ فيه شيء من محتواك.

تنطبق القواعد نفسها على ملفات الإعدادات الأخرى التي يدمج Apothem فيها، مثل خرائط خوادم MCP في settings.json الخاص بـ Qwen Code وopencode.json الخاص بـ OpenCode.