怎样安装WSL并使用claude_code

Submitted by admin on Thu, 02/19/2026 - 10:59

好在命令行里，用 “先临时安装，再导出导入” 的方法，把 Ubuntu 稳稳地装到 D 盘。这个方法最通用，也最保险。

🗺️ 操作概览

整个过程可以分为六步，核心就是使用 wsl --export 和 wsl --import 这两个命令来“搬家”-4-5。

📝 详细命令行安装步骤

准备工作： 请先打开 PowerShell 或 Windows Terminal，并确保是以 管理员身份 运行的。

  1. 在D盘创建专属文件夹
    首先，在D盘创建一个你喜欢的文件夹，用来存放Ubuntu的系统文件。以后所有数据都在这里，和C盘说拜拜。

    # 在 D 盘根目录创建一个名为 WSL 的文件夹，你可以自定义，比如 D:\UbuntuOnD
    mkdir D:\WSL
    # 进入这个文件夹（后续操作会用到）
    cd D:\WSL

  2. 临时安装Ubuntu（会装在C盘）
    执行下面这个最简单的命令，先安装一个Ubuntu。这一步会把它暂时装在C盘，没关系，我们下一步就把它移走-5。

    wsl --install -d Ubuntu

    注意：命令执行后，会提示你创建新的用户名和密码。请正常创建，因为后面导入到D盘后，这个用户信息还会在。安装完并创建好用户后，可以先退出Ubuntu（输入 exit 或直接关掉窗口）。
    ps:如果安装时进度条卡住
    wsl  --install -d Ubuntu --web-download

  3. 将Ubuntu导出为一个“压缩包”
    现在，我们把刚装好的Ubuntu系统打包成一个.tar文件，并存放到你D盘的文件夹里。这个包就是系统的完整备份-4-10。

    # 格式：wsl --export <系统名> <目标路径>
    wsl --export Ubuntu D:\WSL\ubuntu.tar

    命令执行后，去 D:\WSL 文件夹看看，应该能看到一个 ubuntu.tar 文件。

  4. 注销C盘的那个Ubuntu
    “压缩包”打好后，C盘的那个临时系统就没用了，我们用下面命令把它从WSL的列表中注销掉，以释放C盘空间-4-5。

    # 格式：wsl --unregister <系统名>
    wsl --unregister Ubuntu

    执行后，可以用 wsl -l -v 检查一下，应该就看不到Ubuntu了。

  5. 将“压缩包”导入到D盘（关键一步）
    这是最重要的一步。我们把刚才的“压缩包”解压，并正式安装到D盘的目标文件夹。这里的 --version 2 指定使用WSL2-3-8。

    # 格式：wsl --import <系统名> <安装路径> <压缩包路径> --version 2
    wsl --import Ubuntu D:\WSL D:\WSL\ubuntu.tar --version 2

    执行成功后，你再去 D:\WSL 文件夹里看，会发现多了一个 ext4.vhdx 的文件，这就是Ubuntu的虚拟硬盘文件，以后所有数据都存在这里。

  6. 启动并设置默认用户
    现在，让我们启动这个新家，并解决一个细节问题：通过导入方式安装的系统，默认会以root用户登录。我们需要把它改回你之前创建的那个普通用户-3-5。
    • 先以root身份启动一次，并确认你的用户名：

      wsl -d Ubuntu
      # 进入后，如果你是第一次启动，会直接是 root@... 的提示符。
      # 运行以下命令查看你之前在第二步创建的用户名（假设是 yourname）
      ls /home/
      # 你应该会看到一个和你用户名同名的文件夹。
      # 输入 exit 退出。

    • 将默认用户改回普通用户：
      在 PowerShell 中执行以下命令，把 yourname 替换成你自己的用户名。

      # 格式：<发行版名称> config --default-user <你的用户名>
      ubuntu config --default-user yourname

✅ 验证成果

再次启动Ubuntu：

wsl -d Ubuntu
# 或者直接输入 wsl

应该就会以你创建的那个普通用户身份登录了。至此，Ubuntu已经成功安装在D盘，以后使用不会再占用宝贵的C盘空间。

 

 

 

在Windows 10系统上使用Claude Code，核心思路是根据你的需求选择最合适的安装方式。官方文档和一些开发团队的实践指南都提供了详细的步骤，下面我为你梳理了两种主流且可靠的方法，你可以根据自己的情况选择。

🚀 方法一：使用官方推荐的原生安装（最简单，适合大多数用户）

这是Anthropic官方推荐给Windows用户的方式，它通过一个简单的命令就能完成安装，并且支持自动更新，非常省心-7。

  1. 打开PowerShell：按下键盘上的 Win 键，输入 "PowerShell"，右键点击它并选择 “以管理员身份运行”。
  2. 执行安装命令：在PowerShell窗口中，复制并粘贴以下命令，然后按回车执行-3-5-7：

    irm https://claude.ai/install.ps1 | iex

  3. 将Claude添加到PATH：安装程序有时可能不会自动将Claude所在路径添加到系统的环境变量中。为了确保你在任何位置都能直接使用claude命令，建议执行以下命令手动添加-3-5：

     

    $claudePath = "$env:USERPROFILE\.local\bin"
    [Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$claudePath", "User")

    命令执行后，请完全关闭并重新打开PowerShell窗口，这样改动才能生效。

⚙️ 方法二：通过WSL（适用于Linux的Windows子系统）安装（适合Linux开发者）

Claude Code本身是为Linux和macOS环境设计的终端工具，因此在WSL的Linux环境中运行它，是最原生、最稳定的体验。如果你日常有使用Linux的需求，或者需要调用一些Linux特有的工具，这个方法会很适合你-7-8。

  1. 安装WSL：以管理员身份打开PowerShell，执行以下命令即可安装带有默认Ubuntu发行版的WSL 2-8：

    wsl --install

    安装完成后，按提示重启电脑。

  2. sudo apt update && sudo apt upgrade -y
    curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
    sudo apt install -y nodejs

  3. 在WSL中安装Claude Code：继续在Linux终端中，使用npm进行全局安装-1-2-8：

    sudo npm install -g @anthropic-ai/claude-code

    如果在安装过程中遇到操作系统检测错误，可以尝试先设置npm的os选项为linux再安装-8：

    npm config set os linux
    npm install -g @anthropic-ai/claude-code

🔑 安装后的关键步骤：账号认证

无论你选择了哪种安装方式，首次在终端中输入claude命令启动时，都需要完成账号认证。你会看到一个链接，用浏览器打开它，登录你的Claude.ai账号（需要Pro或Max订阅）并授权即可-5-7-8。

如果你是第三方API服务商（如UModelverse）的用户，则不需要通过浏览器授权，而是需要通过配置文件来设置你的API密钥和基础URL-4-9：

  1. 在PowerShell中执行 notepad "$env:USERPROFILE\.claude\settings.json" 来创建并编辑配置文件。
  2. 将以下内容粘贴进去，并替换其中的密钥和URL（如有需要）-4-9：

    json

     

    {
    "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "你的API服务地址",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
    }
    }

✨ 开始使用Claude Code

完成认证后，就可以在你的项目里使用它了。

  1. 进入项目目录：使用cd命令导航到你想要操作的代码项目文件夹。
  2. 启动交互式会话：输入以下命令并回车-1-6：
  3. 开始提问：现在，你可以直接用自然语言与Claude Code对话了。例如-1：
    • 理解代码：“简要介绍一下这个项目的整体结构和核心功能”
    • 生成代码：“帮我用React写一个带计数功能的按钮组件”
    • 调试问题：“我遇到了这个错误：[粘贴错误信息]，帮我分析一下原因”

❓ 常见问题速览

问题
可能原因与解决办法

claude 命令未找到
PATH未设置-3-5：检查是否执行了方法一中的PATH添加命令，并完全重启了终端。

原生安装失败
网络或系统问题-5：可以尝试通过npm安装作为备选方案：npm install -g @anthropic-ai/claude-code。

认证失败
网络或账号问题-8：Claude服务可能需要稳定的网络连接。请确保你的Claude.ai账号有有效的Pro/Max订阅-5-7。

WSL安装时npm报错
使用了Windows的npm-8：在WSL中，确保你运行的是Linux版本的npm。可以尝试npm config set os linux后重新安装。

你是想用Claude Code来探索一个现有的项目，还是准备开始一个新项目呢？如果你能告诉我具体的使用场景，我可以给你一些更实用的提示词建议。