Windows (WSL)

在 Windows 透過 WSL 使用 opencode。

雖然 opencode 可以直接在 Windows 上執行，但為了獲得最佳體驗，我們建議使用 Windows Subsystem for Linux (WSL)。WSL 提供了可與 opencode 功能順暢配合的 Linux 環境。

設定

安裝 WSL

如果你尚未安裝，請依照 Microsoft 官方指南安裝 WSL。
在 WSL 中安裝 opencode

完成 WSL 設定後，打開 WSL terminal，並使用其中一種安裝方式安裝 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

在 Windows 上取得最佳 Web 體驗：

請在 WSL terminal執行 opencode web，而不是在 PowerShell 執行：
Terminal window
```
opencode web --hostname 0.0.0.0
```
在 Windows 瀏覽器中開啟 http://localhost:<port>（opencode 會輸出該 URL）

從 WSL 執行 opencode web 可確保正確的檔案系統存取與terminal整合，同時仍可由 Windows 瀏覽器使用。

WSL 可透過 /mnt/ 目錄存取你所有的 Windows 檔案：

範例：

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