🔥小龙报：个人主页
🎬作者简介：C++研发，嵌入式，机器人，AI等方向学习者
❄️个人专栏：《Codex应用实战》
✨ 永远相信美好的事情即将发生

---

前言

OpenAI Codex是适配代码开发的AI工具，依托MCP协议拓展工具能力，区别于主流编辑器的JSON配置，其采用TOML格式适配参数。本文聚焦Codex完整实操应用，详细讲解模型切换、推理等级设置、基础命令与权限配置，同时介绍AGENTS.md记忆、上下文压缩、自定义命令等核心功能，梳理实用操作技巧，帮助开发者快速掌握Codex，提升代码开发效率。

---

一、模型的切换与推理等级

Codex 默认搭配的是 OpenAI 最牛的代码专用模型 gpt-5-codex，默认的推理等级是：中等， gpt-5-codex 是 CodeX 专用的代码模型，比 GPT-5 更强。 如图所示：

可以用/model 命令切换模式及推理等级：

比如切换到 gpt-5 模型：

codex --model gpt-5.3-codex -c model_reasoning_effort="medium"

也可以是这样：

codex -m gpt-5.3-codex -c model_reasoning_effort="high"

参数释义

1. --model gpt-5.3-codex：指定使用 gpt-5.3-codex 模型
2. -c：配置项参数（set config）
3. model_reasoning_effort="medium"：推理强度设为中等，可选值：low / medium / high

二、基础入门

2.1 基础命令速查

# 交互式TUI模式
codex

# 带初始提示启动
codex "fix lint errors"

# 非交互式自动化模式
codex exec "explain utils.ts"

# 沙盒自动模式
codex --full-auto "create the fanciest todo-list app"

# 非沙盒自动模式
codex --dangerously-bypass-approvals-and-sandbox "create the fanciest todo-list app"

✨	提示词	功能
1	codex "Refactor the Dashboard component to React Hooks"	Codex 重写了类组件，运行了 npm test，并显示了差异
2	codex "Generate SQL migrations for adding a users table"	推断你的 ORM，创建迁移文件，并在沙盒数据库中运行它们
3	codex "Write unit tests for utils/date.ts"	生成测试，执行测试，并反复迭代直到通过
4	codex "Bulk-rename *.jpeg -> *.jpg with git mv"	安全地重命名文件并更新导入 / 使用
5	codex "Explain what this regex does: ^(?=.*[A-Z]).{8,}$"	输入一步步的解释
6	codex "Carefully review this repo, and propose 3 high impact well-scoped PRs"	建议在当前代码库中提出有影响力的 PR
7	codex "Look for vulnerabilities and create a security review report"	发现并解释安全漏洞

2.2 实用技巧

2.2.1 恢复历史会话

• codex resume
  直接输入 codex resume，会弹出会话选择器，允许你选择要恢复的历史会话[1]。

• codex resume --last
  恢复最近的一次会话[1]。

• codex resume <session_id>
  通过会话 ID 恢复某个特定会话。会话 ID 可以通过 /status 命令或在 ~/.codex/sessions/ 目录下查找[1]`。

2.3.2 AGENTS.md 记忆

AGENTS.md 记忆功能类似 Claude Code 的 CLAUDE.md，让 AI 记住项目特定的指导：

# 全局配置
~/.codex/AGENTS.md

# 项目配置
./AGENTS.md

# 子目录配置
./components/AGENTS.md

你可以在 codex 中输入 /init 提示，让 codex 帮你生成初始的 AGENTS.md 文件。

CodeX 中的 AGENTS.md 是一个简单又开放的格式，专门用来指导 CodeX 更好的干活。

可以把 AGENTS.md 想象成是给 Agents 准备的 README，它提供了一个专门的、可预测的地方，用来提供上下文和指令，帮助 AI 编码 Agents 更好地完成你的项目。

详细介绍：https://agents.md/

默认使用的文件是英文的，可以手动把它转换成中文： 把 AGENTS.md 转换成中文

2.3 自定义命令

Codex 也支持自定义斜杠命令，不过它叫自定义提示词，存放路径为 ~/.codex/prompts/。

自定义命令要求：

• 文件必须是 Markdown 格式；
• 文件名作为命令名称，即最终的命令格式为 /filename（不带 .md 后缀）；
• 自定义命令不支持参数，所以提示词必须要自包含（即在需要补充上下文的场景中，提示词要能指导 AI 去找到相关上下文）；
• 新建自定义命令后需要重启 Codex 命令才生效。

2.4 使用快捷命令

在 CodeX 中使用/ 就能调出所有已支持的快捷命令：
命令功能解释如下表所示

指令	功能说明
/model	切换模型与推理强度
/fast	1.5 倍响应速度，消耗更多额度
/ide	读取 IDE 选中内容、打开文件作为上下文
/permissions	配置 Codex 文件系统操作权限
/keymap	自定义终端快捷键
/vim	开启 / 关闭 Vim 编辑模式
/sandbox-add-read-dir <绝对路径>	允许沙箱读取指定文件夹
/experimental	启用实验性功能

2.4.1 快速换行

使用Option + Enter（Mac） 或者 Control + J 可以快速换行：

有时候输入的提示词太长，想换行输入，看起来更清晰，这招特别有用。

2.4.2 中断请求 / 退出会话

在 CodeX 正在工作时，你随时可以按 ESC 键或者 Control + C 键中断当前的请求：

再按一次 Control + C 键，或者输⼊ /quit 可以退出当前会话。

三、切换授权模式

Codex 的默认授权模式为 auto，Codex 可以自动读取文件、进行编辑并在工作目录中运行命 令。不过，处理工作目录外的文件或访问网络，它会需要你的同意。
如果你只想随便聊聊，或者在真正开始之前先规划一下？
用/permission 命令切换到 Read Only 只读模式就行啦：

如果你需要 Codex 在未经你允许的情况下，就能读取文件、编辑内容、运行命令，甚至处理工作目录外的文件或访问网络，那你可以用 Full Access 完全访问模式。
不过用之前可得小心点！来对比下四种模式的差异：

序号	权限模式	中文名称	核心能力	审批行为	适用场景
1	Read Only	只读模式	仅能读取当前工作目录文件	修改文件、联网操作等全部需手动审批	纯代码阅读、安全审计
2	Ask for approval	请求审批模式	可读写当前目录文件、执行命令	访问外网、修改目录外文件需审批	常规开发、受控环境
3	Approve for me	智能自动放行	可读写当前目录文件、执行命令	仅判定有潜在风险时才弹窗，常规操作自动放行	日常开发（推荐）
4	Full Access	完全无限制访问	可编辑工作区以外文件、自由联网	所有操作不再询问	完全信任环境、临时使用（⚠️高危）

另外，还支持通过 Flags 参数来精细控制权限：

模式	标志	说明
自动（默认）	无需标志，默认值	Codex 可以读取文件、编辑文件并在工作区运行命令。Codex 在运行沙箱外的命令时会请求批准。
只读	--sandbox read-only``--ask-for-approval never	Codex 只能读取文件；从不请求批准。
自动编辑，但运行不可信命令时需批准	--sandbox workspace-write``--ask-for-approval untrusted	Codex 可以读取和编辑文件，但在运行不可信命令之前会请求批准。
危险的完全访问	--dangerously-bypass-approvals-and-sandbox（别名：--yolo）	无沙箱、无批准（不推荐）。

这样，在启动 CodeX 的时候通过指定 Flags 参数就能使用指定的授权模式了。

3.1 网络搜索

有了 Web search 网络搜索，模型就能访问互联网上的最新信息，让模型在生成回复之前，先上网搜搜最新的信息，并提供带有出处的答案。

想启用这个功能，传递 --search 参数即可：

codex --search

这样可以仅使用网络搜索，而避免给 agent 完全不受限制的网络访问权限。

3.2 引用文件

你可以通过 @ 这种方式快速引用项目中的任何文件：

在 IDE 插件使用更方便：引⽤具体⽂件，可以让 CodeX 工作更高效，也可以防止它改错文件。

3.3 输入图像

你可以直接把图片粘贴到编辑器里，这样就能把它们添加到你的 prompt 中：

当然，你也可以通过 CLI，使用 -i 或者 --image 这个 flag 来附加图片文件：

codex -i screenshot.png "解释一下这个代码"

codex --image img1.png,img2.jpg "总结一下这些图表"

3.4 脚本功能

你还可以用exec 命令，以非交互方式运行 Codex： codex exec “修复这个报错的问题”

例：

3.5 上下文压缩

执行/compact 命令可压缩上下文，避免触发上下文限制。 如图所示，输入：

3.6 查看配置和Token的使用量

使用status 命令可以查看当前会话的配置和 Token用量：

总结

✨ 本文系统梳理了Codex CLI的全套实战用法，涵盖模型切换、推理强度调节、会话管理、权限分级、特色功能等核心内容，整理了可直接复用的终端命令与权限配置方案。文章详解四种授权模式的适配场景与启动参数差异，介绍了文件引用、图像输入、网络搜索等拓展能力，同时点明多次上下文压缩会降低模型精度的问题。通过全面的实操知识点，帮助开发者规范使用Codex，规避使用问题，最大化发挥AI辅助开发价值。