T3 Code 简介

T3 Code 是一个"智能体控制面（agent harness control surface）"，用于统一管理本机已安装的多种 CLI 编程智能体。它配套提供移动端（iOS / Android）、Web 端与基于 Electron 的桌面应用，通过这些界面远程操控本地代理。

支持的智能体

T3 Code 可控制以下已在本机完成登录的编程代理（Agent）订阅：

• Codex：安装 Codex CLI 后执行 codex login
• Claude Code：安装 Claude Code 后执行 claude auth login
• Cursor：安装 Cursor CLI 后执行 agent login
• Grok Build：安装 Grok Build CLI 后执行 grok login
• OpenCode：安装 OpenCode 后执行 opencode auth login

至少需要完成其中一个 provider 的安装与认证才能使用。

项目动机

项目作者表示 T3 Code 完全是出于自用需求而构建，目的是获得更高质量的代理开发体验。灵感来源于 Codex 桌面应用、Conductor、Claude Desktop 与 Cursor Glass 等同类产品，但这些方案在性能、远程访问能力与真正开源等方面均未达到其要求。作者强调 T3 Code 走的是"高性能、可远程访问、真正开源"的路线，并承诺即使将来方向有变，用户也能 fork 后自行改造。

安装方式

无需安装的试用方式

最快捷的体验方式是在终端运行（要求 Node.js 22.16+、23.11+ 或 24.10+）：

npx t3@latest
# 该命令会在本机启动 T3 Code 后端服务，并打开本地 Web 控制台

可通过 npx t3@latest --help 查看完整 CLI 参考。

桌面应用安装

也可下载安装桌面端：GitHub Releases 提供最新版本。包管理器安装命令如下：

# Windows：使用 winget
winget install T3Tools.T3Code

# macOS：使用 Homebrew
brew install --cask t3-code

# Arch Linux（AUR）
# 稳定版
yay -S t3code-bin
# 尝鲜版
yay -S t3code-nightly-bin

AUR 打包脚本位于仓库 packaging/aur 目录下。

文档索引

完整文档保存在 docs/ 目录（暂无独立文档站点），用户文档涵盖以下主题：

• 安装与首次运行（docs/user/install.md）
• 权限模式（docs/user/permission-modes.md）
• 键盘快捷键（docs/user/keybindings.md）
• 项目图标自定义（docs/user/project-settings.md）
• 通过手机或其他机器远程访问（docs/user/remote-access.md）
• 桌面端与服务器版本同步策略（docs/user/updating.md）
• 源码控制集成（docs/user/source-control.md）
• 多账号配置：Codex、Claude
• Linux 上以后台服务方式运行

若需要从源码构建，请阅读 docs/internals/overview.md。

参与开发

项目目前处于非常早期阶段，基本不接收外部贡献，仅可能考虑少量小型修复。请在提交 PR 或报告 Bug 前阅读 CONTRIBUTING.md。

构建环境使用 Vite+，需先安装全局 vp 命令行工具：

# macOS / Linux
curl -fsSL https://vite.plus | bash

# Windows
irm https://vite.plus/ps1 | iex

随后在仓库根目录执行 vp i 安装依赖。更多细节参见 Vite+ 官方入门指南。