理解 Codex 的上下文窗口
在使用 Codex 进行代码生成或智能体交互时，AGENTS.md 文件不仅是角色设定的入口，更是控制模型行为边界的关键配置文件。许多开发者在部署自定义 Agent 时，往往忽略了“上下文长度限制”这一核心参数。这里的上下文长度并非指单一文件的字符数上限，而是指模型在一次完整推理周期内能够处理的 Token 总量，包括系统提示、历史对话记录以及当前输入的代码片段。
如何在 AGENTS.md 中优化配置
为了获得最佳的响应质量，我们需要在 AGENTS.md 中明确界定上下文的利用效率。虽然 Codex 后端支持较大的上下文窗口（如 4k 或 8k tokens），但在实际实战中，盲目追求长上下文会导致注意力分散和响应延迟。建议在配置文件中通过精简指令来预留更多空间给代码内容。例如，将冗长的背景描述压缩为简洁的规则列表，确保关键约束条件被模型优先关注。
避免截断与提升准确率
当处理大型代码库或复杂的多轮对话时，超出上下文限制会导致信息截断，进而引发逻辑错误或幻觉。因此，合理拆分任务至关重要。若需处理超长文档，应结合外部检索增强生成（RAG）技术，仅将相关片段注入上下文。同时，定期清理对话历史中的冗余信息，保持上下文窗口的“洁净度”，是确保 Codex Agent 稳定输出高质量代码的核心策略。