结论先说
- 利用好官方「子目录
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 条评论
还没有评论,来抢沙发~