SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

Agent skills, MCP servers 與 rules files 比較

解析 coding agent 三種上下文注入機制的成本差異。比較 rules files、skills 與 MCP servers 的 token 消耗與維護開銷,協助您根據專案需求選擇最佳方案。

Agent skills、MCP servers 與 rules files 的比較:簡短回答

Agent skills、MCP servers 與 rules files 都能為程式設計代理(coding agent)提供知識。請根據知識的用途進行選擇。MCP (Model Context Protocol) 適用於每次查看時可能變動的資料。Skill 適用於您今天寫下、六週後依然正確的程序。Rules file 則適用於在每個對話階段都必須遵守的少數事實。

這項選擇有其代價,而代價就是 context。代理不需要的指令每消耗一個 token,就代表讀取程式碼時可用的 token 減少一個。此外,由於整個 context window 會在每次請求時重新發送,這意味著您在每一輪對話中都要重複支付該 token 的成本。因此,真正重要的問題並非哪種機制「能」完成任務(大多數情況下三者皆可),而是哪一種機制在閒置時成本最低。

使用前先了解各自的成本

這三者會在不同時間載入,而載入時機就是全部差異所在。

無條件規則檔案會在啟動時載入,每個工作階段都會載入,不論是否相關,除非將其排除。Claude Code 會在每次對話開始時讀取啟動 CLAUDE.md 檔案,並在將內容注入前,移除程式碼區塊外的區塊層級 HTML 註解;超過 4 MiB 的檔案則會略過。claudeMdExcludes 也可以排除檔案,但受管理的政策檔案除外。文件建議每個檔案少於 200 行,因為較長的檔案會消耗更多上下文,且模型較不容易穩定遵循。這兩種影響方向相同,因此 900 行的規則檔案反而有害。

skill 會分兩個階段載入。啟動時,每個 SKILL.md frontmatter 中只有 description 行會進入上下文,讓模型知道該 skill 存在,以及大致適用的時機。skill 被呼叫時才會載入本文。因此,400 行的參考文件在真正需要前幾乎不會產生成本。

過去 MCP server 是成本最高的一項,這也是目前多數比較文章已經過時的原因。現在的 Claude Code 預設會啟用 tool search。工作階段開始時只會載入工具名稱與 server 的 instructions 欄位,完整的 JSON(JavaScript object notation)結構描述會延後到 Claude 搜尋這些工具時才載入。新增 server 不再一開始就消耗數千個 token。但它仍然會產生成本;在關閉 tool search 的設定中,所有成本仍會在一開始產生。

圖表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"
  }
]

這些是估算值,不是從你的電腦測得的數據。估算依據是各機制載入的文字大小,約每 4 個字元對應 1 個 token:200 行的規則檔案約有 10 KB 的 markdown,skill 描述約有 160 個字元,而公開 12 個工具的 server 約包含 18 KB 的結構描述和 2 KB 的 instructions 區塊。Claude Code 預設會將 server instructions 欄位,以及每個在啟動時載入的工具描述截短至 4,096 個字元;透過 tool search 載入的工具描述則截短至 16,384 個字元。在 v2.1.296 之前,較短的限制是 2,048 個字元;若設定 CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH,則會取代這兩項限制。即使設定該變數,部分由 Anthropic 託管的 MCP server 仍會將完整的 instructions 與描述傳送給 Claude,因此這些限制不是普遍適用的上限。下一節會說明如何讀取你自己的實際數據。

將前兩列放在一起閱讀。在不需要該規則檔案的工作階段中,它會消耗 2,500 個 token。skill 在同一個工作階段會消耗 40 個 token;在十個工作階段中有一個會觸發它的情況下,則會消耗 3,000 個 token。最後兩列是同一個 server 的兩種情況,分別代表開啟與關閉 tool search:500 個 token,對上 4,500 個 token。這項差距就是關於 MCP 上下文膨脹的舊建議至今仍在流傳的原因。

截至 2026 年 10 月,Claude Code 會在 Claude Opus 4、Sonnet 4、Haiku 4.5 及更新的模型上使用 tool search;在 Google Cloud 的 Agent Platform 上,則會在 Opus 4.5、Sonnet 4.5、Haiku 4.5 及更新的模型上使用。較早期的模型,以及託管於 Azure 的 Microsoft Foundry 部署,會在啟動時載入你設定的所有 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 會延後載入,並使用與未設定時相同的模型和部署備援;auto 會在工具定義總量低於上下文視窗的 10% 時於啟動時載入,達到該門檻後則持續使用 tool search,即使之後總量降到門檻以下。設定 "alwaysLoad": true 的 server 不論 ENABLE_TOOL_SEARCH 的值為何,都會在啟動時載入其工具。

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

決定性問題是:資料在每次呼叫之間是否會變動?

先提出這個問題,因為它能直接排除其中一個選項。如果代理程式需要讀取或寫入下次查詢時可能已經不同的內容,就需要伺服器。例如 issue tracker、資料庫、監控儀表板,或你自己的內部 API(application programming interface)。把內容寫下來沒有幫助,因為其他人編輯記錄後,你寫下的內容就會過時。你自己的程式碼庫也屬於這一類,因為其結構會隨每次 commit 變動。這也是應透過 MCP 提供代理程式剖析後的儲存庫對應圖,而不是將會逐漸過時的目錄結構描述在檔案中的原因。

如果六週後仍然正確,且不需要任何人維護,就應該使用 skill。例如 release checklist、migration procedure、錯誤回應的格式,或這個儲存庫要求的測試撰寫方式。skill 是 git 中的檔案。它沒有埠、沒有程序,除了內容錯誤之外也沒有其他失效模式,而程式碼審查可以捕捉這類錯誤。

如果這是一項必須套用到尚未想到的工作的單一事實,就應將它放入規則檔案。Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. 每項各占一行。當一個項目逐漸擴充成步驟時,它就不再是事實,而是程序,應該移至 skill。

規則檔案已足夠時

規則檔案會從多個位置載入,順序由範圍最廣到最具體:受管理的政策檔案、個人的 ~/.claude/CLAUDE.md、專案的 ./CLAUDE.md 或 ./.claude/CLAUDE.md,以及受 gitignore 排除的 ./CLAUDE.local.md。所有找到的檔案會串接起來,而不是彼此覆寫;越接近工作目錄的檔案越晚讀取。

從 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 專用的內容,請改用匯入形式,並將這些內容放在匯入指示下方。

@AGENTS.md

## Claude Code

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

這裡有一個常見陷阱。@path 匯入不會節省內容脈絡。匯入的檔案會在啟動時,與引用它的檔案一併展開並載入,最多深入四層。將 600 行的規則檔案拆成六個匯入檔案,對人類而言較容易整理,但 token 成本完全不變。決定配置方式前,值得先閱讀 AGENTS.md 及其面向人類的對應檔案所遵循的慣例。

真正能降低成本的是搭配 paths 欄位使用 .claude/rules/。包含 paths frontmatter 的規則檔案,只有在代理程式處理符合其中一個模式的檔案時才會載入。

---
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,會隨儲存庫一起保存,也能像其他檔案一樣在 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 的部分,因此同時負責兩項工作。它說明技能的功能,也說明何時應使用技能。如果描述寫成「協助部署」,模型就沒有可用來比對請求的資訊,因此技能不會自動觸發,最後你會以為技能無法運作。

目錄名稱會成為 command,因此上面的範例會提供 /summarize-changes。在個人技能或專案技能中,如果 frontmatter 的 name 與目錄名稱不同,就會設定 / menu 顯示的 command;但如果已有其他 command 使用該名稱,則不會套用,目錄名稱仍可用來呼叫技能。

呼叫技能後,轉譯後的內容會以單一訊息加入對話,並在整個 session 中保留。Claude Code 不會在後續回合重新讀取該檔案。請撰寫持續適用的指示,而不是只執行一次的步驟,並讓內文保持精簡,因為從這一刻起,每一行都會在每次請求中產生持續的 context 成本。自動壓縮後,Claude Code 會重新附加每個技能最近一次的呼叫內容,並將每個技能的前 5,000 個 token 納入合計 25,000 個 token 的上限。若在同一個 session 中呼叫多個大型技能,最早的技能會完全移除,因此長時間對話後,某個技能可能看似不再生效。再次呼叫該技能即可恢復。程序繁多的技能會具體呈現這項取捨:unlazy 技能及其 Depth Tree 方法會將實際的 context 用於檢查關卡與計畫檔案,換取一個不會過早宣告工作完成的 agent。如果相同程序適用於多個 codebase,請在多個 repository 之間共用一個技能,不要複製檔案。

何時需要 MCP 伺服器

新增伺服器僅需執行單一指令,其運作形式取決於傳輸方式。

# 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。若顯示失敗狀態,代表 Claude Code 無法連接該伺服器,而非列出指令本身故障。在工作階段中,/mcp 可提供相同的伺服器檢視資訊,並包含工具數量。

每次對 MCP 伺服器的呼叫皆為獨立運作並攜帶所需資訊,這正是 MCP 伺服器不會記憶先前請求的原因。這是一項設計選擇,但也帶來了後續影響:任何需要保留的狀態都必須儲存在伺服器後端,例如資料庫或檔案中,而這些資源現在由您負責維護。

MCP server 是必須執行的程序

以下是供應商比較中省略的成本。skill 是檔案。MCP server 是在某處執行的軟體;如果這個位置是你的 VPS(virtual private server),你就必須負責它的可用性。

stdio server 是成本較低的情況。Claude Code 會在工作階段開始時將它以子程序啟動,工作階段結束時程序也會終止。不需要監控,也不需要依照自己的排程套用修補程式。遠端 HTTP server 則是長時間執行的服務,具備所有長時間執行服務的需求,首先就需要專用的使用者。建立下方 unit 執行時所使用的 mcp 使用者,並將 server 的目錄指定給它:

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 中會記錄原因;首次執行時,幾乎都是缺少環境變數,或連接埠已被其他程序繫結。這裡不能省略 Restart=on-failure,因為當 MCP server 當機時,不會主動通報。你必須等到 agent 告訴你無法讀取 issue tracker,才會發現問題。

將程序繫結至 127.0.0.1,並在前方使用具備 TLS(transport layer security)的 reverse proxy。能連線至資料庫,卻未經驗證就透過公開連接埠回應的 MCP server,就等於將資料庫公開到網際網路。在 VPS 上執行 MCP server 詳細說明 proxy、憑證與防火牆設定。

接著,務實計算持續性工作。這項服務會依照自己的排程套用安全性更新,與連線至它的 agent 無關。它的 OAuth token 會過期,而 claude mcp list 會在不方便的時間開始輸出 ! Needs authentication。它的認證資訊會放在設定檔或 Authorization 標頭中,因此需要比照其他 secret 妥善管理;這本身就是另一個完整主題:避免 AI agent 讀取 secrets。skill 則完全不需要這些工作。

建置之前,先與替代方案比較。如果建議的 server 背後資料大約每季才變更一次,使用 skill 告訴 agent 應查找的位置與欄位意義,會比維持服務持續運作更省成本。

如何衡量自己的內容成本

不要再估算,直接在工作階段中執行 /context all。它會列出目前的分解結果:系統提示、記憶體檔案、工具和 MCP 伺服器,以及各項目的 token 權重。

檢查兩件事。在 Memory files 下,確認列出所有預期的規則檔案。代理程式看不到未列出的檔案,因此當指示未被遵循時,首先應排除這個原因。如果檔案已列出,但規則仍被跳過,原因就完全在其他地方;在再次改寫該行之前,值得先逐一檢查代理程式看得到指示卻略過它的原因。接著查看伺服器的成本。如果某個每月只使用兩次的伺服器,在清單中卻占用最大的項目之一,請在 /mcp 中將它停用,並在需要的工作階段重新啟用。無論是否停用,設定都會保留。

如果帳戶已啟用 discovery cache,曾經使用過的遠端伺服器可能會顯示 cached 2h ago · connects on first use · 5 tools 之類的狀態。這表示 Claude Code 讀取了先前工作階段的工具清單,而不是在啟動時連線;第一次呼叫工具時才會建立連線。工具從第一則訊息起即可使用,因此不需要修正任何設定。除非逐步推出機制已為你的帳戶啟用,否則快取預設為關閉:設定 MCP_DISCOVERY_CACHE=0,讓所有伺服器都在啟動時建立連線;或設定 1,啟用快取。如需了解完整情況,管理 Claude Code 內容視窗說明壓縮後哪些內容仍會保留,而這些 token 實際會產生多少成本則會將數字換算成金額。

為什麼我的 skill 永遠不會觸發?

通常原因是 description。在 skill 執行前,context 中只有這段文字,因此如果其中沒有指明情境,就不會有任何符合項目。請將觸發條件寫進句子中:「當使用者詢問有哪些變更、要求撰寫 commit message,或要求檢查 diff 時使用。」描述過於模糊時會靜默失敗,因此很難察覺。

第二個原因是 frontmatter 拼寫錯誤;在 Claude Code 中,這個問題同樣會靜默發生。欄位名稱必須完全相符,包括連字號;Claude Code 遇到無法辨識的欄位時會直接忽略,不會回報錯誤。只有在封裝 skill,或上傳至 claude.ai 或 Skills API 時,才會出現明確錯誤;這些平台接受的欄位較少,會直接拒絕其他欄位:

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

第三個原因是位置。Project skills 會從工作目錄中的 .claude/skills/ 載入,並一路搜尋每個父目錄,直到 repository root 為止。位於啟動位置下方巢狀目錄中的 skills 不會在啟動時載入。只有當 agent 第一次讀取或編輯該子目錄中的檔案時,這些 skills 才會出現;在此之前,它們不會出現在自動完成中,也無法依名稱叫用。

MCP 對應的靜默失敗,是包含 url 且沒有 type 的 .mcp.json 項目。Claude Code 會將沒有 type 的項目視為 stdio server,因此會略過該項目並回報:

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

同時使用這三種機制

這些機制並非互斥。一套有效的架構會在各自最合適的環節運用它們。rules 檔案僅包含少數適用於所有情境的通用規則。Skills 則封裝具體程序,且僅在適用時載入。MCP server(通常為一個,偶爾為兩個)負責連接那些內容無法預測的系統。若您仍在建構對前者的認知模型,agent skill 的實際定義 一文詳細說明了其格式。

一項測試即可解決大多數關於歸屬權的爭議:刪除該項目,啟動一個全新的 session,並將任務交給 agent。如果 agent 只是執行速度變慢,則它屬於 skill;如果 agent 表現出自信但錯誤的結果,則它屬於 rules 檔案;如果 agent 完全無法取得資訊,則您需要一個 server,且現在還需要一套維護該 server 運作的計畫。

FAQ

我應該撰寫 skill,還是架設 MCP server?

請根據資訊是否會在每次叫用之間變更來決定。如果 agent 必須讀取其他人可以編輯的即時狀態,例如 issue tracker、database 或 dashboard,就需要 MCP server,因為只要記錄變更,寫下的內容就會過時。如果答案寫下來後,6 weeks 內仍然正確,請撰寫 skill。skill 是 git 中的檔案,不需要執行程序、暴露連接埠或安排修補程式,因此只要可行,這就是成本較低的選項。

MCP server 還是會填滿我的 context window 嗎?

比過去少很多。目前的 Claude Code 預設啟用 tool search,因此工作階段開始時只會載入工具名稱與 server 的 instructions 欄位;Claude 搜尋工具時,才會取得完整 schema。從 v2.1.304 起,這也包含透過 ANTHROPIC_BASE_URL 設定的 LLM gateway 後方工作階段。以下情況仍會預先載入:使用 ENABLE_TOOL_SEARCH=false、server 設為 "alwaysLoad": true、使用早於 Claude Opus 4 和 Sonnet 4 的 model(在 Google Cloud's Agent Platform 上則是早於 4.5 generation),以及部署在 Azure 上的 Microsoft Foundry。執行 /context all 以確認目前屬於哪種情況,因為較早比較文章中的數字假設採用預先載入。

Claude Code 會讀取 AGENTS.md 嗎?

會,從 v2.1.277 起支援;但預設只有在工作目錄及其上層沒有 CLAUDE.md、.claude/CLAUDE.md 或 CLAUDE.local.md 時才會讀取。如果 repository 同時包含兩者,Claude 只會讀取 CLAUDE.md files,因此請讓其中一個指向另一個,不要保留兩份副本。執行 ln -s AGENTS.md CLAUDE.md 建立一般 symlink,或在 CLAUDE.md 的第一行加入 @AGENTS.md,再於下方加入 Claude 專用指示。接著啟動工作階段並執行 /context all,確認 CLAUDE.md 是否出現在 Memory files 下方。

為什麼我的 skill 在工作階段中途失效了?

通常是因為 auto-compaction。對話經過摘要後,Claude Code 會重新附加每個 skill 最近一次叫用的內容;每個 skill 最多保留前 5,000 tokens,所有 skill 合計上限為 25,000 tokens。它會從最近叫用的 skill 開始填入這項額度,因此如果叫用了數個大型 skill,較早的 skill 會完全被捨棄。再次叫用該 skill,即可還原其完整內容。

如何避免長篇 rules file 在每個工作階段載入?

將只在特定情況下需要的部分移至 .claude/rules/ files,並在其 frontmatter 中加入 paths field,使每個檔案只會在 agent 接觸符合條件的檔案時載入。將檔案拆分為 @path imports 沒有幫助,因為 imported files 會在啟動時展開並載入,與引用它們的檔案相同。凡是多步驟程序,而非持續適用的事實,都應改寫為 skill,因為 skill body 只有在叫用後才會產生成本。

這篇文章對您有幫助嗎?