CLAUDE.md 编写指南:配置层级、加载顺序与最佳实践

4310sy · x · 2026-08-15

一位日本开发者在 Qiita 上系统整理了 Claude Code「记忆文件」CLAUDE.md 的编写规范,把许多人凭感觉在用的功能讲清楚了。

配置层级与加载

• 四个位置:用户全局 /.claude/CLAUDE.md(不入 git)、项目 ./CLAUDE.md(提交)、./CLAUDE.local.md(不提交)、子目录级 CLAUDE.md
• 加载顺序从文件系统根部向工作目录推进;子目录文件在 Claude 读到该目录时按需加载
• 多个文件是简单拼接而非覆盖,矛盾指令优先级不定,应尽量避免冲突;可用 claudeMdExcludes 按 glob 模式排除

进阶用法

• @path/to/file import 语法可在原处展开其他文件内容,支持相对/绝对路径和 /,最多嵌套 4 跳;用反引号包裹则保留为普通字符串
• /init 基于代码库自动生成初稿,不覆盖已有文件而是给出改进建议;/memory 列出当前加载的 CLAUDE.md 并调起外部编辑器编辑

最佳实践:全文控制在 200 行以内;写命令、规范、项目癖好与既定决策,而非代码里能读出的内容;指令要具体(如「2 空格缩进」而非「格式正确」);用标题和列表组织;可用 IMPORTANT 等关键词强调。

原文链接 →

「编程与Agent」频道最新

• GitHub 工作流在 AI 重负载下显露裂痕 — talkaboutdesign · 2026-08-15
• AI Agent 运行全解构：循环、记忆与 MCP — noninertialframe96 · 2026-08-15
• AI 编程工具新增 Workspaces 自动提示功能 — zeeg · 2026-08-15
• 深度探讨 Claude Desktop 如何处理 MCP 资源链接 — SnooDoubts8106 · 2026-08-15
• MongoDB 高管：Agent 自主任务中微小检索错误会严重累积 — schwentker · 2026-08-15
• MongoDB演示：agent下了采购单，但资金一分未动 — schwentker · 2026-08-15

更多「编程与Agent」频道 AI 资讯 →