你的 Claude Code 出问题了?5 分钟快速修复指南

@humzaakhalid
英语3周前 · 2026年6月25日
126K
92
18
4
207

TL;DR

本指南介绍了如何通过包含 CLAUDE.md、技能 (skills) 和钩子 (hooks) 的 5 层架构来解决 Claude Code 的上下文问题,确保 AI 能够严格遵守规则并保持项目记忆。

80% 的人第一天就设置错了。这才是真正有效的配置,零编码经验也没问题。

老实说,我问你一件事。

你有没有遇到过这种情况:打开 Claude Code,输入一些内容,得到了一个很棒的答案,然后 10 分钟后,它完全忘记了你刚刚告诉它的一切?

你没看错。这不是 bug。这是设置问题。

而修复只需要 5 分钟。

到这篇文章结束,你将获得一个完整的、即拿即用的入门套件,一个可以直接放到任何项目里立即使用的文件夹设置。不需要任何技术背景。

上个月,我因为同样的问题浪费了 4 个小时,不得不从头重建一个项目。

当时我正在用 Claude Code。它做得很好。但会话变长后,上下文变得混乱,它开始做出与我之前告诉它的一切相矛盾的决定。

我没有给 Claude 提供任何记忆、规则、或护栏。

这就像雇佣了一位出色的助手,却忘了告诉它为谁工作。

这就是我现在使用的设置。它是忘记一切的 Claude Code 和真正能用的 Claude Code 之间的区别。

快速说明:

Anthropic 发布了官方 Claude Code 文档,地址是:

docs.anthropic.com 。我这里展示的是他们没有引导你完成的实际配置。

如果你觉得有用,请把它转发给一个正在为 Claude Code 头疼的人。只需要 10 秒钟。

实际情况是什么

大多数人认为 Claude Code 只是一个更聪明的用于编码的 ChatGPT。

其实不是。它更像一个全职员工。

问题是:大多数人没有给它任何入职指导。没有指令。没有规则。没有关于你在构建什么以及你如何工作的上下文。

解决方案就是我所说的 5 层设置。把它想象成给你的 AI 助手搭建一个合适的工作空间,而不是直接把键盘丢给它就走人。

Hamza Khalid - inline image

下面是每一层的作用:

第 1 层 — 操作手册 (CLAUUDE.md): Claude 在每次会话开始时都会阅读的一份文档。在这里写下你的规则、偏好和项目细节。就像你给新团队成员第一天准备的入职文档。

第 2 层 — 专家 (技能): 预先训练好的迷你专家,你可以召唤它们来处理特定任务。一个负责审阅你的工作。一个负责写描述。一个负责运行测试。Claude 在识别到合适的时机时会自动调用它们。

第 3 层 — 安全卫士 (Hooks): 永远不能跳过的强制性规则。比如:永远不要删除这些文件。未经检查不要发送任何内容。完成前务必运行一次检查。与常规指令不同,hooks 不能被忽略。

第 4 层 — 第二意见 (子 Agent): 一个全新的 Claude 副本,不带任何偏见地审阅工作。它不知道你的主会话在做什么。所以它能捕捉到主会话可能遗漏的错误。

第 5 层 — 团队 (Agent Teams): 多个 Claude 会话协同工作,共享任务,互相发送消息。这是最强大的设置,也是最新的。你在第一天可能用不到。但它存在。

第 1 步:构建文件夹

在做其他任何事情之前,你的项目需要一个家。

想象一下布置一间新办公室。你需要一个放指令的地方,一个放专家的地方,一个放安全规则的地方,还有一个放工具的地方。

以下是有效的文件夹设置:

text
1your-project/
2├── CLAUDE.md ← 操作手册
3├── .claude/
4│ ├── settings.json ← 共享规则(你团队中的每个人都会看到)
5│ ├── settings.local.json ← 你的个人规则(私有,不共享)
6│ ├── skills/
7│ │ ├── review/SKILL.md ← 你的"质量检查"专家
8│ │ ├── testing/SKILL.md ← 你的"找 bug"专家
9│ │ └── writing/SKILL.md ← 你的"描述写作"专家
10│ └── agents/
11│ └── reviewer.md ← 你的"第二意见"检查器
12├── hooks/
13│ └── safety-rules.sh ← 安全卫士规则
14└── src/ ← 你的实际工作放在这里

如何设置:

  1. 为你的项目创建一个新文件夹
  2. 把上面的结构复制进去(我们会在接下来的步骤中填充细节)
  3. .claude/ 文件夹存放所有与 Claude 相关的内容

第 2 步:编写你的操作手册 (CLAUDE.md)

这是最重要的一步。

CLAUDE.md 是 Claude 在做任何事情之前都要阅读的文档。每次会话都会读。这是你告诉 Claude 你是谁、你在构建什么、你喜欢如何工作以及它永远不能跨越什么界限的机会。

Hamza Khalid - inline image

这里有一个真实的、可复制粘贴的模板,你马上就能用:

text
1# 项目是什么
2[用一句话描述你在构建什么]
3例如:"这是一个新闻通讯系统,可以把我的笔记转换成 Substack 文章。"
4
5# 我的工具
6- 我用 [你的写作工具] 写作
7- 我在 [你的平台] 发布
8- 我把文件存储在 [你的文件存放位置]
9
10# 我的规则 — 每次会话都要读
111. 未经询问,永远不要删除任何文件 — 因为我没有备份
122. 在行动之前,总是先展示你要做什么 — 因为需要我批准更改
133. 回复要简短清晰 — 因为我不是技术人员,长篇大论会让我困惑
144. 如果不确定,就问 — 因为猜比问更糟糕
155. 未经许可,不要更改设计或布局 — 因为品牌形象很重要
16
17# 我目前正在做什么
18[快速写一下你当前的项目或任务]
19
20# 之前出过问题的地方
21[可选:列出 Claude 在之前的会话中搞砸过的事情,避免重蹈覆辙]

如何填写:

  1. 在 Claude Code 中运行 /init,它会自动为你的项目创建一个入门版本
  2. 打开它创建的那个文件,把通用文本替换成你的真实信息
  3. 保持在 200 行以内,越短越清晰越好。Claude 会遵循它

第 3 步:设置你的安全卫士 (Hooks)

常规指令很好。但有些规则必须是绝对的。

这就是 Hooks 的作用。把它们想象成一个站在 Claude 每个行动门口的安全卫士。在 Claude 做任何事情之前,卫士都会检查规则。如果规则说不,它就会阻止。

Hamza Khalid - inline image

下面是用通俗语言描述的 hooks:

规则 1 — 事前检查 (PreToolUse) "在 Claude 做出任何更改之前,检查它是否要触碰重要的东西。如果是,停下来先问我。"

规则 2 — 事后检查 (PostToolUse) "在 Claude 做出更改之后,自动运行一次质量检查,标记任何看起来不对劲的地方。"

规则 3 — 通知 (Notification) "当重要的事情发生时,给我发个提醒,让我知道发生了什么。"

你的安全规则文件内部实际上是这样的:

text
1{
2 "PreToolUse": [{
3 "matcher": "any file change",
4 "hooks": [{
5 "type": "command",
6 "command": "./hooks/check-before-changing.sh"
7 }]
8 }],
9 "PostToolUse": [{
10 "matcher": "any write",
11 "hooks": [{
12 "type": "command",
13 "command": "./hooks/check-after-changing.sh"
14 }]
15 }]
16}

翻译: 在触碰任何东西之前,运行一次检查。在触碰任何东西之后,再运行一次检查。

退出代码就像红绿灯。代码 0 = 绿灯,继续。代码 2 = 红灯,完全停止。

在这里停一下。

我知道这一步看起来最技术。其实不是。关键要理解的是:hooks 是你设置中 Claude 真正无法忽略的部分。其他一切,你的 CLAUDE.md、你的规则、你的偏好,如果 Claude 认为自己更懂,它理论上可以覆盖。但 hooks 不能被覆盖。这就是它们重要的原因。设置一次,然后就不用管了。

第 4 步:创建你的专家 (技能)

对于非技术人员来说,这里的乐趣才刚刚开始。

技能 (Skill) 是一个预先写好的专家,Claude 在识别到合适的时机时会自动召唤它。你不是在训练模型。你只是在用简单的英语描述一个你希望随时待命的专家。

Hamza Khalid - inline image

这里有一个真实的例子。这是一个"质量审阅者"技能:

text
1名称: quality-reviewer
2
3这个专家做什么:
4审阅我创建的任何作品,检查:
5- 拼写和语法错误
6- 任何听起来令人困惑或不清晰的内容
7- 遗漏的信息
8- 任何不符合我通常风格的内容
9
10如何使用: 在完成任何重要工作后调用。
11
12要寻找什么: 仔细阅读作品。列出所有问题。不要修复它们——只需指出。
13
14要返回什么: 一份简短的发现列表。对每个问题评级为轻微、中等或严重。

就是这样。Claude 读到这个就知道它在跟什么样的专家对话。

神奇之处在于: 你可以为任何事情设立一个专家。一个"语气检查员",确保所有内容听起来都像你。一个"标题写手",把你的标题改得更有吸引力。一个"简化器",把复杂的文本变成易读的文字。你只需写一次职位描述。Claude 会在需要时自动调用相应的专家。

第 5 步:设置你的第二意见 (子 Agent)

这是大多数人从不使用的质量关卡。而它正是能抓住最多错误的一个。

子 Agent (Subagent) 是一个全新的 Claude 副本,它用零上下文从你的主会话中查看完成的工作。

想象一下,在发送之前请一位同事审阅你的工作。只不过这位同事速度快、从不疲倦,而且没有理由只告诉你你想听的话。

Hamza Khalid - inline image

下面是一个简单的子 Agent 设置:

text
1名称: second-opinion-checker
2
3这个审阅者做什么:
4查看完成的工作,检查它是否真的不错。
5不知道工作是如何创建的。
6
7要检查什么:
8- 这真的回答了所问的问题吗?
9- 有什么遗漏吗?
10- 对于一个第一次看到的人来说,这看起来像是高质量的工作吗?
11
12重要规则: 这个审阅者只能阅读。不能做修改。
13只报告发现。

关键规则:

你的第二意见检查器永远不应该被允许做修改。它只能阅读和报告。就这样。如果它可以编辑,它就会成为问题的一部分,而不是解决方案。

第 6 步:运行日常工作流

设置到位后,每次 Claude Code 会话都遵循相同的简单模式。

Hamza Khalid - inline image

早晨启动:

text
1打开你的项目文件夹 → 输入 "claude" → 按 Enter

在 Claude 写任何东西之前:Shift + Tab 进入计划模式。这会让 Claude 在做之前准确告诉你它要做什么。审阅计划。批准它。然后让它工作。

会话期间: 每 10-15 分钟输入 /compact。这会压缩对话,这样 Claude 就不会因为太多历史记录而困惑。

完成任务后: 保存你的工作,为下一个任务开始一个新的会话。不要让一个会话永远运行下去。新的会话意味着新的思维。

两个值得记住的键盘快捷键:

  • Shift + Tab → 计划模式(Claude 先向你展示计划)
  • Esc Esc → 撤销(撤消 Claude 所做的最后一步)

这就是整个日常模式。计划。批准。执行。检查。保存。新会话。

实际用例(针对非技术人员)

内容创作者: 每完成一个内容后使用质量审阅者技能。使用语气检查技能确保所有内容听起来像你,而不是像 AI。使用标题写手技能为每篇文章获得 5 个标题选项。

企业主: 使用 CLAUDE.md 存储你的品牌规则、客户画像和产品细节。Claude 会在每次会话中自动引用这些内容,你无需重复。

新闻通讯作者: 使用 Hooks 确保 Claude 未经你的审阅绝不发布任何内容。使用子 Agent 在每期上线前检查其清晰度。

自由职业者: 为每个客户创建一个单独的 CLAUDE.md。切换项目时切换这些文件。Claude 会自动适应每个客户的规则和偏好。

这些才是重要的用例。从适合你工作的一个开始。后续再增加更多。

20 秒总结

→ 先创建文件夹结构,再做其他事情。

→ 用真实规则编写你的 CLAUDE.md 操作手册。

→ 为绝不能打破的规则设置 Hooks。

→ 为你重复超过三次的任务添加技能。

→ 在输出前使用子 Agent 检查完成的工作。

保存它。截屏它。以后回来再看。

你现在对 Claude Code 最大的不满是什么?

  • 它老是忘记我的指令
  • 我不知道如何正确设置
  • 我不确定从哪里开始

在下面评论,这将帮助我们为你创建下一个专门的指南。我会阅读并回复每一条评论。

你的免费入门套件——说到做到:

我要向我的新闻通讯订阅者发送一份价值 $99 的 Claude Code 入门套件。

里面有什么:

→ 预先填好的 CLAUDE.md 模板(5 分钟即可就绪)

→ 今天就能用的质量审阅者技能

→ 子 Agent 设置模板

它会在下一期新闻通讯中发出。

免费订阅 → https://substack.com/@humzakhalid

下一期: 我将在 Claude Code 内部测试 /goal 功能,这个功能可以在整个会话中锁定你的意图,让 Claude 永远不会跑偏。这是他们今年推出的最大的生活质量更新。别错过。

我们已经在公开场合测试过了。现在私下使用吧。

下一篇见。

— Hamza 💙

一键保存

使用 YouMind AI 深度阅读爆款文章

保存原文、追问细节、总结观点,并在一个 AI 工作空间里把爆款文章沉淀成可复用笔记。

了解 YouMind
写给创作者

把你的 Markdown 变成干净的 𝕏 文章

图片上传、表格、代码块,往 𝕏 上手动重排太痛苦。YouMind 把整篇 Markdown 一键转成干净、可直接发布的 𝕏 文章草稿。

试试 Markdown 转 𝕏

更多可拆解样本

近期爆款文章

探索更多爆款文章