@humzaakhalid: 大多数开发者都在错误地使用Claude Code(100%)Claude Code在90秒内就能修复。具体方法如下:1. 开始…
摘要
一份关于如何有效使用Claude Code的详细指南,包括设置、CLAUDE.md配置、四层架构、钩子以及日常工作流程模式。
查看缓存全文
缓存时间: 2026/06/24 10:22
大多数开发者都在错误地使用Claude Code(100%)
Claude Code在90秒内就能解决。
具体方法如下:
- 快速启动
→ 一条curl命令,Claude Code就能扫描你的代码库。 → 首次运行时会自动生成一个starter CLAUDE.md 文件。 → 唯一的要求是Node.js 18+。这就已经完成了全部设置。
- CLAUDE.md
→ CLAUDE.md 是Claude Code的大脑,每次会话都会重新加载。 → 把你的技术栈、架构和已知问题都放进去。 → 保持在200行以内。简洁迫使清晰。
- 四层架构
→ 第一层:CLAUDE.md 首先加载上下文和行为规则。 → 第二层:当Claude检测到任务类型时,技能(Skills)会自动调用。 → 第三层:钩子(Hooks)是不可绕过的安全门。 → 第四层:代理(Agents)在隔离窗口中运行,以保护上下文。
- 设置钩子
→ 钩子确定性触发,相同输入,相同输出,始终如此。 → 使用 PreToolUse、PostToolUse 和 Notification 钩子类型。 → 退出码 0 表示允许。退出码 2 表示阻止。没有其他情况。
- 日常工作流模式(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…
获取更多有用内容:
- 订阅 https://substack.com/@humzakhalid
- 收藏本文,你以后会用到
- 转发分享给你的朋友。
如何构建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:输出技能:**这些涵盖特定的文件类型——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会生成技能文件。
**第十步:**保存技能文件。
- AI与科技相关的缩略图:
- 励志与自我控制相关的缩略图:
- 财富与金融相关的缩略图:
如果有错误,只需以“/”开头输入其触发名称来编辑技能,然后告诉Claude你想编辑什么。之后再次保存文件并再次检查结果。
现在你的技能已经开发好了。
以下是大多数人直到尝试过一次才会想到的用法:关于你如何写作的技能。
一个语气技能存储了你的语气、格式偏好、词汇规则和禁止使用的短语。每次Claude代表你写作时,它都会先读取这个文件。
快速设置:
- 创建
/my-voice/SKILL.md - 包含:语气描述、句子长度偏好、你从不使用的词汇、你总是使用的词汇,以及你的署名方式
- 添加示例——你写作的真实样本,标注为“好的”,以及标注为“不是我的语气”的输出。
``
名称: my-voice 描述: 任何以我的身份写作时——邮件、帖子、通讯、回复或以我名义发布的任何文本——都使用此技能。
我的语气
- 直接。没有废话。每句话都有存在的价值。
- 短句。如果可以拆分,就拆分。
- 我从不使用:“利用”、“协同”、“最终”、“保持联系”
- 我总是以明确的下一步行动结束邮件,而不是模糊的结尾
我的语气示例
[在此粘贴3-5个你自己写作的真实样本] ``
“示例部分比所有规则都更有价值。Claude通过模式而不是描述来学习语气。展示给它。不要仅仅告诉它。”
在继续之前——暂停一下。你即将编写你的第一个技能。我知道它看起来像是一个小型markdown文件。但它不小。这一个文件将比你写过的100个提示词更持久。你今天写的提示词下周就会被重写。你今天编写的技能将会在后台运行数月。花15分钟在上面。让它具体化。它的效果会不断累积。
- 内容创作者
存储你的通讯格式、章节结构和字数规则。停止在每个提示中重复解释你的格式。技能只需一次设置,永久生效。
- 开发者 存储你的技术栈、命名约定、禁止使用的模式。Claude不再推荐你不用的库,并开始编写适合你代码库的代码。
- 顾问和自由职业者
为每个项目创建一个客户技能。存储他们的品牌语气、偏好的输出格式和术语。让Claude适应新客户只需20分钟,而不是20个提示。
- 使用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 模板。
包括:
- 缩略图生成技能
- 脚本编写技能
- 提示词工程师技能
点击下面的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)
成为付费订阅者
相似文章
@techNmak: 终于有人整理了如何真正使用 Claude Code 的文档。58K+ 星。claude-code-best-practice。直接来自 Boris Ch…
一份获得 58K+ 星的综合指南,介绍使用 Claude Code 的最佳实践,涵盖来自 Boris Cherny 和社区的技巧,以及最大化代理工程的工作流。
@humzaakhalid: Karpathy 刚刚把所有开发者从第一天起就需要的 Claude Code 配置文件交给了大家。65 行代码,110K 星标。这个作弊码…
Andrej Karpathy 创建了 CLAUDE.md,一个 65 行的配置文件,为 Claude Code 提供明确的规则,避免常见陷阱如默认假设和代码膨胀,极大提升开发者效率。
@akshay_pachaar: 如何设置你的 Claude Code 项目? TL;DR 大多数开发者跳过设置直接开始提示。这是错误…
使用 .claude/ 文件夹结构设置 Claude Code 项目的指南,包括 CLAUDE.md、规则、命令、技能、代理和权限的配置。
@PratikKadam_: 7 个 Claude Code 功能,让你领先 99% 的用户(大多数人只用其中 2 个)我花了 1000 多个小时……
一份指南,详细介绍了 7 个高级 Claude Code 功能——包括 CLAUDE.md 记忆文件、superpowers 插件、hooks、并行代理、会话压缩、定时代理和远程控制——帮助开发者通过一次性设置并让 AI 高效运行来加速交付。
luongnv89/claude-howto
一份全面、结构化的指南,帮助掌握 Claude Code 的功能,包括斜杠命令、钩子、技能、MCP 服务器和子代理,配有可视化教程、复制粘贴模板,以及从新手到高级用户的分阶段学习路径。