Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
The Construct는 AI 에이전트를 깨끗하고 격리된 샌드박스 컨테이너에서 실행하는 단일 바이너리 CLI입니다. 이 도구는 LLM 프롬프트 주입 공격이나 악성 코드로부터 호스트 시스템을 보호하며, MicroVM 엔진과 네트워크 제어 기능을 통해 안전한 개발 환경을 제공합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Codex tools의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기The Construct는 AI 에이전트가 미리 로드된 깨끗하고 격리된 샌드박스 컨테이너를 부팅하는 단일 바이너리(single-binary) CLI입니다. 이 도구는 호스트 시스템을 의존성 확산(dependency sprawl)으로부터 보호하며, 선택적 네트워크 격리를 추가하고, Docker, Podman 또는 macOS 네이티브 컨테이너 런타임과 함께 작동합니다.
하지만 가장 중요한 점은 로컬 머신을 LLM 프롬프트 주입 공격(LLM prompt injection attacks), 이 방식으로 유포되는 악성 코드(malware), 이렇게 도난당하는 자격 증명(credentials), 그리고 여러분의 파일을 아무것도 남기지 않게 할 수 있는 AGENT가 저지르는 위험한 실수로부터 안전하게 유지한다는 것입니다.
단 하나의 명령어로 보안이 확보된 격리된 샌드박스 내부의 모든 AGENT를 사용할 수 있습니다. 에이전트는 호출되는 경로에서 스폰되며, 경로 탈출(path escape) 위험이 없습니다.
설정 불필요 (Zero Config): 복잡한 설정이 필요하지 않습니다. The Construct는 macOS, Linux 및 Windows (WSL) 전반에 걸쳐 별도의 설정 없이 바로 작동합니다.
자동 감지(Auto-detection): 사용 가능한 최적의 컨테이너 런타임(macOS 네이티브 → Podman → Docker)을 자동으로 감지하고 사용합니다.
실험적 MicroVM 엔진: 마이크로 VM(MicroVMs)을 통한 선택적 하드웨어 수준 격리 기능을 제공하며, 전용 게스트 리눅스 커널로 에이전트를 실행합니다. 이 기능은 데몬과 [daemon] mount_paths가 프로젝트 루트를 포함하도록 함께 사용해야 하며, 프로젝트를 전환할 때 샌드박스가 재사용되고 다시 생성되지 않도록 합니다.
깨끗한 상태(Clean Slate): 임시 샌드박스를 제공합니다. 사용자 설정 홈 디렉터리(에이전트, 캐시, 도구)와 프로젝트 디렉터리는 실행 간에도 유지됩니다.
네트워크 격리(Network Isolation): 허용적(permissive), 엄격(strict), 또는 오프라인(offline) 네트워크 모드를 선택할 수 있으며, 허용/차단 목록을 설정할 수 있습니다.
SSH 에이전트 포워딩(SSH Agent Forwarding): SSH 에이전트를 자동으로 감지하고 안전하게 마운트합니다.
전체 클립보드 브리지(Full Clipboard Bridge): Claude, Copilot, Antigravity, Qwen, Pi를 위한 텍스트 및 이미지 붙여넣기 지원 기능을 제공합니다.
에이전트 브라우저(Agent Browser): AI 에이전트를 위한 헤드리스 브라우저 자동화 CLI입니다.
호스트 루프백 브라우징(Host Loopback Browsing): 헤드리스 브라우저 에이전트가 호스트로 제공되는 localhost/*.localhost의 개발 사이트에 접근할 때, 호스트로의 자동 TCP 릴레이를 통해 접속합니다.
터미널 ID 포워딩(Terminal Identity Forwarding): kitty 및 Ghostty 터미널 마커가 샌드박스로 전달되어 TUI와 pi 확장이 인라인 이미지를 올바르게 렌더링하도록 합니다.
사용자 정의 패키지(User-Defined Packages): apt, mise, bun, npm, pip, cargo 또는 gems 패키지로 샌드박스를 사용자 지정할 수 있습니다.
병렬 워크플로우(Parallel Workflows): 병렬 AI 에이전트 워크플로우를 위한 Git worktree 관리를 지원합니다.
Screenshot 1
Screenshot 2
Screenshot 3
Screenshot 4
codex) – OpenAI의 GPT 모델용 최고급 코딩 에이전트agy) – Google의 Gemini 모델용 최고급 코드 에이전트claude) – Anthropic의 Claude 모델용 최고급 코딩 에이전트copilot) – 모든 Copilot 지원 모델에 접근 가능한 GitHub Copilot 코드 에이전트pi) – Earendil Works의 최소 확장 가능 코딩 에이전트pig) – Pi의 Go 구현체 (pi-in-go.dev); 동일한 에이전트 인터페이스, ~/.pig에서 독립적인 설정 제공opencode) – OpenCode의 코딩 에이전트로, 빠르고 오픈 가중치 모델로 가득함amp) – Sourcegraph의 코딩 에이전트qwen) – Alibaba의 Qwen 모델용 코딩 에이전트cline) – VS Code 및 CLI를 위한 자율 코딩 에이전트droid) – Factory의 코딩 에이전트goose) – Block의 코딩 에이전트crush) – Charmbracelet의 코딩 에이전트kilocode) – Kilo Code의 코딩 에이전트# 원라인 설치 스크립트 (macOS 및 Linux)
curl -fsSL https://raw.githubusercontent.com/EstebanForge/construct-cli/main/scripts/install.sh | bash
...
# 첫 사용 설정 (컨테이너 빌드, 에이전트 설치)
construct sys init
...
셸 별칭(Shell aliases)은 대화형 셸 내부에서만 존재합니다 (이전의 별칭 시스템은 심(shims)으로 대체되었습니다). 코딩 에이전트를 관리하는 도구들(Paseo와 같은 오케스트레이터, IDE 확장 기능, CI 래퍼 등)은 에이전트 바이너리를 PATH에서 해결하거나 셸 없이 직접 실행하므로, 별칭을 볼 수 없습니다. 이들은 순수한 호스트 바이너리만 실행합니다. 항상 에이전트를 샌드박스 내부에서 사용하고 싶은 사용자들을 위해, 심(shims)은 또한 ns-<agent> 실행 파일을 설치하여 실제 호스트 바이너리를 직접 실행하며 (비-샌드박스), 이를 설치하면 셸 설정 파일에서 레거시 관리 별칭 블록이 제거됩니다:
construct sys shims --install # 실제 실행 파일 작성 (기본값 ~/.local/bin)
pi --version # Construct를 통해 샌드박싱됨
ns-pi --version # 실제 호스트 바이너리, 샌드박스 없음
...
심(Shims)은 모든 인수를 사용하여 construct <slug>을 실행합니다. stdin/stdout은 변경되지 않고 그대로 전달되므로, RPC 모드(예: pi --mode rpc)의 에이전트는 stdout에 JSON 스트리밍을 계속 유지할 수 있습니다. 오케스트레이터가 전달하는 호스트 경로 인수들(pi --extension, --mcp-config, --session)은 자동으로 construct 홈으로 스테이징되고 컨테이너 경로로 재작성되므로, 하네스(harness) 기반 에이전트는 브리지를 온전히 유지하며 샌드박스 처리되어 실행됩니다. 명시적인 에이전트 바이너리를 허용하는 하네스(예: Paseo의 PI_COMMAND)는 심 파일 자체를 직접 가리킬 수도 있습니다. 오케스트레이터를 위한 전체 설정 가이드 (데몬 마운트, PATH, 문제 해결): docs/HARNESSES.md.
# 엄격한 네트워크 격리 (허용 목록만)
construct claude -ct-n strict "제 코드 검토해줘"
...
| 주제 | 설명 |
|---|---|
| 설치(Installation) | 플랫폼별 설치, 문제 해결 |
| ... |
| 주제 | 설명 |
|---|---|
| 비밀 정보 숨기기 모드(Hide Secrets Mode) | 에이전트가 원시 비밀 정보를 보는 것을 방지함 (실험적) |
| ... |
| 주제 | 설명 |
|---|---|
| Agents | 지원되는 에이전트 전체 목록 |
| ... |
# 시스템 명령어
construct sys init # 최초 설정
construct sys doctor # 상태 확인
...
내장 보호 기능:
backend = "msb") - 문서 보기빌드 무결성:
기여를 환영합니다! 다음 문서를 참고하세요:
MIT License - 자세한 내용은 LICENSE 참조
제 아이들을 위해 ❤️로 제작되었습니다. 마음껏 실험하고 즐기세요. 재미있게 사용하세요.
문서: docs/ | 이슈: GitHub Issues | 릴리스: GitHub Releases