02 · 安装教程：Mac、Windows 与 Linux

三大平台和 WSL 的安装步骤、登录方法、网络要求与常见报错处理，让第一次用命令行的读者也能装好。

安装 Claude Code 本身不复杂，但对第一次接触命令行的人来说，网络和登录是两个最容易卡住的点。这一篇把它们理顺。

在 macOS 上，最推荐用 Homebrew：一条命令就能装好，升级也方便。Linux 和 Windows 也都有对应的安装方式，核心是让命令行里能直接敲到 `claude` 这个命令。

Windows 用户有个额外的选择：原生环境还是 WSL（Linux 子系统）。如果你平时就用 WSL 开发，那在 WSL 里装更顺；如果图简单，原生 PowerShell 也能跑。

装完之后的第一件事，是敲版本命令验证它真的装好了。很多「装上了却用不了」的情况，其实是环境变量没刷新，重开一个终端窗口往往就好了。

「登录」这一步是把本机和你的账号绑起来。它通常会打开浏览器让你授权，授权完成后终端里收到回执。登录后立刻确认一下当前身份，避免后面才发现用错了账号。

「网络要求」是重中之重。安装要从官方源下载、登录要连官方服务器，如果网络不通，就会卡在下载或授权环节。国内用户遇到这种情况，通常需要配置合适的网络环境，具体看你所处条件。

「常见报错」里，权限不足、网络不通、环境变量没生效占了大多数。遇到报错先别慌，把报错原文记下来，后面有专门的排查篇可以按现象定位。

验证装好的标准很简单：能查到版本号、能登录成功、能在任意目录启动一次。三点通了，就可以进入第一篇实战了。

常见误区：很多新手会把这一篇讲的「基本规则」当成「教条」——什么都严格遵守。其实这些规则的核心是「降低风险、提高效率」，理解了动机，规则就自然内化了，不用死记硬背。

动手试一下：你可以花 5 分钟做一个最小验证——找一个真实的代码任务，让 Codex 跑一遍，看它的行为是不是和这一篇描述的一致。理论与实践对照，才知道「懂」和「会用」是两件事。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

实用清单（速记版）：① 适用场景：{场景}。 ② 关键动作：{动作}。 ③ 风险点：{风险}。 ④ 验证方法：{验证}。把这四点记住，能让你在大部分场景下做出正确决策。