很多人第一次用 Cursor、Claude Code 或 Codex 做项目，遇到的不是“AI 不聪明”，而是项目环境根本没准备好：依赖装不上、环境变量缺失、测试命令没人知道、AI 读了半天还在猜入口文件。最后看起来像 AI 编程翻车，其实是环境交接没做好。
这篇文章不讲某一个工具的炫技用法，而是整理一份 AI 编程环境搭建清单。你可以把它当成新项目启动前、旧项目交给 AI 接手前、或者让同事帮忙维护前的基础检查。它和 AI编程学习路线怎么走 不重复：那篇偏学习路径，这篇专门解决“项目怎么先跑起来”。
第一步：先让项目能被人类跑起来
AI 编程工具再强，也需要一个可复现的起点。最基本的要求是：新电脑拉下项目后，按照说明能安装依赖、启动服务、跑测试。如果这一步做不到，AI 很容易在错误环境里反复试错。
我建议每个项目至少准备这几项：
- 运行环境版本：Node、Python、PHP、Java、数据库版本写清楚。
- 依赖安装命令：例如 npm install、pnpm install、pip install -r requirements.txt。
- 启动命令：开发环境、预览环境、构建命令分开写。
- 测试命令：哪怕只有一条最小检查命令，也比完全没有强。
- 常见失败原因：端口冲突、缺少密钥、数据库未启动、权限不足等。
如果你正在从零学习，可以把这一步和 AI编程工具专题 放在一起看。工具选择重要，但真正决定效率的是项目能不能被稳定理解和验证。
第二步：把项目入口和目录结构写给 AI 看
很多旧项目最大的问题不是代码复杂，而是没有入口说明。AI 看到一堆文件，会先花时间猜：页面在哪里、接口在哪里、配置在哪里、测试在哪里。你可以用一个简短的项目说明减少这部分浪费。
建议在 README、AGENTS.md、CLAUDE.md 或项目规则文件里写清楚：
- 主要业务入口：前端页面、后端接口、主题模板或自动化脚本的位置。
- 不能随便改的目录：生产配置、迁移脚本、历史数据、备份文件。
- 常用修改范围：组件、样式、工具函数、文章模板、测试文件。
- 验证方式：本地页面怎么打开，接口怎么测，脚本怎么跑。
这类规则不是形式主义。比如老达AI博客的发文项目，就把“正文不要写 H1、要有摘要、SEO meta、特色图 alt、站内链接和发布后检查”写进项目规则里。AI 不需要每次重新问，维护质量也更稳定。更细的规则分层可以参考 AI编程项目规则怎么分层。
第三步：环境变量只给模板，不给真实密钥
AI 编程环境里最容易踩坑的是密钥。新手为了让 AI 跑通项目，可能直接把 API Key、数据库密码、服务器密码发进对话或写进说明文档。这是非常危险的做法。
正确方式是提供 .env.example 或配置说明，只写变量名和用途，不写真实值。例如：
OPENAI_API_KEY=你的 OpenAI API Key
DATABASE_URL=本地开发数据库连接
WP_BASE_URL=WordPress 站点地址
WP_USER=WordPress 用户名
WP_APP_PASSWORD=WordPress 应用密码
真实密钥放在本地 .env、服务器环境变量或密钥管理工具里。让 AI 修改代码时，只允许它读取必要的变量名和调用方式，不要把生产密钥复制到文章、提交记录或截图里。这个原则和 n8n 凭证管理怎么做 里讲的 API Key 权限分层是一致的。
第四步：给 Cursor、Claude Code、Codex 不同的边界
三类工具都能帮你改代码，但适合的工作方式不一样：
- Cursor：适合在编辑器里边看边改，小范围修改、代码解释和局部重构很顺手。
- Claude Code：适合在项目里做多文件修改、规划任务、读上下文和执行命令。
- Codex CLI：适合把需求、文件修改、命令验证和交接记录串成一个完整任务。
环境配置时，不要只问“哪个工具更强”。更实用的问题是：这个项目允许 AI 读哪些目录、能不能写文件、能不能执行测试、是否需要人工确认、失败后怎么回滚。刚开始使用 Codex 的读者，可以先看 Codex CLI怎么安装和登录，再回到这篇文章补环境清单。
第五步：把测试命令变成固定验收动作
AI 编程最怕“看起来改好了”。页面能打开，不代表旧功能没坏；接口能返回，不代表边界情况没问题。环境搭好以后，至少要给 AI 一组固定验收命令：
- 格式检查：例如 lint、format check。
- 单元测试：覆盖核心函数、组件或接口。
- 构建检查：确认生产构建不报错。
- 页面验证：用浏览器打开关键页面，看按钮、表单、图片和布局。
- 发布后检查：适合 WordPress、博客、工具站这类有线上页面的项目。
如果项目暂时没有测试，也可以先写一个最小验收清单。比如“修改文章页后必须检查标题、meta description、特色图、内链数量和移动端排版”。更完整的验收思路可以看 AI编程验收清单怎么写。
第六步：新手不要一上来让 AI 全自动改生产项目
AI 编程环境搭好以后，很多人会急着让工具直接改线上项目。我的建议是：先在本地、测试分支或副本里跑一轮完整流程。让 AI 读项目、提出计划、修改小范围文件、运行测试、给出交接记录，再决定是否扩大任务范围。
尤其是网站、客户系统、付费接口和自动化工作流，最好保留人工确认。AI 可以帮你加速读代码、补测试、写脚本，但上线决策仍然要有人负责。你可以把这套流程和 老达AI实践专题 里的自动化案例结合起来看：真正稳定的 AI 实践，通常不是一次性神操作，而是一套可复用的检查流程。
老达点评
我现在越来越觉得，AI 编程的核心不是“会不会写提示词”，而是你有没有把项目变成一个可被 AI 正确接手的工作现场。目录清楚、命令清楚、密钥边界清楚、测试清楚，AI 的发挥就会稳定很多；反过来，环境混乱时，再强的工具也会把时间花在猜测和试错上。
如果你是新手，别急着追最新工具。先把一个小项目整理到“别人拉下来能跑、AI 读完能改、改完能验收”的程度。这一步做好以后，Cursor、Claude Code、Codex 的差异才真正有意义。
