从零装好 WSL，Windows 跑 Agent 的保姆级教程 ✍ 泊舟🕐 2026-07-22📦 7.6 KB 🟢 已读 𝕏 文章列表 本文介绍如何在 Windows 上安装和配置 WSL，以解决运行 AI Agent 时遇到的 PowerShell 报错问题。文章涵盖了 WSL 安装、开发环境配置、Codex CLI 运行、Windows 与 WSL 互通、安全隔离设置及环境备份导入等全流程。 WSLAgentCodexWindowsDevOps教程环境配置 # 从零装好 WSL，Windows 跑 Agent 的保姆级教程 保姆教程型 **作者**: 泊舟 **日期**: 2026-07-21T07:23:29.000Z **来源**: [https://x.com/bozhou_ai/status/2079467283848835386](https://x.com/bozhou_ai/status/2079467283848835386) ---  如果你在 Windows 上用 Codex 这类 AI Agent，经常遇到 PowerShell 报错，先别急着怪模型。 它可能不是不会写代码，只是卡在了路径格式、权限、包管理器和 Shell 语法上。活没干多少，Agent 已经围着同一条命令来回试了好几轮，token 全浪费在环境问题上。 我的建议很直接：别继续跟 PowerShell 硬磨，把 Agent 放进 WSL。 Windows 继续照常用，代码、依赖和 Agent 放在 Linux 环境里。只需要一行命令，不用换电脑，也不用装双系统。  WSL 是 Windows Subsystem for Linux，也就是适用于 Linux 的 Windows 子系统。下面我会从安装 WSL、配置 Codex，一直讲到怎么给高风险项目单独划一个环境，带你把整套流程跑通 ## 前提准备 先检查 CPU 虚拟化是否开启。 打开任务管理器，点击「性能」→「CPU」，查看「虚拟化」一项。如果显示「已启用」，就可以继续安装 WSL。  如果显示「未启用」，需要在开机时进入 BIOS/UEFI 设置： - Intel CPU 通常需要开启 Intel Virtualization Technology、VT-x 或 VMX。 - AMD CPU 通常需要开启 SVM Mode 或 AMD-V。 不同电脑的选项名称和入口可能不一样，可以按主板或电脑型号搜索对应的开启方法。 ## 1️⃣ 安装 WSL 用管理员身份打开 PowerShell，执行： ``` wsl --install ``` 这条命令会启用 WSL 所需组件，并默认安装 Ubuntu。安装完成后，按提示重启电脑。 如果下载长期卡在 0%，可以尝试： ``` wsl --install --web-download -d Ubuntu ``` 重启后更新 WSL，并检查发行版和版本： ``` wsl --update wsl -l -v ``` 第一次进入 Ubuntu 时，需要创建 Linux 用户名和密码。输入密码时屏幕不会显示字符，这是 Linux 终端的正常行为。  如果系统版本较旧，或安装时遇到其他问题，可以查看微软官方 WSL 安装文档 ## 2️⃣ 把开发环境装在 Linux 里 进入 Ubuntu 后，先更新软件索引，再检查 Git、Python 和 Node.js： ``` sudo apt update git --version python3 --version node -v npm -v ```  Ubuntu 通常会自带 Git 和 Python 3。如果缺少 Node.js，可以按照 Node.js 官方 Linux 安装说明安装。 项目目录建议建在 Linux 文件系统里： mkdir -p ~/projects/agent-demo cd ~/projects/agent-demo 不要把长期开发项目放在 /mnt/c/Users/... 下。使用 Linux 命令行工作时，把文件存进 WSL 文件系统，能减少跨系统读写带来的 I/O 开销。微软也建议：使用 Linux 工具时，把项目放在 Linux 文件系统中。 需要用 Windows 资源管理器查看当前目录，可以执行： explorer.exe . 需要用 VS Code 打开当前项目，可以执行： code . 这样，代码和依赖留在 Linux 文件系统中，编辑器、浏览器和资源管理器仍然使用 Windows 版本。 ## 3️⃣ 先跑通一个 AI Agent 新手不需要一次安装一整套工具。先选一个你已经有账号或订阅的 AI Agent，跑通最小流程。 以 Codex CLI 为例，先打开 Codex CLI 官方文档。  在 WSL 中执行 Linux 安装命令： ``` curl -fsSL https://chatgpt.com/codex/install.sh | sh ``` 安装完成后，输入： codex 第一次启动时，选择使用 ChatGPT 登录，或按页面提示使用其他登录方式。  让 Codex 桌面版进入 WSL 打开 Codex 设置，把「终端集成」里的 Shell 修改为 WSL。  重启 Codex。此后 Codex 的 Shell 就会运行在 WSL 中，执行的也是 Linux 命令。 ## 4️⃣ 让 Windows 和 WSL 互通 WSL 的优势是两边可以互通。下面几项最常用。 Windows 浏览器访问 WSL 服务 在 WSL 中启动 Node.js、Python 或其他 Web 服务后，通常可以直接在 Windows 浏览器打开： http://localhost:3000 WSL 读取 Windows 文件 Windows 磁盘默认挂载在： /mnt/c /mnt/d 临时读取截图、数据文件或素材很方便，但项目依赖和大量小文件仍建议留在 ~/projects。 Windows 软件打开 Linux 文件 除了执行 explorer.exe .，也可以在 Windows 资源管理器地址栏输入： \\wsl$ 你会看到所有已安装发行版的文件系统。更多细节可以查看微软的 Windows 与 Linux 文件系统互操作说明。 ## 5️⃣ 给 Agent 单独划一块安全区域 把 Agent 放进 WSL，不等于自动获得了完整的安全隔离。安全性仍然取决于它能看到哪些目录、拿到哪些权限。 我建议做三层限制： 1. 为 Agent 单独创建一个 Ubuntu 发行版或实例，不和日常 Linux 环境混用。 2. 只把项目放进专用目录，不把密钥、浏览器数据和个人文档复制进去。 3. 高风险任务关闭 Windows 磁盘自动挂载，减少 Agent 默认接触 /mnt/c 和 /mnt/d 的机会。 关闭单个发行版的自动挂载，需要在 WSL 中编辑 /etc/wsl.conf： ``` [automount] enabled=false ``` 保存后回到 PowerShell 执行： wsl --shutdown 重新进入 Ubuntu，再检查 Windows 磁盘是否仍然自动出现： df -h 这里要注意：关闭自动挂载只是减少默认暴露，不是完整沙箱；有权限的用户仍然可以手动挂载磁盘。 .wslconfig 和 wsl.conf 也不要混用： - %UserProfile%\.wslconfig：Windows 侧的全局 WSL 2 配置。 - /etc/wsl.conf：当前 Linux 发行版自己的配置。 ## 6️⃣ 用导出和导入保留干净环境 WSL 发行版可以完整备份。配置好 Agent、Git、Python 和 Node.js 后，先导出一个基础镜像： ``` wsl --export Ubuntu D:\WSL\ubuntu.tar ```  需要恢复或复制一份新环境时，指定新发行版名称、安装目录和刚才导出的 tar 文件： ``` wsl --import Ubuntu-Agent D:\WSL\Ubuntu-Agent D:\WSL\ubuntu.tar ```  这套方法适合做两类事情： - 把自己电脑上的开发环境迁移到另一台 Windows 电脑。 - 克隆多个相互独立的环境，分别用来测试来源不明的仓库、安装脚本和高风险实验。 实验环境坏掉后，可以直接删除对应实例，再从干净镜像重新导入。很多时候，这比反复清理残留依赖和权限更省时间。 这就是 Windows 跑 AI Agent 最省心的一套思路：Windows 继续负责你熟悉的桌面软件，WSL 负责 Linux 工具链，Agent 只在你划定的环境里工作。 ## 相关链接 - [@bozhou_ai](https://x.com/bozhou_ai) - [2.4K](https://x.com/bozhou_ai/status/2079467283848835386/analytics) - [Upgrade to Premium](https://x.com/i/premium_sign_up) - [3:23 PM · Jul 21, 2026](https://x.com/bozhou_ai/status/2079467283848835386) - [2,452 Views](https://x.com/bozhou_ai/status/2079467283848835386/analytics) --- *导出时间: 2026/7/22 08:45:45*
开 开源月入10w+的Codex使用方法（超详细教学） 本文详细介绍了OpenAI推出的AI编程Agent Codex的使用方法，包括其与ChatGPT的区别、注册订阅流程、Web/桌面/CLI/IDE四种安装方式，以及桌面App的页面功能全解，帮助非程序员利用AI提升效率。 技术 › Codex ✍ 产品经理老王霸🕐 2026-07-23 AI编程OpenAICodex教程效率工具Agent
3 30分钟把二次元老婆/老公搬上桌面！Codex 桌宠完整教程 本文介绍了如何利用一张 IP 设定图，在 Codex 中快速生成动态桌宠。文章详细讲解了从角色准备、生成包含多种状态和视角的动画图集，到最终打包安装的全流程，探讨了将 AI 工具个人化、使其成为工作伙伴的意义。 技术 › Codex ✍ Kimberly🕐 2026-07-21 Codex桌宠AI工具教程个性化IP设定动画Hatch PetAgent工作流
如 如何基于 Codex 构建自我改进的外联系统 本文介绍了如何利用 Codex 构建一个自我改进的外联系统。通过将市场反馈记录为内存文件，Codex 自动评估并修改评分规则和话术配置，提交优化建议供人工审核，从而实现 GTM 策略的持续迭代与优化。 技术 › Codex ✍ Nicolas Finet🕐 2026-07-20 CodexAgent自我改进自动化GTMDevOps外联系统
C Codex 史诗级更新实操教程：Work、Plugins、内置浏览器、Ultra 与 Chat 一次讲透 文章深入介绍了 Codex 的史诗级更新，详细解析了 Work、Chat、Plugins、内置浏览器及 Ultra 等新功能。作者通过实操案例，讲解了 Work 与 Codex 的区别、插件使用技巧及多 Agent 协作模式，帮助用户从单一代码编写转向完整的工作台操作，提升研发与内容创作效率。 技术 › Codex ✍ 雪踏乌云🕐 2026-07-19 CodexWorkPluginsUltra内置浏览器实操教程Agent开发工具教程自动化
C ChatCut 安装、初始化与使用教程 本文介绍了ChatCut视频剪辑工具的运行逻辑、安装配置方法及实际使用流程。ChatCut通过Codex代理调用云端服务完成剪辑、配音、字幕和动效生成，支持可视化编辑与导出。文章详细解析了从需求输入到成片输出的全过程，并评价了其优缺点。 技术 › 工具与效率 ✍ 蔡文彬CyberBin🕐 2026-07-14 ChatCut视频剪辑教程CodexAgent配音字幕动效云端服务
保 保姆级教程：AI视频动效系统 作者介绍了一套自研的视频动效系统，旨在利用AI技术辅助视频制作。该系统通过GitHub开源，用户只需三步即可生成专业视频动效：安装系统、修改文案数字、渲染下载。此外，该系统可与Codex结合，甚至喂给本地Agent（如Cola）进行动效管理。 技术 › Agent ✍ 栗噔噔🕐 2026-07-11 AI视频制作动效AgentCodex教程
A AI 全自动生成图书号短视频实战流程 本文详细拆解了使用 Codex、HyperFrames、VoxCPM 及 fast-whisper 等开源工具，全自动生成图书号短视频的完整技术链路。流程涵盖资料收集、文案生成、语音克隆、音频后期处理及字幕对齐等关键环节，旨在构建一套可复用的 AI 自媒体生产工作流。 技术 › 短剧 ✍ Bytec🕐 2026-07-10 AI视频CodexHyperFramesVoxCPMFFmpeg工作流自媒体TTSAgent教程
别 别再乱装 Codex Skills 了，真正值得先装的是这几类 文章指出，使用 Codex Skills 不应像逛插件商店一样盲目安装，而应围绕核心工作流进行选择。作者推荐了三个安装阶段：第一阶段优先安装前端设计类（如 frontend-design）和浏览器验收类 Skill，以实现从“写页面”到“审页面”的闭环；第二阶段安装研究类（如 last30days）和内容类 Skill，用于产出高质量长文；第三阶段按需补全 Figma 和销售类 Skill。此外，作者建议通过自定义 AGENTS.md 来固化工作流程，提升 Agent 的执行稳定性。 技术 › Codex ✍ MuscleMan🕐 2026-07-06 CodexClaude CodeAgent前端开发工作流AI编程Agent-BrowserResearchContent-Strategy教程
C Codex 如何应用于办公和知识场景 这篇文章介绍了如何利用 Codex 的 AI 工作台能力处理办公与知识管理任务。文章阐述了 Codex 的核心概念、从单次任务到自动化系统的五级进阶用法，以及五步工作法。作者提供了搭建环境的具体建议和16个实用工作流模板，旨在帮助用户将重复劳动自动化，提升工作效率。 技术 › Codex ✍ Gorden Sun🕐 2026-06-29 AI工作流自动化办公效率知识管理Codex教程工具提示词Agent
全 全网 Codex Skill 指南：精选资源与安装教程 本文系统梳理了 Codex 的 Skill 生态，指出安装核心 Skill（如 create-plan、gh-fix-ci）是将其从聊天机器人升级为工程团队的关键。文章汇总了必 Star 的官方与社区仓库，按场景（规划、CI/CD、测试、前端等）分类精选了神级 Skill，并提供了保姆级的安装与调用教程，最后分享了自定义 Skill 及进阶组合玩法，帮助开发者最大化利用 AI 编程工具。 技术 › Codex ✍ AYi🕐 2026-06-17 CodexOpenAIAIEngineeringSkill教程DevOpsCI/CD自动化工具效率编程助手
G GitHub 超详细入门指南 本文是一篇 GitHub 的保姆级教程，旨在帮助 AI 编程爱好者掌握 GitHub 的核心功能。文章详细讲解了 Git 与 GitHub 的区别、账号注册与双重认证设置、仓库的创建与搜索技巧、Issue 工单系统的使用，以及如何利用 Agent 辅助进行本地 Git 操作和项目部署。此外，还介绍了 Fork、Pull Request 等开源协作机制，并列举了通义千问、飞书等知名开源项目作为学习范例。 技术 › 工具与效率 ✍ 老王霸 AI Lab🕐 2026-06-15 GitHubGit教程开源AgentDevOps版本控制部署CopilotCursor
C CODEX 高效工作指南：给小白用户的实用入门课 这是一份面向小用户的 Codex（OpenAI coding agent）入门指南。文章指出 Codex 不是单纯的聊天机器人，而是能读写文件、运行命令的“工作搭档”。作者通过对比 ChatGPT，明确了 Codex 的适用场景，并介绍了 App、CLI、IDE 插件等多种入口。核心内容包含四段式提示词模板、常用工作流（解释项目、修 Bug、加功能、审代码）、配置文件 AGENTS.md 的编写方法，以及 MCP、Skills 和 Automations 的区别与用法。最后强调了安全使用原则及新手从只读理解到自动化的进阶路线。 技术 › Codex ✍ Mr Panda🕐 2026-06-12 AI编程CodexOpenAIAgent教程工作流自动化最佳实践提示词AGENTS.md