CCODEX 实战手册
2026.09 更新

CHAPTER 08 · 约 4 分钟

编辑器、指令与项目说明

在 VS Code 中查看文件,把长期偏好和项目规则放在合适的位置。

Windows 桌面版更新 · 2026-09-03点击截图可放大

安装与打开 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 或账号令牌。

官方文档与延伸阅读