跳到正文
FunCoding

搜索

搜索文档、智能体、博客、Skill 和 MCP

WSL 里的桌面版

在 Windows 上让桌面版 Code 标签页的会话在 WSL 2 发行版里运行:要求、启动步骤、可用功能与受管设备限制。

在 Windows 上,Code 标签页可以在 WSL 2 发行版内运行会话,而不是在 Windows 本身。会话的 Claude Code 进程、工具和 git 都在发行版内执行,使用它的 Linux 工具链和原生 Linux 路径,也就是项目所面向的环境。当你的仓库存放在发行版的文件系统里时用 WSL 会话:从 Windows 操作这些文件要经过网络文件系统,既慢又会破坏文件监听;在发行版内运行会话两者都能避免。

要求

  • 带 WSL 2 的 Windows 10 或 11(不支持 WSL 1)
  • 至少安装了一个发行版(如 Ubuntu)
  • 发行版内安装了 git

启动 WSL 会话

  1. 选择发行版:在 Code 标签页开始新会话并打开环境选择器,已安装的 WSL 2 发行版显示在 WSL 分区,选一个
  2. 选择文件夹:会话从发行版的主目录开始,用文件夹选择器选项目文件夹。浏览发生在发行版内,使用 /home/you/project 这样的 Linux 路径
  3. 信任文件夹:文件夹里的第一个会话会显示工作区信任对话框,信任是按发行版和文件夹授予的:在一个发行版里信任的文件夹,在另一个发行版或 Windows 上相同路径下不算受信

发行版里的第一个会话会因为 Claude 在其中做设置而稍慢。你也可以从普通文件夹选择器打开 \\wsl.localhost\... 文件夹,它会在该发行版内重新打开。最近使用的文件夹按发行版显示在选择器里,重新连接项目只需点一下。

WSL 会话里可用的功能

并行会话、side chat、可视化 diff 评审、分支和 PR 状态、worktree 都可用,由发行版里的 git 和工具链支撑;「在编辑器中打开」会通过 Remote - WSL 打开连接到该发行版的 VS Code。WSL 会话里暂不可用:集成终端、连接器和插件、会话分叉、文件浏览器面板、在输入框键入 @ 时的文件建议。

受管设备

在组织管理的设备上,WSL 会话可能不可用。如果会话启动失败并提示设备受管,那是由你的管理员控制的;管理员请参阅部署指南了解设置如何到达设备。