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

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

متوسط

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

الطبقات (الأعلى أسبقية أولًا)​

عندما يُضبط المفتاح نفسه في أكثر من مكان، يستخدم Claude Code القيمة من أعلى مستوى يضبطه:

  1. مُدار / مؤسسي — managed-settings.json أو سياسة MDM أو الإعدادات المُدارة من الخادم عبر وحدة تحكم claude.ai. لا شيء تضبطه يتجاوزها (باستثناء حالات قليلة حساسة أمنيًا).
  2. سطر الأوامر — claude --settings '<json-or-path>'، لجلسة واحدة فقط. يأتي فوق كل ملف عدا المُدار، ولا يكتب في أي ملف.
  3. المشروع (شخصي) — .claude/settings.local.json، مستثنى من git. تجاوزاتك لهذا المستودع.
  4. المشروع (مشترك) — .claude/settings.json، مُودع في المستودع. لكل الفريق.
  5. المستخدم — ~/.claude/settings.json. إعداداتك الافتراضية في كل المشاريع.
متغيرات البيئة ليست طبقة

هي خارج هذا المكدس وتُحسم لكل مفتاح على حدة. على سبيل المثال، ينطبق ANTHROPIC_MODEL فوق مفتاح model من أي ملف، بينما ينطبق ANTHROPIC_DEFAULT_MODEL فقط عندما لا يضبط أي ملف model.

أودِع الملف المشترك، وتجاهل الملف المحلي

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

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

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

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

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

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

التالي​