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

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

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

比如切换到 gpt-5 模型：

也可以是这样：

参数释义

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

二、基础入门

2.1 基础命令速查

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 中输入 /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 中使用/ 就能调出所有已支持的快捷命令：

命令功能解释如下表所示

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 完全访问模式。
不过用之前可得小心点！来对比下四种模式的差异：

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

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

3.1 网络搜索

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

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

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

3.2 引用文件

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

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

3.3 输入图像

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

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

3.4 脚本功能

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

例：

3.5 上下文压缩

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

3.6 查看配置和Token的使用量

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

总结

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