企业官网建设流程全解析

1. 为什么 Windows 用户值得折腾 Claude Code

Claude Code 是 Anthropic 推出的终端 AI 编程助手，它跟你在网页上跟 Claude 聊天完全是两码事。它直接跑在你的终端里，能读写你本地的项目文件、执行命令、跑测试、改代码，相当于一个随时待命的结对程序员。2025 年以来，它在 Mac 和 Linux 上已经相当成熟，但 Windows 这边的体验一直有点“二等公民”的味道——官方早期只给了 macOS 和 Linux 的原生支持，Windows 用户要么走 WSL，要么等原生版本。

我自己的主力开发机是 Windows 11，从 Claude Code 刚开放那会儿就开始折腾，中间踩过的坑包括但不限于：Node 版本冲突、WSL 路径映射错乱、终端编码乱码、Git Bash 下交互异常、npm 全局安装权限报错。这篇文章就是把这些经验一次性倒出来，从零开始讲清楚在 Windows 上怎么把 Claude Code 跑起来、怎么配得顺手、以及遇到问题怎么排查。

适合谁看？如果你是 Windows 平台的开发者，日常用 VSCode 写代码，想试试 AI 辅助编程但不想换系统，那这篇就是给你写的。如果你已经在用 WSL 但 Claude Code 跑不起来，或者跑起来了但总觉得别扭，也能在这里找到答案。我不假设你有 Linux 背景，所有命令都会解释清楚在干什么。

先说结论：Windows 上用 Claude Code，目前最稳的路线是WSL2 + Node.js 20+ + npm 全局安装，原生 Windows 版本虽然已经可用，但在文件路径、终端兼容性上仍有小毛病。下面我会把两条路线都讲透，你自己选。

2. 安装前的环境准备与方案选型

2.1 两条路线怎么选：原生 Windows vs WSL2

Claude Code 在 Windows 上有两种跑法，选哪条直接决定了你后面会不会被各种奇怪问题折磨。

原生 Windows 路线：直接在 PowerShell 或 CMD 里装 npm 包运行。优点是启动快、不用管 WSL 那套东西、文件路径就是 Windows 路径。缺点是 Claude Code 内部大量依赖 Unix 风格的命令和路径处理，在原生 Windows 上偶尔会出现路径分隔符混乱、shell 命令执行失败的情况。官方虽然一直在改进，但截至我写这篇的时候，原生体验还是不如 WSL 顺滑。

WSL2 路线：在 Windows 里跑一个轻量级 Linux 虚拟机，Claude Code 装在 Linux 侧，通过/mnt/c/访问 Windows 文件。优点是兼容性最好，几乎所有 Unix 工具链都能直接用，Claude Code 的行为跟在原生 Linux 上一致。缺点是文件跨系统访问有性能损耗，而且你得理解 WSL 的路径映射逻辑。

我的建议很直接：如果你只是轻度使用、项目不大，走原生路线省事；如果你要长期用、项目复杂、经常跑构建和测试，老老实实上 WSL2。下面两条路线我都会给完整步骤。

2.2 Node.js 环境：版本选对少一半问题

Claude Code 是通过 npm 分发的，所以 Node.js 是硬性依赖。这里有个坑：Node 版本太低会直接装不上或者跑起来报错。官方要求 Node 18 以上，但我实测下来，Node 20 LTS 或 22 LTS 最稳，Node 18 在某些依赖上会有警告。

安装 Node 我推荐两种方式：

• 官方安装包：去 nodejs.org 下载 LTS 版本的.msi，一路下一步。优点是简单，缺点是全局包权限有时候会抽风。
• nvm-windows：Node 版本管理工具，可以随时切换版本。如果你机器上已经有其他项目依赖不同 Node 版本，强烈建议用这个。

用 nvm-windows 的话，装完之后在 PowerShell 里：

nvm install 20.18.0 nvm use 20.18.0 node -v npm -v

看到版本号输出就说明 OK 了。这里注意，nvm-windows 切换版本后，全局安装的 npm 包不会跟着走，每个 Node 版本有独立的全局包目录，这点跟 Mac 上的 nvm 不太一样，别搞混了。

提示：如果你之前用官方安装包装过 Node，再装 nvm-windows 可能会冲突。建议先把原来的 Node 卸载干净，删掉C:\Program Files\nodejs和用户目录下的npm、npm-cache文件夹，再装 nvm。

2.3 Git 与终端工具的准备

Claude Code 很多操作依赖 Git，比如它要看你项目的改动、生成 diff、提交代码。所以 Git 必须装。去 git-scm.com 下载 Windows 版，安装时有个选项叫“Adjusting your PATH environment”，选Git from the command line and also from 3rd-party software，这样 PowerShell 和 CMD 里都能直接用git命令。

终端方面，Windows Terminal 是目前最好的选择，比老旧的 CMD 和 PowerShell 窗口强太多，支持多标签、分屏、自定义配色。微软商店直接搜“Windows Terminal”装上就行。如果你走 WSL2 路线，Windows Terminal 能自动识别 WSL 发行版，一键切换。

VSCode 这边，Claude Code 有官方扩展，装完之后可以在 VSCode 的集成终端里直接调用，也能通过命令面板触发。VSCode 官网下载安装，然后装几个必备扩展：中文语言包、GitLens、以及 Claude Code 官方扩展。

3. 原生 Windows 安装 Claude Code 全流程

3.1 npm 全局安装与权限处理

环境准备好之后，打开 PowerShell（建议用管理员身份，避免权限问题），执行：

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

这条命令会从 npm 仓库拉取 Claude Code 的最新版本，装到全局目录。装完之后验证：

claude --version

如果输出版本号，说明安装成功。如果报“claude 不是内部或外部命令”，说明 npm 全局目录没加到 PATH 里。解决办法是找到 npm 全局目录：

npm config get prefix

把这个路径加到系统环境变量 PATH 里，重启终端即可。

这里有个 Windows 特有的坑：npm 全局安装有时会因为权限不足失败，报EACCES或EPERM。如果你用的是官方安装包的 Node，全局目录在C:\Program Files\nodejs下，普通用户没写权限。解决办法有两个：一是用管理员身份运行 PowerShell，二是把 npm 全局目录改到用户目录下：

npm config set prefix "C:\Users\你的用户名\.npm-global"

然后把C:\Users\你的用户名\.npm-global加到 PATH 里。这样以后装全局包就不需要管理员权限了。

3.2 首次启动与登录认证

装好之后，在项目目录下执行：

claude

第一次运行会引导你登录。Claude Code 支持两种认证方式：一是用 Anthropic 账号登录（会打开浏览器走 OAuth），二是用 API Key。如果你有 Claude 的订阅，直接走账号登录最省事。如果走 API Key，需要先去 Anthropic 控制台生成一个 Key，然后在终端里粘贴。

登录成功后，你会看到一个交互式界面，可以直接输入自然语言让它干活。比如：

帮我看看这个项目的结构，然后告诉我入口文件在哪

它会自动扫描目录、读文件、给出分析。这时候你就知道它跑起来了。

注意：首次启动时 Claude Code 会请求一些权限，比如读取当前目录、执行 shell 命令。它会明确问你“是否允许”，你可以选择“本次允许”或“始终允许”。建议刚开始选“本次允许”，观察它的行为，确认没问题后再放开。

3.3 VSCode 集成配置

VSCode 里用 Claude Code 有两种方式。第一种是在集成终端里直接敲claude，跟在外面用一样。第二种是装官方扩展，装完之后按Ctrl+Shift+P打开命令面板，输入 “Claude” 就能看到相关命令，比如 “Claude Code: Start Session”。

扩展的好处是它能跟 VSCode 的编辑器状态联动，比如你当前打开的文件、选中的代码，Claude Code 能直接感知到。配置上，扩展默认会读取你系统里的 Claude Code 安装，不需要额外设置。如果你走 WSL2 路线，需要在 VSCode 里装 WSL 扩展，然后连接到 WSL 环境，再在 WSL 侧装 Claude Code 扩展。

VSCode 的settings.json里可以加一些配置来优化体验：

{ "terminal.integrated.defaultProfile.windows": "PowerShell", "terminal.integrated.fontSize": 14, "files.autoSave": "afterDelay" }

字体大小调大一点，因为 Claude Code 输出信息量很大，字太小看着累。

4. WSL2 路线：更稳的长期方案

4.1 WSL2 安装与发行版选择

WSL2 的安装现在非常简单，管理员 PowerShell 里一条命令：

wsl --install

这条命令会自动启用 WSL 功能、下载内核、装一个默认的 Ubuntu 发行版。装完重启电脑，然后设置 Ubuntu 的用户名和密码。

如果你想要更多控制，可以指定发行版：

wsl --list --online wsl --install -d Ubuntu-22.04

Ubuntu 22.04 LTS 是目前最稳的选择，软件源丰富，社区支持好。装完之后用wsl命令进入，或者直接在 Windows Terminal 里选 Ubuntu 标签页。

这里有个常见需求：把 WSL 装到 D 盘。默认 WSL 装在 C 盘，时间长了占用空间很大。迁移方法是先导出再导入：

wsl --export Ubuntu-22.04 D:\wsl\ubuntu.tar wsl --unregister Ubuntu-22.04 wsl --import Ubuntu-22.04 D:\wsl\ubuntu D:\wsl\ubuntu.tar

导入之后默认用户会变成 root，需要改回普通用户。编辑/etc/wsl.conf，加上：

[user] default=你的用户名

然后wsl --shutdown重启 WSL 生效。

4.2 WSL 内 Node 环境搭建

进入 WSL 之后，先更新包列表：

sudo apt update && sudo apt upgrade -y

然后装 Node。WSL 里我推荐用 nvm 而不是 apt 自带的 Node，因为 apt 的版本通常比较旧：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash source ~/.bashrc nvm install 20 nvm use 20

装完之后node -v确认版本。然后装 Claude Code：

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

WSL 里没有权限问题，因为 npm 全局目录在用户 home 下，直接就能写。

4.3 跨系统文件访问与路径映射

WSL 访问 Windows 文件通过/mnt/c/、/mnt/d/这样的挂载点。比如你的项目在D:\projects\myapp，在 WSL 里就是/mnt/d/projects/myapp。

这里有个性能坑：跨系统访问文件很慢，尤其是大量小文件读写的时候。如果你项目在 Windows 盘上，Claude Code 在 WSL 里跑，每次读文件都要跨一层文件系统，速度会明显下降。解决办法是把项目放在 WSL 自己的文件系统里，也就是~/projects/下，这样读写都是 Linux 原生速度。

但如果你必须用 Windows 盘上的项目（比如团队协作要求），那就接受这个性能损耗，或者用 VSCode 的 Remote-WSL 功能，让 VSCode 在 WSL 侧运行，这样编辑器操作也走 Linux 侧，整体会快一些。

路径映射还有个细节：Claude Code 生成的路径可能是/mnt/c/...格式，如果你在 Windows 侧的 Git 里提交，路径会不对。所以跨系统项目最好统一在一侧操作，别两边混着来。

5. 避坑优化：常见问题与排查实录

5.1 安装阶段的典型报错

报错一：npm ERR! code EACCES

这是权限问题，前面讲过，要么用管理员，要么改 npm prefix。改 prefix 之后记得把新路径加到 PATH。

报错二：claude: command not found

npm 全局目录不在 PATH 里。用npm config get prefix找到路径，加到环境变量。WSL 里则是检查~/.bashrc有没有 source nvm。

报错三：Node 版本不兼容

报错信息里会写requires Node >= 18。用node -v检查，低了就升级。nvm 用户直接nvm install 20 && nvm use 20。

报错四：网络超时

npm 装包时如果卡住或超时，可以换国内镜像源：

npm config set registry https://registry.npmmirror.com

装完 Claude Code 后可以换回官方源，或者保持镜像源也行，看个人习惯。

5.2 运行时的交互异常

问题：终端里中文乱码

Windows 终端默认编码可能是 GBK，Claude Code 输出 UTF-8 就会乱码。解决办法是在 PowerShell 里执行：

chcp 65001

或者在 Windows Terminal 的设置里把默认编码改成 UTF-8。VSCode 集成终端一般没这个问题。

问题：Claude Code 执行 shell 命令失败

原生 Windows 下，Claude Code 可能调用bash或sh，但 Windows 没有这些。解决办法是装 Git Bash，然后把 Git 的bin目录加到 PATH 里，或者直接用 WSL2 路线绕开这个问题。

问题：交互式界面按键没反应

某些终端模拟器对 ANSI 转义序列支持不好，导致 Claude Code 的交互界面按键失灵。换 Windows Terminal 基本能解决。如果还不行，试试在 VSCode 集成终端里跑。

5.3 性能与体验优化

优化一：项目放在 WSL 文件系统内

前面提过，跨系统文件访问慢。把项目 clone 到~/projects/下，Claude Code 读写速度会快很多。

优化二：配置.claudeignore

跟.gitignore类似，Claude Code 支持.claudeignore文件来排除不需要扫描的目录，比如node_modules、dist、.git。这样它能更快地理解项目结构，也避免把大量无关文件喂给模型。

node_modules/ dist/ build/ .git/ *.log

优化三：合理使用权限模式

Claude Code 有几种权限模式，默认每次操作都问你。如果你信任它，可以在设置里开启“自动允许读取”或“自动允许执行”，减少打断。但生产环境或重要项目建议保持手动确认，避免它误改文件。

优化四：VSCode 里配置快捷键

在 VSCode 的keybindings.json里加一条：

{ "key": "ctrl+shift+c", "command": "workbench.action.terminal.sendSequence", "args": { "text": "claude\n" } }

这样按Ctrl+Shift+C就能快速在终端里启动 Claude Code。

5.4 常见问题速查表

6. 我个人的实操心得与后续扩展

折腾 Claude Code 这段时间，我最大的体会是：Windows 上的问题，九成都能靠 WSL2 解决。原生路线虽然能跑，但总有些小毛病让你分心，而 WSL2 一旦配好，后面就基本不用管了。我现在的日常是 VSCode + Remote-WSL + Claude Code，项目放在 WSL 的 home 目录下，Windows 侧只负责显示和输入，所有开发操作都在 Linux 侧完成，体验跟 Mac 上几乎没差别。

另一个心得是别一上来就开全自动权限。Claude Code 能力很强，但偶尔也会理解错意图，改错文件。我一般前几次用都手动确认，观察它的操作模式，确认靠谱了再逐步放开。重要项目建议开 Git，每次它改完你都能 diff 看改动，不对就回滚。

后续扩展方面，Claude Code 支持 MCP（Model Context Protocol）服务器，可以接入外部工具和数据源。比如你可以接一个数据库 MCP，让它直接查表结构；或者接一个文档 MCP，让它读你的项目文档。这块我还在摸索，等玩明白了再单独写一篇。

最后分享一个小技巧：Claude Code 的会话是可以保存和恢复的。如果你在做一个复杂任务，中途要关机，可以用claude --continue恢复上次会话，不用从头解释背景。这个在长时间调试的时候特别有用。