[ByAIGC] Windows 从零装 AI 编程代理（一）：通用前置配置

本文 首发于 🌱 煎茶， 转载 请注明 来源。

说明：本文为 AIGC 辅助撰写整理，基于各官方文档核实，供快速上手参考。具体细节请以官方文档为准。

本系列要带你在 Windows 上从零装好并配置几款主流 AI 编程代理：opencode、Codex、DeepSeek Harness、Claude Code、Kimi Code，最后再接入 Lody 用手机远程指挥电脑干活。

这是第一篇：先把公共的地基打好。装好下面这些东西，后面五款工具基本都能直接用。

1. 装 Node.js 与 npm

绝大多数代理都是基于 Node 的工具，Node.js 会附带包管理器 npm。装一个即可。

1. 打开官网 https://nodejs.org，下载 LTS（长期支持） 版 Windows 安装包（.msi）。
2. 双击安装，一路"下一步"，保持默认勾选即可。
3. 装完后重开一个终端，验证：

   node -v
   npm -v
   

   能打印出版本号（如 v22.x）就成功了。

提示：本系列里的 DeepSeek Harness 和 Lody CLI 都要靠 npm，Node 是必装项。

2. 装 Git（Windows 版）

很多代理需要调用 Git，且自带一个 Bash 终端（如 Kimi Code）。装 Windows 版 Git 最省事。

1. 到 https://git-scm.com/download/win 下载安装包。
2. 安装向导里注意两步：
   • 调整 PATH 时选 “Git from the command line and also from 3rd-party software”（推荐默认的第二项）。
   • 行结束符转换选 “Checkout as-is, commit as-is”（避免换行符问题）。
3. 装完验证：

   git --version
   

3. 装一个好用的终端（推荐）

Windows 自带的 CMD/PowerShell 能凑合用，但给 AI 代理配个现代终端体验更好。

• 在 Microsoft Store 搜索并安装 Windows Terminal（免费，微软官方）。
• 打开后把默认配置设为 PowerShell 或你喜欢的 shell 即可。

4. 可选：装 WSL（更推荐但非必需）

如果你的电脑开不了代理功能、或想获得最接近 Linux 的体验，可以装 Windows Subsystem for Linux（WSL）。opencode 官方在 Windows 上最推荐用 WSL。

管理员 PowerShell 里执行：

wsl --install

重启后按提示装一个 Ubuntu，之后在 Ubuntu 里照常装 Node.js、Git，跑代理即可。嫌麻烦可以跳过，本系列其余内容在原生 Windows（PowerShell）下同样能完成。

小结

• Node.js + npm：代理运行基础。
• Git for Windows：提供 Bash 终端与版本管理。
• Windows Terminal：让终端更好用（可选）。
• WSL：Linux 体验更佳（可选，非必需）。

地基打好了，下一篇开始装第一个代理：opencode。

[Windows 从零搭建 AI 编程代理]