安装 T3 Code

T3 Code 在你的计算机上运行编程智能体，并让你从它的桌面应用、Web 应用或移动应用来控制它们。请先把智能体将要在上面工作的那台机器设置好。

要求

开始一条对话线程（thread）之前，你需要一个已经安装并通过身份验证的提供方（provider）。你可以先启动 T3 Code，之后再配置提供方。

命令行

bash

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

在 Windows 上，于 PowerShell 中执行：

powershell

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

这会把 t3 二进制文件安装到 ~/.local/bin。如果该文件夹还不在你的 PATH 里，安装程序会说明这一点，并针对 zsh、Linux 上的 bash 以及 fish 打印一条把它加进去的命令。在 Windows 上，t3 在同一个 PowerShell 窗口里立刻就能用；请把该文件夹加入你的 PATH，新窗口才能使用。如果那里已经有一个并非由安装程序或桌面应用创建的 t3，安装程序会保留它并停止。设置 T3CODE_CHANNEL=nightly 可安装 nightly 轨道，设置 T3CODE_VERSION 则可固定到确切版本。

任务	命令
启动服务器并打开 Web 应用	`t3`
启动服务器但不打开浏览器	`t3 serve`
从你的其他设备使用它	`t3 up`（详情）
让它在后台持续运行（macOS、Linux）	`t3 service install`（详情）
升级到最新版本	`t3 update`
回收数据库空间	`t3 doctor`（详情）
再次移除它	`t3 uninstall`

运行 t3 help 或 t3 --help 可查看完整参考。要在一个新的工作目录中启动，请使用显式路径，例如 t3 ./my-project。纯目录名只有在该目录已经存在时才会被接受。

如果 t3 或 t3 start 报告已经有服务器在运行，请改为连接到那台服务器。在启动一台替代服务器之前先停止它，或者换一个 --base-dir 来运行独立的服务器。

如果想不安装就试用一次 T3 Code，请改为运行 npx t3@latest（npx 需要 Node.js）。它会先提议安装 t3 命令。如果你拒绝，下一次次版本发布时它会再次询问，而 npx t3 install 可以在之后安装它。npx t3 始终运行 npm 所选定的版本，即使已经安装了 t3。在 nightly 轨道上，请运行你已经安装的 t3（例如 t3 connect），而不要运行 npx t3，后者运行的是最新的稳定版。

Intel Mac

没有适用于 Intel Mac 的 t3 可执行文件（桌面应用可用）。要在那里运行服务器，请用 vp 从源码构建，它会提供所需的 Node 版本（安装 vp）：

bash

git clone https://github.com/pingdotgg/t3code
cd t3code && vp i && vp run build:desktop
node apps/server/dist/bin.mjs

t3 update 和后台服务不适用于这样运行的服务器；请用 git pull 再重新构建来更新它。

桌面应用

从 GitHub 发行版下载一个版本，也可以使用包管理器：

平台	安装
Windows	`winget install T3Tools.T3Code`
macOS	`brew install --cask t3-code`
Debian、Ubuntu	`sudo apt install ./T3-Code-*.deb`
Arch Linux	`yay -S t3code-bin`
Arch Linux nightly	`yay -S t3code-nightly-bin`
Nix	`nix profile add github:NixOS/nixpkgs/nixos-unstable#t3code`

Linux

AppImage 和 .deb 的下载同时提供 x86_64 与 ARM64。用 uname -m 查看你的架构：如果是 x86_64，选择以 x86_64.AppImage 或 amd64.deb 结尾的文件；如果是 aarch64，选择 arm64.AppImage 或 arm64.deb。

要启动 AppImage，在它的下载文件夹里打开终端。把下面的 T3-Code.AppImage 换成你下载到的准确文件名：

bash

chmod +x ./T3-Code.AppImage
./T3-Code.AppImage

.deb 会像其他桌面构建一样自行更新。每次安装更新时，它都会向你索取密码。如果你的桌面环境没有密码提示，更新就会失败。请下载新的 .deb，并用同样的方式安装。

AUR 软件包目前只支持 x86_64；在 ARM64 上请使用 AppImage。更新通过 AUR 安装的版本时，请使用你的 AUR 助手，例如 yay -Syu，而不要使用应用内更新器。

Nix（nixpkgs）

T3 Code 在 nixpkgs 中维护。上面那条命令从 nixos-unstable 安装，并要求 Nix 2.30 或更高版本，且启用了 nix-command 和 flakes。用 t3code-desktop 启动桌面应用；这个软件包也包含 t3 命令。

在 NixOS 上，你也可以把该软件包加入系统配置，所用的 nixpkgs 修订需要包含 t3code：

nix

environment.systemPackages = [ pkgs.t3code ];

用 sudo nixos-rebuild switch 应用这项更改。如果使用 Home Manager，把 pkgs.t3code 加入 home.packages，然后运行 home-manager switch。

用 nix profile upgrade t3code 更新通过 profile 安装的版本。对于 NixOS 或 Home Manager，请更新配置里的 nixpkgs 输入或频道，然后重新构建。Nix 同时管理桌面应用和捆绑的 t3 命令；请用 Nix 来更新它们，而不要使用应用内更新器或 t3 update。

`t3` 命令

桌面应用自带 t3 命令行工具。全新安装会在首次启动时把它设置好；更新之后，或在任何时候，都可以在设置 → 关于里、t3 命令旁边选择安装。在 macOS 和 Linux 上，它会添加一个 t3 链接，放在 ~/.local/bin（或 ~/bin）里；在 Windows 上，它会把应用的命令文件夹加入你的 PATH。之后请新开一个终端。如果该文件夹不在你的 PATH 里，欢迎页或设置 → 关于中的添加到 PATH 会在 shell 的启动文件里添加一行。移除会把它去掉，应用也不会再次添加。如果你已经有另一个 t3，它会保持原样。

适用于 Linux 的 Windows 子系统

在设置 → 共享与访问里选择一个 WSL 发行版，以便在其中运行智能体和项目。请在该发行版里安装提供方 CLI。T3 Code 会自动在那里安装自己的服务器运行时；应用更新之后的第一次启动可能会更久。

从终端打开项目

当桌面应用已经在同一台机器上运行时：

bash

t3 app

这会为当前目录打开一条新的对话线程，必要时把该项目加进来。传入一个路径，例如 t3 app ../my-project，可以打开另一个目录。它需要桌面应用，因此单独的服务器或一次 SSH 会话并不够。如果这条命令联系不到应用，请启动或更新桌面应用后再试一次。

移动应用

从 App Store 或 Google Play 安装 T3 Code。手机会连接到另一台机器上的服务器。按照远程访问，通过 T3 Connect 或配对 URL 把它链接起来。

商店链接和二维码也可以在 Web 和桌面的设置 → 关于 → 移动应用里找到。商店应用同时适用于稳定版和 Nightly 服务器。测试构建是可选的：

iPhone 和 iPad： TestFlight 仅限邀请。
Android： 从 Android 测试版发布下载 APK。

如果应用在启动过程中崩溃，请在下一次成功启动时打开设置 → 诊断。那里会列出最近 7 天的启动崩溃，并附上商店崩溃报告所省略的错误和组件栈。复制这份报告，粘贴到 GitHub 议题里。错误信息可能会引用应用中的值，分享之前请先通读一遍。

提供方

在 Web 应用或桌面应用里打开设置 → 提供方，选中环境（environment），然后启用你想用的提供方（provider）。即便你是从手机或另一台计算机连接的，安装、登录和配置也都属于该环境所在的那台机器。

提供方	安装与身份验证
Codex	通过 ChatGPT 连接，或安装 Codex CLI 并运行 `codex login`。
Claude	安装 Claude Code，然后运行 `claude auth login`。
Cursor	安装 Cursor CLI，然后运行 `agent login`。
Grok Build	安装 Grok Build CLI，然后运行 `grok login`。
Kiro	安装 Kiro CLI，然后运行 `kiro-cli login`。
OpenCode	安装 OpenCode，然后运行 `opencode auth login`。
Antigravity	在 T3 Code 的提供方设置中安装，并用 Google 登录。
Pi	使用 Node.js 22.19 或更高版本安装 Pi，然后运行 `pi` 和 `/login`。
Muse Code	在服务器上安装 Muse Code，运行 `muse login`，然后在设置 → 提供方中启用它。
fx	安装 fx 时使用 `curl -fsSL https://fx.sh/setup.sh \| bash`，然后运行 `fx login`。

提供方 CLI 必须位于服务器的 PATH 上。如果 T3 Code 找不到某个 CLI，请在提供方设置里填写它的二进制路径，使用版本管理器时尤其如此。Cursor 的可执行文件是 cursor-agent，尽管它的登录命令是 agent login。通过 ChatGPT 连接的 Codex 以及 Antigravity 可以使用各自的托管运行时，而不需要 PATH 条目。

当某个提供方版本与你的发行版存在已知的兼容性问题时，T3 Code 会给出警告。请到该环境的设置 → 提供方里查看推荐的版本或范围。如果它的包管理器支持安装指定版本，你可以在那里安装推荐的版本。否则，请在该环境所在的机器上使用提供方自己的安装程序。没有列出的版本未经验证。

当提供方 CLI 落后于它的最新版本时，它的提供方卡片会显示可用版本。立即更新会运行负责该 CLI 的安装程序（Homebrew、mise，或者全局的 npm、pnpm、Yarn、Bun、Volta 或 Vite+ 安装），当 T3 Code 无法判断时，则运行该 CLI 自己的更新命令。T3 Code 无法识别的 Claude、Codex 和 OpenCode 安装仍需手动更新：请通过你当初使用的安装程序来更新。T3 Code 只会在这种情况下运行 mise upgrade：你的 mise 配置把该工具请求为 latest，并且该提供方的二进制路径是 mise 的 shim，或者位于该工具的 installs/<tool>/latest 链接之下。固定的版本，或者指向某一个版本目录的路径，请你自己通过 mise 更新。Cursor 和 Antigravity 会随 T3 Code 一起更新。通过 Homebrew 和 Chocolatey 安装的版本，会与各自包管理器所提供的版本作比较，而该版本可能落后于 npm 上的发布；用 Chocolatey 安装的 Claude，请通过 Chocolatey 更新。

可以为单独的账户或配置再添加一个提供方实例。每个实例都可以有自己的环境变量，例如 API 密钥或自定义的 base URL。把机密值标记为敏感；保存之后，T3 Code 不再显示它们的原始值。

各提供方的具体设置和账户，请参见 Codex、Claude、OpenCode、Antigravity、Kiro、Pi、Muse Code 和 fx。

后续步骤

使用对话线程：启动任务，并组织并行的工作。
权限模式：选择智能体在行动之前何时先询问。
远程访问：从另一台设备连接。
在后台运行：让一台 Linux 或 macOS 主机保持可用。
更新 T3 Code：更新应用以及已连接的服务器。
托管策略：为同一台机器上的所有人配置 T3 Code。

安装 T3 Code ​

要求 ​

命令行 ​

Intel Mac ​

桌面应用 ​

Linux ​

Nix（nixpkgs） ​

t3 命令 ​

适用于 Linux 的 Windows 子系统 ​

从终端打开项目 ​

移动应用 ​

提供方 ​

后续步骤 ​

安装 T3 Code

要求

命令行

Intel Mac

桌面应用

Linux

Nix（nixpkgs）

`t3` 命令

适用于 Linux 的 Windows 子系统

从终端打开项目

移动应用

提供方

后续步骤