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 会话
- 选择发行版:在 Code 标签页开始新会话并打开环境选择器,已安装的 WSL 2 发行版显示在 WSL 分区,选一个
- 选择文件夹:会话从发行版的主目录开始,用文件夹选择器选项目文件夹。浏览发生在发行版内,使用
/home/you/project这样的 Linux 路径 - 信任文件夹:文件夹里的第一个会话会显示工作区信任对话框,信任是按发行版和文件夹授予的:在一个发行版里信任的文件夹,在另一个发行版或 Windows 上相同路径下不算受信
发行版里的第一个会话会因为 Claude 在其中做设置而稍慢。你也可以从普通文件夹选择器打开 \\wsl.localhost\... 文件夹,它会在该发行版内重新打开。最近使用的文件夹按发行版显示在选择器里,重新连接项目只需点一下。
WSL 会话里可用的功能
并行会话、side chat、可视化 diff 评审、分支和 PR 状态、worktree 都可用,由发行版里的 git 和工具链支撑;「在编辑器中打开」会通过 Remote - WSL 打开连接到该发行版的 VS Code。WSL 会话里暂不可用:集成终端、连接器和插件、会话分叉、文件浏览器面板、在输入框键入 @ 时的文件建议。
受管设备
在组织管理的设备上,WSL 会话可能不可用。如果会话启动失败并提示设备受管,那是由你的管理员控制的;管理员请参阅部署指南了解设置如何到达设备。