OpenAI Cookbook 近日上线《GPT-5.1-Codex-Max Prompting Guide》，系统整理该模型在代理与开发者工具场景下的提示设计范式。文档将 Codex-Max 定位为“智能体式编码”模型，强调通过精细的 system 提示与工具约定，引导其在真实代码库中执行多步修改、调试与重构，并与 Responses API 深度结合。
指南大篇幅描述了推荐的系统提示结构，包括要求模型以“严谨工程师”心态优先保障正确性和稳定性，避免宽泛 try/catch、静默失败和随意类型断言，鼓励在修改前充分阅读上下文并批量完成逻辑相关的编辑。文档同时明确了编辑约束：偏好使用 apply_patch 进行单文件更新，不要回滚用户未请求的改动，不得使用危险 git 命令，并在出现意外文件变化时立即停下并询问用户。
在工具使用方面，指南建议通过 multi_tool_use.parallel 并行读取文件与搜索结果，减少串行调用，并提供了 apply_patch、shell_command 与 update_plan 等工具的标准定义示例。文档还介绍了 /responses/compact 上下文压缩机制，以在长对话与长链路任务中保留关键信息；同时强调 Codex 系列利用“推理摘要”向用户展示中途计划，这部分由独立模型生成，无需在提示中手动干预。整体来看，该指南为构建基于 GPT-5.1-Codex-Max 的 IDE 插件和代码代理提供了较完整的工程实践模板。
常见问题
Q：这份 Prompting Guide 主要给谁看的？
A：主要面向要在 IDE、CLI 或自建 Agent 中集成 GPT-5.1-Codex-Max 的开发者和团队，用于设计系统提示和工具协议。
Q：指南为什么强调使用 apply_patch？
A：因为模型针对这种 diff 格式特别训练，能更稳定地产生可应用的补丁，降低误删代码或格式混乱的风险。
Q：multi_tool_use.parallel 的作用是什么？
A：用于将多个文件读取、搜索等操作打包并行执行，减少来回往返次数，提升复杂任务下的效率与稳定性。
Q：/responses/compact 上下文压缩什么时候用？
A：当对话与工具调用历史接近上下文上限时，可以通过该端点生成压缩版本，让长任务继续进行而不丢失关键信息。
Q：指南对 shell 使用有什么安全要求？
A：建议通过受限的 shell_command 工具执行命令，明确 workdir、超时和是否需要提升权限，严禁直接使用危险 git 或系统破坏性操作。
