欢迎页面¶

T3 Code 在新安装打开时会显示欢迎页面。已有的工作区会跳过它。它在一页上显示 T3 Code 在你当前使用的计算机上发现的内容：你的智能体、来自 Claude Code、Codex 和 Pi 历史记录的项目，以及手机应用。只需一个智能体即可开始聊天。

若要再次查看该页面，请前往 设置 → 关于 → 欢迎页面，然后选择 打开。直接链接（如设置）在完成设置前会正常打开。

app.t3.codes 上的托管应用不会打开该页面。在没有连接计算机的情况下，它会要求你登录 T3 Connect，然后在你计算机上安装 T3 Code 并运行 t3 connect。从主页开始，它会添加关联到你账户的兼容计算机并打开应用。以后要添加更多计算机，请使用 设置 → 环境。

如果 T3 Code 在启动时无法确认工作区，它会显示 仍在连接 而不是打开应用。选择 重新加载 重试。

如果 T3 Code 无法读取你保存的设置，它会显示 无法读取设置。在存储可用后选择 重试。设置过程不会用默认值替换无法读取的设置。

智能体¶

T3 Code 首先列出它在计算机上发现的智能体，已就绪的排在最上面。添加更多智能体 会列出 T3 Code 支持的所有其他智能体，按 A 到 Z 排序。当未找到任何智能体时，它显示 设置一个智能体 并自动打开：

• 开启 启用在此计算机上关闭的智能体，包括仅某些项目使用的智能体。然后 T3 Code 会检查它是否已安装并已登录。
• 对于 Claude Code，安装 或 登录 会打开一个终端，并准备好要运行的命令。安装使用供应商自己的安装程序，这样 立即更新 在设置中仍然可用。
• 对于 Codex，设置 提供使用你的 ChatGPT 账户或你自己的 Codex CLI 登录。使用现有 CLI 会打开终端进行安装或登录，继续使用 ChatGPT 在 Codex 登录前一直可用。
• 当 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 Connect 时，该页面会省略手机部分。你仍然可以使用 设置 → 共享与访问 中的配对码将应用与计算机配对。

项目¶

T3 Code 会查找 Claude Code、Codex 或 Pi 使用过的目录。Git 仓库会首先列出，最近活动排在前面。当远程仓库位于 GitHub 上时，该分组会以 owner/name 形式显示仓库。具有相同远程仓库的克隆共享一个分组。不是 git 仓库的目录位于“其他文件夹”下。

该页面会提供过去 30 天内活跃且至少有三段对话的 git 仓库，并默认勾选。已存在于 T3 Code 中的项目不会再次被勾选。取消勾选即可不导入它们，或选择 查看全部 从找到的所有内容中挑选，并提供“全选”和“全不选”。裸仓库的关联工作树可以作为单独项目提供。其他关联的 git 工作树、Documents/Codex 下的 Codex 临时目录，以及 Downloads 下的任何内容都不会被提供。

过大或格式错误的历史记录可能会达到扫描限制。T3 Code 会保留它找到的项目，并在项目或对话可能缺失时发出警告。

导入的项目包含过去 30 天内活跃的 Claude、Codex 和 Pi 对话。你可以在 T3 Code 中继续这些对话。Pi 默认关闭：打开 添加更多智能体，选择 Pi 旁边的 开启，该页面也会查找其会话。Pi 会话从每个已启用的 Pi 提供方的会话目录读取，该目录遵循其环境中的 PI_CODING_AGENT_SESSION_DIR 和 PI_CODING_AGENT_DIR。Pi 对话会导入其活动分支，即 Pi 重新打开的那个分支。

对话导入是尽力而为的。T3 Code 会保留第一条用户提示和最新的其余可见用户与助手消息，总计 200 条消息。它会省略工具活动和附件。对于 Codex，只有当规范的用户事件和有效的共享轮次 ID 标识同一用户轮次时，它才会省略生成的设置上下文。模糊的旧版或仅响应上下文会保留在导入的对话中，以便 T3 Code 不会删除用户文本。它一次读取一段对话，并跳过大于 4 GiB 的文件。当它保留的消息文本和元数据需要超过 32 MiB 内存时，它也会跳过该对话。工具输出不计入该限制。它每次都会跳过超过 100,000 条记录的对话，因此再次打开页面不会导入它。它会忽略格式错误的记录，并跳过无法读取或无法解析的对话。

每次导入尝试最多读取 100 个对话文件和每个项目 4 GiB。要继续大型批次，请再次打开欢迎页面，并在 查看全部 中选择该项目。已完成的对话不会再次导入。你可以在没有剩余历史记录的情况下继续。

您可以不导入直接开始。导入运行期间，T3 Code 会停留在欢迎页面。如果退出，可从 设置 → 关于 重新打开欢迎页面；您已开始的项目仍会保持勾选状态。