Windows (WSL)

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

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

설정

WSL 설치하기

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

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

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

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

WSL에서 서버 시작하기

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

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

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

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

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

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

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

예시:

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