跳转到内容

Windows (WSL)

通过 WSL 在 Windows 上运行 Vikasit Code 以获得最佳体验。

虽然 Vikasit Code 可以直接在 Windows 上运行,但我们推荐使用 Windows Subsystem for Linux (WSL) 以获得最佳体验。WSL 提供了一个 Linux 环境,能够与 Vikasit Code 的各项功能无缝配合。


安装配置

  1. 安装 WSL

    如果尚未安装,请参照 Microsoft 官方指南安装 WSL

  2. 在 WSL 中安装 Vikasit Code

    WSL 设置完成后,打开 WSL 终端,使用任一安装方式安装 Vikasit Code。

    Terminal window
    curl -fsSL https://opencode.ai/install | bash
  3. 从 WSL 中使用 Vikasit Code

    导航到你的项目目录(通过 /mnt/c//mnt/d/ 等路径访问 Windows 文件),然后运行 Vikasit Code。

    Terminal window
    cd /mnt/c/Users/YourName/project
    vikasit

桌面应用 + WSL 服务器

如果你希望使用 Vikasit Code 桌面应用,同时在 WSL 中运行服务器:

  1. 在 WSL 中启动服务器,添加 --hostname 0.0.0.0 以允许外部连接:

    Terminal window
    vikasit serve --hostname 0.0.0.0 --port 4096
  2. 在桌面应用中连接到 http://localhost:4096

Terminal window
VIKASIT_SERVER_PASSWORD=your-password vikasit serve --hostname 0.0.0.0

Web 客户端 + WSL

要在 Windows 上获得最佳的 Web 体验:

  1. 在 WSL 终端中运行 vikasit web,而非在 PowerShell 中运行:

    Terminal window
    vikasit web --hostname 0.0.0.0
  2. 在 Windows 浏览器中访问 http://localhost:<port>(Vikasit Code 会输出该 URL)

从 WSL 中运行 vikasit web 可确保正确的文件系统访问和终端集成,同时仍可通过 Windows 浏览器进行访问。


访问 Windows 文件

WSL 可以通过 /mnt/ 目录访问你的所有 Windows 文件:

  • C: 盘 → /mnt/c/
  • D: 盘 → /mnt/d/
  • 其他盘符以此类推…

示例:

Terminal window
cd /mnt/c/Users/YourName/Documents/project
vikasit

使用技巧

  • 对于存储在 Windows 驱动器上的项目,在 WSL 中运行 Vikasit Code 即可无缝访问文件
  • 搭配 VS Code 的 WSL 扩展 使用 Vikasit Code,打造一体化的开发工作流
  • Vikasit Code 的配置和会话数据存储在 WSL 环境中的 ~/.local/share/opencode/