在 T3 Code 里打开远程 localhost,页面究竟跑在哪
T3 Code v0.1.11 的远程浏览器与端口转发让本机能查看另一台机器的开发服务;分清流式画面、本机加载和转发端口,按实际链路验收。

Agent 在远程机器启动了开发服务器,笔记本里直接打开同一个 localhost:3000,通常会访问笔记本自己。T3 Code v0.1.11 为远程预览提供了不同路径:看宿主浏览器的流式画面、在桌面端本机加载远程页面,或者把远端端口转发到本机。先确认使用哪条路径,才能判断页面来自哪份代码。
本文于 2026 年 11 月 21 日核对 v0.1.11 正式版公告及该标签的远程访问说明。以下是按文档整理的操作与验收方法,没有在两台机器之间实测转发,也不提供延迟或兼容率结论。
地址写着 localhost,指的是哪台机器
T3 浏览器标签属于所选环境。Agent 在宿主机器操作浏览器时,localhost 指向宿主机器上的服务;网页客户端和其他设备通常接收宿主浏览器的流式画面。关闭查看设备并不等于关闭宿主上的 Agent 浏览器。
桌面端还有一条不同路径:你在桌面应用中自行打开另一个环境的标签时,页面在你的电脑加载,其中的 localhost、127.0.0.1 和 [::1] 请求仍会通过已有连接抵达宿主。宿主不可达时,它应显示连接错误,不会悄悄改为访问笔记本上的同号端口。网页客户端仍采用流式查看。
| 使用方式 | 页面或画面在哪里处理 | 适合的需求 |
|---|---|---|
| 查看宿主标签的流式画面 | 宿主浏览器运行,设备接收画面 | 与 Agent 看同一页面 |
| 桌面端自行打开远程环境标签 | 桌面设备加载,环回地址请求送到宿主 | 本机选择元素、截图、批注 |
| 桌面端端口转发 | 本机其他应用访问转发端口 | 用自己的浏览器、curl 等检查服务 |
“远程环境”也不等于“独立代码副本”。如果任务改到了另一份目录,转发正常仍可能看到旧页面。先按线程与 Worktree 的目录检查确认启动服务器的工作目录,再检查网络。
怎样让自己的浏览器访问远程开发服务
在桌面应用中,打开线程的 Servers 列表,使用对应服务的转发按钮;也可以在命令面板找 Forwarded ports,手动填写端口并停止已有转发。对远程服务器链接使用 ⌘-点击,Windows/Linux 用 Ctrl-点击,可转发后在外部浏览器打开。
转发优先保留远端的端口号。本机端口已被占用时,T3 会选择可用端口并显示出来。因此远端 3000 并不保证本机也是 3000,应复制界面给出的实际地址。
假设界面显示本机端口为 43127,可以在笔记本终端执行下面的检查;端口只是示例,请替换:
curl --fail-with-body --max-time 10 http://127.0.0.1:43127/
收到页面内容只验证 HTTP 路径。还要在真实浏览器里检查脚本、静态资源、热更新连接和项目实际使用的接口。前端页面里的 API 地址若另指向外部域名或其他端口,需要按它自己的链路检查;一个页面打开成功不能证明全部依赖可用。
这不是把服务发布到公网。文档说明转发只监听本机环回地址,停止转发或退出桌面应用后结束。但本机其他程序可以访问,浏览器里打开的网页也可能触达;macOS 和 Windows 的同机其他登录用户也能访问。不要据此把无认证的管理服务当作完全隔离。
页面打不开时,先在哪一段检查
先在宿主环境确认服务仍在运行、监听地址和端口正确,再回到桌面端核对转发。让 Agent 报告启动目录、启动命令、实际监听端口和首个错误,比反复刷新同一个地址有用。工作尚卡在初始化时,另查Preparing workspace 的检查顺序。
有几个边界容易误判:
- 桌面端这类远程标签忽略系统代理设置;仅能通过代理访问的主机或使用私有签发证书的 HTTPS 地址,可能无法加载。不要把这类失败直接归因于开发服务器。
- 文档特别覆盖的是环回地址;
/etc/hosts里映射到本机的其他名字仍可能访问本机,不能把自定义域名一概理解为远端。 - 在宿主关闭 Settings → Sharing & access → Preview tunnel 后,端口转发与移动端 Open on this device 不再可用,已开通道关闭;宿主浏览器的流式查看仍可工作。
- 手机上 Open on this device 让页面在手机原生浏览器视图里响应触摸,但仍访问宿主服务。iOS/iPadOS 使用替代地址,剪贴板、Service Worker 等要求安全页面的功能存在限制。
近期 Issue #39546涉及 IPv6 监听下的转发失败,Issue #39750涉及 T3 Connect 路径上的错误传递。前者在直接连接路径未复现后关闭,报告者使用的 T3 Connect 路径并未在该次检查中覆盖;后者补充了该路径的服务器记录,但未捕获客户端响应,且由 AI 代发。两者截至查阅均关闭,本文未复现,也没有据此确认修复进入哪个正式版。提问时请保留 T3 版本、两端系统、监听地址和错误原文,按日志脱敏方法移除连接令牌与私人地址。
怎样证明看到的是这次修改
在临时演示项目中加一处不会混淆的页面标记,例如 preview-check-20261121,由宿主启动服务。分别通过 T3 标签和外部浏览器的转发地址检查标记,再触发一次项目已有的交互,最后停止转发,确认外部浏览器不能继续建立新连接。恢复页面标记并保留检查结果。这是一份建议验收步骤,本文没有执行。
如果页面需要调用 Nbility,浏览器预览和模型 API 是两条链路:按接入基础检查服务地址与模型,把 API Key 留在服务端。能看到前端页面不等于模型调用已经成功。


