Claude Code 桌面版在 Linux 与 WSL 上的已知限制
在 Linux 或 WSL 里用桌面版的 Code 标签页，最容易浪费时间的一类问题是：某个东西没出现，你先怀疑自己装错了，翻了半天配置，最后发现官方文档早就写了「这个平台上还没有」。
这些限制不集中在一页里。桌面版的总参考在 code.claude.com/docs/en/desktop，Linux 版单独一页 code.claude.com/docs/en/desktop-linux，WSL 会话又单独一页 code.claude.com/docs/en/desktop-wsl。三页各管一段，交叉的地方还需要自己对着读。本文只讲这两个平台上的能力边界，不讲怎么把它装上——安装本身站内另有一篇专门讲。
下面按排查的顺序走，每种现象都给出可执行的判定动作，以及最后一步：什么情况说明根本不是这个原因。
现象一：WSL 会话里 @ 引不出文件，也加不了 connector 和 plugin
怎么确认是这个问题。 先看你这个会话的环境是什么。官方文档写明，开始一个会话前要在提示区配置四项，其中一项是 Environment，可选 Local、Cloud、SSH connection，Windows 上还有 WSL distribution。如果你当初是在环境选择器的 WSL 分组里挑的分发，那这个会话就是 WSL 会话。
code.claude.com/docs/en/desktop-wsl 里有一句话专门列了 WSL 会话里还没有的东西：integrated terminal（集成终端）、connectors 与 plugins、session forking（会话分叉）、file browser pane（文件浏览面板），以及在输入框里打 @ 时的文件建议。
同一件事在总参考页里也能对上：@mention 那一节写明 @mention 在 cloud 与 WSL 会话中不可用；连接外部工具那一节写明提示框旁的 + 按钮在 cloud 与 WSL 会话中不可用，但 routines 会在创建时配置 connectors；plugins 那一节写明 plugins 在 WSL 会话中不可用。两页说的是同一批限制，措辞不同而已。
文档语义给出的处置。 这些是能力边界，不是配置错误，没有开关可开。文档给的替代路径只有一条明确的：connectors 可以通过 routines 在创建时配置。其余几项，文档没有写明在 WSL 会话里的替代做法。
处置后怎么验证。 把同一个项目在 Local 环境下新开一个会话，看这些能力是否出现。如果在 Local 会话里正常、在 WSL 会话里没有，那就是平台边界，到此为止，不用再查了。
什么情况说明不是这个原因。 如果本地会话里同样没有集成终端，那多半不是 WSL 的事：总参考页写明，pane 布局、终端、文件编辑器和视图模式这一节的内容需要 Claude Desktop v1.2581.0 或更高版本，并且集成终端仅在 local 会话中可用。另外，如果消失的是 side chat，那也不是 WSL 的锅——文档写明 side chats 在 local、SSH 与 WSL 会话中都可用。
现象二：WSL 会话直接起不来
怎么确认是这个问题。 按文档写明的前置条件逐条核对：Windows 10 或 11，且装的是 WSL 2（文档明写 WSL 1 不受支持）；至少装了一个分发；分发内部装了 git。这三条里任何一条不满足，都不是「桌面版有 bug」。
文档语义给出的处置。 前置条件缺哪条补哪条。还有一类完全不同的失败：文档在「Managed devices」一节写明，在受组织管理的设备上，WSL 会话可能不可用；如果会话启动失败并提示设备受管，那是管理员控制的，文档把处置指向了部署指南里「设置如何下发到设备」那一节，也就是说这一条要找管理员，不是你本地能改的。
处置后怎么验证。 重新在环境选择器的 WSL 分组里选分发起一个会话。文档还写明另一条等价入口：从常规文件夹选择器打开 \\wsl.localhost\... 下的文件夹，会话会在对应分发里重新打开。
什么情况说明不是这个原因。 如果 Local 会话也起不来，那就与 WSL 无关。总参考页的排查一节写明，Windows 上 Code 标签页启动本地会话需要 Git，看到 “Git is required” 要装 Git for Windows 并重启应用；另有 Failed to load session 一条，文档给的可能原因是选中的文件夹已不存在、仓库需要未安装的 Git LFS，或文件权限不足。这几条都跟 WSL 无关。
现象三：项目在 Windows 侧信任过了，进 WSL 又要再信任一次
怎么确认是这个问题。 看弹出的是不是工作区信任对话框。文档写明，某个文件夹的第一次会话会出现工作区信任对话框，而信任是按分发、按文件夹授予的：在一个分发里信任过的文件夹，在另一个分发里不算信任，在 Windows 上的同一路径也不算信任。
文档语义给出的处置。 就是在新的分发里再授一次信任，这是设计上的粒度，不是状态丢了。
处置后怎么验证。 文档写明，最近用过的文件夹会按分发出现在选择器里，重连项目只需一次点击。同一分发下再开会话不应再次要求信任。
什么情况说明不是这个原因。 如果同一分发、同一文件夹反复要求信任，那超出了这条规则能解释的范围，官方文档没有说明这种情况。
顺带一提「首次会有等待」这件事：文档自述，某个分发里的第一次会话会稍慢一些，因为 Claude 要先在分发里完成设置。这句是文档写的，我们没有做过实测，也不给任何时长上的说法。
现象四：Linux 上找不到 Computer Use、语音输入，Quick Entry 热键不响应
怎么确认是这个问题。 先确认你用的是 Linux 桌面应用——code.claude.com/docs/en/desktop-linux 页首标题就带 (beta)，并且页内有一条 Note 明写 Linux 对桌面应用的支持处于 beta。这一页末尾有个小节叫「What’s not in the Linux beta yet」，一共四条：
| 文档列出的项 | 文档写明的状态 |
|---|---|
| Computer Use | 应用与屏幕控制在 Linux 上不可用 |
| Dictation | Linux 桌面应用里没有语音输入，文档指向在 CLI 里用 voice dictation |
| Quick Entry 全局热键 | 在 X11 上可用；在原生 Wayland 上需要桌面环境的 GlobalShortcuts portal |
| Fedora 与 RHEL | 目前只支持基于 Debian 的发行版，文档写「对更多发行版的支持将在未来提供」 |
这张表值得单独抄一遍，是因为它是判断「该不该继续查」的直接依据：在这四条范围内的现象，查配置是白查。
文档语义给出的处置。 Computer Use 在 Linux 上没有替代方案的说明；总参考页在「What’s not available in Desktop」里也重复了一次「Linux (beta)：Computer Use 尚不可用」。语音输入的替代是 CLI。Quick Entry 在原生 Wayland 下的处置是你的桌面环境要提供 GlobalShortcuts portal。发行版这一条，文档给的兜底是：桌面应用里还没有的能力，CLI 跑的是同一个 Claude Code 引擎，并且支持更广的 Linux 发行版范围。
处置后怎么验证。 发行版与架构这两项有明确的判定命令，文档在排查一节给出：
dpkg --print-architecture
文档写明这条命令应该输出 amd64 或 arm64，仓库不为其它架构发布包；Requirements 一节写的是 Ubuntu 22.04 或更高、Debian 12 或更高，x86_64 或 arm64，并且明说其它满足条件的 Debian 系发行版可能能用，但未经官方测试。这句「未经官方测试」建议照原样理解，别当成「支持」。
什么情况说明不是这个原因。 如果你在 macOS 或 Windows 上也看不到 Computer Use，那就与 Linux beta 无关：文档另有一条 Note 写明，Computer Use 是 macOS 与 Windows 上的 research preview，需要 Pro 或 Max 套餐，Team 与 Enterprise 套餐上不可用，且桌面应用必须处于运行状态。这是套餐与形态的边界，跟发行版没关系。
现象五：Linux 上的桌面应用版本一直不变
怎么确认是这个问题。 这条是 Linux 独有的行为差异，文档写得很直白：桌面应用在 Linux 上不自更新，更新随系统的常规软件包更新到达。作为对照，总参考页在排查「启动后白屏或卡住」时写的是：macOS 与 Windows 上应用会在启动时自动更新，Linux 则通过 apt 更新。
文档语义给出的处置。 文档给出的命令是：
sudo apt update && sudo apt upgrade
并写明发行版的图形化软件更新器同样会拿到新版本。还有一种情况要留意：如果你当初是用直接下载的 .deb 且事先禁用了仓库注册，那么文档写明 apt 不会送来新版本，需要重新下载安装，或之后再注册仓库。
处置后怎么验证。 这里有个坑：总参考页排查一节里「Check your version」那一小节只写了两条路径——macOS 在菜单栏点 Claude 再点 About Claude，Windows 点 Help 再点 About（以上均为官方文档写明的路径），并写明点版本号可复制到剪贴板。Linux 上怎么在应用内查版本，这一节没有给出路径，官方文档没有说明这一点。所以在 Linux 上，可验证的口径只有包管理器那一侧。
什么情况说明不是这个原因。 如果你更新完仍然缺某个能力，先回到现象四那张表核对一遍：那四条不是版本落后，是 beta 尚未包含。
最后提醒两件事
第一，桌面版的登录方式与 CLI 不同。Linux 那一页写明，桌面端以 claude.ai 订阅或组织 SSO 登录，不直接接受 Claude Console 的 API key；需要用 API key 认证就用 CLI。这一条经常被误当成 Linux 的限制，其实是桌面形态的限制。
第二，这类平台差异属于迭代最快的部分。文档里今天写着「尚未提供」的条目，下一个版本可能就变了，反过来路径与命令也可能调整。上面每一条我都标了出处页，遇到与实际不符时以官方文档最新内容为准。
本文依据 Claude Code 官方文档（code.claude.com/docs）于 2026-08-17 的公开内容整理。
该产品闭源，本文只复述官方文档写明的机制，不推断其内部实现；
我们没有对文中涉及的功能做过实测，因此不涉及界面外观、操作手感与运行速度的任何描述。
该产品迭代频繁，文中涉及的命令、配置项与默认值随版本变动，请以官方文档最新内容为准。
本文不涉及价格、额度与限流的具体数值，相关信息请以官方定价与用量说明页为准。