# Lydia Hallie 介紹 Claude Code Subagent 新增持久化記憶功能 > 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt) > 原作者：Lydia Hallie ✨ (@lydiahallie) · 策展與摘要：EasyVibeCoding · 平台：X (Twitter) · 熱度：🔥🔥 · 日期：2026-07-21 > 原始來源：https://x.com/lydiahallie/status/2079255826355892464 ## 證據與延伸閱讀 - [claude.com](https://code.claude.com/docs/en/sub-agents) - [classmethod.jp](https://dev.classmethod.jp/en/articles/20260616-cc-updates-v2-1-178/) - [buildthisnow.com](https://www.buildthisnow.com/blog/guide/development/claude-code-headless-mode) - [claude.com](https://code.claude.com/docs/en/hooks) - [hidekazu-konishi.com/entry/claude_code_hooks_complete_guide.html](https://hidekazu-konishi.com/entry/claude_code_hooks_complete_guide.html) - [claude.com](https://code.claude.com/docs/en/agent-sdk/subagents) - [github.com/luongnv89/claude-howto/blob](https://github.com/luongnv89/claude-howto/blob/main/04-subagents/README.md) - [claude.com](https://code.claude.com/docs/en/env-vars) - [buttondown.com/krypteiasec/archive/daily-ai-builder-brief-july-17-2026](https://buttondown.com/krypteiasec/archive/daily-ai-builder-brief-july-17-2026/) ## 中文摘要 Lydia Hallie 介紹 Claude Code Subagent 新增持久化記憶功能。 **Subagent 持久化記憶機制** Lydia Hallie 指出，Subagent 預設在每次執行後會清除所有狀態，但透過在定義檔中加入 `memory` 欄位，即可為其指定持久化的儲存目錄。此功能支援三種作用範圍，能根據需求靈活調整： - `user`：儲存於 `~/.claude/agent-memory//`，適用於跨所有專案共享的學習心得。 - `project`：儲存於 `.claude/agent-memory//`，適合納入 Git 版本控制，讓團隊成員的 Agent 也能使用。 - `local`：同樣位於 `.claude/agent-memory-local//`，但不包含在 Git 追蹤中，適合存放專案私有的筆記。 > 該畫面展示了 Claude Code 代理程式（Agent）的設定檔範例，說明如何透過不同的記憶體層級（User、Project、Local）來管理程式碼審查偏好與設定。 啟用記憶功能後，Subagent 會自動獲得 `Read`、`Write` 與 `Edit` 工具權限，並在系統提示詞中載入 `MEMORY.md` 的前 200 行或 25KB 內容作為上下文。若使用者希望同時結合多種記憶範圍，Lydia Hallie 建議可將讀取路徑的指令寫入 Agent 的 `instructions` 中。 **Subagent 的核心架構與管理** Claude Code 的 Subagent 旨在處理特定任務，以避免主視窗被過多日誌或檔案內容淹沒。其運作與配置重點如下： - **定義與優先級**：Subagent 定義為包含 YAML frontmatter 的 Markdown 檔案，存放於 `.claude/agents/` 或 `~/.claude/agents/`。系統解析優先級為：Managed settings > `--agents` CLI 旗標 > 專案級目錄 > 使用者級目錄 > Plugin。 - **模型與權限控制**：Subagent 預設繼承主對話模型，也可透過 `model` 欄位指定；自 `v2.1.198` 起，內建的 Explore 子代理也改為繼承主對話模型（先前固定使用 Haiku）。權限可透過 `permissionMode` 進行細部控制，例如使用 `bypassPermissions` 允許寫入敏感目錄，或透過 `disallowedTools` 限制特定工具（如 `mcp__*` 可移除所有 MCP 工具）。 - **生命週期與 Hook**：透過 `hooks` 欄位，使用者可在 `PreToolUse` 或 `PostToolUse` 等階段執行自定義腳本，例如透過 `./scripts/validate-readonly-query.sh` 攔截非唯讀的 SQL 指令，若偵測到寫入操作可透過 `exit 2` 阻斷執行。 ![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/b8199fa4b8ee89d9.png) > 這是一份關於 Claude Code 說明文件中關於建立自訂子代理（subagents）以優化特定工作流程的教學頁面。 **進階操作與限制** - **巢狀與並行執行**：自 `v2.1.172` 起，Subagent 可產生巢狀 Subagent（深度上限為 5 層）。若需平行處理多項任務，可使用 `fork` 功能，它能繼承主 Session 的上下文與 Prompt cache，比建立全新 Subagent 更具成本效益。 - **數量限制**：每個 Session 預設上限為 200 個 Subagent，可透過環境變數 `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` 調整。 - **執行模式**：Subagent 可在前景（阻塞主對話）或背景（並行）執行。自 `v2.1.210` 起，系統會掃描輸出以防止模仿系統訊息，確保安全性。 若需進一步整合，開發者可參考 [Claude Code 文件](https://code.claude.com/docs/en/sub-agents#enable-persistent-memory) 或透過 [Agent SDK](https://code.claude.com/docs/en/agent-teams) 進行自動化部署。對於需要頻繁互動或共享上下文的任務，建議優先使用主對話；若任務輸出冗長或需嚴格的工具隔離，則應選用 Subagent。 ## 媒體內容 **該畫面展示了 Claude Code 代理程式（Agent）的設定檔範例，說明如何透過不同的記憶體層級（User、Project、Local）來管理程式碼審查偏好與設定。** **影片中的 Prompt 與操作** 操作步驟： 1. （00:00）顯示 user 記憶體設定 2. （00:04）顯示 project 記憶體設定 3. （00:07）顯示 local 記憶體設定 ## 標籤 Claude Code, 功能更新, 記憶系統, Agent, Anthropic, Claude