Windows (WSL)

최상의 경험을 위해 WSL을 사용하여 Windows에서 OpenCode를 실행하세요.

OpenCode는 Windows에서 직접 실행할 수 있지만, 최상의 경험을 위해 Windows Subsystem for Linux (WSL) (opens in a new tab) 사용을 권장합니다. WSL은 OpenCode의 기능과 원활하게 작동하는 Linux 환경을 제공합니다.

Tip: WSL은 더 나은 파일 시스템 성능, 전체 터미널 지원, 그리고 OpenCode가 의존하는 개발 도구와의 호환성을 제공합니다.

설정

WSL 설치 아직 하지 않았다면, 공식 Microsoft 가이드를 사용하여 WSL을 설치하세요 (opens in a new tab).
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
```

데스크톱 앱 + WSL 서버

OpenCode 데스크톱 앱을 사용하면서 서버는 WSL에서 실행하려는 경우:

WSL에서 서버 시작, 외부 연결을 허용하기 위해 --hostname 0.0.0.0 사용:
```
opencode serve --hostname 0.0.0.0 --port 4096
```
데스크톱 앱 연결, http://localhost:4096으로

Note: 설정에서 localhost가 작동하지 않으면, 대신 WSL IP 주소(WSL에서 hostname -I)를 사용하여 연결하고 http://<wsl-ip>:4096을 사용하세요.

Caution: --hostname 0.0.0.0을 사용할 때는, 서버를 보호하기 위해 OPENCODE_SERVER_PASSWORD를 설정하세요.

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

웹 클라이언트 + WSL

Windows에서 최상의 웹 경험을 위해:

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

WSL에서 opencode web을 실행하면 적절한 파일 시스템 접근과 터미널 통합을 보장하면서도 Windows 브라우저에서 접근할 수 있습니다.

Windows 파일 접근

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

C: 드라이브 → /mnt/c/
D: 드라이브 → /mnt/d/
등등...

예시:

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

Tip: 가장 매끄러운 경험을 위해, 저장소를 WSL 파일 시스템으로(예: ~/code/ 아래에) 클론/복사하고 거기서 OpenCode를 실행하는 것을 고려하세요.

팁

Windows 드라이브에 저장된 프로젝트의 경우 OpenCode를 WSL에서 계속 실행하세요 - 파일 접근이 원활합니다
통합 개발 워크플로우를 위해 OpenCode와 함께 VS Code의 WSL 확장 (opens in a new tab)을 사용하세요
OpenCode 설정과 세션은 WSL 환경 내의 ~/.local/share/opencode/에 저장됩니다

문제 해결 TUI