---
title: "指令链默认只有 32 KiB"
summary: "超限会静默截断。调大 project_doc_max_bytes，或把大段说明拆到更靠近 cwd 的文件。"
category: agents-md
level: intermediate
surfaces: [cli]
tags: ["32KiB", "截断", "config"]
canonical: /tips/project-doc-max-bytes/
---

# 指令链默认只有 32 KiB

超限会静默截断。调大 project_doc_max_bytes，或把大段说明拆到更靠近 cwd 的文件。

```toml
# ~/.codex/config.toml
project_doc_max_bytes = 65536
project_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"]
```

症状：后半段规则「没生效」，尤其是子目录里的文件根本没被拼进去。

处理：

- 提高上限
- 把规划、审查、架构文档外链到独立 markdown，主文件保持短
- 用 nested `AGENTS.md` 代替一份巨型根文件

主文件应是索引和硬约束，不是小说。

## 来源

- [OpenAI · AGENTS.md](https://developers.openai.com/codex/guides/agents-md)