Claude Code Windows 安装教程：PowerShell、CMD、Git Bash 与登录验证

Claude Code 在 Windows 上可以原生运行，也可以安装在 WSL 中。按 Anthropic 当前官方安装文档，原生 Windows 支持 Windows 10 1809 及以上或 Windows Server 2019 及以上，Shell 可使用 PowerShell 或 CMD；Git for Windows 不是原生安装的硬性前置条件，但安装后可让 Claude Code 使用 Git Bash。本文截至 2026 年 10 月 12 日核验。

已有的 Windows 通用安装与环境排查 更偏环境思路；本文专门解决官方安装命令、终端区别和安装后验证。

安装前检查

官方当前列出的基本条件包括：

• Windows 10 1809+ 或 Windows Server 2019+。
• 至少 4 GB 内存，x64 或 ARM64 处理器。
• 可用网络连接。
• PowerShell 或 CMD 等支持的 Shell。
• 账号和地区符合 Anthropic 当前服务条件。

不建议在包含密码、SSH 私钥、客户文件或生产配置的目录中第一次启动。先准备一个脱敏测试项目，并保存当前代码改动。

方案一：PowerShell 原生安装

打开 PowerShell 或 Windows Terminal，按官方当前示例运行：

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

这里的 irm 是 PowerShell 的 Invoke-RestMethod 别名。命令只适用于 PowerShell，不要在 CMD 中直接粘贴。如果你对远程脚本不熟悉，先打开官方文档核对域名、命令和当前版本，再执行。

安装完成后关闭当前终端窗口，重新打开一个 PowerShell，再验证：

claude --version
claude doctor

官方文档说明，正常安装应输出版本号；claude doctor 用于查看安装健康、设置文件和警告，不会直接启动完整会话。

方案二：CMD 原生安装

如果你使用的是 Windows CMD，官方当前示例为：

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

CMD 和 PowerShell 的命令分隔符及下载语法不同。若在 PowerShell 中看到 && 相关语法错误，或者在 CMD 中看到 irm 不被识别，通常是终端和命令不匹配。

安装结束后重新打开 CMD，运行：

claude --version
claude doctor

不要为了绕过错误而同时执行 PowerShell 和 CMD 两套安装流程，先保留错误信息，确认当前实际安装来源。

Git for Windows、Git Bash 与 PowerShell 怎么选

原生 Windows 安装不强制要求 Git for Windows。官方文档建议安装它，是因为 Claude Code 可以使用 Git Bash 作为 Bash 工具；没有 Git for Windows 时，Claude Code 会使用 PowerShell 工具。

环境	适合情况	注意点
原生 PowerShell	Windows 项目、PowerShell 脚本和常规开发	命令示例要使用 PowerShell 语法
原生 CMD	需要传统 Windows 命令行	不要照搬 PowerShell 别名和语法
Git Bash	需要 Bash 工具、Git 工作流和类 Unix 命令	检查 Git 安装路径和换行符
WSL 2	Linux 工具链或需要沙箱能力	在 WSL 终端内安装和启动，不要混用 Windows 路径与 Linux 环境

如果已安装 Git for Windows 但 Claude Code 找不到 Git Bash，可以在设置中配置类似路径：

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

实际路径以本机安装位置为准，不要把示例路径当成固定值。

WSL 与原生 Windows 的关键区别

WSL 适合项目本来就依赖 Linux 命令、容器或 Unix 工具链的情况。官方当前文档列出 WSL 2 支持沙箱，而原生 Windows 不支持该沙箱能力；但 WSL 也意味着你要在 WSL 的文件系统、终端和运行时中管理项目。

如果项目位于 Windows 文件盘、依赖 Windows GUI 或使用 Windows 专属工具，原生安装通常更直接。不要在同一个项目里随意交替使用 Windows 与 WSL 的依赖目录，避免路径、权限、换行符和 node_modules 混乱。

登录与首次启动

安装后在脱敏测试项目中运行：

claude

按照官方浏览器授权流程登录。不要把验证码、恢复码、API Key 或浏览器 Cookie 发给所谓“代登录”服务。网页订阅、API Key、第三方网关和云平台账号可能是不同的服务主体。

首次启动建议使用只读任务：

请先只读检查当前项目，不要修改文件、安装依赖或执行网络命令。
输出项目入口、主要目录、测试命令和你实际读取的文件。
不要读取 .env、证书、SSH 密钥、客户数据和生产配置。

确认读取范围后，再允许一个很小的编辑任务。

安装完成后怎么配置 API

如果你只是使用官方 Claude Code 登录流程，可以先完成登录和低风险任务验证；如果你需要用 API Key、切换模型或把 Claude Code 接入多模型工作流，不要直接复制网上旧教程中的固定变量。先确认服务商当前文档给出的 API 基础地址、认证字段、模型名称和兼容范围，再配置到受控环境变量中。

如果需要在 Claude、GPT、Gemini 等模型之间统一管理，可以了解 Claude Code API 配置指南和 ZeoAPI 接入 Claude Code。ZeoAPI 是独立第三方 API 网关，不是 Anthropic 官方服务；接入前要单独核对模型映射、Token 计费、数据处理、限流和服务状态。不要把生产 Key 写进项目、截图或公开仓库。

“找不到命令”排查顺序

1. 关闭并重新打开终端，让 PATH 刷新。
2. 运行 claude --version，确认命令是否被识别。
3. 运行 claude doctor，记录安装目录和设置警告。
4. 检查是否安装了多个来源或多个版本。
5. 确认当前终端不是 WSL、PowerShell 和 CMD 混用造成的路径错位。
6. 按官方安装排错页面处理，不要随意删除配置目录或锁文件。

如果安装脚本返回 403、HTML、代理错误或网络超时，先核对网络和官方域名；不要把错误页面保存成脚本继续执行。

更新与安全

原生安装通常会自动更新，WinGet 等其他方式的更新策略不同。升级前查看当前安装来源和发行渠道，更新后再次运行 claude --version 与关键项目测试。

Windows 上不要把整个用户目录、网络盘或含有 WebDAV 子目录的路径开放给工具。涉及文件写入、命令执行、MCP、部署和删除时，先阅读完整命令并人工确认。更多内容可参考 Claude Code 故障排查 和 API Key 安全清单。

需要 API 网关时的边界

如果你需要把 Claude Code 接到独立 API 服务，可以阅读 ZeoAPI 接入 Claude Code。ZeoAPI 是独立第三方 API 网关，不是 Anthropic 官方服务；配置前要核对模型映射、令牌、数据链路、计费和服务条款，Key 只放在受控环境变量中。

官方参考

• Claude Code 安装与高级设置
• Claude Code 故障排查
• Claude Code 安全说明