环境配置
先在原生 Windows 与 WSL2 中选定一条路径，再完成官方安装、登录、健康检查和首个只读任务。
工具专项 · 安装配置
先决定原生 Windows 还是 WSL2，避免两边混装、路径错位和权限混乱。
只读检查当前项目，报告当前目录、主要文件和 Git 状态；不要修改文件、安装依赖或执行写入命令。
完整文章包含当前安装命令、风险边界、故障排查和逐项验收。
Claude Code 现在可以原生运行在 Windows，也可以运行在 WSL2。
最重要的不是“哪个更高级”，而是项目文件在哪一边。
第一步
路径选错会带来权限、性能和工具链混乱。
| 方案 | 适合 | 注意 |
|---|---|---|
| 原生 Windows | 项目和常用工具都在 Windows；希望用 PowerShell 或 Git Bash | 沙箱当前不受支持；Git for Windows 是可选项 |
| WSL2 | 项目本来就在 Linux 环境；需要 Linux 工具链或沙箱执行 | 在 WSL 终端安装和启动，项目也尽量放在 WSL 文件系统 |
第二步
使用当前官方原生安装，不需要先安装 Node.js。
irm https://claude.ai/install.ps1 | iexwinget install Anthropic.ClaudeCodecurl -fsSL https://claude.ai/install.sh | bashwinget upgrade Anthropic.ClaudeCode。第三步
所有命令都在你刚才选择的同一环境中运行。
claude --version
claude doctor
claudeclaude；或把 WSL 项目从 /mnt/c 大量跨文件系统读写，导致性能和权限问题。先用 pwd 或 Get-Location 确认所在环境。第四步
先证明它读的是你认为的项目，再允许任何修改。
claude doctor 没有未处理的关键错误可选
基础命令能正常运行后，再安装 VS Code 官方扩展。
理解机制
它们能访问彼此文件，但命令、权限、PATH 和工具链并不是同一套。
原生 Windows 的 claude.exe 运行在 Windows 用户环境；WSL2 里的 Claude Code 运行在 Linux 用户环境。你在哪边安装，就应在哪边启动，并优先把项目放在同一边的文件系统。
例如：项目在 C:\work\demo 且依赖 Windows 工具时选原生；项目在 WSL 的 ~/work/demo 且依赖 Linux 脚本时选 WSL2。不要用 PowerShell 安装后去 Ubuntu 终端查版本。