Windows 与 WSL
在 WSL 运行 CLI 或服务，并由 Windows 桌面应用及浏览器连接。
This page has not been translated into English yet. The original Chinese version is shown below.
OpenCode 可以直接运行在 Windows 上，官方更推荐 WSL。WSL 内运行的进程、文件和会话数据属于 Linux 环境，应与原生 Windows 安装区分。
在 WSL 开始工作
按 Microsoft 官方流程完成 WSL 安装后，打开 WSL 终端并安装 OpenCode：
curl -fsSL https://opencode.ai/install | bashWindows 磁盘可通过 /mnt/ 访问，例如 C 盘对应 /mnt/c/。进入实际项目路径后启动：
cd /mnt/c/Users/YourName/project
opencode将示例用户名和项目路径替换为真实值。官方建议为更流畅的体验，把仓库放到 WSL 文件系统，例如 ~/code/，也可以配合 VS Code 的 WSL 扩展。
桌面应用连接 WSL 服务
在 WSL 启动服务并允许外部连接：
OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0 --port 4096这是把官方服务命令与密码环境变量放到同一次启动中的示例，需将密码占位替换为自己的值。监听 0.0.0.0 时官方要求设置 OPENCODE_SERVER_PASSWORD。
在桌面应用连接 http://localhost:4096。如果该环境中的 localhost 转发不可用，在 WSL 运行 hostname -I 获取地址，再连接 http://<wsl-ip>:4096。
在 Windows 浏览器使用 Web 客户端
在 WSL 终端运行 opencode web --hostname 0.0.0.0，根据终端打印的端口从 Windows 浏览器访问 http://localhost:<port>。对外监听时同样配置服务密码，不应将浏览器入口与无需认证的本地页面混为一谈。
官方建议在 WSL 而非 PowerShell 中启动这个 Web 流程，以保持文件系统与终端集成。
数据位置与原生桌面问题
WSL 下的数据位于该 Linux 环境的 ~/.local/share/opencode/。配置文件位置要按具体类型核对；不能把 WSL 教程对数据存储的概述理解为所有配置都放在这个目录。
原生 Windows 桌面应用依赖 Microsoft Edge WebView2 Runtime。白屏或无法启动时检查该运行时；缓慢、文件访问或终端问题可尝试 WSL。更多诊断见故障排查。