当天目标：结束今天，你本地有一个 Codex 能跑、能读你项目约定、能用 Plan 模式规划并跑通一件小事的环境。

为什么先搭环境，而不是先调参

Agent 没有项目记忆。它每次开工，唯一能依赖的上下文就是你给它的文件 + 你下的指令。所以"让它听懂项目"的第一步，不是去点设置，是写一份项目说明书（桌面端的 Personalization 框，或仓库里的 AGENTS.md 文件），再建好一个不会被搅成一锅粥的目录结构。

桌面端的"工作区 / 文件夹"相当于左边的大抽屉，里面每一条 Thread 是一条任务线——这个两层结构决定你后面七天会不会乱，进哪个项目就 指定你的项目 再开 Codex，后面七天都顺着这个结构走。

两条入口路线，先定死一条

Codex 现在有两套入口：桌面端（ChatGPT 桌面应用里的 Codex）和 CLI（终端里的 codex 命令）。功能几乎一样，Personalization 框本质上就是 ~/.codex/AGENTS.md。选定一条走到底，别今天桌面端明天 CLI 来回切，配置会乱。两条路二选一：走桌面端得先装好 ChatGPT 桌面端；走 CLI 得本机有 Node 18 以上。

它还有几种"形态"值得知道：网页版 Cloud、GitHub 上自动审你代码的机器人、IDE 插件、用代码直接调的 SDK。关键差异：走 API key 直接调用拿不到 Cloud 网页和 GitHub 审代码这类托管能力——它们依赖 OpenAI 托管的运行环境。日常个人用，桌面端或 CLI 就够了。

提醒：独立的 Codex App 已在 2026-07-09 并入 ChatGPT 桌面端。

路线 A：桌面端（图形界面工作的人）

• 入口：打开 ChatGPT 桌面端，在左侧找到 Codex 入口。那个独立的 codex app 命令入口其实还在，但日常用桌面端界面就够了。
• 让 Codex 看见你的仓库：在 Codex 里"添加文件夹 / Open Folder"，选中你本地的项目目录（比如 dev/Projects/my-app）。这一步是关键——很多教程只说"建个目录"，没说怎么让 Codex 真的关联到你的代码。选完之后，你在这个工作区里开的每条 Thread 都基于这个仓库。
• 本地目录对照：桌面端的工作区和本地 dev/ 目录一一对应（Projects / sandbox / tools / notes 结构同上），顺着它走就不乱。
• 设置三件小事（路径在 设置 里）：
  1. 开"保持电脑开机"——后台任务依赖电脑不睡眠，你睡了它断了，Day 6 的定时任务就失联。
  2. 把 Follow-up 行为改成 steer——开发过程中你随时发消息调整方向，不用等它停。这是 Day 6"中途纠偏"的前提。
  3. 建好 Threads 两层：第一层文件夹当"工作区"（按项目分），第二层在每个文件夹里建 Thread 当"任务线"（一个明确目标一条线）。别把所有事塞进一个 Thread。

路线 B：CLI（习惯终端、要写脚本/接 CI 的人）

node -v                             # 先确认 Node 已装且在 18 以上；没装去 nodejs.org 下 LTS，装完重开终端
npm install -g @openai/codex        # 全局装 CLI（Node 18+）
codex --version                     # 打印版本号，确认装上了
codex login                         # 弹浏览器授权；回车后 codex status 显示已登录账号

• codex login 引导你用 ChatGPT 账号授权（官方引导是跑 codex 后选 Sign in with ChatGPT）。授权完 codex status 会显示已登录账号。
• 登录卡住：先换网络重跑 codex login；还不行就 codex logout 后重新登录。
• CLI 的好处是后面所有自动化（定时任务、CI、脚本调用）都基于它，偏技术的读者建议走这条。
• 让 Codex 看见仓库：cd 进你的项目目录再敲 codex 进入交互，它就读这个目录。没有现成项目就先 mkdir -p dev/Projects/demo && cd dev/Projects/demo 建个空目录练手。

怎么让 Codex"听懂"你的项目

桌面端的 Personalization 框（在「设置 → Personalization」，或点头像进「Customize」；它等价于全局 ~/.codex/AGENTS.md）。别照抄下面骨架，先用三问反推出你自己的：①项目跑不起来最常卡哪一步？②上次 review 最常被打回什么？③哪个目录碰了会炸？把答案填进去，再补下面几块：

# 项目协作约定（全局 AGENTS.md / Personalization）

## Operating principles
- 改动前先理解现有结构，不引入不必要的抽象。
- 优先改最小范围，不顺手重构无关代码。

## Build & run
- 启动：先 `npm install`，再 `npm run dev`，默认 3000 端口。
- 测试：`npm test`；提交前必须全绿。

## Output formatting
- 改动给 diff 而不是整文件重写。
- 注释用中文，面向人读。

## Conventions
- TypeScript strict 模式。
- 组件用函数式写法。
- 提交信息用 conventional commits（feat/fix/docs/...）。

## Constraints（红线）
- 不动 `migrations/` 目录。
- 测试必须过才能提 PR。
- 不往代码里写死密钥。

CLI 用户则在仓库根写 AGENTS.md，内容一样的几块。

第一性原理：工具的价值 = 决策质量 × 上下文质量。Codex 的决策质量由模型决定（你改不了），你能撬动的只有"上下文质量"——而 AGENTS.md / Personalization 就是上下文质量的乘数。今天写这一份，后面七天都吃利息。

第一个任务：先用 Plan 模式，别让它直接改

新手最常翻的车，就是一上来"帮我重构整个项目"——它改了上百个文件你拦不住。所以第一个任务要小、要能验证、要真有点用，而且先用 Plan 模式让它规划、你确认后再动手。

Plan 模式怎么进：

• 桌面端：对话框左侧找到"计划模式 / Plan"入口，或快捷键 Shift+Tab 切到 Plan。
• CLI：会话里输入 /plan 你的需求描述，或按 Shift+Tab 在模式间切换（切到"只规划、不改动"那档再开工）。

Plan 模式下它只读文件、提澄清问题、生成计划，不写任何代码。你看了计划觉得对，再批准它执行。

第一个小任务示例：

在仓库里，给 utils/format.ts 加一个把日期格式化成 YYYY-MM-DD 的函数，附带一个单元测试，跑通测试。（仓库里没有 utils/format.ts 就先建一个空文件，或把路径换成你真有的文件——重点是让它能跑通一个小闭环。）

进 Plan 模式说这句话，看它列的计划（读哪些文件、怎么加、测试怎么写），确认没问题再放行。它读完 AGENTS.md 和你的指令，会改文件、写测试、跑测试。你看着它跑完，确认测试绿了，Day 1 就过关了。

如果它跑挂了——比如测试环境没装——这正是 Day 2 要讲的"断网伪成功"的苗头，今天先别深究，记住这个感觉：它"说完了"不等于"做对了"。

三个锦囊

1. Personalization / AGENTS.md 今天就必须写，哪怕只写 Build & run 一行。空着等于每天重复交代背景，纯浪费。
2. 桌面端用户今天就把"保持电脑开机"和 Follow-up=steer 开了，不然 Day 6 的后台任务和纠偏玩不转。Windows 用户先确认桌面端有没有 Codex 入口，没有就走 CLI。
3. 第一个任务要小，且先走 Plan 模式。大任务留到 Day 4 你学会验收之后再上。

自测标尺（用命令验证，不是口头打勾）

• [ ] 你跑 codex --version 能看到版本号；codex status 显示已登录。
• [ ] 你能说出自己走的是桌面端还是 CLI，且知道 Personalization 框 ≡ ~/.codex/AGENTS.md。
• [ ] 你的 AGENTS.md / Personalization 里至少有 Build & run 一块写了真实内容（用三问反推填的，不是抄的）。
• [ ] 你用 /plan 或 Plan 模式跑通了第一个小任务，且看到了测试变绿。
• [ ] 验证约定真加载了：在会话里让它"复述你 AGENTS.md 里的 Build & run 要点"，它答得上来才算加载成功（CLI 也可用 /init 作为快速起点）。

效率日志（四列，今天起每天记）

任务	手动做要几分钟	Codex 做+你验收几分钟	打回几次
加日期格式化函数	___	___	___

---