OpenCode

在运行你的环境（environment）的机器上安装并认证 OpenCode，然后在 设置 > 提供方（provider） 中启用它。参见提供方配置。 T3 Code 要求 OpenCode 1.14.19 或更高版本，连接已有的 OpenCode 服务器时也一样。

OpenCode 2

T3 Code 支持 OpenCode 2.0.18 及更新版本。它会自行识别版本，因此同一套提供方（provider）设置对 OpenCode 1.x 和 2.x 都有效。OpenCode 1.x 会在其提供方设置中显示 有限支持。

OpenCode 2 是单独的软件包 @opencode/cli。要从 1.x 迁移，请自行安装，例如 npm install -g @opencode/cli。然后刷新提供方状态。 T3 Code 的更新按钮会更新你已安装的那个软件包。它绝不会把 1.x 安装切换为 2.x。

OpenCode 2 第一次运行时，会把共享的 OpenCode 数据库转换成自己的格式。不要在同一台机器上同时运行 OpenCode 1.x 和 2.x。你在 1.x 上开启的对话线程（thread）会在 2.x 上延续。

压缩

OpenCode 会自己压缩很长的对话，T3 Code 没有对应的设置。在 OpenCode 2 中，于 OpenCode 配置文件的 compaction 下修改，例如 opencode.json：auto 用于打开或关闭自动压缩，buffer 设置 token 余量，keep.tokens 设置保留多少近期上下文。OpenCode 1.x 的压缩配置方式不同。 发送 /compact，即可自行压缩一个对话线程（thread）。

本地或外部服务器

把 服务器 URL 留空，让 T3 Code 在本地启动 OpenCode。提供方（provider）设置里的密码同时作用于该服务器和 T3 Code 的连接。未设置密码时，本地服务器使用其环境（environment）中的 OPENCODE_SERVER_PASSWORD。

要使用已有的 OpenCode 服务器，请在提供方设置中填写 服务器 URL 及其密码。对于外部服务器，T3 Code 只用这个已配置的密码，不会转发本地的 OPENCODE_SERVER_PASSWORD。如果连接或版本检查失败，请核对 URL、凭据和 OpenCode 版本，然后刷新提供方状态。

当 服务器 URL 指向本机正在运行的服务器（例如 127.0.0.1）时，更新按钮会升级已安装的 CLI，但不会结束正在运行的服务器。在你重启它之前，服务器仍可能报告先前的版本。T3 Code 会显示这一重启要求，而不是把 CLI 更新当作失败。请在可以安全打断进行中的提供方会话（session）时再重启服务器。

连接丢失后，再发送一条提示，即可重新连上同一个 OpenCode 提供方会话。

批准

OpenCode 遵循共享的权限模式。自动 与 受监督 的规则相同，因为 OpenCode 没有 AI 批准审查者。 诸如 .env 和 .env.local 这样的环境（environment）文件，在受限模式下需要批准，尽管普通的文件读取不需要；.env.example 是允许的。

对工作区允许 适用于使用同一工作区的其他 OpenCode 提供方会话（session）中的匹配请求。它比当前对话线程（thread）更宽，在共享的外部服务器上尤其如此。单次请求请用 允许一次。拒绝一项操作并不会停止整个回合（turn）。

刷新模型、命令（command）和技能

更改 OpenCode 的登录或配置之后，针对该环境（environment），在 设置 > 提供方 中使用 刷新提供方状态。在移动端，于对话线程（thread）设置中使用 刷新模型。重新连接也会刷新目录；定期的提供方健康检查则不会。

凭据变更会在刷新时读取。本地辅助进程仍在运行时，OpenCode 的原生配置可能继续留在缓存中。让它静置 30 秒，期间不要刷新模型，也不要进行文本生成，然后再刷新一次，以重新加载这些文件。反复刷新会让辅助进程保持存活。外部服务器可能需要自己重新加载或重启，T3 Code 才能看到配置变更。

已有对话线程仍会保留已选模型和选项，哪怕它已经从目录里消失。如果 OpenCode 拒绝该模型，请选择一个仍可用的模型，然后重试。