@humzaakhalid: 大多数开发者都在错误地使用Claude Code(100%)Claude Code在90秒内就能修复。具体方法如下:1. 开始…

X AI KOLs Timeline 工具

摘要

一份关于如何有效使用Claude Code的详细指南,包括设置、CLAUDE.md配置、四层架构、钩子以及日常工作流程模式。

大多数开发者都在错误地使用Claude Code(100%) Claude Code能在90秒内快速修复。 具体方法如下: 1. 开始使用 → 只需一个curl命令,Claude Code就会扫描你的代码库。 → 首次运行时,它会生成一个起步用的CLAUDE.md文件。 → 唯一的要求是Node.js 18+。这就是全部设置。 2. CLAUDE.md → CLAUDE.md是Claude Code的大脑,每次会话都会重新加载。 → 把你的技术栈、架构和已知bug放进去。 → 保持200行以内。简洁迫使清晰。 3. 四层架构 → L1: CLAUDE.md首先加载上下文和行为规则。 → L2: 当Claude检测到任务类型时,技能会自动调用。 → L3: 钩子是安全闸门,无法绕过。 → L4: 代理在隔离窗口中运行以保护上下文。 4. 设置钩子 → 钩子确定性地触发,相同输入,相同输出,始终如此。 → 使用PreToolUse、PostToolUse和Notification钩子类型。 → 退出码0允许,退出码2阻止,没有其他选项。 5. 日常工作流程模式(四个阶段) → 打开你的项目,运行claude,然后按Shift+Tab。 → 在Claude写任何代码之前,说明你的意图。 → 运行/compact来修剪上下文,然后频繁提交。 ---- 如果你想通过实用指南全面学习,我花了几个月制作了关于Claude的指南,这样你就不必了: ✦ Claude Skills: https://humzakhalid.substack.com/p/how-to-build-claude-skills… ✦ Claude in Excel: https://humzakhalid.substack.com/p/excel-just-got-a-new-friend… ✦ Claude Artifacts: https://humzakhalid.substack.com/p/how-to-build-an-app-with-claude-artifacts… ✦ Claude for Chrome: https://humzakhalid.substack.com/p/claude-for-chrome… ✦ Claude Connectors: https://humzakhalid.substack.com/p/stop-using-7-apps-to-do-just-1-thing… ✦ Build Loops: https://humzakhalid.substack.com/p/stop-prompting-claude-build-loops… ✦ Claude Skills Mistakes: https://humzakhalid.substack.com/p/stop-building-claude-skills-like… ✦ Videos with Claude: https://humzakhalid.substack.com/p/how-to-create-videos-using-claude… ✦ Claude Design: https://humzakhalid.substack.com/p/how-to-use-claude-design-like-anthropic… ✦ Claude + Higgsfield: https://humzakhalid.substack.com/p/claude-just-became-a-video-studio… ✦ Claude Loops: https://humzakhalid.substack.com/p/7-advanced-claude-loops-that-run… ✦ Second Brain: https://humzakhalid.substack.com/p/i-set-up-my-second-brain-in-under… ---- 更多实用内容: 1. 在https://substack.com/@humzakhalid订阅 2. 收藏本文,因为你以后会用到 3. 转发此文,与你的朋友分享。
查看原文
查看缓存全文

缓存时间: 2026/06/24 10:22

大多数开发者都在错误地使用Claude Code(100%)

Claude Code在90秒内就能解决。

具体方法如下:

  1. 快速启动

→ 一条curl命令,Claude Code就能扫描你的代码库。 → 首次运行时会自动生成一个starter CLAUDE.md 文件。 → 唯一的要求是Node.js 18+。这就已经完成了全部设置。

  1. CLAUDE.md

→ CLAUDE.md 是Claude Code的大脑,每次会话都会重新加载。 → 把你的技术栈、架构和已知问题都放进去。 → 保持在200行以内。简洁迫使清晰。

  1. 四层架构

→ 第一层:CLAUDE.md 首先加载上下文和行为规则。 → 第二层:当Claude检测到任务类型时,技能(Skills)会自动调用。 → 第三层:钩子(Hooks)是不可绕过的安全门。 → 第四层:代理(Agents)在隔离窗口中运行,以保护上下文。

  1. 设置钩子

→ 钩子确定性触发,相同输入,相同输出,始终如此。 → 使用 PreToolUse、PostToolUse 和 Notification 钩子类型。 → 退出码 0 表示允许。退出码 2 表示阻止。没有其他情况。

  1. 日常工作流模式(4个阶段) → 打开你的项目,运行 claude,然后按 Shift + Tab。 → 在Claude写一行代码之前,先说清楚你的意图。 → 运行 /compact 来精简上下文,然后频繁提交。

如果你想通过实践指南完全掌握,我花了几个月时间创建了关于Claude的指南,这样你就不用自己摸索了:

✦ Claude 技能:https://humzakhalid.substack.com/p/how-to-build-claude-skills… ✦ Excel中的Claude:https://humzakhalid.substack.com/p/excel-just-got-a-new-friend… ✦ Claude Artifacts:https://humzakhalid.substack.com/p/how-to-build-an-app-with-claude-artifacts… ✦ Claude 浏览器扩展:https://humzakhalid.substack.com/p/claude-for-chrome… ✦ Claude 连接器:https://humzakhalid.substack.com/p/stop-using-7-apps-to-do-just-1-thing… ✦ 构建循环:https://humzakhalid.substack.com/p/stop-prompting-claude-build-loops… ✦ Claude 技能常见错误:https://humzakhalid.substack.com/p/stop-building-claude-skills-like… ✦ 用Claude制作视频:https://humzakhalid.substack.com/p/how-to-create-videos-using-claude… ✦ Claude 设计:https://humzakhalid.substack.com/p/how-to-use-claude-design-like-anthropic… ✦ Claude + Higgsfield:https://humzakhalid.substack.com/p/claude-just-became-a-video-studio… ✦ Claude 循环:https://humzakhalid.substack.com/p/7-advanced-claude-loops-that-run… ✦ 第二大脑:https://humzakhalid.substack.com/p/i-set-up-my-second-brain-in-under…


获取更多有用内容:

  1. 订阅 https://substack.com/@humzakhalid
  2. 收藏本文,你以后会用到
  3. 转发分享给你的朋友。

如何构建Claude技能。

来源:https://humzakhalid.substack.com/p/how-to-build-claude-skills 大多数人把Claude当成搜索栏来用。

输入一个请求。阅读输出。稍作修改。继续下一个。

这种工作流程有效,但它浪费了80%的能力。

我的意思是:Claude内部有一个叫做“技能(Skills)”的系统。你从未在发布公告中见过它。它没有设置开关。但一旦你理解了它,你就不会再以同样的方式写提示词了。

读完本期通讯后,你将获得三个可以直接使用的SKILL.md 文件。你可以上传文件并构建自己的技能。

两周前,我在Claude的计算机使用环境中构建一个Word文档流水线。每一个输出在技术上看起来都没问题——正确的结构、合适的格式——但总有哪里不太对劲。错误的页边距。缺失的样式。导出的表格断裂。

我花了4个小时调试单个提示词,然后偶然发现了文件系统中隐藏的东西:一个名为/skills/的文件夹,里面全是.md文件。每一个文件都是一组针对特定输出类型的密集规则、约束和最佳实践。Claude本应在处理任何文件之前读取它们。

但我之前没有告诉它这么做。这就是为什么一切都出错的原因。

当我添加了先阅读相关SKILL.md 的指令后——输出从“差不多正确”变成了“可以发送”,仅仅一次运行。

以下是在Claude内部创建任何技能的确切方法:

如果此文有用,请分享给一个需要它的人。只需10秒钟。 分享 (https://humzakhalid.substack.com/p/how-to-build-claude-skills?utm_source=substack&utm_medium=email&utm_content=share&action=share)

**旧方法:**写一个长提示词。希望Claude能理解约束。手动修正输出。重复。

**新方法:**将约束一次性存储在SKILL.md 文件中。Claude在每次任务前都会读取它。输出第一次就是正确的。

旧方法:提示词 → 平庸输出 → 手动修正 → 再试一次。

新方法:技能 → 提示词 → 可用输出 → 完成。

区别不在于Claude的智能,而在于Claude在一开始是否有正确的上下文。

技能就是一个普通的Markdown文件(.md)。没什么特别的。

它位于项目或计算机使用环境中的/skills/文件夹中。Claude在编写代码、创建文件或运行命令之前会扫描该文件夹。当任务与技能匹配时,Claude会先读取它——然后再行动。

把它想象成你的新员工在第一天上班前阅读的简介文件。没有它,他们只能猜测。有了它,他们就知道了你的确切标准。

格式很简单:

`` 名称: docx 描述: [何时触发此技能]

应该做什么

不应该做什么

环境特定约束

示例

``

就这么简单。纯文本。没有特殊语法。没有配置文件。

力量在于内容——以及让Claude真正去查阅它。

在构建任何东西之前,先了解你要构建什么。

快速设置:

  1. 技能分为三个清晰的类别
  2. 将类型与你想要解决的问题相匹配
  3. 不要将三种类型混入一个文件——一个技能,一个任务

**类型1:输出技能:**这些涵盖特定的文件类型——Word文档、PDF、电子表格、幻灯片。它们编码了普通提示词忽略的约束:哪些Python库可用,环境如何渲染某些元素,以及导出时会出什么问题。

示例:docx,pdf,pptx,xlsx

**类型2:工作流技能:**这些定义了Claude如何处理重复性任务——编写通讯稿、进行代码审查、起草销售邮件。它们编码了你的个人标准、偏好的格式以及不可妥协的要点。

示例:newsletter writing,code-review,client-proposal

**类型3:上下文技能:**这些存储了Claude从训练中无法知道的事实——你公司的语气指南、你产品的技术栈、你受众的人口统计数据。它们不是指令。它们是背景信息。

示例:brand-voice,product-knowledge,team-structure

大多数人编写的技能太长、太模糊或太理论化。Claude草草浏览并忽略了一半内容。

第一步:前往Claude.ai,用Gmail登录,然后打开一个新聊天。

第二步:点击新聊天中的“+”图标,然后点击“技能”。

**第三步:**点击“管理技能”。

**第四步:**再次点击“+”,然后点击“创建技能”。

**第五步:**点击“与Claude一起创建”。

第六步:第一个提示会自动输入;只需按下回车键。

第七步:Claude会问几个与你技能相关的问题,回答它们即可。

第八步:上传文件供Claude分析。

你上传用于分析的文件越多,技能就越强大,该技能的结果也更准确。

第九步:所有分析完成后,Claude会生成技能文件。

**第十步:**保存技能文件。

**第十一步:**现在测试你技能的结果。

  1. AI与科技相关的缩略图:

  1. 励志与自我控制相关的缩略图:

  1. 财富与金融相关的缩略图:

如果有错误,只需以“/”开头输入其触发名称来编辑技能,然后告诉Claude你想编辑什么。之后再次保存文件并再次检查结果。

现在你的技能已经开发好了。

以下是大多数人直到尝试过一次才会想到的用法:关于你如何写作的技能。

一个语气技能存储了你的语气、格式偏好、词汇规则和禁止使用的短语。每次Claude代表你写作时,它都会先读取这个文件。

快速设置:

  1. 创建/my-voice/SKILL.md
  2. 包含:语气描述、句子长度偏好、你从不使用的词汇、你总是使用的词汇,以及你的署名方式
  3. 添加示例——你写作的真实样本,标注为“好的”,以及标注为“不是我的语气”的输出。

``

名称: my-voice 描述: 任何以我的身份写作时——邮件、帖子、通讯、回复或以我名义发布的任何文本——都使用此技能。

我的语气

  • 直接。没有废话。每句话都有存在的价值。
  • 短句。如果可以拆分,就拆分。
  • 我从不使用:“利用”、“协同”、“最终”、“保持联系”
  • 我总是以明确的下一步行动结束邮件,而不是模糊的结尾

我的语气示例

[在此粘贴3-5个你自己写作的真实样本] ``

“示例部分比所有规则都更有价值。Claude通过模式而不是描述来学习语气。展示给它。不要仅仅告诉它。”

在继续之前——暂停一下。你即将编写你的第一个技能。我知道它看起来像是一个小型markdown文件。但它不小。这一个文件将比你写过的100个提示词更持久。你今天写的提示词下周就会被重写。你今天编写的技能将会在后台运行数月。花15分钟在上面。让它具体化。它的效果会不断累积。

  1. 内容创作者

存储你的通讯格式、章节结构和字数规则。停止在每个提示中重复解释你的格式。技能只需一次设置,永久生效。

  1. 开发者 存储你的技术栈、命名约定、禁止使用的模式。Claude不再推荐你不用的库,并开始编写适合你代码库的代码。
  2. 顾问和自由职业者

为每个项目创建一个客户技能。存储他们的品牌语气、偏好的输出格式和术语。让Claude适应新客户只需20分钟,而不是20个提示。

  1. 使用API构建的运营人员

技能是系统提示词的一部分,你可以单独维护并干净地注入。模块化、版本化、可重用。比一个3000字的单一系统提示词干净得多。

这些才是真正重要的用例。在你搞定这些之前,先跳过其他的。

这份通讯得益于您的分享。如果您觉得有价值,请传递下去。 分享 (https://humzakhalid.substack.com/p/how-to-build-claude-skills?utm_source=substack&utm_medium=email&utm_content=share&action=share)

一套新手技能工具包:3个可定制的SKILL.md 模板。

包括:

  1. 缩略图生成技能
  2. 脚本编写技能
  3. 提示词工程师技能

点击下面的Notion链接,获取可直接复制粘贴的技能:

点击这里 (https://www.notion.so/hamzakhalid/3-Claude-Skills-that-you-must-know-35e5696139f280e6ab3ff64a948dabf2?source=copy_link)获取你的礼物。

从一个技能开始。选择你最常重复任务的技能。然后在此基础上构建。

过去两周,我花时间构建了一个面向内容创作者的提示词库 (https://www.notion.so/hamzakhalid/150-Content-Creation-and-Social-Media-Posts-Creation-Prompts-35f5696139f2808684add7bccfb1f17d),包含150个结构化提示,涵盖所有社交媒体平台的内容创作。今天我将完整地免费赠送。

以下是你可能错过的一些期(去看看):

  • 如何精通Excel中的Claude (https://humzakhalid.substack.com/p/excel-just-got-a-new-friend?r=31a9dk)
  • 如何整周使用Claude而不受限制 (https://humzakhalid.substack.com/p/i-stopped-hitting-claudes-usage-limits?r=31a9dk)

如果本期对你有帮助,请转发给一个需要的人。这是免费的,只需10秒钟。分享总是关爱:)

分享 (https://humzakhalid.substack.com/p/how-to-build-claude-skills?utm_source=substack&utm_medium=email&utm_content=share&action=share)

成为付费订阅者

相似文章

luongnv89/claude-howto

GitHub Trending (daily)

一份全面、结构化的指南,帮助掌握 Claude Code 的功能,包括斜杠命令、钩子、技能、MCP 服务器和子代理,配有可视化教程、复制粘贴模板,以及从新手到高级用户的分阶段学习路径。