WSL2安装ClaudeCode全攻略
一、安装 WSL2必须1. 启用虚拟化BIOS/UEFI重启电脑进入 BIOS/UEFI开启Intel VT-x或AMD-V虚拟化。2. 启用 WSL 功能管理员 PowerShell# 启用 WSL dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 启用虚拟机平台WSL2 必需 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart重启电脑使设置生效。3. 安装 WSL2 与 Ubuntu以管理员身份打开 PowerShell一条一条复制执行# 设置 WSL2 为默认版本 wsl --set-default-version 2 # 安装 Ubuntu 24.04推荐 wsl --install -d Ubuntu-24.04等待自动安装完成会弹出 Ubuntu 窗口让你设置用户名英文小写如user密码自己记好输入不显示正常Ubuntu 24.04 已完美安装并初始化完成从输出可以看到✅ Ubuntu 24.04 下载 安装成功✅ 已创建 Linux 用户名zsy密码设置完成✅ 成功进入 WSL 终端zsylocalhost:/mnt/c/Users/32686$二、在 WSL 中安装 Claude Code1. 进入 WSLwsl2. 安装 Node.jsv22运行# 更新包列表 sudo apt update # 安装 Node.js 22 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs # 验证 node -v npm -v3. 安装 Claude Code运行# 全局安装 sudo npm install -g anthropic-ai/claude-code # 速度过慢的话改用国内镜像源重新安装复制执行 sudo npm install -g anthropic-ai/claude-code --registryhttps://registry.npmmirror.comClaude Code 已 100% 安装成功从输出可以看到✅changed 17 packages in 8s→ 安装过程完成且无任何报错✅ 仅耗时 8 秒国内镜像源的优势✅ 提示的2 packages are looking for funding是无关的 /npm 官方提示不影响任何功能验证 Claude Code 安装必做在当前 WSL 终端执行运行claude --version出现版本号即安装成功。4. 打开 WSL 终端执行启动命令运行claude成功启动会出现 Claude 图标 交互提示符此时输入任意编程指令如帮我写一个Python计算斐波那契数列的函数就能使用硅基流动的 Claude 模型了。三、安装 CC SwitchWindows 端1.下载CC Switch方法一下载v3.10.3推荐便携版记得回到Windows端# 下载便携版官网版 Invoke-WebRequest -Uri https://github.com/farion1231/cc-switch/releases/download/v3.10.3/CC-Switch-v3.10.3-Windows-Portable.zip -OutFile $env:USERPROFILE\Downloads\CC-Switch-Portable.zip # 下载便携版镜像版 Invoke-WebRequest -Uri https://ghproxy.com/https://github.com/farion1231/cc-switch/releases/download/v3.10.3/CC-Switch-v3.10.3-Windows-Portable.zip -OutFile $env:USERPROFILE\Downloads\CC-Switch-Portable.zip # 解压到桌面 Expand-Archive -Path $env:USERPROFILE\Downloads\CC-Switch-Portable.zip -DestinationPath $env:USERPROFILE\Desktop\CC-Switch方法二浏览器下载压缩包打开你的浏览器Edge/Chrome/360 等复制以下链接粘贴到地址栏按回车https://github.com/farion1231/cc-switch/releases/download/v3.10.3/CC-Switch-v3.10.3-Windows-Portable.zip2. 解压到桌面打开「此电脑」→ 「下载」文件夹找到刚下载的CC-Switch-v3.10.3-Windows-Portable.zip右键点击这个压缩包 → 选择「解压到」→ 目标位置选「桌面」并命名为CC-Switch方便查找解压完成后桌面会出现「CC-Switch」文件夹。3. 启动 CC Switch1双击打开桌面的「CC-Switch」文件夹2找到里面的CC Switch.exe图标是齿轮样式双击启动3若弹出「Windows 保护你的电脑」提示点击「更多信息」→ 点击「仍要运行」→ 即可正常打开。四、CC Switch 配置一键切换模型1. 打开 CC Switch左侧选择Claude Code。2. 点击Add Provider选择模型如 Claude、GLM、DeepSeek。3. 填入对应API Key保存。4. 点击激活重启 Claude Code 即可生效。