結論先說
- 利用好官方「子目錄
CLAUDE.md按需懶加載」機制:根目錄/CLAUDE.md只寫不到百行的目錄地圖和包過濾語法;前端、後端、UI 包各自的細則放進子目錄CLAUDE.md——沒碰那個子包時完全不佔一丁點上下文。 - 日常開發單應用時,直接
cd apps/web進去啟動並用--add-dir掛載關聯共享包:既鎖死了主搜尋半徑,又允許智能體合法查閱上游公共類型包。 - 嚴禁在 Monorepo 讓智能體跑不帶過濾器的全量
pnpm build:在根規則裏強制規定一律用pnpm --filter <包名>或turbo run typecheck --filter=...[HEAD]只跑受影響包。 - 維護中大型多包倉庫建議配足高水位編碼套餐:日常開發與跨包重構可按工作量在本站選擇 Claude Pro 充值說明 或 5 倍用量的 Claude Max 充值頁。

圖:本站根據 Claude Code 官方層級記憶文檔 整理的三層規則拆分示意圖
本文根據 Anthropic Claude Code 官方文檔《Manage Claude's memory》《Common workflows》(code.claude.com/docs/en/memory)整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是終端截圖。本站(bigolab.com)不是 Anthropic 官方網站。
適用於誰
- 團隊採用 pnpm workspace、Turborepo 或 Nx 把前後端、管理台與公共組件全放在一個 Git 大倉(Monorepo)裏的開發者;
- 在大倉根目錄直接敲
claude,結果改一個小按鈕也觸發全倉幾千個文件盲搜、5 小時訂閱配額飛速見底的人; - 改了
packages/shared裏的一個公共接口類型,沒注意把隔壁apps/admin編譯弄掛過的工程師。
一、三層 CLAUDE.md 怎麼拆,以及 --add-dir 精準縮圈法
不少人在大倉踩的第一個坑,是把前端 React 規範、後端 NestJS 規範、移動端規範全塞進根目錄同一份 CLAUDE.md 裏(各端模板細節可參考 前後端 CLAUDE.md 編寫模板 與 大倉庫聚焦指定目錄指南)。按官方目錄樹加載邏輯,正確拆法如下:
markdown
# 根目錄 /CLAUDE.md(保持精簡,每次啟動必讀)
## 工作區拓撲地圖
- `apps/web`:面向用戶的 Next.js 主站
- `apps/admin`:內部運營後台(Vite + React)
- `services/api`:核心業務後端接口
- `packages/types`:跨前後端共用的 Zod 與 TypeScript 契約(高危共享區)
## Monorepo 命令鐵律
- 嚴禁在根目錄直接運行全倉 `pnpm test` 或 `pnpm build`
- 定向執行單包命令:`pnpm --filter @acme/web test`
- 修改 `packages/*` 下任何導出項後,必須運行:`pnpm turbo run typecheck --filter=...[HEAD]`
接着在 packages/types/CLAUDE.md 裏只寫三句話:「本包被 web、admin、api 同時依賴;修改已有字段前必須先全局搜尋所有消費方引用;優先新增可選字段而非重命名舊字段。」只有當 Claude 真正打開 packages/types 裏的文件時,這條警戒線才會自動跳進它的腦子裏。
如果你今天一整天只改主站前端、但偶爾需要連改公共類型包,不要在倉庫最頂層啟動,改用下面這條縮圈啟動命令(多目錄參數詳解見 Claude Code --add-dir 多目錄用法):
bash
cd apps/web
claude --add-dir ../../packages/types --add-dir ../../packages/ui
Claude Code 免上號訂閱與高配額省心方案:在大倉庫跑百萬上下文、多子包重構或複雜慢查詢排障時,固定月費訂閱比純按量 API 更容易鎖死成本上限。本站支持支付寶、微信支付與 AlipayHK 卡密自助兌換 iOS 鏈路的 Claude Pro 自助充值、5 倍額度的 Claude Max 5x 與頂配 Claude Max 20x,無需交出帳號密碼。
二、三段拿來即用的 Monorepo 跨包改造提示詞

圖:本站根據 Claude Code 常見工作流文檔 整理的四步實操示意圖
1. 修改底層共享 packages 前的下游影響盤點
text
我準備在 packages/types 的訂單模型裏把 discount 字段從單一數值升級為支持多張優惠券數組。
先不要改任何代碼:請派子代理搜尋全倉 apps/* 與 services/* 中所有引用了該字段的文件與行號,列出一份無損兼容遷移順序表供我確認。
2. 前後端同倉同步加字段並跑增量類型檢查
text
請按剛確認的方案依次更新 packages/types 契約、services/api 接口返回以及 apps/web 結算頁展示。
改完後不要跑全倉構建,請執行 pnpm turbo run typecheck test --filter=...[HEAD] 驗證所有受本次改動波及的上游與下游子包均零報錯通過。
3. 排查 Turborepo 跨包構建順序或內部包未編譯報錯
text
在乾淨環境下首次運行 pnpm --filter @acme/web dev 時,報找不到內部包 @acme/ui 的 dist 類型聲明。
請檢查根目錄 turbo.json 的 dependsOn 拓撲配置以及 packages/ui/package.json 的 exports 字段順序,給出符合官方規範的最小修復。
核對要點:跨子包提交 PR 前,自己看一眼根目錄 pnpm-lock.yaml 有沒有因為誤裝錯層依賴而發生意料之外的膨脹(子代理與工作樹搭配技巧見 子代理、Agent Teams 與 Worktree 選型)。
常見問題
問:在子目錄 cd apps/web 啟動 Claude Code 時,最外層倉庫根的 /CLAUDE.md 還會被讀到嗎?
答:會的。Claude Code 啟動時會從當前工作目錄一路向上遍歷到目錄樹上層合併讀取 CLAUDE.md,所以根部的全局包管理鐵律依然生效,而隔壁 apps/admin/CLAUDE.md 則完全不會被讀進來干擾視線。
問:Monorepo 裏有些歷史廢棄子包經常干擾代碼搜尋,怎麼屏蔽掉?
答:可以在項目的 .claude/settings.json 權限配置裏將廢棄歸檔目錄(如 legacy/*)加入讀取忽略或拒絕規則,防止 Grep 每次都撈出一堆死代碼浪費上下文窗口(上下文瘦身見 Claude Code 上下文壓縮技巧)。
問:同時要改互不相干的兩個子應用(比如一人盯兩需求),怎麼防終端卡住?
答:用內置的 Git Worktree(claude --worktree)拉出兩個獨立工作樹終端窗口分別進去各自子包跑,兩邊既不搶端口也不搶構建緩存。
問:Monorepo 子包之間引用的是打包後的 dist/ 產物而非源碼時,智能體總是看不到剛改的字段怎麼辦?
答:這是多包工程裏最典型的假報錯:智能體改完了上游 packages/ui/src 的源碼,卻忘了上游子包還沒重跑構建產出新類型文件,導致下游 apps/web 類型檢查一直標紅。你可以在上游共享包的子級 CLAUDE.md 裏明確補上一條收尾規則:「每次修改本包對外導出的組件屬性或函數簽名後,先執行 pnpm --filter @acme/ui build 更新編譯產物,再去下游消費方包跑類型核驗」,或者在本地開發期開啟 Turborepo 的監聽構建任務。
問:國內沒有海外銀行卡,怎麼給 Claude Code 開通 Pro 或 Max 訂閱最穩妥?
答:可在 Claude Code 訂閱說明頁 或 Claude Max 充值頁 選擇走蘋果 iOS 官方內購鏈路的自助卡密,自己複製登入憑證提交即可到賬,全程無需把密碼交給他人;若帳號偶發彈出身份核驗,也可查看 Claude KYC 人工協助(失敗不收費,封號不在質保範圍)。
0 條評論
還沒有評論,來搶沙發~