프로젝트 소개

The Construct는 Claude Code, Codex, Opencode와 같은 AI 코딩 에이전트를 실행하기 위한 안전하고 일회용 환경을 제공합니다. 주로 Hyper-V 기능을 갖춘 Windows 사용자를 위해 설계되었으며, AI 에이전트와 호스트 PC 사이의 샌드박스 역할을 하는 격리된 Ubuntu 가상 머신을 생성합니다. 이 아키텍처는 에이전트가 호스트 시스템을 위험에 빠뜨리지 않고 완전한 루트 권한으로 작동하고 권한 프롬프트를 우회할 수 있도록 보장합니다. 주요 기능은 다음과 같습니다: - **샌드박스 실행**: 에이전트는 일회용 Hyper-V VM에서 실행되어 호스트 운영 체제와의 직접적인 상호 작용을 방지합니다. - **일회용 및 재사용 가능**: VM 및 에이전트 구성은 쉽게 재설치할 수 있도록 설계되었으며, 프로젝트 프로필을 통해 저장소, SDK 및 MCP 서버를 자동으로 복원할 수 있습니다. - **에이전트 지원**: Claude Code, Codex, Opencode를 기본 지원하며, 원활한 작동을 위해 바이패스 모드로 실행됩니다. - **원격 액세스**: VS Code Remote-SSH, T3 Code 통합, 브라우저 기반 VS Code, SMB를 통한 파일 공유 등 다양한 연결 방법을 지원합니다. - **유연한 배포**: 단일 머신에서 로컬로 실행하거나 공유 Hyper-V 호스트에 배포하여 다중 사용자 원격 액세스를 지원할 수 있습니다. - **통합 클라이언트**: 음성 입력, 세션 재개 및 Construct 전용 제어 기능이 포함된 패치된 T3 Code 버전을 포함합니다. 설치는 Ubuntu 자동 설치 ISO 생성, VM 설정 및 에이전트 프로비저닝을 자동화하는 PowerShell 원라이너를 통해 간소화됩니다. 이 도구는 또한 설정, 수명 주기 이벤트 및 포트 포워딩을 관리하기 위한 Windows 트레이 컴패니언 앱을 제공합니다. 문서는 설치, 프로비저닝, 원격 호스팅 및 문제 해결을 다룹니다.