إنتقل إلى المحتوى الرئيسي

settings.json: نظام الإعداد

متوسط

settings.json هو المكان الذي يوجد فيه إعداد Claude Code — الأذونات، والخطافات، ومتغيرات البيئة، والنماذج الافتراضية، والمزيد. وفهم الطبقات هو المفتاح.

الطبقات (من الأكثر عمومية ← إلى الأكثر تحديدًا)​

تتجاوز الطبقات اللاحقة (الأكثر تحديدًا) السابقة:

  1. المؤسسة / المُدارة — سياسة يضبطها مدير المؤسسة. تتفوق على كل شيء.
  2. المستخدم — ~/.claude/settings.json. افتراضاتك عبر جميع المشاريع.
  3. المشروع (المشترك) — .claude/settings.json، مُودَع في المستودع. على مستوى الفريق.
  4. المشروع (الشخصي) — .claude/settings.local.json، متجاهَل من git. تجاوزاتك لهذا المستودع.

:::tip أودِع الملف المشترك، وتجاهل الملف المحلي ضع أعراف الفريق في .claude/settings.json (مُودَع). وضع التعديلات الشخصية والمسارات الخاصة بالجهاز في .claude/settings.local.json (متجاهَل من git). هذا يبقي الفريق متسقًا دون فرض تفضيلاتك على الآخرين. :::

ما الذي ستضبطه عادةً​

  • permissions — قواعد السماح/السؤال/الرفض. راجع الأذونات.
  • hooks — أوامر تعمل عند أحداث دورة الحياة. راجع الخطافات.
  • env — متغيرات البيئة للجلسة.
  • افتراضات النموذج / السلوك — مثل النموذج المفضّل.

التحرير بأمان​

  • أبقِه JSON صالحًا (فاصلة زائدة في النهاية ستُعطّله).
  • فضّل قواعد الأذونات الضيقة على الواسعة.
  • لا تضع أسرارًا أبدًا في ملف مُودَع — استخدم مراجع env أو مدير أسرار.

توجد ملفات بدء جاهزة للنسخ في وصفات Hooks وsettings.json.

التالي​