FollowAgents AI AGENTS 目录
首页/ 横向对比/ Claude Code Windows 安装与排错指南

返回 Claude Code 介绍与审查 →

安装与排错指南

Claude Code Windows 安装与排错指南

在 Windows 上安装 Claude Code：选原生还是 WSL 2，PowerShell / CMD / WinGet 安装命令，Git for Windows 要不要装，'claude' is not recognized 等常见报错对照，登录与权限模式，均链接官方文档。

文档核验

核验日期：2026-10-20。本文依据 Anthropic 官方 Claude Code 文档整理，本站尚未在新版 Claude Code 上完成 Windows 实测。Claude Code 更新很快，命令以文中链接的官方页面为准。

在 Windows 上装 Claude Code，最常见的问题不是 Claude Code 本身，而是三件事：在原生 Windows 还是 WSL 里装，命令贴错了终端（PowerShell 和 CMD 的命令不一样），以及装完提示 'claude' is not recognized。本文按这个顺序讲，最后说明套餐、权限和卸载。

如果你还在比较工具，先看 Claude Code 的功能与审查结果，或 Claude Code 与 Codex 怎么选。

先确认：你的套餐和电脑能不能用

  • 套餐：官方写明需要 Pro、Max、Team、Enterprise 或 Console（API）账号，免费的 claude.ai 套餐不包含 Claude Code。也可以通过 Amazon Bedrock、Google Cloud 或 Microsoft Foundry 使用。
  • 系统：Windows 10 1809 及以上，或 Windows Server 2019 及以上；x64 或 ARM64；至少 4 GB 内存。不支持 32 位 Windows。
  • 地区：需要在 Anthropic 支持的国家和地区 使用。列表里没有中国大陆和中国香港，官方说明未列出的地区均不支持。

见 官方安装与系统要求。

第一步：原生 Windows 还是 WSL

方式 需要什么 沙箱 适合
原生 Windows 什么都不需要；Git for Windows 可选 不支持 项目和工具都在 Windows 上
WSL 2 启用 WSL 2 支持 Linux 工具链，或想让命令在沙箱里执行
WSL 1 启用 WSL 1 不支持 用不了 WSL 2 时才考虑

简单说：项目是 Windows 原生的（.NET、Windows 桌面程序等）就原生安装；项目本来就在 Linux 环境里跑，或者想让 Claude Code 执行的命令在沙箱里隔离，就用 WSL 2。

第二步：安装

原生 Windows：不需要管理员权限。先看清你打开的是哪种终端——提示符是 PS C:\Users\你的名字> 的是 PowerShell，没有 PS 的是 CMD。

PowerShell：

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

CMD：

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

也可以用 WinGet（不会自动更新，需要定期运行 winget upgrade Anthropic.ClaudeCode）：

winget install Anthropic.ClaudeCode

安装过程不显示进度。装完新开一个终端窗口，运行 claude --version，打印出版本号就说明成功了。

WSL：打开你的 WSL 发行版，在 WSL 终端里运行 Linux 版安装命令，之后也在 WSL 终端里启动 claude，不要从 PowerShell 或 CMD 启动：

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

原生安装的版本会在后台自动更新；想立刻更新运行 claude update，想全面体检运行 claude doctor。

第三步：要不要装 Git for Windows

原生 Windows 上，Git for Windows 是可选的：

  • 没装：Claude Code 用 PowerShell 执行命令。
  • 装了：Claude Code 用 Git Bash 执行命令，同时 PowerShell 工具也可用。很多项目的脚本和文档默认是 Bash 写法，装上会更顺。

如果装了 Git 但 Claude Code 找不到，先用 where.exe git 找到安装位置，再在 settings.json 里指定 bash.exe 的路径：

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

WSL 里不需要 Git for Windows。

常见报错对照

按 官方安装排错文档 整理：

你看到的 原因 怎么办
'irm' is not recognized 在 CMD 里运行了 PowerShell 命令 换 PowerShell，或改用上面的 CMD 命令
The token '&&' is not a valid statement separator 在 PowerShell 里运行了 CMD 命令 改用上面的 PowerShell 安装命令
A parameter cannot be found that matches parameter name 'fsSL' 在 PowerShell 里运行了 macOS/Linux 的 curl 安装命令 改用 PowerShell 安装命令
'claude' is not recognized 安装目录 %USERPROFILE%\.local\bin 不在 PATH 里，或者没开新终端 先开新终端再试；仍不行就把该目录加入用户 PATH（见下方）
更新后突然 'claude' is not recognized claude.exe 在更新中丢失 运行下方的恢复命令，或重新运行安装命令
The process cannot access the file ... being used by another process 另一个安装窗口或杀毒软件占用了下载目录 关掉其他安装窗口，删除 %USERPROFILE%\.claude\downloads 后重装
running scripts is disabled on this system 用 npm 安装时，PowerShell 执行策略拦截了 .ps1 启动脚本 改用 PowerShell 安装命令；或运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
运行 claude 打开的是桌面版 旧版 Claude Desktop 抢占了 claude 命令 把 Claude Desktop 更新到最新版
提示不支持 32 位 Windows 可能打开的是 Windows PowerShell (x86) 改用不带 x86 的 PowerShell；若系统确实是 32 位则无法使用
WSL 里 Exec format error 用的是 WSL 1 在 PowerShell 运行 wsl --set-version <发行版名> 2 转成 WSL 2

把安装目录加入用户 PATH（PowerShell，执行后重开终端）：

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User")

更新后 claude.exe 丢失时，把最新的备份改回原名：

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

第四步：登录

在项目目录运行 claude，按提示在浏览器里登录。浏览器没有自动打开时，按 c 复制登录链接，手动粘贴到浏览器。

在 WSL 2 里登录，浏览器常常打不开，或者登录后跳不回来：

  • 让 WSL 使用 Windows 上的浏览器：export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"，再运行 claude。
  • 登录后浏览器显示一串登录码时，把它粘贴回终端。在 Windows Terminal 里，粘贴可以试试右键或 Shift+Insert。
  • 实在不行，改用 claude auth login。

登录出了说不清的问题时，在会话里运行 /logout，退出后重新运行 claude 登录，可以解决大部分情况。

第五步：第一个任务与权限

在一个用 Git 管理的项目里运行 claude，先问一个不改文件的问题。Claude Code 用“权限模式”决定什么操作要先问你，按 Shift+Tab 在几种模式之间切换，状态栏会显示当前模式。按 官方权限模式文档：

模式 不问你就能做的 适合
default（手动） 只读文件 每一步都自己确认
acceptEdits 读文件、改文件和常见的文件操作命令 边看边改代码
plan 只读和探索，改动要等你批准计划 动手前先摸清代码
auto 几乎所有操作，由后台分类器做安全检查 长任务，减少确认次数

注意：较新版本的交互会话默认就是 auto。想更保守，可以这样启动：

claude --permission-mode plan

--dangerously-skip-permissions（即 bypassPermissions）会跳过所有确认，官方要求只在隔离的容器或虚拟机里用。原生 Windows 不支持沙箱，所以在原生 Windows 上更不要开这个模式。

卸载

原生安装（PowerShell）：

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

WinGet 安装：winget uninstall Anthropic.ClaudeCode。设置、MCP 配置和会话记录在 %USERPROFILE%\.claude 和 %USERPROFILE%\.claude.json，删除前确认不再需要。VS Code 插件、JetBrains 插件和桌面版也会写这个目录，要彻底清除得先卸载它们。

常见问题

Claude Code 免费吗？有免费额度吗？ 免费的 claude.ai 套餐不包含 Claude Code，最低需要 Pro。也可以用 Console 的 API key 按量付费。见 官方安装文档。

不想用命令行怎么办？ 官方有 Windows 桌面版，可以不开终端使用 Claude Code。下载入口见 官方安装文档。

能用其他模型吗？ Claude Code 官方支持的是 Anthropic 账号，以及 Bedrock、Google Cloud、Microsoft Foundry 这几个云平台。想在多个模型供应商之间切换，有人用 CC Switch，但第三方中转的风险要自己评估。想换一个不绑定厂商的编程 Agent，可以看 OpenCode 教程。

和 Codex 怎么选？ 主要看你已有的套餐和想用的模型。见 Claude Code vs Codex 和 AI 编程 Agent 排行榜。