Windows (WSL)

通过 WSL 在 Windows 上运行 OpenCode 以获得最佳体验。

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

为什么选择 WSL？

WSL 提供更出色的文件系统性能、完整的终端支持，以及与 OpenCode 所依赖的开发工具的良好兼容性。

安装配置

安装 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 桌面应用，同时在 WSL 中运行服务器：

在 WSL 中启动服务器，添加 --hostname 0.0.0.0 以允许外部连接：
```
opencode serve --hostname 0.0.0.0 --port 4096
```
在桌面应用中连接到 http://localhost:4096

如果 localhost 在你的环境中无法使用，请改用 WSL 的 IP 地址进行连接（在 WSL 中运行：hostname -I），使用 http://<wsl-ip>:4096。

使用 --hostname 0.0.0.0 时，请设置 OPENCODE_SERVER_PASSWORD 以保护服务器安全。

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

为了获得更流畅的体验，建议将仓库克隆或复制到 WSL 文件系统中（例如 ~/code/ 目录下），然后在该位置运行 OpenCode。