本文基于 OpenAI 官方 Codex CLI Command line options 页面生成。官方原文只保留一个短摘录；主要精读材料是根据官方页面信息改写的英文学习段落，不是官方逐字原文。
悬停整句 → 显示中文翻译 | 悬停彩色词 → 显示词类型 | 点击英文句子/虚线词 → 朗读
官方短摘录：This page catalogs every documented Codex CLI command and flag.
英文原句：
Codex reference pages help you look up command-line behavior instead of learning a step-by-step tutorial.
自然翻译：Codex 的参考文档是用来帮你查询命令行行为的，不是一步一步带你学的教程。
句子主干：Reference pages help you look up behavior.
结构拆解：help you look up... 表示“帮你查询”；instead of... 做对比，说明 reference 不是 tutorial。
大白话解释：reference 不是拿来通读的，而是遇到命令或参数不会用时查的。
英文原句：
The command line options page lists documented Codex CLI commands and flags, so you can search for a key or description when you forget how an option works.
自然翻译：这个命令行选项页面列出了有文档说明的 Codex CLI 命令和 flag，所以当你忘记某个选项怎么用时，可以按 key 或描述去搜索。
句子主干：The page lists commands and flags.
结构拆解：前半句说明页面内容；so you can... 说明结果或用途；when you forget... 说明使用场景。
大白话解释：你忘了某个参数，就在表格里搜名字或说明。
英文原句：
Each section marks whether an option is stable or experimental and warns about risky combinations.
自然翻译：每个小节都会标明某个选项是稳定功能还是实验性功能，并提醒你注意有风险的组合。
句子主干：Each section marks and warns.
结构拆解：whether A or B 表示“是 A 还是 B”。两个动作是 marks 和 warns。
大白话解释：不要只看参数名，还要看成熟度和风险提示。
英文原句：
Most default settings come from your ~/.codex/config.toml file.
自然翻译：大多数默认设置来自你的 ~/.codex/config.toml 文件。
句子主干：Default settings come from a file.
结构拆解：Most 表示不是全部，但大多数是这样。come from 在技术文档里常表示“来源于”。
大白话解释：平时不写参数时，Codex 会去读你的配置文件。
英文原句：
When you pass -c key=value on the command line, that value overrides the config file for this invocation only.
自然翻译：当你在命令行里传入 -c key=value 时，这个值会覆盖配置文件里的设置，但只对本次调用生效。
句子主干：That value overrides the config file.
结构拆解：When you pass... 是条件；主句说明命令行里的值会覆盖配置文件。for this invocation only 限定只对这一次生效。
大白话解释：命令行临时传的配置比文件里的默认配置更优先，但只管这一次运行。
| 英文 | 本文意思 | 普通意思 | 技术文档常见意思 | 记忆提示 |
|---|---|---|---|---|
| reference | 参考文档 | 参考、引用 | 用来查询细节的说明文档 | reference = 查字典 |
| command-line | 命令行的 | 命令 + 行 | 通过终端命令使用工具的方式 | line 指终端输入行 |
| behavior | 行为 | 行为、表现 | 工具在某种设置下实际会怎么运行 | 看工具会怎么做 |
| tutorial | 教程 | 教程 | 按步骤带你学习的文档 | tutorial = 从头教 |
| command | 命令 | 命令 | 终端里执行的操作入口 | command 可带子命令 |
| flag | 参数 | 旗子 | 以 -- 或 - 开头的命令选项 | flag 改变命令行为 |
| key | 键 / 参数名 | 钥匙、关键 | 配置项名称或表格索引 | key=value 里的 key |
| description | 描述 | 描述 | 对参数用途的说明文字 | 通过说明搜索 |
| option | 选项 | 选择 | 命令或配置里的可选设置 | option 比 flag 更泛 |
| stable | 稳定的 | 稳定的 | 已成熟、适合日常使用 | stable = 放心用 |
| experimental | 实验性的 | 实验性的 | 可能变化、谨慎使用 | experimental = 会变 |
| default | 默认值 | 默认的 | 没有指定时自动采用的值 | 不写就用它 |
| config file | 配置文件 | 配置文件 | 保存工具默认行为的文件 | config = configuration |
| override | 覆盖 | 推翻、凌驾 | 临时值优先于默认值 | over + ride = 压过去 |
| invocation | 一次调用 | 祈求、调用 | 某一次命令执行 | 只管这一次 |
悬停造句 → 显示中文翻译 | 点击英文例句 → 朗读
| 短语 | 中文意思 | 为什么重要 | 自己造句 |
|---|---|---|---|
| look up | 查询 | reference 文档的核心用法 | Use the reference page to look up a flag.用参考文档查询某个参数。 |
| command-line behavior | 命令行行为 | 帮你理解参数会改变什么 | This flag changes command-line behavior.这个参数会改变命令行行为。 |
| step-by-step tutorial | 分步骤教程 | 区分 reference 和 tutorial | This page is not a step-by-step tutorial.这个页面不是分步骤教程。 |
| documented commands and flags | 有文档说明的命令和参数 | 读懂 reference 页面范围 | The table lists documented commands and flags.这个表格列出有文档说明的命令和参数。 |
| search for a key or description | 按键名或描述搜索 | 说明怎么查表格 | Search for a key or description when you forget an option.忘记某个选项时，按键名或描述搜索。 |
| stable or experimental | 稳定或实验性 | 判断是否适合日常使用 | Check whether the option is stable or experimental.检查这个选项是稳定的还是实验性的。 |
| risky combinations | 有风险的组合 | 参数组合可能带来安全风险 | Avoid risky combinations in production.在生产环境里避免有风险的组合。 |
| for this invocation only | 只对本次调用生效 | 理解临时覆盖的范围 | This value applies for this invocation only.这个值只对本次调用生效。 |
悬停例句 → 显示中文翻译 | 点击英文例句 → 朗读
意思：X 帮你做 Y，而不是做 Z。
还能这样用：instead of 常用来区分两个相近但不同的用途。
意思：这个页面列出了 X，所以你可以做 Y。
还能这样用：so you can 后面通常说明页面、工具或功能的用途。
意思：每个小节都会标明 X 是 A 还是 B。
还能这样用：whether A or B 常用于表达“判断是哪一种状态”。
意思：当你传入 X 时，Y 会覆盖 Z。
还能这样用：这个句式常用于解释配置优先级。看到 override，要立刻想到“谁比谁优先”。
Codex 的命令行参考文档不是教程，而是用来查询命令、参数、默认值和临时覆盖规则的工具说明书。