Windows (WSL)

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

虽然 OpenCode 可以直接在 Windows 上运行，但我们建议使用 Windows Subsystem for Linux (WSL)↗ 以获得最佳体验。WSL 提供了一个与 OpenCode 功能无缝配合的 Linux 环境。

为什么选择 WSL？

WSL 提供了更好的文件系统性能、完整的终端支持，并且与 OpenCode 依赖的开发工具兼容性更好。

# 安装设置#

1. 安装 WSL

   如果你还没有安装，请使用微软官方指南 安装 WSL↗。

2. 在 WSL 中安装 OpenCode

   WSL 设置完成后，打开你的 WSL 终端并使用以下 安装方法 之一安装 OpenCode。

   bash
   复制
   curl -fsSL https://opencode.ai/install | bash

3. 从 WSL 使用 OpenCode

   导航到你的项目目录（通过 /mnt/c/, /mnt/d/ 等访问 Windows 文件）并运行 OpenCode。

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

# 桌面应用 + WSL 服务器#

如果你更喜欢使用 OpenCode 桌面应用，但想在 WSL 中运行服务器：

1. 在 WSL 中启动服务器，使用 --hostname 0.0.0.0 允许外部连接：

   bash
   复制
   opencode serve --hostname 0.0.0.0 --port 4096

2. 连接桌面应用 到 http://localhost:4096

注意 如果 localhost 在你的设置中无法工作，请使用 WSL IP 地址代替（在 WSL 中运行 hostname -I 获取），并使用 http://<wsl-ip>:4096。

警告 当使用 --hostname 0.0.0.0 时，请设置 OPENCODE_SERVER_PASSWORD 以保护服务器。

bash
复制
OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

# Web 客户端 + WSL#

为了在 Windows 上获得最佳的 Web 体验：

1. 在 WSL 终端中运行 opencode web 而不是 PowerShell：

   bash
   复制
   opencode web --hostname 0.0.0.0

2. 从你的 Windows 浏览器访问 http://localhost:<port>（OpenCode 会打印 URL）

从 WSL 运行 opencode web 确保了正确的文件系统访问和终端集成，同时仍然可以从你的 Windows 浏览器访问。

# 访问 Windows 文件#

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

• C: 盘 → /mnt/c/
• D: 盘 → /mnt/d/
• 以此类推...

示例：

bash
复制
cd /mnt/c/Users/YourName/Documents/project
opencode

提示 为了获得最流畅的体验，建议将你的仓库克隆/复制到 WSL 文件系统中（例如在 ~/code/ 下），并在那里运行 OpenCode。

# 提示#

• 对于存储在 Windows 驱动器上的项目，保持 OpenCode 在 WSL 中运行 - 文件访问是无缝的
• 使用 VS Code 的 WSL 扩展↗ 配合 OpenCode 以获得集成的开发工作流
• 你的 OpenCode 配置和会话存储在 WSL 环境中的 ~/.local/share/opencode/