Codex 配置排障与工作流中心
汇集 Codex config.toml 只读修复、日志文件过大处理、项目交接模板和工程规范。每一篇都来自真实使用场景，包含可复制的命令和可回滚的操作步骤。
更新时间：2026-07-05
适用对象：Codex 用户 / 独立开发者
配置排障
按常见问题分类，遇到哪个查哪个：
- config.toml 只读/无法保存 — 从路径查找、权限检查、编辑器占用到项目配置覆盖，六步排障流程。
- 修改后不生效 — 检查 CODEX_HOME、项目配置覆盖、CLI 参数和 TOML 语法。
- TOML 常见错误 — 字符串引号、数组格式、重复键定义。
日志与磁盘
- logs_2.sqlite 持续增长 — 安全退出、备份、重命名 .old、恢复步骤。
- WAL 文件持续写入 — 与主数据库一起处理，不要只删 WAL。
- 磁盘空间不足 — 检查 PSDrive、目录权限和文件占用。
工作流与规范
- 项目交接文档模板 — 可直接复制的 Markdown 模板，覆盖背景、技术栈、状态、待办和验收标准。
- AGENTS.md 配套建议 — 长期规则放 AGENTS.md，阶段任务放交接文档。
- 新线程接手提示词 — 先理解、后计划、再执行的标准流程。
FAQ
- Q：config.toml 修改后为什么不生效？
A：可能是项目级配置覆盖、CLI 参数优先、CODEX_HOME 指向其他路径、Codex 未重启或 TOML 语法错误。 - Q：可以直接删除 logs_2.sqlite 吗？
A：不建议。优先重命名为 .old，确认 Codex 正常后再删除。运行时删除可能导致数据损坏。 - Q：为什么需要项目交接文档？
A：Codex 每次新线程没有上下文记忆。交接文档能让新线程快速理解项目现状，减少重复沟通。