Agent skills vs MCP servers vs rules files: kipi bora?
Jifunze tofauti kati ya agent skills, MCP servers, na rules files katika kuongeza muktadha wa coding. Linganisha gharama za token na matumizi sahihi kwa kila mbinu.
Ujuzi wa wakala dhidi ya seva za MCP dhidi ya faili za sheria: jibu fupi
Ujuzi wa wakala (agent skills), seva za MCP, na faili za sheria zote huweka maarifa mbele ya wakala wa usimbaji. Chagua kulingana na kile ambacho maarifa hayo hufanya. MCP (model context protocol) ni kwa ajili ya data inayoweza kubadilika wakati mwingine utakapoiangalia. Ujuzi (skill) ni kwa ajili ya utaratibu ambao unaweza kuandika leo na bado ukawa sahihi baada ya wiki sita. Faili ya sheria (rules file) ni kwa ajili ya ukweli machache ambao lazima uzingatiwe katika kila kipindi (session).
Chaguo hilo lina gharama, na gharama hiyo ni muktadha (context). Kila token inayotumika kwa maelekezo ambayo wakala hakuhitaji ni token ambayo haipatikani kwa ajili ya msimbo (code) unaosomwa. Pia ni token unayolipa tena katika kila hatua, kwa sababu dirisha zima la muktadha hutumwa tena kwa kila ombi. Kwa hivyo, swali la maana si ni utaratibu upi unaoweza kufanya kazi hiyo. Mara nyingi yote matatu yanaweza. Swali ni lipi linalogharimu kidogo zaidi wakati likiwa halitumiki.
Gharama ya kila kipengele kabla ya kukitumia
Vipengele hivi vitatu hupakiwa kwa nyakati tofauti, na muda huo ndio tofauti kuu.
Faili ya sheria zisizo na masharti hupakiwa wakati wa kuanzisha programu, katika kila kikao, iwe inahusika au la, isipokuwa kama imetengwa. Claude Code husoma faili za kuanzisha CLAUDE.md mwanzoni mwa kila mazungumzo, huondoa maoni ya HTML ya kiwango cha block yaliyo nje ya block za msimbo kabla ya kuingiza maudhui yake, na huruka faili zenye ukubwa wa zaidi ya 4 MiB; claudeMdExcludes inaweza pia kutenga faili isipokuwa faili ya sera iliyosimamiwa. Lengo lililoelekezwa ni chini ya mistari 200 kwa kila faili, kwa sababu faili ndefu hugharimu muktadha (context) zaidi na hufuatwa kwa usahihi mdogo. Athari hizo mbili hufanya kazi kwa njia moja, ndiyo sababu faili ya sheria yenye mistari 900 ni mbaya zaidi kuliko kutokuwa na kitu.
Ujuzi (skill) hupakiwa katika hatua mbili. Wakati wa kuanzisha, ni mstari wa description pekee kutoka kwa kila frontmatter ya SKILL.md ndio huingia kwenye muktadha, ili modeli ijue kuwa ujuzi huo upo na takriban wakati gani unapaswa kutumika. Mwili wa ujuzi hupakiwa wakati ujuzi huo unapoitwa. Kwa hivyo, hati ya marejeleo yenye mistari 400 haikugharimu karibu chochote hadi wakati ambapo inahitajika.
Seva ya MCP ilikuwa ndiyo inayogharimu zaidi, na hapa ndipo kulinganisha kwingi unakoweza kusoma sasa kumepitwa na wakati. Utafutaji wa zana (tool search) umewashwa kwa chaguo-msingi katika Claude Code ya sasa. Majina ya zana pekee na sehemu ya maelekezo ya seva hupakiwa mwanzoni mwa kikao, na schema kamili za JSON (JavaScript object notation) huahirishwa hadi Claude atakapozitafuta. Kuongeza seva hakugharimu tena maelfu ya tokeni mwanzoni. Bado kuna gharama, na bado inagharimu kila kitu mwanzoni katika usanidi ambapo utafutaji wa zana umezimwa.
Data iliyo nyuma ya chati hii
[
{
"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"
}
]Hizo ni makadirio, si vipimo kutoka kwenye mashine yako. Yanatokana na ukubwa wa maandishi ambayo kila utaratibu hupakia, kwa takriban herufi nne kwa kila tokeni: faili ya sheria ya mistari 200 ni takriban 10 KB ya markdown, maelezo ya ujuzi ni takriban herufi 160, na seva inayotoa zana kumi na mbili hubeba takriban 18 KB ya schema pamoja na block ya maelekezo ya 2 KB. Claude Code hukata sehemu ya maelekezo ya seva, na maelezo ya kila zana inayopakiwa mwanzoni, kwa herufi 4,096 kwa chaguo-msingi, na maelezo ya zana yaliyopakiwa kupitia utafutaji wa zana kwa herufi 16,384. Kabla ya v2.1.296 kikomo kifupi kilikuwa herufi 2,048, na CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH huchukua nafasi ya mipaka yote miwili ukiweka thamani hiyo. Maelekezo na maelezo kutoka kwa baadhi ya seva za MCP zinazohifadhiwa na Anthropic humfikia Claude kikamilifu hata kama kigezo hicho kimewekwa, kwa hivyo mipaka hii si kikomo cha ulimwengu wote. Sehemu inayofuata inakuonyesha jinsi ya kusoma namba zako halisi.
Soma safu mbili za kwanza pamoja. Faili ya sheria inagharimu 2,500 tokeni katika kikao ambapo hakuna mtu aliyeihitaji. Ujuzi unagharimu 40 tokeni katika kikao hicho hicho, na 3,000 katika kikao kimoja kati ya kumi ambapo ujuzi huo hufanya kazi. Safu mbili za mwisho ni seva ile ile mara mbili, ikiwa na utafutaji wa zana umewashwa na kuzimwa: 500 tokeni dhidi ya 4,500. Pengo hilo ndilo sababu ya ushauri wa zamani kuhusu uvimbe wa muktadha wa MCP bado kusambaa.
Kufikia Oktoba 2026, Claude Code hutumia utafutaji wa zana kwenye Claude Opus 4, Sonnet 4, Haiku 4.5 na modeli za baadaye, na kwenye Opus 4.5, Sonnet 4.5, Haiku 4.5 na baadaye kwenye Agent Platform ya Google Cloud. Kwenye modeli za awali, na kwenye utekelezaji wa Microsoft Foundry unaohifadhiwa kwenye Azure, kila zana ya MCP hupakiwa mwanzoni bila kujali ulichoweka. Pamoja na ANTHROPIC_BASE_URL kuelekezwa kwenye lango la LLM (LLM gateway), utafutaji wa zana umewashwa kwa chaguo-msingi tangu v2.1.304; matoleo ya zamani yalizima utafutaji huo hapo isipokuwa kama ulichagua kuuwasha. Tangu v2.1.305, Claude Code inaweza kujaribu tena ombi la lango bila utafutaji wa zana baada ya 400 au 422, ikipakia zana mwanzoni wakati jaribio hilo la pili likifanikiwa. Weka ENABLE_TOOL_SEARCH ili kuidhibiti: false hupakia kila schema mwanzoni, true huiahirisha kwa kutumia modeli ile ile na utekelezaji wa fallback kama ilivyo wakati haijawekwa, na auto huipakia mwanzoni wakati ufafanuzi wake kwa jumla ni chini ya 10% ya dirisha la muktadha, kisha huweka utafutaji wa zana umewashwa mara tu kizingiti hicho kinapofikiwa hata kama jumla itashuka chini yake baadaye. Seva iliyosanidiwa na "alwaysLoad": true hupakia zana zake mwanzoni bila kujali ENABLE_TOOL_SEARCH.
# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claudeSwali la msingi: je, data hubadilika kati ya matumizi?
Uliza swali hili kwanza, kwa sababu linaondoa chaguo moja mara moja. Ikiwa agent inahitaji kusoma au kuandika kitu kinachoweza kuwa tofauti wakati ujao, unahitaji seva. Mfumo wa kufuatilia masuala (issue tracker), database, dashibodi ya ufuatiliaji, au API (application programming interface) yako ya ndani. Kuandika kitu hicho hakusaidii, kwa sababu ulichokiandika kinapitwa na wakati pindi mtu mwingine anapohariri rekodi hiyo. Codebase yako pia inapaswa kuwa kwenye orodha hiyo, kwa sababu muundo wake hubadilika kila unapo-commit, ndiyo sababu ya kuipatia agent ramani iliyochambuliwa ya repository kupitia MCP badala ya kuelezea mpangilio wake kwenye faili inayopitwa na wakati.
Ikiwa jibu litaendelea kuwa sahihi hata baada ya wiki sita bila mtu yeyote kulisimamia, unahitaji skill. Orodha ya ukaguzi wa release. Utaratibu wa migration. Muundo wa majibu yako ya makosa (error responses). Jinsi repository hii inavyotaka majaribio (tests) yaandikwe. Skill ni faili ndani ya git. Haina port, haina process, na haina hali ya kufeli (failure mode) isipokuwa kuwa na taarifa zisizo sahihi, jambo ambalo linaweza kugunduliwa kupitia code review.
Ikiwa ni ukweli mmoja ambao lazima utumike kwa kazi ambayo bado hujaiwaza, iweke kwenye faili ya rules. Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. Mstari mmoja kwa kila moja. Pale ambapo ingizo linapokua na kuwa na hatua nyingi, linakuwa limeacha kuwa ukweli na kugeuka kuwa utaratibu, na linapaswa kuhamishiwa kwenye skill.
Wakati faili ya sheria inatosha
Faili za sheria hupakiwa kutoka maeneo kadhaa, kuanzia yale ya jumla hadi mahususi zaidi: faili ya sera iliyosimamiwa, ~/.claude/CLAUDE.md yako binafsi, ./CLAUDE.md au ./.claude/CLAUDE.md ya mradi, na ./CLAUDE.local.md iliyotengwa na git. Faili zote zinazopatikana huunganishwa badala ya kufutana, na faili zilizo karibu na saraka yako ya kazi husomwa mwisho.
Tangu v2.1.277 Claude Code pia husoma AGENTS.md, lakini kwa chaguo-msingi hufanya hivyo tu wakati hakuna CLAUDE.md, .claude/CLAUDE.md au CLAUDE.local.md katika saraka yako ya kazi au juu yake. Ikiwa hazina yako ina zote mbili, Claude husoma faili za CLAUDE.md pekee, kwa hivyo usitunze nakala mbili ambazo zitatofautiana.
ln -s AGENTS.md CLAUDE.mdSymlink haitoi ujumbe wowote ikifanikiwa. Anzisha kipindi, endesha /context all, na uthibitishe CLAUDE.md inaonekana chini ya Memory files. Ikiwa haijaorodheshwa hapo, wakala haijawahi kuiona na hakuna marekebisho ya maneno yatakayosaidia. Unapotaka pia mistari mahususi ya Claude, tumia fomu ya import na uiweke chini ya import hiyo.
@AGENTS.md
## Claude Code
Use plan mode for changes under `src/billing/`.Mtego mmoja upo hapa. Imports za @path hazihifadhi muktadha. Faili iliyoingizwa hupanuliwa na kupakiwa wakati wa kuanza pamoja na faili iliyoirejelea, hadi hatua nne za kina. Kugawanya faili ya sheria ya mistari 600 katika imports sita huipanga kwa ajili ya binadamu na haibadilishi gharama ya token hata kidogo. Mikataba iliyo nyuma ya AGENTS.md na pacha wake inayolenga binadamu inafaa kusomwa kabla ya kuamua mpangilio.
Kinachopunguza gharama ni .claude/rules/ yenye uwanja wa paths. Faili ya sheria yenye frontmatter ya paths hupakiwa tu wakati wakala anapogusa faili inayolingana na moja ya mifumo hiyo.
---
paths:
- "src/api/**/*.ts"
---
# API rules
- Every endpoint validates its input.
- Use the standard error response shape.Sheria isiyo na uwanja wa paths hupakiwa wakati wa kuanza ikiwa na kipaumbele sawa na .claude/CLAUDE.md. Kwa hivyo, mfumo wa kazi ni sheria fupi zisizo na masharti, pamoja na orodha ya paths kwa chochote ambacho ni muhimu tu ndani ya saraka moja.
Unapohitaji ujuzi (skill)
Ujuzi ni saraka (directory) iliyo na SKILL.md ndani yake. Ujuzi wa kibinafsi unakaa kwenye ~/.claude/skills/<name>/SKILL.md na unatumika kwa kila mradi kwenye mashine yako. Ujuzi wa mradi unakaa kwenye .claude/skills/<name>/SKILL.md, unasafiri pamoja na hazina (repository), na unaweza kukaguliwa kwenye pull request kama faili nyingine yoyote.
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.description ndiyo sehemu pekee ya faili hiyo inayokuwa kwenye muktadha kabla ya ujuzi kuanza kufanya kazi, kwa hivyo inafanya kazi mbili. Inasema ujuzi huo hufanya nini, na inasema wakati wa kuutumia. Maelezo yanayosomeka "Husaidia katika deploys" hayampi mfano (model) kitu chochote cha kulinganisha na ombi, kwa hivyo ujuzi huo hautawaka na utahitimisha kuwa ujuzi haufanyi kazi.
Jina la saraka huwa ndilo amri (command), kwa hivyo mfano hapo juu unakupa /summarize-changes. Katika ujuzi wa kibinafsi au wa mradi, frontmatter name inayotofautiana na jina la saraka huweka amri ambayo menyu ya / inaonyesha badala yake, isipokuwa kama amri nyingine tayari inatumia jina hilo, na jina la saraka bado huita ujuzi huo.
Mara tu ujuzi unapoitwa, maudhui yake yaliyotolewa huingia kwenye mazungumzo kama ujumbe mmoja na kubaki hapo kwa muda wote wa kikao. Claude Code haisomi tena faili hiyo katika hatua zinazofuata. Andika maelekezo ya kudumu badala ya hatua za mara moja, na uweke mwili wa ujumbe ukiwa mfupi, kwa sababu kuanzia wakati huo kila mstari ni gharama ya mara kwa mara katika kila ombi. Baada ya auto-compaction, Claude Code huunganisha tena mwito wa hivi karibuni wa kila ujuzi, ikihifadhi token 5,000 za kwanza za kila mmoja ndani ya bajeti ya jumla ya token 25,000. Ukiita ujuzi kadhaa mkubwa katika kikao kimoja, zile za zamani zaidi huondolewa kabisa, ndiyo sababu ujuzi unaweza kuonekana kuacha kuwa na maana baada ya mazungumzo marefu. Ukiuita tena, utarejea. Ujuzi wenye taratibu nyingi hufanya biashara hiyo kuwa dhahiri: ujuzi usio wavivu na mbinu yake ya Depth Tree hutumia muktadha halisi kwenye milango (gates) na faili ya mpango ili kupata wakala anayeacha kutangaza kazi kuwa imekamilika mapema. Wakati utaratibu uleule unapotumika kwa zaidi ya codebase moja, shiriki ujuzi mmoja kwenye hazina kadhaa badala ya kunakili faili hiyo kila mahali.
Wakati unahitaji seva ya MCP
Kuongeza seva ni amri moja tu, na mfumo wa usafirishaji (transport) huamua umbo lake.
# 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-- ni muhimu. Kwa seva ya stdio, hutenganisha chaguzi za Claude Code na mstari wa amri unaoanzisha seva yako. Ukiiondoa, --port 8080 iliyokusudiwa seva itatafsiriwa kama chaguo la claude mcp add, ambayo kisha itaikataa.
claude mcp list
claude mcp get notionclaude mcp add inathibitisha kwa mstari wa Added ..., ambao hukuambia tu kuwa usanidi umeandikwa kwenye diski. claude mcp list ndiyo amri inayokuambia ukweli, kwa sababu inachapisha hali ya afya kando ya kila seva: ✔ Connected, ! Needs authentication, au ✘ Failed to connect. Hali ya kushindwa (failure) inamaanisha Claude Code haikuweza kufikia seva hiyo, si kwamba amri ya orodha imevunjika. Ndani ya kikao, /mcp hutoa mtazamo uleule kwa kila seva pamoja na idadi ya zana.
Kila mwito kwa seva ya MCP hujitegemea na hubeba chochote kinachohitaji, ndiyo sababu seva ya MCP haikumbuki ombi lako la awali. Hilo ni chaguo la usanifu lenye matokeo unayorithi: hali yoyote (state) inayostahili kuhifadhiwa lazima ikae nyuma ya seva, kwenye database au faili, na hilo ni jambo ambalo sasa unaliendesha.
MCP server ni mchakato unaopaswa kuuendesha
Hapa kuna gharama ambayo ulinganisho wa wachuuzi huacha. Skill ni faili. MCP server ni programu inayofanya kazi mahali fulani, na mahali hapo panapokuwa VPS (virtual private server) yako, unawajibika kwa uptime yake.
Stdio server ni chaguo la bei nafuu. Claude Code huianzisha kama mchakato msaidizi (child process) kikao kinapoanza, na hufa kikao kinapoisha. Hakuna cha kufuatilia, hakuna cha kufanyia viraka (patch) kwa ratiba yake yenyewe. Remote HTTP server ni huduma ya muda mrefu, na inahitaji kile ambacho huduma yoyote ya muda mrefu inahitaji, kuanzia mtumiaji wake mwenyewe. Unda mtumiaji mcp ambaye unit iliyo hapa chini itatumika chini yake, na upe saraka ya seva hiyo:
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 inapaswa kuchapisha active. Ikitokea imechapisha failed, journal inashikilia sababu, na katika uendeshaji wa kwanza mara nyingi huwa ni variable ya mazingira iliyokosekana au port ambayo tayari inatumiwa na kitu kingine. Restart=on-failure si ya hiari hapa, kwa sababu MCP server iliyoanguka haijitangazi yenyewe. Utajua wakati wakala (agent) anapokuambia kuwa hawezi kusoma tracker yako ya masuala.
Funga mchakato kwenye 127.0.0.1 na uweke reverse proxy yenye TLS (transport layer security) mbele yake. MCP server inayofikia database yako na kujibu kwenye port ya umma bila uthibitisho ni sawa na database uliyoiweka hadharani. Kuendesha MCP server kwenye VPS inashughulikia vizuri upande wa proxy, cheti na firewall.
Kisha hesabu kazi ya mara kwa mara kwa uaminifu. Huduma hupokea masasisho ya usalama kwa ratiba yake yenyewe, bila kuhusiana na wakala anayewasiliana nayo. Token yake ya OAuth huisha muda wake, na claude mcp list huanza kuchapisha ! Needs authentication wakati usiofaa. Vitambulisho vyake hukaa kwenye faili ya usanidi au header ya Authorization, kwa hivyo vinahitaji uangalifu uleule kama siri nyingine yoyote, ambayo ni mada nzima kwa yenyewe: kuepusha siri zisifikiwe na AI agent. Hakuna kazi hiyo kwa ajili ya skill.
Pima dhidi ya njia mbadala kabla ya kujenga. Ikiwa data iliyo nyuma ya seva inayopendekezwa inabadilika takriban mara moja kwa robo mwaka, skill inayomwambia wakala mahali pa kuangalia na maana ya sehemu hizo ni nafuu kuliko huduma unayopaswa kuiweka hai.
Jinsi ya kupima gharama yako ya muktadha
Acha kukadiria na uendeshe /context all ndani ya kipindi cha kazi. Amri hii huchapisha uchanganuzi wa sasa: prompt ya mfumo, faili za kumbukumbu, zana, na seva za MCP, pamoja na uzito wa tokeni kwa kila moja.
Angalia mambo mawili. Chini ya Memory files, thibitisha kuwa kila faili ya sheria unayotarajia imeorodheshwa. Faili inayokosekana haionekani na wakala, kwa hivyo hilo ndilo jambo la kwanza kuliondoa unapogundua maelekezo yanapuuzwa. Ikiwa faili imeorodheshwa na sheria bado inarukwa, sababu iko mahali pengine kabisa, na sababu zinazomfanya wakala kupuuza maelekezo anayoweza kuyaona zinastahili kufanyiwa kazi kabla ya kuandika upya mstari huo. Kisha angalia gharama za seva zako. Ikiwa seva unayotumia mara mbili kwa mwezi ni mojawapo ya mistari mikubwa zaidi kwenye orodha hiyo, izime katika /mcp na uiwashe tena kwa vipindi vinavyoihitaji. Usanidi huhifadhiwa hata ukiizima.
Ikiwa cache ya ugunduzi imewashwa kwa akaunti yako, seva ya mbali uliyotumia hapo awali inaweza kuonyesha hali kama cached 2h ago · connects on first use · 5 tools. Hiyo inamaanisha kuwa Claude Code ilisoma orodha ya zana kutoka kwa kipindi cha awali badala ya kuunganisha wakati wa kuanza, na itaunganisha mara ya kwanza zana itakapotumiwa. Zana zinapatikana kuanzia ujumbe wako wa kwanza, kwa hivyo hakuna cha kurekebisha. Cache imezimwa kwa chaguo-msingi isipokuwa kama usambazaji wa taratibu umekuwashia: weka MCP_DISCOVERY_CACHE=0 ili kufanya kila seva iunganishe wakati wa kuanza, au 1 ili kuwasha cache. Kwa mtazamo mpana zaidi, kusimamia dirisha la muktadha la Claude Code kunaelezea kile kinachobaki baada ya ufinyu, na gharama halisi ya tokeni hizo inageuza namba hizo kuwa fedha.
Kwa nini ujuzi wangu haufanyi kazi?
Sababu ya kawaida ni description. Hii ndiyo matini pekee katika muktadha kabla ya ujuzi kuanza, kwa hivyo ikiwa haitaji hali husika, hakuna kitakacholingana nayo. Andika kianzishi (trigger) kwenye sentensi: "Tumia wakati mtumiaji anapouliza nini kimebadilika, anapotaka ujumbe wa commit, au anapoomba kukagua diff yao." Maelezo yasiyo wazi hushindwa kimya kimya, jambo linalofanya iwe vigumu kutambua tatizo.
Sababu ya pili ni kosa la uchapaji kwenye frontmatter, na katika Claude Code hili pia hutokea kimya kimya. Jina la uwanja (field) lazima lilingane kikamilifu, ikiwa ni pamoja na hyphens, na Claude Code hupuuza uwanja usioutambua bila kutoa ujumbe wa hitilafu. Toleo la wazi huonekana tu unapopakia ujuzi au kuupakia kwenye claude.ai au Skills API, ambavyo hukubali nyanja chache na kukataa nyingine zote moja kwa moja:
Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, nameSababu ya tatu ni eneo. Ujuzi wa mradi hupakiwa kutoka .claude/skills/ katika saraka yako ya kazi na katika kila saraka kuu hadi mzizi wa hazina (repository root). Ujuzi uliomo kwenye saraka ndogo chini ya mahali ulipoanzisha haupakiwi wakati wa kuanza. Huonekana mara ya kwanza wakala anaposoma au kuhariri faili ndani ya saraka hiyo ndogo, kwa hivyo hadi wakati huo hauwezi kukamilishwa kiotomatiki wala kuitwa kwa jina.
Sawa ya MCP ya hitilafu hii ya kimya kimya ni ingizo la .mcp.json lenye url na bila type. Claude Code husoma ingizo lolote lisilo na type kama seva ya stdio, kwa hivyo huruka ingizo hilo na kuripoti:
MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entryKutumia zote tatu kwa pamoja
Mbinu hizi hazishindani kwa nafasi moja. Usanidi unaofanya kazi hutumia kila moja mahali ambapo ni rahisi. Faili ya rules ina mistari michache ambayo ni kweli kila mahali. Skills huhifadhi taratibu na hupakiwa tu zinapohitajika. Seva moja ya MCP, au mbili mara chache, huunganisha mifumo ambayo maudhui yake huwezi kuyatabiri mapema. Ikiwa bado unajenga mtazamo wako wa kwanza kuhusu hili, nini hasa skill ya agent ilivyo inaelezea muundo huo kwa kina.
Jaribio moja hutatua mabishano mengi kuhusu mahali kitu kinapopaswa kuwepo. Kifute, anza session mpya, na umpe agent kazi hiyo. Ikiwa agent anafanya kazi polepole tu, basi ilipaswa kuwa kwenye skill. Ikiwa agent anakosea kwa kujiamini, basi ilipaswa kuwa kwenye faili ya rules. Ikiwa agent hawezi kupata taarifa hiyo kabisa, basi ulihitaji seva, na sasa unahitaji pia mpango wa kuiweka seva hiyo ikiwa inafanya kazi.
FAQ
Je, niandike skill au niweke MCP server?
Amua kulingana na kama taarifa hubadilika kati ya matumizi moja na lingine. Ikiwa wakala lazima asome hali ya sasa ambayo mtu mwingine anaweza kuibadilisha, kama vile kifuatiliaji cha masuala (issue tracker), database au dashibodi, unahitaji MCP server, kwa sababu chochote unachoandika kinakuwa kimepitwa na wakati mara tu rekodi inapobadilika. Ikiwa unaweza kuandika jibu mara moja na bado likawa sahihi baada ya wiki sita, andika skill. Skill ni faili katika git isiyo na mchakato wa kuendeshwa, isiyo na port ya kufunguliwa, na isiyo na ratiba ya patch, kwa hivyo ndiyo chaguo nafuu zaidi kila inapowezekana.
Je, MCP servers bado zinajaza context window yangu?
Kwa kiasi kidogo sana kuliko ilivyokuwa awali. Utafutaji wa zana (tool search) umewezeshwa kwa chaguo-msingi katika Claude Code ya sasa, kwa hivyo majina ya zana na sehemu ya maelekezo ya seva hupakiwa tu wakati wa kuanza kipindi, na schema kamili hupatikana wakati Claude anapozitafuta. Hiyo sasa inajumuisha vipindi vilivyo nyuma ya LLM gateway iliyowekwa kupitia ANTHROPIC_BASE_URL, kuanzia v2.1.304 na kuendelea. Upakiaji wa awali bado hutokea kwa ENABLE_TOOL_SEARCH=false, kwa seva iliyowekwa kwenye "alwaysLoad": true, kwenye model ya zamani kuliko Claude Opus 4 na Sonnet 4 (ya zamani kuliko kizazi cha 4.5 kwenye Google Cloud's Agent Platform), na kwenye Microsoft Foundry deployments zinazohifadhiwa kwenye Azure. Endesha /context all ili kuona hali uliyo nayo, kwa sababu namba katika machapisho ya zamani ya kulinganisha hudhani upakiaji wa awali.
Je, Claude Code inasoma AGENTS.md?
Ndiyo, tangu v2.1.277, lakini kwa chaguo-msingi ni pale tu ambapo hakuna CLAUDE.md, .claude/CLAUDE.md au CLAUDE.local.md katika saraka yako ya kazi au juu yake. Ikiwa hazina yako ina zote mbili, Claude anasoma faili za CLAUDE.md pekee, kwa hivyo elekeza moja kwenye nyingine badala ya kuweka nakala mbili. Endesha ln -s AGENTS.md CLAUDE.md kwa symlink ya kawaida, au weka @AGENTS.md kwenye mstari wa kwanza wa CLAUDE.md na uongeze maelekezo mahususi ya Claude hapo chini. Kisha anza kipindi na uendeshe /context all ili kuthibitisha kuwa CLAUDE.md inaonekana chini ya faili za Memory.
Kwa nini skill yangu iliacha kufanya kazi katikati ya kipindi?
Auto-compaction ndiyo sababu ya kawaida. Wakati mazungumzo yanapofupishwa, Claude Code huunganisha tena matumizi ya hivi karibuni ya kila skill, ikihifadhi token 5,000 za kwanza za kila moja, ndani ya bajeti ya pamoja ya token 25,000 kwa zote. Inajaza bajeti hiyo kuanzia skill iliyotumiwa hivi karibuni zaidi, kwa hivyo ikiwa umetumia skills kadhaa kubwa, zile za zamani huondolewa kabisa. Tumia skill hiyo tena ili kurejesha maudhui yake kamili.
Ninawezaje kuzuia faili ndefu ya sheria kupakiwa katika kila kipindi?
Hamisha sehemu ambazo ni muhimu wakati mwingine tu kwenye faili za .claude/rules/ zenye sehemu ya paths katika frontmatter yake, ili kila moja ipakiwe tu wakati wakala anapogusa faili inayolingana. Kugawanya faili katika imports za @path hakusaidii, kwa sababu faili zilizopakiwa hupanuliwa na kupakiwa wakati wa kuanza pamoja na faili iliyozirejelea. Chochote ambacho ni utaratibu wa hatua nyingi badala ya ukweli wa kudumu kinapaswa kuwa skill, kwa sababu mwili wa skill haugharimu chochote hadi pale utakapotumika.