Skip to content

Windows (WSL)

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

为什么用 WSL

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

安装步骤

  1. 安装 WSL:参考 Microsoft 官方指南

  2. 在 WSL 中安装 OpenCode

    bash
    curl -fsSL https://opencode.ai/install | bash
  3. 从 WSL 使用 OpenCode

    bash
    cd /mnt/c/Users/YourName/project
    opencode

桌面应用 + WSL 服务端

在 WSL 中启动服务端,桌面应用连接:

bash
opencode serve --hostname 0.0.0.0 --port 4096

使用 --hostname 0.0.0.0 时,需设置 OPENCODE_SERVER_PASSWORD 保护服务端。

Web 客户端 + WSL

bash
opencode web --hostname 0.0.0.0

访问 Windows 文件

  • C: 盘 → /mnt/c/
  • D: 盘 → /mnt/d/

建议将项目克隆到 WSL 文件系统中(如 ~/code/)以获得最佳体验。

实用提示

  • WSL 中保持 OpenCode 运行,文件访问无缝
  • 配合 VS Code 的 WSL 扩展使用
  • 配置和会话存储在 ~/.local/share/opencode/