Windows (WSL)

透過 WSL 在 Windows 上執行 OpenCode 以獲得最佳體驗。

雖然 OpenCode 可以直接在 Windows 上執行，但我們推薦使用 Windows Subsystem for Linux (WSL) 以獲得最佳體驗。WSL 提供了一個 Linux 環境，能夠與 OpenCode 的各項功能無縫配合。

安裝設定

安裝 WSL

如果尚未安裝，請參照 Microsoft 官方指南安裝 WSL。
在 WSL 中安裝 OpenCode

WSL 設定完成後，開啟 WSL 終端機，使用任一安裝方式安裝 OpenCode。
Terminal window
```
curl -fsSL https://opencode.ai/install | bash
```
從 WSL 中使用 OpenCode

導航到你的專案目錄（透過 /mnt/c/、/mnt/d/ 等路徑存取 Windows 檔案），然後執行 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

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

要在 Windows 上獲得最佳的 Web 體驗：

在 WSL 終端機中執行 opencode web，而非在 PowerShell 中執行：
Terminal window
```
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