04 · 会话与 AGENTS.md 配置

03-上下文与Token管理 ｜ 下一篇 → 05-计划模式与项目开发

一、会话管理命令

Codex 把每次工作组织成会话（session），可保存、恢复、分叉：

• /fork 很有用：想试一个有风险的改法，分叉出去试，失败不影响主会话。

会话怎么存

• 底层用 SQLite + JSONL 存会话历史。
• 意味着会话可持久化、可检索、可恢复——不是关掉就没了。

二、AGENTS.md：项目指令文件

AGENTS.md 之于 Codex，等于 CLAUDE.md 之于 Claude Code。 放在项目根目录，Codex 自动读取，作为项目的「长期说明书」。

典型内容

# AGENTS.md

## 项目
- 技术栈：Flask + SQLite + 原生 JS
- 启动：`flask run`
- 测试：`pytest -q`

## 约定
- API 返回 JSON，字段 snake_case
- 新代码必须带测试
- 不要修改 `vendor/` 目录

## 偏好
- 提交信息用 Conventional Commits
- 优先用标准库，少加依赖

为什么重要

• 省得每次重述项目背景（呼应 上下文管理）。
• 让 Codex 的产出贴合你的项目约定，少返工。
• 团队共享一份 AGENTS.md = 团队对智能体的统一规范。

三、自定义状态栏与用量追踪

• Codex 支持自定义 status line：在界面上显示当前模型、用量、目录等。
• 可追踪 token 用量/成本，对长任务很有用（控成本见 08-高级技能与编排）。

本节实操

• 在项目根写一份 AGENTS.md（技术栈+测试命令+约定+不要碰的目录）
• 用 /fork 试一个有风险的改动
• 用 /resume 恢复昨天的会话

下一篇 → 05-计划模式与项目开发