paxzone先把话说在前头：Claude Code 这玩意儿在 Windows 上跑起来，跟 macOS 和 Linux 上的体验还是有差别的，不是功能少了，而是终端环境、快捷键体系、编码习惯都得顺着 Windows 的脾气来。你要是刚装完发现方向键乱跳、中文全是乱码、Ctrl+Space 直接被输入法抢走，别急着卸载，这大概率不是工具的问题，是环境没调顺。
这篇文章就把我在 Windows 上折腾 Claude Code 的完整记录整理出来，从安装、快捷键、常用命令到各种乱码和冲突的排查思路，全是有实操依据的东西。不管你是第一次装，还是已经用了一段时间想优化体验，都能从里面找到对应方案。
1. Windows 环境下的安装与启动准备
1.1 安装前置条件：Node.js 版本与系统环境
Claude Code 本质上是基于 Node.js 的 CLI 工具，所以第一步就是把 Node.js 装好。这里有个坑需要先说一下：很多 Windows 用户装了 Node.js 之后发现 claude 命令找不到，大概率是安装时没勾选自动加入 PATH，或者装的是非 LTS 版本导致后续出现兼容性问题。
我建议直接用 Node.js 官方 LTS 版本，目前实测下来 18.x 和 20.x 都没有问题。装完之后打开 PowerShell 或 CMD，输入以下命令确认环境：
bash复制node -v
npm -v
正常情况下会输出两个版本号。如果提示找不到命令，去系统环境变量里检查 PATH 是否包含了 Node.js 的安装目录（默认是 C:\Program Files\nodejs\）。顺带提一嘴，Windows 11 自带的 Terminal 体验比传统 CMD 好很多，推荐优先用 Windows Terminal 跑 Claude Code，后面说的快捷键和乱码问题在 Windows Terminal 里也更好处理。
1.2 两种安装路径：原生 Windows 与 WSL
Windows 上使用 Claude Code 有两条主流的路线，分别适合不同的使用习惯。
第一条路是直接在 Windows 原生环境安装。这种方式最简单，PowerShell 或 CMD 里跑一行命令就行：
bash复制npm install -g @anthropic-ai/claude-code
装完后直接用 claude 启动，适合大多数只需要在本地目录里快速写代码、做重构、跑测试的场景。缺点是某些依赖 Unix 工具的脚本和命令在原生 Windows 下可能会报错，比如 shell 脚本、文件权限模型、路径风格等。
第二条路是装 WSL（Windows Subsystem for Linux），在 Linux 子系统里运行 Claude Code。我个人的建议是：如果你的项目本身就是跑在 Docker、Linux 服务器或者涉及 shell 脚本比较多，直接上 WSL 会省掉很多兼容性问题。在 WSL 里安装的方式和 Linux 完全一样，但在 Windows 侧访问 WSL 里的文件时要注意路径转换，/mnt/c/ 前缀是绕不开的。
关于这两条路线，我在实际使用中的体会是：如果只是配合 VSCode 做常规开发，原生 Windows 完全够用；如果要做自动化部署脚本调试、或者经常要操作 Linux 命令，那 WSL 是更稳的选择。两条路线并不冲突，一台机器上同时装着也不会有问题。
1.3 首次启动与认证
安装完成后，在终端输入 claude，第一次启动会要求登录 Claude 账号。这一步需要注意：Windows 下如果浏览器没有自动跳转，会有两种情况，一种是安全软件拦截了本地回调端口，另一种是默认浏览器兼容性问题。
我遇到的情况是 Chrome 偶尔不自动跳转，手动复制终端里的 URL 到浏览器打开也能完成认证。认证成功后，Claude Code 会在本地生成配置文件，之后启动就不需要重复登录了。
另外有一个提升体验的小技巧，在系统环境变量里加上以下配置，可以让 Claude Code 的启动速度和稳定性都有明显改善：
bash复制# 设置终端编码为 UTF-8
setx CHCP 65001
# 增大 Node.js 内存限制
setx NODE_OPTIONS "--max-old-space-size=8192"
设置完记得重启终端。8GB 的内存上限对于大型项目来说基本够用，跑长任务的时候不容易中途崩溃。