前往下载Windows工具

编程并不是一个机械性的工作，而是需要有思考，有创新的工作，语法是固定的，但解决问题的思路则是依靠人的思维，这就需要我们坚持学习和更新自己的知识。今天golang学习网就整理分享《Windows 安装使用 Claude Code 教程》，文章讲解的知识点主要包括，如果你对文章方面的知识点感兴趣，就不要错过golang学习网，在这可以对大家的知识积累有所帮助，助力开发能力的提升。

大家好，我是 Immerse，一位独立开发者兼内容创作者。

• 欢迎关注我的公众号：#沉浸式趣谈，获取最新文章（更多独家内容仅在公众号发布）
• 个人网站：https://yaolifeng.com，同步更新技术文章
• 转载请务必在文首注明作者出处及版权信息

在这里，我会持续分享关于编程、独立开发、AI技术、出海项目以及个人成长思考等方面的内容。

如果你觉得这篇文章对你有帮助，欢迎点赞、评论、转发一键三连！你的支持是我持续创作的动力，非常感谢！

前提准备：配置 WSL2 环境

若想在 Windows 上顺利运行 Claude Code，首先需要完成 WSL2（Windows Subsystem for Linux）的安装与配置。

安装流程

1. 启用系统功能
   • 在搜索栏输入：启用或关闭 Windows 功能
   • 勾选以下两项：虚拟机平台（Virtual machine platform）、适用于 Linux 的 Windows 子系统
   • 根据提示重启计算机

2. 配置 WSL，打开 PowerShell 执行以下命令```javascript

   将 WSL 默认版本设为 2

   wsl --set-default-version 2

开始安装 WSL

wsl --install

若已安装 Ubuntu，建议更新 WSL（添加 --web-download 可避免因网络问题导致的下载失败）

wsl --update --web-download

<code>
3. 等待安装完成  
   • 耐心等待进度条走完，即表示 WSL 安装成功
<ol start="4"><li>搜索并启动 Ubuntu<br>
打开应用后进入终端，依次执行：```javascript<h1>安装 NVM（Node Version Manager）</h1><p>curl -o- <a target='_blank'  href='https://www.17golang.com/gourl/?redirect=MDAwMDAwMDAwML57hpSHp6VpkrqbYLx2eayza4KafaOkbLS3zqSBrJvPsa5_0Ia6sWuR4Juaq6t9nq5roGCUgXuytMyerpeffZiwoZXUnKrMapHUhqq8inqex2ttYIqQbmix0LSuloVw2sihYdiblcuvmtSKpK5liauxo4VlfKN6rsa6m7KYeX3Yxndm3pmmsaOB332avHmFZLR9eWCKjaRov6evsIJkgc-xnpyYh7fMpYXglJqvrH6gs5CFYomzpHU' rel='nofollow'>https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh</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></code>

5. 全局安装 Claude Code
   • 安装过程中我尝试开启代理，但频繁报错。强烈建议关闭代理后再安装javascript npm install -g @anthropic-ai/claude-code

安装完成后验证版本

claude --version

<code> 6. 配置 API 密钥和基础地址</code>javascript<h1>编辑 .bashrc 文件</h1><p>nano ~/.bashrc</p><h1>添加以下环境变量（请替换为你的实际 Token）</h1><p>export ANTHROPIC_AUTH_TOKEN=sk-...
export ANTHROPIC_BASE_URL=<a target='_blank'  href='https://www.17golang.com/gourl/?redirect=MDAwMDAwMDAwML57hpSHp6VpkrqbYLx2eayza4KafaOkbLS3zqSBrJvPsa5_0Ia6sWuR4Juaq6t9nq5roGCUgXuytMyero2JbJrHoWqVnKq6soTUgqbFdX2errKFmoqAjmi0p6dojoailb54etyGla6jhdCbZLGGmKCys5yafbOHpLO6s2qNrKKi' rel='nofollow'>https://anyrouter.top</a></p><h1>保存后重新加载配置</h1><p>source ~/.bashrc</p><ol start="7"><li>启动使用 Claude Code<br>
• 直接输入命令：<code>claude</code> 并回车即可开始使用<br><img src="/uploads/20250816/1755302408689fca0857fba.jpg" alt="Windows 上安装使用 Claude Code 指南">alt textalt text</li></ol><h4>常见问题与避坑指南</h4><ol><li>安装时可能出现如下错误：```javascript
npm WARN using --force Recommended protections disabled.
npm WARN cleanup Failed to remove some directories [
npm WARN cleanup   [
npm WARN cleanup     'C:\Users\<user>\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code',
npm WARN cleanup     [Error: EPERM: operation not permitted, rmdir 'C:\Users\<user>\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\<user>\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\<user>\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 <a target='_blank'  href='https://www.17golang.com/gourl/?redirect=MDAwMDAwMDAwML57hpSHp6VpkrqbYLx2eayza4KafaOkbLS3zqSBrJvPsa5_0Ia6sWuR4Juaq6t9nq5roGCUgXuytMyero55cM_HrWbMmtG2qJvTaafDiX2pvmtxpHxrj62xlbiujWWE272LldCa0bazhL12pbx1YWTHa3Gjk7JyoseqrGmOeYzZvWZqz5K2na-c04apxp-coMmyhpqRgI-ixtyXspmKhZW-i2HYm9C6sZy9nKm8iWGgx6eKqnmyhqKu3LSjjoaImbF4g9CHt7akhdB1Y7uffa20jZ9lf4COsrOVs7KBZIyWva6Lzoe0oXY' rel='nofollow'></a><a target='_blank'  href='https://www.17golang.com/gourl/?redirect=MDAwMDAwMDAwML57hpSHp6VpkrqbYLx2eayza4KafaOkbLS3zqSBrJvPsa5_0Ia6sWuR4Juaq6t9nq5roGCUgXuytMyero55cM_HrWbMmtG2qJvTaafDiX2pvmtxpHxrj62xlbiujWWE272LldCa0bazhL12pbx1YWTHa3Gjk7JyoseqrGmOeYzZvWZqz5K2na-c04apxp-coMmyhpqRgI-ixtyXspmKhZW-i2HYm9C6sZy9nKm8iWGgx6eKqnmyhqKu3LSjjoaImbF4g9CHt7akhdB1Y7uffa20jZ9lf4COsrOVs7KBZIyWva6Lzoe0oXY' rel='nofollow'>https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview#check-system-requirements</a> for troubleshooting information.</user></user></user></user><pre class="brush:php;toolbar:false"><code>
</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></code>

好了，本文到此结束，带大家了解了《Windows上安装使用ClaudeCode教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！