安装 Claude Code：10 分钟准备就绪
上一课你在四款工具里选定了主线；这一课 10 分钟，完成 Claude Code 安装、验证、登录三件事，把工具带到「能用」的状态。本页走官方推荐的原生安装路线——一条命令，装完后台自动更新；npm、Homebrew、WinGet 这些备用方式放到下一课，不在这页纠缠。
没用过终端也没关系：官方为终端新手写了专门指引，开篇第一句就是「即使你从没用过终端，你也可以用 Claude Code」。本课从「终端在哪、怎么打开」开始教。（事实核对时间 2026-11-04；命令与政策会更新，以官方页面为准。）
学完你能做什么
- 在 macOS、Linux/WSL 或 Windows 上，用一条官方命令完成 Claude Code 安装
- 用
claude --version打出版本号，确认命令装上了、系统能找到它 - 分清 Claude 订阅和 Console 账号两条登录路线，完成首次登录（登录一次，凭据保存）
- 在项目目录里启动 Claude Code，问出第一个问题，亲眼看到它读文件、给回答
- 遇到
command not found、一堆 HTML 这类报错时，知道去哪一页 60 秒速查
你现在的困境
- 搜「Claude Code 安装教程」，这篇说 npm 装、那篇说 brew 装、还有的要先装一堆依赖——不知道听哪篇的，怕把系统装乱
- 没用过终端：不知道终端在哪、怎么打开；粘贴命令后「一点反应都没有」，分不清是正在下载还是已经坏了
- Mac 和 Windows 的命令不一样，Windows 里 PowerShell 和 CMD 又是两个东西——抄错一条命令，报错看不懂，卡死在第一步
什么时候用这一招
当你需要：
- 跟官方推荐的原生安装路线，一次把 Claude Code 装好、验证过、登录完
- 装完自动保持最新版本，不想每个月手动升级
- 从「怎么打开终端」开始，零基础逐步对照做完
而且不想：
- 在 npm、Homebrew、WinGet 一堆安装方式里迷路——备用方式下一课统一讲
- 装到一半才发现系统版本、地区政策或账号类型过不去
- 报错后满世界乱搜，把 PATH 这种 30 秒的小问题折腾成大问题
🎒 开始前的准备
- 读完上一课 四款工具怎么选，确认主线走 Claude Code——完全不想碰命令行的同学，直接去 安装备用方式 看 WorkBuddy 桌面版
- 一台满足下方「系统要求」的电脑，网络能访问 claude.ai（安装命令从 claude.ai 下载安装器）
- 一个可登录的账号，二选一：Claude 订阅（Pro $20/月起，另有 Max/Ultra/Team/Enterprise）或 Anthropic Console 账号（API 按量预付）——费用全表见 价格对比
- 一个用来练手的项目文件夹；还没有也没关系，官方指引说了：没有项目也可以，Claude 能帮你从零建一个
- 10 分钟不被打扰的时间
系统要求
| 项目 | 官方要求 |
|---|---|
| 操作系统 | macOS 13.0+；Windows 10 1809+（或 Windows Server 2019+）；Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+ |
| 内存与处理器 | 4 GB+ 内存；x64 或 ARM64 处理器 |
| 网络 | 需要互联网连接 |
| Shell | Bash、Zsh、PowerShell 或 CMD |
| 所在地区 | Anthropic 支持地区名单（见下方提示框） |
⚠️ 地区政策：安装前先核对
Anthropic《Supported Regions Policy》（2026-11-12 生效版）明确：旗下产品——包括 Claude.ai、Claude Code 和 API 平台——只在名单列出的国家和地区提供服务；名单不含中国大陆、香港、澳门（日本、新加坡、韩国、中国台湾在名单内）。政策原文写明：不在名单的国家和地区即不受支持，包括身处不支持地区的用户。
本教程只陈述政策事实，不提供任何绕行做法，也不把「名单不含中国大陆」引申成「国内完全用不了」；政策会更新，以官方页面最新版为准。
核心思路
Claude Code 安装的主线只有三件事：打开终端 → 粘贴一条官方命令 → 新开终端验证。登录和第一次提问是收尾，加起来 10 分钟。
本课为什么走「原生安装」这条官方推荐路线：
| 安装路线 | 一句话特点 | 在哪一页讲 |
|---|---|---|
| 原生安装（官方推荐） | 一条命令；装完后台自动更新，保持最新版 | 本课主线 |
| npm / Homebrew / WinGet / apt 等 | 给已有工具链的用户；装完不自动更新（npm 除外） | 下一课 安装备用方式 |
| Claude Code 桌面版 / WorkBuddy 桌面版 | 完全不碰终端 | 本课「进阶技巧」+ 下一课 |
开工前记住三个关键认知，能避开 90% 的新手坑：
- 下载期间「没有任何进度显示」是正常的。 安装命令运行后窗口看起来没反应——官方文档明说：命令在下载 Claude Code 时不显示进度。不是卡死，别关窗口。
- 装完要新开一个终端窗口再验证。 旧窗口不认识新装的命令（PATH 没刷新），
command not found多半是没开新窗口。 - 终端只是「打字 → 回车 → 执行」的窗口。 不能用鼠标点里面的东西，用方向键移动；官方为终端新手写了专门指引，本课步骤就是照着它展开的。
跟我做
第 1 步：打开终端——Claude Code 安装的第一道门
为什么：Claude Code 是装在终端里使用的工具，这一课所有命令都在终端窗口里发生。先把它打开。
按你的系统对号：
- macOS：按
Cmd + Space打开 Spotlight，输入Terminal，回车 - Linux：按
Ctrl + Alt + T，或在应用菜单里搜「Terminal」 - Windows：按
Win + X，选 Windows PowerShell（或「终端」）
Windows 多看一眼：PowerShell 和 CMD 是两个不同的命令行程序。分辨方法看每行开头——PowerShell 有 PS（如 PS C:\>），CMD 没有。本课 Windows 主路线用 PowerShell。
你应该看到：一个新窗口，里面有个闪烁的光标——这就是终端，你打命令的地方。
- 小检查：我能说出自己打开的是 macOS/Linux 终端，还是 Windows PowerShell
第 2 步：粘贴安装命令，开始 Claude Code 安装
为什么：原生安装是官方推荐路线：一条命令从 claude.ai 下载安装器并完成安装，装完在后台自动更新——以后不用手动升级。
macOS / Linux / WSL 用户
复制这条命令，粘贴进终端（macOS 用 Cmd + V，Linux 用 Ctrl + Shift + V），回车：
curl -fsSL https://claude.ai/install.sh | bashWindows 用户
在 PowerShell 里粘贴（Ctrl + V 或右键），回车：
irm https://claude.ai/install.ps1 | iexirm 负责下载安装脚本，iex 负责运行它。
如果你开的是 CMD（行首没有 PS），改用这条：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd💡 Windows 用户：建议顺手装 Git for Windows
官方推荐 Windows 用户安装 Git for Windows：装了它，Claude Code 就能用 Bash 工具；没装也能用，Claude Code 会改用 PowerShell。安装时一路 Next 保持默认即可。走 WSL 的同学不需要装。
你应该看到：命令运行后没有任何进度显示——下载在后台进行，窗口看起来「没反应」，这是正常的，别关。装完后会打印 Claude Code successfully installed!。
- 小检查：我看到了
Claude Code successfully installed!（报错先别慌：去下方「踩坑提醒」对号，或直接跳 装不上怎么办 60 秒速查）
第 3 步：新开终端，用 claude --version 验证安装
为什么：验证两件事——命令装上了、系统能找到它（PATH 正常）。必须在新开的终端窗口里跑：旧窗口不认识新装的命令。
新开一个终端窗口（刚才那个可以关掉），输入：
claude --version你应该看到：一个版本号，后面跟着 (Claude Code)，例如：
2.1.211 (Claude Code)版本号会随版本更新变化，以你打出来的为准。
先在这里敲一遍找找手感。下面是练习终端，不会真的执行命令：
$claude --version
2.1.211 (Claude Code)
如果提示 command not found: claude（macOS/Linux）或 'claude' is not recognized（Windows）：安装目录还没进 PATH。安装器结束时在 Setup notes 里打印了确切的修复命令；完整步骤见 装不上怎么办。
- 小检查：
claude --version打出了带(Claude Code)的版本号
第 4 步：进入项目目录，首次启动并登录
为什么：Claude Code 在「当前目录」里工作——先进入你的项目文件夹再启动，它读的才是这个项目的文件。
在终端里输入（把路径换成你自己的项目）：
cd /path/to/your/project
claude还没有项目？没关系——官方指引原话：没有项目也可以，Claude 能帮你开始一个新的。随便进入一个你放练习文件的文件夹即可。
首次启动会提示登录，按提示在浏览器完成认证。账号两条路：
| 账号类型 | 是什么 | 适合谁 |
|---|---|---|
| Claude 订阅（Pro / Max / Ultra / Team / Enterprise，官方推荐） | claude.ai 的订阅账号，Pro $20/月起 | 大多数个人用户 |
| Anthropic Console 账号 | API 按量预付额度；首次登录会自动建一个「Claude Code」工作台，方便集中看花费 | 想按量付费的开发者 |
登录一次后凭据会保存，以后启动不用再登。（进阶：如果设置了 ANTHROPIC_API_KEY 环境变量，Claude Code 会问你是否用它，确认后跳过登录提示。）
你应该看到：浏览器打开认证页面，完成后回到终端——Claude Code 的提示符出现，上方显示版本号、当前模型和工作目录。输入 /help 能看到可用命令。
- 小检查：登录完成，终端里出现了带版本号、模型和工作目录的提示符
第 5 步：问第一个问题，确认 Claude Code 真能用
为什么：claude --version 只证明「装上了」；问一个问题、看它读文件并回答，才证明「能用了」。
在 Claude Code 里输入：
what does this project do?你应该看到：Claude 分析你的项目文件并给出总结——它需要文件时会自己去读，不用你手动复制粘贴代码。
再来一个，问问它自己会什么：
what can Claude Code do?三个立刻有用的操作：/help 看可用命令；Esc 打断正在运行的 Claude；exit 或连按两次 Ctrl+D 退出。
- 小检查：Claude 回答了我的第一个问题——安装五步全部走完
检查点 ✅
- 我用官方原生安装命令完成了 Claude Code 安装（macOS/Linux/WSL 或 Windows PowerShell/CMD 各有对应命令）
- 新开终端运行
claude --version，打出了版本号 +(Claude Code) - 我完成了首次登录（Claude 订阅或 Console 账号二选一），知道凭据已保存、不用每次重登
- 我在项目目录里启动了 Claude Code，问出了第一个问题并得到回答
- 我知道原生安装会后台自动更新，也知道报错时去 装不上怎么办 速查
踩坑提醒
❌ 粘贴命令后「没反应」，以为卡死把窗口关了
原生安装命令下载期间不显示任何进度，窗口看起来像卡住——官方文档明说这是正常现象。等它打出 Claude Code successfully installed! 再动。网速慢的时候，这一步可能要等一会儿。
❌ 装完在旧窗口里跑 claude，提示 command not found / 'claude' is not recognized
原因：安装目录还没进这个窗口的 PATH。正确做法：新开一个终端窗口再跑 claude --version；还是不行，就照安装器末尾 Setup notes 打印的命令修 PATH——完整步骤在 装不上怎么办。
❌ 在 PowerShell 里跑了 CMD 的命令（或反过来）
- 看到
The token '&&' is not a valid statement separator→ 你在 PowerShell，跑的是 CMD 命令 - 看到
'irm' is not recognized→ 你在 CMD，跑的是 PowerShell 命令
分辨方法看行首：PowerShell 有 PS，CMD 没有。换对应命令重跑即可。
❌ 安装命令打出一堆 HTML / syntax error near unexpected token '<'
原因：安装地址返回了网页而不是安装脚本。官方排错指引：先重跑一次；如果页面写着 "App unavailable in region"，这是地区政策原因——事实见上方「地区政策」提示框，本教程不提供绕行做法；其他情况可改用 Homebrew（brew install --cask claude-code，下一课细讲）或查 装不上怎么办。
进阶技巧（可选）
完全不想碰终端？两个出口。
- Claude Code 桌面版：官方桌面应用，跳过终端；官方提供 macOS 和 Windows 下载，账号要求与终端版一致
- WorkBuddy 桌面版：本教程的零命令行替代路线——腾讯出品、微信扫码登录，安装步骤在 安装备用方式
已经有工具链？ npm、Homebrew、WinGet、apt/dnf/apk 都能装 Claude Code；其中 Homebrew、WinGet、apt/dnf/apk 装完不会自动更新（原生安装才会），npm 能自动更新、但要求 npm 全局目录可写——各方式的命令与更新规则在下一课统一讲。
不止终端一种形态。 Claude Code 还有 VS Code / JetBrains 插件、网页版等形态——先把终端版跑通，其他形态到 Claude Code 用法 再展开。
本课小结
✅ Claude Code 安装主线 = 打开终端 → 粘贴一条原生安装命令 → 新开终端 claude --version 验证 → 登录 → 问第一个问题。 五步走完，工具进入「能用」状态。
✅ 原生安装后台自动更新；Homebrew/WinGet 等备用方式不自动更新（npm 例外，它依赖全局目录权限自动更新），下一课讲。
✅ 登录两条路：Claude 订阅（Pro $20/月起，官方推荐）或 Console 账号（API 按量预付）；登录一次凭据保存。
✅ 系统要求：macOS 13.0+ / Windows 10 1809+ / Ubuntu 20.04+ 等；4 GB 内存起步。
✅ 地区政策事实：Anthropic 支持地区名单（2026-11-12 生效版）不含中国大陆——只陈述事实，不给绕行建议。
✅ 报错别慌：command not found、HTML 报错、PowerShell/CMD 用错，都能在 装不上怎么办 60 秒对号。
关键命令回顾：
| 命令 | 作用 | 适用平台 |
|---|---|---|
curl -fsSL https://claude.ai/install.sh | bash | 原生安装 | macOS / Linux / WSL |
irm https://claude.ai/install.ps1 | iex | 原生安装 | Windows PowerShell |
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd | 原生安装 | Windows CMD |
claude --version | 验证安装 | 全平台 |
cd /path/to/your/project 然后 claude | 进入项目并首次启动 | 全平台 |
下一课预告
主线装好了，备用方式还没讲。下一课 安装备用方式：npm、Homebrew、WinGet 与 WorkBuddy 桌面版。
你会学到：
- npm / Homebrew / WinGet 三种备用安装方式的命令与取舍（Homebrew 稳定版约落后一周、装完不自动更新）
- 完全零命令行的替代路线：WorkBuddy 桌面版下载、安装与微信扫码登录
- 各安装方式怎么更新：原生安装自动更新，Homebrew/WinGet 等要手动升级（npm 例外）
- 怎么判断自己该留在主线，还是换备用方式