88 content : CLAUDE.md,Claude Code,AI编程,AI项目规范,Agentic Coding,AI辅助开发,CLAUDE.md最佳实践,.claude/rules
99---
1010
11- 你好,我是小 G。前几天分享 [ Claude Code 使用技巧] ( https://javaguide.cn/ai-coding/claudecode-tips.html ) 的时候,我提到了一个很重要的文件 ` CLAUDE.md ` ,并简单介绍了一下。
11+ 你好,我是小 G。前几天分享 [ Claude Code 使用技巧] ( https://javaguide.cn/ai-coding/practices/ claudecode-tips.html ) 的时候,我提到了一个很重要的文件 ` CLAUDE.md ` ,并简单介绍了一下。
1212
1313有 G 友在评论区留言:这个文件既然这么重要,能不能单独写一篇来讲?
1414
@@ -52,7 +52,7 @@ README 主要是写给人看的,重点是介绍项目信息;`CLAUDE.md` 则
5252| ** 谁读** | Claude Code 专属 | 跨工具开放标准,OpenAI Codex、Cursor、Google Jules 等也采用 |
5353| ** 定位** | Claude Code 的项目规则文件 | 跨工具通用的 Agent 指令文件 |
5454
55- ![ 多智能股票分析项目中的 CLAUDE.md 和 AGENTS.md] ( https://oss.javaguide.cn/github/javaguide/ai/coding/claude-agents-md.png )
55+ ![ CLAUDE.md 和 AGENTS.md] ( https://oss.javaguide.cn/github/javaguide/ai/coding/claude-agents-md.png )
5656
5757简单说:通常来看 ** AGENTS.md** 是跨工具标准,** CLAUDE.md** 是 Claude Code 专属入口。两者可以复用同一份基础指令。
5858
@@ -348,7 +348,7 @@ Spring Boot 4.0 + Java 21 + Spring AI 2.0 + React 面试平台。
348348
349349## CLAUDE.md 放在哪里?
350350
351- Claude Code 支持 ` CLAUDE.md ` 放在多个位置,按优先级从低到高 :
351+ Claude Code 支持 ` CLAUDE.md ` 放在多个位置。按加载顺序和影响范围,可以先这样看 :
352352
353353![ CLAUDE.md 层级与优先级] ( https://oss.javaguide.cn/github/javaguide/ai/coding/claudecode/claude-md-best-practices-file-hierarchy.png )
354354
@@ -359,11 +359,10 @@ Claude Code 支持 `CLAUDE.md` 放在多个位置,按优先级从低到高:
359359| ** 项目级** | ` ./CLAUDE.md ` 或 ` ./.claude/CLAUDE.md ` | 团队共享规范,提交至 Git |
360360| ** 本地级** | ` ./CLAUDE.local.md ` | 个人的项目特定配置,加入 ` .gitignore ` |
361361| ** 子目录** | ` ./subdir/CLAUDE.md ` | Claude 访问该目录文件时按需加载,不在会话开始时注入 |
362- | | | |
363362
364- Claude Code 会把不同层级的 ` CLAUDE.md ` 一起加载,不是后面的文件把前面的直接覆盖掉。不过,越靠近当前项目、作用范围越具体的规则,会排在更后面,通常也更容易被 Claude 采纳 。
363+ Claude Code 会把不同层级的 ` CLAUDE.md ` 一起加载,不是后面的文件把前面的直接覆盖掉。不过,越靠近当前项目、作用范围越具体的规则,会排在更后面,也更贴近当前任务 。
365364
366- 比如用户级规则写“统一用空格缩进”,项目级规则写“这个仓库使用 Tab”,那在这个项目里,Claude 通常会优先按项目规则来 。官方文档里的加载顺序也是从组织级、用户级,一直到项目级和本地级。
365+ 比如用户级规则写“统一用空格缩进”,项目级规则写“这个仓库使用 Tab”,那在这个项目里,Claude 更可能按项目规则来 。官方文档里的加载顺序也是从组织级、用户级,一直到项目级和本地级。真遇到互相打架的规则,最好直接删掉冲突项,不要指望 Claude 每次都选对 。
367366
368367我的做法比较简单:项目级 ` CLAUDE.md ` 提交到 Git,放团队都要遵守的规则;只和自己有关的偏好,比如当前项目里希望提交信息用中文,就放进 ` CLAUDE.local.md ` ,再加到 ` .gitignore ` ,别把个人习惯混进团队文件。
369368
0 commit comments