---

用“输入一句话就能跑”的方式用 Codex CLI（超简单入门）

这是一篇给零基础/新手看的快速上手指南：只要在命令行里输入一句“提示词”（Prompt），Codex CLI 就能理解你的意图、搭建/修改代码、在安全沙箱里运行并把结果呈现给你。

参考来源：Codex 官方 Getting Started 文档中 “Running with a prompt as input” 相关内容，本文做了通俗化解读与整理。

---

这篇文章适合谁？

• 想快速体验“自然语言驱动编码”的同学。
• 不想先学一堆 API，只想“先跑起来再说”。
• 希望用一句话完成脚手架搭建、运行测试、或做小改动的人。

什么是“用提示词直接运行”？

你可以直接在命令行里对 Codex 说出你的意图，比如：

codex "帮我解释这个代码仓库在做什么"

或者让它“全自动”执行更完整的任务（减少手动确认）：

codex --full-auto "创建一个很炫的待办清单应用"

接下来 Codex 会理解你的描述，自动搭建/修改代码，并在沙箱中运行、安装缺失依赖、展示结果和变更。你只需在关键节点做确认即可。

运行时到底会发生什么？

• 生成/修改代码：根据你的目标脚手架项目或改动现有文件。
• 沙箱执行：在隔离环境里运行代码，保证安全、可回滚。
• 自动补依赖：缺什么装什么，不用你手动 npm install/pip install。
• 展示结果与 Diff：把运行结果、变更内容展示给你。
• 一键批准并落盘：你确认后，改动会落到你的工作目录并可提交到 Git。

最快上手：两条命令

• 交互式（推荐新手先用）

  codex "请把这个仓库的大致结构和模块职责解释给我"
  

  体验节奏：Codex 会给出计划、展示变更，重要步骤让你确认。

• 全自动（减少打断，更快产出）

  codex --full-auto "生成一个简单但结构清晰的待办应用，并跑起来"
  

  体验节奏：Codex 尽量不打断你，直接产出并运行。适合明确的小任务。

提示词怎么写？（可抄的思路）

你可以把 Codex 当“聪明的搭档”。描述清楚目标、范围、约束，效果最好：

• “把 Dashboard 类组件重构为 React Hooks，保持现有行为，补充必要测试。”
• “为项目新增 users 表的数据库迁移，按项目里已有 ORM 规范生成并在沙箱 DB 里试跑。”
• “为 utils/date.ts 编写单元测试，保证边界条件覆盖，并运行到通过为止。”
• “把所有 .jpeg 重命名为 .jpg，要用 git mv 并修正引用。”
• “逐步解释这个正则 ^(?=.*[A-Z]).{8,}$ 的含义和匹配策略。”
• “审阅这个仓库并给出 3 个高影响、范围清晰的改进 PR 点子。”
• “做一次安全检查并列出潜在漏洞及修复建议。”

小贴士：

• 明确输入输出（要哪些文件、要跑哪些脚本、产物放哪里）。
• 先小后大（把目标拆小，分步骤更稳）。
• 允许迭代（看结果不满意就补充限制条件再来一次）。

让 Codex 记住你的“偏好”：AGENTS.md

想让 Codex 更懂你的项目规约（命名风格、目录结构、代码习惯）？可以在这些位置放 AGENTS.md：

1. ~/.codex/AGENTS.md（个人全局偏好）
2. 项目根目录的 AGENTS.md（团队/项目级约束）
3. 子目录里的 AGENTS.md（针对某个模块/功能的特定说明）

Codex 会按 1 → 2 → 3 的顺序合并这些指导。可写的内容包括：代码风格、如何运行/测试、约束与黑名单、生成内容的文件命名规范等。

常用技巧与快捷方式

• @ 文件搜索：在输入框里敲 @ 就能模糊搜索工作区文件，回车或 Tab 选中即可插入路径。
• 图片输入：可以用 -i/--image 附加图片做视觉理解。

  codex -i screenshot.png "解释这个报错"
  codex --image img1.png,img2.jpg "帮我总结这两张图的流程"
  

• 快速编辑上一条消息：在聊天输入为空时按 Esc 进入回溯编辑，再按 Esc 选择上一次用户消息进行修改并重试。
• Shell 补全：

  codex completion bash
  codex completion zsh
  codex completion fish
  

• 指定工作目录：不用 cd 也行。

  codex --cd path/to/project "在这个目录里执行我的任务"
  

常见疑问（FAQ）

• 必须写得很正式吗？不需要，但“清楚”和“具体”能显著提升效果。
• 会不会改坏我项目？改动先在沙箱验证，且你可以在落盘前审阅和批准。
• 失败了怎么办？缩小范围、补充上下文，多给一些项目线索（如运行方式）。

小结与下一步

• 你已经知道：一句提示词就能驱动 Codex 完成搭建/修改/运行的整套流程。
• 现在就试试：

  codex "解释当前仓库的结构并给出改进建议"
  

• 想要更稳：把你的团队规范写进 AGENTS.md，让 Codex 更贴合你的项目。

祝玩得开心，也欢迎把你的高效提示词套路沉淀到 AGENTS.md 里共享给团队！