搞懂 .claude/ 資料夾：Claude Code 的控制中樞，CLAUDE.md、指令、技能與權限完整解析

大多數 Claude Code 使用者知道 .claude/ 資料夾的存在，但從未真正打開過它。AI 工程師 Akshay 近日整理了一份完整指南，解析這個資料夾的每個檔案的功能，以及如何設定才能讓 Claude 完全按照你的方式工作。

兩個資料夾，不是一個

首先要釐清一個常見誤解：.claude/ 資料夾有兩個，不是一個。

• 專案層級（你的專案/.claude/）：存放團隊共用設定，提交到 Git，讓所有人獲得一致的規則與指令
• 全域層級（~/.claude/）：個人偏好與跨專案設定，只影響自己的機器

CLAUDE.md：最重要的一個檔案

每次啟動 Claude Code 工作階段，Claude 第一件事就是讀取 CLAUDE.md，並將其載入系統提示詞（system prompt），在整個對話中持續遵守其中的指示。

應該寫入的內容：

• 建置、測試、lint 指令（如 npm run test）
• 重要的架構決策
• 不明顯的注意事項（例如「TypeScript strict mode 開啟，未使用的變數會報錯」）
• 命名規範、錯誤處理風格

不應該寫入的內容：適合放在 linter 設定的規則、完整文件、冗長的理論說明。

Akshay 建議將 CLAUDE.md 控制在 200 行以內——超過這個長度，Claude 的指令遵守率實際上會下降，因為消耗太多 context。

rules/ 資料夾：模組化指令，適合團隊擴展

當 CLAUDE.md 越來越臃腫，.claude/rules/ 是解法。每個 Markdown 檔案代表一個關注點，例如 code-style.md、testing.md、api-conventions.md，Claude 會自動讀取所有檔案。

更強大的是「路徑範圍規則」：在規則檔案加入 YAML 前置資料，就能讓規則只在 Claude 處理特定路徑的檔案時才載入，避免不相關的規則佔用 context。

commands/ 資料夾：自訂斜線指令

放在 .claude/commands/ 的每個 Markdown 檔案都會成為一個斜線指令。review.md 對應 /project:review，fix-issue.md 對應 /project:fix-issue。

最實用的功能是在指令檔案中使用 ! 語法執行 shell 指令並嵌入輸出——例如自動抓取 git diff 注入提示詞，讓 Claude 真正「看到」你的程式碼變更。放在 ~/.claude/commands/ 的個人指令則跨所有專案都可使用。

skills/ 與 agents/：主動觸發 vs. 指定子代理

Skills 和 agents 的核心差異在於觸發方式：

• Skills：Claude 根據對話內容自動判斷是否呼叫，無需手動輸入指令。每個 skill 有自己的目錄與 SKILL.md，並可附帶支援檔案
• Agents：定義專業子代理人格，擁有獨立的系統提示詞、工具權限與模型設定。複雜任務時 Claude 會 spawn 一個隔離的 context window 讓代理執行，避免主工作階段被大量 token 塞滿

Agents 的 tools 欄位能限制子代理的行為範圍——安全審計代理只需要讀取權限，不應有寫入能力。model 欄位則讓你為聚焦型任務選用較輕量的模型，節省成本。

settings.json：權限白名單與黑名單

.claude/settings.json 控制 Claude 被允許或禁止執行的操作：

• allow 清單：直接執行，不需確認（例如 npm run *、git *）
• deny 清單：完全封鎖（例如 rm -rf *、讀取 .env）
• 不在清單內的操作：Claude 會詢問是否繼續

個人設定可放在 .claude/settings.local.json，自動被 gitignore，不會提交到倉庫。

從哪裡開始？

Akshay 建議的實用起步順序：先執行 /init 生成初始 CLAUDE.md，加入 settings.json 設定基本權限，再建立一兩個最常用的自訂指令——其餘的隨著使用習慣逐步添加。

核心洞察是：.claude/ 資料夾是你告訴 Claude「你是誰、專案是什麼、應該遵守什麼規則」的協定。設定得越清楚，花在糾正 Claude 的時間就越少。