註冊
Claude

Claude Code Skills 安裝在哪裏：個人、項目、嵌套、插件目錄與同名優先級

Claude Code 的 Skills 安裝目錄在哪、放個人還是放項目？按官方文檔講清七種存放位置、同名時誰生效、monorepo 裏嵌套 Skill 何時加載、改了要不要重啟，以及控制誰能調用的 frontmatter 字段和 skillOverrides 設定。

NNathaniel bigo··原創首發·AI 輔助撰寫
12 分鐘讀完
資料核對於 2026-10-11 · 依據官方文檔與公開資料整理 Plus 帳號
本文根據 Claude Code 官方文檔《Extend Claude with skills》整理，資料核對於 2026-10-11。Skill 的基本概念和安裝官方技能包的命令見《Claude Skills 是什麼、怎麼裝》，本文只講「放在哪、誰優先、誰能調用」。

適用於誰

  • 搜「claude code skills 安裝目錄」「claude code skills 安裝在哪裏」「claude code skills 目錄結構」的人；
  • 個人目錄和項目目錄裏有同名 Skill，不確定哪個在生效的人；
  • 在 monorepo 的子目錄裏放了 Skill 卻在選單裏找不到的人。

結論先說

  1. 自己用，放 ~/.claude/skills/技能名/SKILL.md；團隊共用，放倉庫裏的 .claude/skills/技能名/SKILL.md 並提交。
  2. 同名時：企業 > 個人 > 項目。個人目錄和項目目錄裏都有 deploy，/deploy 運行的是個人那一份。
  3. 插件裏的 Skill 帶命名空間（/插件名:技能名），不會和別的衝突。
  4. 改了不用重啟。Claude Code 會監視 Skill 目錄，新增、修改、刪除在當前會話內生效；唯一要手動處理的是會話中途新建了頂層 skills 目錄，這時運行 /reload-skills。
  5. 子目錄裏的嵌套 Skill 是懶加載的：Claude 第一次讀或改那個子目錄裏的文件時才出現。

一、七種存放位置

位置路徑在哪裏生效
企業託管設定目錄下的 .claude/skills/<skill-name>/SKILL.md組織部署到的所有機器、所有用戶
個人~/.claude/skills/<skill-name>/SKILL.md這台電腦上你的所有項目（不含 Cowork 和雲端會話）
項目.claude/skills/<skill-name>/SKILL.md在這個倉庫裏啟動的會話
嵌套<subdir>/.claude/skills/<skill-name>/SKILL.md在該子目錄或其下啟動的會話
附加目錄用 --add-dir 傳入的目錄裏的 .claude/skills/當次會話
插件<plugin>/skills/<skill-name>/SKILL.md啟用了該插件的地方，以 /plugin-name:skill-name 調用
claude.ai 帳號你在 claude.ai 上啟用的技能Cowork、雲端會話，以及用該帳號登入的終端會話

Windows 上的 ~ 指用戶主目錄。

兩個保留名稱：不要把 Skill 文件夾命名為 synced（那是 claude.ai 同步下來的技能所在的子目錄）；anthropic-skills 以及以 anthropic-skills: 開頭的名字在插件之外不會加載。

用符號連結指向別處的 Skill 文件夾也可以，Claude Code 會跟隨連結；多個位置指向同一個目標時只加載一次。

二、同名時誰生效

官方列出的規則：

  • 企業 > 個人 > 項目；
  • 項目根目錄的 Skill 和嵌套 Skill 都會加載。同名時 /deploy 運行根目錄那一份，嵌套的那一份用帶路徑的名字調用，如 /apps/web:deploy；
  • 插件 Skill 和非插件 Skill 都會加載，因為插件 Skill 帶命名空間；
  • Skill 和 .claude/commands/ 裏的同名文件：Skill 生效；
  • 自己的 Skill 和內置命令同名：在本地終端會話裏，Skill 會替換同名的內置命令，但不替換它的別名。官方舉的例子：項目裏一個叫 usage 的 Skill 會替換 /usage，而 /cost 仍然運行內置命令。

第一條容易和直覺相反：很多人以為項目級配置會覆蓋個人配置，Skill 這裏是個人優先。團隊 Skill 不生效時，先查自己的 ~/.claude/skills/ 裏有沒有同名的。

三、monorepo 和子目錄

  • 啟動時，Claude Code 從啟動目錄一路向上到倉庫根目錄，加載每一層的 .claude/skills/；
  • 啟動目錄之下的子目錄裏的 Skill 屬於嵌套 Skill，要等 Claude 第一次讀取或編輯該子目錄裏的文件才加載，在那之前 / 選單裏看不到；
  • 想提前加載，運行 /add-dir <subdir>；
  • 在連結的 git worktree 裏，向上查找到 worktree 根目錄為止。

--add-dir 傳入的目錄會加載其中的 .claude/skills/、.claude/commands/ 和 .claude/agents/。其中只有 skills 目錄會被持續監視，另外兩個改了需要重啟。官方還特別區分了一點：設定裏的 permissions.additionalDirectories 只是授予文件訪問權限，不會加載任何 Skill。

四、改了之後要不要重啟

情況需要做什麼
在已有的 skills 目錄裏新增、修改、刪除 Skill不用做，會話內自動生效（bare 模式除外）
會話中途新建了一個啟動時不存在的頂層 skills 目錄運行 /reload-skills；之後該目錄再有變化也要再運行一次
改的是插件裏的 hooks、.mcp.json、agents 等運行 /reload-plugins

注意一個細節：Skill 的內容在調用時加載進對話，之後不會重讀文件。所以你在會話中途改了某個已經調用過的 Skill，要重新調用一次才會用上新內容。

五、控制誰能調用

預設情況下，你可以用 /技能名 調用，Claude 也可以自動調用。兩個 frontmatter 字段可以改變這一點：

frontmatter你能調用Claude 能調用進入上下文的內容
（預設）能能描述始終在；調用時加載全文
disable-model-invocation: true能不能描述不進上下文
user-invocable: false不能能描述始終在
  • 有副作用的流程（部署、發佈、發消息）用 disable-model-invocation: true：只在你點名時運行，平時也不佔上下文；
  • 純背景知識用 user-invocable: false：不出現在 / 選單裏，只由 Claude 在需要時讀取。

手動調用的寫法也有講究：/deploy staging 放在消息開頭才會直接運行；寫成「go ahead and /deploy to staging」只是授權，不會直接運行。

六、不改文件也能調整：skillOverrides

別人寫的 Skill、插件之外同步來的 Skill，不方便改它的文件，可以在設定裏覆蓋可見性。輸入 /skills 打開列表，按空格在幾種狀態之間切換，按 Esc 儲存到 .claude/settings.local.json 的 skillOverrides。四個取值：

取值含義
"on"正常
"name-only"只列名稱，不列描述，用來節省上下文
"user-invocable-only"只能你手動調用
"off"關閉

官方註明插件裏的 Skill 不受這個設定影響，插件 Skill 在插件管理裏啟停。

七、Claude Code 額外支持的 frontmatter 字段

除了開放規範裏的字段，Claude Code 還認下面這些（節選自官方參考表）：

字段作用
name/ 選單裏的命令名，不寫時預設用目錄名
description做什麼、什麼時候用；不寫時取正文第一個非空行
when_to_use補充的觸發場景，在清單裏接在 description 後面
argument-hint自動補全時顯示的參數提示，如 [issue-number]
arguments命名的位置參數，正文裏用 $name 引用
allowed-tools調用這一輪裏免確認可用的工具
disallowed-toolsSkill 生效期間移除的工具
model / effort只對當前這一輪生效的模型和思考強度
context設為 fork 時在分叉出的子代理裏運行
agent配合 context: fork，指定子代理類型，預設 general-purpose
paths用 glob 限定只在處理匹配文件時才自動啟用
hooks調用時註冊、保留到會話結束的 Hook
shell正文裏內聯命令使用的 shell，bash（預設）或 powershell

官方說明：不認識的字段會被靜默忽略；布爾字段接受 true / false。這些擴展字段只在 Claude Code 裏有效，上載到 claude.ai 或通過 API 使用時，多出來的鍵會直接報錯，詳見《SKILL.md 怎麼寫》。

正文裏可用的變量包括 $ARGUMENTS（全部參數）、$0 $1（按位置，從 0 開始）、${CLAUDE_SKILL_DIR}（SKILL.md 所在目錄）、${CLAUDE_PROJECT_DIR}（項目根目錄）等。引用 Skill 自帶的腳本時用 ${CLAUDE_SKILL_DIR}，不要寫死絕對路徑。

八、舊的 .claude/commands 還能用嗎

能。官方說明：.claude/commands/deploy.md 和 .claude/skills/deploy/SKILL.md 都會創建 /deploy，已有的命令文件繼續有效。Skill 多出來的是三樣：可以帶支持文件、可以控制誰能調用、可以被 Claude 自動加載。自定義命令的寫法見《Claude Code 斜槓命令大全》。

常見問題

Q：個人 Skill 在 Cowork 或網頁版的 Claude Code 裏為什麼沒有？

官方表格寫明個人目錄的 Skill 只在這台電腦上生效，不含 Cowork 和雲端會話。那些環境用的是你 claude.ai 帳號上啟用的技能，或倉庫裏提交的項目 Skill。

Q：怎麼確認某個 Skill 到底加載沒有？

輸入 /skills 看列表，或者直接問 Claude 現在有哪些 Skill 可用。在列表裏卻不被自動調用，見《Skill 不觸發怎麼辦》。

Q：子代理裏能用 Skill 嗎？

能，方式不同。子代理定義裏的 skills 字段會在啟動時把列出的 Skill 全文預加載；沒列出的項目、個人、插件 Skill，子代理仍可以通過 Skill 工具發現並調用。子代理的配置見《Claude Code 子代理》。

Q：權限規則裏能限制 Skill 嗎？

可以。官方給的寫法：Skill(commit) 精確匹配某個 Skill，Skill(review-pr *) 匹配帶參數的調用，單寫 Skill 則針對整個工具。

參考資料

  • Extend Claude with skills（Claude Code 官方）：https://code.claude.com/docs/en/skills
  • Extend Claude Code（Claude Code 官方）：https://code.claude.com/docs/en/features-overview
需要開通或續費？Claude Pro 充值 →

Nathaniel 的更多內容

  1. 01

    AI 學習路線：零基礎從哪開始，6 個階段、每階段該讀哪幾篇教學（2026）

    AI 學習路線怎麼走？給零基礎的人一條循序漸進的路徑：先選一個助手用順，再學提問，再用進日常工作，按需學做圖做影片，守住私隱與版權，最後進階自動化和編程。每個階段都配了本站對應的教學。

    其他 AI 工具0
  2. 02

    AI 瀏覽器有哪些：Perplexity Comet、Opera Neon、Dia、Brave Leo 與 Edge Copilot 的官方說法對照

    AI 瀏覽器有哪些？按官方頁面整理 Perplexity Comet、Opera Neon、Dia、Brave Leo 和 Edge 裏的 Copilot：官方自述的定位、支持的平台、免費還是訂閱，以及 Gemini、Claude 的 Chrome 方案和已停用的 ChatGPT Atlas。

    其他 AI 工具0
  3. 03

    即夢國際版 Dreamina 是什麼：官方站入口、能生成什麼、免費積分和模型（2026）

    即夢國際版 Dreamina 是什麼？官方站是 dreamina.capcut.com，是一個圖片、影片和數字人一體的 AI 創作平台。按官方首頁和 FAQ 講：能生成什麼、免費用戶每天 120 積分、列出的 Seedance 與 Seedream 模型，以及和國內即夢怎麼區分。

    其他 AI 工具0
  4. 04

    Kimi K3 Coding Plan 是什麼、怎麼用：Kimi Code 會員、模型 ID、套餐價格和額度規則

    Kimi K3 Coding Plan 是什麼？按 Kimi 官方文檔核對：官方現在叫 Kimi Code，是 Kimi 會員權益裏的編程服務，Plus 及以上才有；講 K3 等模型 ID、國內新套餐價格、三種客戶端、第三方工具接入和額度規則。

    Kimi0
  5. 05

    DeepSeek V4 Pro 和 Flash 的區別與 API 價格：官方價格頁逐項對照（高峰與空閒時段）

    DeepSeek V4 Pro 和 Flash 有什麼區別、API 怎麼收費？按 DeepSeek 官方價格頁（2026-10-19 查詢）列出兩個模型的版本、上下文、圖像理解、並發和每百萬 token 價格，說明高峰與空閒時段的計費差別和舊模型名怎麼處理。

    其他 AI 工具0
  6. 06

    GPT-6 Pro（Astra）怎麼用、哪些套餐有：怎麼選到 Pro 檔、用量限制和 Pro 三檔價格

    GPT-6 Pro（Astra）怎麼用、哪些套餐有？按 OpenAI 幫助中心核對：聊天裏 Pro 檔給 Pro 100、Pro 200、Business 和 Enterprise；Plus 在 Work 和 Codex 裏含 Astra。講怎麼選到、用量上限和官方 Pro 價格。

    ChatGPT0

同產品的其他教學

  1. 01

    Claude Pro 和 Max 的區別：用量、價格、Fable 模型和每月 API 額度怎麼選

    Claude Pro 和 Max 有什麼區別？按官方定價頁和幫助中心核對：Max 有 5x、20x 兩檔用量，Pro 與 Max 在價格、Fable 模型、每月 API 額度和計費週期上的差別，以及什麼情況下 Pro 夠用、什麼情況下該升 Max。

    Claude0
  2. 02

    Claude 登入不了、用不了、打不開怎麼辦：按官方幫助中心逐條排查

    Claude 無法登入、無法使用、無法打開怎麼辦？按官方幫助中心的順序排查：收不到登入電郵、登入報錯、Google 登入出問題、系統繁忙、額度用完、官方故障，以及所在地區是否在官方支持名單裏。

    Claude0
  3. 03

    Claude 怎麼註冊：官方註冊流程、手機驗證要求，以及提示無法註冊時官方怎麼說

    Claude 怎麼註冊？打開 claude.ai，用 Google 或電郵登入連結創建帳號，再用支持地區的手機號收短訊驗證碼。講清官方的註冊條件、手機驗證的限制，以及收不到驗證碼、號碼被用過多次時官方的處理辦法。

    Claude0
  4. 04

    Claude 怎麼用：新手入門，從打開聊天到寫出第一個好問題

    Claude 怎麼用？按官方幫助中心整理的新手路徑：在網頁、桌面版或手機 App 打開聊天，像對同事一樣寫需求，用輸入框的「+」和「/」找功能，點模型名換模型，免費版有每 5 小時重置的上限。

    Claude0
  5. 05

    Claude 怎麼設定成中文：介面語言、回答語言和語音語言分別怎麼設

    Claude 怎麼設定中文？官方幫助中心列出的 11 種介面語言裏目前沒有中文，但 Claude 會用你提問的語言回答，直接用中文問即可；想固定用中文，可在設定的 Instructions for Claude 裏寫一句。語音模式的語言要單獨選。

    Claude0
  6. 06

    MCP Inspector 怎麼用：安裝、啟動命令、調試 MCP 伺服器與 v2 的變化

    MCP Inspector 是什麼、怎麼安裝和使用？按 MCP 官方文檔講清網頁、命令行、終端介面三種模式的啟動命令，怎麼連本地和遠程伺服器、怎麼傳環境變量，密鑰存在哪，以及 v2 相比舊教學在端口、令牌變量名和 Node 版本上的變化。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論，來搶沙發～