如何使用 Claude Code 构建你的第一个 AI Agent（零基础入门教程）

了解如何安装 Claude Code，从头开始编写你的第一个 Agent，并最终得到一个真正有用的成果：一个能够读取文件夹、发现问题和撰写报告的工作 Agent，全程无需任何编程经验。

聊天机器人会等待你提问并给出回答。而 AI Agent 则不同：你给它一个目标，它自己会规划步骤、读取文件、运行命令，并自主采取行动，直到任务完成。你不需要驱动每个动作，只需设定好目的地。

这个区别很重要，因为它改变了你能够自动化的内容。你不再是一次一个地输入提示词，而是在构建一个能替你完成工作、让你专注于其他事情的工具。

开始之前需要准备什么

以下是开始操作前你需要准备好的一切：

• 一个带付费计划的 Claude 账户（最低要求 Pro 版 $20/月；Claude Code 已包含在内）
• 一台运行 macOS 13 或更高版本的 Mac，或 Windows PC，或 Linux 机器
• 一个网络连接
• 大约 30 到 45 分钟来完成完整设置和首次构建

无需编程经验。本指南中的每条命令都已完整写出，你只需复制、粘贴，然后按回车即可。

跟随本指南的成本：除了订阅费用外无需额外花费。Claude Code 已包含在所有的 Claude 付费计划中。

安装 Claude Code（桌面应用方式，无需终端操作）

对于初学者来说，最简单的路径是使用桌面应用。它让你无需先学习终端命令就能使用 Claude Code 的全部功能。

前往 claude.ai 下载适合你平台的桌面应用。在 macOS 上，打开 .dmg 文件，将 Claude 拖入应用程序文件夹。在 Windows 上，运行安装程序。启动应用，使用你的 Claude 账户登录，然后点击屏幕顶部中央的 Code 标签。

如果 Code 标签要求你升级计划，说明你当前的计划不包含 Claude Code。如果要求你在线登录，完成登录后重启应用。无论哪种情况，你都会进入一个干净的工作区。

成功标志：你会看到一个空白的提示框，Code 标签处于激活状态，且没有错误信息。这就是你的 Agent 工作区。你构建的一切都将在这里完成。

你要构建的内容

你要构建一个特定的 Agent，并将在本指南中一直使用它。

这个 Agent 的任务：读取一个包含文本文件的文件夹，找出任何顶部缺少标题行的文件，然后撰写一份名为 missing-titles.txt 的报告，列出所有需要修复的文件。

这是一个真实且有用的任务。它展示了所有核心的 Agent 行为：读取文件、做出决策和写入输出。而且它足够简单，完成后你可以用肉眼验证结果。

步骤 1：创建你的工作文件夹

在桌面上创建一个名为 my-agent 的新文件夹。这个文件夹就是 Agent 的工作区域。它只能看到和操作这个文件夹内的文件，这样保证了所有内容的安全和隔离。

在 my-agent 文件夹内，再创建一个名为 articles 的文件夹。这是 Agent 查找并检查文件的地方。

现在在 articles 文件夹内创建四个纯文本文件。分别命名为 post-one.txt、post-two.txt、post-three.txt 和 post-four.txt。打开其中两个文件，并在第一行添加以下内容：

1Title: My Article

将另外两个文件保持完全空白。Agent 的任务就是找出那些空白的文件。

成功标志：你的文件夹结构是 my-agent/articles/，里面包含四个 .txt 文件，其中两个带有标题行，另外两个没有。

步骤 2：编写 CLAUDE.md 指令文件

CLAUDE.md 是一个纯文本文件，Claude Code 在每个会话开始时都会读取它。它就像是你的 Agent 的常设指令，相当于一份它永远不会忘记的职位描述。

在 my-agent 文件夹内（不是在 articles 文件夹内），创建一个名为 CLAUDE.md 的新文件。用任意文本编辑器打开它（Windows 上可用记事本，Mac 上可用文本编辑），然后精确粘贴以下内容：

1# 我的文件检查 Agent
2
3## 你的任务
4
5检查 /articles 文件夹内的所有 .txt 文件。
6
7## 检查什么
8
9一个有效的文件必须以如下格式开头：Title:
10
11如果第一行不是以 "Title:" 开头，则该文件缺少标题。
12
13## 要做什么
14
151. 逐一读取 /articles 中的每个 .txt 文件。
162. 记录哪些文件缺少 Title 行。
173. 在主文件夹中创建一个名为 missing-titles.txt 的文件。
184. 在该文件中，列出所有未通过检查的文件名，每行一个。
195. 如果所有文件都通过，则在 missing-titles.txt 中写入 "All files have titles."。
20
21## 不要做什么
22
23不要编辑任何文章文件。只读取。只写入 missing-titles.txt。

保存文件。这就是你 Agent 的整个大脑。Claude Code 在开始任何操作之前都会读取这个文件。

成功标志：你在 my-agent/CLAUDE.md 下有了一个文件，并且其中包含上述指令。

步骤 3：将 Claude Code 指向你的文件夹

打开 Claude Code 桌面应用，点击文件夹图标或"打开文件夹"选项，导航到你的 my-agent 文件夹。选择它并确认。

Claude Code 会自动读取你的 CLAUDE.md 文件。你不会看到确认消息，但每次你打开一个文件夹时，它都会在后台静默完成。

如果你使用的是终端而非桌面应用，请打开终端并运行：

1cd ~/Desktop/my-agent
2claude

cd 命令的意思是"更改目录"，它会将你切换到 my-agent 文件夹内。输入 claude 则从该文件夹内启动 Agent 会话。

步骤 4：运行 Agent

在 Claude Code 界面底部的提示框中，精确输入以下内容：

1读取 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 上，当文件扩展名被隐藏时可能会发生这种情况。打开文件资源管理器中的"显示文件扩展名"设置来检查。

步骤 5：验证与扩展

打开 missing-titles.txt，确认它只列出了你留空的那两个文件。如果是这样，你的 Agent 就成功完成了端到端的工作。

你现在拥有一个可工作的 Agent。它位于 my-agent 文件夹中，读取 CLAUDE.md 中的指令，并且可以随时通过将新文件放入 articles 文件夹并运行相同的提示词来再次执行。

一个明确的下一步：更新 CLAUDE.md，让它也检查每个文件的长度是否超过五行。在"检查什么"部分下添加以下内容：

1一个有效的文件还应该有超过 5 行的内容。
2
3如果文件有 5 行或更少，请在标题检查的同时将其标记为"过短"。

用相同的提示词再次运行 Agent。现在它将会检查两件事而不是一件，而你的提示词无需更改，只需更改指令文件即可。

你刚刚构建了什么以及为什么它很重要

你构建了一个能够读取文件、做出决策并写入输出的 Agent，而无需你监督每一步。这是你将构建的任何更高级 Agent 的核心模式。

CLAUDE.md 文件是可以扩展的部分。你在其中添加的每一条新规则、新检查或新输出格式，都会改变 Agent 的行为，而无需改变你运行它的方式。提示词保持不变，指令则不断进化。

从这里开始，自然的扩展方向包括：检查更多文件类型、将报告写入 CSV 等不同格式、或者使用 Claude Code 内置的 Routines 功能按计划运行检查。

对任何步骤有疑问？请在下方留言。