Windows系统安装Claude Code时遇到PowerShell权限报错怎么办？|powershell|CMD|git|windows系统|终端

　　一、Claude Code 简介与安装前置条件

　　Claude Code 是 Anthropic 推出的 AI 命令行编程助手，可直接在终端中与 Claude 对话，完成代码编写、文件操作、项目分析等任务。Windows 原生安装依赖于 Git for Windows、Node.js v18+ 以及 PowerShell 或 CMD 环境。安装方式主要有两种：官方推荐的原生安装器（PowerShell 一键脚本）和备选的 npm 全局安装。

　　二、PowerShell 权限报错的根源

　　PowerShell 默认的执行策略为 Restricted，禁止运行任何

　　.ps1

　　脚本。当运行

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

　　或安装后执行

　　claude

　　命令时，系统会提示：“无法加载文件，因为在此系统上禁止运行脚本”。这是 Windows 的安全机制，并非 Claude Code 本身的问题。

　　三、解决方案：三种应对方法

　　1. 方法一：以管理员身份修改执行策略

　　右键点击“开始”按钮，选择“Windows PowerShell (管理员)”或“终端 (管理员)”。

　　执行以下命令：

　　Set-ExecutionPolicy RemoteSigned

　　。

　　输入

　　确认更改。

　　修改后，重新运行安装或启动命令即可。

　　此方法将执行策略改为“允许本地脚本运行，远程脚本需签名”，兼顾安全性与便利性。

　　2. 方法二：临时绕过（适用于单次安装）

　　如果不想全局修改策略，可在当前会话中临时绕过：

　　随后执行安装脚本

　　.\install.ps1

　　，仅当前窗口生效。

　　3. 方法三：使用 CMD 代替 PowerShell

　　Claude Code 原生安装器也支持 CMD 命令：

　　CMD 不受 PowerShell 执行策略限制，可绕过该报错。

　　四、安装后的关键配置

　　1. 添加 PATH 环境变量

　　安装完成后，Claude Code 可执行文件位于

　　C:\Users\你的用户名\.local\bin

　　，需将其添加至系统 PATH，否则终端无法识别

　　claude

　　命令。方法：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”→“用户变量”→Path→新建→粘贴路径。重启终端后生效。

　　2. 使用国内镜像加速安装

　　若 npm 安装速度过慢，可配置淘宝镜像：

　　再执行

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

　　。

　　3. 务必安装 Git for Windows

　　Claude Code 内部依赖 git-bash 执行命令，未安装 Git 会导致 “No suitable shell found” 错误。安装后在系统变量中设置

　　CLAUDE_CODE_GIT_BASH_PATH

　　指向

　　bash.exe

　　路径（如

　　C:\Program Files\Git\bin\bash.exe

　　）。

　　五、验证安装与开始使用

　　关闭所有终端，重新打开 PowerShell。

　　输入

　　claude --version

　　，看到类似

　　2.1.89 (Claude Code)

　　的输出即安装成功。

　　首次运行

　　claude

　　会提示登录，使用 Anthropic API Key 或 Claude.ai 账号完成认证。

　　如需接入国产模型（如 DeepSeek），可通过配置环境变量

　　ANTHROPIC_BASE_URL

　　和

　　ANTHROPIC_AUTH_TOKEN

　　实现。

　　六、常见问题速查

问题
解决方案
命令“claude”不是内部或外部命令
检查 PATH 是否包含
　　.local\bin
　　路径，重启终端
npm 安装后提示“Wrong package!”
　　误装了仿冒包
　　claude-code
　　，应卸载后重装
　　@anthropic-ai/claude-code
“Claude Code requires Node.js version 18 or higher”升级 Node.js 至 LTS v18+
原生安装器卡住无响应改用 npm 方式安装，或使用 CMD 命令安装