T3 Code Windows 教程：用手机远程控制 Codex、Claude Code 与 OpenCode

T3 Code 把自己定义为“Agent harness control surface”：它不提供新的基础模型，而是控制已经安装并登录在你电脑上的 Codex、Claude Code、Cursor、Grok Build 和 OpenCode。

你可以使用本地 Web 页面、Electron 桌面客户端或手机界面查看和操控 Agent。它解决的是离开电脑后继续查看任务、回复问题和管理多个本地编码 Agent 的问题。 这也意味着 T3 Code 的权限上限取决于底层 CLI。如果 Codex 能修改整个工作区、Claude Code 能执行命令，那么远程控制界面同样可能触发这些能力。官方明确提示项目仍很早期，应预期 Bug，因此本文从本地试用开始，再讨论远程访问。

它与远程桌面、Pi Web 有什么区别

远程桌面传输整个 Windows 图形界面，T3 Code 只呈现 Agent 会话和相关控制，因此手机上更容易操作。 它也不是把模型搬到云端。Agent CLI、登录状态、仓库和命令仍在你的 Windows 电脑上运行。 与单一 Agent 的 Web 包装相比，T3 Code 的目标是统一控制多个 Provider，并提供 Web、桌面和移动入口。

适合的使用方式：

• 通勤途中查看长时间测试结果；
• 在手机上回答 Agent 的澄清问题；
• 同时管理几个独立仓库会话；
• 在局域网内从平板控制开发主机；
• 保留现有 Codex 或 Claude Code 订阅登录。 不适合把无人值守电脑直接开放到公网，也不应把它当作成熟的企业权限平台。

安装前先检查底层 Agent

T3 Code 至少需要一个已经安装并认证的 Provider。PowerShell 中逐项检查：

1
2
3
4

codex --version
claude --version
cursor-agent --version
opencode --version

只需要其中一个可用，不必全部安装。 Codex 登录：

1

codex login

Claude Code 登录：

1

claude auth login

Cursor CLI 登录：

1

cursor-agent login

OpenCode 登录：

1

opencode auth login

这些命令可能随各项目版本变化，以对应官方文档为准。完成登录后，先在普通终端打开一个测试仓库，确认 Agent 能启动并能读取文件。

路线一：用 npx 零安装试用

官方给出的最快入口是：

1

npx t3@latest

首次运行会下载 npm 包，启动 T3 Code 后端和本地 Web 应用。记录终端显示的本地地址和端口，不要根据旧教程假定一定是某个端口。 查看全部参数：

1

npx t3@latest --help

如果 npm 询问是否安装包，先核对包名确实是 t3，并确认来源来自官方项目。 保持终端运行，在同一电脑浏览器访问它输出的本地 URL。此时不要配置公网转发，先完成本地功能验证。 结束测试时在终端按 Ctrl+C。随后确认进程是否退出：

1

Get-Process | Where-Object { $_.ProcessName -match 't3|node' }

不要随意终止所有 Node 进程，因为其他开发服务也可能使用 Node。

路线二：安装 Windows 桌面版

官方支持通过 winget 安装：

1

winget install T3Tools.T3Code

安装后从开始菜单启动，或检查程序是否已注册：

1

winget list T3Tools.T3Code

升级：

1

winget upgrade T3Tools.T3Code

如果企业策略阻止 winget，可从官方 GitHub Releases 下载签名安装包。不要从第三方软件下载站获取重新打包的安装器。

桌面版仍然依赖本机已有 Provider。它不会替你自动完成 Codex 或 Claude Code 登录。

第一次连接测试仓库

新建一个不含敏感代码的目录：

1
2
3
4

$testRoot = 'C:\Work\t3code-demo'
New-Item -ItemType Directory -Path $testRoot -Force
Set-Location $testRoot
git init

创建少量示例文件后，从 T3 Code 选择这个目录并启动已登录的 Provider。 第一条任务应是只读的，例如：

1

列出仓库中的文件，说明每个文件用途，不要修改文件，也不要运行安装命令。

检查界面是否正确显示：

• Provider 名称；
• 当前工作目录；
• Agent 输出；
• 工具调用或审批；
• 会话停止按钮；
• 页面刷新后的会话状态。

通过后再让 Agent 修改一个测试文件，并用 Git 确认范围：

1
2

git status --short
git diff

Windows 身份与环境变量为何会不一致

从 PowerShell 启动 npx t3@latest 时，它通常继承当前终端的用户、PATH 和环境变量。桌面应用从开始菜单启动时，获得的环境可能不同。 典型症状是终端里能运行 codex，T3 Code 却提示找不到 Provider。 先检查命令位置：

1
2
3

Get-Command codex
Get-Command claude
$env:PATH -split ';'

重新登录 Windows 或重启桌面应用可以刷新安装后变化的用户级 PATH。 不要把 API Key 写进系统级环境变量来“解决一切”。T3 Code 的设计是复用 Provider 已有认证，优先修正 CLI 登录和程序可见性。

如果 T3 Code 以不同 Windows 用户运行，它也不会自动读取你当前账户下的认证文件。

本地 Web 与局域网访问

本地监听地址 127.0.0.1 只能从当前电脑访问，这是最安全的默认值。 若要从同一 Wi-Fi 的手机访问，需要确认 T3 Code 是否提供监听地址参数。先看：

1

npx t3@latest --help

只有官方参数明确支持时，才把监听地址改为局域网接口。随后查找电脑 IP：

1
2

Get-NetIPAddress -AddressFamily IPv4 |
  Where-Object { $_.IPAddress -notlike '169.254*' -and $_.IPAddress -ne '127.0.0.1' }

查看实际监听：

1
2
3

Get-NetTCPConnection -State Listen |
  Sort-Object LocalPort |
  Select-Object LocalAddress,LocalPort,OwningProcess

只为实际端口创建 Windows 防火墙规则，并将远程地址限制到家庭或办公网段。不要创建允许所有端口、所有网络配置文件的宽泛规则。 公共 Wi-Fi 上不要使用裸 HTTP 访问，因为会话内容和控制请求可能被同网段设备窃听。

更安全的远程访问方式

离开局域网后，优先使用组网 VPN，例如 Tailscale、WireGuard 或现有企业 VPN。这样 T3 Code 可以继续只对私有网络监听。 推荐关系是：

1

手机 -> 私有 VPN -> Windows 开发机 -> T3 Code -> 本地 Agent CLI

不推荐：

1

互联网 -> 路由器端口转发 -> 未认证的 T3 Code HTTP 端口

如果必须使用反向代理，至少要求 HTTPS、强认证、来源限制、WebSocket 支持和短会话。还要确认 T3 Code 自身的认证机制，不能只依赖一个难猜 URL。 Cloudflare Tunnel 可以隐藏源站地址，但公开 Tunnel 仍是公网入口。应结合 Access 身份验证，不要因为“不开放路由器端口”就认为没有风险。

手机端要验证哪些动作

首次手机连接不要立即执行真实开发任务。逐项测试：

1. 打开现有会话；
2. 查看长输出是否完整；
3. 回复普通文本；
4. 拒绝一次工具审批；
5. 停止正在运行的 Agent；
6. 切换到另一个仓库；
7. 手机锁屏后重新连接；
8. 断开 VPN 后确认不能访问。 尤其要测试“停止”是否真的终止底层进程。有些界面只是停止继续输出，命令可能仍在后台运行。 在 Windows 端检查相关进程：

1
2
3

Get-CimInstance Win32_Process |
  Where-Object { $_.Name -match 'codex|claude|node|t3' } |
  Select-Object ProcessId,Name,CommandLine

多 Provider 会话不要混淆工作区

T3 Code 能控制多个 Provider，并不代表它们共享相同上下文、权限或配置。 为每个会话明确记录：

• Provider；
• 仓库绝对路径；
• 当前分支；
• 是否允许写入；
• 是否允许执行命令；
• 任务目标；
• 验收命令。 远程操作前先要求 Agent回报：

1

只报告当前工作目录、Git 分支和未提交文件，不要修改任何内容。

如果目录或分支不对，停止会话，在电脑端修正后再继续。手机屏幕较小，更容易忽略路径提示。

订阅、API Key 与费用

官方说明 T3 Code 可以使用你在 Codex、Claude Code、Cursor、Grok Build 和 OpenCode 中已有的订阅或认证。

费用仍由对应 Provider 产生。T3 Code 只是控制面，不会把高额度任务变成免费任务。 需要分别检查：

• Provider 使用订阅登录还是 API Key；
• 并行会话是否增加消耗；
• 长时间后台任务是否仍在运行；
• 失败重试是否重复执行昂贵操作；
• 手机断线是否会自动停止任务。 不要把 Provider 的认证目录同步到公共云盘，也不要把 API Key粘贴到 T3 Code 聊天中。

项目仍处早期意味着什么

官方 README 明确写着“Expect bugs”，且暂时没有完整公共文档站。 实际使用时应假设：

• 升级可能改变会话格式；
• Web 与桌面版行为可能不一致；
• 某些 Provider 集成落后于 CLI 新版本；
• 远程重连可能丢失部分状态；
• 后台进程需要手动检查；
• 安全模型仍可能调整。

不要把唯一的开发环境和唯一会话历史建立在早期版本上。真实代码始终依靠 Git 保存，重要任务说明保存在 Issue 或仓库文档中。

T3 Code 故障按症状定位

npx t3@latest 下载失败

检查 npm Registry、代理和 Node 版本：

1
2
3

npm config get registry
node --version
npm cache verify

不要在未确认原因时关闭公司 TLS 检查或使用不可信镜像。

T3 Code 找不到 Codex 或 Claude

用同一 Windows 用户运行 Get-Command，重启桌面应用，确认 CLI 登录不是只存在于另一个用户或 WSL 中。

浏览器打开后空白

查看启动终端的第一条错误、浏览器控制台和端口占用。尝试无扩展浏览器窗口，以排除脚本拦截。

手机连接超时

确认手机与电脑网络可达、程序监听的不是 127.0.0.1、Windows 防火墙规则范围正确，VPN 路由已建立。

会话显示运行但没有输出

检查底层 Agent 是否在等待审批、登录过期或命令卡住。回到 Windows 端查看进程和启动日志。

仓库出现意外修改

立即停止 Agent，并保存证据：

1
2
3

git status --short
git diff --stat
git diff

不要用破坏性 Git 命令直接清空现场。先确认哪些文件是用户原有修改。

日常使用的安全习惯

• Windows 开发机启用磁盘加密和锁屏；
• 手机启用生物识别和远程擦除；
• T3 Code 仅监听本机或私有 VPN；
• 不直接开放公网端口；
• Agent 使用普通用户而不是管理员；
• 高风险命令保留人工审批；
• 每次远程任务先确认目录和分支；
• 定期升级 T3 Code 与底层 Provider；
• 离开电脑前保存 Git 状态；
• 发现设备丢失时撤销 VPN 和 Provider 会话。

是否值得安装

如果你经常运行持续十几分钟的 Codex 或 Claude Code 任务，T3 Code 的移动控制入口很有吸引力。最快的评估方式不是立即公网部署，而是在测试仓库运行 npx t3@latest，体验本地 Web、任务停止和会话恢复。

确认本地可靠后，再通过私有 VPN接入手机。只有当认证、权限、日志和断线行为都经过验证，才让它控制真实工作仓库。

T3 Code 资料入口

• T3 Code 官方仓库
• Codex 官方文档
• Claude Code 官方文档