T3 Code：用手机和桌面远程操控 Claude Code / Codex / Cursor 等 Agent

T3 Code 是 pingdotgg（Theo 团队）开源的 agent harness 控制面：用手机、Web、Electron 桌面端，远程操控你本机已经装好的编码 Agent——Claude Code、Codex、Cursor、Grok Build、OpenCode。仓库约 1.7 万 stars，MIT 许可。官网：https://t3.codes

T3 Code

项目简介

它不卖新模型，也不替换你现有的 CLI 订阅。本机装了哪些 Agent、登过哪些账，T3 Code 就尽量把它们收成一套「远程可控」的界面：桌面 Electron、Web、iOS、Android。

README 写得很直白：他们想要性能好、能远程、真正开源的体验；现有 Codex Desktop / Conductor / Claude Desktop / Cursor Glass 都没完全踩到点。方向偏了你也可以 fork。

目前仍很早期，预期会有 bug；大功能贡献暂不接，小修可能看。

核心能力

多 Provider 统一壳：Codex / Claude Code / Cursor / Grok Build / OpenCode——CLI 在本机装好并 login 即可
多端客户端：本机 Web、桌面 App、手机 App，经服务端会话编排
远程访问：npx t3 pair 配对（含二维码）；推荐 Tailscale 等私有网络，也可桌面端开 Network access
服务端边界清晰：Agent 进程、终端、git、文件系统都在 server 侧执行，客户端只做 UI + RPC
事件溯源编排：命令 → 持久化事件 → projection，便于重试与订阅流

架构（简图）

text

Clients (web / desktop / mobile)
        │  Effect RPC over WebSocket (/ws)
        ▼
apps/server  — orchestration · provider drivers · VCS · terminals · FS
        │
        ▼
Agent CLIs: Codex, Claude, Cursor, Grok, OpenCode

客户端共享 packages/client-runtime（连接监督、RPC、状态）；契约在 packages/contracts。服务端 OrchestrationEngine 串行处理 command，落库事件并更新读模型。

安装与首次运行

前置

跑 server 的机器：Node.js ^22.16 || ^23.11 || >=24.10
至少一个 Provider CLI，并完成登录：

Provider	CLI	登录
Codex	Codex CLI	`codex login`
Claude	Claude Code	`claude auth login`
Cursor	Cursor CLI（`cursor-agent`）	`agent login`（注意不是 `cursor-agent login`）
Grok Build	Grok Build CLI	`grok login`
OpenCode	OpenCode	`opencode auth login`

Auth 在跑 T3 server 的那台机器上做，不是在你浏览用的手机上做。

免安装试用

bash

npx t3@latest

会在本机起 backend，并打开本地 Web 控制面。完整参数见 npx t3@latest --help。

桌面应用

Releases：https://github.com/pingdotgg/t3code/releases
Windows：winget install T3Tools.T3Code
macOS：brew install --cask t3-code
Arch：yay -S t3code-bin

手机配对

本机 server 已在跑时：

bash

npx t3 pair              # 一次性配对 token + 二维码
npx t3 pair --tailscale  # 经 Tailscale Serve HTTPS 暴露，适合跨设备

若只绑了 loopback，别的设备扫不了；用 tailnet 或在桌面 Settings → Connections 打开 Network access。

文档入口

仓库 docs/（暂无独立文档站）：

从源码构建需要 Vite+ 的 vp CLI（见 README / CONTRIBUTING）。

适用场景

你已经在用 Claude Code / Codex 等订阅，想在：

手机上盯长任务、补一句指令
另一台电脑的浏览器连回本机 Agent
一个界面里切换多家 Provider

这类需求时，T3 Code 比「再装一个闭源桌面壳」更透明：协议和 server 边界都能看。

小结

T3 Code 是 本机 Agent 的远程控制台，不是新的 coding model。npx t3@latest 就能试；正式用再装桌面端，并配好至少一个 CLI 的 login。早期项目，功能与稳定性会变，以仓库 README 和 Releases 为准。

GitHub：https://github.com/pingdotgg/t3code
官网：https://t3.codes
Web：https://app.t3.codes
Discord：https://discord.gg/jn4EGJjrvv