Claude学院

Claude Code 怎么安装？Windows 完整安装教程（2026）

在 Windows 上安装 Claude Code 其实只有三步：先装 Node.js 18 及以上版本，再用 npm install -g @anthropic-ai/claude-code 全局安装官方包，最后在终端里运行 claude 完成登录。整个过程通常 10 分钟以内就能跑通。下面按从零开始的顺序，把每一步的命令、参数和坑都讲清楚。

安装前的环境准备

Claude Code 是 Anthropic 官方的命令行工具，基于 Node.js 运行，因此第一步是确认系统里有合适版本的 Node。打开 PowerShell 或 Windows Terminal，执行：

node -v
npm -v

如果提示「不是内部或外部命令」，或者 Node 版本低于 18，就需要先安装/升级。推荐两种方式：

  • 官网安装包：访问 nodejs.org 下载 LTS 版本（建议 20.x 或更高）的 Windows Installer（.msi），一路下一步即可，安装程序会自动把 node 和 npm 加入 PATH。
  • 用 nvm-windows 管理多版本：如果你电脑上有多个项目依赖不同 Node 版本，安装 nvm-windows 后执行 nvm install 20 再 nvm use 20 更省心。

安装完关闭再重开终端，重新运行 node -v 确认输出类似 v20.x.x 即可。Windows 10/11 自带的 Windows Terminal 体验更好，比传统 cmd 对颜色和交互的支持更完整，强烈建议用它。

第一步：全局安装 Claude Code

环境就绪后，在终端执行下面这条命令进行全局安装：

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

这里 -g 表示全局安装，装完后 claude 命令在任意目录都能直接调用。安装结束后验证版本：

claude --version

如果遇到 EACCES 权限错误或写入失败，多半是 npm 全局目录权限问题。Windows 上不建议用「以管理员身份运行」硬解，更干净的做法是把 npm 全局前缀改到用户目录：

npm config set prefix "%USERPROFILE%\.npm-global"

然后把 %USERPROFILE%\.npm-global 加进系统环境变量 PATH，重开终端后再次安装即可。国内网络如果 npm 拉包慢，可临时切换镜像：npm config set registry https://registry.npmmirror.com，安装完再切回官方源。

第二步：启动并完成登录认证

进入你的项目目录（比如 cd D:\projects\myapp），直接运行：

claude

首次启动会引导你登录。Claude Code 支持两种认证方式：

  1. 账号登录（推荐订阅用户）：会自动打开浏览器，用你的 Claude 账号授权后回到终端即可，适合有 Claude Pro/Max 订阅的用户。
  2. API Key 方式：如果你走 API 计费，可在终端设置环境变量 ANTHROPIC_API_KEY。在 PowerShell 中临时设置：$env:ANTHROPIC_API_KEY="sk-ant-xxxx"；要永久生效可写入系统环境变量。Key 的获取流程可参考 Claude API Key 怎么获取。

如果浏览器没能自动跳转、或者登录卡住，参考 Claude Code 登录失败怎么办 排查。底层用的还是标准 Messages API（POST /v1/messages，鉴权头 x-api-key 与 anthropic-version），所以 API 能正常调用，Claude Code 一般也能登录成功。

WSL 方案：更接近原生的体验

Claude Code 在 WSL（Windows Subsystem for Linux）下运行通常比纯 Windows 更顺畅，尤其涉及大量 Git、shell 脚本和 Unix 工具链的项目。如果你愿意多花几分钟，推荐这条路径：

  1. 以管理员身份打开 PowerShell，执行 wsl --install，默认会装好 Ubuntu，重启电脑。
  2. 进入 WSL 终端，在 Linux 里安装 Node（推荐用 nvm）：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash，再 nvm install 20。
  3. 同样执行 npm install -g @anthropic-ai/claude-code，然后在 WSL 里 cd 到你的项目运行 claude。

注意：在 WSL 里操作项目时，尽量把代码放在 Linux 文件系统（如 ~/projects）下，而不是通过 /mnt/c/... 访问 Windows 盘，否则文件读写会明显变慢。

常用配置与第一条命令

装好登录后，可以在项目根目录放一个 CLAUDE.md 来告诉 Claude 项目约定（技术栈、目录结构、代码规范），它会在每次会话自动读取，写法见 CLAUDE.md 配置文件怎么写。常用操作可以查 Claude Code 常用命令大全，需要连接外部工具（数据库、文件系统等）时再看 配置 MCP 服务器完整步骤。

验证一切就绪，最简单的方式是在项目里启动 claude 后直接输入一句自然语言，例如「解释一下这个仓库的整体结构」，能正常返回回答就说明安装、认证、模型调用全链路打通了。当前 Claude Code 默认会用 Claude Opus 4.8、Sonnet 4.6 等主力模型，具体可用模型与配额以 Anthropic 官网为准。

常见问题

提示 'claude' 不是内部或外部命令怎么办？

说明 npm 全局 bin 目录不在 PATH 里。先用 npm config get prefix 查看全局前缀路径，把该路径（Windows 下通常是该目录本身，或其下的可执行文件目录）加入系统环境变量 PATH，然后完全关闭并重开终端再试。如果用了 nvm-windows，记得切换版本后重新做一次全局安装。

Windows 原生和 WSL，到底选哪个？

如果只是想快速体验、项目以 Windows 工具链为主，直接在 PowerShell/Windows Terminal 里原生安装就够了。如果你日常用大量 Linux 命令、Git 操作频繁，或遇到原生环境下的兼容性报错，建议切到 WSL，体验更稳定。两种方式安装命令完全一样，区别只在运行环境。

安装好了但启动报错或无响应怎么排查？

先确认 node -v 不低于 18、claude --version 能正常输出；再检查网络是否能访问 Anthropic 服务（公司网络/代理可能拦截），必要时配置 HTTPS_PROXY 环境变量。若是认证相关报错，对照 Claude Code 报错排查清单 逐项检查通常都能定位问题。

← Claude Code