简介

T3 Code 是一个开源的编码代理（Coding Agent）统一控制台，定位为面向本机智能体的控制平面。它不替代具体的 AI 编程工具，而是作为架构中的胶水层，将多个命令行形态的 AI 助手集中管理。项目由 pingdotgg 团队开发（GitHub 仓库：pingdotgg/t3code，官网：t3.codes），采用 TypeScript 重写全链路协议与前端交互，遵循 MIT 许可证。其核心价值在于解决多代理环境下的上下文割裂、认证重复和交互分散问题，提供网页端、移动端（iOS/Android）和 Electron 桌面端的统一访问入口。开发者只需在本地运行一次服务，即可通过任意客户端远程或本地调度已配置的代理实例，实现从自然语言指令到代码提交的端到端可视化管理。

核心定位与功能

T3 Code 的本质是代理编排器（Agent Orchestrator）。它本身不提供模型推理能力，也不转售 Token 或设置配额上限，而是通过本地服务器连接已安装并完成认证的 CLI 工具，将其能力标准化后暴露给前端界面。 支持的主流代理包括 Claude Code、Codex CLI、Antigravity、OpenCode、Cursor 和 Grok。每个代理保持独立的订阅与密钥，T3 Code 仅负责会话路由、权限桥接与状态追踪。 核心功能聚焦于工程落地提效：

• 统一会话管理：所有代理任务以“线程（Thread）”形式组织，记录使用的模型、执行目录、标准输入输出流及审批日志。PTY 进程级上下文隔离确保每个实例独占终端环境。
• 一键版本控制：每个代理线程自动隔离到独立 Git 分支。任务完成后，界面提供单按钮操作，自动生成 PR 标题、正文与变更日志，并直接推送至 GitHub。支持草稿 PR、堆叠 PR 与 amend 操作。
• 跨端无缝接入：本地启动服务后，可通过手机浏览器、iOS/Android App 或桌面端 Electron 应用实时查看终端输出、中断进程或下发新指令。无需依赖物理终端窗口，彻底改变传统 CLI 的碎片化体验。
• 高度可定制：源码完全开放，支持二次分叉。开发者可替换 UI 组件、接入自定义工具链或修改底层通信协议，将其作为内部低代码平台或自研 Agent 控制中枢的基础。

安装部署

T3 Code 的安装分为服务端（CLI 守护进程）与客户端（GUI 入口）两部分。服务端负责建立本地 API 网关与进程调度，客户端负责渲染交互界面。以下为标准部署路径。

前置条件：

1. 系统需安装 Node.js（建议 LTS 版本）与 npm 包管理器。
2. 目标机器上已至少安装并登录一个受支持的代理（如执行 claude auth login 或 codex login）。Antigravity 需在设置中启用并通过 Google 账号完成鉴权。

服务端安装：

bash
# 方式一：全局安装（推荐用于长期运行与后台驻留）
npm install -g t3code
# 将服务注册为系统守护进程，开机自启且脱离终端存活
t3 service install

bash
# 方式二：一次性试用（无需全局安装，临时验证）
npx t3@latest

客户端获取：

• Electron 桌面端：前往 GitHub Releases 页面下载对应系统的安装包（macOS / Windows / Debian/Ubuntu / Arch Linux / Nix）。
• 移动端：iOS 用户可在 App Store 搜索 T3 Code Remote Claude More；Android 用户可在 Google Play 搜索 com.t3tools.t3code。
• Web 端：服务端启动后，默认监听本地端口，直接在浏览器访问控制台地址（具体端口以实际启动日志为准）。

使用步骤

完成安装与服务启动后，按以下流程接入代理并执行任务。

1. 启动本地服务 → 终端执行 t3 命令，服务将在后台拉起并自动打开默认浏览器进入控制台首页。
2. 配置代理凭证 → 在控制台设置面板中，选择目标代理，填入对应的环境变量或调用官方 CLI 完成鉴权。系统会自动检测本地可用工具链并显示连接状态。
3. 创建任务线程 → 点击新建线程，指定工作目录与初始代理。界面会分配独立沙箱环境，所有文件读写与命令执行均在该目录下进行，互不干扰。
4. 下达指令与监控 → 在聊天框输入自然语言需求。代理会通过标准 I/O 流返回执行结果，界面同步渲染终端输出、文件变更预览与审批请求。支持 Ctrl+C 中断、历史命令调取与日志过滤。
5. 提交代码变更 → 任务确认无误后，点击界面上的 Commit & Push 按钮。系统自动创建分支、生成 PR 描述并提交至关联仓库。支持内联 Diff 审查后再执行推送。
6. 跨设备接管 → 若需在其他设备继续调试，保持服务端运行，在另一台设备的浏览器或 App 中输入同一局域网 IP 与端口即可直连控制台，无需额外隧道配置。

日常维护命令：

bash
# 更新 T3 Code 核心服务与依赖
t3 update
# 查看当前运行的代理列表、端口占用与进程状态
t3 status
# 停止后台守护进程
t3 service stop

限制与边界

T3 Code 并非万能型 IDE 或模型提供商，其设计哲学决定了明确的适用边界。

• 早期阶段特性：项目目前处于快速迭代期，部分高级编排逻辑、长上下文缓存或复杂权限隔离机制可能尚未完善。生产环境使用前，务必先在测试项目中验证连接稳定性与故障恢复流程。
• 强依赖本地代理：T3 Code 仅做路由与展示，不托管 Token 或转售配额。若本机未正确安装或认证底层 CLI 工具，控制台将无法发起任何请求。各代理的鉴权方式、网络策略与沙箱限制仍由原厂商决定。
• 远程访问限制：官方文档未完整公开企业级身份认证、VPC 隔离或审计日志方案。跨公网访问需自行配置反向代理或防火墙规则，网络拓扑与安全性由使用者自行承担。
• 贡献策略收紧：README 明确说明目前主要不接受外部贡献，大型功能请求通常不会被合并。若需深度定制，建议直接 Fork 仓库并在本地分支开发。
• 资源占用考量：同时挂载多个代理线程时，Node.js 进程与子进程并发会显著增加内存占用。建议在配置较低的机器上限制并发线程数，避免 OOM 导致服务崩溃。

部署与使用 T3 Code 的核心在于理解其“控制台而非引擎”的定位。它适合需要频繁切换不同 AI 编程助手、追求统一工作流视图的开发者，以及希望从终端解放出来但保留完整 Shell 能力的工程团队。对于仅需单一模型辅助或依赖重度图形化 IDE 的场景，该工具并非最优解。以官方仓库的最新版本为准，结合具体业务环境进行灰度验证，方能发挥其最大效能。