零基础搭建你的第一个 AI Agent：手把手教程
阅读时间：25 分钟
📋 第 0 步：确认你的电脑系统
🍎 Mac
点击左上角 →「关于本机」→ 查看系统版本。只要是 macOS 10.15 以上即可。本教程主要在 Mac 上演示。
🪟 Windows
按 Win+R → 输入 winver → 回车。需要 Windows 10 或 11。大部分步骤和 Mac 一样，关键区别会特别标注。
🐧 Linux
打开终端输入 uname -a。Ubuntu/Debian/Fedora 都可以。本教程默认你熟悉 Linux 基本操作。
📦 第 1 步：安装 Node.js
Node.js 是一个运行环境——把它想象成 AI Agent 的「插座」。Claude Code 需要它才能运行。
🍎 Mac 安装方法
- 方法 A（推荐）：打开 nodejs.org → 下载 LTS 版本 → 双击安装 → 一路点「继续」
- 方法 B（更快）：打开终端，粘贴：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
然后nvm install --lts - 验证安装：终端输入
node -v，显示版本号即成功
🪟 Windows 安装方法
- 打开 nodejs.org
- 下载 LTS 版本（左边那个绿色的）
- 双击 .msi 文件 → 安装 → 全部默认选项 → Next → Install
- ⚠️ 重要：安装时勾选「Automatically install the necessary tools」
- 安装完成后 重启电脑
- 验证：按 Win+R → 输入 cmd → 输入
node -v
💻 第 2 步：学会打开终端（30秒学会）
终端就是那个黑底白字的窗口——别怕，你只需要会打开、会粘贴、会回车。
🍎 Mac
按 Cmd+空格 → 输入「终端」或「Terminal」→ 回车
💡 右键终端图标→「选项」→「留在程序坞」→ 下次直接点
🪟 Windows
按 Win 键 → 输入「cmd」或「PowerShell」→ 回车
💡 推荐用 PowerShell（蓝色图标），功能更多
🐧 Linux
Ctrl+Alt+T（Ubuntu）或从应用菜单找「终端」
💡 你应该已经知道怎么打开终端了 😄
🤖 第 3 步：安装 Claude Code
在终端里粘贴以下命令，回车：
等待 1-3 分钟。看到安装完成的提示后，输入：
第一次启动会提示登录——在浏览器中授权你的 Anthropic 账号。没有账号？去 console.anthropic.com 注册（需要海外手机号或 Google 登录）。
claude --model deepseek-v4（需先配置 API Key）。🎮 第 4 步：第一次使用 Claude Code
启动后，你会看到命令行变成对话模式。你现在可以跟 AI 用中文聊天了。试试说：
「帮我查一下当前文件夹里有什么文件」
→ 了解 AI 能读文件
「创建一个 index.html 文件，写一个好看的欢迎页面」
→ 了解 AI 能写代码
「帮我把这个页面的标题改大一点、颜色改成蓝色」
→ 了解 AI 能改代码
「帮我提交这些改动到 Git」
→ 了解 AI 能操作 Git
🚀 第 5 步：用它做第一个项目
不用想太复杂。下面 3 个项目选一个试试，每个 30 分钟搞定：
个人博客
「帮我创建一个个人博客网站，用 Next.js，简洁白色风格，有首页+文章列表+关于页面」
⏱ 30 分钟AI 工具箱
「帮我做一个在线工具网站，包含 JSON 格式化、Base64 编解码、Markdown 编辑器三个工具」
⏱ 30 分钟数据分析仪表盘
「我有一个 CSV 文件，帮我设计一个数据可视化面板，展示趋势图和统计表」
⏱ 30 分钟🆘 常见问题排查
提示 npm command not found
Node.js 没装好。回第 1 步重装。装完要重启终端。
提示 permission denied
Mac/Linux 用 sudo：sudo npm install -g @anthropic-ai/claude-code
提示 EACCES 权限错误
运行：sudo chown -R $(whoami) ~/.npm
claude 命令打不开
关闭终端重开，或加完整路径。Mac 试试：/usr/local/bin/claude
提示 API key 无效
去 console.anthropic.com → API Keys → 创建新 Key → 把 Key 设到环境变量
Windows 上中文乱码
PowerShell 里先运行：chcp 65001 切换到 UTF-8 编码
国内网络连不上 Anthropic
需要科学上网。或者用 DeepSeek 替代（deepseek.com 国内直连，免费额度足）
⚡ 第 6 步：安装 Skill（进阶）
Skill 让 AI 变成特定领域的专家。安装一个试试：
📺 视频教程推荐
不想看文字？这些 B 站视频手把手教：