SSH 下的功能支持

当您Warp 化 SSH 会话时，Warp 的核心终端功能——输入编辑器、自动补全、代码块、历史搜索等——与本地工作方式相同。在远程主机上安装 Warp 的 SSH 扩展后，额外的编码功能，如文件树、原生文件读取和原生代码差异，也可在 macOS 和 Linux 上通过 SSH 工作。

本页根据您所处的路径说明了哪些功能可用

• SSH 扩展 - 首次连接时选择 安装 Warp 的 SSH 扩展 后安装。适用于 macOS 和 Linux 远程主机。
• 旧版基于 tmux 的 Warp 化 - 一种正在被弃用的旧替代方案。目前仍适用于尚未提供 SSH 扩展的客户端（例如 Windows 客户端）。请参阅 旧版：基于 tmux 的 Warp 化。

注意

当当前路径上没有原生工具时，Agent 会回退到终端命令（例如 cat、sed、grep）。您仍然可以完成大多数编码任务，但体验不如本地或通过 SSH 扩展工作那么无缝。

通过 SSH 可用的功能

以下功能在两种路径的 Warp 化远程会话中均可使用

• Agent 模式对话 — 在远程主机上与 Agent 聊天、提问并请求代码更改。
• 运行 shell 命令 — Agent 可以代表您在远程机器上执行命令。
• Grep 和文件通配 — Agent 可以使用基于终端的 grep 和 glob 工具搜索文件和模式。
• MCP 工具 — 模型上下文协议集成仍然可用。
• 终端功能 — 输入编辑器、命令补全、自动建议、命令历史记录、代码块以及所有其他核心终端功能均按预期工作。

以下功能需要 SSH 扩展

• 文件树（项目浏览器） — [文件树侧边栏](/code/code-editor/file-tree/)反映远程项目结构，并随您的导航或文件更改而更新。
• 原生文件读取 — Agent 通过 Warp 的内置文件读取工具读取远程文件，而不是调用 cat。
• 原生代码差异 — Agent 将编辑作为内联 代码差异应用，您可以查看并批准，而不是使用 sed 或其他 shell 命令。
• 可靠的并行补全 — 生成器通过单个多路复用连接并行运行，因此补全不再触及远程主机的 MaxSessions 上限，并停止偶尔向您的代码块注入错误。

通过 SSH 尚不可用的功能

以下功能需要本地文件系统访问，并且在两种路径的 Warp 化远程 (SSH) 会话中尚不可用

• 代码编辑器（文件打开/编辑 UI） — Warp 的原生代码编辑器尚未在远程会话中提供。您无法在 Warp 的内置编辑器中打开、查看或编辑远程文件。
• 计算机使用 — Agent 无法截屏或与远程机器的桌面交互。

注意

WSL 会话具有与 SSH 相同的限制，目前不被 SSH 扩展支持。WSL 支持的功能请求：GitHub #6744。 ::