Codex高效配置两招:AGENTS.md和精简工具集
通过全局配置文件让Codex理解你的习惯,再精选关键工具,避免浪费token和时间。
用AGENTS.md建立工作共识
Codex启动时会自动读取AGENTS.md文件,按全局→项目路径逐层合并。你可以在全局配置中写好通用习惯,在项目中覆盖特殊规则,这样每次对话不用重复交代背景。
全局默认(所有项目共享):
在 ~/.codex/AGENTS.md 写入你的工作协议。例如:`
# ~/.codex/AGENTS.md
## 工作协议
修改 Python 文件后始终运行 pytest
安装依赖优先使用 pip,次选 conda
添加新生产依赖前先询问确认`
> 示例取自OpenAI官方教程,你完全可以根据自己的技术栈定制——Node.js项目可换成 npm test / pnpm。
项目级覆盖:
在仓库根目录放 AGENTS.md,设定项目特有规则(如构建命令、提交规范)。Codex会从项目根向下扫描,越靠近工作目录的文件优先级越高。
验证生效:
在终端运行 codex --ask-for-approval never "Summarize the current instructions.",如果看到它引用你的AGENTS.md内容,说明配置成功。
> 截至2026年7月,AGENTS.md格式已被6万+开源项目采用(来源:agents.md),是跨项目复用规范的高效方法。
精简工具集,少即是多
Codex支持集成各种外部工具(如编译器、测试框架、部署脚本),但官方最佳实践明确建议:只添加能消除手动循环的工具,别一开始就接入所有能用的工具。这两个方面——AGENTS.md配置和工具精简——本质上是同一套工作流配置体系的两个维度,协同提升效率。
具体做法:
找出你每天重复最多次的手动操作——比如改完代码后总要手动跑测试,那就先只加一个测试工具。
不要同时启用代码审查、文档生成、依赖检查等工具;每多一个工具,Codex就可能多一次调用,消耗更多token和响应时间。
用一段时间后再逐步补充,确保添加的每个工具都明确节省了你的操作。
成本视角:ChatGPT Plus、Pro、Business、Edu、Enterprise计划包含Codex(来源:OpenAI Codex IDE页面)。每次工具调用都会消耗token,精简工具可减少不必要的token消耗,间接省额度、省等待时间。
兼容非前端开发:上述思路不限语言。无论你是写Python、Go、Rust还是SQL,都可以将对应的测试/编译命令写进AGENTS.md,工具只加自己实际需要的。
关于安装与计划
Codex VS Code扩展本身免费,通过 ext install openai.chatgpt 即可安装(来源:VS Marketplace)。首次使用需登录ChatGPT账户,计划包含Codex的使用额度,具体包含情况请参考官方帮助页面(截至2026年7月,Free、Go、Plus、Pro、Business、Edu、Enterprise 均包含)。注意:扩展安装后默认在右侧侧边栏,可拖拽调整位置,但这属于个人偏好,不影响效率核心。