Windows (WSL)

WSL로 Windows에서 vikasit를 더 편하게 사용하세요.

vikasit는 Windows에서 직접 실행할 수 있지만, 가장 좋은 사용 경험을 위해 Windows Subsystem for Linux (WSL) 사용을 권장합니다. WSL은 vikasit 기능과 자연스럽게 동작하는 Linux 환경을 제공합니다.

설정

WSL 설치하기

아직 설치하지 않았다면 Microsoft 공식 가이드를 따라 WSL을 설치하세요.
WSL에 vikasit 설치하기

WSL 설정이 끝나면 WSL terminal을 열고 설치 방법 중 하나로 vikasit를 설치하세요.
Terminal window
```
curl -fsSL https://opencode.ai/install | bash
```
WSL에서 vikasit 실행하기

프로젝트 디렉터리로 이동한 뒤(vikasit에서 Windows 파일은 /mnt/c/, /mnt/d/ 등으로 접근) vikasit를 실행하세요.
Terminal window
```
cd /mnt/c/Users/YourName/project
vikasit
```

vikasit 데스크톱 앱을 쓰면서 서버는 WSL에서 실행하고 싶다면 다음처럼 진행하세요.

WSL에서 서버 시작하기

외부 연결을 허용하려면 --hostname 0.0.0.0 옵션을 사용하세요.
Terminal window
```
vikasit serve --hostname 0.0.0.0 --port 4096
```
데스크톱 앱 연결하기

http://localhost:4096로 연결하세요.

Windows에서 웹 사용 경험을 가장 좋게 하려면:

PowerShell 대신 WSL terminal에서 vikasit web 실행하기
Terminal window
```
vikasit web --hostname 0.0.0.0
```
Windows 브라우저에서 접속하기

http://localhost:<port>로 접속하세요(vikasit가 URL을 출력합니다).

WSL에서 vikasit web를 실행하면 올바른 파일 시스템 접근과 terminal 통합을 유지하면서도 Windows 브라우저에서 바로 사용할 수 있습니다.

WSL에서는 /mnt/ 디렉터리를 통해 Windows 파일 전체에 접근할 수 있습니다.

예시:

cd /mnt/c/Users/YourName/Documents/project
vikasit