ChatGPT Codex 安装与项目配置
Codex 能不能稳定完成任务,首先取决于它是否拿到了正确的项目上下文。安装工具只是第一步,项目目录、规则文件和验证命令同样重要。
先选择你要使用的 Codex 形态
不同版本的 Codex 入口和安装方式会随产品更新。常见使用形态包括桌面应用、命令行工具和集成到开发环境中的工作流。不要根据旧文章里的命令猜测当前版本,安装前应查看对应版本的官方说明。
无论使用哪种入口,下面 4 件事都需要准备好:
- 项目目录:Codex 必须在正确的仓库或工作目录中运行。
- 运行命令:至少知道如何启动开发环境和执行构建。
- 验证命令:知道测试、类型检查或 lint 怎么运行。
- 权限边界:明确哪些文件可以修改,哪些目录和凭证不能访问。
项目目录检查
在开始任务前,先确认当前目录:
bash
pwd
git status --short --branch
ls接着查看项目说明和脚本:
bash
cat README.md
cat package.json如果项目不是 Node.js,也要找到对应的依赖文件和命令,例如 pyproject.toml、requirements.txt、go.mod 或 Cargo.toml。
用 AGENTS.md 写清项目规则
AGENTS.md 适合记录每次任务都要遵守的内容,例如:
markdown
# 项目规则
- 使用 pnpm,不要改用 npm 安装依赖
- 修改后运行 pnpm test 和 pnpm build
- 不修改 generated/ 目录中的文件
- API 返回结构必须保持向后兼容
- 提交前说明测试结果和未验证事项规则文件应该写项目事实和工作要求,不要把一次性的任务描述永久写进去。
权限和敏感信息
不要把以下内容放进提示词、截图或提交记录:
- API key、OAuth token、SSH 私钥和数据库密码。
- 生产环境配置、客户名单和未公开业务文件。
- 身份证件、支付信息和其他个人敏感资料。
需要 Codex 读取环境变量时,只说明变量名和用途,不要把真实值复制到对话中。对生产系统的修改,应先在本地或测试环境完成验证。
一份合格的启动任务
text
请先阅读 README.md、AGENTS.md、package.json 和首页相关文件。
先告诉我项目如何启动、如何测试,以及你准备修改哪些文件。
暂时不要修改代码。让 Codex 先调查,可以在真正修改前发现目录、框架和命令理解上的错误。