项目能做什么
使用说明 查看原始 README 原仓库文档
项目简介
T3 Code 是一个“Agent 调度控制面板(agent harness control surface)”。它允许开发者通过移动端(iOS / Android)、Web 端以及基于 Electron 的桌面端,统一控制和操作本机上运行的各种 AI Agent。
该项目受 Codex 桌面端、Conductor、Claude Desktop 和 Cursor Glass 等工具启发,旨在提供高性能、支持远程访问且完全开源的 Agent 交互体验。
核心功能
- 多端控制:支持 iOS、Android 移动端 App,本地/网页端 Web 应用(
app.t3.codes),以及 Electron 桌面端。 - 跨平台 Agent 联动:兼容并复用你在各大平台的现有订阅。只要你的电脑上配置好了以下 Agent,T3 Code 就能直接接管与控制:
- Claude Code
- Codex
- Cursor
- Grok Build
- OpenCode
- Google Antigravity
- fx
- 支持后台运行与远程连接:支持注册为系统后台服务,便于从手机或其他电脑远程访问本地 Agent。
适合谁用
适合日常重度使用 Claude Code、Cursor、Codex 等 AI 编程 Agent,并希望摆脱单一终端限制,在电脑桌面端、网页或手机移动端统一查看、调度和远程控制这些 Agent 的开发者。
安装步骤
前置要求(重要)
使用前必须在电脑上安装并完成至少一个 Agent 服务的认证登录:
- Codex:安装 Codex CLI 并运行 codex login
- Claude:安装 Claude Code 并运行 claude auth login
- Cursor:安装 Cursor CLI 并运行 agent login
- Grok Build:安装 Grok Build CLI 并运行 grok login
- OpenCode:安装 OpenCode 并运行 opencode auth login
- Antigravity:在软件的 Settings 中开启,点击 Install Antigravity 并完成 Sign in with Google(无需安装 CLI)
- fx:在运行 T3 Code 服务的机器上安装 fx 并运行 fx login
1. 命令行方式安装
macOS / Linux:
curl -fsSL https://t3.codes/install.sh | sh
Windows(PowerShell):
irm https://t3.codes/install.ps1 | iex
快速体验(免预先安装):
npx t3@latest
常用运行命令:
t3 # 启动本地服务并打开 Web 界面
t3 service install # 安装为后台常驻服务
t3 update # 更新到最新版本
t3 --help # 查看完整命令帮助
2. 桌面客户端安装
可直接前往 GitHub Releases 下载安装包,或通过系统包管理器安装:
- macOS (Homebrew):
bash brew install --cask t3-code - Windows (winget):
bash winget install T3Tools.T3Code - Windows (Scoop):
bash scoop install extras/t3code - Debian / Ubuntu (
.deb): 从 GitHub Releases 下载.deb文件后执行:bash sudo apt install ./T3-Code-*.deb - Arch Linux (AUR):
bash yay -S t3code-bin # 稳定版 yay -S t3code-nightly-bin # Nightly 版 - Nix (nixpkgs):
bash nix profile add github:NixOS/nixpkgs/nixos-unstable#t3code
配置说明
此部分原文未在 README 中直接展开,详细配置请参阅仓库内 docs/ 文档:
- 权限模式配置:docs/user/permission-modes.md
- 快捷键自定义:docs/user/keybindings.md
- 项目级配置:docs/user/project-settings.md
- 外观与主题:docs/user/appearance.md
- 手机/跨设备远程连接配置:docs/user/remote-access.md
- 通过 MCP 接入其它 Agent:docs/user/outside-agents.md
常见问题
- 项目稳定性:目前项目处于极早期阶段,可能存在较多 Bug。
- 关于代码贡献:当前官方基本不接受大型功能的 PR,仅会考虑合并少量小型修复(Small fixes)。
- 具体问题排查:此部分原文未在 README 中罗列问答清单,遇到问题请参阅官方 FAQ 文档 或加入官方 Discord 社区寻求支持。
原始 README 摘录(英文原文,节选前 3000 字符)
# T3 Code T3 Code is an "agent harness control surface". It enables control of the agents on your machine with a best-in-class mobile app ([iOS](https://apps.apple.com/us/app/t3-code-remote-claude-more/id6787819824), [Android](https://play.google.com/store/apps/details?id=com.t3tools.t3code)), [web app](https://app.t3.codes) and [Electron-based desktop app](https://t3.codes). Works with your subscriptions on Claude Code, Codex, Cursor, Grok Build, OpenCode, Google Antigravity, and fx. If they're set up on your computer, T3 Code can control them. ## "Wait, what are you selling me?" Nothing. We built T3 Code because we wanted the best possible development experience with agents. We were inspired by existing solutions like the Codex desktop app, Conductor, Claude Desktop and Cursor Glass, but none met our bar. We wanted something performant, remote-ready, and truly open. If we ever go the wrong direction, we want you to have everything you need to fork and build the editor that you want. ## Installation > [!WARNING] > T3 Code currently supports Codex, Claude, Cursor, Grok Build, OpenCode, Antigravity, and fx. Install and authenticate at least one provider before use: > > - Codex: install [Codex CLI](https://developers.openai.com/codex/cli) and run `codex login` > - Claude: install [Claude Code](https://claude.com/product/claude-code) and run `claude auth login` > - Cursor: install [Cursor CLI](https://cursor.com/cli) and run `agent login` > - Grok Build: install [Grok Build CLI](https://x.ai/cli) and run `grok login` > - OpenCode: install [OpenCode](https://opencode.ai) and run `opencode auth login` > - Antigravity: enable it in Settings, then use **Install Antigravity** and **Sign in with Google**. No CLI is required. > - fx: install [fx](https://fx.sh) and run `fx login` on the machine running the T3 Code server ([setup guide](./docs/user/providers-fx.md)) ### Command line ```bash curl -fsSL https://t3.codes/install.sh | sh ``` On Windows, in PowerShell: ```powershell irm https://t3.codes/install.ps1 | iex ``` Then run `t3` to start the server and open the local web app. `t3 service install` keeps it running in the background, `t3 update` moves to a newer release, and `t3 --help` has the full reference. To try it once without installing, run `npx t3@latest`. It offers to install the `t3` command for you. ### Desktop app Install the latest version of the desktop app from [GitHub Releases](https://github.com/pingdotgg/t3code/releases), or from your favorite package registry: #### Windows (`winget`) ```bash winget install T3Tools.T3Code ``` #### Windows (`scoop`) ```bash scoop install extras/t3code ``` #### macOS (Homebrew) ```bash brew install --cask t3-code ``` #### Debian, Ubuntu (`.deb`) Download the `.deb` from [GitHub Releases](https://github.com/pingdotgg/t3code/releases), then: ```bash sudo apt install ./T3-Code-*.deb ``` #### Arch Linux (AUR) Stable: ```bash yay -S t3code-bin ``` Nightly: ```bash yay -S t3code-ni阅读完整原文
商业机会分析 AI 生成
托管式安全中继与远程控制服务(T3 Cloud Relay)
| 产品构想 | 针对移动端(iOS/Android)远程连接本地开发机的网络穿透痛点,提供零配置、端到端加密的低延迟中继和推送告警服务 |
| 核心功能 | 一键扫码配对网络、端到端加密控制通道、代码生成完成/需要确认时的移动端系统级Push通知、断线自动重连 |
| 目标用户 | 有移动端远程控制本地Agent需求但无公网IP/不愿折腾Tailscale等组网工具的个人开发者 |
| 难度/周期 | 中等 · 1-2个月 · 成本:中继服务器带宽与流量费用、域名与APNs/FCM推送网关维护成本 |
| 收费模式 | 免费提供基础限速通道,按月订阅(如 $5-10/月)提供高速专属通道与多设备无限连接 |
| 竞争风险 | 官方未来可能推出官方免费中继服务;自建内网穿透工具(如Tailscale/Cloudflare Tunnel)存在替代性(推测) |
| 依据 | 已验证事实 |
企业级Agent安全网关与操作审计插件(T3 Gateway for Teams)
| 产品构想 | 在T3 Code之上构建组织级代理,统一管理多模型Provider权限、拦截危险终端命令、记录代码变更与审计日志 |
| 核心功能 | 统一SSO认证与权限模式下发、高危Shell指令拦截与双人审批流、团队级API Key与费用配额分发、敏感数据(Secret)自动脱敏 |
| 目标用户 | 允许员工使用AI Agent但对源码泄露与越权高危操作有合规要求的研发团队与CTO |
| 难度/周期 | 高 · 2-3个月 · 成本:主要为开发与安全测试成本,初期服务器成本极低 |
| 收费模式 | 按团队席位收费(如 $15-30/席位/月)或私有化部署买断许可 |
| 竞争风险 | 仓库目前未开放完整商业化许可及生态插件机制,接入层可能随上游更新发生破坏性变化(推测) |
| 依据 | 数据支持的判断 |
跨Agent自动化任务编排流(Multi-Agent Recipe Hub)
| 产品构想 | 利用T3 Code聚合多Agent的特性,提供开箱即用的工作流模板,实现多Agent串联协作(例如:Codex写模块、Claude重构、Cursor找Bug) |
| 核心功能 | 可视化多Agent串行/并行调度编排、错误自动重试并切换备用Agent模型、自动化CI/CD钩子联动 |
| 目标用户 | 追求高自动化产出的独立开发者、开源项目维护者、自动化测试工程师 |
| 难度/周期 | 中等 · 1-2个月 · 成本:开发与工作流测试Token消耗,维护社区模板库的轻量服务器 |
| 收费模式 | 增值工作流模板市场交易抽佣,高级编排调度引擎订阅制 |
| 竞争风险 | 底层CLI更新可能导致命令输出解析失败;用户编写复杂工作流的意愿需市场验证(推测) |
| 依据 | 尚需验证的假设 |
竞品与相似项目 GitHub Search 真实检索
| 项目 | 中文简介 | Stars | 语言 |
|---|---|---|---|
| maria-rcks/t1code | 在终端中运行的 T3 Code 版本。 | 544 | TypeScript |
| Deepusleepy/t3-tots | 专为 T3 Code 打造的 Grok Bot 伴侣助手。 | 131 | JavaScript |
| erfnzdeh/t3code-atlas | pingdotgg/t3code 的非官方交互式等轴测架构图。 | 83 | HTML |
| goat-si/goat | 基于 T3 Code 的分支,可跨机器统一控制 Claude Code、Cursor 等。 | 72 | TypeScript |
| zortos293/t3code-copilot | 增加了 GitHub Copilot 支持并与上游保持同步的 T3 Code。 | 58 | TypeScript |
| maria-rcks/t4code | 用于通过 Tailscale tailnet 网络暴露 T3 Code 的启动器。 | 50 | TypeScript |
项目优势与风险
| 技术成熟度 | 创建于 ,最近推送 ,发布过 100 个 Release |
| 社区活跃 | Star 56,653 / Fork 0 / Issue 0(数据支持,可自行核实) |
| 许可证 | 未检测到(需人工确认) |
| 主要风险 | 上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价 |
安装与使用
git clone https://github.com/pingdotgg/t3code.git cd t3code # 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)