SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

تفاوت مهارت‌های Agent، سرور MCP و فایل rules در کدنویسی

برای بهینه‌سازی context در coding agent، تفاوت هزینه و کاربرد مهارت‌ها، سرورهای MCP و فایل‌های rules را بررسی کنید. یاد بگیرید کدام روش کمترین توکن را مصرف می‌کند.

مهارت‌های Agent در مقابل سرورهای MCP و فایل‌های rules: پاسخ کوتاه

مهارت‌های Agent، سرورهای MCP و فایل‌های rules همگی دانش را در اختیار یک coding agent قرار می‌دهند. انتخاب بین آن‌ها به عملکرد آن دانش بستگی دارد. پروتکل MCP (مخفف Model Context Protocol) برای داده‌هایی است که ممکن است در مراجعه بعدی تغییر کنند. مهارت (Skill) برای رویه‌ای است که می‌توانید امروز بنویسید و تا 6 هفته دیگر همچنان معتبر باشد. فایل rules برای آن دسته از حقایق معدودی است که باید در هر نشست (session) ثابت بمانند.

این انتخاب هزینه‌ای دارد و آن هزینه، context است. هر توکنی که صرف دستوری شود که agent به آن نیاز ندارد، توکنی است که برای خواندن کد در دسترس نخواهد بود. همچنین این توکنی است که در هر نوبت دوباره پرداخت می‌کنید، زیرا کل context window با هر درخواست مجدداً ارسال می‌شود. بنابراین پرسش مفید این نیست که کدام مکانیزم می‌تواند کار را انجام دهد؛ در بیشتر روزها هر سه گزینه قادر به انجام آن هستند. پرسش اصلی این است که کدام‌یک در زمان بیکاری، کمترین هزینه را تحمیل می‌کند.

هزینه هر کدام پیش از استفاده

این سه مورد در زمان‌های متفاوتی بارگذاری می‌شوند و همین زمان‌بندی، تفاوت اصلی آن‌هاست.

یک فایل قوانین بدون شرط (unconditional rules file) در زمان راه‌اندازی و در هر نشست (session) بارگذاری می‌شود، فارغ از اینکه مرتبط باشد یا خیر، مگر آنکه مستثنی شده باشد. Claude Code فایل‌های راه‌اندازی CLAUDE.md را در ابتدای هر گفتگو می‌خواند، کامنت‌های HTML در سطح بلوک را که خارج از بلوک‌های کد هستند حذف می‌کند تا محتوای آن‌ها را تزریق کند، و فایل‌های بزرگ‌تر از 4 MiB را نادیده می‌گیرد؛ claudeMdExcludes نیز می‌تواند فایل‌ها را به جز فایل سیاست مدیریت‌شده (managed policy file) مستثنی کند. هدف مستندشده، کمتر از 200 خط در هر فایل است، زیرا فایل طولانی‌تر هزینه context بیشتری دارد و کمتر به آن توجه می‌شود. این دو اثر در یک جهت عمل می‌کنند، به همین دلیل است که یک فایل قوانین 900 خطی، بدتر از بی‌فایده است.

یک مهارت (skill) در دو مرحله بارگذاری می‌شود. در زمان راه‌اندازی، تنها خط description از frontmatter هر SKILL.md وارد context می‌شود تا مدل بداند که آن مهارت وجود دارد و تقریباً چه زمانی اعمال می‌شود. بدنه مهارت زمانی بارگذاری می‌شود که فراخوانی شود. بنابراین، یک سند مرجع 400 خطی تا لحظه‌ای که به آن نیاز نباشد، تقریباً هیچ هزینه‌ای برای شما ندارد.

یک سرور MCP در گذشته گزینه پرهزینه‌ای بود و این همان جایی است که اکثر مقایسه‌هایی که می‌خوانید، اکنون قدیمی شده‌اند. جستجوی ابزار (tool search) در نسخه فعلی Claude Code به‌صورت پیش‌فرض فعال است. تنها نام ابزارها و فیلد دستورالعمل‌های سرور در شروع نشست بارگذاری می‌شوند و طرح‌واره‌های کامل JSON (نمادگذاری شیء جاوااسکریپت) تا زمانی که Claude آن‌ها را جستجو نکند، به تعویق می‌افتند. افزودن یک سرور دیگر هزینه‌ای معادل هزاران توکن در ابتدا ندارد. البته هنوز هزینه‌ای دارد و در پیکربندی‌هایی که جستجوی ابزار در آن‌ها خاموش است، همچنان تمام هزینه در ابتدا پرداخت می‌شود.

نمودارStartup and post-use context cost, estimated tokens
داده‌های پشت این نمودار
[
  {
    "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 خطی حدود 10 KB مارک‌داون است، توصیف یک مهارت حدود 160 کاراکتر است، و سروری که دوازده ابزار را ارائه می‌دهد، حدود 18 KB طرح‌واره به اضافه یک بلوک دستورالعمل 2 KB دارد. Claude Code فیلد دستورالعمل‌های سرور و توصیف هر ابزاری که در ابتدا بارگذاری می‌شود را به‌صورت پیش‌فرض در 4,096 کاراکتر و توصیف ابزاری که از طریق جستجوی ابزار بارگذاری می‌شود را در 16,384 کاراکتر محدود می‌کند. پیش از نسخه v2.1.296، حد کوتاه‌تر 2,048 کاراکتر بود و CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH در صورت تنظیم، جایگزین هر دو حد می‌شود. دستورالعمل‌ها و توصیفات برخی از سرورهای MCP میزبانی‌شده توسط Anthropic، حتی با تنظیم این متغیر نیز به‌طور کامل به Claude می‌رسند، بنابراین این محدودیت‌ها یک سقف جهانی نیستند. بخش بعدی به شما نشان می‌دهد که چگونه اعداد واقعی خود را بخوانید.

دو ردیف اول را با هم بخوانید. فایل قوانین در نشستی که هیچ‌کس به آن نیاز نداشته، 2,500 توکن هزینه دارد. مهارت در همان نشست 40 توکن و در یک نشست از هر ده نشستی که در آن فعال می‌شود، 3,000 توکن هزینه دارد. دو ردیف آخر مربوط به یک سرور مشابه در دو حالت با جستجوی ابزار روشن و خاموش است: 500 توکن در مقابل 4,500. این شکاف، دلیلی است که توصیه‌های قدیمی درباره تورم context در MCP همچنان دست‌به‌دست می‌شود.

از اکتبر 2026، Claude Code از جستجوی ابزار در مدل‌های Claude Opus 4، Sonnet 4، Haiku 4.5 و نسخه‌های جدیدتر، و همچنین در Opus 4.5، Sonnet 4.5، Haiku 4.5 و نسخه‌های جدیدتر در پلتفرم Agent گوگل کلود استفاده می‌کند. در مدل‌های قدیمی‌تر و در استقرار‌های Microsoft Foundry که روی Azure میزبانی می‌شوند، هر ابزار MCP صرف‌نظر از تنظیمات شما، در ابتدا بارگذاری می‌شود. با تنظیم ANTHROPIC_BASE_URL روی یک درگاه LLM، جستجوی ابزار از نسخه v2.1.304 به‌صورت پیش‌فرض فعال است؛ نسخه‌های قدیمی‌تر در آنجا آن را خاموش می‌کردند مگر اینکه خودتان انتخاب می‌کردید. از نسخه v2.1.305، Claude Code می‌تواند پس از یک 400 یا 422، درخواست درگاه را بدون جستجوی ابزار دوباره امتحان کند و در صورت موفقیت‌آمیز بودن آن تلاش مجدد، ابزارها را در ابتدا بارگذاری کند. برای کنترل آن، ENABLE_TOOL_SEARCH را تنظیم کنید: false هر طرح‌واره را در ابتدا بارگذاری می‌کند، true آن‌ها را با همان مدل و بازگشت‌های استقرار (fallback) مشابه حالت تنظیم‌نشده به تعویق می‌اندازد، و auto آن‌ها را در ابتدا بارگذاری می‌کند تا زمانی که مجموع تعاریف آن‌ها کمتر از 10% پنجره context باشد، سپس حتی اگر مجموع آن‌ها بعداً به زیر آن حد برسد، جستجوی ابزار را روشن نگه می‌دارد. سروری که با "alwaysLoad": true پیکربندی شده باشد، صرف‌نظر از ENABLE_TOOL_SEARCH، ابزارهای خود را در ابتدا بارگذاری می‌کند.

# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claude

پرسش تعیین‌کننده: آیا داده‌ها بین دفعات اجرا تغییر می‌کنند؟

این پرسش را ابتدا بپرسید، زیرا یک گزینه را به‌طور کامل حذف می‌کند. اگر agent نیاز دارد چیزی را بخواند یا بنویسد که ممکن است در مراجعه بعدی متفاوت باشد، شما به یک سرور نیاز دارید. یک سیستم ردیابی خطا (issue tracker)، یک پایگاه داده، یک داشبورد مانیتورینگ یا API داخلی خودتان. نوشتن آن روی کاغذ کمکی نمی‌کند، زیرا آنچه نوشته‌اید در لحظه‌ای که شخص دیگری رکورد را ویرایش می‌کند، قدیمی می‌شود. کدبیس (codebase) شما نیز در این لیست قرار می‌گیرد، زیرا ساختار آن با هر commit تغییر می‌کند؛ این همان دلیلی است که پشت ارائه یک نقشه تحلیل‌شده از مخزن به agent از طریق MCP وجود دارد، به‌جای اینکه ساختار را در فایلی توصیف کنید که به‌مرور زمان قدیمی می‌شود.

اگر پاسخ همچنان پس از 6 هفته و بدون اینکه کسی آن را نگهداری کند درست باقی بماند، شما به یک skill نیاز دارید. یک چک‌لیست انتشار. یک رویه مهاجرت. شکل پاسخ‌های خطای شما. نحوه نوشتن تست‌ها در این مخزن. یک skill فایلی در git است. هیچ پورتی ندارد، هیچ پردازشی ندارد و هیچ حالت شکستی جز «اشتباه بودن» ندارد که آن هم با code review قابل شناسایی است.

اگر این یک حقیقت است که باید برای کارهایی که هنوز به آن‌ها فکر نکرده‌اید اعمال شود، آن را در فایل rules قرار دهید. Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. هر کدام در یک خط. لحظه‌ای که یک ورودی به مراحل مختلف تبدیل می‌شود، دیگر یک حقیقت نیست و به یک رویه تبدیل شده است، بنابراین باید به یک skill منتقل شود.

چه زمانی یک فایل قوانین کافی است

فایل‌های قوانین از چندین مکان بارگذاری می‌شوند، از کلی‌ترین تا جزئی‌ترین: یک فایل سیاست مدیریت‌شده، ~/.claude/CLAUDE.md شخصی شما، ./CLAUDE.md یا ./.claude/CLAUDE.md پروژه، و یک ./CLAUDE.local.md که در gitignore قرار دارد. تمام فایل‌های یافت‌شده به‌جای بازنویسی یکدیگر، با هم ترکیب (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

لینک نمادین (symlink) در صورت موفقیت چیزی چاپ نمی‌کند. یک نشست (session) را شروع کنید، /context all را اجرا کنید و تأیید کنید که CLAUDE.md در بخش Memory files ظاهر می‌شود. اگر در آنجا فهرست نشده باشد، عامل (agent) هرگز آن را ندیده است و هیچ تغییر متنی کمکی نخواهد کرد. زمانی که می‌خواهید خطوط اختصاصی Claude را نیز داشته باشید، از فرم import استفاده کنید و آن‌ها را زیر دستور import قرار دهید.

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

یک دام در اینجا وجود دارد. دستورات @path زمینه (context) را ذخیره نمی‌کنند. فایل واردشده (imported) در زمان راه‌اندازی، در کنار فایلی که به آن ارجاع داده است، تا عمق چهار سطح باز و بارگذاری می‌شود. تقسیم یک فایل قوانین 600 خطی به شش import، آن را برای انسان‌ها سازماندهی می‌کند و هزینه توکن را دقیقاً به اندازه صفر تغییر می‌دهد. خواندن قراردادهای پشت AGENTS.md و همزاد انسانی آن پیش از نهایی کردن ساختار، ارزشمند است.

آنچه هزینه را کاهش می‌دهد، .claude/rules/ با فیلد paths است. یک فایل قوانین که دارای frontmatter از نوع paths باشد، تنها زمانی بارگذاری می‌شود که عامل با فایلی که با یکی از الگوها مطابقت دارد، تعامل داشته باشد.

---
paths:
  - "src/api/**/*.ts"
---

# API rules

- Every endpoint validates its input.
- Use the standard error response shape.

یک قانون بدون فیلد paths در زمان راه‌اندازی با همان اولویت .claude/CLAUDE.md بارگذاری می‌شود. بنابراین الگوی کاری مناسب، استفاده از قوانین کوتاه بدون شرط، به علاوه یک لیست paths برای هر چیزی است که فقط در یک دایرکتوری خاص اهمیت دارد.

زمانی که به یک مهارت نیاز دارید

یک مهارت، دایرکتوری‌ای است که یک SKILL.md در داخل آن قرار دارد. مهارت‌های شخصی در ~/.claude/skills/<name>/SKILL.md قرار می‌گیرند و برای تمام پروژه‌های موجود در سیستم شما اعمال می‌شوند. مهارت‌های پروژه در .claude/skills/<name>/SKILL.md قرار دارند، همراه با مخزن (repository) جابه‌جا می‌شوند و می‌توانند مانند هر فایل دیگری در یک pull request بررسی شوند.

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 تنها قسمتی از آن فایل است که پیش از اجرای مهارت در context قرار می‌گیرد، بنابراین دو وظیفه دارد. این بخش مشخص می‌کند که مهارت چه کاری انجام می‌دهد و چه زمانی باید از آن استفاده کرد. توصیفی مانند "کمک به استقرارها" (Helps with deploys) هیچ اطلاعاتی برای تطبیق با درخواست به مدل نمی‌دهد، بنابراین مهارت بی‌سروصدا هرگز اجرا نمی‌شود و شما به این نتیجه می‌رسید که مهارت‌ها کار نمی‌کنند.

نام دایرکتوری به دستور تبدیل می‌شود، بنابراین مثال بالا به شما /summarize-changes را می‌دهد. در یک مهارت شخصی یا پروژه‌ای، یک name در frontmatter که با نام دایرکتوری متفاوت باشد، دستوری را تعیین می‌کند که در منوی / نمایش داده می‌شود، مگر اینکه دستور دیگری قبلاً از آن نام استفاده کرده باشد؛ در این صورت، نام دایرکتوری همچنان مهارت را فراخوانی می‌کند.

هنگامی که یک مهارت فراخوانی می‌شود، محتوای رندرشدهٔ آن به عنوان یک پیام واحد وارد گفتگو شده و تا پایان نشست (session) در آنجا باقی می‌ماند. Claude Code فایل را در نوبت‌های بعدی دوباره نمی‌خواند. دستورالعمل‌های دائمی بنویسید نه مراحل یک‌بارمصرف، و بدنهٔ آن را مختصر نگه دارید، زیرا از آن لحظه به بعد، هر خط هزینهٔ تکرارشونده‌ای برای هر درخواست خواهد داشت. پس از فشرده‌سازی خودکار (auto-compaction)، Claude Code آخرین فراخوانی هر مهارت را دوباره ضمیمه می‌کند و 5000 توکن اول هر کدام را در یک بودجهٔ ترکیبی 25000 توکنی حفظ می‌کند. اگر چندین مهارت بزرگ را در یک نشست فراخوانی کنید، قدیمی‌ترین آن‌ها کاملاً حذف می‌شوند؛ به همین دلیل است که یک مهارت ممکن است پس از یک گفتگوی طولانی دیگر تأثیری نداشته باشد. آن را دوباره فراخوانی کنید تا بازگردد. یک مهارتِ مبتنی بر رویه‌های سنگین، این مبادله را ملموس می‌کند: مهارت unlazy و روش Depth Tree آن، برای داشتن عاملی که کار را زودتر از موعد تمام‌شده اعلام نکند، از context واقعی برای گیت‌ها و یک فایل برنامه‌ریزی استفاده می‌کند. هنگامی که یک رویهٔ مشابه برای بیش از یک codebase اعمال می‌شود، به‌جای کپی کردن فایل در جاهای مختلف، یک مهارت را بین چندین مخزن به اشتراک بگذارید.

چه زمانی به یک MCP server نیاز دارید

افزودن یک سرور تنها با یک دستور انجام می‌شود و نوع 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 را از خط فرمانی که سرور شما را اجرا می‌کند، تفکیک می‌کند. اگر آن را حذف کنید، یک --port 8080 که برای سرور در نظر گرفته شده، به عنوان گزینه‌ای برای claude mcp add تفسیر می‌شود و در نتیجه با خطا مواجه خواهید شد.

claude mcp list
claude mcp get notion

claude mcp add با یک خط Added ... تأیید می‌شود که تنها نشان می‌دهد پیکربندی در دیسک ذخیره شده است. claude mcp list دستوری است که واقعیت را به شما نشان می‌دهد، زیرا وضعیت سلامت هر سرور را چاپ می‌کند: ✔ Connected، ! Needs authentication، یا ✘ Failed to connect. وضعیت failure به این معناست که Claude Code نتوانسته به آن سرور متصل شود، نه اینکه دستور list دچار مشکل شده باشد. در طول یک session، دستور /mcp همان وضعیت را به ازای هر سرور به همراه تعداد ابزارها نمایش می‌دهد.

هر فراخوانی به یک MCP server مستقل است و هر آنچه نیاز دارد را به همراه می‌برد؛ به همین دلیل است که یک MCP server درخواست قبلی شما را به خاطر نمی‌سپارد. این یک انتخاب طراحی است که پیامد آن بر عهده شماست: هر وضعیتی (state) که ارزش نگهداری داشته باشد، باید در پشت سرور، درون یک پایگاه داده یا یک فایل ذخیره شود و این چیزی است که اکنون شما مدیریت آن را بر عهده دارید.

سرور MCP فرآیندی است که باید آن را اجرا کنید

این هزینه‌ای است که مقایسه‌های فروشندگان از آن غافل می‌شوند. یک Skill در واقع یک فایل است. اما سرور MCP نرم‌افزاری است که در جایی اجرا می‌شود و وقتی آن «جا» سرور مجازی (VPS) شما باشد، مسئولیت پایداری (uptime) آن با شماست.

سرور stdio حالت کم‌هزینه است. Claude Code هنگام شروع نشست (session)، آن را به عنوان یک فرآیند فرزند (child process) ایجاد می‌کند و با پایان نشست، آن فرآیند نیز خاتمه می‌یابد. در این حالت نیازی به مانیتورینگ یا وصله‌گذاری طبق زمان‌بندی جداگانه نیست. اما یک سرور HTTP از راه دور، سرویسی با طول عمر بالاست و به همان چیزهایی نیاز دارد که هر سرویس پایداری به آن محتاج است؛ که اولین قدم آن، داشتن یک کاربر اختصاصی است. کاربر mcp را که unit زیر با آن اجرا می‌شود ایجاد کنید و دایرکتوری سرور را به آن اختصاص دهید:

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.target
sudo systemctl daemon-reload
sudo systemctl enable --now notes-mcp
systemctl is-active notes-mcp
journalctl -u notes-mcp -n 50 --no-pager

systemctl is-active باید مقدار active را چاپ کند. اگر failed را چاپ کرد، لاگ‌های journal دلیل آن را در خود دارند؛ در اولین اجرا، این خطا تقریباً همیشه به دلیل متغیرهای محیطی (environment variable) گمشده یا پورتی است که توسط سرویس دیگری اشغال شده است. Restart=on-failure در اینجا اختیاری نیست، زیرا سرور MCP در صورت کرش کردن، خودش را اعلام نمی‌کند. شما زمانی متوجه می‌شوید که agent به شما بگوید قادر به خواندن سیستم مدیریت وظایف (issue tracker) شما نیست.

فرآیند را به 127.0.0.1 متصل کنید و یک reverse proxy با TLS (امنیت لایه انتقال) در مقابل آن قرار دهید. سرور MCP که به دیتابیس شما دسترسی دارد و روی یک پورت عمومی بدون احراز هویت پاسخ می‌دهد، در واقع دیتابیس شما را در دسترس عموم قرار داده است. اجرای سرور MCP روی VPS به درستی به مباحث پروکسی، گواهی‌ها و فایروال می‌پردازد.

سپس کارهای تکراری را صادقانه محاسبه کنید. این سرویس به‌روزرسانی‌های امنیتی خود را طبق زمان‌بندی خودش دریافت می‌کند که مستقل از agent متصل به آن است. توکن OAuth آن منقضی می‌شود و claude mcp list در لحظه‌ای نامناسب شروع به چاپ ! Needs authentication می‌کند. اعتبارنامه‌ها (credentials) در یک فایل پیکربندی یا یک هدر Authorization قرار می‌گیرند، بنابراین به همان مراقبتی نیاز دارند که هر secret دیگری نیاز دارد؛ موضوعی که خود بحثی مفصل است: دور نگه داشتن secretها از دسترس AI agent. هیچ‌کدام از این کارها برای یک Skill وجود ندارد.

پیش از ساخت، آن را با جایگزین‌هایش بسنجید. اگر داده‌های پشت سرور پیشنهادی شما حدوداً هر سه ماه یک‌بار تغییر می‌کنند، یک Skill که به agent می‌گوید کجا را نگاه کند و فیلدها چه معنایی دارند، ارزان‌تر از سرویسی است که باید همیشه آن را زنده نگه دارید.

نحوه محاسبه هزینه کانتکست (context) خود

حدس و گمان را کنار بگذارید و /context all را در یک نشست اجرا کنید. این دستور جزئیات فعلی را چاپ می‌کند: پرامپت سیستم، فایل‌های حافظه، ابزارها و سرورهای MCP، به همراه وزن توکن هر کدام.

دو مورد را بررسی کنید. در بخش Memory files، تأیید کنید که تمام فایل‌های قوانین (rules) که انتظار دارید، فهرست شده باشند. یک فایل گمشده برای ایجنت نامرئی است، بنابراین وقتی دستورالعمل‌ها نادیده گرفته می‌شوند، این اولین چیزی است که باید بررسی کنید. اگر فایل فهرست شده است و قانون همچنان نادیده گرفته می‌شود، علت کاملاً در جای دیگری است و بررسی دلایلی که باعث می‌شود ایجنت از دستوری که می‌بیند عبور کند، پیش از بازنویسی مجدد آن خط، ارزشمند است. سپس به هزینه سرورهای خود نگاه کنید. اگر سروری که دو بار در ماه از آن استفاده می‌کنید یکی از بزرگترین ردیف‌های آن فهرست است، آن را در /mcp خاموش کنید و برای نشست‌هایی که به آن نیاز دارند، دوباره روشن کنید. پیکربندی در هر دو حالت حفظ می‌شود.

اگر کش اکتشاف (discovery cache) برای حساب شما فعال باشد، سرور راه دوری که قبلاً از آن استفاده کرده‌اید ممکن است وضعیتی مانند cached 2h ago · connects on first use · 5 tools را نشان دهد. این بدان معناست که Claude Code فهرست ابزارها را از یک نشست قبلی خوانده است به جای اینکه در زمان راه‌اندازی متصل شود، و اولین باری که یک ابزار فراخوانی شود، متصل خواهد شد. ابزارها از همان اولین پیام شما در دسترس هستند، بنابراین نیازی به اصلاح چیزی نیست. کش به‌صورت پیش‌فرض غیرفعال است مگر اینکه عرضه تدریجی آن را برای شما فعال کرده باشد: MCP_DISCOVERY_CACHE=0 را تنظیم کنید تا همه سرورها در زمان راه‌اندازی متصل بمانند، یا 1 را برای فعال کردن کش تنظیم کنید. برای درک کلی‌تر، مدیریت پنجره کانتکست Claude Code توضیح می‌دهد که چه چیزی پس از فشرده‌سازی باقی می‌ماند، و هزینه واقعی آن توکن‌ها برای شما این اعداد را به پول تبدیل می‌کند.

چرا مهارت من هرگز اجرا نمی‌شود؟

دلیل معمول، description است. این تنها متنی است که پیش از اجرای مهارت در زمینه (context) قرار دارد؛ بنابراین اگر موقعیت مورد نظر را توصیف نکند، هیچ تطابقی صورت نمی‌گیرد. ماشه (trigger) را به این صورت در جمله بنویسید: "Use when the user asks what changed, wants a commit message, or asks to review their diff." توصیفات مبهم بدون هیچ پیامی شکست می‌خورند و همین موضوع تشخیص مشکل را دشوار می‌کند.

دلیل دوم، غلط تایپی در frontmatter است که در Claude Code نیز بدون هیچ هشداری رخ می‌دهد. نام فیلد باید دقیقاً مطابقت داشته باشد (شامل خط‌تیره‌ها) و Claude Code فیلدی را که تشخیص ندهد، بدون گزارش خطا نادیده می‌گیرد. نسخه دقیق‌تر خطا فقط زمانی ظاهر می‌شود که مهارت را بسته‌بندی کنید یا آن را در claude.ai یا Skills API بارگذاری کنید؛ چرا که این پلتفرم‌ها فیلدهای کمتری را می‌پذیرند و بقیه را مستقیماً رد می‌کنند:

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

دلیل سوم، موقعیت مکانی است. مهارت‌های پروژه از .claude/skills/ در دایرکتوری کاری شما و تمام دایرکتوری‌های والد تا ریشه مخزن بارگذاری می‌شوند. مهارت‌های موجود در دایرکتوری‌های تودرتوی پایین‌تر از جایی که شروع کرده‌اید، هنگام راه‌اندازی بارگذاری نمی‌شوند. این مهارت‌ها اولین باری که عامل (agent) فایلی را در آن زیردایرکتوری بخواند یا ویرایش کند ظاهر می‌شوند؛ بنابراین تا آن زمان، تکمیل خودکار ندارند و با نام نیز قابل فراخوانی نیستند.

معادل MCP برای این شکستِ بی‌صدا، یک ورودی .mcp.json با یک url و بدون type است. Claude Code هر ورودی بدون type را به عنوان یک سرور stdio می‌خواند، بنابراین از آن ورودی عبور کرده و گزارش می‌دهد:

MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry

استفاده همزمان از هر سه مورد

این مکانیزم‌ها برای تصاحب یک جایگاه با هم رقابت نمی‌کنند. یک پیکربندی کارآمد از هر کدام در جایی استفاده می‌کند که هزینه کمتری دارد. فایل rules شامل چند خط محدود است که در همه جا صادق هستند. Skills رویه‌ها را در خود نگه می‌دارند و تنها زمانی بارگذاری می‌شوند که کاربرد داشته باشند. یک سرور MCP، و گاهی دو سرور، سیستم‌هایی را متصل می‌کنند که محتوای آن‌ها را نمی‌توان از پیش پیش‌بینی کرد. اگر هنوز در حال ساخت مدل ذهنی خود از اولین مورد هستید، اینکه یک agent skill واقعاً چیست جزئیات مربوط به فرمت آن را پوشش می‌دهد.

یک آزمایش، اکثر بحث‌ها درباره اینکه هر چیزی به کجا تعلق دارد را حل می‌کند. آن را حذف کنید، یک نشست (session) جدید شروع کنید و وظیفه را به agent بسپارید. اگر agent صرفاً کندتر عمل می‌کند، آن مورد متعلق به یک skill بوده است. اگر agent با اطمینان پاسخ اشتباه می‌دهد، آن مورد متعلق به فایل rules بوده است. اگر agent اصلاً نمی‌تواند اطلاعات را دریافت کند، شما به آن سرور نیاز داشته‌اید و اکنون برای سرپا نگه داشتن آن سرور نیز به یک برنامه نیاز دارید.

FAQ

آیا باید یک skill بنویسم یا یک MCP server راه‌اندازی کنم؟

تصمیم‌گیری بر این اساس است که آیا اطلاعات بین دو فراخوانی تغییر می‌کند یا خیر. اگر عامل (agent) باید وضعیت لحظه‌ای را بخواند که ممکن است توسط شخص دیگری تغییر کند، مانند یک issue tracker، پایگاه داده یا داشبورد، به یک MCP server نیاز دارید؛ زیرا هر چیزی که یادداشت کنید، به محض تغییر رکورد، قدیمی می‌شود. اگر می‌توانید پاسخ را یک بار بنویسید و تا 6 هفته دیگر همچنان صحیح باشد، یک skill بنویسید. این skill یک فایل در git است که هیچ فرآیندی برای اجرا، هیچ پورتی برای باز کردن و هیچ برنامه زمانی برای وصله (patch) ندارد، بنابراین هر زمان که ممکن باشد، گزینه ارزان‌تری است.

آیا MCP serverها همچنان پنجره کانتکست (context window) من را پر می‌کنند؟

بسیار کمتر از گذشته. قابلیت جستجوی ابزار (tool search) به‌طور پیش‌فرض در نسخه فعلی Claude Code فعال است، بنابراین در شروع نشست فقط نام ابزارها و فیلد دستورالعمل‌های سرور بارگذاری می‌شوند و شمای کامل (full schemas) زمانی فراخوانی می‌شود که Claude آن‌ها را جستجو کند. این مورد اکنون شامل نشست‌های پشت یک LLM gateway که از طریق ANTHROPIC_BASE_URL تنظیم شده‌اند نیز می‌شود (از نسخه v2.1.304 به بعد). بارگذاری اولیه (upfront loading) همچنان با ENABLE_TOOL_SEARCH=false، برای سروری که روی "alwaysLoad": true تنظیم شده، در مدل‌های قدیمی‌تر از Claude Opus 4 و Sonnet 4 (قدیمی‌تر از نسل 4.5 در پلتفرم عامل Google Cloud) و در استقرار‌های Microsoft Foundry روی Azure رخ می‌دهد. دستور /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 را اجرا کنید، یا @AGENTS.md را در خط اول یک CLAUDE.md قرار دهید و دستورالعمل‌های اختصاصی Claude را زیر آن بنویسید. سپس یک نشست را شروع کرده و /context all را اجرا کنید تا تأیید کنید که CLAUDE.md در زیر فایل‌های Memory نمایش داده می‌شود.

چرا skill من در میانه یک نشست دیگر اثری ندارد؟

دلیل معمول آن فشرده‌سازی خودکار (auto-compaction) است. هنگامی که مکالمه خلاصه‌سازی می‌شود، Claude Code آخرین فراخوانی هر skill را دوباره ضمیمه می‌کند و 5000 توکن اول از هر کدام را در یک بودجه کلی 25000 توکنی برای همه آن‌ها نگه می‌دارد. این بودجه از آخرین skill فراخوانی‌شده پر می‌شود، بنابراین اگر چندین skill بزرگ را فراخوانی کرده باشید، موارد قدیمی‌تر کاملاً حذف می‌شوند. برای بازیابی محتوای کامل، skill را دوباره فراخوانی کنید.

چگونه از بارگذاری یک فایل قوانین طولانی در هر نشست جلوگیری کنم؟

بخش‌هایی که فقط گاهی اوقات اهمیت دارند را به فایل‌های .claude/rules/ با یک فیلد paths در frontmatter آن‌ها منتقل کنید تا هر کدام فقط زمانی بارگذاری شوند که عامل با یک فایل منطبق درگیر شود. تقسیم فایل به importهای @path کمکی نمی‌کند، زیرا فایل‌های import شده در زمان راه‌اندازی، در کنار فایلی که به آن‌ها ارجاع داده، بسط و بارگذاری می‌شوند. هر چیزی که یک رویه چندمرحله‌ای است و نه یک واقعیت ثابت، باید به یک skill تبدیل شود، زیرا بدنه یک skill تا زمانی که فراخوانی نشود، هزینه‌ای ندارد.

آیا این مقاله مفید بود؟