T3 Code

项目定位

T3 Code 是一个"代理控制面板"，可在本机统一调度多种编程代理工具，并通过 iOS、Android、Web 与 Electron 桌面端进行远程或本地操作。目前兼容的代理包括 Claude Code、Codex、Cursor、Grok Build、OpenCode 与 Google Antigravity，只要这些工具在本机完成登录认证，即可被 T3 Code 接管。

设计初衷

项目本身不进行任何商业推广。作者团队希望打造一个高性能、支持远程访问、并且真正开源的代理编辑器，借鉴了 Codex 桌面版、Conductor、Claude Desktop、Cursor Glass 等已有方案，但认为它们均未达到要求。为此在架构上保留足够的可扩展性，以便用户在项目方向偏离时能够方便地 fork。

安装方式

前置条件

在安装前，至少需要完成以下一种代理的登录：

• 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：在设置中启用，通过 Install Antigravity + Sign in with Google 完成登录，无需 CLI

命令行安装

macOS / Linux：

curl -fsSL https://t3.codes/install.sh | sh

Windows（PowerShell）：

irm https://t3.codes/install.ps1 | iex

安装完成后可使用以下子命令：

• t3：启动服务并打开本地 Web 界面
• t3 service install：将服务注册为后台常驻进程
• t3 update：升级到最新版本
• t3 --help：查看完整命令参考

如果只想临时试用而不写入系统，可直接执行 npx t3@latest。

桌面应用

桌面端可从 GitHub Releases 下载，也支持各平台包管理器：

平台	安装命令
Windows (winget)	winget install T3Tools.T3Code
Windows (scoop)	scoop install extras/t3code
macOS (Homebrew)	brew install --cask t3-code
Debian / Ubuntu	从 Releases 下载 .deb 后 sudo apt install ./T3-Code-*.deb
Arch (AUR) 稳定版	yay -S t3code-bin
Arch (AUR) 每日构建	yay -S t3code-nightly-bin

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

文档与使用指南

完整文档位于 docs/ 目录，覆盖以下主题：

• 安装与首次启动
• 权限模式
• 键盘快捷键
• 项目设置
• 外观偏好
• 通过手机或其他机器进行远程访问
• 通过 MCP 连接 Claude Code、Codex、ChatGPT 等外部代理
• 应用与服务的版本同步更新
• 源码管理集成
• 多账号管理（Codex、Claude）
• 后台服务运行方式

需要从源码构建或了解内部架构时，可从 docs/internals/overview.md 开始阅读。

贡献说明

项目目前处于非常早期的阶段，可能存在较多缺陷。团队暂不接受大型特性贡献，仅酌情合并小型修复。如确需参与开发：

1. 安装 Vite+ 全局 CLI vp：

bash # macOS / Linux curl -fsSL https://vite.plus | bash # Windows irm https://vite.plus/ps1 | iex

2. 安装项目依赖：

bash vp i

提交 Bug 或 PR 之前请先阅读 CONTRIBUTING.md。功能建议可前往 GitHub Discussions 的 Ideas 板块；技术支持请加入 Discord 社区。