PuppyIP 资源中心
AI 编程工具 8 分钟 发布于 2026-10-02 更新于 2026-11-05

VS Code 远程代理 localhost 预览:启用远端代理并核对主机

要预览远程 Agent Host 上运行的应用,启用浏览器远端代理并打开原始 localhost 地址;客户端和主机都支持时,地址栏会显示远程主机。

VS Code Agent Host 多目录会话 远程代理 Git worktree

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • VS Code 1.145 Stable 的日期为 2026 年 11 月 4 日;集成浏览器远程连接仍标为 Preview,Stable 版本不代表该功能已普遍可用。
  • 启用 workbench.browser.enableRemoteProxy,保留 workbench.browser.dataStorage 为 default,再打开远端应用的原始 localhost URL;无需先转发端口。
  • 远程 Agent Host 浏览器连接支持 SSH、dev tunnels、WSL 和 Dev Containers;客户端和主机都须支持。Cloud sandboxes 和其他非 VS Code agent hosts 不支持。
  • 远程 default 存储按项目目录和主机隔离,包括关联的 worktree;代理打开的页面默认按 chat 使用单独的内存存储。global 存储始终走本地网络。
  • 浏览器标签页固定在原主机;断线时不会退回本地网络,重连后需重新加载。Share with Agent 是单独的页面交互授权。

启用浏览器代理并打开原始 localhost 地址

在远程 Agent Host 会话中启动应用,然后在用户设置中将 workbench.browser.enableRemoteProxy 设为 true,让 workbench.browser.dataStorage 保持 default。在 VS Code 集成浏览器中打开应用原始的远端地址,例如 http://localhost:3000;远端代理会经主机网络访问页面,无需先把该端口转发到本机。

检查地址栏中的远程指示是否标明预期主机。启用代理只改变浏览器的网络路径;如果希望代理与页面交互,还要在浏览器工具栏选择 Share with Agent 并单独确认。

核对主机支持、存储范围和断线行为

远端 Agent Host 浏览器代理支持 SSH、dev tunnels、WSL 和 Dev Containers。客户端与远端主机都需要支持该功能;Cloud sandboxes 和其他非 VS Code agent hosts 不受支持。若指示显示主机不支持,官方建议将两端更新到当前 VS Code;这不构成对地区、套餐或组织资格的保证。

default 在远程浏览时使用 workspace 存储:cookies 和 localStorage 按项目目录与主机隔离,关联 worktree 共用该项目范围;代理自行打开的页面默认按 chat 使用互相隔离的内存存储。global 标签页始终使用本地网络,不会通过远端代理。在不受信任的工作区中,无论该设置为何值,浏览器始终使用临时存储。

每个标签页保留创建时的主机。切换当前会话不会迁移已有标签页;代理打开的页面也绑定到发起它的主机,即使另一个会话处于活动状态。主机断开时,标签页不会回退到本地网络。重新连接原主机并重新加载页面后才能继续访问;关闭远端代理只会让之后新开的标签页走本地网络。

1.145 是 Stable 版本,远端浏览器连接仍为 Preview

VS Code 1.145 发布说明将该版本标为 Stable,日期为 2026-11-04;同一轮官方说明明确指出,集成浏览器远程连接仍处于 Preview,正式普遍可用前可能变化。版本 Stable 与单项功能 Preview 可以同时成立。

VS Code 1.140 Stable 于 2026-09-30 发布;GitHub 10 月 1 日的月度汇总涵盖 9 月多个版本,不等于这些功能当天才上线。1.140 将多目录会话、远程委派和共享工作树文件夹标为 Experimental;这是历史状态,不是 1.145 新功能,也不证明当前账号或主机可用。

按 harness 配置多目录会话;旧设置需先核对版本

1.140 时代的配置按 harness 区分:Copilot 使用 chat.agentHost.copilotAgent.multiRootEnabled,Claude 使用 chat.agentHost.claudeAgent.multiRootEnabled,Codex 使用 chat.agentHost.codexAgent.multiRootEnabled。当时这些实验设置默认关闭,也不显示在 Settings editor;新会话读取设置,无需重启 Agent Host。

如果使用比 1.140 更新的版本,先在当前 agent harness 文档中核对这些 multiRootEnabled 键及其适用入口。多目录 Agent 会话不同于普通编辑器多根工作区;VS Code Agent Host Codex、OpenAI Codex 扩展和 Codex 桌面应用也是不同入口。

逐个确认 chat 使用的目录和共享状态

1.140 的操作说明没有专门的目录添加或 peer chat 路径选择界面,建议在请求中写明仓库或工作树;界面可能已变化,以当前版本为准。每个 chat 可以使用自己的目录,但指向同一目录的 chat 会共享终端、tasks、changes、pull request 和 Agent merge 状态。

允许写入前,悬停会话查看目录汇总,再悬停嵌套 chat 查看它自己的目录;先让代理只报告主机、目录、仓库、分支和预期文件。需要并行修改同一仓库时,明确指定不同工作树;创建两个 chat 本身不会隔离变更。

远程委派需要已连接主机和现有仓库目录

1.140 的远程委派配置使用 chat.remoteAgentHostsEnabled 和 chat.remoteSessions.tools.enabled,并要求先连接目标主机;较新版本的具体入口以当前官方说明为准。仓库工作需指定该主机上的现有受信任目录,或为它创建 Git worktree;远程会话不会自动克隆或复制协调会话的仓库,未指定目录的会话没有仓库。

可用 list_agent_hosts 查看主机;用 get_remote_session 检查状态,并让远端通过 send_remote_message 回报,因为最终答复不会自动转回主聊天。核对主机和目录后再允许修改。

工作树分隔代码改动,不等于权限隔离

Agent-harness 文档说明,新工作树从选定基准分支的已提交状态开始,默认不带入原 checkout 的未提交 tracked 改动、untracked 文件或 ignored 内容。若任务依赖这些内容,先确认如何安全提供;不要假设 .env、依赖或构建输出已复制。

1.140 的工作树说明区分复制与链接:git.worktreeIncludeFiles 复制选定 ignored 文件,实验性的 git.worktreeSymlinkFolders 按 patterns 链接匹配的 ignored 文件夹。符号链接不是副本,通过链接写入会影响原 checkout;需要独立可写依赖或缓存时不要共享。

1.140 时期所引用的通用 harness 指南把 Worktree 会话描述为 Allow all,Folder 会话审批依 harness 而异;具体权限以当前会话显示为准。工作树不限制命令、网络或文件系统;系统级限制需查看 sandbox 配置。只有实际遇到代理连接、407 或证书链错误时再排查网络层;网络出口不能开启实验设置或创建远程目录。

资料来源

常见问题

这个预览会把 localhost 应用发布到公网吗?

这项功能本身不创建公网部署或公开 URL。它让集成浏览器借助已连接的远程主机访问应用;应用是否另外可公开访问,取决于应用原有的配置。

在代理标签页输入 file:// 地址,会通过远程主机读取文件吗?

不会。file:// URL 不通过远端代理;在启用了代理的标签页打开这类地址,指示会变成警告。这不等于集成浏览器完全不支持文件 URL;远程应用预览应使用它的 http 或 https 地址。