Windows (WSL)

OpenCode는 Windows에서 직접 실행할 수도 있지만, 최상의 환경을 위해 Windows Subsystem for Linux (WSL) 사용을 권장합니다. WSL은 OpenCode의 기능과 매끄럽게 동작하는 Linux 환경을 제공합니다.

설정

WSL 설치

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

WSL 설정이 끝나면 WSL 터미널을 열고 설치 방법 중 하나로 OpenCode를 설치하세요.
```
curl -fsSL https://opencode.ai/install | bash
```
WSL에서 OpenCode 사용

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

OpenCode Desktop 앱을 사용하면서 서버는 WSL에서 실행하고 싶다면 다음을 따르세요.

WSL에서 --hostname 0.0.0.0 옵션으로 서버 시작해 외부 연결을 허용합니다.
```
opencode serve --hostname 0.0.0.0 --port 4096
```
데스크톱 앱을 http://localhost:4096에 연결합니다.

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

Windows에서 최상의 웹 환경을 이용하려면 다음을 따르세요.

PowerShell이 아닌 WSL 터미널에서 opencode web 실행
```
opencode web --hostname 0.0.0.0
```
Windows 브라우저에서 http://localhost:<port>로 접속 (OpenCode가 URL을 출력합니다)

WSL에서 opencode web을 실행하면 Windows 브라우저에서 접근할 수 있으면서도 파일 시스템 접근과 터미널 통합이 원활합니다.

WSL은 /mnt/ 디렉터리를 통해 모든 Windows 파일에 접근할 수 있습니다.

예시:

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