让 Agent 能进入项目目录、看工作区状态、读取 README 和配置文件。
没有这一层，它只能给建议，不能理解真实项目。给 AI 准备运行环境
约 1531 字大约 5 分钟
2026-05-25
AI 编程工具不是孤立聊天框。只有本地环境能读仓库、装依赖、跑项目、执行验证，Agent 才能看到错误并继续修复。你准备的不是一台“能装 AI 工具的电脑”，而是一套能让 Agent 形成闭环的最小工作环境。
RUNTIME SETUP
环境不是附属品，而是 AI Coding 能不能闭环的前提。
对 Agent 来说，本地环境至少要满足三件事：能读仓库、能跑命令、能看结果。缺一项，协作都会断在中间。让 Agent 能安装项目依赖、启动前端或脚本、读取报错输出。
第一次只要能跑最小命令，不要追求把所有生态都装齐。让人能审查代码、让 Agent 能基于页面效果、日志和 diff 继续修正。
能看到结果，才有真正的反馈闭环。FIRST CHECK
第一次只验证“能不能工作”，不要先追求装得很全。
- Git`git --version`能显示版本号，并且在项目目录里执行 `git status`。
- Node.js`node -v` / `npm -v`能确认 Node 和 npm 已可用，足够支撑前端项目和 CLI。
- Python`python --version`能确认本地 Python 可运行，先不要急着装一堆包。
- 终端进入项目目录能 `cd` 到项目目录，并执行最小命令。
- 浏览器打开本地地址能访问 `localhost` 预览地址并观察页面变化。
环境作用
没有运行环境时，AI 最多只能给你建议和代码草稿；有了运行环境，它才能进入项目目录、读工作区状态、执行命令、看到报错，再把结果回到下一轮上下文。也就是说，环境决定的不是“能不能聊天”，而是“能不能协作”。
对新手来说，第一次不需要准备很复杂的机器。你只需要确认三件事：
- 它能进项目目录并看懂当前仓库。
- 它能执行最小命令并拿到真实输出。
- 它能让你看到代码变化和页面结果。
基础清单
| 环境 | 作用 | 第一次只要确认什么 |
|---|---|---|
| Git | 管理修改、查看 diff、提交成果 | git --version、git status 可用 |
| Node.js | 前端项目、CLI 工具、Vue/React/VuePress 等 | node -v、npm -v 有输出 |
| Python | 脚本、数据处理、AI SDK、后端项目 | python --version 可运行 |
| 终端 | 让 Agent 执行命令并读取输出 | 能进入项目目录并运行最小命令 |
| 编辑器 | 人工审查代码、补充修改 | 能打开项目文件并查看改动 |
| 浏览器 | 预览页面、验证交互和移动端 | 能打开本地预览地址 |
官方入口
以下链接口径核对时间为 2026-05-26。第一次准备环境时，优先使用官方入口，不要先找第三方整合包。
| 对象 | 官方入口 | 适合第一次怎么装 |
|---|---|---|
| Git | git-scm.com | Windows 直接下载官方安装包；macOS 可先用 Xcode Command Line Tools；Linux 用发行版包管理器 |
| Node.js | nodejs.org/download | 直接装 LTS 版本，不必第一次就折腾多版本管理 |
| Python | python.org/downloads | Windows 用官方安装器或 Microsoft Store；macOS 用 Python.org 安装包；Linux 多数发行版已自带或可直接装包 |
| VS Code | code.visualstudio.com | 先装一个稳定编辑器即可，后面再决定要不要换 Cursor 或 JetBrains |
| 浏览器 | Google Chrome / Firefox | 二选一即可，目标是能打开本地预览地址并做基本检查 |
第一次不要在生产仓库尝试
请准备一个可实验项目。第一次练习时不要授权删除、重置、全局安装、上传密钥或修改生产配置。
Git 基础
git status
git diff
git log --oneline -5git status 告诉你工作区有没有修改；git diff 用来看 AI 改了什么；git log 用来确认当前分支历史。这三条命令不是给 Git 入门考试用的，而是 AI Coding 的最低审查能力。
如果你自己都不会看这三样，后面就很难判断 Agent 改动是否超范围。初学阶段不要把 reset --hard、强推送、批量删除交给 AI 自动执行。
安装路径
如果你只想尽快开始，不想先研究太多环境工具，可以按下面走：
| 系统 | Git | Node.js | Python | 编辑器 / 浏览器 |
|---|---|---|---|---|
| Windows | 用 Git for Windows 安装器 | 从 Node.js 下载页 装 LTS | 从 Python.org 或 Microsoft Store 安装 | VS Code + Chrome / Firefox |
| macOS | 先执行 xcode-select --install，需要更新版本再看 Git 官方页 | 从 Node.js 官方下载页装 LTS | 从 Python.org 安装官方 macOS 包 | VS Code + Chrome / Firefox |
| Linux | 用发行版包管理器装，例如 apt 或 dnf | 从 Node.js 官方下载页选对应发行版入口 | 多数发行版已预装；缺失时优先用发行版包管理器 | VS Code .deb / .rpm 包或你现有编辑器 + Chrome / Firefox |
这一步的目标不是把机器整理到完美，而是让下面这些命令都能正常工作。
依赖策略
前端入门先装 Node.js LTS 即可。Python 入门只需要能运行 python --version，需要项目隔离时再学习虚拟环境。不要一开始就让 AI 安装一大批 AI 包；依赖越多，排错成本越高。
第一次练习时，环境策略应该是：
Node.js：先保证能跑当前项目，不急着折腾多个版本管理器。Python：先保证系统里有可运行版本，不急着装 AI SDK 全家桶。CLI 工具：先装你当前要练的那一个，不要同时铺开一整套工具链。
首次自检
你可以按下面的顺序快速自检一遍，不需要超过五分钟：
git --version
git status
node -v
npm -v
python --version然后再做两个动作：
- 用终端进入一个项目目录。
- 用浏览器打开这个项目的本地预览地址，确认自己能看到页面或服务结果。
如果前面的命令都能跑，目录能进，浏览器能看，本地环境就已经足够支撑你开始第一轮 AI Coding 练习。
常见误区
第一次准备环境时，很多人会被这些问题带偏：
- “我是不是必须先装所有 AI SDK？”
- “我要不要先把 Python、Node、pnpm、bun、docker 全配齐？”
- “我是不是必须先准备一套完美开发机？”
答案都是否。你需要的不是一套完美环境，而是一套能支撑当前任务闭环的环境。只要能读仓库、跑最小命令、看结果，就可以开始。
验证清单
读完这一篇，你的目标不是“环境知识学完了”，而是确认下一篇里的 Codex 已经有条件进入项目、解释启动方式、读取文件和执行安全任务。
