大家好，我是 immerse，一位独立开发者兼内容创作者。
• 欢迎关注我的公众号：#沉浸式趣谈，获取最新文章（更多独家内容仅在公众号发布）
• 个人网站：
https://yaolifeng.com
，同步更新技术文章
• 转载请务必在文首注明作者出处及版权信息
在这里，我会持续分享关于
编程
、
独立开发
、
AI技术
、
出海项目
以及
个人成长思考
等方面的内容。
如果你觉得这篇文章对你有帮助，欢迎点赞、评论、转发一键三连！你的支持是我持续创作的动力，非常感谢！
前提准备：配置 WSL2 环境
若想在 Windows 上顺利运行 Claude Code，首先需要完成 WSL2（Windows Subsystem for Linux）的安装与配置。
安装流程
-
启用系统功能
• 在搜索栏输入：启用或关闭 Windows 功能
• 勾选以下两项：虚拟机平台
（Virtual machine platform）、适用于 Linux 的 Windows 子系统
• 根据提示重启计算机 -
配置 WSL，打开 PowerShell 执行以下命令```javascript
将 WSL 默认版本设为 2
wsl --set-default-version 2
开始安装 WSL
wsl --install
若已安装 Ubuntu，建议更新 WSL（添加 --web-download 可避免因网络问题导致的下载失败）
wsl --update --web-download
3. 等待安装完成 • 耐心等待进度条走完，即表示 WSL 安装成功 <ol start="4"><li>搜索并启动 Ubuntu<br> 打开应用后进入终端，依次执行：```javascript<h1>安装 NVM（Node Version Manager）</h1><p>curl -o- <a href="https://www.php.cn/link/a92de86fbd1ad5ecc06de4a595978a81">https://www.php.cn/link/a92de86fbd1ad5ecc06de4a595978a81</a> | bash</p></li></ol><h1>重新加载 bash 配置文件</h1><p>source ~/.bashrc</p><h1>安装最新版 Node.js LTS 版本</h1><p>nvm install --lts nvm use --lts</p><h1>验证是否安装成功</h1><p>node --version # 应显示类似 v22.x.x npm --version # 应显示类似 10.x.x</p>
- 全局安装 Claude Code
• 安装过程中我尝试开启代理，但频繁报错。强烈建议关闭代理后再安装javascript npm install -g @anthropic-ai/claude-code</li></ol><h1>安装完成后验证版本</h1><p>claude --version</p><pre class="brush:php;toolbar:false;"><code> 6. 配置 API 密钥和基础地址
javascript编辑 .bashrc 文件
nano ~/.bashrc
添加以下环境变量（请替换为你的实际 Token）
export ANTHROPIC_AUTH_TOKEN=sk-... export ANTHROPIC_BASE_URL=https://www.php.cn/link/1dcad8cc5b82a7ef72f72716b220cf13
保存后重新加载配置
source ~/.bashrc
- 启动使用 Claude Code
• 直接输入命令：claude
并回车即可开始使用
alt textalt text
常见问题与避坑指南
- 安装时可能出现如下错误：```javascript
npm WARN using --force Recommended protections disabled.
npm WARN cleanup Failed to remove some directories [
npm WARN cleanup [
npm WARN cleanup 'C:\Users\
\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code', npm WARN cleanup [Error: EPERM: operation not permitted, rmdir 'C:\Users\ \AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\vendor\sdk\src\internal'] { npm WARN cleanup errno: -4048, npm WARN cleanup code: 'EPERM', npm WARN cleanup syscall: 'rmdir', npm WARN cleanup path: 'C:\Users\ \AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\vendor\sdk\src\internal' npm WARN cleanup } npm WARN cleanup ] npm WARN cleanup ] npm ERR! code 1 npm ERR! path C:\Users\ \AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code npm ERR! command failed npm ERR! command C:\WINDOWS\system32\cmd.exe /d /s /c node scripts/preinstall.js npm ERR! Error: Claude Code is not supported on Windows. npm ERR! Claude Code requires macOS or Linux to run properly. npm ERR! If you are using WSL (Windows Subsystem for Linux): npm ERR! 1. Make sure you are running npm install from within the WSL terminal, not from PowerShell or CMD npm ERR! 2. If you're still seeing this message in WSL, your environment may be incorrectly reporting as Windows npm ERR! Please visit https://www.php.cn/link/c5e04ccb6be7fab8ccb9df005a075cc2 for troubleshooting information. </li></ol><p><strong>解决方案</strong>：务必在 WSL 的 Ubuntu 终端内执行安装命令，不要在 Windows 的 CMD 或 PowerShell 中操作。使用 NVM 管理 Node 版本也能有效减少依赖冲突。</p><ol start="2"><li>若 C 盘空间不足，可将 WSL 系统迁移到其他磁盘。具体操作可参考教程：<a href="https://www.bilibili.com/video/BV1mpMizQEUS">Claude Code 在 Windows 系统中安装全流程教学[1]</a></li></ol><h5>参考链接</h5><p><code>[1]</code> Claude Code 在 Windows 系统中安装全流程教学: <em><a href="https://www.bilibili.com/video/BV1mpMizQEUS">https://www.bilibili.com/video/BV1mpMizQEUS</a></em></p>
- 启动使用 Claude Code
