共计 4612 个字符,预计需要花费 12 分钟才能阅读完成。

T3 Code 是一层控制面。它不是又一个编程 Agent。手机 App 和网页只负责发起、盯进度、点批准。真正跑命令的那台电脑必须开机,CLI 还得已经登录。
状态条(本机实操):作者的 Linux 测试机 · x86_64 · t3 v0.1.6 · 验证日 2026-11-02(Asia/Shanghai)· GitHub pingdotgg/t3code 写稿时 API 星标 37,914 · Release v0.1.6 发布于 2026-10-31 18:52(UTC+8)。本机 PATH 里没有 claude / codex,Providers 页两家都是 Not found,所以下文只验到控制面装通、默认权限与远程入口,没有编造一次真实 Agent 跑通。
它和几样容易混的东西差在哪
容易看成「又一个手机上的 Claude」。对照一下就不一样。
| T3 Code | Cindy 一类本机客户端 | Claude Code Remote Control | 官方网页云端会话 | |
|---|---|---|---|---|
| 模型/Agent 跑在哪 | 你已经装好的 CLI(Claude Code、Codex 等) | 客户端自己管会话 | 本机还活着的 Claude Code session | 云端临时工作站 |
| 手机角色 | 遥控器:发任务、批准 | 主要是电脑侧产品 | 接续本机 session | 浏览器里直接干活 |
| 电脑关机 | 全断 | 看客户端设计 | 断 | 通常还能继续 |
| 你还缺什么 | 本机 CLI + 远程路线 | 把客户端装上 | 官方 Remote Control 能力 | 愿意把项目丢上云 |
若你连 Agent 客户端都还没装上电脑,那是另一条线,可以先看站内 Cindy 那篇。这篇默认你已经有 CLI,缺的是手机入口和权限默认值。

验收:合上对照表,还能不能用一句话说清「谁在哪执行」。说不清就再看一眼表。
本机装通:钉死 0.1.6,再起本地 Web
官方安装脚本装到 ~/.local/bin,不强制 Node。想钉版本就带环境变量:
curl -fsSL https://t3.codes/install.sh | T3CODE_VERSION=0.1.6 sh
export PATH="$HOME/.local/bin:$PATH"
t3 --version
# 本机输出:t3 v0.1.6
装完后二进制实际落在 ~/.t3/runtime/versions/0.1.6/t3,~/.local/bin/t3 是软链。t3 --help 里能直接看到 serve、up、pair、service 这些子命令。
只在这台机器上看界面:
t3 serve --host 127.0.0.1 --no-browser
# 本机起在 127.0.0.1:3789,浏览器标题 T3 Code (Beta),HTTP 200
第一次用浏览器打开 http://127.0.0.1:3789/,会先卡在 Pair with this environment。这是正常的:本机服务在,但客户端会话还没授权。另开一个终端:
t3 pair
# 打印 QR、Pairing URL、Token(一次性,别当密码贴群里)
把 Token 贴进网页,或直接打开它打印的 /pair#token=… 链接,就能进主界面。本机配对链接里如果是 127.0.0.1,只有这台机器自己打得开。官方文档原话大意:loopback 地址只到达打开链接的那台设备。



验收:t3 --version 显示 0.1.6;浏览器能进 T3 Code 主界面;t3 status 能读到本机服务状态。
Provider 边界:控制面起来了,不等于 Agent 能跑
进 Settings → Providers。本机 2026-11-02 的实况:
- Claude:
Not found · Claude Agent CLI (claude) was not found on PATH. - Codex:
Not found · Could not start Codex CLI (codex). … Installing ChatGPT or Codex desktop may not add codex to PATH.
Sharing & access 页也写着版本 0.1.6 · http://127.0.0.1:3789/。
FAQ 原意:T3 Code 不是 harness,它要靠你本机的 Claude Code / Codex 等;手机只是 remote。CLI 没装、没登录,或装了但不在跑 server 那台机器的 PATH 上,Providers 就会空。Version manager 最爱干这事。
本机结论写死:控制面装通了;Agent 线程这台机器跑不动。 你自己的电脑上先 claude auth login 或 codex login,必要时在 Providers 里填 Binary path,再回来谈手机批准。

验收:Providers 页能打开;缺 CLI 时诚实显示 Not found,而不是假装已连接。
必做:把新线程默认权限从 Full access 改成 Supervised
装通之后别急着接手机。先改这个。
路径:Settings → Threads → New threads → Permissions。
本机打开时,下拉框默认就是 Full access。官方 permission-modes 写得很直:初始默认 Full access;现有线程和草稿里你手动选过的模式会自己留着。
四档对照(官方表意译):
| 模式 | 行为 |
|---|---|
| Supervised | 命令和改文件都要你批准 |
| Auto-accept edits | 改文件自动过;其它动作仍可能要批准 |
| Auto | 交给 Provider 的自动审阅;没有等价能力的 Provider 会退回询问 |
| Full access | 命令和编辑都不弹批准 |
远程场景我只推荐先选 Supervised。你人在地铁上点一下「新建线程」,默认要是 Full access,等于把本机 shell 交给一段你还没看清的指令。项目级设置可以覆盖环境默认;改默认只影响之后新建的线程。


验收:同一路径下能把 New threads → Permissions 改成 Supervised;截图或口述能指出改前是 Full access。
远程三条路怎么选
电脑开着。人在外面。路线其实就这几条:
T3 Connect(省事,带账号推送感)
主机跑t3 up或t3 up --connect(等同t3 connect)。按提示登录 T3 账号。Linux / macOS 还会帮你装后台 service。另一台设备用同一账号选这台 environment。FAQ:T3 Connect 目前免费;每账号最多 3 台跑 T3 Code 的机器,手机和浏览器不计。局域网或 Tailscale 直连(自建路,不经过 T3 Connect)
t3 up --lan,或已在跑的服务上t3 serve --lan/t3 pair。文档写明:开启后会接受来自局域网和 tailnet 的连接,配对码是唯一锁。两边都在同一 Tailscale 网里时,也可以t3 serve --tailscale-serve或t3 pair --tailscale,配对链接会走https://机器.tailnet.ts.net/这类地址。海外华人把家里机器留在 tailnet 上、人在外面批准命令,走的就是这条「用自己的机器继续干活」,不是教谁去翻墙出境。只本机回环(
127.0.0.1)
默认最安全,也最死:手机不挂在同一台机器的网络命名空间里,就连不上。本机t3 status当时是:Service not installed · T3 Connect off · Local network off。Sharing 页文案:Only this machine can connect.
坑就一条,值得单独记:t3 pair 若打出 http://127.0.0.1:…/pair#token=…,把链接发到手机,手机一定失败。先 t3 up --lan / Tailscale,再 pair,让 URL 里出现手机路由得通的地址。配对链接当密码;正文里不要贴真实 token。


验收:三条路能按「要不要账号中继 / 要不要私网可达 / 是否仅本机」说出选择;手机侧用到的 URL 主机名不是 127.0.0.1。
手机侧最小验收(有 Provider 时)
前置:电脑侧至少一个 Provider 是绿的;新线程默认已是 Supervised。
- 装 iOS 或 Android 的 T3 Code。
- 同一 T3 Connect 账号,或扫 / 粘贴配对码。
- 丢一个最小任务:在仓库里新建文本文件,外加一条只读命令(例如
git status)。 - 手机上出现批准请求时点允许。
- 回到电脑终端再跑一次
git status,确认文件真的落盘。
本机没有登录 Provider,这一节没法在这篇的验证环境里做完。你按上面五步在自己的机器上盖章即可。Web 端 app.t3.codes 也可以当「另一块屏幕」,逻辑一样:执行仍在主机。
验收:手机(或 Web)能看到待批准项;批准后电脑工作区有对应变更。
限制与诚实清单
- 项目很早:README / 发行说明自己写 Expect bugs;v0.1.6 一次合了很大一波改动(Release 写 521 changes / 137 contributors),别当生产运维面板。
- Claude 经 Agent SDK 会更快啃掉 5 小时额度(作者确认是 Anthropic 侧问题,周额度不受影响)。见官方 FAQ。
- 不支持本地模型。FAQ 原文态度很硬:本地能跑的模型做不了他们要的工程活。
- T3 Connect「for now」免费,机器数有上限;不够就链路 T3 Chat 付费档,或改走 Tailscale / 自建。
- 代码和提示词不进 T3 服务器;走 Provider。遥测可关:
T3CODE_TELEMETRY_ENABLED=false。 - 电脑睡了就断。断网也断。CLI 掉登录同样断。手机界面再完整,也只是一块亮着的玻璃。
出处
- 仓库:https://github.com/pingdotgg/t3code
- 官网 / 下载 / Web:https://t3.codes · https://t3.codes/download/ · https://app.t3.codes
- Release v0.1.6:https://github.com/pingdotgg/t3code/releases/tag/v0.1.6
- 远程 / 权限 / FAQ:
https://github.com/pingdotgg/t3code/blob/main/docs/user/remote-access.md
https://github.com/pingdotgg/t3code/blob/main/docs/user/permission-modes.md
https://github.com/pingdotgg/t3code/blob/main/docs/user/faq.md - iOS / Android 商店页见上文链接
写稿当日 Trending 中文镜像里,这仓库大约 +3,100★;累计星标以本机 gh api repos/pingdotgg/t3code --jq .stargazers_count 为准,当时是 37914。




