磨刀不误砍柴工。在开始 AI 编码之前，先把工具和环境准备好。

2.1 你需要什么

要开始 AI 编码，你只需要三样东西：

1. 一个 AI 编码工具——本书以 Claude Code 为例进行讲解。
2. 一个代码编辑器——VS Code 或你习惯使用的任何编辑器。
3. 一个终端（命令行工具）——用于运行命令。

如果你已经在日常开发中使用这些工具，可以跳过本章的大部分内容，直接阅读 2.5 节。

2.2 安装 AI 编码工具

什么是 Claude Code

Claude Code 是 Anthropic 公司推出的 AI 编码助手。它不是一个插件，而是一个可以在终端中运行的"AI 编程伙伴"。你通过自然语言告诉它你要做什么，它就能理解你的项目结构、读取文件、编写代码、运行命令。

安装步骤

以下步骤以 macOS 为例。Windows 和 Linux 的安装方式类似，具体差异请参考官方文档。

第一步：安装 Node.js

Claude Code 需要 Node.js 18 或更高版本。如果你还没有安装：

# 使用 Homebrew 安装（macOS）
brew install node

# 验证安装成功
node --version
# 输出类似：v18.17.0 或更高

第二步：安装 Claude Code

# 全局安装
npm install -g @anthropic-ai/claude-code

# 验证安装成功
claude --version

第三步：获取 API 密钥

1. 访问 console.anthropic.com。
2. 注册或登录你的账号。
3. 在 API Keys 页面创建一个新的密钥。
4. 复制密钥并保存在安全的地方。

第四步：配置 API 密钥

# 设置环境变量
export ANTHROPIC_API_KEY=你的密钥

建议将这一行添加到你的 shell 配置文件（~/.bashrc、~/.zshrc 等）中，这样每次打开终端都会自动配置。

验证安装

创建一个空目录，进入后运行：

mkdir hello-ai
cd hello-ai
claude

如果看到 Claude Code 的欢迎信息，说明安装成功。

2.3 选择项目目录

AI 编码工具会在你当前所在的目录中工作。建议：

• 每个项目一个独立的目录——不要把所有代码混在一起。
• 项目目录应是一个 git 仓库——这样你可以随时回滚到之前的版本。
• 目录名简洁明了——使用英文，不要包含空格。

# 好的做法
mkdir my-todo-app
cd my-todo-app
git init

2.4 了解你的工作区域

启动 Claude Code 后，你会看到一个终端界面，主要分为以下几个区域：

1. 输入区——在这里输入你的需求，就像在聊天窗口打字一样。
2. 输出区——AI 的回复、代码生成、命令执行结果都在这里显示。
3. 文件区——AI 可以读取和修改你项目目录中的任何文件。

你可以像跟一位同事对话一样与它交流。用自然语言描述需求，它会理解并执行。

2.5 三个基本原则

在开始使用之前，请记住这三个原则。它们会帮你避免很多麻烦。

原则一：先想清楚再动手

这是最重要的一条原则。为什么？因为 AI 没有读心术。当你说"做一个订单系统"时，你脑海中有一个完整的业务流程——谁下订单、订单包含什么、状态怎么流转。但 AI 看到的只是一句话，它只能从训练数据中"猜"一个最可能的实现。猜的结果可能和你想要的天差地别。

所以，在告诉 AI "开始写代码"之前，先问自己三个问题：

1. 我要做什么？（需求是否明确？）
2. 怎么做？（用什么技术、什么结构？）
3. 怎么知道做完了？（验收标准是什么？）

如果这三个问题答不上来，说明还没有准备好。先去想清楚，不要急着让 AI 写代码。这五分钟的思考，能帮你省下后面五小时的返工。

原则二：小步快跑

不要一次让 AI 完成一个巨大的功能。把它拆成多个小步骤，每完成一步就验收一次。

为什么？因为 AI 的任务越复杂，出错的概率越高。一个"用户注册功能"可能包含数据库迁移、API 接口、参数校验、前端表单、错误处理——如果让 AI 一口气写完再验收，你可能会发现 API 的返回格式和前端期望的不一致，数据库字段命名和后端代码风格不同。这时候要改，牵一发而动全身。

如果拆成 5 个小里程碑，每个 10 分钟就能完成和验证——即使某个里程碑出了错，最多损失 10 分钟的工作，而不是一整个功能的代码。

原则三：验收不可省略

AI 生成的代码看起来都对，但可能有隐藏的问题。因为 AI 是一个概率模型，它生成的每一个 Token 都是"在当前上下文中概率最高的那个"。这意味着它的代码在语法上几乎总是正确的，但逻辑错误、边界情况、安全隐患不是一眼能看出来的。

就像你不会不检查就签收快递一样，不要不验收就提交 AI 的代码。验收不是不信任，而是工程的基本规范。

本章小结

准备工作做好了，你才能在后续的开发中不被打断。三个基本原则是新手阶段最重要的护身符——先想清楚再动手、小步快跑、验收不可省略——每一条背后都有 AI 编码的底层逻辑在支撑。现在工具和环境已经就绪，下一章，我们学习全书最核心的方法——六步工作法。