Windows 与 WSL
在 WSL 运行 CLI 或服务，并由 Windows 桌面应用及浏览器连接。
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。更多诊断见故障排查。