Claude Code Windows安装教程：命令行配置、首次登录与常见报错（2026）

更新时间：2026年9月18日

直接答案： Windows 用户可以原生安装 Claude Code，也可以在 WSL 2 中安装。一般的 Windows 项目优先选择原生 PowerShell 安装；项目本来就在 Linux 环境、需要 Linux 工具链或沙箱功能时再选 WSL 2。官方当前推荐的 PowerShell 安装命令是 irm https://claude.ai/install.ps1 | iex。安装后依次运行 claude --version、claude doctor 和 claude，完成版本检查、环境诊断与浏览器登录。

本文所有安装命令均对照 Claude Code 官方安装文档 核验。命令、系统要求和账号范围可能继续调整，实际安装时以官方页面最新内容为准。

一、安装前先选：原生 Windows 还是 WSL 2

Claude Code 当前支持 Windows 10 1809 及更高版本、Windows Server 2019 及更高版本，官方列出的最低硬件要求为 4 GB 内存，并需要互联网连接。Windows 可用 PowerShell、CMD，也可以在 WSL 终端中运行。

安装方式	更适合什么项目	主要特点
原生 Windows	代码位于 C:\，主要使用 PowerShell、Visual Studio、Windows SDK	安装最直接；Git for Windows 可选；当前不支持 Claude Code 沙箱
WSL 2	代码位于 Linux 文件系统，使用 Bash、apt、Docker 或 Linux 工具链	支持沙箱；命令和路径更接近 Linux 服务器
WSL 1	旧电脑暂时无法使用 WSL 2	可以运行，但不支持沙箱，通常不作为新项目首选

不要在 PowerShell 中执行 WSL 安装命令，也不要在 WSL 里重复安装 Windows 版本。先确定项目实际存放在哪里，再在对应环境中安装和启动。

二、用 PowerShell 安装 Claude Code

第一步：打开普通 PowerShell

从开始菜单打开 PowerShell 或 Windows Terminal 即可，官方说明原生安装不需要“以管理员身份运行”。在提示符以 PS C:\ 开头时，执行：

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

irm 是 PowerShell 的 Invoke-RestMethod 别名。这条命令只适用于 PowerShell；如果当前窗口是 CMD，请使用下一节的 CMD 命令。

第二步：检查安装结果

安装完成后，新开一个 PowerShell 窗口，再运行：

claude --version
claude doctor

claude --version 应输出已安装版本；claude doctor 会只读检查安装状态、设置文件和更新情况。文章不固定写死版本号，因为 Claude Code 更新频率较高，能正常输出版本并通过诊断比和旧教程对照号码更可靠。

第三步：进入项目目录

先进入一个测试项目，而不是直接打开包含生产密钥或客户数据的仓库：

Set-Location "D:\projects\demo-app"
git status
claude

首次任务可以先要求 Claude Code 只读说明项目结构、启动命令和测试方式，不要一开始就授权批量修改或部署。

三、使用 CMD、WinGet 或 WSL 安装

CMD 安装命令

如果提示符是 C:\Users\你的用户名>，而不是 PS C:\Users\...>，说明当前是 CMD。执行：

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

安装后重新打开终端，执行 claude --version 检查结果。

WinGet 安装方式

习惯用 Windows 包管理器时，可以使用官方包标识：

winget install Anthropic.ClaudeCode

WinGet 安装默认需要手动更新：

winget upgrade Anthropic.ClaudeCode

官方原生安装器会在后台自动检查更新；WinGet、npm 等安装方式的更新机制不同。不要同时保留多套安装，以免终端调用到旧版本。

WSL 2 安装方式

先进入 Ubuntu 等 WSL 发行版的终端，再执行 Linux 安装命令：

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

Claude Code 也应在 WSL 终端内启动。若项目位于 WSL，建议把代码放在 Linux 主目录下，而不是频繁跨 /mnt/c/ 调用大量小文件，以减少文件系统性能问题。

四、首次登录怎么完成

在项目目录执行：

claude

Claude Code 会启动交互会话，并按照当前认证方式显示浏览器登录提示。完成网页授权后回到终端即可。官方当前列出的可用账号包括 Claude Pro、Max、Team、Enterprise 和 Anthropic Console；Claude 免费方案当前不包含 Claude Code。

如果环境变量中已经设置了 ANTHROPIC_API_KEY，Claude Code 会优先提示确认该 Key，而不是直接打开账号登录页面。想排查旧变量时，可以先查看当前 PowerShell 会话：

Get-ChildItem Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue

如果确认这是当前会话里不再使用的旧值，可仅从本次 PowerShell 会话移除后重新启动 Claude Code：

Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
claude

不要把 API Key 复制到聊天消息、截图、公开仓库或安装求助帖中。团队账号、Console 账号以及云平台接入方式，应继续查看官方 认证说明。

五、Git for Windows 要不要安装

在原生 Windows 上，Git for Windows 不是 Claude Code 的强制前置条件：

• 没有安装 Git for Windows 时，Claude Code 可以使用 PowerShell 工具执行命令；
• 安装 Git for Windows 后，可以使用 Git Bash 提供的 Bash 工具；
• WSL 环境不需要依赖 Git for Windows。

如果已经安装 Git for Windows，但 Claude Code 没找到 Bash，可在用户设置文件中配置路径。Windows 用户设置文件通常位于 %USERPROFILE%\.claude\settings.json：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

实际路径可能因安装位置而不同，可以先在文件资源管理器中确认 bash.exe 是否存在，再修改设置。

六、首次进入项目的安全配置

Claude Code 能读取文件、修改代码和运行命令。第一次使用时，建议按以下顺序进行：

1. 在项目目录先运行 git status，确认已有改动属于谁；
2. 让 Claude Code 只读分析目录、入口、构建和测试命令；
3. 指定允许修改的文件，不要只说“全部优化”；
4. 每完成一个小步骤就检查差异；
5. 运行项目原有的 lint、test 和 build；
6. 把安装、数据库迁移、删除文件和部署保留为单独审批步骤。

可以把首次提示词写成：

先只读检查当前项目，不要修改文件。
请说明技术栈、入口文件、启动命令、测试命令和当前 Git 状态。
不要读取或输出 .env、密钥和客户数据。
需要执行安装、删除、发布或联网操作时，先解释影响并等待确认。

更完整的权限与审查方法可继续阅读 OpenAI Codex安装与使用教程。这些边界同样适用于其他能操作本地项目的编程代理。

七、Windows 常见报错与解决办法

报错或现象	常见原因	处理方法
The token '&&' is not a valid statement separator	在 PowerShell 中执行了 CMD 安装命令	改用 irm https://claude.ai/install.ps1 | iex
'irm' is not recognized...	在 CMD 中执行了 PowerShell 命令	改用官方 install.cmd 命令，或打开 PowerShell
claude 无法识别	终端未刷新、安装未完成或 PATH 中存在问题	关闭并重开终端，运行 Get-Command claude，再对照官方安装排错页
下载出现 403、curl 错误或意外的 <	网络代理、安全软件或网关返回了网页，而非安装脚本	停止重复执行，检查访问 claude.ai 的网络策略，并使用官方替代安装方式
登录页没有打开	默认浏览器、网络策略或已有 API Key 环境变量影响认证	检查默认浏览器和网络，查看 ANTHROPIC_API_KEY，再重新运行 claude
找不到 Git Bash	Git 安装在非默认路径	核对 bash.exe，在 settings.json 配置 CLAUDE_CODE_GIT_BASH_PATH
更新后仍显示旧版本	电脑中存在多套安装	运行 Get-Command claude -All，保留一种安装方式后再检查版本

遇到安装下载问题时，优先使用官方 安装与登录故障排查。不要从下载站获取所谓绿色版或替换可执行文件。

八、更新与日常检查

官方原生安装会自动在后台检查更新，也可以手动执行：

claude update
claude doctor

如果是 WinGet 安装，则使用 winget upgrade Anthropic.ClaudeCode。更新后重新打开终端，再用 claude --version 验证当前实际调用的版本。

常见问题 FAQ

Claude Code 在 Windows 上一定要安装 Node.js 吗？

官方当前推荐的原生安装器不要求先通过 npm 安装。官方仍提供 npm 方式，但其运行环境要求会变化；普通 Windows 用户优先使用原生 PowerShell 安装即可。

PowerShell 和 CMD 选哪个？

两者都能安装，区别主要是安装命令语法。新手更适合 PowerShell，因为后续环境变量、路径检查和诊断命令更容易统一。

原生 Windows 和 WSL 能同时安装吗？

可以，但通常没有必要。两套环境的可执行文件、配置和项目路径相互独立，容易出现“更新了一个，运行的却是另一个”的情况。按项目所在环境保留一套更清楚。

首次登录一定需要 API Key 吗？

不一定。Claude Pro、Max、Team、Enterprise 等支持的账号可以按浏览器提示登录；Anthropic Console 和部分云平台工作流则可能使用 API 或云凭据。以官方认证页和终端实际提示为准。

Claude Code 安装好了，为什么免费账号不能进入？

官方当前说明 Claude 免费方案不包含 Claude Code。需要使用当前支持 Claude Code 的订阅、团队方案、Console 账号或受支持的云平台接入方式。

claude doctor 会修改项目吗？

官方说明该命令用于只读输出安装和设置诊断，不会启动项目会话。它适合用来检查安装健康、设置文件错误和更新警告。

官方来源

• Claude Code：系统要求、Windows 安装、验证与更新
• Claude Code 快速入门
• Claude Code 认证方式
• Claude Code 安装与登录故障排查
• Claude Code CLI 参考

继续阅读

• OpenAI Codex安装与使用教程
• OpenAI API Key安全配置指南
• Gemini AI Studio使用教程
• ChatGPT、Claude、DeepSeek编程能力怎么选
• ChatGPT、Claude、Gemini、Grok怎么选

站群延伸阅读

• Claude Code 中文教程与开发资料
• Codex 与 AI 编程工具中文指南

总结

Windows 安装 Claude Code 的最短路径是：选定原生 Windows 或 WSL 2，在正确的终端执行官方命令，用 claude --version 和 claude doctor 验证，再通过 claude 完成登录。真正进入项目后，先限制目录和命令权限，再逐步修改、检查差异和运行测试。