准备工作：你需要这 4 样东西

在开始之前，先准备好以下 4 样东西。它们都是免费的，跟着做就行。

• Node.js 22 或更新版本：Node.js 是一个让 JavaScript 在电脑上运行的工具。去 nodejs.org 下载安装包，安装时一路点“下一步”即可。
• Anthropic API 密钥：这是调用 AI 模型（Claude）的钥匙。去 console.anthropic.com 注册账号，在控制台里生成一个密钥，复制保存好。
• Tavily API 密钥：这是让 AI 能上网搜索的工具。去 tavily.com 注册，免费版每月有 1000 次搜索，足够用了。
• Convex 账号：Convex 是一个云数据库，用来保存和展示结果。去 convex.dev 注册，免费版够用。

安装步骤：跑通第一个智能体

1. 创建项目文件夹：在电脑上新建一个文件夹，比如叫 ai-demo。
2. 初始化项目：打开终端（Mac 的“终端”或 Windows 的“命令提示符”），进入这个文件夹，运行 npm init -y。这会在文件夹里生成一个 package.json 文件。
3. 安装 Mastra：运行 npm install @mastra/core。Mastra 是一个帮你构建 AI 智能体的框架，它让写代码更简单。
4. 安装 LangChain：运行 npm install langchain @langchain/core。LangChain 是另一个流行的 AI 框架，你可以对比着学。
5. 设置环境变量：在项目文件夹里新建一个 .env 文件，用记事本打开，写入以下内容：
   ANTHROPIC_API_KEY=你的密钥
TAVILY_API_KEY=你的密钥
   注意：等号前后不要有空格，密钥不要加引号。
6. 写一个最简单的智能体：新建一个 index.js 文件，把下面的代码复制进去：
   

   const { Agent } = require('@mastra/core');
   const agent = new Agent({ model: 'claude-haiku-4.5' });
   agent.run('你好，告诉我一句话').then(console.log);

7. 运行程序：在终端里执行 node index.js。如果看到 AI 回复了一句话，就说明成功了！

验证是否成功：常见问题

• “npm 不是内部命令”：说明 Node.js 没装好。重新安装 Node.js，安装时勾选“Add to PATH”。
• “API key 错误”：检查 .env 文件里的密钥是否复制完整，前后有没有多余空格。
• “网络超时”：可能是你的网络无法访问 API 服务。可以尝试切换网络，或者使用代理。

下一步可以做什么

你已经成功跑通了第一个 AI 智能体！接下来可以试试：

• 修改 index.js 中的提问内容，让 AI 回答不同问题。
• 尝试用 LangChain 写同样的功能，对比两者的区别。
• 学习如何让 AI 上网搜索（使用 Tavily）并总结结果。