Windows (WSL)

在 Windows 上通过 WSL 使用 opencode。

虽然 opencode 可以直接在 Windows 上运行，但为了获得最佳体验，我们推荐使用 Windows Subsystem for Linux (WSL)。WSL 提供了一个与 opencode 功能无缝协作的 Linux 环境。

设置

安装 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

在 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