ACP 提供方¶

T3 Code 可以运行已安装的 ACP 命令，或来自官方 ACP Registry 的编码智能体。Registry 智能体自带模型、工具和登录能力，而 T3 Code 提供项目、线程、检查点和任务委派。

T3 Code 作为独立提供方直接支持的智能体（如 Codex、Claude、Cursor、Grok、OpenCode、Pi 和 Antigravity）不会出现在 Registry 列表中。请改为在 设置 → 提供方 中启用它们。

T3 Code 优先使用当前的 ACP v2 预览协议，并在智能体支持时使用其更丰富的消息、用量、计划、配置、压缩和智能体终端更新。它还会为尚未迁移的 Registry 智能体协商 ACP v1，使它们继续通过同样的通用集成正常工作。

Claude Agent 默认对 Registry 和本地 claude-agent-acp 命令使用 ACP v2 预览协议。如果遇到预览问题，可在提供方实例的环境变量覆盖中设置 CLAUDE_AGENT_ACP_EXPERIMENTAL_V2=0，以使用 ACP v1。

添加智能体¶

1. 打开 设置 → 提供方。
2. 选择 添加提供方，然后选择 显示更多。
3. 在 ACP Registry 中搜索该智能体，并在其结果上选择 添加。
4. 确认名称和实例 ID，然后完成该智能体的登录步骤。

搜索只会显示可在已连接服务器上运行的智能体。Registry 智能体是第三方代码；在添加之前，请审查智能体的源代码和许可证。

添加本地命令¶

在 设置 → 提供方 → 添加提供方 中，选择 显示更多，然后选择 本地 ACP 命令。在所选环境中输入可执行文件名称或路径，每行添加一个字面参数，并选择显示名称。对于 DeepSeek Harness，请使用 dsh，参数为 --profile 和 acp。

本地命令不需要 Registry 条目或下载。环境变量覆盖适用于该命令；凭据和技能仍由已安装的智能体或其包装器管理。模型和推理选项来自 ACP，包括包含 JSON 的模型 ID。T3 Code 直接启动可执行文件，不会展开 shell 表达式。

智能体的运行位置¶

Registry 智能体始终运行在托管你的 T3 Code 服务器的机器上。即使你通过 app.t3.codes、T3 Connect 或中继连接，也是如此。

智能体安装在 T3 主目录下的 tools/<agent-id>/<version>/ 中。当 Registry 条目提供 SHA-256 时，T3 Code 会进行校验；没有校验和的条目仍保留 Registry 的 HTTPS 分发保证。Registry 的 npx 和 uvx 包使用 T3 拥有的 npm 前缀和 Python 工具目录，版本与 Registry 发布的完全一致。它们的命令可用于新服务器终端中的登录和直接使用。删除某个智能体的最后一个提供方实例会移除 T3 管理的二进制文件，但会保留包安装。若要使用现有的本地二进制文件，请显式设置 可执行文件覆盖。

登录¶

在 Web 或桌面端打开 设置 → 提供方 中该智能体的账户区域。选择 登录，如果该智能体提供多种方式，请选择其中一种。对于已安装且已配置的提供方，移动端也提供 设置 → 提供方。

浏览器登录会显示该智能体的 URL，并等待你打开或复制该 URL，然后才告知智能体继续。页面会在你的设备上打开，而智能体运行在环境中。终端方式在该环境的应用内终端中运行。在移动端，通过终端响应字段发送响应。T3 Code 会在终端登录后重新连接，并在报告成功前等待智能体确认登录。你可以取消或重试已过期的尝试。

浏览器和终端登录会将凭据保存在智能体自己的存储中。通过环境变量使用 API 密钥的智能体，仍会在实例的环境设置中接收这些密钥。已配置的环境或智能体主目录同时适用于登录和聊天。

如果智能体提供退出功能，请选择 退出登录。更改共享的智能体登录状态会停止该环境中同一智能体实例正在运行的线程。线程历史和工作区文件会保留。ACP 未描述账户隔离，因此添加另一个实例并不能保证独立账户；在支持的情况下，请使用智能体自身的配置来隔离账户。

如果智能体无法远程完成其宣称的流程，其 CLI 仍可在服务器上使用。例如，Codex 支持 codex login --device-auth，Grok Build 支持 grok login --device-auth。

模型与选项¶

模型选择器会列出智能体报告的模型。如果智能体未报告任何模型，或隐藏了部分模型，你可以在实例设置中的 自定义模型 下添加自己的模型 ID。

智能体提供的其他设置（如推理强度或审批模式）会像内置提供方那样，出现在 composer 的模型选择器中模型列表的旁边。智能体运行期间发生变化的模型和选项会更新选择器，而无需等待另一次提供方探测。

命令与技能¶

会话运行期间，智能体提供的斜杠命令会显示在 / 菜单的 提供方 下。智能体以 $ 前缀命名的命令则会显示在 T3 Code 的 $ 技能菜单中。

原生会话¶

当智能体宣称支持 ACP 会话列表和导入时，展开其提供方卡片，选择一个项目，然后选择 列出会话。导入一个会话会创建由该原生会话支持的确定性 T3 线程。再次导入同一个智能体会话将返回现有线程，包括当另一个客户端执行导入时也是如此。

该线程会保留原生会话的标题和最后更新值，作为提供方元数据，而不会覆盖你在 T3 Code 中设置的标题。报告 ACP 上下文用量的智能体会驱动线程详情中的上下文窗口和累计成本元数据。请参阅 命令与技能，以在 Web 和桌面端显示这些信息。文本资源和链接会作为助手输出渲染；T3 Code 尚无法渲染的二进制资源、图片和音频则会显示为明确的占位符，而不是消失。

权限与终端¶

注册表代理会自行读取文件、编辑文件并运行命令，这些操作受其自身的沙箱和批准规则约束。它们以各自的默认模式启动，模型选项菜单中的模式选择器可切换该模式。代理的受限程度取决于该模式以及代理自身的设置，因此在需要时，请使用它的沙箱和权限控制。

当注册表代理请求批准时，T3 Code 会按照线程的权限模式来响应：Supervised 会在对话中显示请求；Auto-accept edits 会批准编辑并显示其余内容；Auto 和 Full access 则自动批准。文件读取和搜索操作无需等待批准。

Devin 通过 T3 Code 的终端运行其命令，这些命令遵循线程的权限模式。对于其他代理，T3 Code 会显示代理报告的命令、输出和退出状态，但不会运行或停止其终端。

注册表代理可以调度工作并使用 T3 的 MCP 工具。子任务的呈现方式取决于代理所暴露的内容：ACP 没有可移植的原生子代理谱系合约，因此更丰富的委派视图仍然是代理特定的。

检查点¶

检查点回滚会像往常一样恢复你的文件。ACP 代理无法回退自己的对话，因此回滚后的下一轮会启动一个新的代理会话，该会话不再记得检查点之前的对话。

注册表实例不会用于 T3 应用自有的文本生成，例如线程标题、提交消息、分支名称或拉取请求描述。请为这些操作配置支持文本生成的提供商。

高级配置¶

• Executable override 运行现有的本地可执行文件，而不是受管理的发行版，同时保留注册表声明的参数和环境。
• Authentication method 在代理公布多个方法时选择特定的一种。
• Custom models 添加代理未报告的模型 ID。