Codex CLI Prompt Editor：用外部编辑器写长提示词

适用场景

CLI composer 适合短提示词，但复杂任务常常需要写清楚背景、范围、限制、步骤和验收标准。这时可以用 Prompt Editor。

官方文档说明，在 Codex CLI 的 prompt 输入框中按：

Ctrl+G

会打开由 VISUAL 或 EDITOR 环境变量定义的编辑器。

步骤 1：设置编辑器

在 shell 中设置 VISUAL：

export VISUAL="code --wait"

或者：

export VISUAL="vim"

如果没有设置 VISUAL，Codex 会尝试使用 EDITOR：

export EDITOR="nano"

把配置加入你的 shell profile 后，重启终端。

步骤 2：在 Codex CLI 中打开编辑器

运行：

codex

在 composer 为空或正在编辑 prompt 时，按 Ctrl+G。外部编辑器打开后，写完整任务。

示例：

目标：修复移动端导航按钮溢出。

范围：
- 只修改 src/components/site-header.tsx 和必要样式。
- 不改路由和内容读取逻辑。

验收：
- 运行 npm run lint。
- 说明是否需要截图验证。

限制：
- 保持现有设计规范。
- 不新增依赖。

保存并关闭编辑器后，Codex 会把内容带回 composer。

步骤 3：适合写长 prompt 的结构

建议使用这个模板：

目标：

背景：

范围：

不要做：

验收：

完成后请汇报：

结构越清楚，Codex 越容易按预期行动。

常见错误

不要忘记 --wait。如果用 VS Code 这类 GUI 编辑器，通常要让命令等待文件关闭，否则 Codex 可能马上拿到空内容。

不要把密钥或客户数据写进长 prompt。Prompt editor 只是编辑体验更好，不改变数据安全边界。

不要把多个不相关任务写进同一个长 prompt。长不等于乱。

小结

Prompt Editor 适合写复杂任务说明。先设置 VISUAL 或 EDITOR，在 CLI 中按 Ctrl+G，用外部编辑器写清目标、范围、限制和验收，再交给 Codex 执行。