欢迎页
首次打开新安装的 T3 Code 时，会显示欢迎页。已有的工作区会跳过它。它在同一页展示 T3 Code 在你正在使用的这台计算机上发现的内容：你的智能体、来自 Claude Code、Codex 和 Pi 历史记录的项目，以及手机应用。开始聊天只需要一个智能体。
若要再次查看此页面，前往 设置 → 关于 → 欢迎页，然后选择 打开。设置完成之前，诸如「设置」之类的直接链接仍会正常打开。
托管应用 app.t3.codes 不会打开此页面。没有连接计算机时，它会要求你登录 T3 Connect，然后在你的计算机上安装 T3 Code 并运行 t3 connect。在主页上，它会加入关联到你账户的兼容计算机并打开应用。以后若要添加更多计算机，请使用 设置 → 环境。
如果 T3 Code 在启动时无法确认工作区，它会显示 仍在连接，而不会打开应用。选择 重新加载 再试一次。
如果 T3 Code 无法读取你保存的设置，它会显示 无法读取设置。请在存储恢复可用后选择 重试。设置流程不会用默认值替换无法读取的设置。
智能体
T3 Code 会优先列出在这台计算机上找到的智能体，已就绪的排在最前。添加更多智能体 会按 A 到 Z 列出 T3 Code 支持的其余所有智能体。当没有找到任何智能体时，文案为 设置智能体，并会自动展开：
- 开启 会启用在这台计算机上处于关闭状态的智能体，包括只有部分项目在使用的智能体。随后 T3 Code 会检查它是否已安装并已登录。
- 对于 Claude Code，安装 或 登录 会打开一个终端，其中已准备好要运行的正确命令。安装使用供应商自己的安装程序，因此设置里的 立即更新 仍能正常工作。
- 对于 Codex，设置 可以选择使用 ChatGPT 账户登录，或使用你自己的 Codex CLI。使用现有 CLI 会打开终端以进行安装或登录，在 Codex 完成登录之前，继续使用 ChatGPT 一直可用。
- 当 T3 Code 确认某个已安装版本无法与它配合工作时，更新 会在 设置 → 提供方 中打开该智能体。那里会显示应使用的版本，并在能够更新时完成更新。
- 其他智能体，以及无法加载的智能体，会在 设置 → 提供方 中打开各自的页面。
- 浏览 会打开 ACP Registry，以便查找更多智能体。
在桌面应用中，如果 t3 命令所在的文件夹不在你的 PATH 里，添加到 PATH 会向 shell 的启动文件添加一行。
设置所用的终端会使用为该提供方实例配置的主目录和环境。敏感值在设置和终端元数据中保持脱敏，终端进程仍然可以使用它们。
开始 会等待一个已就绪的智能体。选择 不使用智能体开始 可以在没有智能体的情况下完成。已勾选的项目仍会被导入。
手机
选择 设置，并用手机扫描二维码。在 iPhone 上会打开 App Store，在 Android 上会打开 Google Play。然后选择 登录 T3 Connect，并在 T3 Code 询问时允许这台计算机，以便应用能够访问它。使用同一账户登录该应用。如果你已经登录，但这台计算机尚未共享，请选择 设置 T3 Connect。如果 T3 Connect 已开启，但应用无法访问这台计算机，请选择 检查 T3 Connect 查看原因。在不含 T3 Connect 的构建上，或当你的组织将其关闭时，此页面不包含手机部分。你仍然可以使用 设置 → 共享与访问 中的配对码来配对应用。
项目
T3 Code 会找出 Claude Code、Codex 或 Pi 使用过的目录。Git 仓库列在前面，最近有活动的排在最上方。当远程位于 GitHub 时，分组会把仓库显示为 owner/name。远程相同的克隆共用一个分组。不是 git 仓库的目录归在「其他文件夹」下。
此页面会提供最近 30 天内有活动、且至少有三段对话的 git 仓库，并已勾选。已经在 T3 Code 中的项目不会再次勾选。取消勾选即可在不导入它们的情况下开始，也可以选择 查看全部，从找到的所有内容里挑选，其中有「全选」和「全不选」。裸仓库的已链接工作树（worktree）可以作为单独的项目提供。其他已链接的 git 工作树、Documents/Codex 下的 Codex 临时目录，以及 Downloads 下的任何内容都不会提供。
庞大或格式异常的历史记录可能达到扫描上限。T3 Code 会保留已经找到的项目，并在项目或对话可能缺失时给出警告。
导入的项目包含最近 30 天内有活动的 Claude、Codex 和 Pi 对话。你可以在 T3 Code 中继续这些对话。Pi 默认关闭：打开 添加更多智能体，选择 Pi 旁边的 开启，此页面也会查找它的提供方会话（session）。Pi 的会话从每个已启用 Pi 提供方的会话目录读取，该目录遵循其环境中的 PI_CODING_AGENT_SESSION_DIR 和 PI_CODING_AGENT_DIR。一段 Pi 对话会导入它的活动分支，也就是 Pi 重新打开的那个分支。
对话导入是尽力而为。T3 Code 会保留第一条用户提示，以及其余最新的可见用户消息和助手消息，合计 200 条。它会省略工具活动和附件。对于 Codex，只有当一条规范的用户事件和一个有效的共享回合（turn）ID 指向同一个用户回合时，才会省略生成的设置上下文。含义不清的旧式上下文，或仅包含响应的上下文，会保留在导入的对话中，这样 T3 Code 就不会删掉用户文本。它一次读取一段对话，并跳过大于 4 GiB 的文件。当它要保留的消息文本和元数据需要超过 32 MiB 内存时，也会跳过该对话。工具输出不计入这一上限。记录数超过 100,000 的对话每次都会被跳过，因此再次打开此页面也不会导入它。它会忽略格式异常的记录，并跳过无法读取或无法解析的对话。
每次导入尝试对每个项目最多读取 100 个对话文件和 4 GiB。若要继续一大批导入，请再次打开欢迎页，并在 查看全部 中选中该项目。已经完成的对话不会再次导入。你可以在没有剩余历史的情况下继续。
你可以不导入就直接开始。导入进行时，T3 Code 会停留在欢迎页。如果退出，请从 设置 → 关于 再次打开欢迎页；你已经开始的项目会保持勾选。