T3 Code Windows 安装教程:用网页界面管理 Codex、Claude、Cursor 与 OpenCode

T3 Code Windows 安装与排错指南:通过 winget 或 npx 启动网页 GUI,连接 Codex、Claude、Cursor、OpenCode,并处理登录、端口和远程访问问题。

T3 Code 的本篇教程围绕标题中的具体任务展开。T3 Code 是管理多个编码 Agent 的网页界面;它不会替代 Codex、Claude、Cursor 或 OpenCode 自身的安装、登录和权限模型。

下面使用测试环境和可撤销数据演示。涉及账号、密钥、机器控制、投资或应急通信时,必须再做人工确认。

T3 Code 管理的是会话而不是模型账号

这一节只处理“T3 Code 管理的是会话而不是模型账号”。先保存当前状态,再运行最小测试,不要同时改变多个条件。

1
Get-Command codex, claude -ErrorAction SilentlyContinue

对 T3 Code 来说,判断结果时必须结合这一边界:T3 Code 是管理多个编码 Agent 的网页界面;它不会替代 Codex、Claude、Cursor 或 OpenCode 自身的安装、登录和权限模型。

如果结果无法重复,记录版本、输入和日志,然后缩小测试范围。

Windows 上先核对 Node.js 版本

建议按以下顺序执行:

  1. 核对实际版本与来源。
  2. 使用测试账号、测试目录或测试设备。
  3. 执行一个可撤销动作。
  4. 保存输出、退出码或截图。
  5. 恢复修改并重新验证。
1
2
node --version
npm --version

完成标准是“Windows 上先核对 Node.js 版本”得到可核验结果,而不是命令刚好没有报错。

从官方仓库取得源代码

检查项 通过标准 停止信号
从官方仓库取得源代码 输入、输出和权限范围明确 工具自动扩大操作范围
来源 能回到官方仓库或原始数据 依赖未知镜像或二手结论
安全 日志中没有秘密值 出现 Token、Cookie 或隐私数据
恢复 能回到执行前状态 没有备份或撤销方法
1
git clone https://github.com/pingdotgg/t3code.git

出现停止信号时先恢复,不要继续下一步。

安装依赖前查看包管理器锁文件

这一节只处理“安装依赖前查看包管理器锁文件”。先保存当前状态,再运行最小测试,不要同时改变多个条件。

1
Get-ChildItem -Name *lock*

对 T3 Code 来说,判断结果时必须结合这一边界:T3 Code 是管理多个编码 Agent 的网页界面;它不会替代 Codex、Claude、Cursor 或 OpenCode 自身的安装、登录和权限模型。

如果结果无法重复,记录版本、输入和日志,然后缩小测试范围。

启动 Web UI 后确认监听地址

建议按以下顺序执行:

  1. 核对实际版本与来源。
  2. 使用测试账号、测试目录或测试设备。
  3. 执行一个可撤销动作。
  4. 保存输出、退出码或截图。
  5. 恢复修改并重新验证。
1
netstat -ano | Select-String '3000|5173'

完成标准是“启动 Web UI 后确认监听地址”得到可核验结果,而不是命令刚好没有报错。

Codex 找不到时检查 PATH 继承

检查项 通过标准 停止信号
Codex 找不到时检查 PATH 继承 输入、输出和权限范围明确 工具自动扩大操作范围
来源 能回到官方仓库或原始数据 依赖未知镜像或二手结论
安全 日志中没有秘密值 出现 Token、Cookie 或隐私数据
恢复 能回到执行前状态 没有备份或撤销方法
1
Get-Command codex

出现停止信号时先恢复,不要继续下一步。

Claude 已登录但 T3 Code 未识别

这一节只处理“Claude 已登录但 T3 Code 未识别”。先保存当前状态,再运行最小测试,不要同时改变多个条件。

1
2
Get-Command claude
claude --version

对 T3 Code 来说,判断结果时必须结合这一边界:T3 Code 是管理多个编码 Agent 的网页界面;它不会替代 Codex、Claude、Cursor 或 OpenCode 自身的安装、登录和权限模型。

如果结果无法重复,记录版本、输入和日志,然后缩小测试范围。

多个项目目录如何分开授权

建议按以下顺序执行:

  1. 核对实际版本与来源。
  2. 使用测试账号、测试目录或测试设备。
  3. 执行一个可撤销动作。
  4. 保存输出、退出码或截图。
  5. 恢复修改并重新验证。
1
git worktree list

完成标准是“多个项目目录如何分开授权”得到可核验结果,而不是命令刚好没有报错。

会话列表与真实进程如何对应

检查项 通过标准 停止信号
会话列表与真实进程如何对应 输入、输出和权限范围明确 工具自动扩大操作范围
来源 能回到官方仓库或原始数据 依赖未知镜像或二手结论
安全 日志中没有秘密值 出现 Token、Cookie 或隐私数据
恢复 能回到执行前状态 没有备份或撤销方法
1
Get-Process node,codex -ErrorAction SilentlyContinue

出现停止信号时先恢复,不要继续下一步。

浏览器页面打不开先查什么

这一节只处理“浏览器页面打不开先查什么”。先保存当前状态,再运行最小测试,不要同时改变多个条件。

1
Test-NetConnection 127.0.0.1 -Port 3000

对 T3 Code 来说,判断结果时必须结合这一边界:T3 Code 是管理多个编码 Agent 的网页界面;它不会替代 Codex、Claude、Cursor 或 OpenCode 自身的安装、登录和权限模型。

如果结果无法重复,记录版本、输入和日志,然后缩小测试范围。

远程访问为什么不能直接开放端口

建议按以下顺序执行:

  1. 核对实际版本与来源。
  2. 使用测试账号、测试目录或测试设备。
  3. 执行一个可撤销动作。
  4. 保存输出、退出码或截图。
  5. 恢复修改并重新验证。
1
Get-NetTCPConnection -State Listen

完成标准是“远程访问为什么不能直接开放端口”得到可核验结果,而不是命令刚好没有报错。

反向代理前先解决应用认证

检查项 通过标准 停止信号
反向代理前先解决应用认证 输入、输出和权限范围明确 工具自动扩大操作范围
来源 能回到官方仓库或原始数据 依赖未知镜像或二手结论
安全 日志中没有秘密值 出现 Token、Cookie 或隐私数据
恢复 能回到执行前状态 没有备份或撤销方法
1
# 未确认认证能力前保持 127.0.0.1

出现停止信号时先恢复,不要继续下一步。

Agent 修改文件后从 Git 验收

这一节只处理“Agent 修改文件后从 Git 验收”。先保存当前状态,再运行最小测试,不要同时改变多个条件。

1
2
git status --short
git diff --stat

对 T3 Code 来说,判断结果时必须结合这一边界:T3 Code 是管理多个编码 Agent 的网页界面;它不会替代 Codex、Claude、Cursor 或 OpenCode 自身的安装、登录和权限模型。

如果结果无法重复,记录版本、输入和日志,然后缩小测试范围。

结束会话不等于结束子进程

建议按以下顺序执行:

  1. 核对实际版本与来源。
  2. 使用测试账号、测试目录或测试设备。
  3. 执行一个可撤销动作。
  4. 保存输出、退出码或截图。
  5. 恢复修改并重新验证。
1
Get-Process node,codex -ErrorAction SilentlyContinue

完成标准是“结束会话不等于结束子进程”得到可核验结果,而不是命令刚好没有报错。

升级 T3 Code 时保留什么

检查项 通过标准 停止信号
升级 T3 Code 时保留什么 输入、输出和权限范围明确 工具自动扩大操作范围
来源 能回到官方仓库或原始数据 依赖未知镜像或二手结论
安全 日志中没有秘密值 出现 Token、Cookie 或隐私数据
恢复 能回到执行前状态 没有备份或撤销方法
1
git rev-parse HEAD

出现停止信号时先恢复,不要继续下一步。

卸载后恢复原 CLI 工作流

这一节只处理“卸载后恢复原 CLI 工作流”。先保存当前状态,再运行最小测试,不要同时改变多个条件。

1
2
codex --version
claude --version

对 T3 Code 来说,判断结果时必须结合这一边界:T3 Code 是管理多个编码 Agent 的网页界面;它不会替代 Codex、Claude、Cursor 或 OpenCode 自身的安装、登录和权限模型。

如果结果无法重复,记录版本、输入和日志,然后缩小测试范围。

不同 Agent 的工作目录不能混用

建议按以下顺序执行:

  1. 核对实际版本与来源。
  2. 使用测试账号、测试目录或测试设备。
  3. 执行一个可撤销动作。
  4. 保存输出、退出码或截图。
  5. 恢复修改并重新验证。
1
git worktree list

完成标准是“不同 Agent 的工作目录不能混用”得到可核验结果,而不是命令刚好没有报错。

Web UI 刷新后会话仍在不在

检查项 通过标准 停止信号
Web UI 刷新后会话仍在不在 输入、输出和权限范围明确 工具自动扩大操作范围
来源 能回到官方仓库或原始数据 依赖未知镜像或二手结论
安全 日志中没有秘密值 出现 Token、Cookie 或隐私数据
恢复 能回到执行前状态 没有备份或撤销方法
1
Get-Process node,codex -ErrorAction SilentlyContinue

出现停止信号时先恢复,不要继续下一步。

后台启动时日志应该写到哪里

这一节只处理“后台启动时日志应该写到哪里”。先保存当前状态,再运行最小测试,不要同时改变多个条件。

1
Get-ChildItem -Recurse -Filter *.log -ErrorAction SilentlyContinue

对 T3 Code 来说,判断结果时必须结合这一边界:T3 Code 是管理多个编码 Agent 的网页界面;它不会替代 Codex、Claude、Cursor 或 OpenCode 自身的安装、登录和权限模型。

如果结果无法重复,记录版本、输入和日志,然后缩小测试范围。

T3 Code 的最终核对

  • 使用的版本和来源已经记录。
  • 测试输入与正式数据已经隔离。
  • 命令、配置和实际输出能够对应。
  • 失败路径至少主动测试过一次。
  • 密钥、账号和私人数据没有进入 Git 或日志。
  • 升级、停止和恢复都有明确动作。

如果仍无法解释结果如何产生,就继续把 T3 Code 保持在测试环境,不要扩大权限或替换现有稳定流程。