Skip to content

ChatGPT Codex 安装与项目配置 ​

Codex 能不能稳定完成任务,首先取决于它是否拿到了正确的项目上下文。安装工具只是第一步,项目目录、规则文件和验证命令同样重要。

ChatGPT Codex 安装与配置场景图
配置 Codex 时,先确定项目目录,再确定规则和验证命令。

先选择你要使用的 Codex 形态 ​

不同版本的 Codex 入口和安装方式会随产品更新。常见使用形态包括桌面应用、命令行工具和集成到开发环境中的工作流。不要根据旧文章里的命令猜测当前版本,安装前应查看对应版本的官方说明。

无论使用哪种入口,下面 4 件事都需要准备好:

  1. 项目目录:Codex 必须在正确的仓库或工作目录中运行。
  2. 运行命令:至少知道如何启动开发环境和执行构建。
  3. 验证命令:知道测试、类型检查或 lint 怎么运行。
  4. 权限边界:明确哪些文件可以修改,哪些目录和凭证不能访问。

项目目录检查 ​

在开始任务前,先确认当前目录:

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 先调查,可以在真正修改前发现目录、框架和命令理解上的错误。

内容用于学习与信息整理,请以官方公告为准。