[Github] T3 Code – 用一个界面管理 Claude Code、Codex 等多个 AI 编程代理

Github发现2026-11-12发布 WarpEdit

T3 Code 是一个开源的 AI 编程代理「控制台」：它本身不带模型，也不提供算力，而是把你电脑上已经装好、登录好的 Claude Code、Codex、Cursor、OpenCode、Grok Build、Google Antigravity 等代理统一放进一个界面里管理。桌面应用、网页和手机 App 都能用，订阅还是你自己的，T3 Code 不收费，代码采用 MIT 许可。如果你同时开着两三个代理的终端窗口来回切，或者想在手机上看一眼家里电脑上的任务跑到哪了，它就是为这种场景做的。

它管的是哪一层

理解 T3 Code，先要分清两层东西。Claude Code、Codex 这类工具，底下是一个「harness」（可以理解为代理的运行框架）：它给模型提供读写文件、执行命令等工具，负责调用、执行并把结果交回模型，模型这才成了能干活的代理。上面再套一层界面，比如终端里的 TUI 或官方桌面应用。

T3 Code 替换的只是上面那层界面。官方 FAQ 打了个比方：模型是厨师，harness 是厨房，T3 Code 是一家允许你自带厨房的餐厅。所以它离开这些代理就无法工作，必须先装好至少一个，并在命令行里完成登录。

这样做的好处是，不同代理在 T3 Code 里的操作方式几乎一样：开线程、发消息、批准命令、看改动 diff、管理 Git 分支，都在同一套界面里完成，不用为每个代理记一套快捷键和窗口。官方 README 说团队参考过 Codex 桌面应用、Conductor、Claude Desktop 和 Cursor Glass，但都「没达到我们的标准」，于是自己做了一个，强调三点：性能、远程可用、完全开源。

T3 Code 桌面界面左侧列出线程，中央对话显示多个子代理，右侧展开线程菜单 — T3 Code 官网的桌面示例。左侧可以切换线程，中央能看到同一任务下的多个子代理。

支持哪些代理

截至 2026 年 11 月 12 日，README 列出的可直接使用的代理和登录方式如下。每一个都要先在运行 T3 Code 服务的那台电脑上装好并登录：

代理	准备工作
Claude Code	安装 Claude Code，运行 `claude auth login`
Codex	安装 Codex CLI，运行 `codex login`
Cursor	安装 Cursor CLI，运行 `agent login`
Grok Build	安装 Grok Build CLI，运行 `grok login`
OpenCode	安装 OpenCode，运行 `opencode auth login`
Google Antigravity	不需要 CLI，在 T3 Code 设置里启用，点「Install Antigravity」并用 Google 登录
fx	安装 fx，运行 `fx login`

文档里还有 Pi、Muse Code、Kiro 以及 ACP Registry 代理的接入说明。如果不想用订阅，也可以在设置里另加一个「provider 实例」，填自己的 API Key 或 OpenRouter 地址，原来的订阅配置不受影响。

有两点要提前知道。第一，T3 Code 不支持本地模型，官方 FAQ 的理由是本地能跑的模型还做不了像样的工程工作。第二，如果某个代理在列表里不出现，十有八九是它的命令行工具没装在服务那台电脑上，或者不在 PATH 里；用 nvm 之类版本管理器装的工具尤其容易这样，可以在 provider 设置里手动填「Binary path」。

安装和首次运行

T3 Code 有两种装法：命令行服务和桌面应用。二者都会在本机启动一个服务，代理就在这台机器上干活。

命令行方式，macOS 和 Linux：

curl -fsSL https://t3.codes/install.sh | sh

Windows 用 PowerShell：

irm https://t3.codes/install.ps1 | iex

装好后运行 t3，它会启动服务并在浏览器里打开本地网页界面。几个常用命令：

t3 ./my-project：在指定项目目录里启动
t3 service install：作为后台服务常驻
t3 update：升级到新版本
t3 uninstall：卸载

只想先试一下，可以用 npx t3@latest，需要本机有 Node.js。

桌面应用可以从 GitHub Releases 下载，也能用包管理器装：Windows 用 winget install T3Tools.T3Code 或 Scoop，macOS 用 brew install --cask t3-code，Linux 有 .deb、AppImage（x86_64 和 ARM64）、AUR 和 Nix。

注意一个例外：Intel 芯片的 Mac 没有 t3 命令行程序，只能用桌面应用；想在 Intel Mac 上跑服务，得自己从源码构建。Windows 用户还可以让代理跑在 WSL 里。

第一次打开后，先确认要用的代理已经出现在列表里，再开一个线程，先核对模型和下文的权限模式，再发送第一个任务。

先把默认权限改掉

这一节建议在开第一个线程前就看。T3 Code 给每个线程设了「权限模式」，决定代理执行命令、改文件前要不要问你：

模式	行为
Supervised	执行命令和修改文件前都请求批准
Auto-accept edits	文件修改自动通过，其他操作仍可能要批准
Auto	交给代理自身的自动审查，常规操作放行，其余再问你
Full access	T3 Code 放行命令和修改，代理自身或管理员的限制仍可生效

关键在于：根据官方文档，新线程的初始默认值是 Full access。对熟手来说这很省事，但如果你习惯 Claude Code 或 Codex 默认先问再做，换到 T3 Code 后代理可能直接执行命令、改动文件。建议先到「Settings → Threads → New threads → Permissions」把默认值改成 Supervised 或 Auto，确认信得过再放开。

各代理对权限的执行也不完全一样。比如 OpenCode 和 Antigravity 没有对应的自动审查，选 Auto 时会退回到逐项询问；Grok 没有 Auto-accept edits，Muse Code 只有 Supervised 和 Full access 两档。项目可以覆盖环境默认，已开启的线程保留原权限；管理员也可以限制整台机器可选的模式。具体以各 provider 文档为准。

远程和手机怎么用

T3 Code 的另一个卖点是远程。思路是：代理在哪台机器上运行，T3 Code 服务就装在哪台机器上，比如家里的台式机、公司的开发机或一台 VPS；手机、浏览器和别的电脑只是遥控器。官方 FAQ 里作者自己说，他不到 5% 的提示是在笔记本上跑的。

在那台机器上运行 t3 up，它会问你其他设备怎么连进来，有三种选择：

T3 Connect：官方提供的连接服务，不用设置路由器端口转发。目前免费，每个账号最多连 3 台跑 T3 Code 的机器，手机和浏览器不算在内；关联 T3 Chat Pro 账号可提高到 10 台，Premier 可提高到 100 台。官方也说明，如果账单压力太大，免费政策可能调整。
局域网配对：同一网络下直接连。
Tailscale：自己组的虚拟局域网。作者在 FAQ 里说他本人也拿 Tailscale 当 T3 Connect 的备用。

为什么不在家庭宽带上直接开个端口就行，原理可以看内网穿透是什么？为什么出门了就连不上家里的电脑？

手机端有 iOS 和 Android App，网页端是 app.t3.codes。要记住手机只是遥控器：干活的电脑必须一直开机、保持在线，电脑休眠了，任务也就停了。

T3 Code iPhone 界面把不同项目与代理的会话集中列在一个收件箱中 — T3 Code 在 App Store 展示的 iPhone 收件箱。手机上可以查看各个会话，执行任务的仍是运行代理的电脑。

代码和数据走向

很多人第一反应是：代码会不会经过 T3 的服务器？按官方 FAQ 和文档的说法：

代码和提示直接从你的机器发给模型提供方（Anthropic、OpenAI 等），不经过 T3。
用 T3 Connect 时，流量走你机器上运行的 Cloudflare 隧道（cloudflared）。T3 的中继只负责建立连接，不代理你的 HTTP 和 WebSocket 会话。
T3 Code 会发送产品使用数据，包括用的哪个代理、模型、权限模式、token 数量等，并附带哈希化的账号标识。文档写明不包含提示、回复、文件内容和认证 token。
想关掉，在启动服务前设置环境变量 T3CODE_TELEMETRY_ENABLED=false。但文档也提到，浏览器里的网页端不读这个变量，可能仍会发送自己的连接诊断数据；手机 App 崩溃时也会上报错误报告。

这些都是项目方的说明，本文没有抓包验证。对代码保密要求高的团队，可以先用局域网或 Tailscale 方式连接、关闭遥测，再自行检查网络流量。

还有两条 FAQ 里的说法值得留意。一是用 Claude 时，作者确认 Anthropic 的 Agent SDK 有个问题，会让 5 小时额度比直接用 Claude Code 消耗得快，周额度不受影响，已上报 Anthropic。二是关于「会不会因此被封号」，项目方表示 T3 Code 在 Claude Code、Codex 和 Antigravity 的服务条款范围内。这是项目方的表态，具体还是以各家条款为准；FAQ 里也明确不建议在 T3 Code 里堆一大批账号轮换使用。

谁适合用，现阶段要注意什么

比较适合的人：

同时订阅了两个以上编程代理，想在一个界面里切换和对比的人。
任务常跑在台式机、开发机或 VPS 上，希望离开电脑后还能用手机看进度、批准操作的人。
看重开源、希望工具方向不对时还能自己 fork 的人。

可能没必要换的情况：只用一个代理，而且对它的官方应用或终端已经很满意；或者你主要想用本地模型。

现阶段的几点提醒：

项目很早期。版本号还在 0.1.x，README 自己写着「Expect bugs」。稳定版更新很密，10 月 27 日到 11 月 11 日之间就发了 v0.1.3 到 v0.1.9，预览版每天还有好几个。
基本不接受外部贡献。README 写明小修复可能考虑，大功能不收；有需求可以去 Discussions 提。
工作树会占磁盘。T3 Code 会为线程创建 Git worktree，FAQ 提到有用户一次清出了 500 GB，建议在「Settings → Worktrees → Cleanup」打开自动清理。

如果你更关心代理用了多少 token、花了多少钱，站内介绍过的 AgentsView 走的是另一条路：不负责控制代理，只在本地搜索和分析各代理的会话记录，两者可以搭配使用。