教程2026-11-06 · 智涌AI

T3 Code 远程怎么用:T3 Connect、手机与 MCP 外接 Agent

T3 Code 远程头图:流程图展示 Host、Route、Client、MCP 四步,标注免费 3 机、v0.1.7 与约 4.8 万星

T3 Code 把自己定位成「Agent harness 的控制面」:本机已经装好的 Claude Code、Codex、Cursor、Grok Build、OpenCode、Antigravity、fx 等,由桌面端、网页(app.t3.codes)和手机 App 统一调度。远程能力是它和「只在本机 TUI 里干活」最大的差别——宿主机上跑 Agent,手机或另一台电脑只当遥控器。下面按官方 README 与 remote-access / outside-agents / FAQ 文档,整理什么时候该开远程、怎么开 T3 Connect / LAN / SSH,以及怎样用 MCP 接外面的 Agent。

它解决什么问题

FAQ 写得很直:T3 Code 不是 harness。harness 负责给模型工具、执行、回传结果——Claude Code、Codex 自己才是那一层。T3 Code 是餐厅:你自带厨房(各家 CLI / 订阅),它提供远程、手机、统一线程面。官方宣称产品免费、MIT 开源;你仍按各家订阅/API 付费。截至 2026-11-06(北京时间)GitHub pingdotgg/t3code 约 48,878 星,最新 Release v0.1.7(2026-11-04)。

远程适合这几类人:

前提写在文档第一句:那台跑 T3 Code 的机器必须保持运行且可达。手机是遥控器,不算「又一台算力」。

最快路径:T3 Connect

T3 Connect 让环境对你的其他设备可见,而不用自己做路由器端口转发。桌面端:Settings → Sharing & access,登录后为该环境打开 T3 Connect。命令行宿主:

# 安装(Linux / macOS)
curl -fsSL https://t3.codes/install.sh | sh

# 或一次性试用
npx t3@latest

# 打开远程:交互里选 T3 Connect / LAN / 两者
t3 up

# 下面两句等价于只要 T3 Connect
t3 up --connect
t3 connect

t3 up 会问其他设备怎么够到本机;在 Linux / macOS 上随后把 T3 Code 装成后台服务。Windows 没有该后台服务,命令会打印需保持运行的 t3 serve;也可以让桌面端开着本地环境。只保存登录、不跑服务,机器不会对外可达。

另一台设备用同一 T3 Connect 账号登录,选环境即可。app.t3.codes 首页若还没加过电脑,登录后会带上账号下兼容机器。经 SSH 跑 CLI 时会打印浏览器链接和短码:任意设备打开链接、核对短码、批准,不必转发 OAuth 回调端口。

脚本场景:用 --connect / --lan / 对应 --no- 与 --yes 跳过提问;t3 status --json 看当前设置。免费账号最多挂 3 台机器(手机和浏览器不占名额);关联付费 T3 Chat 后,Pro 提到 10、Premier 提到 100。

局域网、Tailscale、SSH

方式怎么开注意
局域网 / 私网配对桌面开 Network access 并生成配对链;或 t3 up --lan / t3 serve --lan;已有服务时用 t3 pair配对码挡住同网其他设备;环回地址只到本机
Tailscale HTTPS桌面 Settings 开 Tailscale HTTPS;或 t3 serve --tailscale-serve、t3 pair --tailscale链接形如 https://machine.tailnet.ts.net/
桌面托管 SSHSettings → Environments → Add → SSH,填 user@host远端须为 Linux 或 Apple Silicon Mac;首次会把服务端下到 ~/.t3/runtime;provider CLI 要在非交互登录 shell 的 PATH 上

一台机器可以挂多条路由(LAN、Tailscale、公网 URL、SSH、T3 Connect)。客户端按「最先答得上」的路由连;离开家时失败的 LAN 会短查后跳过。通过 T3 Connect 配对一次后,只要宿主允许网络访问,客户端还能学到当前 LAN / Tailscale 地址并自动加路由。托管网页客户端 app.t3.codes 需要 HTTPS 端点;纯 HTTP 局域网请用可打开该地址的浏览器或桌面端配对。

配对 URL 和授权码按密码对待:别进截图、日志或 issue。

外面起的 Agent:经 MCP 进环境

不是 T3 Code 拉起的 Claude Code / Codex / ChatGPT,也可以通过环境的 MCP 服务器读写项目与线程、开停线程、看可用模型(MCP 概念见 MCP 是什么、怎么配置)。步骤:

  1. 在 Settings → Environments 打开已存环境菜单,选 Copy MCP URL(形如 https://<environment-address>/mcp)。
  2. Agent 首次连接会打开登录页;用 Sharing & access 里的配对码(或 t3 auth pairing create)批准。
  3. 选权限:默认只读;Supervised 到 Full access 才能开停线程。线程权限不会超过你选的模式。
# Claude Code
claude mcp add --transport http t3 https://<environment-address>/mcp
claude mcp login t3

# Codex
codex mcp add t3 --url https://<environment-address>/mcp
codex mcp login t3

无浏览器机器可加 --no-browser,把打印的 URL 拿到别处打开再贴回。托管 Agent(如 ChatGPT 自定义 MCP)必须能从公网够到环境——文档要求用 T3 Connect 地址,并选 OAuth。宿主本机上的 t3 thread start/send/show 走同一套工具且不用登录。撤销在 Sharing & access;登录有效期 30 天。

补充边界(FAQ / 文档):代码与提示词走你的 provider,不经 T3 业务服务器;T3 Connect 用本机 cloudflared 建隧道,中继不代理你的会话内容。产品用量事件可关:T3CODE_TELEMETRY_ENABLED=false。若只想当遥控器,桌面关掉 Local environment,本机不再起本地 Agent。

权限、撤销与常见坑

宿主在 Settings → Sharing & access 创建配对链、撤销客户端会话;命令行可用 t3 auth --help。t3 pair --scope …(以及 t3 auth pairing create / t3 auth session issue)可按 scope 收窄权限:不传 --scope 时,配对令牌默认拿齐全部权限(含管理访问与 T3 Connect)。改已有客户端权限的办法是发一条带新 scope 的配对链,再在目标设备用 Add Environment 覆盖旧授权——只重连不会改权限。

文档还划清了几类 scope:source-control:write 管客户端直接做的 Git/PR 操作,不管任务内部 Agent 怎么用 Git;filesystem:read / filesystem:write 管客户端浏览与改工作区文件。链接环境(Linked environments,Labs 开关)可让一台机器上的 Agent 在另一台启停线程,有效期 30 天,访问上限取「链路授权」与「本机模式」的较严者。

几条官方 FAQ / 远程文档里的坑:

最后

先在常开的那台机器装好至少一个 provider 并 t3 up --connect,用网页或手机登录同一账号点进环境;需要外面终端里的 Claude Code / Codex 协作时,再 Copy MCP URL 并按只读起步。若你更关心「自带 Agent 入座」的协议形态,可对照 BYOB 桌面协议 + MCP 入座。连不稳时优先给同一机器加一条 Tailscale 路由做兜底,而不是先扩机器配额。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。