Agent skills, MCP servers की rules files: काय निवडावे?
Coding agent ला context देण्यासाठी skill, MCP server आणि rules file यांतील फरक समजून घ्या. प्रत्येकाची token किंमत, upkeep आणि योग्य वापराचे एक स्पष्ट नियम जाणून घ्या.
Agent skills, MCP servers आणि rules files: थोडक्यात उत्तर
Agent skills, MCP servers आणि rules files हे सर्व coding agent समोर ज्ञान उपलब्ध करून देतात. ज्ञान काय करते, यानुसार पर्याय निवडा. MCP (model context protocol) हे पुढच्या वेळी पाहिल्यावर बदललेले असू शकणाऱ्या डेटासाठी वापरा. Skill ही अशी प्रक्रिया असते, जी आज लिहून ठेवली तरी सहा आठवड्यांनंतरही योग्य राहील. Rules file ही प्रत्येक session मध्ये लागू राहिलीच पाहिजेत अशा मोजक्या तथ्यांसाठी असते.
या निवडीची एक किंमत आहे आणि ती म्हणजे context. Agent ला आवश्यक नसलेल्या instruction वर खर्च होणारा प्रत्येक token तो वाचत असलेल्या code साठी उपलब्ध राहत नाही. प्रत्येक turn वर त्याच token साठी पुन्हा पैसे द्यावे लागतात, कारण प्रत्येक request सोबत संपूर्ण context window पुन्हा पाठवली जाते. त्यामुळे उपयुक्त प्रश्न हा कोणती यंत्रणा हे काम करू शकते हा नाही. बहुतेक दिवशी तिन्ही यंत्रणा ते करू शकतात. प्रश्न हा आहे की idle असताना कोणत्या यंत्रणेचा खर्च सर्वात कमी असतो.
वापरण्यापूर्वी प्रत्येकाचा खर्च
हे तिन्ही घटक वेगवेगळ्या वेळी लोड होतात आणि ही वेळच त्यांच्यातील मुख्य फरक आहे.
एक unconditional rules file प्रत्येक सत्राच्या सुरुवातीला लोड होते, मग ती संबंधित असो वा नसो, जोपर्यंत ती वगळली जात नाही. Claude Code प्रत्येक संभाषणाच्या सुरुवातीला startup CLAUDE.md फाइल्स वाचते, कोड ब्लॉक्सच्या बाहेरील block-level HTML कमेंट्स काढून टाकते आणि 4 MiB पेक्षा मोठ्या फाइल्स वगळते; claudeMdExcludes द्वारे managed policy फाइल वगळता इतर फाइल्सना वगळता येते. दस्तऐवजीकरणानुसार प्रति फाइल 200 ओळींपेक्षा कमी लांबी असणे अपेक्षित आहे, कारण मोठी फाइल जास्त context वापरते आणि तिचे पालन कमी विश्वासार्हतेने केले जाते. हे दोन्ही परिणाम एकाच दिशेने काम करतात, म्हणूनच 900 ओळींची rules file निरुपयोगी ठरते.
एक skill दोन टप्प्यांत लोड होते. सुरुवातीला, प्रत्येक SKILL.md frontmatter मधील फक्त description ओळ context मध्ये येते, जेणेकरून मॉडेलला skill अस्तित्वात आहे आणि ती साधारणपणे कधी लागू होते हे समजते. जेव्हा skill वापरली जाते, तेव्हाच तिचा मुख्य भाग लोड होतो. त्यामुळे, 400 ओळींचा संदर्भ दस्तऐवज (reference document) आवश्यक असल्याशिवाय कोणताही खर्च करत नाही.
पूर्वी MCP server महाग मानला जायचा आणि तुम्ही वाचत असलेली बहुतेक जुनी तुलना आता कालबाह्य झाली आहे. सध्याच्या Claude Code मध्ये tool search डीफॉल्टनुसार सुरू असते. सत्राच्या सुरुवातीला फक्त टूल्सची नावे आणि सर्व्हरचे instructions field लोड होतात, तर पूर्ण JSON (JavaScript object notation) स्कीमा Claude द्वारे शोधले जाईपर्यंत पुढे ढकलले जातात. सर्व्हर जोडल्यामुळे आता सुरुवातीला हजारो टोकन्सचा खर्च होत नाही. तरीही काही खर्च होतोच, आणि जर tool search बंद असेल तर सर्व कॉन्फिगरेशनमध्ये सुरुवातीलाच पूर्ण खर्च होतो.
या तक्त्यामागील डेटा
[
{
"label": "Rules file, 200 lines",
"at_startup": "2,500",
"after_use": "2,500"
},
{
"label": "Skill, 12 KB body",
"at_startup": 40,
"after_use": "3,000"
},
{
"label": "MCP server, tool search on",
"at_startup": 500,
"after_use": "3,200"
},
{
"label": "MCP server, tool search off",
"at_startup": "4,500",
"after_use": "4,500"
}
]हे अंदाज आहेत, तुमच्या मशीनवरील मोजमाप नाहीत. हे प्रत्येक यंत्रणेद्वारे लोड होणाऱ्या मजकुराच्या आकारावरून आले आहेत, जिथे साधारणपणे चार अक्षरांचा एक टोकन मानला जातो: 200 ओळींची rules file सुमारे 10 KB ची markdown असते, skill चे वर्णन सुमारे 160 अक्षरांचे असते आणि बारा टूल्स देणारा सर्व्हर सुमारे 18 KB स्कीमा आणि 2 KB instructions ब्लॉक घेतो. Claude Code सर्व्हरचे instructions field आणि प्रत्येक टूलचे वर्णन डीफॉल्टनुसार 4,096 अक्षरांवर मर्यादित करते, तर tool search द्वारे लोड केलेले टूल वर्णन 16,384 अक्षरांवर मर्यादित असते. v2.1.296 पूर्वी ही मर्यादा 2,048 अक्षरे होती आणि तुम्ही सेट केल्यास CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH दोन्ही मर्यादा बदलू शकते. काही Anthropic-hosted MCP सर्व्हरच्या instructions आणि वर्णने ही मर्यादा सेट करूनही पूर्णपणे Claude पर्यंत पोहोचतात, त्यामुळे या मर्यादा सर्वत्र लागू होत नाहीत. पुढील विभागात तुम्ही स्वतःचे प्रत्यक्ष आकडे कसे वाचायचे ते पाहू शकता.
पहिले दोन तक्ते एकत्र वाचा. ज्या सत्रात कोणालाही गरज नव्हती, तिथे rules file चा खर्च 2,500 टोकन्स आहे. त्याच सत्रात skill चा खर्च 40 टोकन्स आहे आणि ज्या दहापैकी एका सत्रात ती वापरली जाते, तिथे तो 3,000 इतका आहे. शेवटच्या दोन ओळी एकाच सर्व्हरच्या आहेत, एकदा tool search सुरू असताना आणि एकदा बंद असताना: 500 टोकन्स विरुद्ध 4,500. ही तफावतच MCP context bloat बद्दलच्या जुन्या सल्ल्यांचे कारण आहे.
ऑक्टोबर 2026 पर्यंत, Claude Code हे Claude Opus 4, Sonnet 4, Haiku 4.5 आणि त्यानंतरच्या मॉडेल्सवर, तसेच Google Cloud च्या Agent Platform वरील Opus 4.5, Sonnet 4.5, Haiku 4.5 आणि त्यानंतरच्या मॉडेल्सवर tool search वापरते. जुन्या मॉडेल्सवर आणि Azure वर होस्ट केलेल्या Microsoft Foundry deployments वर, तुम्ही काहीही सेट केले तरी प्रत्येक MCP टूल सुरुवातीलाच लोड होते. जर ANTHROPIC_BASE_URL ला LLM gateway कडे निर्देशित केले असेल, तर v2.1.304 पासून tool search डीफॉल्टनुसार सुरू असते; जुन्या आवृत्त्यांमध्ये तुम्ही निवड केल्याशिवाय ते बंद असायचे. v2.1.305 पासून, Claude Code 400 किंवा 422 नंतर tool search शिवाय gateway विनंती पुन्हा प्रयत्न करू शकते, अशा वेळी पुन्हा प्रयत्न यशस्वी झाल्यास टूल्स सुरुवातीलाच लोड होतात. हे नियंत्रित करण्यासाठी ENABLE_TOOL_SEARCH सेट करा: false प्रत्येक स्कीमा सुरुवातीला लोड करते, true ते सेट न केल्याप्रमाणेच समान मॉडेल आणि deployment fallbacks सह पुढे ढकलते, आणि auto टूल्स सुरुवातीला लोड करते जोपर्यंत त्यांच्या व्याख्या एकूण context window च्या 10% पेक्षा कमी असतात, त्यानंतर एकदा ती मर्यादा ओलांडली की एकूण प्रमाण खाली आले तरी tool search सुरूच ठेवते. "alwaysLoad": true सह कॉन्फिगर केलेला सर्व्हर ENABLE_TOOL_SEARCH ची पर्वा न करता आपली टूल्स सुरुवातीलाच लोड करतो.
# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claudeनिर्णायक प्रश्न: प्रत्येक invocation दरम्यान डेटा बदलतो का?
हा प्रश्न सर्वप्रथम विचारा, कारण त्यातून एक पर्याय लगेच बाद होतो. Agent ला प्रत्येक वेळी पुन्हा पाहताना वेगळा असू शकणारा डेटा वाचायचा किंवा लिहायचा असेल, तर server आवश्यक आहे. Issue tracker, database, monitoring dashboard किंवा तुमचे स्वतःचे internal API (application programming interface). ते लिहून ठेवणे उपयुक्त ठरत नाही, कारण दुसऱ्या व्यक्तीने record संपादित करताच तुम्ही लिहिलेली माहिती stale होते. तुमचा स्वतःचा codebase देखील या यादीत येतो, कारण प्रत्येक commit सोबत त्याची रचना बदलते. म्हणून repository ची रचना कालबाह्य होणाऱ्या file मध्ये वर्णन करण्याऐवजी MCP द्वारे agent ला repository चा parsed map देणे अधिक योग्य ठरते.
कोणीही देखभाल न करता सहा आठवड्यांनंतरही उत्तर योग्य राहणार असेल, तर skill वापरा. Release checklist. Migration procedure. Error responses ची रचना. या repository मध्ये tests कसे लिहायचे याचे नियम. Skill ही git मधील file असते. तिला port किंवा process नसतो आणि चुकीची असण्याव्यतिरिक्त failure mode नसतो; code review मध्ये ती चूक पकडता येते.
तुम्ही अद्याप विचारात न घेतलेल्या कामालाही लागू होणारी एकच वस्तुस्थिती असेल, तर ती rules file मध्ये ठेवा. Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. प्रत्येक ओळीत एक तथ्य ठेवा. एखादी entry steps मध्ये वाढू लागली की ती यापुढे तथ्य राहत नाही; ती procedure बनते आणि skill मध्ये हलवली पाहिजे.
जेव्हा नियमांची फाईल पुरेशी असते
नियमांच्या फाईल्स अनेक ठिकाणांहून लोड होतात, ज्याचा क्रम व्यापक ते विशिष्ट असा असतो: एक व्यवस्थापित पॉलिसी फाईल, तुमची वैयक्तिक ~/.claude/CLAUDE.md, प्रकल्पाची ./CLAUDE.md किंवा ./.claude/CLAUDE.md, आणि gitignore केलेली ./CLAUDE.local.md. सापडलेल्या सर्व फाईल्स एकमेकांना ओव्हरराईड करण्याऐवजी एकत्रित (concatenate) केल्या जातात आणि तुमच्या वर्किंग डिरेक्टरीच्या जवळ असलेल्या फाईल्स शेवटी वाचल्या जातात.
v2.1.277 पासून Claude Code ही AGENTS.md देखील वाचते, परंतु डीफॉल्टनुसार हे तेव्हाच घडते जेव्हा तुमच्या वर्किंग डिरेक्टरीमध्ये किंवा त्यावरील फोल्डरमध्ये CLAUDE.md, .claude/CLAUDE.md किंवा CLAUDE.local.md उपलब्ध नसतात. जर तुमच्या रिपॉझिटरीमध्ये दोन्ही असतील, तर Claude फक्त CLAUDE.md फाईल्स वाचते, त्यामुळे दोन प्रती ठेवू नका ज्या कालांतराने विसंगत होऊ शकतात.
ln -s AGENTS.md CLAUDE.mdयशस्वी झाल्यावर सिम्बॉलिक लिंक काहीही आउटपुट देत नाही. एक सेशन सुरू करा, /context all चालवा आणि Memory files अंतर्गत CLAUDE.md दिसते का ते तपासा. जर ती तिथे दिसत नसेल, तर एजंटने ती कधीही पाहिलेली नाही आणि शब्दांत बदल करूनही उपयोग होणार नाही. जेव्हा तुम्हाला Claude-विशिष्ट ओळींचीही गरज असते, तेव्हा import फॉरमॅट वापरा आणि त्यांना import च्या खाली ठेवा.
@AGENTS.md
## Claude Code
Use plan mode for changes under `src/billing/`.येथे एक अडचण आहे. @path इंपोर्ट्स संदर्भ (context) सेव्ह करत नाहीत. इंपोर्ट केलेली फाईल लाँचच्या वेळी ज्या फाईलने तिला रेफर केले आहे, तिच्यासोबत चार लेव्हल्सपर्यंत विस्तारली आणि लोड केली जाते. 600 ओळींची नियमांची फाईल सहा इंपोर्ट्समध्ये विभागल्याने ती मानवासाठी सुटसुटीत होते, परंतु टोकन खर्चामध्ये कोणताही बदल होत नाही. लेआउट ठरवण्यापूर्वी AGENTS.md आणि त्याच्या मानवी आवृत्तीमागील संकेत वाचणे फायदेशीर ठरेल.
खर्च कमी करण्याचा मार्ग म्हणजे paths फील्डसह .claude/rules/ वापरणे. paths फ्रंटमॅटर असलेली नियमांची फाईल तेव्हाच लोड होते जेव्हा एजंट एखाद्या पॅटर्नशी जुळणाऱ्या फाईलला स्पर्श करतो.
---
paths:
- "src/api/**/*.ts"
---
# API rules
- Every endpoint validates its input.
- Use the standard error response shape.paths फील्ड नसलेला नियम लाँचच्या वेळी .claude/CLAUDE.md च्या समान प्राधान्याने लोड होतो. त्यामुळे, कार्यक्षम पद्धत म्हणजे लहान बिनशर्त नियम वापरणे आणि केवळ एका डिरेक्टरीमध्ये महत्त्वाच्या असलेल्या गोष्टींसाठी paths लिस्ट वापरणे.
एखादे skill हवे असल्यास
Skill म्हणजे त्यामध्ये SKILL.md असलेली directory होय. वैयक्तिक skills ~/.claude/skills/<name>/SKILL.md येथे असतात आणि तुमच्या मशीनवरील प्रत्येक project ला लागू होतात. Project skills .claude/skills/<name>/SKILL.md येथे असतात, repository सोबत येतात आणि इतर कोणत्याही file प्रमाणे pull request मध्ये त्यांचे review करता येते.
mkdir -p ~/.claude/skills/summarize-changes---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---
Run `git status` and `git diff` against the merge base.
Group the changes by intent, not by file.
Call out anything touching auth, migrations or deletions.त्या file मधील context मध्ये skill सुरू होण्यापूर्वी असणारा एकमेव भाग म्हणजे description. त्यामुळे तो दोन कामे करतो. Skill काय करतो आणि तो कधी वापरायचा हे तो सांगतो. "Helps with deploys" असे description असल्यास request शी जुळवण्यासाठी model कडे पुरेशी माहिती राहत नाही. त्यामुळे skill शांतपणे invoke होतच नाही आणि skills काम करत नाहीत असा निष्कर्ष तुम्ही काढता.
Directory चे नाव command बनते. त्यामुळे वरील उदाहरणात तुम्हाला /summarize-changes मिळते. Personal किंवा project skill मध्ये directory name पेक्षा वेगळे असलेले frontmatter name असल्यास, / menu त्याऐवजी ते command दाखवते, जोपर्यंत दुसरे कोणतेही command ते नाव आधीपासून वापरत नाही. मात्र directory name वापरून skill invoke करता येतो.
Skill invoke केल्यानंतर त्याचा rendered content conversation मध्ये single message म्हणून येतो आणि session च्या उर्वरित काळात तिथेच राहतो. पुढील turns मध्ये Claude Code file पुन्हा वाचत नाही. एकदाच करायच्या steps ऐवजी सतत लागू राहणाऱ्या instructions लिहा आणि body लहान ठेवा, कारण त्यानंतर प्रत्येक request वर प्रत्येक line चा recurring context cost लागतो. Auto-compaction नंतर Claude Code प्रत्येक skill चे सर्वात अलीकडील invocation पुन्हा जोडतो. Combined budget 25,000 tokens असताना प्रत्येक skill मधील पहिले 5,000 tokens ठेवले जातात. एका session मध्ये अनेक मोठे skills invoke केल्यास सर्वात जुने skills पूर्णपणे काढले जातात. त्यामुळे दीर्घ conversation नंतर एखादा skill प्रभावी राहिलेला नाही असे वाटू शकते. तो पुन्हा invoke केल्यास परत येतो. Procedure-heavy skill मध्ये हा trade-off स्पष्ट दिसतो: unlazy skill आणि त्याची Depth Tree पद्धत gates आणि plan file साठी प्रत्यक्ष context वापरते. त्याच्या बदल्यात काम लवकर पूर्ण झाल्याचे घोषित करणारा agent थांबतो. हीच procedure एकापेक्षा जास्त codebase साठी लागू होत असल्यास, file च्या प्रती वेगवेगळ्या ठिकाणी ठेवण्याऐवजी अनेक repositories मध्ये एकच skill share करा.
MCP सर्व्हरची आवश्यकता कधी असते
MCP सर्व्हर जोडण्यासाठी एकच command लागतो आणि transport त्याची रचना ठरवतो.
# Remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp
# Remote HTTP server behind a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
--header "Authorization: Bearer your-token"
# Local stdio server: everything after -- is passed through untouched
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
-- npx -y airtable-mcp-server-- महत्त्वाचे आहे. stdio सर्व्हरसाठी ते Claude Code चे स्वतःचे options आणि तुमचा सर्व्हर सुरू करणारी command line यांच्यात विभाजन करते. ते वगळल्यास, सर्व्हरसाठी असलेला --port 8080 हा claude mcp add च्या option म्हणून parse केला जातो आणि claude mcp add तो नाकारतो.
claude mcp list
claude mcp get notionclaude mcp add ही क्रिया Added ... line सह यशस्वी झाल्याची पुष्टी करते. यावरून फक्त configuration disk वर लिहिली गेली आहे, एवढेच समजते. प्रत्येक सर्व्हरच्या बाजूला health status दाखवणारी खरी पडताळणी claude mcp list करते: ✔ Connected, ! Needs authentication किंवा ✘ Failed to connect. failure status म्हणजे Claude Code त्या सर्व्हरपर्यंत पोहोचू शकले नाही; list command मध्ये बिघाड झाला, असा त्याचा अर्थ नाही. Session मध्ये /mcp प्रत्येक सर्व्हरसाठी हीच माहिती आणि tool count दाखवते.
MCP सर्व्हरला केलेली प्रत्येक call स्वतंत्र असते आणि त्यासाठी आवश्यक असलेली माहिती ती स्वतःसोबत घेऊन जाते. म्हणूनच MCP सर्व्हरला तुमची मागील विनंती आठवत नाही. हा रचनेचा एक निर्णय आहे आणि त्याचा परिणाम तुम्हाला स्वीकारावा लागतो: जतन करणे आवश्यक असलेली कोणतीही state सर्व्हरच्या मागे, database किंवा file मध्ये ठेवावी लागते आणि आता त्या घटकाचे संचालनही तुम्हालाच करावे लागते.
MCP server हे तुम्हाला चालवावे लागणारे process आहे
Vendor comparisons मध्ये वगळलेली किंमत येथे दिसते. Skill ही एक file असते. MCP server हे कुठेतरी चालणारे software असते. ते कुठेतरी तुमचा VPS (virtual private server) असेल, तर त्याची uptime राखण्याची जबाबदारी तुमची असते.
stdio server हे कमी खर्चाचे प्रकरण आहे. Session सुरू झाल्यावर Claude Code ते child process म्हणून सुरू करते आणि session संपल्यावर ते बंद होते. स्वतंत्रपणे monitor करण्यासारखे किंवा त्याच्या schedule नुसार patch करण्यासारखे काही नसते. Remote HTTP server ही दीर्घकाळ चालणारी service असते. त्यामुळे अशा प्रत्येक service ला लागणाऱ्या गोष्टी त्यालाही लागतात. सुरुवात स्वतंत्र user पासून होते. खालील unit ज्या mcp user म्हणून चालते तो user तयार करा आणि त्याला server ची directory द्या:
sudo useradd --system --home-dir /srv/notes-mcp --shell /usr/sbin/nologin mcp
sudo chown -R mcp:mcp /srv/notes-mcp[Unit]
Description=Notes MCP server
After=network-online.target
Wants=network-online.target
[Service]
User=mcp
WorkingDirectory=/srv/notes-mcp
ExecStart=/usr/bin/node /srv/notes-mcp/dist/server.js
Environment=PORT=8931
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now notes-mcp
systemctl is-active notes-mcp
journalctl -u notes-mcp -n 50 --no-pagersystemctl is-active ने active दाखवले पाहिजे. त्याऐवजी failed दिसल्यास journal मध्ये कारण नोंदलेले असेल. पहिल्यांदा चालवताना कारण बहुतेक वेळा missing environment variable किंवा दुसऱ्या process ने आधीच वापरलेला port असतो. येथे Restart=on-failure ऐच्छिक नाही, कारण crash झालेला MCP server स्वतःची माहिती देत नाही. Agent ने तुमचा issue tracker वाचता येत नसल्याचे सांगितल्यावरच तुम्हाला हे कळते.
Process ला 127.0.0.1 वर bind करा आणि त्याच्या पुढे TLS (transport layer security) असलेला reverse proxy ठेवा. तुमच्या database पर्यंत पोहोचणारा आणि authentication शिवाय public port वर उत्तर देणारा MCP server म्हणजे तुम्ही public केलेला database होय. VPS वर MCP server चालवणे यामध्ये proxy, certificate आणि firewall यांची योग्य मांडणी समाविष्ट आहे.
यानंतर नियमित करावे लागणारे काम प्रामाणिकपणे मोजा. Agent शी बोलणाऱ्या service पासून स्वतंत्र schedule नुसार ती service security updates घेते. तिचा OAuth token expire होतो आणि गैरसोयीच्या वेळी claude mcp list कडून ! Needs authentication छापले जाऊ लागते. तिची credentials config file किंवा Authorization header मध्ये असतात. त्यामुळे इतर कोणत्याही secret प्रमाणे त्यांचीही काळजी घ्यावी लागते. हा स्वतंत्र आणि मोठा विषय आहे: AI agent च्या आवाक्याबाहेर secrets ठेवणे. Skill साठी यापैकी कोणतेही काम करावे लागत नाही.
तुम्ही ते तयार करण्यापूर्वी पर्यायाचा विचार करा. प्रस्तावित server मागील data मध्ये साधारणपणे प्रत्येक quarter मध्ये एकदाच बदल होत असेल, तर agent ला कुठे पाहायचे आणि fields चा अर्थ काय आहे हे सांगणारी skill, सतत चालू ठेवावी लागणाऱ्या service पेक्षा स्वस्त ठरते.
तुमच्या स्वतःच्या कॉन्टेक्स्टची किंमत कशी मोजावी
अंदाज लावणे थांबवा आणि सेशनमध्ये /context all चालवा. हे सध्याचे विभाजन प्रिंट करते: सिस्टम प्रॉम्प्ट, मेमरी फाइल्स, टूल्स आणि MCP सर्व्हर्स, तसेच प्रत्येकाचे टोकन वेट.
दोन गोष्टी तपासा. Memory files अंतर्गत, तुम्हाला अपेक्षित असलेली प्रत्येक रूल्स फाइल सूचीबद्ध आहे याची खात्री करा. एखादी फाइल गहाळ असल्यास ती एजंटला दिसत नाही, त्यामुळे सूचनांकडे दुर्लक्ष केले जात असेल तर हे सर्वात आधी तपासावे. जर फाइल सूचीबद्ध असेल आणि तरीही नियम पाळला जात नसेल, तर त्याचे कारण पूर्णपणे वेगळे आहे आणि एजंटला दिसणारी सूचना तो का दुर्लक्षित करतो याची कारणे पुन्हा ओळ लिहिण्यापूर्वी तपासून पाहणे फायदेशीर ठरेल. त्यानंतर तुमच्या सर्व्हर्सची किंमत तपासा. जर तुम्ही महिन्यातून दोनदा वापरत असलेला सर्व्हर त्या यादीतील सर्वात मोठ्या खर्चांपैकी एक असेल, तर /mcp मध्ये तो बंद करा आणि ज्या सेशनसाठी गरज असेल तेव्हा पुन्हा चालू करा. कॉन्फिगरेशन दोन्ही स्थितीत जतन केले जाते.
जर तुमच्या अकाउंटसाठी डिस्कव्हरी कॅशे सुरू असेल, तर तुम्ही यापूर्वी वापरलेला रिमोट सर्व्हर cached 2h ago · connects on first use · 5 tools सारखी स्थिती दर्शवू शकतो. याचा अर्थ असा की Claude Code ने स्टार्टअपला कनेक्ट करण्याऐवजी मागील सेशनमधील टूल लिस्ट वाचली आहे आणि जेव्हा एखादे टूल पहिल्यांदा कॉल केले जाईल तेव्हा तो कनेक्ट होईल. टूल्स तुमच्या पहिल्या मेसेजपासून उपलब्ध असतात, त्यामुळे यात काहीही दुरुस्त करण्याची गरज नाही. जोपर्यंत हळूहळू होणाऱ्या रोलआउटमुळे ते तुमच्यासाठी सुरू झाले नसेल, तोपर्यंत कॅशे डीफॉल्टनुसार बंद असतो: प्रत्येक सर्व्हर स्टार्टअपला कनेक्ट ठेवण्यासाठी MCP_DISCOVERY_CACHE=0 सेट करा, किंवा कॅशे सुरू करण्यासाठी 1 वापरा. अधिक माहितीसाठी, Claude Code कॉन्टेक्स्ट विंडो व्यवस्थापित करणे यामध्ये कॉम्पॅक्शननंतर काय टिकून राहते हे कव्हर केले आहे आणि ते टोकन्स तुम्हाला प्रत्यक्षात किती पडतात हे त्या आकड्यांचे पैशात रूपांतर करते.
माझे skill कधीच का trigger होत नाही?
याचे नेहमीचे कारण म्हणजे description. Skill चालण्यापूर्वी context मध्ये असलेला तो एकमेव मजकूर असतो. त्यामुळे त्यात परिस्थितीचे नाव नसेल, तर कोणतीही जुळवणी होत नाही. Trigger वाक्यात स्पष्टपणे लिहा: "Use when the user asks what changed, wants a commit message, or asks to review their diff." अस्पष्ट वर्णने कोणताही error न दाखवता अपयशी ठरतात. त्यामुळे हे लक्षात येणे कठीण जाते.
दुसरे कारण म्हणजे frontmatter मधील typo. Claude Code मध्ये हे देखील कोणताही error न दाखवता घडते. Field name अचूक असणे आवश्यक आहे आणि hyphens देखील तशाच असाव्यात. Claude Code ला न ओळखणारे field आढळल्यास तो error नोंदवता ते दुर्लक्षित करतो. Skill package केल्यावर किंवा ते claude.ai अथवा Skills API वर upload केल्यावरच स्पष्ट error दिसतो. ही दोन्ही ठिकाणे कमी fields स्वीकारतात आणि उर्वरित fields थेट नाकारतात:
Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, nameतिसरे कारण म्हणजे location. Project skills तुमच्या working directory मधील .claude/skills/ आणि repository root पर्यंतच्या प्रत्येक parent directory मधून load होतात. तुम्ही सुरुवात केलेल्या ठिकाणाच्या खालील nested directories मधील skills launch वेळी load होत नाहीत. Agent त्या subdirectory मधील file प्रथमच read किंवा edit करतो तेव्हा ती skills उपलब्ध होतात. तोपर्यंत त्या autocomplete मध्ये दिसत नाहीत आणि नावाने invoke करता येत नाहीत.
MCP मधील या silent failure चे समतुल्य म्हणजे .mcp.json entry मध्ये url असणे आणि type नसणे. type नसलेल्या प्रत्येक entry ला Claude Code stdio server मानतो. त्यामुळे तो entry वगळतो आणि पुढील संदेश दाखवतो:
MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entryतीन्ही एकत्र वापरणे
हे तिन्ही mechanisms एकाच जागेसाठी स्पर्धा करत नाहीत. कार्यक्षम setup मध्ये प्रत्येक mechanism जिथे कमी खर्चात उपयुक्त ठरतो तिथे वापरला जातो. rules file मध्ये सर्वत्र लागू होणाऱ्या काही ओळी असतात. Skills मध्ये procedures असतात आणि त्या लागू असतील तेव्हाच load केल्या जातात. एक MCP server, आणि कधीकधी दोन MCP servers, ज्यांची सामग्री आधीच सांगता येत नाही अशा systems शी connect होतात. पहिल्या mechanism चे mental model अजून तयार करत असाल, तर agent skill नेमके काय आहे यामध्ये format चे सविस्तर वर्णन आहे.
एखादी गोष्ट कुठे ठेवायची यावरील बहुतेक वाद एका test ने मिटतात. ती गोष्ट delete करा, fresh session सुरू करा आणि agent ला task द्या. agent फक्त धीम्या गतीने काम करत असेल, तर ती skill मध्ये असायला हवी होती. agent आत्मविश्वासाने चुकीचे उत्तर देत असेल, तर ती rules file मध्ये असायला हवी होती. agent ला माहिती अजिबात मिळत नसेल, तर server आवश्यक होता; आता तो server चालू ठेवण्यासाठी plan देखील आवश्यक आहे.
FAQ
मी स्किल लिहावे की MCP सर्व्हर सुरू करावा?
माहिती एका विनंतीनंतर दुसऱ्या विनंतीपर्यंत बदलते की नाही, यावरून निर्णय घ्या. जर एजंटला एखाद्या इश्यू ट्रॅकर, डेटाबेस किंवा डॅशबोर्डसारखी अशी लाइव्ह स्थिती वाचावी लागत असेल जी इतर कोणीही बदलू शकते, तर तुम्हाला MCP सर्व्हरची गरज आहे. कारण तुम्ही लिहिलेली कोणतीही माहिती रेकॉर्ड बदलताच जुनी (stale) होते. जर तुम्ही उत्तर एकदा लिहून ठेवले आणि ते सहा आठवड्यांनंतरही अचूक राहणार असेल, तर स्किल लिहा. स्किल ही git मधील एक फाईल असते, ज्यासाठी कोणतीही प्रक्रिया चालवावी लागत नाही, कोणताही पोर्ट उघडावा लागत नाही आणि पॅच शेड्यूलची गरज नसते. त्यामुळे जेव्हा शक्य असेल तेव्हा हा स्वस्त पर्याय आहे.
MCP सर्व्हर अजूनही माझे कॉन्टेक्स्ट विंडो भरतात का?
पूर्वीच्या तुलनेत आता खूप कमी. सध्याच्या Claude Code मध्ये टूल सर्च डीफॉल्टनुसार सुरू असतो, त्यामुळे सेशन सुरू होताना फक्त टूलची नावे आणि सर्व्हरची सूचना फील्ड लोड होतात. जेव्हा Claude त्यांना शोधतो, तेव्हाच पूर्ण स्कीमा फेच केले जातात. v2.1.304 पासून, ANTHROPIC_BASE_URL द्वारे सेट केलेल्या LLM गेटवेच्या मागील सेशन्समध्येही आता हे समाविष्ट आहे. ENABLE_TOOL_SEARCH=false सह, "alwaysLoad": true वर सेट केलेल्या सर्व्हरसाठी, Claude Opus 4 आणि Sonnet 4 पेक्षा जुन्या मॉडेलवर (Google Cloud च्या एजंट प्लॅटफॉर्मवरील 4.5 जनरेशनच्या आधीचे), आणि Azure वर होस्ट केलेल्या Microsoft Foundry डिप्लॉयमेंटवर अजूनही सुरुवातीलाच लोडिंग होते. तुम्ही कोणत्या स्थितीत आहात हे पाहण्यासाठी /context all चालवा, कारण जुन्या तुलनात्मक पोस्टमधील आकडेवारी सुरुवातीच्या लोडिंगवर आधारित आहे.
Claude Code AGENTS.md वाचते का?
हो, v2.1.277 पासून, परंतु डीफॉल्टनुसार फक्त तेव्हाच जेव्हा तुमच्या वर्किंग डिरेक्टरीमध्ये किंवा त्याआधी CLAUDE.md, .claude/CLAUDE.md किंवा CLAUDE.local.md नसते. जर तुमच्या रिपॉझिटरीमध्ये दोन्ही असतील, तर Claude फक्त CLAUDE.md फाईल्स वाचते. त्यामुळे दोन प्रती ठेवण्याऐवजी एकाला दुसऱ्याकडे पॉइंट करा. साध्या symlink साठी ln -s AGENTS.md CLAUDE.md चालवा, किंवा CLAUDE.md च्या पहिल्या ओळीवर @AGENTS.md ठेवा आणि त्याखाली Claude-विशिष्ट सूचना जोडा. त्यानंतर सेशन सुरू करा आणि Memory फाईल्स अंतर्गत CLAUDE.md दिसते का हे तपासण्यासाठी /context all चालवा.
सेशनच्या मध्यभागी माझ्या स्किलचा परिणाम का थांबला?
Auto-compaction हे याचे सामान्य कारण आहे. जेव्हा संभाषणाचा सारांश (summarize) केला जातो, तेव्हा Claude Code प्रत्येक स्किलची सर्वात अलीकडील विनंती पुन्हा जोडते. प्रत्येक स्किलचे पहिले 5,000 टोकन्स राखून ठेवले जातात, ज्याची एकत्रित मर्यादा सर्व स्किल्स मिळून 25,000 टोकन्स इतकी असते. हे बजेट सर्वात अलीकडे वापरलेल्या स्किलपासून भरले जाते, त्यामुळे जर तुम्ही अनेक मोठी स्किल्स वापरली असतील, तर जुनी स्किल्स पूर्णपणे काढून टाकली जातात. पूर्ण मजकूर पुन्हा मिळवण्यासाठी स्किल पुन्हा इनव्होक करा.
प्रत्येक सेशनमध्ये मोठी रूल्स फाईल लोड होण्यापासून मी कशी रोखू?
ज्या गोष्टी फक्त कधीकधी महत्त्वाच्या असतात, त्यांना paths फील्ड असलेल्या .claude/rules/ फाईल्समध्ये हलवा. यामुळे प्रत्येक फाईल तेव्हाच लोड होईल जेव्हा एजंट संबंधित फाईलला स्पर्श करेल. फाईलला @path इम्पोर्ट्समध्ये विभागल्याने काहीही फायदा होत नाही, कारण इम्पोर्ट केलेल्या फाईल्स लाँच होतानाच त्या फाईलसोबत विस्तारल्या आणि लोड केल्या जातात ज्याने त्यांना रेफर केले होते. जी गोष्ट कायमस्वरूपी तथ्य नसून बहु-टप्प्यांची प्रक्रिया आहे, तिचे रूपांतर स्किलमध्ये करा, कारण स्किल बॉडी जोपर्यंत इनव्होक केली जात नाही तोपर्यंत तिचा कोणताही खर्च (टोकन वापर) होत नाही.