Windows (WSL)
최상의 경험을 위해 WSL을 사용하여 Windows에서 OpenCode를 실행하세요.
OpenCode는 Windows에서 직접 실행할 수 있지만, 최상의 경험을 위해 Windows Subsystem for Linux (WSL) (opens in a new tab)을 사용하는 것을 권장합니다. WSL은 OpenCode의 기능과 원활하게 작동하는 Linux 환경을 제공합니다.
왜 WSL인가요?
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
Desktop 앱 + WSL 서버
OpenCode Desktop 앱을 사용하면서 서버는 WSL에서 실행하고 싶다면:
-
WSL에서 서버 시작 시
--hostname 0.0.0.0을 사용하여 외부 연결을 허용하세요:opencode serve --hostname 0.0.0.0 --port 4096 -
Desktop 앱 연결
http://localhost:4096으로 연결하세요
설정에서 localhost가 작동하지 않는 경우, WSL IP 주소를 사용하여 연결하세요 (WSL에서: hostname -I) 그리고 http://<wsl-ip>:4096을 사용하세요.
--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가장 원활한 경험을 위해, 저장소를 WSL 파일 시스템 내에 클론/복사하고 (예: ~/code/ 아래) 거기서 OpenCode를 실행하는 것을 고려해 보세요.
팁
- Windows 드라이브에 저장된 프로젝트의 경우 WSL에서 OpenCode를 계속 실행하세요 - 파일 접근이 원활합니다
- 통합 개발 워크플로우를 위해 VS Code의 WSL 확장 (opens in a new tab)을 OpenCode와 함께 사용하세요
- OpenCode 설정과 세션은 WSL 환경 내
~/.local/share/opencode/에 저장됩니다