文章目录为什么Windows运行AI Agent优先用WSL前置准备开启CPU虚拟化WSL基础安装与多版本部署WSL启动与基础管理WSL开发环境搭建AI Agent必备主流AI Agent WSL部署实战Pi Coding Agent轻量省TokenHermes Agent 部署Cloud Code 部署CodexChatGPT桌面端适配WSLWSL图形界面与远程桌面补充为什么Windows运行AI Agent优先用WSLWindows原生PowerShell对AI适配性差AI大模型训练语料以Linux/Mac命令为主导致PowerShell命令频繁报错、执行低效、浪费Token。而WSLWindows子系统Linux可以让Windows同时拥有Windows和Linux双系统优势是Windows运行各类AI Agent的最优方案核心三大优势运行更稳定、效率更高AI适配Linux命令更成熟大幅降低命令报错概率减少Token损耗运行流畅度远超Windows原生终端。贴合生产环境项目最终大多部署在Linux服务器WSL开发测试可消除系统环境差异让本地到线上部署流程更丝滑。环境隔离更安全WSL为独立Linux子系统误操作损坏环境不会影响Windows宿主机故障后可直接删除重建子系统零成本恢复。前置准备开启CPU虚拟化WSL2基于硬件虚拟化必须开启CPU虚拟化功能现阶段主流电脑均支持打开任务管理器 → 性能 → CPU查看「虚拟化」是否已启用。未启用则重启电脑进入BIOS如果是 Intel CPU 则开启 Intel VMX 虚拟化平台如果是AMD CPU 则开启 SVM Mode。WSL基础安装与多版本部署Windows右键打开终端PowerShell/CMD国内网络推荐加速安装命令wsl--install--web-download若提示需重启重启电脑后重新执行上述命令。安装完成后设置Linux子系统用户名、密码输入密码无屏幕显示正常输入回车即可需二次确认。命令行变色即进入Linux系统输入 exit 可退出子系统。WSL基础查看与更新命令查看所有可在线安装的发行版wsl-l-o指定发行版自定义安装路径安装wsl--install 发行版名--location 自定义路径如D:\WSL\Kali wsl--install kali-linux--locationD:\WSL\kali-linux创建多个同发行版独立实例同一发行版可创建多个隔离实例互不干扰、独立配置示例新建Ubuntu2实例自定义名称和路径wsl--installUbuntu--nameUbuntu2--locationD:\WSL\Ubuntu2查看已安装所有子系统wsl -l升级WSL核心到最新版建议使用前执行wsl --updateWSL启动与基础管理启动默认子系统wsl指定启动某个子系统wsl -d 子系统名图形快捷启动Windows终端下拉框直接选择对应Linux实例。设置默认子系统wsl--set-default子系统名关机退出关闭WSL终端窗口/输入 exit子系统自动关机无后台驻留。清理删除发行版wsl--unregisterUbuntu-22.04WSL开发环境搭建AI Agent必备以Ubuntu为例搭建开发三件套Git、Python、Node.jsGit系统自带------ 验证git -v无需额外安装。Python环境配置------ 系统自带Python3验证python3 --version绑定python命令到python3sudo apt update sudo apt install python-is-python3直接输入 python 即可正常调用。Node.js环境配置NVM安装nodejs官网下载地址通过NVM安装指定版本Node.js适配Linux环境稳定性更强按官网Linux命令依次执行安装安装后验证node -v、npm -v。# 下载并安装 nvm curl-o-https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh|bash # 代替重启 shell \.$HOME/.nvm/nvm.sh# 下载并安装Node.js nvm install24# 验证Node.js 版本 node-v #Shouldprintv24.18.0.# 验证 npm 版本 npm-v #Shouldprint11.16.0.主流AI Agent WSL部署实战Pi Coding Agent轻量省Token极简AI编码Agent低干扰、省Token推荐WSL环境部署。pi agent 下载地址通过官方CURL命令安装确认安装输入Y。curl-fsSL https://pi.dev/install.sh|sh创建项目目录cd~mkdir pitestcd pitest启动Agentpi模型配置输入 /login选择API Key方式支持DeepSeek、MiniMax、Kimi等模型。deepseek api-key 获取地址可能存在的问题Failed to download ripgrep: fetch failed.ripgrep简称 rg是高速文件检索工具Pi 命令行工具必须依赖它用来扫描项目文件、读取代码、检索配置启动 Pi 时自动尝试在线下载 rg但网络拉取失败国内访问 GitHub / 上游资源超时所以抛出下载失败WSL Ubuntu 官方源自带 ripgrep直接系统安装绕过 Pi 的在线下载.sudo apt updatesudo apt install ripgrep -y项目开发与调试VS Code联动Windows安装VS CodeWSL项目目录下执行code.直接调用Windows VS Code打开Linux项目。支持实时代码修改、浏览器同步预览、Git提交、云端推送。github相关操作可以看我之前的文章从代码提交到远程部署GitHub 完整操作指南解决 SSH 连接与分支冲突如果想让ai代替完成一些git操作在wsl里时可以使用命令你现在在WSL里面读一下我windows宿主机的git设置然后在WSL里也配置一下。WSL特色localhost端口自动转发WSL内启动的服务端口自动映射到Windows宿主机localhost可直接用Windows浏览器访问。本地文件互通WSL内执行 explorer.exe .WSL访问Windows磁盘Windows C/D盘自动挂载在 /mnt/c、/mnt/d可直接cd进入访问桌面、文件夹。开发规范项目务必放在WSL原生目录不要放在Windows挂载目录避免跨系统IO卡顿、性能损耗。Hermes Agent 部署Hermes无稳定Windows原生版本WSL为最优运行环境hermes官方下载地址复制官方Linux安装命令WSL内执行安装。curl-fsSL https://hermes-agent.nousresearch.com/install.sh|bash输入虚拟机密码选择「完全设置」选择DeepSeek等模型厂商。填入对应API Key选择模型、通信渠道未知配置默认skip。重启WSL执行 hermes 启动Agent。Cloud Code 部署WSL内执行官方安装命令安装完成后 cloude 启动。claude code文档地址curl-fsSL https://claude.ai/install.sh|bash浏览器打开授权地址复制授权码粘贴确认完成配置即可对话使用。CodexChatGPT桌面端适配WSL方案1推荐WSL安装Codex CLI命令行运行原生Linux环境、性能最优。codex项目地址curl-fsSL https://chatgpt.com/codex/install.sh|sh方案2Windows桌面端切换WSL环境设置→常规→智能体环境/终端切换为WSL重启软件生效缺点依赖Windows挂载目录IO效率较低。WSL图形界面与远程桌面Ubuntu桌面执行桌面环境安装命令获取虚拟机IP通过Windows「远程桌面连接」输入IP:3389连接完整Ubuntu桌面。sudo apt update sudo apt install xfce4 xfce4-goodies xrdp-y echostartxfce4~/.xsession sudo systemctl enable xrdp sudo systemctl start xrdp hostname-I补充WSL1与WSL2核心区别WSL1纯指令翻译层无真实Linux内核兼容性差不支持Docker、显卡直通仅适合简单命令操作。WSL2基于Hyper-V虚拟化搭载真实Linux内核支持Docker、GPU直通、完整网络配置、图形界面性能、兼容性拉满是当前主流版本。WSL支持命令混合执行Windows终端可直接调用Linux命令适配跨系统操作示例Windows列举文件 Linux筛选过滤Get-ChildItem|wsl grep video前半段为Windows原生命令后半段为Linux命令无缝混搭解决Windows命令适配短板。