在Windows安装Claude Code：PowerShell官方方式与错误确认

核心概括： 在Windows开始使用Claude Code CLI时，应先查看当前官方安装文档的Windows部分，区分自己打开的终端是否为PowerShell。执行安装命令、确认版本、账号认证与项目工作，是不同步骤。本文整理官方安装方式，并非在特定电脑完成安装的使用体验。

1. 选择Windows直接运行或WSL环境

官方安装指南介绍直接在Windows运行与在WSL内运行两种方式。如果主要使用Windows工具与文件夹，可考虑直接运行；Linux项目则应确认WSL条件。本文说明从PowerShell直接安装的方式。

2026年10月3日确认的文档，将Git for Windows列为可选，未安装环境也有使用PowerShell工具的说明。因此，不要把旧文章“没有Git Bash就无法安装”的表述当作当前条件。必要工具与系统要求，应依据官方文档当前内容比较。

2. 安装前确认终端与官方地址

Windows Terminal可以打开多个Shell。同一个窗口中，PowerShell与命令提示符使用不同命令。下方命令用于PowerShell，因此应确认打开PowerShell标签。提示符前面的PS通常有助于区分。

安装命令会下载并执行官方脚本。不要只相信文章字符串，应先与官方Quickstart中的Windows PowerShell项目确认地址一致后再使用。公司或学校管理电脑也适用对应安装政策。不要为了避免错误，一次修改不了解的设置。

3. 执行PowerShell安装命令

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

上方是截至确认日，官方文档列出的原生安装命令。实际结果应按网络连接、操作系统与组织政策等环境确认。执行后阅读输出，失败消息应原样记录。分别查看最后是否出现版本字符串，以及是否没有错误。

官方文档也有WinGet方式。与其同时尝试多个安装方法，不如记录所选方法与结果，更容易缩小问题。本文基本流程是上述PowerShell原生安装；选择其他方式时，也应从对应官方项目确认更新与管理流程。

4. 在新终端确认版本后打开项目

安装结束后，打开新PowerShell窗口，用下方命令确认是否找到可执行文件。

claude --version

显示版本，与完成Claude账号认证，是不同状态。随后进入实际工作项目文件夹，运行claude并按提示认证。可用账号与认证方式，应从官方文档确认。密码与验证码不要贴入公开文章或问题。

cd "C:\경로\내프로젝트"
claude

上方路径是示例，应改为实际文件夹。不熟悉项目时，首次可请求“只说明结构与运行方法，暂时不要修改文件”。确认版本只是检查安装状态，并不能证明项目构建或测试成功。

5. 逐项确认常见错误

• 找不到irm： 确认是否在命令提示符运行了PowerShell命令。
• 找不到claude： 确认是否打开新终端，比较安装输出与PATH指南。
• 403或下载错误： 记录输出错误与执行环境，查看官方安装问题文档对应项目。
• 命令运行，但认证失败： 分开检查安装错误与账号认证问题。

确认准确原因，可在官方安装、登录故障排查文档搜索错误提示。提问时，提供操作系统、终端类型、安装方法与错误信息，按必要范围遮盖个人路径与账号信息。先反复删除设置文件夹或重装，可能难以了解原状态。

6. 选择安装方法先查看项目位置

不要只因命令简短而改变安装方式，应先记录通常在哪里运行项目。例如，用Windows开发工具管理C盘文件夹，PowerShell原生方式自然；项目在Linux发行版内安装依赖与运行时，继续在该发行版WSL终端工作，更容易说明环境。

选择WinGet方式时，应结合对应指南使用官方winget install Anthropic.ClaudeCode。确认日原生安装提供自动更新，WinGet默认需要单独更新，手动命令为winget upgrade Anthropic.ClaudeCode。将安装与更新方法写成一行，之后咨询版本问题更方便。

也应区分安装所用Shell，与Claude Code执行工作命令的Shell。用PowerShell安装，不代表全部工作始终使用PowerShell。Git for Windows是否安装等当前环境会影响行为，因此应一起查看出错命令的实际运行环境。

7. 找不到可执行文件时，用只读方式确认

下方是调查安装状态的命令示例，并非本文运行结果。先在新PowerShell尝试claude --version，仅找不到文件时才扩大诊断。原生安装默认路径，是官方故障排查文档确认的用户文件夹下路径。其他安装方式在相同位置没有文件，并不能认定失败。

Get-Command claude -ErrorAction SilentlyContinue
where.exe claude
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

文件存在却找不到命令时，可比较安装输出PATH说明与当前窗口状态；文件本身不存在时，应回看下载、安装错误。修正PATH前，应阅读官方对应项目，了解添加哪个用户路径。用任意字符串覆盖完整PATH，可能使原因更复杂。

命令可运行时，可以用claude doctor请求安装与设置诊断。官方文档将其介绍为不开始会话的只读诊断。也应确认诊断建议符合自己的安装方式后应用。继续分别记录只能输出版本，与能够使用实际会话的状态。

8. 将虚构错误转为诊断请求

假设一个虚构情境：在PowerShell尝试原生安装，新窗口仍找不到命令，但上述Test-Path为True。这是说明情境，并非特定电脑观察。此时不要只说“安装不了”，按下方分开状态提问，就能分别审查文件存在与搜索路径。

Windows 직접 실행 환경이며 PowerShell을 사용 중입니다.
설치 방법: 공식 PowerShell 네이티브 명령.
설치 출력: [민감한 값은 가린 실제 마지막 오류·안내]
새 창의 claude --version: [실제 출력]
Get-Command / where.exe: [실제 출력 또는 출력 없음]
기본 파일 위치 Test-Path: [실제 True 또는 False]
이 기록에서 관찰된 사실과 가능한 원인을 나눠 설명해 주세요.
현재 상태를 바꾸지 않는 다음 진단 한 가지부터 제안해 주세요.
재설치·설정 삭제는 원인과 영향이 설명되기 전에는 제안만 해 주세요.

下载错误时，应先提供错误代码、安装地址与网络环境，而不是先使用格式中的文件确认。认证错误则补充版本能够输出，以及登录阶段提示。同样是失败，不同步骤所需信息不同。无须附上认证令牌或完整环境变量列表。

9. 记录首个项目运行与之后更新

1. 确认实际存在的项目文件夹路径。有空格时，用引号包围路径。
2. 进入该文件夹，确认当前是否有修改文件。不要为检查安装而删除项目文件。
3. 启动Claude Code并遵循认证提示，首次请求说明结构与运行流程。
4. 确认使用命令后，选择一个小任务。不要把构建完成也合并写入安装完成记录。

현재 프로젝트의 설명 파일과 실행 설정을 읽어 줘.
어떤 종류의 프로젝트인지, 시작 명령과 검증 명령의 근거 파일을 알려 줘.
파일 수정과 의존성 설치는 아직 하지 마.
모르는 명령을 추측하지 말고, 확인할 파일이나 질문을 제시해 줘.

更新后出现问题时，同时记录安装方式、旧版本、当前版本与失败命令。相比“更新导致损坏”这一原因结论，“更新后在这个输入出现这个错误”的观察，是诊断起点。分别确认相同项目其他命令是否正常，也能缩小调查范围。

更换终端后结果不同怎么办？

先比较两窗口类型与可执行文件路径。Windows PowerShell与WSL的路径表示、安装位置可能不同。两个窗口输入同名命令，不代表运行相同安装。先规定准备使用的环境，再记录对应路径与版本。

常见问题与错误处理

需要管理员窗口吗？ 截至确认日，官方Windows原生指南说明不需要管理员运行。各环境政策应另行确认。WSL也使用PowerShell命令吗？ WSL内部安装应遵循官方Linux、WSL方式。如何记录安装成功？ 分别记录实际显示版本、认证状态与尚未确认的项目行为。

官方来源与确认日期

• 高级设置
• 快速入门
• 排查安装与登录问题

官方文档确认日期：2026年10月3日。画面与提供条件之后可能变化。