Sobre el proyecto

The Construct 为运行 Claude Code、Codex 和 Opencode 等 AI 编码代理提供了一个安全、一次性的环境。它主要面向具备 Hyper-V 能力的 Windows 用户设计,会创建一个隔离的 Ubuntu 虚拟机,作为 AI 代理与主机 PC 之间的沙箱。这种架构确保代理能够在拥有完整 root 权限并绕过权限提示的情况下运行,而不会危及主机系统。 主要功能包括: - **沙箱化执行**:代理在一次性 Hyper-V 虚拟机中运行,防止与主机操作系统发生任何直接交互。 - **一次性且可复用**:虚拟机和代理配置被设计为易于重新安装,项目配置文件允许自动恢复仓库、SDK 和 MCP 服务器。 - **代理支持**:原生支持 Claude Code、Codex 和 Opencode,它们以绕过模式运行以实现无缝操作。 - **远程访问**:支持多种连接方式,包括 VS Code Remote-SSH、T3 Code 集成、基于浏览器的 VS Code,以及通过 SMB 进行文件共享。 - **灵活部署**:可以在单台机器上本地运行,也可以部署在共享的 Hyper-V 主机上,以实现多用户远程访问。 - **集成客户端**:包含一个经过修补的 T3 Code 版本,具备语音输入、会话恢复以及 Construct 专用控制功能。 安装通过 PowerShell 一行命令进行了简化,该命令会自动完成 Ubuntu 自动安装 ISO 的创建、虚拟机设置和代理配置。该工具还提供了一个 Windows 托盘伴侣应用,用于管理设置、生命周期事件和端口转发。文档涵盖安装、配置、远程托管和故障排除。