十五分钟装好，并跑通第一个真实任务

2.1 先确认你的机器满足条件

安装之前花一分钟对一下清单，可以省掉后面大半的排错时间：

项目	要求
操作系统	macOS 13.0+、Windows 10 1809+ 或 Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine 3.19+
硬件	4 GB 以上内存，x64 或 ARM64
Shell	Bash、Zsh、PowerShell 或 CMD
网络	需要联网；并且你所在地区需在 Anthropic 支持范围内
依赖	通常自带 ripgrep；部分 musl 系发行版需要另行安装

Windows 用户有两条路：直接用原生安装，或者在 WSL 里当作 Linux 装。如果你的项目本来就在 WSL 里，走 WSL 那条路会少很多路径问题。

官方推荐原生安装器，因为它会在后台自动更新；其余方式都需要你手动升级。

# macOS / Linux / WSL：原生安装（推荐，自动更新）
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell：原生安装
irm https://claude.ai/install.ps1 | iex

# macOS：Homebrew（需手动升级）
brew install --cask claude-code

# Windows：WinGet（需手动升级）
winget install Anthropic.ClaudeCode

还有一条你会在旧文章里频繁看到的路径：npm install -g @anthropic-ai/claude-code。它仍然可用，但官方仓库的 README 已经把 npm 安装标记为不再推荐。如果你是从旧教程过来的，这是第一个需要更新的知识点。

装完立刻验证：

claude --version

claude doctor

claude doctor 会在不启动会话的情况下做一遍环境自检。以后只要遇到”命令找不到""登录状态奇怪""终端显示错乱”这类问题，它都是第一站。

在项目目录里第一次运行 claude，它会打开浏览器让你登录。可选的身份来源有几类：

如果浏览器没有自动弹出，终端里会给一个可复制的登录链接。登录凭据在 macOS 上存进 Keychain，在 Linux/Windows 上存成本地凭据文件。

需要提前知道的一件事：订阅计费和按量计费的行为不完全一样。最典型的差异是提示缓存（prompt cache）的有效期——订阅账号是 1 小时，按量计费/API key 是 5 分钟。这个数字在第 11 章讨论”为什么放着不动也会掉额度”时会再出现。

新手最常见的错误，是第一次就丢一个”帮我实现用户系统”过去。更好的起手式是让它先读、后说、不改。

进入一个你熟悉的项目目录，然后：

cd ~/code/your-project
claude

会话起来之后，依次试这三条：

用三段话解释这个项目是做什么的、主要目录怎么划分、入口在哪里

@src/api/orders.ts 这个文件里的错误处理有哪些分支？用表格列出来，不要改代码

项目里有哪些命令是我该知道的？测试怎么跑，构建怎么跑

这三条的共同点是：只读、可核对、成本低。你能立刻判断它说得对不对，从而校准你对它的信任度——而这个校准，比第一次就让它写代码要有价值得多。

然后再交给它第一个会动手的任务。挑一个你自己也能做、但懒得做的小事，比如：

给 src/utils/date.ts 里的 formatRelativeTime 补一个单元测试，
覆盖跨年和刚好 60 秒这两个边界。测试写完后跑一遍 npm test，把输出贴给我。

注意这条提示里包含了第 1 章的那个标准：它带着自己的验证手段（跑测试并贴输出）。

Esc 是新手最该练成肌肉记忆的一个键。看到它开始往错误方向跑，立刻打断，比等它跑完再纠正便宜得多——第 5 章会解释为什么这个”便宜”是字面意义上的。

你现在的成果：环境跑通了，而且你已经亲眼见过一次它把测试跑绿。接下来的问题不再是”能不能用”，而是”怎么用得稳”。