原始文章發布於 getlockstep.dev。週二,一位工程師花了三個小時使用 Claude Code 處理一個不穩定的結帳測試。他們排除了支付模擬的問題,發現了會話儲存中的競爭條件,並完成了一半的修復工作,然後就被調去處理另一個突發事件。
週三,一位隊友接手了這張工單。他們的 Claude Code 從零開始,建議檢查支付模擬,這就是 Claude Code 追蹤器中最具體請求之一(共享團隊記憶功能提案)背後的問題。在類似功能推出之前,本文將說明團隊目前可以共享什麼、不能共享什麼,以及各類知識應該儲存在何處。事實來自 Anthropic 的文件,並於 2026 年 11 月 4 日進行了核對。
Claude Code 能否在團隊中共享記憶?答案是不能。Claude Code 的自動記憶儲存在您的主目錄中,根據文件說明,它不會在機器或雲端環境之間共享。您的隊友的代理永遠不會看到您的代理學到了什麼。
Claude Code 的自動記憶預設是本機儲存,不會在團隊成員之間共享。然而,團隊可以透過多種機制共享知識,這些機制通常儲存在儲存庫或共享的 Git 主機中。例如,專案層級的 CLAUDE.md 和 .claude/rules/ 可以透過 Git 共享,由團隊共同編寫。
技能(儲存在 .claude/skills/ 或作為插件)和帶有專案範圍記憶的子代理(儲存在 .claude/agent-memory/)也支援團隊共享。此外,團隊插件市場和由 IT 部門部署的受管理 CLAUDE.md 也能實現組織級別的知識共享。大多數團隊只使用專案 CLAUDE.md 和 .claude/rules/ 就停止了,但帶有記憶的子代理和團隊插件市場才是真正有用的共享方式。
團隊真正想共享的知識類型多樣,且有效期各不相同。例如,衝刺任務中途換手時,需要共享任務狀態,包括嘗試過什麼和失敗過什麼,這類知識通常只有數天的有效期。事件處理交接時的調查筆記,其知識有效期則為數小時到數天。
當工程師在不同服務中工作時,領域內的「陷阱」或特殊情況,其知識有效期可能長達數月。此外,程式碼變更背後的理由,其有效期與程式碼本身一樣長;而會話中做出的架構決策,則會一直有效直到被新的決策取代。
這些並非單一類型的知識。任務狀態應該會過期,領域陷阱應該累積,決策應該有負責人並被刻意替換。單一的共享記憶池會將這三者混淆,最終導致團隊對其失去信任。以下選項為每種知識類型提供了各自的歸屬。
選項 1:提交每個人都需要的指令
專案 CLAUDE.md 和 .claude/rules/ 已經透過 Git 共享。將它們用於適用於幾乎所有任務的穩定指令:命令、邊界、慣例。養成兩個習慣可以讓這對團隊有效。將 CLAUDE.md 保持在 200 行以下(這是 Anthropic 的建議),並將僅適用於部分程式碼庫的內容推送到帶有路徑的規則中,這樣它只會在 Claude 觸及匹配檔案時加載。
然後像程式碼一樣在拉取請求中審查這些檔案的變更,因為它們就是代理的程式碼。這無法容納的內容:每週變更的任何內容,以及會話期間學到但沒有人停下來寫下來的任何內容。有關完整的加載順序和限制,請參閱 Claude Code 記憶如何運作。
選項 2:為子代理提供專案範圍的記憶
這是 Claude Code 中最有用但最少使用的共享功能。子代理可以擁有自己的持久記憶,並且透過 memory: project,該記憶儲存在儲存庫的 .claude/agent-memory/<agent-name>/ 中。Anthropic 建議將專案範圍作為預設值,因為根據文件說明,它使子代理的知識可以透過版本控制共享。
一個服務的領域專家可能看起來像這樣,儲存為 .claude/agents/payments-expert.md:
```
---
name: payments-expert
description: Knows the payments service. Use for any change under services/payments/.
memory: project
---
您是團隊中支付服務的專家。在回答之前,請閱讀您的記憶以了解已知的陷阱。當您學到任何可以為下一位工程師節省時間的內容,例如競爭條件、不穩定的測試原因或未記錄的限制,請將其添加到您的記憶中。
```
當團隊中的任何人使用此子代理時,它會加載其 MEMORY.md 的前 200 行或 25KB,並且它寫回的內容會進入一個目錄,與其他所有內容一起經過程式碼審查。開頭範例中的工程師會將會話儲存的競爭條件留在該記憶中,他們的隊友的代理就會讀取它。
有三點注意事項。記憶是由執行子代理的人編寫的,因此請在拉取請求中審查這些檔案,而不是盲目合併。兩個人在不同分支上編輯 MEMORY.md 會產生普通的合併衝突。主對話的自動記憶不會加載到子代理中,因此這是一個單獨的儲存,而不是任何人的個人記憶的延伸。
選項 3:透過團隊插件市場發布技能
技能包含程序:如何發布版本、如何新增遷移、如何調試佇列。有關實例,請參閱 ADR 編寫技能。它們可以儲存在一個儲存庫的 .claude/skills/ 中。當多個儲存庫需要相同的技能時,將它們打包為插件。插件市場是一個 Git 儲存庫,其中包含一個列出您插件的 .claude-plugin/marketplace.json 檔案。它可以是私有的。
隊友只需註冊一次:claude plugin marketplace add your-org/claude-plugins 和 claude plugin install release-tools@your-org-plugins。更新會傳達給所有從中安裝的人,管理員可以要求每台機器都安裝該市場。這共享了團隊的工作方式,但它不共享任何人昨天學到的內容。
選項 4:為未完成的工作編寫交接文件
任務狀態是唯一不應儲存在永久記憶中的知識類型,它會在數天內過時。對於任務中途的交接,最可靠的工具仍然是提交到分支的簡短檔案:目標是什麼、嘗試了什麼、失敗了什麼,以及下一步。在您停止工作之前,請 Claude 編寫它,並在下一個會話開始之前,要求它閱讀。當分支合併時,刪除該檔案。有關模板和應包含的內容,請參閱 Claude Code 總是忘記上下文?
這些都無法共享什麼?
上述每個選項都涵蓋了某人寫入儲存庫的知識。最難的團隊知識很少能到達那裡。產品經理和工程主管在 Slack 中達成共識,導出必須排除客戶的內部筆記。產品需求文件 (PRD) 已更新,但沒有人編輯 CLAUDE.md,因為它不是關於程式碼庫的指令。一週後,一位工程師的代理從較舊的原型構建了一個導出端點,並包含了這些筆記。
像這樣的決策具有儲存庫中檔案無法追蹤的屬性:所有者(有人做出了決定,也有人可以更改它)、狀態(提案與已批准不同)、替換歷史(當決策改變時,舊的決策應該標記為已替換,而不是默默地編輯),以及儲存庫外部的來源(Slack 討論串、PRD 和工單,而不是提交記錄)。
不同類型的知識應有其最佳歸屬。命令、慣例和邊界最適合儲存在專案 CLAUDE.md 和規則中。累積的領域陷阱則應由帶有專案範圍記憶的子代理來管理。可重複的程序可以透過技能和插件市場共享。未完成的任務狀態則應記錄在分支上的交接檔案中。至於產品和架構決策,則需要一個帶有所有者和狀態的共享決策記錄。
Lockstep 的定位
Lockstep 是為 Claude Code 設計的共享團隊記憶,專為上表中的最後一行而建構。決策從 PRD、Slack 和拉取請求中擷取,並在所有者批准後生效。在每個 Claude Code 會話開始時,代理會收到適用於該工作的決策簡報,並且可以在會話中透過 MCP 查詢相同的記錄。當一個決策被替換時,舊版本會被標記為已替換,因此沒有代理會將其視為當前決策。
對於工程主管,Standards & Skills 會發布版本化的標準和技能一次,並按團隊、儲存庫或路徑推出,並提供哪個版本到達哪個結帳的視圖。這與插件市場在分發上有所重疊;區別在於推出控制和採用視圖。它不取代 CLAUDE.md、專案範圍的子代理記憶或交接檔案,它也不會讓代理服從任何東西。
會話簡報和受管理的技能今天就可以與 Claude Code 配合使用;其他 MCP 客戶可以在沒有自動簡報的情況下呼叫這些工具。請在一個儲存庫上試用:npx lockstep-cli onboard。
來源核對日期:2026 年 11 月 4 日
- https://code.claude.com/docs/en/memory
- https://code.claude.com/docs/en/sub-agents
- https://code.claude.com/docs/en/plugin-marketplaces
- https://github.com/anthropics/claude-code/issues/38536
相關閱讀
- 有關每個記憶檔案和限制,請閱讀 Claude Code 記憶如何運作。
- 有關一個儲存庫中的並行代理,請參閱兩個 AI 代理,一個程式碼庫。
- 有關指令和記憶之間的分離,請參閱 CLAUDE.md 與代理記憶。
- 如果您想要託管儲存而不是 Git,請比較 Claude Code 的 MCP 記憶伺服器。