답변게시됨2시간 전Last edited 2시간 전15 소스

Windows 10 설치 가이드: WSL2에서 안전하게 진행하기

현재 프로젝트는 Windows PowerShell이나 CMD만으로 설치하는 방식에 맞춰져 있지 않습니다. WSL2와 Ubuntu를 이용하는 경로가 권장됩니다. Ubuntu 안에서 의존성을 설치하고 저장소를 받은 다음, 사전 점검과 드라이런이 성공한 경우에만 실제 배포를 진행하세요.

게시자GPT Image 2로 이미지 생성

Studio Global AI로 검색 및 팩트체크 인기 페이지 더 보기

연구 답변

주요 시사점

현재 프로젝트는 Windows PowerShell이나 CMD만으로 설치하는 방식에 맞춰져 있지 않습니다. WSL2와 Ubuntu를 이용하는 경로가 권장됩니다.
Ubuntu 안에서 의존성을 설치하고 저장소를 받은 다음, 사전 점검과 드라이런이 성공한 경우에만 실제 배포를 진행하세요.
WSL에 파일을 배포했다고 해서 Windows에서 실행되는 IDE가 설정을 읽는 것은 아닙니다. IDE가 어느 환경에서 실행되는지 별도로 확인해야 합니다.

[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you operate via client side tool execution on theAI-generated editorial hero image for [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you operate via client side tool execution on the.
AI 프롬프트
Create a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you operate via client side tool execution on the. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"当前项目不能直接用 Windows 原生 PowerShell/CMD 完成安装；Win10 上建议采用 WSL2 + Ubuntu 路线。以下是基于已读取源码的安装建议，未在 Win10 实机验证，也未执行安装或修改项目。\n\n 兼容性结论\n\n 安装依赖 Bash、Git、GNU timeout、Pyth. Topic tags: general web, workflow, code, python, api. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts wit
openai.com

현재 프로젝트는 Windows 기본 PowerShell이나 CMD에서 바로 설치하기 어렵습니다. Windows 10에서는 WSL2와 Ubuntu를 사용하는 방식을 권합니다. 아래 절차는 저장소 코드를 살펴본 뒤 정리한 것으로, Windows 10 실기기에서 검증하거나 실제 설치·수정을 진행한 것은 아닙니다.

먼저 확인할 점: Windows 기본 환경과의 호환성

프로젝트는 Bash, Git, GNU timeout, Python 3.10 이상, PyYAML을 필요로 합니다. README.md
배포 모듈이 Unix 전용 파일 잠금 모듈을 직접 불러옵니다. Windows 네이티브 Python에서는 이 모듈을 사용할 수 없으므로, Git Bash와 Windows용 Python만 설치해도 호환성 문제가 해결되지는 않습니다. asset_safety.py 7
모드 자동 검색도 Linux의 저장 경로를 기준으로 합니다. deployment_targets.py 따라서 WSL 안에 파일을 배포하는 것만으로 Windows 네이티브 IDE에 설정이 적용되는 것은 아닙니다.

1. Windows 10에 WSL 설치하기

아래 절차는 WSL2를 사용할 수 있는 환경을 기준으로 합니다. Microsoft의 간편 설치 명령은 업데이트된 Windows 10 버전 2004 이상에서 지원되며, 이전 버전은 수동 설치가 필요할 수 있습니다. 15 10

관리자 권한으로 PowerShell을 열고 다음 명령을 실행합니다. 12

wsl --install -d Ubuntu

안내에 따라 컴퓨터를 다시 시작한 뒤, Ubuntu를 처음 실행할 때 Linux 사용자 이름과 비밀번호를 만듭니다. 3

설치된 배포판이 WSL2를 사용하는지 확인합니다. 12

wsl --list --verbose

Ubuntu의 VERSION이 1이라면 다음 명령으로 WSL2로 전환합니다. 12

wsl --set-version Ubuntu 2

2. Ubuntu에서 의존성 설치 및 저장소 받기

이 단계의 명령은 Ubuntu 터미널에서 실행하세요. 먼저 관리자 인증을 완료한 뒤 프로젝트 의존성을 설치합니다. 명령이 하나라도 실패하면 중단하고, 다음 단계로 넘어가지 마세요.

sudo -v

timeout 600s sudo -n apt-get update < /dev/null &&
timeout 600s sudo -n env DEBIAN_FRONTEND=noninteractive apt-get install -y git coreutils python3 python3-yaml < /dev/null

원하는 Linux 작업 디렉터리에서 저장소를 복제합니다. 저장소 주소는 install.sh에 기재돼 있습니다.

timeout 30s env GIT_TERMINAL_PROMPT=0 git -c core.autocrlf=false -c core.hooksPath=/dev/null clone --no-recurse-submodules --branch main https://github.com/zhaosan2023/dotfiles-bmad-solo.git dotfiles-bmad-solo < /dev/null

복제가 완료되면 저장소 디렉터리로 이동합니다.

cd dotfiles-bmad-solo

실행하기 전에 내려받은 install.sh와 bs.sh를 직접 검토하세요. 원격 스크립트를 검토 없이 파이프로 넘겨 실행하지 않는 것이 좋습니다. 프로젝트도 신뢰할 수 있는 버전인지 먼저 살펴보라고 안내합니다. README.md

3. 사전 점검 후 설치 진행하기

저장소 루트에서 변경을 가하지 않는 사전 점검과 드라이런을 실행합니다. 두 옵션은 bs.sh에서 지원합니다.

timeout 30s bash bs.sh --preflight < /dev/null &&
timeout 30s bash bs.sh --dry-run < /dev/null

사전 점검이 통과하고 대상이 올바른지 확인했으며, 현재 Linux 사용자의 전역 설정에 쓰기를 진행해도 괜찮을 때만 실제 배포를 실행합니다. 이어서 상태를 확인합니다. README.md

timeout 30s bash bs.sh < /dev/null &&
timeout 15s bash bs.sh --status < /dev/null

기존 파일과 충돌하거나 설정이 손상됐거나 미완료 트랜잭션이 있다고 보고되면, 먼저 해당 문제를 해결하세요. 상태 기록을 지우거나 강제로 덮어쓰지 마세요. README.md

4. IDE가 실제로 실행되는 환경 확인하기

VS Code를 사용한다면 Windows에 VS Code와 WSL 확장을 설치한 뒤 Ubuntu 작업 공간에 연결할 수 있습니다. Microsoft도 이 방식을 WSL 개발 환경으로 안내합니다. 9
다만 Roo가 실제로 어느 확장 호스트에서 실행되는지, 모드 설정이 그 호스트에서 읽히는지는 별도로 확인해야 합니다. 프로젝트도 런타임에서 독립적인 검증을 하도록 안내합니다. README.md
Windows 네이티브로 실행되는 Antigravity, Gemini, Roo를 사용한다면 WSL에 배포한 것을 Windows 네이티브 설치 성공으로 간주하지 마세요. 현재 자동 검색은 Windows 네이티브 설정 경로를 대상으로 하지 않습니다. deployment_targets.py

정리하면: WSL2를 사용할 수 있다면 위 절차로 설치를 시도할 수 있습니다. 반대로 프로젝트를 Windows 네이티브 환경에서만 실행해야 한다면, 현재 코드만으로는 권할 만한 완전한 설치 절차가 없습니다. 파일 잠금과 권한 처리, 디렉터리 동기화, Windows 설정 경로에 대한 조정이 선행돼야 합니다. 파일 배포가 완료됐더라도 IDE에서 설정이 로드되고 권한 검증까지 통과했다는 뜻은 아닙니다. README.md

Studio Global AI

연구를 계속하세요

이 페이지에는 Studio Global 내에서 계속할 수 있는 소스 기반 답변이 포함되어 있습니다.

Studio Global AI로 검색 및 팩트체크

사람들은 또한 묻습니다.