本篇文章更新時間：2026/03/28
如有資訊過時或語誤之處，歡迎使用 Contact 功能通知或向一介資男的 LINE 社群反應。
如果本站內容對你有幫助，歡迎贊助支持 。
內容目錄
拆解 .claude/ 資料夾的真正用途
一份幫你重新掌控 AI 工作流的操作指南
編輯前言：如果你正在使用 Claude Code，但始終覺得它像個黑箱、偶爾很聰明但偶爾又「不聽話」，這篇來自 Anatomy of the .claude/ Folder 的文章會徹底改變你使用它的方法。原來 Claude 的真正智慧，藏在你從沒打開過的
.claude/裡。
核心觀點 (Key Takeaways)
.claude/是 Claude Code 的行為控制中心，包含規則、指令、權限與記憶。CLAUDE.md是整個系統最重要的文件，相當於 Claude 的「人格設定」與「工作守則」。- 當專案變大、規則變多時，要善用 rules、commands、skills 和 agents 進行模組化管理。
深入解析
文章最讓我驚訝的，是 .claude/ 其實分成兩個層級：
- 專案層級
.claude/：團隊共用、會被 commit。 - 個人層級
~/.claude/：私人偏好、本機狀態、跨專案生效。
換句話說，Claude 在工作時，其實同時參考了不同層級的設定，難怪我們常覺得它「會記得某些奇怪的事」。
作者特別強調：「Whatever you write in CLAUDE.md, Claude will follow.」
這句話是整篇文章最核心的洞察。既然 Claude 會全盤遵行，那就更需要好好設計內容，而不是把它當備忘錄亂塞資訊。
1. 最重要的：CLAUDE.md
文章給了很實用的建議：CLAUDE.md 最好保持 200 行以內，內容聚焦在：
- 專案的 build/test/lint 指令
- 非直覺的規則（例如 TypeScript strict 打開）
- 錯誤處理慣例、命名風格
- 重要架構決策（monorepo、模組劃分）
不要加入：完整文件、理論解說、會被 linter 規範到的東西。
這讓我認為 CLAUDE.md 更像「給 AI 的快速上手指南」，而不是 README。
2. CLAUDE.local.md：個人化偏好
這個檔案自動 gitignore，方便你告訴 Claude：
- 我偏好某種測試框架
- 我喜歡它用什麼格式開檔
它像是「私人的 AI 操作習慣層」，不干擾團隊規則。
3. rules/：團隊維護的大型規則庫
當 CLAUDE.md 變得太長，應該拆到 rules/：
- 每個領域一個檔案（API、Testing、Frontend、Security）
- 可用 YAML frontmatter 限制作用範圍，例如只在
src/api/套用
這是團隊規模化最關鍵的部分，讓 Claude 的規則可維護、可協作。
4. commands/：打造你的 Slash 指令集
只要丟一個 markdown 檔進去，就能生成像：
- /project:review
- /project:fix-issue
並且支援：
- 執行 shell 指令並將輸出注入 prompt
- 支援
$ARGUMENTS
讓我意識到：原來你可以把常用工作流「程式化」給 AI，而不只是依賴對話。
5. skills/：Claude 自動觸發的能力模組
與 commands 最大差別是：
- commands 需要你手動觸發
- skills 會在任務匹配時自動啟動
例如：
- 當你說「檢查這段程式碼的安全性」 → security skill 自動上線
skills 甚至可以放多檔支持文件，更像是一個「功能包」。
6. agents/：專屬子代理人
這部分我覺得很酷。你可以定義：
- code reviewer agent
- security auditor agent
- documentation agent
每個 agent 都可以：
- 有自己的 system prompt
- 各自的可用工具（例如 read-only）
- 各自的 model
這代表你在打造一個小型 AI 團隊，而不是只有單一 Claude。
筆者心得與啟發
讀完這篇文章，我最大的感受是：大多數人只是「使用 AI」，但沒有真正「設計 AI 工作環境」。
.claude/ 其實就像是我們與 AI 共同工作的 IDE，而我們能做的優化遠比想像中多：
- 用 CLAUDE.md 決定基本行為
- 用 rules 決定團隊規範
- 用 commands 打造屬於自己的快捷鍵
- 用 skills 轉化成「智慧工作流」
- 用 agents 打造多專長 AI 小組
這種結構化的設計思維讓我意識到：與其花時間糾正 AI，不如花時間教好 AI。教一次、受益無限次。
如果你剛開始導入 Claude Code，我會推薦的入門路線是：
- 先跑
/init建立初始 CLAUDE.md - 加上基本的 permissions 設定，確保工具安全性
- 為常用工作流建立 1-2 個 commands
- 隨著專案成長再拆 rules
- 最後才考慮 skills 與 agents
這篇文章讓我重新思考 AI 開發的重點不僅是 prompt，而是「AI 的工作環境架構」。.claude/ 正是那個架構的基礎。設好它，等於打好整個 AI 工作流的地基。