Codex 使用指南

Appearance

提示词 ​

官方原文： Prompting
译文同步： 2026-07-22

提示词概览 ​

提示词是你告诉 ChatGPT 想了解、创建或改变什么的方式。它可以是问题、指令或目标。你不需要技术语法或固定公式：先用自己的话开始，检查回复，再通过后续消息逐步调整结果。

短提示词通常已经足够。对于较大或较重要的任务，可以补充真正有影响的部分：

  • 目标（Goal）： ChatGPT 应该做什么？
  • 上下文（Context）： 哪些信息或来源会有帮助？
  • 输出（Output）： 需要什么格式、长度或详细程度？
  • 边界（Boundaries）： 哪些内容不能改变？执行哪些动作前必须先与你确认？

只使用有帮助的部分，不必逐项填写，也没有强制格式。

描述你需要的结果 ​

先说明结果，而不是列出很长的操作步骤。当受众或格式会改变成品时，把它们写清楚。

text
把这些会议记录整理成一份发给项目团队的简短更新。
将已做决定和下一步行动放在最前面。

如果过程本身很重要，再说明过程；否则给 ChatGPT 留出搜索、比较信息和调整方法的空间。

添加有用的上下文 ​

提供可能改变结果的信息，只添加真正相关的来源，并说明 ChatGPT 应从每个来源中获取什么。

  • 需要总结、比较、转换或创建文件时，附上文档、电子表格、演示文稿或 PDF；
  • 任务依赖视觉信息时，附上截图、图表或其他图像，并指出需要关注的区域；
  • 答案依赖最新信息时，明确要求使用网页搜索；需要核验时要求列出来源；
  • 相关对话需要共享文件、来源或本地文件夹时，使用项目（Project）。

使用已连接的来源 ​

当 ChatGPT 可以访问已连接来源时，说明应去哪里查找以及需要找到什么，不必逐条规定搜索动作。

text
使用 Drive 中最新的项目计划，以及项目 Slack 频道中的相关决定和更新，
准备一份项目状态报告。

连接来源需要相应插件，可用性可能取决于套餐和工作区设置。

使用插件 ​

插件为 ChatGPT 提供可复用指令，并连接 Google Drive、Gmail、Slack、GitHub 等工具。描述需要的结果，让 ChatGPT 从可用工具中选择；若要指定插件，可在输入框中键入 @。

个性化 ChatGPT ​

应跨对话生效的偏好可以放入 Settings > Personalization 的自定义指令中。只与当前对话有关的细节仍应写进当前提示词。

设置能避免真实问题的边界 ​

边界应聚焦于防止额外工作或意外动作。例如：

  • 保持已批准的日期和预算数字不变；
  • 只使用提供的来源，缺少信息时明确标记，不要猜测；
  • 建议不得超出指定预算；
  • 只准备消息草稿，不要发送。

聚焦最重要的一两条边界，不必控制 ChatGPT 的每一步。

让结果可以直接使用 ​

说明你准备如何使用结果，帮助 ChatGPT 选择合适的长度、细节和结构。

  • 写成主管会前可以快速浏览的一页摘要，将决定和下一步放在最前面；
  • 把记录整理成跟进邮件，包含决定、负责人和截止日期；
  • 创建“计划支出与实际支出”的清晰表格，突出超过 10% 的差异。

对于重要工作，可要求在结束前做最终检查，例如确认每个行动项都有负责人和截止日期，或标记无法验证的信息。使用或分享之前，你仍应亲自审查结果。

用后续消息改进结果 ​

第一条提示词不必完美。先检查结果，再明确要求具体修改。

text
开头写得更直接，保留证据，并把建议移到背景说明之前。

你可以补充缺失来源、纠正方向、要求另一种方案或改变详细程度，而不必从头开始。

引导（Steer）与排队（Queue） ​

Codex 正在工作时，你可以不等当前运行结束就发送另一条消息：

  • Steer：将消息加入当前运行，适合改变方向、补充遗漏细节或提供新信息；
  • Queue：把消息留到下一次运行，适合应等当前工作完成后再处理的后续任务。

在 ChatGPT 桌面应用中，可在 Settings > General > Follow-up behavior 设置默认行为。Codex CLI 中，Codex 工作时按 Enter 可引导当前轮次，按 Tab 可将消息排到下一轮。

把各部分组合起来 ​

text
为周一的管理层会议准备一页项目状态更新。使用 Drive 中最新的项目计划，
以及项目 Slack 频道中的相关决定和更新。

首先列出管理层需要做出的决定和下一步行动。总结进度、风险、负责人和截止日期。
保持已经批准的日期和预算数字不变。标记互相冲突或缺失的信息，
不要发送或发布任何内容。

结束前，检查每个下一步行动是否都有负责人和截止日期。

这段提示词包含目标、上下文、输出和边界，并要求最终检查，但没有逐步规定所有操作。

Chat 模式示例 ​

理解一个主题 ​

text
向从未投资过的人解释复利如何运作。
使用一个具体示例，并解释出现的金融术语。

起草和修改文字 ​

text
起草一封友好的邮件，因为我要出行而婉拒这次邀请。
控制在 120 字以内，并为今后的活动保留可能性。

比较方案 ​

text
为一位每年出国两次的用户比较这两个手机套餐。
用表格展示重要差异，然后推荐一个并解释取舍。

在 Work 模式中编写提示词 ​

快速提问、短文改写、头脑风暴和轻量草稿可使用 Chat 模式。任务需要综合多个来源或工具、经过一系列步骤、执行修改或产生大型交付物时，使用 Work 模式。

在 Work 模式中，应描述所需结果、提供来源材料、说明受众，并解释你将如何审查工作。可以要求 ChatGPT 制定计划、收集必要信息、创建文件并在结束前检查。

高效使用 Work 模式 ​

  • 只包含相关来源，必要时限制日期范围；
  • 定义受众、输出格式和期望长度；
  • 区分必做工作与可选优化；
  • 方法很重要时要求先给计划；发送、发布或更改他人依赖的信息前必须获得批准；
  • 任务开始做你不再需要的工作时，缩小范围或停止任务。

先审查第一版结果，完善指令，并在工作流可靠后复用它。

为 Codex 编写提示词 ​

需要 ChatGPT 结合代码、代码库或开发者工具工作时，使用 Codex。有效的 Codex 提示词应说明期望行为，指向相关代码或复现步骤，保留重要约束，并说明如何验证改动。

对于多步骤任务，可在应用输入框键入 /plan，让 Codex 在编辑前先调查并提出方法。如果 Goal 模式可用，可在计划之后使用 /goal 设置持续目标。

NOTE

IDE 扩展会自动把打开的文件作为上下文。在 CLI 中应明确提及路径，或使用 /mention 和 @ 路径自动补全附加文件。

Codex 在限制文件和网络访问的沙箱中运行本地命令。任务需要越过该边界时，Codex 会按照当前审批策略继续。

解释代码库 ​

text
阅读 @foo.ts 和 @schema.ts，解释这个服务使用的协议、数据结构和请求/响应流程。
重点说明必填字段、可选字段和向后兼容规则。先不要修改文件。

修复 Bug ​

text
Bug：在设置页点击“保存”有时会显示成功，但修改没有持久化。

复现：
1. npm run dev
2. 打开 /settings
3. 切换“Enable alerts”
4. 点击 Save
5. 刷新页面，开关恢复原状

约束：不要改变 API 结构；保持修复最小；可行时添加回归测试。
先在本地复现问题，再提出补丁并运行检查。

编写测试 ​

text
为 @transform.ts 中的 invert_list 函数添加测试。
覆盖正常路径和边界情况，并遵循仓库现有测试约定。

根据截图制作原型 ​

text
根据附图创建新的仪表盘。

约束：使用 React、Vite、Tailwind 和 TypeScript；
尽可能匹配间距、字体和布局。

输出：可渲染 UI 的新路由、必要的小组件，以及本地运行说明。

本地代码审查 ​

在 Codex CLI 中运行：

text
/review

也可以补充审查重点：

text
/review 重点检查边界情况和安全问题

根据反馈完成修复后，再运行一次 /review，确认问题已经解决。

更新文档 ​

text
更新“高级功能”文档，补充身份验证故障排除说明。
验证所有链接都有效，并报告检查结果。

草稿生成后，请阅读渲染页面并继续迭代。