【实践】Windows 安装Claude Code教程（WSL2 篇）

本教程将帮助你在 Windows 上通过 WSL2 安装 Claude Code，包含环境配置、安装步骤和 GLM 模型配置，预计耗时 30 分钟。

🎯 目标说明

完成本教程后，你将能够：

• ✅ 在 Windows 上安装并配置 WSL2 环境
• ✅ 在 WSL2 中安装 Node.js 和 Claude Code
• ✅ 配置智谱 GLM 模型作为后端
• ✅ 解决安装过程中的常见问题

为什么选择 WSL2 方案？

• 获得完整的 Linux 开发环境
• 与 Windows 文件系统无缝集成
• 更好的兼容性和性能
• 适合需要 Linux 工具链的开发场景

📋 环境准备

系统要求

• 操作系统：Windows 10 2004+ 或 Windows 11（64 位）
• 内存：至少 4GB（推荐 8GB+）
• 磁盘空间：至少 10GB（WSL2 + Ubuntu + 工具）

所需工具

前置账号

• 智谱开放平台账号（注册链接^[1]）
• GLM API Key（获取链接^[2]）

🚀 步骤详解

步骤 1：启用 WSL2 功能

以管理员身份运行 PowerShell（右键 → 以管理员身份运行）：

# 启用 WSL 功能dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart# 启用虚拟机平台dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

可以打开：启用或关闭windows功能，检查两个是否开启，如果Virtual Machine Platform没有，可以手动勾

重启电脑使更改生效。

步骤 2：安装 WSL2

推荐方式：从 GitHub 下载 MSI 安装包

wsl --install 命令下载速度较慢，建议直接下载离线安装包：

1. 访问 WSL2 GitHub 发布页：https://github.com/microsoft/WSL/releases^[3]
2. 下载最新版本的 MSI 安装包（如 wsl_2.6.3.0.x64.msi）
3. 双击运行安装包，按提示完成安装

验证安装：

# 查看 WSL 版本wsl --version

设置默认 WSL 版本为 2：

wsl --set-default-version2

步骤 3：安装 Ubuntu

查看可用的 Linux 发行版：

wsl --list--online

安装 Ubuntu 22.04 LTS（推荐）：

wsl --install-d Ubuntu-22.04

指定安装位置（可选）：

wsl --install-d Ubuntu-22.04--location C:\wsl

预期输出：

正在下载：Ubuntu 22.04 LTS正在安装：Ubuntu 22.04 LTS已成功安装分发。可以通过"wsl.exe -d Ubuntu-22.04"启动它正在启动 Ubuntu-22.04...

查看已安装的发行版：

wsl -l-v

预期输出：

  NAME            STATE           VERSION* Ubuntu-22.04    Running         2

步骤 4：配置 Ubuntu 环境

首次启动 Ubuntu（或者点击Ubuntu-22.04程序）：

wsl -d Ubuntu-22.04

设置 Ubuntu 用户名和密码：

Enter new UNIX username: [输入用户名，如 ubuntu]New password: [输入密码]Retype new password: [确认密码]

修改 apt 源为阿里云镜像（加速下载）：

# 备份原源sudocp /etc/apt/sources.list /etc/apt/sources.list.bak# 编辑源文件sudo vim /etc/apt/sources.list

删除全部内容（vim 命令：dG），然后添加以下内容：

deb https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiversedeb-src https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiversedeb https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiversedeb-src https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiversedeb https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiversedeb-src https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiversedeb https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiversedeb-src https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse

更新系统包：

sudo apt update && sudo apt upgrade -y

步骤 5：安装 Node.js

使用 NVM 安装（推荐，灵活管理多版本）：

# 下载并运行 nvm 安装脚本（官方脚本）curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash# 验证 nvm 安装nvm --versionnvm ls# 安装 npmsudo apt install npm# 安装 Node.js（最新稳定版）nvm install stable# 验证安装node --versionnpm --version

预期输出：

v0.39.7v25.8.111.11.0

步骤 6：安装 Claude Code

全局安装：

# 安装 Claude Codenpm install -g @anthropic-ai/claude-code# 验证安装claude --version

步骤 7：配置智谱 GLM 模型

创建并编辑 ~/.claude/settings.json：

mkdir -p ~/.claudevim ~/.claude/settings.json

添加以下配置：

{"env":{"ANTHROPIC_AUTH_TOKEN":"你的 GLM API Key","ANTHROPIC_BASE_URL":"https://open.bigmodel.cn/api/anthropic","API_TIMEOUT_MS":"3000000","CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC":1,"ANTHROPIC_DEFAULT_HAIKU_MODEL":"glm-4.5-air","ANTHROPIC_DEFAULT_SONNET_MODEL":"glm-4.7","ANTHROPIC_DEFAULT_OPUS_MODEL":"glm-4.7"}}

创建并编辑 ~/.claude.json：

vim ~/.claude.json

添加以下内容：

{"hasCompletedOnboarding":true}

获取 GLM API Key：

1. 访问 智谱开放平台^[4]
2. 注册/登录账号
3. 进入「API 密钥管理」
4. 创建新密钥，复制保存

注意事项：

• 将 你的 GLM API Key 替换为实际密钥
• 确保 JSON 格式正确（引号、逗号）
• 保存后重启终端

步骤 8：首次使用

启动 Claude Code：

# 进入项目目录cd ~/workspace/project/# 启动交互模式claude

测试对话：

你好，请介绍一下你自己

预期响应：

你好！我是 Claude Code，一个 AI 编程助手...

📚 参考资料

• WSL 官方文档^[5]
• WSL2 GitHub 发布页^[6]
• Claude Code 官方文档^[7]
• 智谱 GLM Coding Plan 文档^[8]
• Node.js 下载^[9]
• Ubuntu 下载^[10]

引用链接