安装与打开 VS Code
只使用 Codex 桌面版,不需要先学会 VS Code。需要自己查看、修改文件,或逐行检查代码时,再装编辑器。
可以让 Codex 帮你检查是否已经安装 Git 和 VS Code;缺少时,从官方来源安装。遇到安装器或系统权限提示,先看清内容再确认。
安装后如果 Codex 仍找不到编辑器,关闭并重新打开应用,再从项目的打开方式中选择 VS Code。也可以先启动 VS Code,选择“打开文件夹”,打开同一个项目目录。
- VS Code用来查看与编辑文件。
- Git用来记录版本和比较改动;装好 Git 不会自动给每份文件建立历史。
如果想在 VS Code 里继续用 Codex,在扩展商店安装 OpenAI 发布的 Codex 扩展,登录账号,再打开 Codex 侧栏。桌面版与编辑器里的任务是否能看到,应以当前扩展、账号和本机环境为准,不要默认所有聊天都会完整同步。
自定义指令
对所有工作都通用的要求,放在“设置 → 个性化 → 自定义指令”中。写好后点“保存”。
例如:
回复要基于事实,不能故意讨好我,要实事求是,不能阿谀奉承。
也可以加上自己的语言与表达习惯,例如“默认中文回答”“不确定的内容明确说明”。保持简短,不要把某个项目的目录结构和临时任务也写进来。
项目里的 AGENTS.md
AGENTS.md 是给 Codex 看的项目说明文件。项目怎么组织、哪些文件不能动、修改后怎么检查,都适合写在这里。
它不应该是一整段聊天记录,也不应该堆满“请认真”“请专业”这样的空要求。
可以在当前项目里直接说:
根据当前目录和已经确认的要求,生成一份简洁的 AGENTS.md。
写清项目用途、目录说明、修改范围和检查方法。
不确定的地方列出来让我确认,不要把临时讨论当成长期规则。
生成后,打开文件逐项检查。最重要的是“能不能照着执行”,而不是写得长不长。
# 项目约定
- 修改之前先阅读相关文件。
- 不删除或覆盖用户已有内容。
- 有事实不确定时明确标注,不自行补写结论。
- 完成后说明改了什么、检查了什么、还有什么未确认。
Codex 会按目录层级读取适用的说明。项目根目录的规则可以覆盖整个项目,子目录还可以有更具体的规则。修改规则后,在新任务中让它列出当前生效的要求,核对有没有读到。
不要混淆规则与记忆
- 自定义指令:你主动设置的通用偏好。
- AGENTS.md:可查看、可修改、可以跟随项目保存的明确规则。
- 记忆:可用时,从过去的工作中保留有用背景;不是逐字保存所有聊天。
需要准确执行的约定,放进可检查的文件。不要只期待模型“应该记得”。项目说明也不要包含密码、Cookie 或账号令牌。