Windows (WSL)

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

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

提示： 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。