Windows WSL2 方案（Claude Code）
如果你想在 Windows 上使用 Linux 终端环境，或希望换一种方式安装 Claude Code，可以使用 WSL2 + Ubuntu 方案。
适用场景：你希望在 Windows 上获得更接近 Linux 的使用环境，或希望把 Claude Code 放在 Ubuntu 环境里安装与使用。这一页提供的是完整的 WSL2 路线。
你会用到的官方页面
开始前先确认
系统
建议 Windows 11，或已开启虚拟化能力的 Windows 10。
管理员 PowerShell
安装 WSL2 时，建议以管理员身份打开 PowerShell。
Claude Code Key
请先到 Key 管理 创建 Claude Code Key。后面的命令里会用到 你的Claude_API_KEY。
第一步：安装 WSL2
# 1) 以管理员身份打开 PowerShell
wsl --install -d Ubuntu
# 2) 安装完成后重启电脑
# 3) 打开 Ubuntu，第一次设置 Linux 用户名和密码如果 wsl --install 不可用，请改看微软官方旧版系统手动安装文档。
第二步：在 Ubuntu 里准备环境
下面所有命令都在 Ubuntu 终端里执行，不是在 Windows PowerShell 里执行。
sudo apt update
sudo apt install -y curl git build-essential第三步：安装 Node.js 18+
推荐使用 nvm 安装，后续升级更方便。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 18
nvm use 18
node -v
npm -v第四步：安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code@latest
claude -v如果你只想先确认是否安装成功，执行 claude -v 即可。
第五步：写入积木AI的 Claude Code 配置
把下面命令里的 你的Claude_API_KEY 替换成你在 Key 管理里创建的真实 Claude Code Key。
curl -fsSL https://code.jimuxyz.com/env_deploy/claude-deploy.sh | bash -s -- "你的Claude_API_KEY"执行后会自动把环境变量写入 ~/.zshrc 或 ~/.bashrc。
第六步：开始使用
# 进入你的项目目录（可选）
cd your-project
# 启动 Claude Code
claude如果只是想继续看 Linux 常规说明，也可以直接进入 macOS / Linux Claude Code 使用说明。
如果遇到问题
wsl --install不可用：看微软官方旧版系统手动安装文档。node -v不是 18+：重新执行nvm install 18和nvm use 18。- 配置后仍不是积木AI：重新执行一次
claude-deploy.sh，并确认你替换的 Key 是真实值。 - 如果只是想看 Claude Code 在 Linux 环境里的常规说明，也可以直接进入 macOS / Linux Claude Code 使用说明。