
T3 Code 安装与上手指南用一套控制面调度本机全部 Coding Agent【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3codeT3 Code 是一个开源的 agent harness control surface智能体操控台它本身不运行模型而是统一调度你本机已经装好的 Claude Code、Codex、Cursor、Grok Build、OpenCode、Google Antigravity 等 agent CLI并通过移动端、Web 端与 Electron 桌面端对它们进行远程控制。本文以仓库根目录 README.md 为骨架结合 docs/user/install.md 与 docs/internals/overview.md 等文档完整梳理从零安装、Provider 配置、远程访问到源码构建的完整链路读完即可在一台机器上把 T3 Code 跑起来并接上任意已登录的 agent。项目定位控制面Control Surface而非新的 AgentT3 Code 的核心定位在 README.md 中一句话讲清agent harness control surface。它不替代任何一家模型厂商而是做控制这件事——把运行在你自己电脑上的 agent 进程含其终端、Git、项目文件与 Provider 凭证统一纳入一个可远程操作的控制面。README 明确提到它支持与 Claude Code、Codex、Cursor、Grok Build、OpenCode、Google Antigravity 的订阅配合使用只要这些 CLI 在你的电脑上完成安装和登录T3 Code 就能控制它们。这一点在 docs/internals/overview.md 中体现为一条关键架构原则执行始终留在拥有工作区的环境里。Web、桌面、移动客户端通过经过认证的 RPC 控制环境远程客户端永远不能用自己的文件系统、Provider 凭证或机器状态去替代环境的。桌面应用虽然内置了一个 server但它的渲染进程同样遵循这条边界——也就是说无论你从手机还是浏览器接入真正跑代码、跑 agent 的始终是那台装有 Provider 的机器。从仓库结构也能印证这一设计多端共享的连接与领域状态集中在 packages/client-runtimeRPC 契约定义在 packages/contracts/src/rpc.ts而 Web / 桌面 / 移动端只是提供平台服务与 UI。Provider 特有行为则被抽象在 adapter 之后编排层只处理归一化后的命令与事件。安装前须知先装好一个 Provider[!WARNING] T3 Code 目前支持 Codex、Claude、Cursor、Grok Build、OpenCode、Antigravity 六家。使用前至少要安装并认证一个 Provider否则无法真正开启线程工作。各 Provider 的安装与认证方式来自 docs/user/install.md 的 Providers 小节仓库 README 中也有同样的表格Provider安装与认证命令Codex安装 Codex CLI运行codex loginClaude安装 Claude Code运行claude auth loginCursor安装 Cursor CLI运行agent login注意可执行文件名为cursor-agentGrok Build安装 Grok Build CLI运行grok loginOpenCode安装 OpenCode运行opencode auth loginAntigravity无需 CLI直接在 T3 Code 的 Provider 设置中启用 Install Antigravity 并 Sign in with Google几个关键实操细节PATH 问题Provider CLI 必须在 server 所在机器的PATH中。如果 T3 Code 找不到某个 CLI可以在 Provider 设置里手动指定Binary path——尤其在使用版本管理器如 nvm时常见。Antigravity 比较特殊可以使用其托管运行时而不依赖PATH。升级提示当 Provider CLI 落后于最新版本时其卡片会显示可用版本。Update now 按钮只在 T3 Code 能识别该 CLI 的安装归属自己的更新命令、Homebrew、全局 npm/pnpm/bun 或 Vite 安装时出现否则请按你当初安装的方式自行升级。多实例可以为一个 Provider 添加多个实例来隔离不同的账号或配置每个实例可配置独立的环境变量如 API Key、自定义 base URL并将机密值标记为 sensitive保存后 T3 Code 不再显示其原始值。一个多账号实战Codex 双实例Shadow Homedocs/user/providers-codex.md 给出了一个共享 Codex home 一个 shadow home的多账号方案让工作号与个人号可以在同一线程里延续会话# 第一个账号保持默认 ~/.codex # 第二个账号登录到全新目录 mkdir -p ~/.codex_personal CODEX_HOME~/.codex_personal codex login然后在Settings Providers中添加两个实例两者的CODEX_HOME path 必须相同个人号额外填写 shadow home 路径实例CODEX_HOME pathShadow home pathCodex Work~/.codex留空Codex Personal~/.codex~/.codex_personalshadow home 是 T3 Code 为共享状态准备的目录不要通过整目录复制来填充。shadow 账号需要自己的auth.json若 Codex 使用系统凭据存储则需为该方案配置文件存储。切换账号只需在线程的模型选择器里选另一个实例T3 Code 只会推荐共享同一 CODEX_HOME 的兼容实例。详细内容见 providers-codex.md。三种安装路径免安装体验、桌面应用与移动端免安装试跑推荐先试README 与安装文档一致推荐只要机器上有 Node.js要求22.16、23.11 或 24.10一行命令即可启动npx t3latest该命令会在本机启动 T3 Code 的后端 server同时打开本地 Web 应用来操控你的 agent。npx t3latest --help可查看完整 CLI 参考。值得说明的版本细节npx t3本身只需要 Node 来运行 npm而 CLI 安装下来的是一个自包含可执行文件Node.js 版本要求实际作用于 SSH 主机与 WSL 后端。由于 Node 无法为 Intel Mac 生成单文件可执行文件目前没有 Intel Mac 构建Intel 桌面应用不受影响在 Intel Mac 上运行独立 server 需从源码构建。桌面应用winget / Homebrew / AUR平台安装命令Windowswinget install T3Tools.T3CodemacOSbrew install --cask t3-codeArch Linux稳定版yay -S t3code-binArch Linux每日构建yay -S t3code-nightly-binAUR 打包脚本维护在仓库的 packaging/aur 目录下。桌面应用内置完整的 server 运行时安装后即可直接在应用内配置 Provider 与远程访问。WSL 后端与从终端打开项目WSL在Settings → Connections中选择一个 WSL 发行版agent 与项目就跑在里面。需要在发行版内部安装 Node.js 与 Provider CLIT3 Code 会在其中自动安装匹配版本的 server 运行时因此应用更新后的首次启动可能较慢。从终端打开项目桌面应用已在同一台机器运行时执行npx t3 app # 为当前目录打开一个新线程 npx t3 app ../my-project # 打开指定目录该命令依赖桌面应用独立 server 或 SSH 会话下不可用。如果命令无法到达应用请先启动或更新桌面应用再重试。移动端从 App Store 或 Google Play 安装移动应用后手机通过 T3 Connect 或配对 URL 连接到另一台机器上的 server完整流程见 docs/user/remote-access.md。如果应用启动崩溃在下次成功启动后打开Settings → Diagnostics其中列出了最近 7 天的启动崩溃报告含错误与组件堆栈复制后提交 GitHub issue 即可。连接远程机器T3 Connect、LAN 配对与桌面托管 SSHREADME 将远程就绪remote-ready列为项目的核心诉求仓库也确实提供了多条连接通道详见 docs/user/remote-access.mdT3 Connect云中继无需配置路由器端口转发。桌面端在Settings → Connections登录并启用命令行主机执行npx t3latest connect按指引登录。T3 Connect 会在不中断健康连接的前提下续期访问凭证PR diff 与 Provider 设置在旧凭证过期后依然可用。LAN/私网直连配对桌面端在Settings → Connections开启 Network access 并生成配对链接命令行主机用npx t3 serve --host private-ip启动或在已运行的情况下用npx t3 pair生成一次性链接手机扫码或粘贴 URL 即可接入。配对授权是持久化的但建议每个新设备使用新的一次性链接。Tailscale HTTPS两端加入同一 tailnet 后桌面端启用Tailscale HTTPS或命令行执行npx t3 serve --tailscale-serve/npx t3 pair --tailscale配对链接形如https://machine.tailnet.ts.net/。桌面托管 SSH在桌面端Settings → Connections → Add environment选择 SSH 并输入主机或别名如userexample.comT3 Code 会自动在该主机启动或复用 server 并建立端口转发项目、Provider 凭证与 agent 工作全部留在远程机器上。远程主机需要兼容的 Node.js 与 Provider 设置排查时可用ssh userexample.com sh -lc command -v node node --version验证非交互 shell 中的 Node 环境。多台机器时还可在Settings → Connections → Load balancing开启自动负载均衡为跨机器分组的项目新线程自动挑选负载合适的机器偏好值为 Normal / Prefer / Less often / Manual only。权限模式控制 agent 何时需要你批准docs/user/permission-modes.md 定义了四种线程级权限模式在消息输入框中为当前线程选择也可在Settings → General → New threads → Permissions设置新线程默认值项目可覆盖环境默认值初始默认为Full access模式行为Supervised命令与文件变更都需要请求批准Auto-accept edits文件编辑自动批准其他操作可能仍需批准Auto使用 Provider 的自动审查批准常规操作并询问其他操作Full access命令与编辑均无需批准注意 Provider 差异Auto模式在 Codex、Claude、Cursor 上使用自动审查而 OpenCode、Antigravity 等没有等价能力的 Provider 会退化为询问Antigravity 即使在 Full access 下仍可能发送原生批准请求Grok 的 Always allow this session 只记忆匹配的命令或工具输入。保持多端同步更新机制与后台服务由于你用的客户端与跑 agent 的 server可以在不同机器上docs/user/updating.md 强调当 server 落后于客户端时对话流和Settings → Connections会出现更新提示更新提示点名的机器。更新动作取决于 server 的运行方式后台服务可远程更新npx t3client-version service update桌面托管 server 会更新并重启桌面应用前台 server 则复制更新命令后在其主机上重启通常为npx t3client-version必要时加上serve、--host、--tailscale-serve等自定义选项。失败时先重试一次再确认更新的是 server 所在机器。后台服务场景docs/user/background-service.mdLinux/macOS 支持以用户服务方式常驻Windows 不支持。核心命令任务命令安装并启动npx t3latest service install查看状态与日志位置npx t3latest service status更新或修复npx t3latest service update停止并移除npx t3latest service uninstallLinux 依赖 systemd 用户服务并启用 lingering 使服务在注销后继续运行若需管理员权限安装程序会先打印恢复命令排查 SSH 断开即停的问题可执行sudo loginctl enable-linger $(id -un)。macOS 在登录时启动、注销时停止无人值守远程访问需保持登录并唤醒。无 Node 的机器可用安装脚本直接装自包含t3CLI脚本放在~/.local/bin支持T3CODE_CHANNEL、T3CODE_VERSION、T3CODE_RELEASE_BASE_URL环境变量控制发布轨道与版本。卸载服务不会删除项目、线程与设置位于~/.t3/userdata。从源码构建与贡献Vite 工具链仓库采用 pnpm workspace Vitevp工具链。想从源码构建或参与贡献README 给出了两条全局命令# macOS / Linux curl -fsSL https://vite.plus | bash # Windows (PowerShell) irm https://vite.plus/ps1 | iex随后在仓库根目录安装依赖vp i。常见开发/构建命令记录在根 package.json 中例如vp run --filter ./apps/* build构建全部应用、build:desktop构建桌面端与t3CLI、test运行全仓测试、typecheck运行类型检查。README 同时明确项目处于极早期基本暂不接受大功能贡献小修复可能被考虑提交 issue/PR 前请先读 CONTRIBUTING.md。构建入口的架构背景从 docs/internals/overview.md 与 docs/operations/development.md 开始阅读。文档导航与源码印证完整文档位于仓库 docs 目录README 明确说明目前还没有独立 docs 站点用户文档安装与首次运行、权限模式、键盘快捷键、项目设置、远程访问、版本同步与更新、源码控制集成、后台服务、多账号Codex · Claude内部文档架构总览、术语表、连接运行时、远程环境README 中的架构描述与源码实现是相互印证的server 默认端口定义在 apps/server/src/config.tsDEFAULT_PORT 3773编排引擎、决策器与投影器分别位于 OrchestrationEngine.ts、decider.ts 与 projector.tscheckpoint 通过隐藏 Git ref 捕获工作区状态实现在 apps/server/src/checkpointing/CheckpointStore.ts。从这些文件可以确认 README 描述的事件日志是编排状态的唯一事实来源、命令确认只代表意图已提交而非副作用已完成等设计承诺。快速上手清单在本机安装并认证至少一个 Provider CLIcodex login/claude auth login等。执行npx t3latest启动 server 与本地 Web 应用或安装桌面/移动应用。在Settings → Providers中启用对应 Provider必要时设置 Binary path 与环境变量。在 composer 中选择权限模式新线程默认 Full access开始第一个线程。需要远程操控时按 remote-access 文档启用 T3 Connect、LAN 配对或桌面托管 SSH。定期按 updating 文档保持客户端与 server 版本一致长时驻留可启用后台服务。【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3code创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考