T3 Code WSL支持完整指南Windows开发者如何在WSL里远程操控AI Agent【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3codeT3 Code 是一个开源的 AI Agent 控制中枢Agent Harness Control Surface让你通过手机、网页和桌面应用远程操控电脑上的 Claude Code、Codex、Cursor 等编程智能体。它内置的WSL 支持能让 Windows 开发者把后端直接跑在 WSL 的 Linux 发行版里实现「桌面应用 WSL 环境」双环境并行并随时从手机远程接管 Agent 任务。为什么要在 WSL 里运行 T3 Code 后端很多 Windows 开发者的真实工作流是这样的Windows 桌面上跑 IDE 和 Git但项目本身Docker、Linux CLI 工具链、AI Agent全部跑在 WSL 里。如果 T3 Code 的后端只运行在 Windows 侧它就只能管理 Windows 侧的 Agent而你的 Claude Code、Codex 很可能装在 WSL 里。T3 Code 的 WSL 支持正好解决这个痛点一个应用两个环境Windows 主后端 WSL 副后端并行运行各管各的 AgentWSL-only 模式让 WSL 后端直接成为主后端Windows 侧只做控制面手机远程控制无论后端在哪个环境手机/平板都能扫码配对、远程盯梢 Agent 进度。后端编排逻辑wsl:distro实例 ID、端口分配、对账机制完整实现见 DesktopWslBackend.ts。T3 Code WSL 支持是怎么工作的1. 环境探测与发行版管理T3 Code 启动时会探测C:\Windows\System32\wsl.exe是否存在来判断当前机器是否支持 WSL可用时通过wsl.exe --list --verbose列出所有已安装的发行版供设置界面选择。这套环境探测服务封装在 DesktopWslEnvironment.ts提供了一组能力能力作用listDistros/probeDistros枚举 WSL 发行版如 Ubuntu、DebianwindowsToWslPath把C:\Projects\demo转成/mnt/c/Projects/demogetUserHome解析发行版内 Linux 用户主目录支持~展开getDistroIp获取 WSL vEthernet 网卡的 IPv4避免依赖不稳定的 localhost 转发2. 自动预检Node.js 与 node-ptyWSL 后端启动前会做一次完整的「工具链体检」Node.js 检查解析发行版登录 shell 的 PATH兼容 nvm 等版本管理器验证 Node 版本是否满足要求node-pty 原生模块检查终端功能依赖 node-pty 原生二进制。打包版 Windows 应用内置了预编译的 Linux 版pty.node开箱即用开发模式下会自动在 WSL 里用node-gyp现场编译需要make、g、python3友好报错缺什么就提示什么——比如「WSL 里没装 Node.js请用 nvm 安装」或「缺少 build-essential」而不是一句看不懂的报错。检查逻辑工具链脚本与可操作的错误提示在 DesktopWslEnvironment.ts#L268-L389。3. 服务端文件树的透明解包一个容易忽略的细节Windows 打包版的服务端代码存放在server.asar归档里而 WSL 里的 Linux Node 读不了 asar 归档。T3 Code 会在首次启用 WSL 时自动把整个服务端文件树解包到真实目录按版本缓存复用之后再启动 WSL 后端就直接读取。这段逻辑见 DesktopWslServerTree.ts。三步启用 WSL 后端最快配置方法 启用 WSL 支持非常简单第 1 步准备 WSL 环境确保已安装 WSL2 和至少一个 Linux 发行版并在发行版内装好 Node.js建议 18推荐用 nvm以及你想被托管的 Agent CLI如claude、codex并完成登录授权。第 2 步安装 T3 Code 桌面应用Windows 下用 winget 一键安装winget install T3Tools.T3Code第 3 步在设置里打开开关打开Settings → Connections打开WSL backend开关在发行版下拉框选择目标发行版选「default」则跟随 WSL 默认发行版如需让 WSL 直接接管可再开启WSL-only 模式应用会自动重启以切换主后端。这些开关对应的 IPC 接口setWslBackendEnabled、setWslDistro、setWslOnly定义在 wsl.ts。切换发行版后无需手动重启应用会用幂等的对账机制reconcile自动停掉旧实例、拉起新实例。从手机远程操控 WSL 里的 AI AgentWSL 后端跑起来后它就和其他 T3 Code 环境一样支持远程访问局域网配对在 Connections 设置里打开Network access用Create Link生成配对链接手机iOS/Android 应用或另一台电脑的网页版扫码/打开链接即可接管命令行快速配对在服务器上运行npx t3 pair会打印一次性配对二维码用npx t3 pair --tailscale则可通过 Tailscale 私有网络配对跨网络也能安全连接私有网络推荐官方文档建议使用 Tailscale 之类的私有组网获得稳定地址和传输加密比直接暴露到公网更稳妥。完整远程访问流程参考官方文档 remote-access.md。 典型场景你在公司电脑上让 WSL 里的 Codex 跑一个大任务出门路上用手机 App 查看 Agent 的实时进度、审批权限请求、审阅 diff——全程不用碰电脑。常见问题与排查清单现象原因解决办法提示「Node.js was not found」WSL 发行版里没装 Node 或版本过低在发行版内nvm install 24后重启应用终端不可用、node-pty 报错原生模块未随构建打包或 CPU 架构/ glibc 不匹配使用 glibc 系的 x64/arm64 发行版如 Ubuntu开发模式自动现场编译首次启动 WSL 后端慢WSL 冷启动 服务端文件树解包正常现象后续启动复用缓存目录双模式下 WSL 副后端未起预检失败缺工具/版本不符Connections 设置页会内联显示具体失败原因修复后自动重试前端连不上 WSL 后端wslhost 的 localhost 自动转发不稳定T3 Code 会改用发行版的 vEthernet IPv4 直连无需手动配置总结T3 Code 的 WSL 支持是「Windows 桌面应用 Linux 开发环境」混合工作流的点睛之笔自动环境探测、工具链预检、asar 解包、双模式后端编排全部开箱即用你只需要在设置里拨动一个开关。配合手机 App 和配对链接WSL 里的 AI Agent 从此真正实现了「人在哪里控制面就在哪里」。核心源码与文档入口WSL 环境探测apps/desktop/src/wsl/WSL 设置 IPCapps/desktop/src/ipc/methods/wsl.ts远程访问文档docs/user/remote-access.md项目总览docs/internals/overview.md【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 T3 Code WSL支持完整指南：Windows开发者如何在WSL里远程操控AI Agent
T3 Code WSL支持完整指南Windows开发者如何在WSL里远程操控AI Agent【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3codeT3 Code 是一个开源的 AI Agent 控制中枢Agent Harness Control Surface让你通过手机、网页和桌面应用远程操控电脑上的 Claude Code、Codex、Cursor 等编程智能体。它内置的WSL 支持能让 Windows 开发者把后端直接跑在 WSL 的 Linux 发行版里实现「桌面应用 WSL 环境」双环境并行并随时从手机远程接管 Agent 任务。为什么要在 WSL 里运行 T3 Code 后端很多 Windows 开发者的真实工作流是这样的Windows 桌面上跑 IDE 和 Git但项目本身Docker、Linux CLI 工具链、AI Agent全部跑在 WSL 里。如果 T3 Code 的后端只运行在 Windows 侧它就只能管理 Windows 侧的 Agent而你的 Claude Code、Codex 很可能装在 WSL 里。T3 Code 的 WSL 支持正好解决这个痛点一个应用两个环境Windows 主后端 WSL 副后端并行运行各管各的 AgentWSL-only 模式让 WSL 后端直接成为主后端Windows 侧只做控制面手机远程控制无论后端在哪个环境手机/平板都能扫码配对、远程盯梢 Agent 进度。后端编排逻辑wsl:distro实例 ID、端口分配、对账机制完整实现见 DesktopWslBackend.ts。T3 Code WSL 支持是怎么工作的1. 环境探测与发行版管理T3 Code 启动时会探测C:\Windows\System32\wsl.exe是否存在来判断当前机器是否支持 WSL可用时通过wsl.exe --list --verbose列出所有已安装的发行版供设置界面选择。这套环境探测服务封装在 DesktopWslEnvironment.ts提供了一组能力能力作用listDistros/probeDistros枚举 WSL 发行版如 Ubuntu、DebianwindowsToWslPath把C:\Projects\demo转成/mnt/c/Projects/demogetUserHome解析发行版内 Linux 用户主目录支持~展开getDistroIp获取 WSL vEthernet 网卡的 IPv4避免依赖不稳定的 localhost 转发2. 自动预检Node.js 与 node-ptyWSL 后端启动前会做一次完整的「工具链体检」Node.js 检查解析发行版登录 shell 的 PATH兼容 nvm 等版本管理器验证 Node 版本是否满足要求node-pty 原生模块检查终端功能依赖 node-pty 原生二进制。打包版 Windows 应用内置了预编译的 Linux 版pty.node开箱即用开发模式下会自动在 WSL 里用node-gyp现场编译需要make、g、python3友好报错缺什么就提示什么——比如「WSL 里没装 Node.js请用 nvm 安装」或「缺少 build-essential」而不是一句看不懂的报错。检查逻辑工具链脚本与可操作的错误提示在 DesktopWslEnvironment.ts#L268-L389。3. 服务端文件树的透明解包一个容易忽略的细节Windows 打包版的服务端代码存放在server.asar归档里而 WSL 里的 Linux Node 读不了 asar 归档。T3 Code 会在首次启用 WSL 时自动把整个服务端文件树解包到真实目录按版本缓存复用之后再启动 WSL 后端就直接读取。这段逻辑见 DesktopWslServerTree.ts。三步启用 WSL 后端最快配置方法 启用 WSL 支持非常简单第 1 步准备 WSL 环境确保已安装 WSL2 和至少一个 Linux 发行版并在发行版内装好 Node.js建议 18推荐用 nvm以及你想被托管的 Agent CLI如claude、codex并完成登录授权。第 2 步安装 T3 Code 桌面应用Windows 下用 winget 一键安装winget install T3Tools.T3Code第 3 步在设置里打开开关打开Settings → Connections打开WSL backend开关在发行版下拉框选择目标发行版选「default」则跟随 WSL 默认发行版如需让 WSL 直接接管可再开启WSL-only 模式应用会自动重启以切换主后端。这些开关对应的 IPC 接口setWslBackendEnabled、setWslDistro、setWslOnly定义在 wsl.ts。切换发行版后无需手动重启应用会用幂等的对账机制reconcile自动停掉旧实例、拉起新实例。从手机远程操控 WSL 里的 AI AgentWSL 后端跑起来后它就和其他 T3 Code 环境一样支持远程访问局域网配对在 Connections 设置里打开Network access用Create Link生成配对链接手机iOS/Android 应用或另一台电脑的网页版扫码/打开链接即可接管命令行快速配对在服务器上运行npx t3 pair会打印一次性配对二维码用npx t3 pair --tailscale则可通过 Tailscale 私有网络配对跨网络也能安全连接私有网络推荐官方文档建议使用 Tailscale 之类的私有组网获得稳定地址和传输加密比直接暴露到公网更稳妥。完整远程访问流程参考官方文档 remote-access.md。 典型场景你在公司电脑上让 WSL 里的 Codex 跑一个大任务出门路上用手机 App 查看 Agent 的实时进度、审批权限请求、审阅 diff——全程不用碰电脑。常见问题与排查清单现象原因解决办法提示「Node.js was not found」WSL 发行版里没装 Node 或版本过低在发行版内nvm install 24后重启应用终端不可用、node-pty 报错原生模块未随构建打包或 CPU 架构/ glibc 不匹配使用 glibc 系的 x64/arm64 发行版如 Ubuntu开发模式自动现场编译首次启动 WSL 后端慢WSL 冷启动 服务端文件树解包正常现象后续启动复用缓存目录双模式下 WSL 副后端未起预检失败缺工具/版本不符Connections 设置页会内联显示具体失败原因修复后自动重试前端连不上 WSL 后端wslhost 的 localhost 自动转发不稳定T3 Code 会改用发行版的 vEthernet IPv4 直连无需手动配置总结T3 Code 的 WSL 支持是「Windows 桌面应用 Linux 开发环境」混合工作流的点睛之笔自动环境探测、工具链预检、asar 解包、双模式后端编排全部开箱即用你只需要在设置里拨动一个开关。配合手机 App 和配对链接WSL 里的 AI Agent 从此真正实现了「人在哪里控制面就在哪里」。核心源码与文档入口WSL 环境探测apps/desktop/src/wsl/WSL 设置 IPCapps/desktop/src/ipc/methods/wsl.ts远程访问文档docs/user/remote-access.md项目总览docs/internals/overview.md【免费下载链接】t3code项目地址: https://gitcode.com/GitHub_Trending/t3/t3code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考