跳转到内容

IDE、CLI、桌面版怎么配合

教程版本基线Codex CLI v0.147.0

Codex 的入口不是互相替代,而是各自适合不同阶段。

前置教程:IDE 里第一次做局部修改
如果你还没有用 IDE 扩展完成一次局部修改,先完成前置教程。

依据来源:OpenAI Codex 官方手册中关于 IDE extension、CLI、Codex app、共享配置、工作流和审批沙箱的说明。

阶段 推荐入口 原因
看不懂当前代码 IDE 打开文件和选中代码就是上下文
做小范围局部修改 IDE 目标明确,改动小
阅读整个项目 CLI 或桌面版 更适合项目级上下文
修改多个文件 CLI 更适合构建、测试和 Git 状态
审查结果和管理多任务 桌面版 更适合看线程、diff、审批
长任务和并行任务 Cloud 更适合远程和后台任务

适合场景:

  • 你在 IDE 里看懂了问题。
  • 修改可能影响项目行为。
  • 需要构建或测试验证。

步骤:

  1. 在 IDE 里选中代码,让 Codex 解释。
  2. 在 IDE 里完成小修改,或只生成修改方案。
  3. 切到 CLI。
  4. 让 Codex 检查当前变更和项目脚本。
  5. 让 Codex 根据现有脚本做必要验证。
  6. 阅读验证结果和 diff 总结。

CLI 提示词:

请检查当前项目的未提交变更。
要求:
1. 不要新增功能。
2. 只围绕刚才 IDE 中的局部修改做检查。
3. 总结改动文件。
4. 根据项目现有脚本判断是否需要运行构建、测试或类型检查。
5. 如果运行了检查,请说明结果;如果没有运行,请说明原因。

工作流 2:CLI 读项目,IDE 看细节

Section titled “工作流 2:CLI 读项目,IDE 看细节”

适合场景:

  • 你不知道入口文件在哪里。
  • 你不知道问题在哪个模块。
  • 你需要先让 Codex 建立项目地图。

步骤:

  1. 在 CLI 里让 Codex 只读分析项目。
  2. 让它列出相关文件。
  3. 在 IDE 里打开这些文件。
  4. 用 IDE 扩展解释当前文件和选中代码。
  5. 再决定是否局部修改。

CLI 提示词:

请只读分析当前项目,不要修改任何文件。
请告诉我和【问题或功能】最相关的 3 到 5 个文件,以及每个文件为什么相关。

IDE 追问:

请解释当前文件和刚才 CLI 提到的问题有什么关系。
不要修改文件。

工作流 3:桌面版做审查,CLI 做修复

Section titled “工作流 3:桌面版做审查,CLI 做修复”

适合场景:

  • 你已经有一批改动。
  • 想先审查风险。
  • 修复时又需要本地验证。

步骤:

  1. 在桌面版里让 Codex 审查当前变更。
  2. 找到真实 bug、风险和漏测。
  3. 把明确的问题交给 CLI 修复。
  4. CLI 修复后运行必要检查。
  5. 回到桌面版或 CLI 看总结。

桌面版审查提示词:

请审查当前变更,不要修改文件。
优先找真实 bug、行为回归、漏测和安全风险。
请按严重程度排序,并给出文件位置和建议修复方式。

CLI 修复提示词:

请只修复刚才审查指出的这个问题:【粘贴问题】
不要修改无关文件。
完成后请总结 diff 和验证结果。

工作流 4:IDE 定位,桌面版拆任务

Section titled “工作流 4:IDE 定位,桌面版拆任务”

适合场景:

  • 你在 IDE 里发现一个复杂问题。
  • 它不是一小段代码能解决的。
  • 需要拆成多个小任务。

步骤:

  1. 在 IDE 里让 Codex 解释当前问题。
  2. 把问题背景复制到桌面版。
  3. 让桌面版拆任务。
  4. 每个子任务再选择 CLI 或 IDE 执行。

桌面版拆解提示词:

我在 IDE 里定位到这个问题:
【粘贴问题背景】
请不要修改文件。
请帮我拆成 3 到 5 个最小任务,每个任务包含目标、范围、禁止事项和验收标准。

多入口配合不是同时开一堆会话乱改。

要遵守 4 条规则:

  1. 同一时间只让一个入口负责修改。
  2. 另一个入口只做解释或审查。
  3. 修改前明确范围。
  4. 修改后统一做一次提交前检查。

如果 IDE、CLI、桌面版都同时改文件,最后会很难判断是谁改了什么。

完成后,你应该能做到:

  • IDE 负责当前文件和局部问题。
  • CLI 负责本地项目验证和 Git 相关检查。
  • 桌面版负责拆解、审查和多任务管理。
  • 避免多个入口同时乱改文件。
  • 根据任务阶段切换入口。

下一篇建议看:配置大模型总览第一次让 Codex 阅读项目