本篇核心目标从空白文件开始手把手写出一份适用于内容型知识库项目的 CLAUDE.md。你会得到两份成品模板最小可用版 进阶增强版以及每个模块为什么这样写的详细拆解。先别急着写搞清楚三种创建方式在动手之前你需要知道 CLAUDE.md 有三种创建方式各有适用场景。方式一/init 命令自动生成打开你的项目目录启动 Claude Code输入/initcd your-project claude /initClaude 会扫描你的项目——看 package.json、tsconfig、目录结构、现有文档——然后自动生成一份 CLAUDE.md 初稿。生成的内容通常包括构建命令、测试命令、关键目录、它检测到的代码约定。优点快有 baseline对新接手的项目很友好。问题自动生成的内容往往偏冗余。它会把能检测到的东西都塞进去不会帮你做这条规则重不重要的筛选。而且它几乎不可能自动识别内容型项目的特殊规则——比如 frontmatter 约束、slug 规则、分类体系的设计逻辑。正确用法把/init当草稿不要当成品。生成后必须人工精修——删掉冗余、补充它遗漏的关键规则、调整结构。如果你的项目已经有了 CLAUDE.md也可以再跑一次/init。Claude 会基于对项目的重新扫描给出改进建议。方式二手动从零创建在项目根目录创建文件touch CLAUDE.md然后用任何 Markdown 编辑器打开从空白开始写。适合对项目很熟悉的人、想完全掌控内容的人、不想引入自动生成冗余的人。这也是本篇主要教你的方式。方式三# Memory 快捷添加在 Claude Code 对话中输入#加上一条规则# 新增内容必须使用统一的 frontmatter 模板Claude 会把这条规则追加到 CLAUDE.md 文件中。适合工作过程中随手补充。当你发现Claude 又犯了这个错或者这个约定我每次都要重复说时立刻用#记录下来。最佳实践不要试图用#从零构建一份完整的 CLAUDE.md——它会变成一堆无序的规则碎片。#的价值在于持续迭代而不是初始创建。我的建议组合使用第 1 步手动创建骨架或用 /init 生成草稿后精修 第 2 步实际协作 3-5 次发现遗漏 第 3 步用 # 快速补充新规则 第 4 步每隔一段时间回来整理一次最好的 CLAUDE.md 不是一次写完的而是在真实使用中逐步长出来的。但你需要一个好的骨架起步。接下来就教你搭这个骨架。核心骨架7 个必备模块不管你的项目多大多小一份 CLAUDE.md 最核心的骨架就是 7 个模块# Project Context ← 项目是什么 协作哲学 ## About This Project ← 技术栈和架构 ## Key Directories ← 关键目录 ## Commands ← 常用命令 ## Standards ← 关键规则 ## Workflows ← 高频任务步骤 ## Notes ← 防坑提醒这 7 个模块不是我随意拍的而是从Claude 做事前必须知道什么倒推出来的它需要知道项目是什么Project Context About它需要知道代码在哪里Key Directories它需要知道怎么运行项目Commands它需要知道什么不能做Standards它需要知道做事的正确顺序Workflows它需要知道哪里有坑Notes下面逐个拆解怎么写。模块一Project Context这是 CLAUDE.md 的第一段Claude 进入项目后最先看到的内容。它的任务用最短的篇幅告诉 Claude 两件事这个项目是做什么的你希望它以什么态度和原则来工作怎么写项目说明只写一句话。不要写项目历史、团队背景、用户画像。一句话说清这是什么类型的项目核心目标是什么就够了。协作哲学写一到两条。这是你给 Claude 设定的做事态度。示例# Project Context 教师考试知识库系统。Markdown 驱动的内容型静态站点面向备考用户提供考情、政策和备考指南。 处理任务时优先理解现有内容结构和字段设计再做增量式修改避免随意重构。常见错误# ❌ 太长像在写项目介绍书 # Project Context 本项目是一个面向全国中小学教师的综合性知识库系统旨在为正在备考教师资格证、 教师编制、特岗教师招聘的用户提供一站式信息服务。项目始于 2024 年 3 月 由三人团队协作开发。目前已积累超过 500 篇原创内容覆盖 12 个省份的 考试信息。项目采用 JAMStack 架构理念追求高性能、低成本和优秀的 SEO 表现……Claude 不需要知道你团队有几个人、项目什么时候开始、积累了多少篇文章。这些信息不会影响它做任何具体任务。
第 2 篇：从零搭建一份内容型知识库项目的 CLAUDE.md 实战编写
本篇核心目标从空白文件开始手把手写出一份适用于内容型知识库项目的 CLAUDE.md。你会得到两份成品模板最小可用版 进阶增强版以及每个模块为什么这样写的详细拆解。先别急着写搞清楚三种创建方式在动手之前你需要知道 CLAUDE.md 有三种创建方式各有适用场景。方式一/init 命令自动生成打开你的项目目录启动 Claude Code输入/initcd your-project claude /initClaude 会扫描你的项目——看 package.json、tsconfig、目录结构、现有文档——然后自动生成一份 CLAUDE.md 初稿。生成的内容通常包括构建命令、测试命令、关键目录、它检测到的代码约定。优点快有 baseline对新接手的项目很友好。问题自动生成的内容往往偏冗余。它会把能检测到的东西都塞进去不会帮你做这条规则重不重要的筛选。而且它几乎不可能自动识别内容型项目的特殊规则——比如 frontmatter 约束、slug 规则、分类体系的设计逻辑。正确用法把/init当草稿不要当成品。生成后必须人工精修——删掉冗余、补充它遗漏的关键规则、调整结构。如果你的项目已经有了 CLAUDE.md也可以再跑一次/init。Claude 会基于对项目的重新扫描给出改进建议。方式二手动从零创建在项目根目录创建文件touch CLAUDE.md然后用任何 Markdown 编辑器打开从空白开始写。适合对项目很熟悉的人、想完全掌控内容的人、不想引入自动生成冗余的人。这也是本篇主要教你的方式。方式三# Memory 快捷添加在 Claude Code 对话中输入#加上一条规则# 新增内容必须使用统一的 frontmatter 模板Claude 会把这条规则追加到 CLAUDE.md 文件中。适合工作过程中随手补充。当你发现Claude 又犯了这个错或者这个约定我每次都要重复说时立刻用#记录下来。最佳实践不要试图用#从零构建一份完整的 CLAUDE.md——它会变成一堆无序的规则碎片。#的价值在于持续迭代而不是初始创建。我的建议组合使用第 1 步手动创建骨架或用 /init 生成草稿后精修 第 2 步实际协作 3-5 次发现遗漏 第 3 步用 # 快速补充新规则 第 4 步每隔一段时间回来整理一次最好的 CLAUDE.md 不是一次写完的而是在真实使用中逐步长出来的。但你需要一个好的骨架起步。接下来就教你搭这个骨架。核心骨架7 个必备模块不管你的项目多大多小一份 CLAUDE.md 最核心的骨架就是 7 个模块# Project Context ← 项目是什么 协作哲学 ## About This Project ← 技术栈和架构 ## Key Directories ← 关键目录 ## Commands ← 常用命令 ## Standards ← 关键规则 ## Workflows ← 高频任务步骤 ## Notes ← 防坑提醒这 7 个模块不是我随意拍的而是从Claude 做事前必须知道什么倒推出来的它需要知道项目是什么Project Context About它需要知道代码在哪里Key Directories它需要知道怎么运行项目Commands它需要知道什么不能做Standards它需要知道做事的正确顺序Workflows它需要知道哪里有坑Notes下面逐个拆解怎么写。模块一Project Context这是 CLAUDE.md 的第一段Claude 进入项目后最先看到的内容。它的任务用最短的篇幅告诉 Claude 两件事这个项目是做什么的你希望它以什么态度和原则来工作怎么写项目说明只写一句话。不要写项目历史、团队背景、用户画像。一句话说清这是什么类型的项目核心目标是什么就够了。协作哲学写一到两条。这是你给 Claude 设定的做事态度。示例# Project Context 教师考试知识库系统。Markdown 驱动的内容型静态站点面向备考用户提供考情、政策和备考指南。 处理任务时优先理解现有内容结构和字段设计再做增量式修改避免随意重构。常见错误# ❌ 太长像在写项目介绍书 # Project Context 本项目是一个面向全国中小学教师的综合性知识库系统旨在为正在备考教师资格证、 教师编制、特岗教师招聘的用户提供一站式信息服务。项目始于 2024 年 3 月 由三人团队协作开发。目前已积累超过 500 篇原创内容覆盖 12 个省份的 考试信息。项目采用 JAMStack 架构理念追求高性能、低成本和优秀的 SEO 表现……Claude 不需要知道你团队有几个人、项目什么时候开始、积累了多少篇文章。这些信息不会影响它做任何具体任务。
