T3 Code:在一个工作区管理 AI 编程智能体
T3 Code 将现有 AI 编程智能体、任务对话与 Git 审查集中到同一工作区。本文梳理安装、服务商接入、worktree 任务隔离及手机远程访问流程,区分稳定版主题与 nightly 的智能体驱动 CSS 定制,并说明宿主机、权限和代码审查方面的限制,帮助你判断是否值得纳入日常开发流程。
发布于

T3 Code 把现有的 AI 编程智能体集中到一个工作区,让不同任务在各自的分支上推进,还能通过手机接着处理同一项工作。如果管理智能体、代码改动和多台设备本身已经成了一项负担,就值得考虑引入它。
它真正改变的是工作组织方式:从任务到差异查看,再到创建拉取请求,不必围着每个智能体的界面重新搭一套流程。T3 Code 免费且开源;智能体的费用仍由各自的服务套餐收取。
**版本范围,截至 2026 年 11 月 16 日:**本文以 11 月 11 日发布的 v0.1.9 稳定版为基准。这是一篇依据文档编写的指南,没有进行安装或手机配对实测。配置步骤参考仓库当前文档;较新的智能体驱动界面定制功能,下文会明确标注为 nightly 功能。
T3 Code 能为现有的 AI 编程智能体带来什么?
T3 Code 为多个智能体提供了共同的工作空间。这是 Theo Browne 团队的开源项目,提供 macOS、Windows 和 Linux 桌面应用、iOS 和 Android 移动应用,以及网页客户端。
可以把它想成一间工坊:不同专家各守一张工作台,专家就是编程智能体。T3 Code 负责整理工作区、对话和审查流程。它沿用智能体现有的运行框架,也就是为模型提供工具并执行其操作的软件,而不是提供一个自己的新模型。
仓库的功能概览列出了在线程内切换模型、在智能体之间委派任务、使用 worktree、审查差异和远程访问等能力。这里的线程是与任务关联的对话;差异视图则准确显示哪些代码行发生了变化。
引入它的理由,是把不同服务商的能力整合进同一套流程。单凭 worktree 或远程访问,不能断言各智能体自己的应用都没有这些功能。如果现有配置已经能轻松处理一个智能体和一项任务,新添的界面就得证明自己的价值。
想选择底层智能体,可以看我们的 AI 编程智能体对比;想选择自己动手写代码的环境,可以看编辑器对比。
先安装,再跑一个小任务
先在存放代码、运行智能体的电脑上配置,手机应用稍后再装。
- **安装桌面应用。**从官方下载页获取安装包。macOS 的包管理器命令是
brew install --cask t3-code;Windows 是winget install T3Tools.T3Code。Linux 提供 AppImage 和.deb下载,请选择符合机器架构的文件。AppImage 启动前需要先赋予可执行权限。 - **连接一个服务商。**打开 设置 → 服务商(Settings → Providers),选择环境,也就是实际执行任务的机器,再按下表启用一个智能体。安装和登录都要在那台机器上完成。
- **添加现有 Git 项目。**Git 是记录改动的版本控制系统。在网页应用中使用 添加项目(Add project);桌面端则可以把文件夹拖进侧边栏。桌面应用运行时,执行
t3 app也能将终端当前目录作为项目打开。 - **新建线程,确认工作位置。**选好项目、模型和权限模式。需要隔离的代码改动,应在发送任务前选择 新建工作树(New worktree) 并指定基准分支。
- **交给它一个容易验证的任务。**例如:“为这条现有校验规则补一个测试,运行相关测试命令,并解释代码差异。”发布任何改动前,先检查变更文件和测试输出。
如果想先试网页端,npx t3@latest 需要 Node.js,运行的是 npm 选定的稳定版,不能用它启动已安装的 nightly 版本。安装指南还介绍了 Linux 启动细节和 Windows Subsystem for Linux。使用 WSL 时,服务商工具应安装在所选的 Linux 发行版中。
各智能体如何接入?
通用规则很简单:智能体在哪里运行,就在哪里登录,然后在 T3 Code 中启用。在笔记本上登录,并不会替远程服务器上的智能体完成配置。
CLI 即命令行界面,指可以在终端中运行的程序。如果已安装的智能体没有显示,请在服务商设置中填写 可执行文件路径(Binary path),告诉 T3 Code 到哪里寻找程序。还应查看服务商卡片中的兼容性警告和推荐版本。
若要接入其他使用 ACP 的智能体,可打开 设置 → 服务商 → 添加服务商 → 显示更多(Settings → Providers → Add provider → Show more)。ACP 即 Agent Client Protocol,是连接智能体软件与客户端的协议。选择注册表中的智能体,添加并完成登录。本地 ACP 命令(Local ACP command) 则用于连接宿主机上已经安装的可执行程序。可用模型和选项取决于该智能体开放的能力,具体参见 ACP 配置指南。
用 worktree 分开任务,再审查整个分支
worktree 是关联到同一个 Git 仓库的独立工作目录。一个任务修改自己的文件时,另一个任务可以在别处推进,避免同时编辑同一份检出目录。
例如,将结账流程缺陷和文档更新放进不同线程。每个任务都选择 新建工作树(New worktree),并从预期的基准分支开始。这样,各任务都有自己的分支和目录,结果也能分别审查。

线程工作流还支持把同一个提示词发送给多个模型:在新线程的模型选择器中按住 Shift 点击模型,选择基准分支,再发送任务。每个选中的模型都会启动独立线程和 worktree。这项功能需要 Git 项目。
先用当前轮次的差异视图检查本轮改动,再用分支比较查看相对基准分支的全部变化,并运行项目相关检查。改动准备好后,可以通过线程中的 Git 操作提交、推送并创建拉取请求,也就是供他人在合并前审查代码的提案。
Git 和代码托管平台的身份验证,都应配置在运行 T3 Code 的机器上。登录后,使用 设置 → 源代码管理 → 重新扫描(Settings → Source control → Rescan)。源代码管理指南介绍了身份验证和审查控件。
worktree 能隔离文件,却不能让相互冲突的设计决策自动兼容。两个任务仍可能用不同方式修改同一行为。也不能认为目录分开了,数据库、凭据和外部服务就随之隔离;这些都需要项目另行配置。
对业务而言,实际变化是:还原任务状态时,需要四处查找的地方变少了,对话、文件和审查进入同一套流程。这是操作步骤上的具体变化。本文没有经过验证的节省工时数据,增加智能体数量也不会消除审查工作。
手机接着处理,宿主机继续运行
手机控制的是宿主电脑。项目、凭据和运行中的智能体,仍在宿主机上。
- 在桌面宿主机上打开 设置 → 共享与访问(Settings → Sharing & access),登录并为该环境启用 T3 Connect。
- 通过官网上的 iOS 或 Android 链接安装移动应用。
- 在手机上登录同一个 T3 Connect 账号,并选择环境。
- 打开现有线程,继续对话或处理审批。正式在外使用前,先确认计划使用的网络能够连接宿主机。
对于命令行宿主机,t3 up 可以启用 T3 Connect、局域网访问或两者兼用,并将 T3 Code 作为后台服务运行。如果依赖的是桌面应用的本地服务器,关闭最后一个窗口就会停止服务器。电脑必须持续运行,且能够连接。

普通 T3 Connect 账号的上限是三台宿主机,手机和浏览器不占用名额。也可以通过局域网或 Tailscale 直接配对。配对 URL 本身就是凭据,默认配对会授予广泛权限。远程访问指南介绍了如何缩小权限范围以及撤销访问。
如果任务需要持续较长时间,可以看我们的长时间运行的生产任务指南,其中讨论的是另一个问题:如何监督任务本身。
界面定制:稳定版改主题,nightly 改 CSS
新的定制能力不只是选颜色:智能体可以通过 CSS 重新设计界面样式。CSS 就是控制网页界面外观的规则。
务必分清版本边界。稳定版 v0.1.9 的对应版本外观指南包含调色板编辑、主题导入导出和环境主题。由智能体驱动的颜色与布局定制,则列在 11 月 14 日发布的预发布版本 v0.1.10-nightly.20261114.4669 中,可参见发布记录。
在支持新功能的构建版本中,打开 设置 → 外观 → 创建主题(Settings → Appearance → Create theme),再选择 自定义 CSS(Custom CSS)。导出主题时,CSS 会一并导出。也可以让运行在服务器所在机器上的智能体完成具体修改,比如加高聊天区标题栏。该线程必须使用 完全访问(Full access) 模式。
这里有几个使用边界。移动端有自己的外观偏好设置。环境主题不适用于 app.t3.codes 及其他连接。CSS 类名可能随版本变化;当前指南建议改用看起来较稳定的 data- 属性作为选择目标。通过主题 CSS 加载外部文件也受到限制。
如果定制后把需要的控件藏起来了,可以换一个主题,或在服务器上运行 t3 theme set t3-chat。当前外观文档说明了功能用法和恢复方法。我的建议是:先做一项改善可读性的小改动,再确认差异视图和审批控件仍然可见。
值得尝试的五种工作流,按优先级排列
以下是可以尝试的实际用法,并非经过测量的客户成果。
围绕它可以做的两个产品方向
**最值得考虑的是面向特定仓库的 worktree 初始化工具包。**团队可能愿意付费,换取一套可重复执行的流程,为每个任务目录准备依赖、本地配置、测试数据库和开发服务器端口。最小可用版本可以只支持一个团队的仓库,检查前置条件,并提供清理命令。T3 Code 仍然是启动任务和审查工作的操作界面。
大家对底层工作流感兴趣,不代表这款具体产品就有需求。商业验证要看:团队是否反复把时间耗在让新 worktree 真正可用上。难点在于仓库差异,通用封装很容易被复制,而可靠的初始化经验却与具体技术栈紧密相关。这种针对性也正是它最值得考虑的原因。
**另一个方向是服务商接入与兼容性工具包。**服务团队或内部工具团队可以用它检查各宿主机装了哪些智能体工具,在不收集凭据的前提下引导身份验证,并记录已知可用的配置。MVP 可以是一份本地诊断报告加一份团队配置指南,先以小型实施服务交付,再发展为软件。
人们愿意了解配置方法,不等于愿意为配置工具包付费。T3 Code 已有服务商设置、兼容性警告和更新控件,重复这些能力难以构成有吸引力的产品。机会必须落在团队可复现的环境和接入流程上,而服务商的变化意味着持续维护责任。
什么情况下值得引入 T3 Code?
需要跨智能体的共同工作流、多个相互隔离的任务,或从其他设备访问时,可以考虑引入它。如果这些能力都没有解决反复出现的问题,就继续使用现有配置。
限制都很实际:服务商身份验证和用量限制依然存在,远程宿主机必须可用,worktree 仍需配置依赖并运行测试。自动生成一份拉取请求说明,也不等于完成代码审查。当前主分支文档可能描述比稳定版下载更新的功能,而 nightly 定制又增加了一个需要管理的变量。
第一天使用时,先选一项低风险改动走完流程:接入一个智能体、打开仓库、创建 worktree、运行检查、查看差异,再准备拉取请求。这套流程跑通后,再加手机访问。如果整套工作流确实更容易管理,就留下 T3 Code。
应该使用 T3 Code Nightly 吗?
首次配置以稳定版为基准。Nightly 属于预发布版本,适合明确需要较新智能体驱动 CSS 定制功能的情况。本文区分了稳定版 v0.1.9 和列出该功能的 11 月 14 日 nightly 版本。
T3 Code Mobile 会在手机上运行智能体吗?
手机连接的是另一台机器上的 T3 Code 服务器。智能体在那台宿主机上运行,项目也保存在那里。请保持宿主机运行并可连接,再通过 T3 Connect 或合适的配对方式接入。
T3 Code 支持 Windows 和 Linux 吗?
支持。Windows 提供桌面安装程序和包管理器安装方式。Linux 为支持的架构提供 AppImage 和 Debian 安装包。如果使用 WSL,请在所选发行版内部配置智能体。
能在浏览器里使用 T3 Code 吗?
可以。网页客户端会连接你的 T3 Code 服务器。托管的 app.t3.codes 客户端需要 HTTPS 端点;它本身不能让原本无法连接的宿主机变得可连接。
如果团队希望为智能体工作区建立可重复的配置流程,我们可以帮助搭建配套的生产工作流。
- 发布日期
- 分类
- Build
- 语言







