拾光 AI 工作室

Claude Code 非工程师实战・第 3 篇・约 9 分钟

让它记住你的习惯：非工程师的 CLAUDE.md 怎么写

本文目录

    写作时版本：Claude Code 2.1.x／2026 年 11 月（内容依官方文档 2026-11 查阅整理）。 Claude Code 更新很快，界面文字、指令名称、默认值都可能改变。看到的画面和本文不一样时，请以官方文档为准。

    这篇文章要帮你做到什么

    用过前两篇你应该发现一件事：每次开新的对话，它都忘了你是谁。

    昨天你才教它“文件名不要用最终版”，今天开新窗口，它又问你一次。你得重讲命名规则、报表格式、哪些文件夹不能碰……

    这篇要解决的就是这个：把你的习惯写成一个叫 CLAUDE.md 的纯文本文件，放在文件夹里。之后每次在这个文件夹启动 Claude Code，它一开始就会读到。一次设置，长期有效。

    读完你会：

    • 知道 CLAUDE.md 是什么、放哪里
    • 用一份“六段式”结构，在 20 分钟内写出你的第一份
    • 用 /memory、/context all 确认它真的读到了
    • 知道哪些内容不该写进去，以及它没照做时怎么查

    需要准备：

    • 已按第 1 篇装好并登录 Claude Code
    • 一个你平常会处理文件的文件夹（练习用文件夹也行，沿用第 1、2 篇的 Claude练习）
    • 约 30 分钟

    先搞懂：CLAUDE.md 是什么，不是什么

    是什么：一个你自己用记事本就能写的纯文本文件（Markdown 格式，其实就是纯文本加几个 # 标题符号）。Claude Code 每次开始工作时，会把它读进去当作背景资料。官方的说法是：把它当成“你原本需要重复解释的内容”的存放处。

    不是什么：它不是强制执行的设置。官方文档明说，Claude 把 CLAUDE.md 当“背景信息”，会尽力遵循，但没有严格遵守的保证，指令越模糊、互相冲突，越容易被忽略。

    这点对非工程师特别重要：

    “不准删除文件”写在 CLAUDE.md 里，是提醒它，不是锁住它。真正的刹车，还是第 1 篇教的权限模式（动手前它会问你）。两层要一起用。

    它可以放在哪里（你只需要记两个）

    官方文档列了好几种位置，非工程师只要记这两个：

    想要的效果 文件位置 说明
    只在某个文件夹工作时适用 该文件夹里的 CLAUDE.md 例如 Claude练习 文件夹。你在这个文件夹（或它底下）启动，就会读到
    不管在哪个文件夹都适用 ~/.claude/CLAUDE.md ~ 在 Windows 就是 C:\Users\你的名字。适合放“我是谁、回答一律用繁体中文”这类个人偏好

    另外两个细节：

    • 它会读“你启动的文件夹”以及它上层文件夹里的 CLAUDE.md，内容是叠加、不是互相覆盖。
    • 子文件夹里的 CLAUDE.md 不会一开始就读，而是它开始处理那个子文件夹的文件时才读进来。

    建议做法：先只做一份，放在你最常工作的文件夹。写顺手了再加。

    步骤 1：先让它帮你起个草稿（/init）

    不想从空白页开始，可以在工作文件夹启动 Claude Code 后输入：

    /init

    官方文档说明，/init 会自动生成一份起始 CLAUDE.md；如果文件已经存在，它会建议改进，而不是直接覆盖。

    但请注意：/init 是设计给程序项目的，它会分析代码库，找构建指令、测试指令。如果你的文件夹是一堆 Word、Excel、图片，它生成的内容可能很空泛或不太对。（本文作者未在纯文档文件夹实测 /init 的输出，标“待验证”。）所以对非工程师，我更建议下一步：自己写，或请它访谈你。

    步骤 2：用“六段式”写你的第一份

    打开记事本，另存为，文件名必须是 CLAUDE.md（注意保存类型选“所有文件”，不然会变成 CLAUDE.md.txt，它就读不到了）。放在你的工作文件夹里。

    把下面的架构复制进去，换成你自己的内容：

    # 關於我
- 我是【某某公司】的【行政專員】，名字叫【小安】。
- 我不是工程師，請用白話說明你做了什麼，不要丟一大段技術術語。
- 回答一律用繁體中文（台灣用語）。

# 這個資料夾放什麼
- 00 待整理：還沒分類的檔案
- 10 會議：會議紀錄，依年份分資料夾
- 90 封存：已結案，只讀不改

# 檔名規則
- 格式：YYYYMMDD_類型_主題_版本.副檔名，例如 20261105_會議_採購檢討_v1.docx
- 版本從 v1 開始，改版加 1。不要用「最終版」「最終版(2)」。

# 常見工作怎麼做
## 整理檔案
1. 先列出「舊檔名 → 新檔名」給我看，我說「好」才動手。
2. 動手前先把原檔名清單存成 CSV，方便我救回來。

# 不能做的事
- 不刪除任何檔案；要移除的，移到 90 封存。
- 不覆蓋原檔；修改一律另存新版本。
- 不確定的事先問我，一次問一個問題。

# 不要寫進任何檔案的東西
- 密碼、銀行帳號、身分證字號、客戶私人聯絡方式。

    这六段（我是谁／文件夹／文件名／常见工作／不能做／敏感数据）涵盖了多数办公室情境。

    写的时候抓这四个原则

    官方文档对“怎么写才有效”的建议，翻成白话：

    1. 要具体到可以检查。“文件名要整齐”不行；“格式是 YYYYMMDD_类型_主题_版本，例如……”可以。官方例子：“使用 2 空格缩进”比“正确格式化代码”有效。
    2. 短。官方建议每份控制在 200 行以内；太长会占用它的工作记忆、反而降低遵守度。
    3. 用标题和列表。分好段的内容，比一大段文字好读。
    4. 不要自相矛盾。如果上层文件夹说“用英文文件名”、这份说“用中文文件名”，它可能随机选一个。

    该写进去 vs. 不该写进去

    适合写 不适合写
    每次都要的规则（命名、格式、语气） 只有这一次要用的指令（直接在对话里讲）
    文件夹结构、哪里不能碰 密码、账号、身份证号码、客户隐私（它会被读进每一次对话）
    “第二次犯同样的错”的更正 整份很长的作业手册（太长会被稀释）

    另外一个实用判断：官方建议，如果是“好几个步骤的固定流程”，更适合做成“技能卡”（下一篇会教）；CLAUDE.md 放的是“每次都该知道的事实与规则”。

    步骤 3：确认它真的读到了

    写好了不代表它读到。一定要验证。保存后，在那个文件夹启动 Claude Code：

    cd "$env:USERPROFILE\Claude練習"
claude

    进去后输入下面两个指令（依官方文档）：

    ① 看清单：

    /context all

    在清单的 Memory files（记忆文件）区块，应该看到你刚写的 CLAUDE.md 路径。没列在那里，它就看不到。

    ② 打开与编辑：

    /memory

    这个指令会列出你的 CLAUDE.md 文件位置（包括用户层级、项目层级）。选一个文件，就能用你电脑上的编辑器打开修改；如果列出的文件还不存在，选它会先帮你建立。

    ③ 用一句话考它：

    我剛下載了一份採購檢討會議的 Word 檔，請告訴我依照我的規則，它應該叫什麼檔名。先不要改。

    如果它回答的是 YYYYMMDD_会议_采购检讨_v1.docx 这种格式，就是读到了。

    注意：界面样子、区块名称可能随版本不同；上述 /context all、/memory 指令依官方文档记载，作者未逐字比对各版本画面。

    步骤 4：它没照做的时候，怎么查

    官方的故障排除顺序，翻成白话：

    1. 先 /context all：文件有没有列在 Memory files？没有 → 文件名错了（常见：变成 CLAUDE.md.txt），或你不是在那个文件夹启动的。
    2. 指令太模糊？改成有例子、可检查的写法。
    3. 有没有互相冲突的规则？打开 /memory 列出的每个文件，看有没有两处说法不一样。
    4. 子文件夹的 CLAUDE.md 不会出现在清单里，它是用到才读。这不是坏掉。
    5. “一定要做”的事别只靠 CLAUDE.md。官方提到，必须在特定时机执行的事，要用 hook（较进阶）。非工程师的替代做法：靠第 1 篇的权限模式，让它动手前问你。

    另一个常见疑问：它自己也会“记笔记”

    除了你写的 CLAUDE.md，官方文档还说 Claude Code 有“自动记忆”：它会根据你的更正和偏好，自己写笔记。这些笔记存在你电脑的 ~/.claude/projects/ 底下，你可以用 /memory 打开、编辑或删除，也可以在 /memory 里关掉。

    区别很简单：CLAUDE.md 是你写的规则；自动记忆是它写的笔记。想要稳定、可预期，就把重要规则自己写进 CLAUDE.md。

    步骤 5：之后怎么养这份文件

    官方建议的时机很实用，直接照用：

    • 它第二次犯同样的错，就把更正写进去。
    • 你发现自己在不同对话里打同一段更正，就把它写进去。
    • 想请它代写也行，直接说：「请把这条规则加到 CLAUDE.md。」
    • 每个月看一次，删掉过时的规则。官方也提供 /doctor prompt-audit，可请它检查有没有过时或互相矛盾的内容（需要较新版本，标「待验证」）。

    四个「不要」

    1. 不要把密码、账号、客户资料写进去。 它每次都会被读进去，而且有些人会把文件夹共享给别人。
    2. 不要写成一整本手册。 超过 200 行，效果反而变差。
    3. 不要以为写了就等于锁住。 它是提醒，不是保证；重要动作仍要看它的计划再按同意。
    4. 不要写了就不管。 一定要用 /context all 验证一次。

    想直接拿现成的？

    自己从空白写第一份最花时间。我们整理了三种职业的模板：行政助理、社群小编、接单者，每一份都是写好结构、标出「要填空的地方」，搭配使用说明与改写指南，你只要把【 】换成自己的内容。

    👉 看数字商品

    （不买也没关系，上面的「六段式」已经足够你写出能用的第一份。）

    下一篇预告

    第 4 篇：《把每周都要做的事变成一张技能卡：Agent Skills 入门》 CLAUDE.md 放「每次都该知道的规则」；每周固定要做的「多步骤流程」，下一篇教你做成一张技能卡，之后一句话就能调用。

    参考来源（均为官方文档，2026-11 查阅）

    操作说明：CLAUDE.md 位置、大小建议（200 行）、/context all、/memory、/init、自动记忆的描述均依上述官方文档整理，本篇未在作者电脑上逐项实测界面；/init 在纯文档文件夹的输出、/doctor prompt-audit 为「待验证」；Mac 的路径写法（~/.claude/CLAUDE.md）相同，但 PowerShell 指令需改用 Terminal 的 cd ~/Claude练习。范例中的人名与公司均为虚构。

    同系列延伸阅读

    ← 返回文章列表

    本页由繁体中文机器转换。如有差异，以繁体中文原文为准。购买与客服以繁体中文进行。