सेटिंग्स
settings.json में Claude Code हार्नेस कॉन्फ़िगरेशन, जो टूल अनुमतियों, हुक वायरिंग, एनवायरनमेंट वेरिएबल और स्टेटस-लाइन टेम्पलेट को कवर करता है।
settings.json Claude Code हार्नेस कॉन्फ़िगरेशन वहन करता है: हुक वायरिंग,
टूल अनुमतियाँ, एनवायरनमेंट वेरिएबल, और स्टेटस-लाइन सेटिंग्स।
पूर्ण कैनोनिकल संदर्भ settings-reference.md पर है। यह पृष्ठ अनुबंध का सारांश देता है और विस्तृत संदर्भ की ओर संकेत करता है।
अनुभाग
| अनुभाग | उद्देश्य |
|---|---|
permissions | प्रति मैचर टूल श्वेतसूचियाँ और अवरोध-सूचियाँ |
hooks | इवेंट-कुंजीबद्ध हुक कमांड तालिका (कैनोनिकल वायरिंग) |
env | प्रति-सत्र एनवायरनमेंट वेरिएबल |
statusLine | स्टेटस-लाइन टेम्पलेट, जिसे होस्ट रेंडर करता है |
एकल-टेम्पलेट अपरिवर्तनीयता
Claude Code अडैप्टर एक settings.json टेम्पलेट शिप करता है। हुक कमांड
शेल-विशिष्ट कमांड स्ट्रिंग के बजाय exec रूप (command और args) का उपयोग करते
हैं, इसलिए क्रॉस-OS व्यवहार की समीक्षा एक ही फ़ाइल के भीतर होती है। नई अनुमति
प्रविष्टियाँ और हुक इवेंट उस फ़ाइल में परमाण्विक रूप से जुड़ते हैं।
आपकी अपनी सेटिंग्स फ़ाइल में मर्ज
settings.json आपकी फ़ाइल भी है। इंस्टॉल टेम्पलेट को उस फ़ाइल को बदलने के बजाय
उसमें मर्ज करता है, और इंस्टॉल लेजर
(~/.apothem/state/<harness>/ledger.jsonl) में ठीक-ठीक दर्ज करता है कि उसने कौन-सी
कुंजियाँ और सूची प्रविष्टियाँ जोड़ीं:
permissions.allowऔरpermissions.denyसमुच्चय-संघ के रूप में मर्ज होते हैं: आपके नियम पहले रहते हैं और Apothem के नियम अंत में जोड़े जाते हैं। आपका लिखा कोई निषेध नियम हमेशा बना रहता है, और Claude Code अनुमति नियमों से पहले निषेध नियम लागू करता है।- आपके अपने हुक हैंडलर अपनी जगह बने रहते हैं। कोई हैंडलर केवल तभी Apothem का माना
जाता है जब वह ऐसी स्क्रिप्ट चलाता है जिसे Apothem ने हार्नेस रूट के अंतर्गत इंस्टॉल
किया हो, इसलिए जो हैंडलर किसी अन्य
hooks/dispatch.pyको कॉल करता है, वह आपका है। - पुनः इंस्टॉल करने पर केवल वही बदला जाता है जो Apothem ने पिछली बार जोड़ा था, इसलिए जिस प्रविष्टि को टेम्पलेट हटा देता है वह हटा दी जाती है, और जो प्रविष्टि आपने जोड़ी है वह बनी रहती है।
- अनइंस्टॉल केवल उन्हीं प्रविष्टियों को हटाता है जिन्हें लेजर Apothem की प्रविष्टियों
के रूप में दर्ज करता है। कोई नियम जो संयोग से Apothem के किसी नियम के समान हो
(उदाहरण के लिए, पहले इंस्टॉल से पहले आपकी अपनी
allowसूची मेंRead) बना रहता है। फ़ाइल केवल तभी हटाई जाती है जब उसे Apothem ने बनाया हो और उसमें आपका कुछ भी शेष न हो।
यही नियम उन अन्य सेटिंग्स फ़ाइलों पर भी लागू होते हैं जिनमें Apothem मर्ज करता है,
जैसे Qwen Code के settings.json और OpenCode के opencode.json में MCP सर्वर मैप।
MCP सर्वर
Model Context Protocol सर्वर कॉन्फ़िगरेशन — ऑपरेटर-स्वामित्व वाला और प्रत्येक टूल के नेटिव MCP तंत्र के माध्यम से पंजीकृत; कुछ अडैप्टर साझा प्रोफ़ाइल की MCP इन्वेंट्री को प्रक्षेपित करते हैं, बाकी कोई सर्वर प्रविष्टि नहीं लिखते।
settings.json दस्तावेज़ीकरण
Apothem इकोसिस्टम के लिए Claude Code हुक निष्पादन, अनुमतियाँ, इवेंट, टाइमआउट, Python रनटाइम, सत्यापन और स्तरित सेटिंग्स प्राथमिकता कॉन्फ़िगर करें।