从零安装 Claude Code：普通用户也能看懂的完整教程

Windows / macOS / Linux / WSL，一篇跑通安装、登录、验证与常见报错

面向：第一次接触 Claude Code 的普通 AI 用户　｜　技术核验：2026-09-10　｜　推荐：官方 Native Install

先给结论

如果你只是想尽快装好：Windows 打开 PowerShell，macOS / Linux 打开终端，执行本文对应的官方安装命令；装完运行 claude --version，再运行 claude 完成浏览器登录。绝大多数用户不需要先安装 Node.js。

Claude Code 是 Anthropic 推出的终端型 AI 编程工具。它可以读取项目文件、修改代码、运行命令、搜索代码库，并在你的电脑上完成一整套开发任务。对普通用户来说，第一次上手最容易卡住的往往不是“怎么用”，而是安装方式选错、Windows 终端搞混、账号权限不够，或者照着旧教程先折腾了一圈 Node.js。

这篇教程只做一件事：把 Claude Code 安装、验证、登录和第一次启动讲清楚。命令以 Anthropic 当前官方文档为准，并在常见教程的基础上删掉重复背景，只保留真正会影响你安装成功率的信息。

01　安装前，先确认这 4 件事

1. 电脑系统是否支持

Claude Code 对硬件要求不高，但系统版本有最低要求。官方当前列出的基础要求如下：

项目官方要求
操作系统macOS 13.0+；Windows 10 1809+ / Windows Server 2019+；Ubuntu 20.04+；Debian 10+；Alpine Linux 3.19+
内存4 GB 以上 RAM
处理器x64 或 ARM64
网络需要能够连接 Claude / Anthropic 服务
终端Bash、Zsh、PowerShell 或 CMD

2. 账号是否能使用 Claude Code

Claude Code 目前需要 Claude Pro、Max、Team、Enterprise 或 Claude Console 账号。Claude.ai 免费版账号不包含 Claude Code 使用权限。企业用户也可能通过 Amazon Bedrock、Google Cloud 或 Microsoft Foundry 接入，但这属于团队部署场景，本文不展开。

常见误区

“我能在网页上免费和 Claude 聊天”不等于“这个账号能登录 Claude Code”。如果安装成功但登录后提示无权限，先检查账号套餐，而不是反复重装。

3. 普通用户优先选择“原生安装”

Anthropic 官方把 Native Install（原生安装）列为推荐方式。它的优势很直接：步骤少、不需要提前安装 Node.js，而且原生安装会在后台自动更新。Homebrew、WinGet、npm 仍然可用，但更适合作为备选方案。

方式适合谁自动更新建议
Native Install绝大多数用户是首选
HomebrewmacOS 且习惯用 brew 管软件默认否可选
WinGetWindows 且习惯用 winget默认否可选
npm有明确 npm / Node.js 工作流的人默认否最后考虑

2026 年需要特别注意的一处变化

如果你坚持使用 npm，官方当前要求 Node.js 22 或更高版本。很多旧教程仍写 Node.js 18+，已经过时。并且不要使用 sudo npm install -g ...，官方明确提醒这可能造成权限和安全问题。

4. 第一次测试，别直接在重要目录里运行

Claude Code 能读取文件、修改文件并执行命令。第一次体验建议新建一个空目录测试，先熟悉它的权限确认方式，再进入真正的项目目录。这样就算你点错了，也不会碰到重要文件。

02　Windows 安装：推荐 PowerShell

Windows 是新手最容易把命令搞混的平台。最省事的做法是：直接用 PowerShell，不需要“以管理员身份运行”。

打开开始菜单，搜索“PowerShell”，打开 Windows PowerShell 或 PowerShell。

看一眼命令行开头。如果类似 PS C:\Users\你的名字>，说明你就在 PowerShell。

复制下面这条官方命令，粘贴后按回车。

irm https://claude.ai/install.ps1 | iex

安装结束后，关闭当前窗口，再重新打开一个 PowerShell，用后面的“验证安装”命令检查。

要不要安装 Git for Windows？

不是安装 Claude Code 的硬性前提。官方建议原生 Windows 用户安装 Git for Windows，这样 Claude Code 可以使用 Git Bash / Bash 工具；如果不装，它仍可以通过 PowerShell 执行命令。刚入门可以先把 Claude Code 装好，再按需要补 Git。

如果你偏要用 CMD

CMD 的提示符通常是 C:\Users\你的名字>，前面没有 PS。CMD 需要使用另一条命令：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

如果你在 PowerShell 里运行这条 CMD 命令，看到类似 “&& 不是有效的语句分隔符”；或者在 CMD 里运行 irm，看到 “irm 不是内部或外部命令”，本质上都只是终端和命令不匹配。换回对应命令即可。

Windows：原生还是 WSL？

普通 Windows 项目直接使用原生 Windows 就够了。如果你的项目本来就在 Linux 环境、依赖 Linux 工具链，或者你明确需要 Claude Code 的沙箱执行能力，再考虑 WSL 2。使用 WSL 时，要在 WSL 终端内部安装和启动 Claude Code，不要在 PowerShell 里装一遍再期待 WSL 自动共用。

03　macOS 安装

macOS 用户打开“终端（Terminal）”即可。可以按 Command + Space 打开 Spotlight，输入“终端”并回车。然后粘贴官方安装命令：

curl -fsSL https://claude.ai/install.sh | bash

安装完成后建议新开一个终端窗口，再运行 claude --version。如果系统版本低于 macOS 13，请先升级系统；官方当前最低要求就是 macOS 13.0。

Homebrew 备选方案

如果你本来就用 Homebrew 管理软件，也可以通过 Homebrew 安装。稳定通道一般会比最新版本慢约一周，并跳过有重大回归的版本。

brew install --cask claude-code
# 想追最新版本可用：
brew install --cask claude-code@latest

Homebrew 安装默认不会由 Claude Code 自己自动更新。稳定版用 brew upgrade claude-code，latest 版用 brew upgrade claude-code@latest。

04　Linux / WSL 安装

Ubuntu、Debian 等常见 Linux 发行版，以及 WSL，优先使用与 macOS 相同的原生安装命令：

curl -fsSL https://claude.ai/install.sh | bash

WSL 用户要特别注意：请先进入 WSL 的 Ubuntu / Debian 终端，再执行这条命令，并在同一个 WSL 环境中运行 claude。

Alpine 用户注意

Alpine 属于 musl 环境，官方要求额外准备 bash、curl、libgcc、libstdc++、ripgrep 等依赖。普通桌面或 Ubuntu / Debian 用户可以忽略这条。

05　验证：先确认“装好了”，再谈登录

安装结束后，不要立刻判断成败。重新打开一个终端，先运行：

claude --version

如果安装正常，你会看到 Claude Code 的版本号。具体数字会随着更新变化，所以不用和教程截图一模一样。只要能输出版本号，就说明 claude 命令已经可以被系统找到。

如果想做更完整的检查，再运行：

claude doctor

claude doctor 会检查安装状态、设置文件、更新状态并给出诊断信息。遇到“不知道哪里不对”的情况，它比直接重装更值得先试。

06　第一次登录 Claude Code

确认版本号正常后，在终端中输入：

claude

第一次启动时，Claude Code 通常会打开浏览器，让你登录 Claude.ai 或 Claude Console 账号。登录完成后回到终端，看到登录成功提示即可继续。以后再次运行通常不需要重复登录。

浏览器没有自动打开怎么办？

在登录界面按 c，Claude Code 会复制登录 URL。把它粘贴到浏览器打开即可。如果浏览器最后显示一个登录 code，把这个 code 再粘回终端。WSL、SSH、容器等环境里比较常见。

如果你的电脑里已经设置了 ANTHROPIC_API_KEY 环境变量，Claude Code 会优先提示你批准这个 API key，而不是直接走浏览器订阅登录。这属于正常行为。想确认当前使用哪种认证方式，可以进入 Claude Code 后查看 /status。

07　用一个空目录跑通第一次

对于第一次使用的人，我更建议先做一个“不会伤到任何项目”的测试。下面这组命令在 macOS、Linux、WSL 和 PowerShell 中都很好理解：

mkdir claude-test
cd claude-test
claude

进入 Claude Code 后，可以先发一句非常简单的指令，例如：“请告诉我当前目录里有哪些文件，并创建一个 README.md，写一句 Hello Claude Code。” 当它准备写文件或执行命令时，留意终端里的权限提示。完成后退出，再去这个目录看一眼 README.md 是否真的生成。这样你就验证了账号、网络、文件操作和基本权限链路都正常。

08　更新：原生安装基本不用管

通过官方 Native Install 安装的 Claude Code 会自动检查更新，并在后台下载新版本；通常下一次启动就会生效。想立即检查并更新，可以运行：

claude update

如果你更重视稳定，可以把自动更新通道切换到 stable；它通常比 latest 延后一段时间，并跳过有重大回归的版本。普通新手没必要一开始就改，默认 latest 即可。

09　安装失败时，先看这张速查表

现象 / 报错通常意味着什么先怎么处理
claude 找不到 / command not found命令没有进入 PATH，或终端还没刷新先关掉终端重开；再运行 claude --version，仍失败再检查 PATH
PowerShell 提示 && 无效你运行了 CMD 命令改用 irm https://claude.ai/install.ps1 | iex
CMD 提示 irm 不存在你运行了 PowerShell 命令改用 CMD 的 curl ... install.cmd 命令，或直接换 PowerShell
安装脚本返回 HTML / < 语法错误下载到的不是安装脚本检查网络、服务可用区域，或改用官方 Homebrew / WinGet 方案
登录 403 / 无权限账号、组织权限或服务地区不符合要求先检查套餐、组织权限和 Anthropic 官方可用地区
npm 出现 EBADENGINENode.js 版本太旧npm 方式升级到 Node.js 22+，或更省事地改用原生安装
版本混乱、升级不对电脑里可能同时存在多个 Claude CodemacOS / Linux 用 which -a claude；Windows 用 where.exe claude 查看多个路径

PATH 问题怎么修？

原生安装在 macOS / Linux 上通常把启动器放在 ~/.local/bin/claude。如果程序已经下载成功，但终端始终找不到 claude，可以先确认 ~/.local/bin 是否已经在 PATH 中。macOS 默认 Zsh，可尝试：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude --version

Linux 如果使用 Bash，通常把 ~/.zshrc 换成 ~/.bashrc。Windows 原生安装对应的用户目录通常是 %USERPROFILE%\.local\bin；如果仍找不到命令，可以检查这个目录是否已经加入用户 PATH，然后重启终端。

10　如果你一定要用 npm

旧教程经常把 npm 当成默认安装方法。现在它仍然能用，但已经不适合作为普通用户的第一选择。你需要先有 Node.js 22 或更高版本，然后执行：

npm install -g @anthropic-ai/claude-code

升级时用 npm install -g @anthropic-ai/claude-code@latest。不要用 sudo npm install -g，也不要把 npm update -g 当成保证升级到最新版的方法。只要你没有明确理由必须用 npm，回到本文前面的 Native Install 会更省心。

11　卸载（可选）

如果只是试用后不想要了，按当初的安装方式卸载即可。原生安装的程序本体可以这样删除：

# macOS / Linux / WSL
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
# Windows PowerShell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

注意：卸载程序本体不会自动删除 ~/.claude/ 里的设置、授权信息、MCP 配置和会话历史。如果你只是暂时卸载，不建议顺手清空这些数据。彻底删除属于不可恢复操作，确认确实不再需要后再处理。

最后：普通用户记住这 5 条就够了

  • 优先用官方 Native Install，不要先给自己增加 Node.js 和 npm 的前置负担。
  • Windows 新手直接用 PowerShell；看到 PS C:\...> 就运行 PowerShell 那条 irm 命令。
  • 装完先跑 claude --version，有问题再跑 claude doctor，不要一报错就重装。
  • Claude.ai 免费版不包含 Claude Code；登录失败先查账号套餐和组织权限。
  • 第一次在空目录测试，认真看权限提示，确认它会怎样读取、写入和执行命令。

一句话收尾

Claude Code 今天的安装已经比早期简单很多：选对官方 Native Install，装完先跑 claude --version 验证，再在空目录里完成第一次登录和测试，真正需要记住的命令其实只有“安装命令 → 验证 → 登录”这三步。走完这一遍，你就已经稳稳迈出了从“会安装”到“会用 Claude Code”的第一步。

预告！

下一篇 03 · Claude Code 如何工作：我们继续往里走一步。 到这里，你已经把 Claude Code 装好并跑起来了，但真正决定你能不能用顺手的，是理解它到底怎么工作：为什么你只说一句“帮我修这个 Bug”，它就会自己读文件、运行命令、修改代码，再重新测试确认？下一篇我们会从最核心的“想 → 做 → 看”代理循环讲起，再看它手里的文件、搜索、执行、网络等工具，以及权限确认和上下文窗口是怎么运作的。搞懂这些之后，你会更清楚什么时候可以放心让它自己执行、什么时候该按下 Esc，也就真正从“会安装”走到了“会用 Claude Code”。

AGIStudy.CSCITech.Top

# 人工智能
Logo
中科创新烁智（CSCITech）

中科创新烁智（CSCITech）

更多推荐

cover

MAX API 2.0 SmartOps pre2：订阅策略、异步任务结算、跨协议计费与认证授权可靠性

avatar 中科创新烁智
cover

Gemini 3.8 Flash：六周三连发，但这次“卷“出了新问题

avatar 中科创新烁智

GPT-Image-2.5 正式发布！生成提速50%，从“会画图“到“会改图“

GPT-Image-2.5 已向 ChatGPT、ChatGPT Work 和 Codex 全线用户开放，免费版也能直接体验。也就是说，这只是开头。AI 生图的"生产力时代"，才刚刚拉开帷幕。

avatar 中科创新烁智