如果你想自己做老板，那今天就得给自己留出 30 分钟。
因为今天，我会教你如何在一个下午内，用零编程知识，构建一个真正能用的 AI Agent。
别把我接下来要说的东西和聊天机器人混为一谈。聊天机器人等着你问问题，然后给答案。Agent 的工作方式不同：你给它一个目标，它自己制定步骤，读取文件，运行命令，然后自主推进，直到任务完成。你不需要管理它的每一步，只需要画好路线。
这个区别很重要，因为你不再需要一条一条地写提示词。当你在忙其他事情的时候，任务自己就在推进。
需要准备什么？
安装前你需要准备的东西都在这里：
- 付费的 Claude 计划（Pro，每月 20 美元，包含 Claude Code）
- Mac（macOS）、Windows 或 Linux 电脑
- 网络连接
- 30-45 分钟的空闲时间
不需要编程知识。每条命令都会完整给出，你只需要复制粘贴然后按回车。
没有额外费用。除了订阅费之外，你不需要多花一分钱。
安装：桌面应用，无需终端
对初学者来说，最简单的方式是使用桌面应用。它把 Claude Code 的所有功能都放在你手边，无需学习终端操作。
通过 claude.ai 下载适合你操作系统的桌面应用。在 Mac 上，打开 .dmg 文件，把 Claude 拖到 Applications 文件夹；在 Windows 上，运行安装程序。打开应用，用你的账户登录，然后点击顶部中央的 Code 标签。
如果 Code 标签要求你升级计划，说明你当前的计划不包含 Claude Code。如果它要求你在线登录，完成登录后重启应用。无论哪种情况，最终你都会进入一个空的工作区。
成功进入的标志是：一个空的提示框、一个激活的 Code 标签，并且没有错误信息。你接下来构建的所有东西都会在这个区域里。
我们要构建什么？
我们将构建一个单一且清晰的 Agent；我们会一直使用同一个 Agent 直到文章结束。
它的任务是：读取一个文件夹里的文本文件，找出那些缺少标题的文件，然后生成一份名为 missing-titles.txt 的报告，列出需要你修复的文件。
一个虽小但真实的任务。它包含了 Agent 应该做的三件基本事情：读取文件、做出决策、写入输出。而且它足够简单，你可以亲眼验证它是否工作正常。
第一步：创建工作文件夹
在你的桌面上创建一个名为 my-agent 的文件夹。Agent 会在这里工作；它只能看到和操作这个文件夹内部的内容，所以一切都很安全。
在 my-agent 文件夹内，再创建一个名为 articles 的子文件夹。Agent 会在这里寻找它要检查的文件。
在 articles 文件夹内创建四个纯文本文件：post-one.txt、post-two.txt、post-three.txt、post-four.txt。打开其中两个文件，在最顶部写上：
Title: My Article
另外两个文件保持完全空白。Agent 的任务就是找到这些空白的文件。
你的文件夹结构应该是 my-agent/articles/，里面包含四个 .txt 文件，两个有标题，两个没有。
第二步：编写 CLAUDE.md 指令文件
CLAUDE.md 是一个纯文本文件，Claude Code 会在每次会话开始时读取它。把它想象成你 Agent 的固定指令，一份它永远不会忘记的工作说明书。
在 my-agent 文件夹内（不是在 articles 里面），创建一个名为 CLAUDE.md 的新文件。用任何文本编辑器打开它——Windows 上用记事本，Mac 上用文本编辑——然后精确地粘贴以下内容：
# 我的文件检查 Agent ## 你的任务 检查 /articles 文件夹中的每一个 .txt 文件。
## 检查什么 一个有效的文件以这一行开头：Title: 如果第一行不是以 "Title:" 开头，则该文件缺少标题。
## 做什么 1. 逐一读取 /articles 内的每一个 .txt 文件。 2. 记录哪些文件缺少标题。 3. 在主文件夹中创建一个名为 missing-titles.txt 的文件。 4. 将每个未通过检查的文件名写入此文件，每行一个。 5. 如果所有文件都有效，则在 missing-titles.txt 中写入 "All files have titles."。
## 不要做什么 不要编辑任何文章文件。只读取。只写入 missing-titles.txt 文件。
保存文件。这就是你 Agent 的整个大脑。Claude Code 会在做任何事之前先读取它。
my-agent/CLAUDE.md 文件已创建，并包含上述指令，仅此而已。
第三步：让 Claude Code 指向文件夹
打开 Claude Code 桌面应用，点击文件夹图标或 "Open folder" 选项，然后选择 my-agent 文件夹。确认选择。
Claude Code 会自动读取你的 CLAUDE.md 文件。你不会看到任何确认消息；每次你打开一个文件夹时，这都会在后台静默发生。
如果你使用终端，打开终端并运行以下命令：
cd ~/Desktop/my-agent claude
cd 命令的意思是 "改变目录"；它会将你移动到 my-agent 文件夹内。输入 claude 会从该文件夹启动会话。
第四步：运行 Agent
在 Claude Code 界面底部的提示框中，精确输入以下内容：
读取 articles 文件夹中的每一个 .txt 文件。找出任何顶部缺少 Title 行的文件。按照 CLAUDE.md 中的指示，将结果写入 missing-titles.txt。
按回车。然后观察。
Claude Code 会向你展示它在工作时所做的每一步：它读取了哪个文件，在每个文件中发现了什么，以及它写入了什么。这种透明度是设计使然。你可以在每个操作发生之前看到它，如果发现异常，可以随时停止。
Claude 读取了四个文件，检测到两个没有标题，然后在你的 my-agent 文件夹中创建了 missing-titles.txt 文件。当你打开它时，你应该能看到两个文件名上下排列。
最常见的错误：Agent 说 "完成" 但文件是空的
这通常发生在 Agent 创建了 missing-titles.txt 文件，但里面什么也没写。原因几乎总是 CLAUDE.md 中的指令太模糊。
解决方案：打开 CLAUDE.md，让输出指令更具体。不要写 "列出文件"，而是写 "将每个文件名单独写在一行，例如：post-two.txt"。在指令中加入一个具体的例子，每次都能让输出变得具体。
如果 Agent 写错了文件名或跳过了某个文件，请确保你的文章文件确实有 .txt 扩展名，而不是 .txt.txt。这在 Windows 上隐藏文件扩展名时经常发生。从文件资源管理器设置中打开 "显示文件扩展名" 并检查。
第五步：验证和扩展
打开 missing-titles.txt 文件，验证你留空的那两个文件是否被列出。如果正确，说明你的 Agent 从头到尾都工作正常。
现在你有了一个能工作的 Agent。它存在于 my-agent 文件夹中，从 CLAUDE.md 获取指令，当你把新文件放入 articles 文件夹时，你可以用同样的提示词再次运行它。
下一步很明确：更新 CLAUDE.md，让它也检查每个文件是否超过五行。在 "检查什么" 标题下添加以下内容：
**一个有效的文件还应该包含超过 5 行的内容。 如果一个文件只有 5 行或更少，请在标题检查旁边也将其标记为 "太短"。**
用同样的提示词再次运行 Agent。现在它会检查两件事而不是一件；你没有修改提示词，只修改了指令文件。
你做了什么，为什么这很重要？
你构建了一个能读取文件、做出决策、写入输出，并且不需要你监督每一步的 Agent。这是你未来构建所有更高级 Agent 的基本模式。
真正能扩展的部分是 CLAUDE.md。你每在那里添加一条新规则、一项新检查、一种新输出格式，都会改变 Agent 的行为，而你运行它的方式却不需要改变。提示词保持不变，指令在进化。
从这里自然的下一步是：检查更多文件类型，以 CSV 等不同格式编写报告，或者让检查在特定时间间隔自动重复。
恭喜你，你已经迈出了第一步；剩下的就靠你自己了，你的想象力有多大，它就能走多远。
在差距扩大之前采取行动。
别忘了点赞、分享和评论支持。
