我從家目錄啟動 Claude Code,讓跨專案工作在同一個範圍內、共用同一份記憶

經驗 L2 614 字 2 分鐘 v2.0.0 更新 2026-11-16

我幾乎都從家目錄(~)啟動 Claude Code,不先 cd 進專案。我的理由是:「碰得到所有專案、記憶共用」。

我的專案固定放在 Projects/<組織>/<專案>/,位置寫在使用者層級的 CLAUDE.md。因此我只講專案名稱,Claude Code 就找得到。

我實際下過的跨專案指令

我對 Claude Code 下過這個指令:「nas.zyx.tw 應該改成 ui.zyx.tw 的」。ui.zyx.tw 是我的共用元件庫,nas.zyx.tw 是另一個專案的網站。這項任務需要先讀元件庫,再修改另一個專案。

Claude Code 的啟動位置決定了什麼

Claude Code 預設的工作範圍,是啟動資料夾與底下的內容;範圍外的資料夾要另外加入並同意存取。從家目錄啟動,底下所有專案都在工作範圍內,自動記憶也集中在同一個資料夾。

Claude Code 不會因此讀完整個家目錄,而是依任務搜尋需要的檔案。使用者層級的 ~/.claude/CLAUDE.md 則每段對話都載入,與啟動位置無關。

Claude Code 的啟動位置

Claude Code 的工作範圍

  • 專案網站
  • ui.zyx.tw 在範圍外,需要另外提供路徑

新對話載入的規則

  • 使用者層級的 CLAUDE.md
  • 專案資料夾內的 CLAUDE.md

記憶位置

  • 這個專案的記憶資料夾
其他專案位於範圍外。需要補充路徑,並確認存取。

我替 Claude Code 補上的規則與整理

Claude Code 在對話開始時載入啟動資料夾與上層的 CLAUDE.md。子資料夾的 CLAUDE.md 要等讀到該資料夾的檔案才載入,因此從家目錄啟動時,專案規則還沒進來。

我在使用者層級的 CLAUDE.md 寫了這條規則:「Session 幾乎都從 ~ 開,repo 自己的 CLAUDE.md 不會自動載入:動某 repo 前先讀它的 CLAUDE.md / AGENTS.md / README」。這類工作要求寫在哪裡、怎麼驗證生效,見 CLAUDE.md。

我的記憶都集中在同一個資料夾,筆數很多,因此另做 1 份索引檔,每則記憶佔 1 行,同類再收成總表。相關做法見 記憶。

什麼情況適合,什麼情況不適合

需要同時處理多個專案時,這樣啟動比較合適,像上面先讀元件庫再改另一個專案的任務。代價是範圍內的每個專案,Claude Code 都改得到。

只做 1 個專案,或團隊共用專案規則時,機制上在專案資料夾啟動比較省事:Claude Code 開場就自動載入專案的 CLAUDE.md,不必另寫「先讀」規則。

讀完之後

基礎入門家目錄擴充MCPSkillPluginCLAUDE.md載入