Anatomy of .claude

Anatomy of .claude/（2026 完整版）

Brij Kishore Pandey 製作的 Claude Code 結構全景視覺圖——把專案級 + 全域級的 .claude/ 兩個目錄完整解構，含 2026 年新增項。本頁是文字版收錄 + Vincent 場景對照。

雙層結構並存

PROJECT SCOPE                    GLOBAL SCOPE
（committed to git，team 共享） （personal，applies to every project）
your-project/                    ~/.claude/
├── CLAUDE.md                    ├── CLAUDE.md
├── CLAUDE.local.md              ├── settings.json
├── .mcp.json                    ├── ~/.claude.json     ← don't delete
├── .worktreeinclude   NEW       ├── keybindings.json
└── .claude/                     ├── plugins/           ← don't delete
    ├── settings.json            ├── projects/          NEW
    ├── settings.local.json      │   <project>/memory/  → auto-memory
    ├── rules/                   ├── commands/
    ├── commands/                ├── skills/
    ├── skills/<name>/SKILL.md   ├── agents/
    ├── output-styles/  NEW      └── agent-memory/      NEW
    ├── agents/                      （survives across projects）
    └── agent-memory/   NEW
        <name>/  → persists across sessions

Project Scope 詳解

路徑	角色	git 狀態
CLAUDE.md	團隊指引（必要）	commit
CLAUDE.local.md	本地專屬規則	gitignored
.mcp.json	團隊共享 MCP servers	commit
.worktreeinclude	git worktree 範圍（NEW）	commit
.claude/settings.json	權限、hooks、env	commit
.claude/settings.local.json	本地覆寫	gitignored
.claude/rules/	模組化條件式規則	commit
.claude/commands/	自製 slash commands	commit
.claude/skills/<name>/SKILL.md	任務 SOP	commit
.claude/output-styles/	輸出風格定義（NEW）	commit
.claude/agents/	Subagent personas	commit
.claude/agent-memory/<name>/	agent 跨 session 記憶（NEW）	gitignored 通常

Global Scope 詳解

路徑	角色	注意
~/.claude/CLAUDE.md	全域個人偏好	—
~/.claude/settings.json	個人預設值	—
~/.claude.json	auth state	不要刪
~/.claude/keybindings.json	自定快捷鍵	—
~/.claude/plugins/	已安裝 plugin	不要刪
~/.claude/projects/<project>/memory/	自動專案記憶（NEW）	—
~/.claude/commands/	個人 slash commands	—
~/.claude/skills/	跨專案可用 skills	—
~/.claude/agents/	個人 subagents	—
~/.claude/agent-memory/	agent 跨專案記憶（NEW）	—

心智模型：6 個行為維度

rules/           → what Claude knows       （知識）
skills/          → how it works            （方法）
agent-memory/    → what it remembers       （記憶）
commands/        → what it does            （動作）
agents/          → who it becomes          （人格）
output-styles/   → how it communicates     （風格）

→ 設計新模組時對著這 6 維度問「我要影響哪個維度？」就找到該放哪。

「實際載入了什麼」用這些 slash commands 查

指令	看什麼
/context	各類別 token 用量
/memory	CLAUDE.md + rules 載入內容
/agents	已配置的 subagent
/hooks	啟用的 hooks
/mcp	連線的 MCP servers
/skills	可用的 skills
/permissions	allow / deny 規則
/doctor	完整診斷

NEW 2026 項目（需驗證）

這 5 個項目在原圖標 NEW，是 2026 系列新增。我推測對應的概念：

NEW 項目	推測對應
.worktreeinclude	git worktree 模式時告訴 Claude 哪些 worktree 納入 context
.claude/output-styles/	輸出風格定義（對應 brand-voice.md 的 Claude Code 版）
.claude/agent-memory/<name>/	每個 subagent 跨 session 記憶
~/.claude/projects/<project>/memory/	Claude Code 全域自動管理某專案的累積記憶
~/.claude/agent-memory/	agent 跨專案記憶

這 5 個都跟 4.6 升級主題（記憶 + 持久化 + 個人化）方向一致，合理但建議實測驗證。

對 Vincent / PAM 的對照

已實作（PAM）

ExamSystem/
├── CLAUDE.md             ✅ 650 行（已精簡）
└── .claude/
    └── rules/            ✅ 5 個 rule
        ├── 01-grading-service.md
        ├── 02-controller.md
        ├── 03-frontend.md
        ├── 04-tests.md
        └── 05-migration.md

短期可加（已驗證的功能）

└── .claude/
    ├── settings.json     🟡 加 hooks（pre-commit 跑 dotnet test）
    ├── commands/
    │   ├── pam-status.md      🟡 /pam-status 一鍵看週期狀態
    │   └── pam-followup.md    🟡 起草催繳信
    ├── skills/
    │   └── pam-spec-lookup/   🟡 PAM 規格速查
    └── agents/
        └── pam-reviewer/      🟡 PAM code review 專家

中期可試（NEW 2026）

├── .claude/
│   ├── output-styles/    ⏸ 試一個 PAM-formal 風格
│   └── agent-memory/
│       └── pam-reviewer/ ⏸ 讓 reviewer 跨 session 記憶 review 偏好
└── ~/.claude/
    └── agent-memory/     ⏸ 全域記憶 Vincent 的 review 風格

跟 Cowork 的對照

.claude/ 結構	Cowork 對應
CLAUDE.md	Global Instructions + 上下文檔體系
rules/	（無直接對應，Cowork 是整體規則）
skills/	SKILL.md 規範 / Cowork Plugins 內的 skills
commands/	Cowork Plugins 內的 slash commands
agents/	Sub-agent / Agent Teams
agent-memory/	Memory 記憶功能（雲端版）

→ Claude Code 的 .claude/ = 開發者版的「個人化全套」；Cowork 把同樣概念用 UI 包成一般人能用的形態。

來源

• 原圖：Brij Kishore Pandey, “Anatomy of .claude/ — 2026 edition”
• 對照官方：https://docs.claude.com/en/docs/claude-code/configuration
• 對照本地實證：Claude Code 專案結構 / Rules Directory / CLAUDE.md 4 層機制

相關概念

強連結（原文明確提及）

• Claude Code — 主執行環境
• Claude Code 專案結構 — 同主題簡化版
• CLAUDE.md 4 層機制 — 規則疊加邏輯
• Rules Directory — .claude/rules/ 詳細
• SKILL.md 規範 — .claude/skills/ 詳細
• Sub-agent / Agent Teams — .claude/agents/ 詳細
• Hooks — settings.json 內 hooks 段
• 15-References 上下文資料引用 — references/ 子資料夾的角色

← 回到 wiki