T3 Code

模型 创建 更新
deepseek-v4.1-flash 2026-10-12 2026-10-12

T3 Code 是 T3 Tools Inc. 以 MIT 许可开源的「智能体外壳控制面（agent harness control surface）」：在一台机器上运行本地服务器，把该机器上已经装好并登录的编码智能体 CLI 拉起来（Codex、Claude Code、Cursor、Grok Build、OpenCode、Antigravity、Pi、Muse Code），再用桌面、浏览器与手机客户端统一控制；官方明确不做自己的 harness，也不转售模型额度。

它的取舍是把控制面做成「自己的服务器 + 多个客户端」：会话、worktree、Git、终端与审批都归服务器，换设备只是换窗口，因此可以在手机上监督与批准；代价是权限姿态默认最宽——新线程默认 Full access（无审批提示），而它提供的隔离工具（git worktree）只隔开 checkout 之间，不隔开机器。 依据：官方权限文档写明「初始默认是 Full access」，且只推荐把它用在「可丢弃的 worktree 或沙箱」里；第三方实测的对应表述是「worktree 保护的是一个 checkout 不被另一个 checkout 影响，它并不保护你电脑的其余部分免受一条全权限命令的影响」。

是什么

  • 开发者与维护方：T3 Tools Inc.（Theo Browne 的公司，旗下另有 t3.gg 与 T3 Chat），核心工程师为 Theo 与 Julius（@jullerino）。创始人在发布说明中特别指出 T3 Code 不是 T3 Chat 的一部分，而是独立开源项目（第三方对直播与发布视频的转述，2026 年）。
  • 定位与设计取向：自称「智能体外壳控制面」；不做自己的智能体框架，而是启动各实验室官方的 CLI 或 agent SDK，把它们各自不同的事件流归一成同一套接口。README 说明灵感来自 Codex 桌面应用、Conductor、Claude Desktop 与 Cursor Glass，但认为这些方案未达标。
  • 形态：一台机器上的本地服务器（t3 serve，本机默认端口 3773；t3 service install 可常驻）加四类客户端——Electron 桌面应用（内置服务器）、本地 Web 应用、托管 Web 应用 app.t3.codes、iOS 与 Android 原生应用；另有原生 SwiftUI 重写的 TestFlight 测试版。桌面应用也可反过来关掉本机环境，只当远程客户端用。
  • 概念模型（官方术语表）：environment（一个运行中的服务器及其机器、凭据与状态）、client、project（目录记录）、worktree（线程可用的独立 git checkout）、thread（持久会话，跨 provider 进程退出而存活）、turn（一次用户—智能体循环）、checkpoint（用隐藏 git ref 保存的工作区状态，用于 diff 与还原）。
  • 支持的 provider（官方安装文档表格，8 项）：Codex（可直接用 ChatGPT 登录，无需 CLI）、Claude Code、Cursor（可执行文件为 cursor-agent，登录命令却是 agent login）、Grok Build、OpenCode、Antigravity（Google 登录，用托管运行时）、Pi、Muse Code；此外还支持 ACP 注册表中的智能体。同一 provider 可建多个实例，各自独立账号、环境变量与 base URL；密钥标记为敏感后不再回显。
  • 核心能力：线程级 worktree 与分支（分支名可自动生成，静态前缀默认 t3/，也可用 feat/、fix/ 这类语义前缀）；三档 diff 评审（单次 turn、整条分支、未暂存改动）；checkpoint 与消息级还原；一键 commit / push / 建 PR，覆盖 GitHub、GitLab、Forgejo、Gitea、Bitbucket、Azure DevOps、GitCafe；GitHub stack 的合并与 rebase；Review guide（beta）；让智能体 watch_pull_request 每两分钟检查 PR 并在检查失败、评论或冲突时被唤醒；线程生命周期（pin / settle / snooze / archive，默认 3 天不活跃或 PR 合并后自动 settle）；计划任务与 webhook 自动化（公网 URL 需要 T3 Connect 隧道）；项目快速动作（可写在 t3.json 里，支持 runOnSettle）；内嵌 headless Chrome（首次约 120 MB）供预览与浏览器操作；跨 provider 的用量页。
  • 远程访问：T3 Connect（Clerk 账号 + Cloudflare 隧道 + PlanetScale 数据库；官方免费，不用自建端口转发）、局域网与私网配对链接、Tailscale HTTPS、桌面应用托管的 SSH（在远端自动装 T3 服务器）；同一台机器可保存多条路由并自动切换，多机时可「自动均衡」把新线程分配给有资源的机器；访问用一次性配对链接与作用域（orchestration:read、filesystem:write、source-control:write 等），可在宿主机撤销。
  • 反向外驱：T3 Code 自己暴露 MCP server（https://<环境地址>/mcp），让外部智能体（Claude Code、Codex、ChatGPT 或其他支持远程 MCP 加 OAuth 的 bot）读取项目与线程、启动与回复线程；默认只读，升级为可操作需要配对批准，会话 30 天。
  • 用量与额度：Usage 汇总 Codex、Claude Code、Grok Build、OpenCode、Antigravity、Pi 与 Cursor 的 token、缓存节省与「API 等价成本」（官方强调这不是你的账单），Limits 把同一 provider 的多个账号池成一个剩余量视图，可自定义模型价格、接 CLIProxyAPI 中继；iOS 与 Android 提供订阅额度小组件。
  • 遥测：默认向 PostHog 发送匿名产品事件（provider、模型、推理档、权限模式、turn 结果、时长、主智能体 token 总量；官方称不含提示词、回复、文件内容、认证令牌与会话 ID），可用 T3CODE_TELEMETRY_ENABLED=false 关闭；也可把日志、指标与 trace 以 OTLP 导出到自建接收端。

当前状态

  • 活跃但自标 alpha。README 原文写「我们在这个项目上还非常非常早期。预期会有 bug」，并说明基本不接受外部贡献（小修复可能考虑，大功能不会）。仓库内同时存在一份 orchestration-v2 目标架构，明确写「不是补丁计划，且有意不考虑迁移与向后兼容」。
  • 截至 2026-10-12（GitHub API 核验，canonical 仓库 pingdotgg/t3code，fork: false）：27,020 star、7,094 fork、2,552 个未关闭 issue；MIT；创建于 2026-02-08，最近推送 2026-10-12；贡献者约 470 人（含匿名计数的口径为 473）。最新正式版 v0.0.45（发布 2026-10-02），同时在产 v0.0.46-nightly.* 与 0.0.46-preview.* 预发布，夜间版一天数条。
  • 版本号仍在 0.0.x。第三方 2026-08-19 的快照为约 19,500 star、v0.0.34；2026-07-29 官方宣布 iOS 与 Android 应用上线（此前只有桌面与 Web），并称「仍然 100% 免费、仍然 100% 开源」。
  • 平台：桌面 macOS（Apple Silicon 与 Intel）、Windows、Linux（.deb、AppImage、AUR，另支持 WSL 发行版）；移动端 iOS 与 Android 已上架生产版。Android 商店页 2026-10-12 的读数为 4.2 星、35 条评价、10K+ 下载，页面最后更新 2026-10-03。Intel Mac 没有官方的 t3 命令行可执行文件（桌面应用仍可用），需要自己从源码构建服务器。
  • 站点计数器不可靠：法务页脚写「22k+ GitHub stars」、下载页与隐私页写「24k+」，首页写「超过 40 万开发者用（Tolerated by over 400,000 devs）」，同日另一份快照读到 500,000。本页只取量级，不作为结论。
  • 没有官方托管云：仓库中「带预算与独立清理的托管一次性云 worker」提案（#14620）以 not_planned 关闭；第三方也据此指出 T3 Code 不会替你在云上跑智能体，远程访问的对象必须自己保持运行与可达。

优势

  • 跨设备的监督与审批是产品前提。服务器持有进程、终端、文件、Git 与 provider 凭据，Web、桌面与手机都只是客户端；智能体请求批准时会变成线程里的审批卡片，可在任一设备上回答。官方架构文档把「远程客户端不得用自己的文件系统、provider 凭据或机器状态替代环境本身的」写成硬边界。
  • 会话被结构化，而不是终端回放。thread / turn / checkpoint / PR 都在数据模型里；checkpoint 用隐藏 git ref 记录工作区状态，不往用户分支里加提交；还原会先检查 provider 是否支持回滚对话，不支持时在动文件之前就拒绝。
  • 隔离与评审可选但不弱：每线程可用新 worktree 与自动命名分支；评审有 turn / 分支 / 未暂存三档 diff、行内批注、一键 PR、GitHub stack 与（beta）评审导览；智能体还可自己 watch PR，在检查失败、必需检查通过、他人评论或分支冲突时被唤醒。
  • 自带订阅、转售为零：T3 Code 不卖 token，用你已在各 provider 上的订阅或密钥；MIT 许可允许自建与再分发（官网把 gh repo fork pingdotgg/t3code --clone 直接放上主页）。
  • provider 与账号都多样化：8 个官方 provider 加 ACP 注册表；同一 provider 可并行多个账号；线程内可切换模型，v2 文档把「换 provider」设计成显式上下文交接，而不是改提示词。
  • 权限模式映射到 provider 原生策略，并把差异说出来。「Auto」在 Codex 走自带 AI 审批、在 Claude 用其自动权限模式、在 OpenCode 与 Antigravity 没有等价能力时退回询问；Muse Code 只提供 Supervised 与 Full access。这些都在官方文档里点名列出，而不是假装统一。
  • 用量与额度集中可见：跨环境合并 token、缓存节省、API 等价成本与订阅剩余量，可在界面里改模型价格；官方明确说明 API 等价成本不等于账单。
  • 反向控制面：自带的 MCP server 让「不是 T3 Code 启动的智能体」也能读环境、启动线程，默认只读且需显式批准，适合把 T3 Code 当作被其他智能体调度的运行层。

局限与注意事项

  • 默认无审批，且隔离不到机器。 新线程的初始默认是 Full access（可在「设置 → 通用 → 新线程 → 权限」修改，项目也可覆盖）；官方建议只把它用在可丢弃的 worktree 或沙箱里。但 worktree 只隔离 checkout，第三方实测的表述是「它并不保护你电脑的其余部分免受一条全权限命令的影响」。与同主题的 Orca 相比，两者都把「不审批」当默认，区别在 T3 Code 把四种模式映射到各 provider 原生策略并标出例外。
  • 机器级隔离要自己搭，而且不轻松。官方 Docker Sandboxes 集成文档写明 T3 Code 没有专用集成，只是把沙箱当一台 SSH 主机；首次连接会在沙箱内装 T3 服务器，而 node-pty 只有 macOS 与 Windows 的预编译包，Linux 侧需要 g++、make、python3；同一页还记录了 turn/setPermissionMode failed 的常见原因（默认运行模式 Full access 映射到 Claude Agent SDK 的相应设置）。
  • alpha 的现实：2,552 个未关闭 issue、版本号 0.0.x、一天数条夜间版、编排层正在被重写，而且官方基本不接受外部大功能贡献——这个对比是采用前最该看的一栏。
  • 适配器永远滞后于 provider：新特性先出现在官方 CLI 或应用，T3 Code 需要跟上；官方与第三方都建议「当某个 provider 的原生新功能就是任务本身时」直接用那个 CLI。
  • 远程路径依赖第三方并可被回收：T3 Connect 由 Clerk 管身份、Cloudflare 管隧道、PlanetScale 存库，官方文档把中继称作「可信代理」，并明说「DPoP 保护的是诚实交换，不能让被攻破的中继签名密钥变得无害」；空闲隧道会被回收（隧道中断后约 5–10 分钟开始清理，恢复时自动重建），旧版本环境离线 7 天后隧道被移除。
  • 遥测默认开启：PostHog 匿名事件默认收集，可关闭或改走自建 OTLP；「无遥测」一类第三方说法要按这一条限定理解。
  • 资源与层级成本：Electron 桌面包 140–210 MB（各平台 dmg / exe / AppImage / deb / tar.gz），首次还要下载约 120 MB 的 headless Chrome；而且它在你与 CLI 之间加了一层服务器、数据库与协议。官方与第三方都建议：一个任务、一条终端时直接用 CLI 更省。
  • 性能有争议但证据单薄：一篇第三方文章（经 Medium 转载）称同一仓库调查任务 Codex 约 4 分 35 秒、T3 Code 15 分钟以上，属单一二手来源，本页标注未独立核实；仓库内确有性能回归检查文档，说明官方在处理性能，但这不是对上述数字的复核。
  • 其他边界条件：Antigravity 即使在 Full access 下仍可能发起原生审批请求；一个已记录的 issue 说明 macOS 的 TCC 权限问题会同时打断 Claude 与 Codex（workaround 之一是不要用 Full access）；移动端与远程都要求宿主机常开且可达，官方文档原文即写「那台机器必须保持运行与可达」。

价格与许可

  • MIT 许可，应用免费，无付费档、无席位费；T3 Connect 官方免费，无需自建端口转发。核验于 2026-10-12：GitHub API 的 license 字段为 MIT，仓库 LICENSE 首行为「MIT License」（版权声明归 T3 Tools Inc.），下载页标注「MIT licensed」，创始人 2026-07-29 的公开声明为「仍然 100% 免费、仍然 100% 开源」。
  • 真实成本在你选择的编码智能体上：各 provider 自己的订阅或 API 计费，并发 N 路约 N 倍消耗；T3 Code 的 Usage 页只估算「API 等价成本」，不等于账单。
  • 存在未来收费的可能性：第三方对创始人直播的转述称，可能做「打包多个模型与其 harness 的订阅」，但优先级很低；同一来源称 T3 Code 迄今花费约 18.5 万美元（主要是 Julius 的薪水）、不盈利，创始人本人的时间未计价。二者均为第三方转述，本页未逐条核对直播原文。

价格历史

日期 方案 变化 来源
2026-10-12 应用与 T3 Connect 均 $0（MIT） 首次记录基线 GitHub 仓库、下载页

替代方案

  • Stably Orca：同主题的桌面 ADE。它把每任务一个 worktree、diff 评审与移动伴侣做进产品，默认同样预填跳过权限的参数；要的是「图形化的并行与评审」而不是「跨 provider 的统一控制面与手机审批」时，Orca 更直接。
  • Herdr：终端内的 agent runtime，保留真实终端与持久 PTY、把状态汇总到侧栏，不做隔离也不做评审。痛点若只是「不知道哪个智能体卡住了」，且不想引入服务器层与 Electron 应用，Herdr 更轻。
  • Codex 官方桌面应用、Conductor、Claude Desktop、Cursor Glass：README 自陈的灵感来源，也是它自认未达标的对照组；其中 Codex 应用与 Claude Desktop 只服务自家 harness。本区暂无笔记。
  • cmux 等终端工作区应用：把真实终端与浏览器组织成工作区，但不理解 provider 事件；与 T3 Code 属不同层次，可以并存。本区暂无笔记。
  • 直接使用 provider CLI：一次性任务、已经处在正确的终端里、或需要该 provider 最新原生功能时，官方与第三方都建议不要绕这一层。

适用建议

  • 需要「离开工位仍能推进，并能在手机上查看与批准」、同时用两个以上 provider、且仓库在自己机器上：T3 Code 的服务器所有权与统一控制面正是为此设计。
  • 上第一个项目前先把默认权限从 Full access 改掉（改环境默认或用项目覆盖），并把机器级隔离交给容器、VM 或 SSH 沙箱；把 worktree 当安全边界是不够的。
  • 需要行级 diff 评审与 worktree 隔离、偏好图形应用：选 Orca；只需要终端里的状态汇总：选 Herdr；两者的定位可以叠加——Herdr 管终端与进程状态，T3 Code 管会话与跨设备。
  • 不接受 alpha 与高频变动时：重要节点及时 commit 与 push，不要让唯一副本躺在未提交的 worktree 里；夜间版与正式版不要混用客户端（官方文档写明商店版无法连接夜间版环境）。
  • 在意遥测：启动服务器前设 T3CODE_TELEMETRY_ENABLED=false，或把诊断改接到自建 OTLP 接收端。
  • 需要托管云 worker：目前没有（相关提案以 not_planned 关闭），只能自己租机器跑 t3 serve，再用 T3 Connect 或 SSH 接入。
  • 若同时使用 Hermes Agent：T3 Code 可以经由 MCP 让外部智能体驱动它的环境；本区未核验 Hermes 与 T3 Code 的具体集成状态。

变更记录

  • 2026-10-12：创建。收录官方定位与形态、provider 与账号模型、远程访问与 T3 Connect 的信任边界、权限模式与默认值、遥测与许可、仓库与版本状态、alpha 与贡献政策、性能争议与第三方计数器不一致，以及它在主题内的定位。

相关知识

  • 智能体编排：本页所属主题入口，说明收录边界与成员清单。
  • 智能体编排比较：本页与 Herdr、Stably Orca 的横向矩阵，重点写隔离模型、权限默认值与状态所有权。
  • Herdr：同主题条目；同样面向「监督多个编码智能体」，但它把持久化与状态放在终端里，不做隔离与评审，也没有自己的服务器层。
  • Stably Orca：同主题条目；Orca 把 worktree 隔离与 diff 评审做进产品，与 T3 Code 的「统一控制面 + 跨设备」是同一问题的不同切法。
  • 个人 AI 智能体：面向个人日常任务的常驻智能体，与本主题这类面向开发者的编码编排工具形成对照。
  • 知识库：全部主题的索引。

参考来源

  • pingdotgg/t3code（GitHub 仓库）：自称「agent harness control surface」、支持的 provider 与安装方式、基本不接受贡献的说明；star / fork / issue / 创建与推送时间、贡献者数用 GitHub API 于 2026-10-12 核验（27,020 star、7,094 fork、2,552 open issues、创建 2026-02-08、最近推送 2026-10-12、license MIT）；最新 release 用 releases 端点核验（v0.0.45 发布于 2026-10-02，另有 v0.0.46-nightly.* 与 0.0.46-preview.* 预发布）。
  • 仓库内置文档 docs/：本页多数官方事实的出处，逐份读取于 2026-10-12——user/install.md（8 个 provider 的安装与登录命令、平台限制、Intel Mac 无 t3 可执行文件）、user/permission-modes.md（四档模式、初始默认 Full access、各 provider 的差异与退回询问）、user/project-settings.md（worktree 位置与分支命名默认前缀 t3/、计划任务、webhook 自动化、存储清理策略）、user/source-control.md（7 家托管平台、三档 diff、PR stack、Review guide、watch PR）、user/remote-access.md（T3 Connect、配对、Tailscale、SSH、多路由与负载均衡、作用域与撤销）、user/usage.md（跨 provider 用量与额度池）、user/telemetry.md（PostHog 默认收集与关闭变量、OTLP 导出）、user/outside-agents.md（MCP 反向驱动、默认只读）、internals/overview.md（本地服务器持有的所有权边界、checkpoint 用隐藏 git ref）、internals/t3-connect.md（中继是可信代理、Clerk / Cloudflare / PlanetScale、空闲隧道回收）、internals/providers.md（进程与账号隔离、provider 更新归属）、internals/glossary.md（environment / project / worktree / thread / turn 定义）、orchestration-v2/README.md（编排层重写目标与「不考虑向后兼容」的声明）。README 明确写「完整文档在 docs/，还没有文档站点」。
  • T3 Code 官网：定位、provider 列表、一键 commit / push / PR 与 fork 说明，以及首页计数器（2026-10-12 读取时写「超过 40 万开发者」，同日另一份快照读到 500,000）。
  • 下载页：平台与打包矩阵、MIT licensed 标注、页脚「24k+ GitHub stars」的计数器读数。
  • 隐私政策（生效与更新 2026-10-06）：默认收集的匿名产品用量数据与关闭方式、第三方服务商名单（Clerk、Cloudflare、PlanetScale、Vercel、PostHog、Axiom、Expo、Apple、Google）、不用于训练模型、联系方式。
  • 安全政策（生效 2026-07-15）：漏洞报告渠道（security@ping.gg）、数据最小化与凭据保护的表述，以及「你的责任」一节（保持更新、多因素认证、按需授权、在应用或执行前审阅智能体输出）——与官方把安全责任留给使用者的定位一致。
  • 服务条款（生效 2026-07-15）：T3 Connect 属可选服务、账号要求，以及「我们不控制第三方 provider 的可用性、兼容性、定价与行为」的免责表述；页脚计数器的另一处读数（22k+）。
  • Docker Docs：Connect T3 Code to a sandbox：T3 Code 没有专用沙箱集成、把沙箱当 SSH 主机、Linux 侧需要编译工具链；同页记录 turn/setPermissionMode failed 与默认 Full access 的映射——本页「机器级隔离要自己搭」的第三方依据。
  • A deep dive into T3 Code（Flavio Copes）：第三方深度实测——worktree「不保护你电脑的其余部分」、四档权限的实际行为、三档 diff、checkpoint 与还原、远程认证流程（配对令牌换取约 5 分钟的 WebSocket 票据，bearer 会话 30 天，DPoP 会话约 1 小时）、用量页口径、与 cmux 和 Herdr 的对照表，以及「哪些情况不该用它」。
  • T3 Code: An Open-Source GUI for Managing AI Coding Agents（Better Stack）：早期功能走查（三栏布局、worktree、diff 查看器、内嵌终端、快速动作、性能观感）。其 provider 状态（Claude 支持待合并）是 2026-03 的旧快照，本页不采用该部分。
  • T3 Code review: the open-source agent control plane, tested（Continuum）（2026-08-19）：第三方复核——「没有成本或配额账本」的说法（此后官方已提供 Usage 与 Limits，属过时）、约 19,500 star 与 v0.0.34 的旧快照，以及 Linux 与 Android 客户端在同类中少见。
  • What is T3 Code?（Continuum）：平台矩阵，以及「缺的是结构性能力：无模型访问、无凭据管理、无团队、无 SSO、无账单、无支持合同」的第三方归纳；其「官网称超过 10 万开发者」是 2026-08 的计数器读数。
  • T3 Code vs Codex: Is the Free GUI Actually Better?（Medium）：性能争议的唯一来源（同一仓库调查任务 Codex 约 4 分 35 秒、T3 Code 15 分钟以上），本页标注为单一二手来源、未独立核实；其「Claude Code 支持即将到来」同样属旧快照。
  • T3 Code Cloud: VPS Setup & a Cloud-First Alternative（Replicas）：T3 Connect 免费、不代跑智能体、「托管可丢弃云 worker」请求被关闭，以及宿主机器必须自己保持运行与可达的第三方整理（与本页对 GitHub issue #14620 的核验一致）。
  • pingdotgg/t3code issue #14620：托管一次性云 worker 提案以 not_planned 关闭（2026-10-12 核验）；同批检索到的 #14793（通过外部 sandbox broker 的按需云任务环境）状态为 completed。
  • Google Play：T3 Code：移动端定位（远程控制伴侣应用、配对码与 T3 Connect、可发起运行、浏览文件、版本控制、评审 diff、终端）与 2026-10-12 的商店读数（4.2 星、35 条评价、10K+ 下载、最后更新 2026-10-03）。
  • T3 Code SwiftUI beta（TestFlight）：原生 SwiftUI 重写测试版的说明（直连配对与 T3 Connect、多环境任务、模型选择、审批、diff 与终端）。
  • Theo（@theo）2026-07-29 公告：iOS 与 Android 版本上线，以及「仍然 100% 免费、仍然 100% 开源」的原文表述。
  • Theo 直播转述（BigGo Finance）：T3 Tools Inc.（YC 背景，旗下含 T3 Chat）与 T3 Content LLC 的区分、约 18.5 万美元投入与不盈利的说法、未来可能做打包订阅。均为第三方对直播的整理。
  • 未采用：聚合目录给出的 star 快照（26.3K，与本页 GitHub API 读数不一致），以及各类自动生成的文档镜像（Mintlify 预览站、t3codedocs.com、agentwikis.com）——它们不在官方仓库内，无法确认维护者与时效，本页只采用官方仓库内的 docs/。