Windows (WSL)

在 Windows 上使用 WSL 运行 OpenCode 以获得最佳体验。

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

💡

为什么选择 WSL？

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

安装配置

安装 WSL

如果你还没有安装，请参考 Microsoft 官方指南安装 WSL (opens in a new tab)。
在 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。