Skip to content
返回 AI 编程

Claude Code 记忆（CLAUDE.md）

用 CLAUDE.md 记忆文件持久化项目约定与会话笔记。

Claude Code进阶

为什么

Stack Overflow 2025 开发者调查显示 9.7% 的开发者使用 Claude Code，JetBrains 2026 年 1 月 AI Pulse 发现 18% 的专业开发者在工作中使用，较 2025 年 9 月增长 1.5 倍。CLAUDE.md 自动加载到每个 Claude Code 会话，约定、架构与坑无需重复说明即持久化。

它相当于终端智能体的 .cursorrules，显著提升跨会话一致性。

何时使用

当每会话重复说明同一约定、新队友用 Claude Code、或输出偏离项目模式时加 CLAUDE.md。避免用 Claude Code 做需可视化 diff 审查的快速单行编辑——改用 Cursor 等 IDE 工具。

如何做

1. 在项目根创建 CLAUDE.md（纳入 git）。 2. 首放技术栈、构建/测试命令、架构规则。 3. 加"要/不要"规则与智能体常犯的坑。 4. 会话中用 # 内联加记忆："# 始终用 zod 验证"。 5. 保持约 50 行以内；长文档移至 /docs 并引用。 6. 子目录嵌套 CLAUDE.md 获目录级规则。

示例

# CLAUDE.md 技术栈：Astro 7 + React 18 + Tailwind 3，TypeScript strict。 构建：npm run build（tsc -b && astro build）。测试：npm test（vitest）。 - 数据仅在 src/data/*.ts；绝不在组件内联。 - 命名导出；仅 Astro 页面默认导出。 - 所有 API 输入用 zod 验证。 - 不加新依赖除非询问。 - i18n：9 语言，en 在根。

常见问题

  • ⚠Error: Cannot find module '@anthropic-ai/claude-code' → 运行 `npm install -g @anthropic-ai/claude-code`；需 Node.js 18+。
  • ⚠"Error: ENOTFOUND api.anthropic.com" → 检查 `echo $ANTHROPIC_API_KEY` 已设置且网络/代理放行 api.anthropic.com:443。
  • ⚠错误：限流："429 Too Many Requests" → 运行 `/cost` 查用量，`/compact` 压缩上下文，或等待配额重置。

最佳实践

  • ✓首放构建/测试命令，使智能体可自主跑门禁。
  • ✓一次性坑用内联 # 记忆；反复出现的提升到 CLAUDE.md。
  • ✓用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。

常见问题解答

什么是Claude Code 记忆（CLAUDE.md）？

用 CLAUDE.md 记忆文件持久化项目约定与会话笔记。 它可帮助开发者快速理解 Claude Code 记忆（CLAUDE.md） 的核心价值与适用场景。

如何开始使用Claude Code 记忆（CLAUDE.md）？

开始使用 Claude Code 记忆（CLAUDE.md），建议先掌握以下要点：在项目根创建 CLAUDE.md（纳入 git）。

Claude Code 记忆（CLAUDE.md） 的常见误区有哪些？

使用 Claude Code 记忆（CLAUDE.md） 时常遇到的问题包括：Error: Cannot find module '@anthropic-ai/claude-code' → 运行 `npm install -g @anthropic-ai/claude-code`；需 Node.js 18+。；"Error: ENOTFOUND api.anthropic.com" → 检查 `echo $ANTHROPIC_API_KEY` 已设置且网络/代理放行 api.anthropic.com:443。；错误：限流："429 Too Many Requests" → 运行 `/cost` 查用量，`/compact` 压缩上下文，或等待配额重置。。

Claude Code 记忆（CLAUDE.md） 的最佳实践是什么？

Claude Code 记忆（CLAUDE.md） 的最佳实践包括：首放构建/测试命令，使智能体可自主跑门禁。；一次性坑用内联 # 记忆；反复出现的提升到 CLAUDE.md。；用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。。

如何深入学习Claude Code 记忆（CLAUDE.md）？

从官方文档入手，再在 GitHub 上搜索真实示例；先在小实验仓库验证模式，再应用到生产代码。