windows claude code 安装

要在Windows电脑上使用Claude Code进行代码问答、文件修改和命令执行，关键不在于复制一条安装命令，而在于构建一个兼容的终端运行环境。只要准备好Node.js 18及以上版本，并选择WSL或Git Bash作为终端载体，就能顺利完成安装并立即投入项目使用。

在终端中运行node --version和npm --version确认环境满足要求

1. 确认Windows环境与安装条件

首先确认电脑运行的是Windows 10或更高版本，并确保拥有至少4GB内存和稳定的互联网连接，因为Claude Code需要联网进行身份验证和AI处理。

核心依赖是Node.js，版本必须达到18或更高。打开终端输入以下命令检查当前环境：

node --version
npm --version

如果系统提示找不到node或npm，说明需要先安装Node.js。Windows用户主要有两条路径：一是使用WSL（Windows Subsystem for Linux），二是使用Git for Windows提供的Git Bash。无论选择哪种方式，都要确保终端能正确识别Node.js环境。

2. 准备Windows终端

如果你习惯使用WSL，可以直接打开对应的Linux发行版终端，后续所有命令都在其中执行。注意不要让WSL中的npm调用Windows分区里的node，否则可能引发路径识别错误。可以通过以下命令确认命令位置：

which node
which npm

如果更倾向于在原生Windows环境中操作，建议安装Git for Windows并使用Git Bash。在这种模式下，Claude Code需要定位到Git安装目录中的bash.exe。若Git采用默认安装路径，可以在PowerShell中设置环境变量：

$env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

如果Git安装在其他位置，请将路径修改为实际的bash.exe所在目录。设置完成后，重新打开终端以确保环境变量生效。

在PowerShell中配置Git Bash路径以支持原生Windows终端运行

3. 安装Node.js并检查npm

如果尚未安装Node.js，请先下载并安装Node.js 18或更高版本。安装完成后，务必关闭并重新打开PowerShell、Git Bash或WSL窗口，再次执行版本检查命令：

node --version
npm --version

只要node版本符合要求且npm能正常运行，即可进入下一步。在Windows环境下无需使用sudo提升权限，WSL中也应优先遵循当前Linux环境的权限管理规范。

4. 安装Claude Code

在确认Node.js可用的终端中，执行全局安装命令：

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

等待npm完成依赖下载和安装。安装结束后，检查claude命令是否可用：

claude --version

如果提示命令不存在，请尝试重新打开终端，或检查npm的全局安装路径是否已加入系统环境变量。遇到权限报错时，应通过调整npm配置解决，而非强行使用sudo。

使用npm install -g命令全局安装Claude Code包

5. 在项目目录中启动

进入你需要处理的项目文件夹，启动Claude Code：

cd your-project-directory
claude

将your-project-directory替换为实际的项目路径。启动后，终端会提示进行身份验证。你可以使用Anthropic Console，或根据账号类型选择支持的订阅服务及企业平台配置。只有完成登录，Claude Code才能执行需要在线服务的操作。

5. 在项目目录中启动

6. 用诊断命令确认配置

安装或更新后，建议运行诊断命令检查整体状态：

claude doctor

该命令会检查安装类型、Node.js版本、Git Bash路径及登录状态。如果诊断结果提示异常，请根据指引修正对应环境。WSL用户需重点检查Linux侧的node和npm路径；Git Bash用户则需核对CLAUDE_CODE_GIT_BASH_PATH是否指向正确的bash.exe。

7. 处理常见启动问题

如果提示找不到node，通常是终端调用了错误的Node.js路径，特别是在WSL中误用了Windows安装的Node.js时。若安装成功但claude无法启动，请关闭并重新打开终端，确认命令路径和版本信息。对于原生Git Bash模式，还需检查Git for Windows是否完整安装以及bash.exe路径是否正确。

完成上述步骤后，Windows上的Claude Code即可正常使用。具体登录方式和界面提示可能随版本更新而变化，实际操作请以终端显示为准。

在项目文件夹中启动claude并完成身份验证