AI编程控制台T3 Code下载安装教程

大家好,本文将围绕最近在开发者社区刷屏的开源项目 T3 Code 展开,从下载安装一路讲到手机遥控实操,希望能带来一些实用的参考。无论你是刚开始用 Claude Code 的新手,还是已经同时开好几个 Agent 的进阶玩家,希望你都能有所收获!

Claude Code、Codex、Cursor 各占一个终端窗口,切来切去容易丢上下文;出门在外,任务跑没跑完、报没报错,全都两眼一抹黑——这是很多人用 AI 编程工具的共同痛点。**T3 Code(开源 AI 编程 Agent 统一控制台)**就是冲着这个问题来的:一个窗口管住你电脑上所有编码 Agent,还支持手机、网页、桌面三端远程接管。本文整理它的下载安装方式、Agent 接入配置、手机遥控全流程和避坑清单。

T3 Code 最新版安装包下载地址(无提取码,长期有效):

https://share.wangpanso.cn/s/dcpysr

不想装包管理器的朋友,直接从上面拿现成安装包即可;习惯命令行的往下看,三种安装方式都整理好了。

一、T3 Code 是什么:Agent 的驾驶舱,不是又一个编辑器

T3 Code 的官方定位是 “agent harness control surface”(Agent 控制面)——它自己不跑模型、不生成代码,而是把你电脑上已经在运行的编码 Agent 收进一个统一界面来调度、观测和控制。你可以把它理解成所有编码 Agent 的"驾驶舱":方向盘和仪表盘在这里,发动机还是原来那些。

项目出自 T3 Stack 作者 Theo 所在的 pingdotgg 团队,MIT 协议完全开源。截至本文撰写,GitHub 已收获 5.2 万+ Star、1 万 Fork,最新版本 v0.1.7,发版非常密集(Release 已累计近 800 个),热度还在上涨。

T3 Code 官网:The open-source control plane for coding agents

它最大的特点是"不另起炉灶,只做聚合":模型订阅继续用你自己的(BYO subscription),T3 Code 负责把散落各处的 Agent 会话变成可管理的线程。目前已支持接入的 Agent 清单如下:

Agent登录命令备注
Claude Codeclaude auth loginAnthropic 官方 CLI
Codexcodex loginOpenAI 官方 CLI
Cursoragent loginCursor CLI
Grok Buildgrok loginxAI 出品
OpenCodeopencode auth login开源 CLI
Antigravity设置内启用Google 出品,无需 CLI
fxfx login需在 T3 服务所在机器登录

形态上有三端,同一套服务端可以同时被多种设备接管:

  1. 桌面端:基于 Electron,支持 Windows / macOS / Linux;
  2. Web 端:浏览器打开 app.t3.codes 直达,零安装;
  3. 手机端:iOS、Android 均有官方 App。

其中"手机也能操控电脑里的 Agent"是最出圈的卖点:沙发上、地铁上都能看进度、回答 Agent 的提问、验收代码改动。

二、下载与安装:桌面端、命令行、免安装三种方式

2.1 桌面端安装包(推荐普通用户)

Windows 下用 winget 一条命令搞定:

winget install T3Tools.T3Code

或者用 scoop:

scoop install extras/t3code

macOS 用 Homebrew:

brew install --cask t3-code

Linux 用户从 GitHub Releases 下载 .deb 包后安装:

sudo apt install ./T3-Code-*.deb

Arch 用户走 AUR,Nix 用户用 nixpkgs:

nix profile add github:NixOS/nixpkgs/nixos-unstable#t3code

各平台安装方式对照如下:

平台推荐方式备选方式
Windowswinget install T3Tools.T3Codescoop / 官网安装包
macOSbrew install --cask t3-code官网下载 dmg
Debian/UbuntuReleases 页下载 .deb命令行脚本
Arch (AUR)t3code 系列命令行脚本
Nixnixpkgs 内置命令行脚本

不熟悉包管理器的朋友,直接从文首下载地址获取安装包,或者到 GitHub Releases 页面挑对应平台的文件。下图是仓库主页,Release 版本号和平台文件一目了然:

GitHub 仓库:52.3k Star,最新版 v0.1.7

2.2 命令行一键脚本(推荐服务器、常驻用户)

macOS / Linux:

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

Windows 在 PowerShell 中执行:

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

装完就有 t3 命令可用。这个方式装的是服务端 + CLI,适合想让 Agent 7x24 常驻的用户,桌面端可以后补。

2.3 免安装先体验

只想先看看界面合不合口味,一行命令跑一次就走:

npx t3@latest

不落常驻文件,玩完即走,适合观望党。

三、启动服务并接入第一个 Agent

T3 Code 本身不带模型,使用前提是电脑上已经装好并登录了至少一个编码 Agent。官方 README 专门用 Warning 强调过这一点。以主流的三家为例,登录命令:

# Claude Code
claude auth login

# Codex
codex login

# OpenCode
opencode auth login

Agent 就绪后,运行 t3 启动服务:

t3

它会拉起本地服务并自动打开 Web 界面。几个高频子命令建议记一下:

t3 service install   # 注册后台常驻服务(仅 Linux/macOS)
t3 update            # 升级到新版本
t3 status            # 查看运行状态
t3 --help            # 完整命令参考

下面是官方 README 的安装章节,七家 Agent 的登录方式官方都列好了,照着抄即可:

官方 README:安装与 Agent 接入清单

进入界面后,每个任务以"线程(Thread)"为单位组织,可以并行开多条线程分别跑不同 Agent,互不串上下文。

四、手机遥控实操:两条路线任选

4.1 T3 Connect:免公网 IP 的远程接管(推荐)

适合"人在外面、电脑在家里/公司"的场景,全程不需要在路由器上开端口转发。操作步骤:

  1. 在主机上运行 t3 up;
  2. 它会询问其他设备如何连到这台机器:T3 Connect、局域网、或两者都要,选 T3 Connect 并登录账号;
  3. Linux / macOS 会自动把服务注册成后台服务;Windows 不支持后台服务,t3 up 会给出 t3 serve 命令,保持终端开着即可(或直接常驻桌面端);
  4. 手机装官方 App(iOS / Android),或浏览器打开 app.t3.codes;
  5. 登录同一个 T3 Connect 账号,选择对应环境,即可接管主机上的所有线程。
t3 up        # 按提示选 T3 Connect
t3 status    # 随时查看连接状态

额度方面:免费账号可绑定 3 台主机,手机和浏览器不计数;如果订阅了 T3 Chat,Pro 上限 10 台、Premier 上限 100 台。对个人开发者来说 3 台(台式机 + 笔记本 + 家庭服务器)基本够用。

4.2 局域网 / Tailscale 配对:同网低延迟

手机和电脑在同一 Wi-Fi 下,走局域网直连延迟更低:

t3 up --lan    # 启动时选局域网
t3 pair        # 服务已在跑时,重新生成一条配对链接

把生成的配对链接粘贴到手机端「Add environment」输入框即可完成绑定。进阶玩家可以把两台设备加入同一个 Tailscale 网络,用下面命令拿到加密通道:

t3 serve --tailscale-serve

安全上注意两点:配对链接和授权码等同密码,不要截图发群里、不要贴进日志;把手机借给别人或接入不受信设备时,可以收缩权限再配对:

npx t3 pair --scope orchestration:read --scope relay:read

这样那条链接只有只读编排权限,删文件、改设置这类操作做不了。

五、避坑清单与 FAQ

Q1:T3 Code 收费吗?
工具本身完全免费开源(MIT 协议)。它调度的是你自己的 Agent 订阅,模型费用按你原有订阅计,T3 Code 不加价。只有绑机数量(免费 3 台)和可选的 T3 Chat 会员有关。

Q2:和 Cursor、GitHub Copilot 是什么关系?
不冲突也不替代。Cursor 是一体化 AI 编辑器,Copilot 是补全工具,T3 Code 是控制面——管的是 Claude Code、Codex 这类 CLI Agent。你可以白天在 Cursor 里写,同时让 T3 Code 管着后台跑任务的三条 Agent 线程。

Q3:Windows 上 t3 service install 不可用?
后台服务目前仅支持 Linux / macOS。Windows 用 t3 serve 保持终端运行,或者让桌面端常驻;关闭桌面端最后一个窗口会停掉本地服务,这点要注意。

Q4:我的代码会被传到云端吗?
服务端跑在你自己机器上,Web / 手机端是直连你的服务器,不走第三方中转;也可以完全走局域网或 Tailscale。代码和凭据都留在本地。

Q5:多开 Agent 并行一定更快吗?
不一定。并行会叠加各订阅的额度消耗,而代码验收、冲突处理仍然是人工瓶颈。建议从 2~3 条并行线程起步,找到自己的验收节奏再加量。

Q6:Linux 服务器上浏览器预览打不开?
部分 Linux 主机需要一次性装依赖,按服务启动时的提示在主机上执行 sudo t3 browser setup 即可(它会补齐沙箱配置和缺失的库与字体)。

Q7:项目稳定吗?
官方 README 原话是 “very very early”,明确说预期会有 bug,大功能 PR 目前也不接受。个人项目随便玩,生产环境建议等它再长一长。

六、总结

最后用一张清单收束全文核心要点:

  • T3 Code 是开源(MIT)的 AI 编程 Agent 统一控制台,GitHub 5.2 万+ Star,一个窗口调度 Claude Code、Codex、Cursor、Grok Build、OpenCode、Antigravity、fx 七家 Agent;
  • 三端接管:Electron 桌面端、Web(app.t3.codes)、iOS/Android App,服务端跑在自己电脑上;
  • 安装三条路:包管理器(winget / brew / deb 等)、官方一键脚本、npx t3@latest 免安装体验;
  • 使用前提:本机至少装好并登录一个编码 Agent,模型订阅用自己的;
  • 手机遥控两条路:T3 Connect(免公网 IP,免费绑 3 台)和局域网 / Tailscale 配对(t3 pair);
  • 项目早期,预期有 bug,个人项目尝鲜很香,生产环境再等等。

安装包再放一次,需要的朋友自取:

https://share.wangpanso.cn/s/dcpysr

参考资料:

  • GitHub 仓库:pingdotgg/t3code
  • 官方网站:t3.codes
  • Web 控制台:app.t3.codes

如果这篇文章帮到了你,点个收藏再走;你在接入哪家 Agent 时遇到了坑,欢迎评论区聊聊。

相关链接

名称链接
https://share.wangpanso.cn/s/dcpysrhttps://share.wangpanso.cn/s/dcpysr
pingdotgg/t3codehttps://github.com/pingdotgg/t3code
t3.codeshttps://t3.codes
app.t3.codeshttps://app.t3.codes
Logo

更多推荐