相信大家都知道Opencode一款开源的AI编程助手。对 liunx、mac系统比较友好。我们虽然可以使用桌面bata版本勉强体验但是在开发大型项目中整体感受执行命令、性能方面不如Liunx系统。官方也推荐windows用户可以基于WSL来使用这期教程教大家基于WSL流畅的使用Opencode进行前后端开发WSL 安装在管理员模式下打开 PowerShell输入 wsl --install 命令然后重新启动计算机官方地址链接: https://learn.microsoft.com/zh-cn/windows/wsl/installwsl--install在 WSL 中安装 OpenCodeWSL安装完成后打开WSL终端执行下方命令就可以安装Opencode, 安装好Opencode后需要自定义模型记得配置好对应的模型对应的配置路径如下Windows全局配置C:\Users\你的用户名\.config\opencode\opencode.jsonLiunx( WSL 本次教程配置地址)全局配置~/.config/opencode/opencode.json自定义配置OPENCODE_CONFIG环境变量- 自定义覆盖curl-fsSL https://opencode.ai/install|bash注意.opencode和~/.config/opencode目录的子目录使用复数名称agents/、commands/、modes/、plugins/、skills/、tools/ 和themes/。为了向后兼容也支持单数名称例如agent/从 WSL 中使用 OpenCode导航到你的项目目录通过 /mnt/c/、/mnt/d/ 等路径访问 Windows 文件然后运行 OpenCode。到这里你就已经可以在WSL使用Opencode进行AI编码了。cd/mnt/c/Users/YourName/project opencode桌面应用 WSL 服务器如果你习惯桌面操作也是在Windows安装Opencode桌面版然后连接Opencode服务; 在 WSL 中启动服务器添加 --hostname 0.0.0.0 以允许外部连接opencode serve--hostname 0.0.0.0--port 4096在桌面应用中连接到 http://localhost:4096注意如果 localhost 在你的环境中无法使用请改用 WSL 的 IP 地址进行连接在 WSL 中运行hostname -I使用http://wsl-ip:4096。警告使用--hostname 0.0.0.0时请设置OPENCODE_SERVER_PASSWORD以保护服务器安全。OPENCODE_SERVER_PASSWORDyour-password opencode serve--hostname 0.0.0.0Web 客户端 WSL要在 Windows 上获得最佳的 Web 体验在WSL终端中运行 opencode web而非在 PowerShell 中运行opencode web--hostname 0.0.0.0本地访问可以执行一下命令opencode web--port 4096可以修改 opencode.json 的 server 选项为 opencode serve 和 opencode web 命令配置服务器设置可用选项port - 监听端口hostname - 监听主机名。当 mdns 启用且未设置主机名时默认为 0.0.0.0。mdns - 启用 mDNS 服务发现。这允许网络上的其他设备发现您的 OpenCode 服务器。mdnsDomain - mDNS 服务的自定义域名。默认为 opencode.local。适用于在同一网络上运行多个实例的场景。cors - 从基于浏览器的客户端使用 HTTP 服务器时允许 CORS 的额外来源。值必须是完整的来源协议 主机 可选端口例如 https://app.example.com。{$schema:https://opencode.ai/config.json,server:{port:4096,hostname:0.0.0.0,mdns:true,mdnsDomain:myproject.local,cors:[http://localhost:5173]}}进阶用法通过/mnt例如 /mnt/c/Users/你的名字访问 Windows 文件虽然在 WSL 中很方便但存在几个不可忽视的缺点尤其在运行 Opencode 这类需要频繁读写、监控文件变化的工具时影响会更明显性能明显下降/mnt 下的文件访问经过 DrvFsDrive File System协议层需要来回转换 Linux 系统调用到 Windows NT 内核调用大量小文件读写如 node_modules、git 仓库、编译产物时速度比在 WSL 原生 Linux 文件系统如 /home慢 2~5 倍随机读写、元数据操作stat、chmod、readdir延迟高对于构建工具、包管理器npm、pip影响显著文件监控inotify不工作或不可靠WSL 2 对 /mnt 的 inotify 支持有限许多工具如 nodemon、webpack --watch、jest --watch、Opencode 的自动重载无法检测到 Windows 侧的文件变更权限和所有权混乱/mnt 下的所有文件默认显示为 root 或默认 WSL 用户无法设置真正的 Linux 用户/组权限chown/chmod 仅能模拟基本标志文件系统特性差异、路径转换开销和兼容问题等优化通过 mnt 访问window文件鉴于两个系统之间的是存在缺陷的我们应该改变方式用 WSL 开发就住在 WSL 的家里别挤在 /mnt 这个“朋友家的客厅”干活 在WSL环境安装好我们开发需要的环境比如node、git、java、maven等按需部署下面我就前后端介绍两种不同的方式VsCode WSL插件安装WSL插件VS code切到远程模式, 添加WSL中的项目进行管理、编译、版本控制在项目路径下执行 Opencode既可唤起AI编程工作IDEA WSL终端Opencode Web界面IDEA支持WSL打开项目、对项目进行开发、编译、版本控制打开路径需要注意打开WSL路径写法\\wsl.localhost\发行版名称\用户目录\项目名例如 \wsl.localhost\Ubuntu\home\test\MyProject自动识别 Git如果 Windows 没装 GitIDEA 会自动调用 WSL 里的 Git无需额外配置如果windows安装了需要指定wsl的git路径例如 \wsl.localhost\Ubuntu\usr\bin\gitMaven配置注意事项maven项目如果拉取不到依赖的话可以把maven的地址、配置、仓库都配置为wsl的maven配置操作到这里恭喜你已经安装完成可以体验AI编程的快乐了…
手把手教你：Windows 下用 WSL 搭建 Opencode 专业开发环境
发布时间：2026/5/28 2:02:07
相信大家都知道Opencode一款开源的AI编程助手。对 liunx、mac系统比较友好。我们虽然可以使用桌面bata版本勉强体验但是在开发大型项目中整体感受执行命令、性能方面不如Liunx系统。官方也推荐windows用户可以基于WSL来使用这期教程教大家基于WSL流畅的使用Opencode进行前后端开发WSL 安装在管理员模式下打开 PowerShell输入 wsl --install 命令然后重新启动计算机官方地址链接: https://learn.microsoft.com/zh-cn/windows/wsl/installwsl--install在 WSL 中安装 OpenCodeWSL安装完成后打开WSL终端执行下方命令就可以安装Opencode, 安装好Opencode后需要自定义模型记得配置好对应的模型对应的配置路径如下Windows全局配置C:\Users\你的用户名\.config\opencode\opencode.jsonLiunx( WSL 本次教程配置地址)全局配置~/.config/opencode/opencode.json自定义配置OPENCODE_CONFIG环境变量- 自定义覆盖curl-fsSL https://opencode.ai/install|bash注意.opencode和~/.config/opencode目录的子目录使用复数名称agents/、commands/、modes/、plugins/、skills/、tools/ 和themes/。为了向后兼容也支持单数名称例如agent/从 WSL 中使用 OpenCode导航到你的项目目录通过 /mnt/c/、/mnt/d/ 等路径访问 Windows 文件然后运行 OpenCode。到这里你就已经可以在WSL使用Opencode进行AI编码了。cd/mnt/c/Users/YourName/project opencode桌面应用 WSL 服务器如果你习惯桌面操作也是在Windows安装Opencode桌面版然后连接Opencode服务; 在 WSL 中启动服务器添加 --hostname 0.0.0.0 以允许外部连接opencode serve--hostname 0.0.0.0--port 4096在桌面应用中连接到 http://localhost:4096注意如果 localhost 在你的环境中无法使用请改用 WSL 的 IP 地址进行连接在 WSL 中运行hostname -I使用http://wsl-ip:4096。警告使用--hostname 0.0.0.0时请设置OPENCODE_SERVER_PASSWORD以保护服务器安全。OPENCODE_SERVER_PASSWORDyour-password opencode serve--hostname 0.0.0.0Web 客户端 WSL要在 Windows 上获得最佳的 Web 体验在WSL终端中运行 opencode web而非在 PowerShell 中运行opencode web--hostname 0.0.0.0本地访问可以执行一下命令opencode web--port 4096可以修改 opencode.json 的 server 选项为 opencode serve 和 opencode web 命令配置服务器设置可用选项port - 监听端口hostname - 监听主机名。当 mdns 启用且未设置主机名时默认为 0.0.0.0。mdns - 启用 mDNS 服务发现。这允许网络上的其他设备发现您的 OpenCode 服务器。mdnsDomain - mDNS 服务的自定义域名。默认为 opencode.local。适用于在同一网络上运行多个实例的场景。cors - 从基于浏览器的客户端使用 HTTP 服务器时允许 CORS 的额外来源。值必须是完整的来源协议 主机 可选端口例如 https://app.example.com。{$schema:https://opencode.ai/config.json,server:{port:4096,hostname:0.0.0.0,mdns:true,mdnsDomain:myproject.local,cors:[http://localhost:5173]}}进阶用法通过/mnt例如 /mnt/c/Users/你的名字访问 Windows 文件虽然在 WSL 中很方便但存在几个不可忽视的缺点尤其在运行 Opencode 这类需要频繁读写、监控文件变化的工具时影响会更明显性能明显下降/mnt 下的文件访问经过 DrvFsDrive File System协议层需要来回转换 Linux 系统调用到 Windows NT 内核调用大量小文件读写如 node_modules、git 仓库、编译产物时速度比在 WSL 原生 Linux 文件系统如 /home慢 2~5 倍随机读写、元数据操作stat、chmod、readdir延迟高对于构建工具、包管理器npm、pip影响显著文件监控inotify不工作或不可靠WSL 2 对 /mnt 的 inotify 支持有限许多工具如 nodemon、webpack --watch、jest --watch、Opencode 的自动重载无法检测到 Windows 侧的文件变更权限和所有权混乱/mnt 下的所有文件默认显示为 root 或默认 WSL 用户无法设置真正的 Linux 用户/组权限chown/chmod 仅能模拟基本标志文件系统特性差异、路径转换开销和兼容问题等优化通过 mnt 访问window文件鉴于两个系统之间的是存在缺陷的我们应该改变方式用 WSL 开发就住在 WSL 的家里别挤在 /mnt 这个“朋友家的客厅”干活 在WSL环境安装好我们开发需要的环境比如node、git、java、maven等按需部署下面我就前后端介绍两种不同的方式VsCode WSL插件安装WSL插件VS code切到远程模式, 添加WSL中的项目进行管理、编译、版本控制在项目路径下执行 Opencode既可唤起AI编程工作IDEA WSL终端Opencode Web界面IDEA支持WSL打开项目、对项目进行开发、编译、版本控制打开路径需要注意打开WSL路径写法\\wsl.localhost\发行版名称\用户目录\项目名例如 \wsl.localhost\Ubuntu\home\test\MyProject自动识别 Git如果 Windows 没装 GitIDEA 会自动调用 WSL 里的 Git无需额外配置如果windows安装了需要指定wsl的git路径例如 \wsl.localhost\Ubuntu\usr\bin\gitMaven配置注意事项maven项目如果拉取不到依赖的话可以把maven的地址、配置、仓库都配置为wsl的maven配置操作到这里恭喜你已经安装完成可以体验AI编程的快乐了…
