blob: e75ad41f1cd0e005096e1899babd3ea9c4d680ee (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
---
title: Windows (WSL)
description: WSL로 Windows에서 opencode를 더 편하게 사용하세요.
---
import { Steps } from "@astrojs/starlight/components"
opencode는 Windows에서 직접 실행할 수 있지만, 가장 좋은 사용 경험을 위해 [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) 사용을 권장합니다. WSL은 opencode 기능과 자연스럽게 동작하는 Linux 환경을 제공합니다.
:::tip[왜 WSL인가요?]
WSL은 더 나은 파일 시스템 성능, 완전한 terminal 지원, 그리고 opencode가 의존하는 개발 도구와의 호환성을 제공합니다.
:::
---
## 설정
<Steps>
1. **WSL 설치하기**
아직 설치하지 않았다면 Microsoft 공식 가이드를 따라 [WSL을 설치](https://learn.microsoft.com/en-us/windows/wsl/install)하세요.
2. **WSL에 opencode 설치하기**
WSL 설정이 끝나면 WSL terminal을 열고 [설치 방법](/docs/) 중 하나로 opencode를 설치하세요.
```bash
curl -fsSL https://opencode.ai/install | bash
```
3. **WSL에서 opencode 실행하기**
프로젝트 디렉터리로 이동한 뒤(opencode에서 Windows 파일은 `/mnt/c/`, `/mnt/d/` 등으로 접근) opencode를 실행하세요.
```bash
cd /mnt/c/Users/YourName/project
opencode
```
</Steps>
---
## 데스크톱 앱 + WSL 서버
opencode 데스크톱 앱을 쓰면서 서버는 WSL에서 실행하고 싶다면 다음처럼 진행하세요.
1. **WSL에서 서버 시작하기**
외부 연결을 허용하려면 `--hostname 0.0.0.0` 옵션을 사용하세요.
```bash
opencode serve --hostname 0.0.0.0 --port 4096
```
2. **데스크톱 앱 연결하기**
`http://localhost:4096`로 연결하세요.
:::note
환경에 따라 `localhost`가 동작하지 않으면 WSL의 IP 주소를 사용하세요(WSL에서 `hostname -I` 실행). 이후 `http://<wsl-ip>:4096`로 접속하면 됩니다.
:::
:::caution
`--hostname 0.0.0.0`을 사용할 때는 `OPENCODE_SERVER_PASSWORD`를 설정해 서버를 보호하세요.
```bash
OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
```
:::
---
## 웹 클라이언트 + WSL
Windows에서 웹 사용 경험을 가장 좋게 하려면:
1. **PowerShell 대신 WSL terminal에서 `opencode web` 실행하기**
```bash
opencode web --hostname 0.0.0.0
```
2. **Windows 브라우저에서 접속하기**
`http://localhost:<port>`로 접속하세요(opencode가 URL을 출력합니다).
WSL에서 `opencode web`를 실행하면 올바른 파일 시스템 접근과 terminal 통합을 유지하면서도 Windows 브라우저에서 바로 사용할 수 있습니다.
---
## Windows 파일 접근
WSL에서는 `/mnt/` 디렉터리를 통해 Windows 파일 전체에 접근할 수 있습니다.
- `C:` drive → `/mnt/c/`
- `D:` drive → `/mnt/d/`
- 다른 드라이브도 같은 방식입니다
예시:
```bash
cd /mnt/c/Users/YourName/Documents/project
opencode
```
:::tip
가장 매끄러운 경험을 원한다면 저장소를 WSL 파일시스템(예: `~/code/`)으로 복제하거나 복사한 뒤 그 위치에서 opencode를 실행해 보세요.
:::
---
## 팁
- Windows 드라이브에 있는 프로젝트라도 opencode는 WSL에서 실행하면 파일 접근이 더 자연스럽습니다
- 통합된 개발 워크플로를 위해 opencode와 함께 VS Code의 [WSL 확장](https://code.visualstudio.com/docs/remote/wsl)을 사용해 보세요
- opencode 설정과 세션은 WSL 환경의 `~/.local/share/opencode/`에 저장됩니다
|
