WSL+OpenCode最佳实践：环境一致、模型配置与GUI远程使用

数码系统

相机 win10

测评 win11

手机智车

华为 Tesla

小米理想

苹果蔚来

游戏软件

LOL 抖音

原神微信

当前位置：首页

AI教程

WSL+OpenCode最佳实践：环境一致、模型配置与GUI远程使用

热心网友时间：2026-06-06

转载

序言说到在 Windows 上安装 OpenCode，官方最推荐的方案其实是借助 WSL（Windows Subsystem for Linux）。如果你此前没有接触过 WSL，可能会觉得有点门槛——但请放心，整套流程实际上非常顺畅。本文将以 WSL 环境为基础，手把手带你完成 OpenCode

序言

说到在 Windows 上安装 OpenCode，官方最推荐的方案其实是借助 WSL（Windows Subsystem for Linux）。如果你此前没有接触过 WSL，可能会觉得有点门槛——但请放心，整套流程实际上非常顺畅。本文将以 WSL 环境为基础，手把手带你完成 OpenCode 的安装与启动。

顺便多说一句：如果你是 Windows 平台的开发者，强烈建议尽早配置好 WSL。毕竟最终代码都要部署到 Linux 服务器上运行，在本地使用与线上完全一致的环境进行开发和调试，能帮你避开不少潜在的坑。

OpenCode 的 GitHub 仓库

先附上官方仓库地址：OpenCode GitHub 仓库

OpenCode 官网

中文官网直达链接：OpenCode 中文官网

1. 通过 WSL 安装 OpenCode

打开你的 WSL 终端，直接运行下面这条命令即可：

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

没错，仅需这一行，安装即告完成。整个过程无需繁琐的依赖配置，干净利落。

2. 使用 OpenCode

2.1 先配置好环境变量

安装完成后，务必让 shell 重新加载配置文件，这样才能让 opencode 命令全局生效：

source /home/wangyi/.bashrc

执行一次后永久有效。即使重启电脑，后续直接输入 opencode 即可启动。

2.2 启动 OpenCode

进入你想要工作的项目目录，然后输入：

opencode

一切准备就绪。

2.3 查看 OpenCode 命令的实际位置

如需确认命令安装路径，可以使用以下两个命令进行查询：

which opencode
whereis opencode

2.4 将代码复制到 WSL 文件系统

虽然 WSL 可以通过 /mnt/c/ 访问 Windows 盘符，但 OpenCode 官方依然建议将项目仓库放在 WSL 自身的文件系统下（例如 /home/wangyi/projects）。这样做能获得更好的性能，并减少兼容性问题。建议不要直接使用 /mnt/d 进行开发操作，体验会有所下降。

3. 为 OpenCode 配置大模型

3.1 配置智谱大模型 GLM-5

配置方式非常简单：在 OpenCode 界面中选择对应的大模型提供商，填入你的 API Key 即可。具体步骤可参考官方文档，此处不再截图展示。

3.2 切换免费大模型

OpenCode 自带了一些免费的大模型可供使用——对预算敏感的用户可以放心体验。在设置中直接切换即可生效，无需额外付费。

3.3 查看 model.json 文件

如果你想知道当前使用了哪些模型，可以打开 /home/wangyi/.local/state/opencode 目录下的 model.json，其中记录了最近使用过的模型列表。

3.4 配置文件 auth.json

API Key 等认证信息存储在 auth.json 中，同样位于上述目录。调整模型配置时可能会用到该文件。

4. OpenCode 图形化界面

前面几步均为纯命令行操作，但如果你不习惯在终端中频繁敲击，OpenCode 同样支持图形界面。思路如下：将 Windows 作为显示器，WSL（Linux）作为后端服务器，通过远程连接的方式在 Windows 桌面上操作 WSL 中的代码。代码、模型、环境全部在 Linux 中，但界面显示在 Windows 上。

4.1 下载 OpenCode 桌面应用

前往 OpenCode 官网下载 Windows 版桌面客户端（注意：目前仍为 Beta 版本，可能存在一些小 bug，但基本功能稳定可靠）。

4.2 在 WSL 上启动 OpenCode 服务

在 WSL 终端中执行：

opencode serve --hostname 0.0.0.0 --port 4096

这样 OpenCode 便在 WSL 中开启了一个服务，等待客户端连接。

4.3 在 Windows 上连接 WSL 的 OpenCode 服务器

打开 Windows 上的 OpenCode 客户端，添加远程服务器。注意：localhost 有时连接不上，建议使用 IP 地址。在 WSL 中运行 hostname -I 即可获取当前 WSL 的 IP，填写该地址即可。

连接成功后，Windows 上即可展示 WSL 中的 OpenCode 界面。操作体验与本地应用无异，但所有计算与存储均在 WSL 的 Linux 环境中完成——相当于将 Windows 当作一台远程显示器使用。

5. 在 VS Code 中使用 OpenCode

如果你更习惯使用 VS Code，同样可以将其作为远程客户端连接 WSL。原理与上述相同：Windows 负责显示，WSL 提供开发环境。

5.1 安装 Remote Development 插件

前往 VS Code 扩展市场搜索并安装 Remote Development 插件。注意不要单独安装 WSL 插件，该插件包已集成了 WSL、SSH、容器三种远程连接能力，一个扩展即可满足需求。

5.2 关闭火绒安全软件的 ARP 攻击防护

这一步容易踩坑：如果你的电脑安装了火绒，其 ARP 攻击防护功能可能会拦截 WSL 与 Windows 之间的通信。建议在连接前临时关闭该功能，否则 VS Code 可能无法正常连接 WSL。

5.3 使用 Remote Development 插件远程连接 WSL

在 VS Code 左下角点击远程连接图标，选择 "Remote-WSL: New Window"，VS Code 会自动检测到 WSL 并建立连接。整个过程无需手动输入 IP，它将自动完成。连接成功后，VS Code 左下角会显示 "WSL: Ubuntu" 等字样，此时你打开的终端、运行的代码均在 WSL 环境中。

5.4 退出 WSL

退出操作同样简便：在 VS Code 中关闭远程窗口，或直接在 WSL 终端中输入 exit 命令即可退出。

6. 在浏览器中使用 OpenCode+WSL

除了桌面客户端和 VS Code，你还可以直接通过浏览器访问 OpenCode 的 Web 界面。在 WSL 中启动 OpenCode 服务时，加上 --web 参数即可开启 Web 模式，然后在 Windows 浏览器中输入 WSL 的 IP 加端口号即可访问。这种方式非常适合轻量级操作，无需安装任何额外软件。