Windows（WSL）

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

设置

安装 WSL

如果你还没有安装，请按照 Microsoft 官方指南安装 WSL。
在 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
```

如果你更倾向于使用 OpenCode Desktop 应用，但希望在 WSL 中运行服务器：

在 WSL 中启动服务器时使用 --hostname 0.0.0.0 以允许外部连接：
```
opencode serve --hostname 0.0.0.0 --port 4096
```
将 Desktop 应用连接到 http://localhost:4096

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

要在 Windows 上获得最佳的 Web 体验：

在 WSL 终端中运行 opencode web，而不是在 PowerShell 中运行：
```
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