再见 Claude Code！玩转 CodeX CLI 的 16 个实用小技巧，效率拉满！！

大家好，我是R哥。

最近用上了 CodeX CLI，替代了 Claude Code，原因不多说，看这篇：

再见 Claude Code，我选择了 Codex！真香！！

今天，我再来分享一波我实战中积累的 CodeX CLI 实用小技巧，不管你是新手刚入坑，还是老司机，这些技巧都能帮你用得更溜、更爽、更高效。

这些都是我自己真正在项目中踩过坑、总结出的实战经验，不管你平时在公司写代码，还是想让 CodeX 整点副业的活，这波技巧都值得你收藏。

那我们开干吧，没空看，关注收藏一波！

1、使用别名

学会使用别名，快速启动工作。

如下所示：

alias codex='codex -m gpt-5-codex -c model_reasoning_effort="high" -c model_reasoning_summary_format=experimental --search --dangerously-bypass-approvals-and-sandbox'

这样只是临时在当前会话生效，关掉就没有了，如果要永久生效，建议在本机环境中配置。

Mac 参考配置如下：

echo "alias codex='codex -m gpt-5-codex -c model_reasoning_effort="high" -c model_reasoning_summary_format=experimental --search --dangerously-bypass-approvals-and-sandbox'" >> ~/.zshrc
source ~/.zshrc

这样在启动的时候就配置好模型等参数了，而不需要启动之后再调整，相关参数在下面会有详细说明。

2、使用快捷命令

在 CodeX 中使用 / 就能调出所有已支持的快捷命令：

命令功能解释如下表所示：

命令	中文说明
/model	切换模型和推理等级
/approvals	设置授权模式
/new	开启新的会话
/init	初始化 AGENTS.md 指导文件
/compact	上下文压缩，避免触发上下文限制
/diff	显示 git 差异
/mention	引用某个文件
/status	显示当前会话配置和 Token 用量

3、快速换行

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

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

4、中断请求/退出会话

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

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

5、通过 API 使用

如果你没有订阅付费计划，免费账户也可以通过付费 API 的形式使用 CodeX，你可以通过修改 codex 配置文件中的 preferred_auth_method 配置来更换为 API 使用认证方式。

费用说明

以下是 GPT-5 的 API 价格：

以下是其他 GPT 的 API 价格：

更多费用明细查看官方说明：

https://openai.com/api/pricing/

切换 API 认证

修改配置文件：

~/.codex/config.toml

添加以下 API 认证配置：

preferred_auth_method = "apikey"

你也可以通过 CLI 命令行工具临时覆盖这个设置：

codex --config preferred_auth_method="apikey"

你可以通过运行以下命令返回到 ChatGPT 默认认证方式：

codex --config preferred_auth_method="chatgpt"

你可以根据需要来回切换，比如说，如果你的 ChatGPT 账号额度用完了，你就可以切换 API 方式来使用 CodeX。

6、初始化项目指导文件

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

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

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

通过 /init 命令，初始化一个项目的 AGENTS.md 指导文件：

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

把AGENTS.md转换成中文

7、切换模型与推理等级

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

如图所示：

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

也可以通过在启动 codex 的时候，加上 -m 或者 --model 参数来切换指定模型。

比如切换到 gpt-5 模型：

codex --model gpt-5 -c model_reasoning_effort="high"

也可以是这样：

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

这样，如果使用 /model 命令无法切换到旧模型（比如：o4-mini），就可以使用这招来切换了。

另外，还支持 -c model_reasoning_summary_format 参数，强制推理总结格式，支持 none | experimental 两个值，即默认格式/实验性格式。

8、切换授权模式

Codex 的默认授权模式为 auto，Codex 可以自动读取文件、进行编辑并在工作目录中运行命令。不过，处理工作目录外的文件或访问网络，它会需要你的同意。

如果你只想随便聊聊，或者在真正开始之前先规划一下？

用 /approvals 命令切换到 Read Only 只读模式就行啦：

如果你需要 Codex 在未经你允许的情况下，就能读取文件、编辑内容、运行命令，甚至处理工作目录外的文件或者访问网络，那你可以用 Full Access 完全访问模式。

不过用之前可得小心点！

来对比下三种模式的差异：

权限项	Auto（默认）	Read Only	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 参数就能使用指定的授权模式了。

9、网络搜索

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

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

codex --search

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

10、引用文件

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

在 IDE 插件使用更方便：

引用具体文件，可以让 CodeX 工作更高效，也可以防止它改错文件。

11、输入图像

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

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

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

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

12、脚本功能

你还可以用 exec 命令，以非交互方式运行 Codex：

codex exec "修复这个报错的问题"

13、上下文压缩

执行 /compact 命令可压缩上下文，避免触发上下文限制。

如图所示，输入框下面会显示当前剩余上下文长度：

14、查看配置和 Token 用量

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

如图所示，显示了我的账户信息、模型信息、Token 使用量信息等等。

15、MCP 集成

配置 MCP

Codex CLI 可以通过在 ~/.codex/config.toml 中定义一个 mcp_servers 部分来配置 MCP，和 Claude 和 Cursor 在各自的 JSON 配置文件中定义 mcpServers 一样，但是 Codex 的格式略有不同，它使用 TOML，而不是 JSON。

比如我添加了以下几个 MCP：

[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
env = { "test" = "123456" }[mcp_servers.puppeteer]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-puppeteer"]
env = { "test" = "123456" }

验证 MCP

目前来说，Codex 还没有提供专门的命令来验证 MCP 服务器的集成情况，不像 Claude Code / Gemini CLI 能提供详细的 MCP 连接信息，相信后续迭代会添加上。

不过，要是在启动 Codex 时，如果连不上你配置的 MCP server，就会给出错误信息。

比如我故意把 @upstash/context7-mcp 改成 @upstash/context7-mcp1 后，再执行 codex：

要是没看到这个报错，那就可以认为 MCP 集成没问题了。

使用 MCP

比如，我来测试下使用 context7 这个 MCP Server：

请使用context7写一段最新的java25的switch代码

如图所示，控制台已经显示成功调用 context7 工具，并成功输出了代码。

16、更多配置

Codex CLI 还支持超多配置选项，偏好设置都存在 ~/.codex/config.toml 这个配置文件里，一些命令行设置的，或者通过 / 设置的个性化参数都可以在这里进行配置。

如果使用了 VS Code 中的 CODEX 插件，可以在设置菜单中打开并编辑这个文件：

示例配置如下：

model = "gpt-5-codex"
[projects."/Users/XX/project1"]
trust_level = "trusted"[projects."/Users/XX/project2"]
trust_level = "trusted"...

更多详细配置参考官方文档：

https://github.com/openai/codex/blob/main/docs/config.md

---

好了，这次的分享就到了～

以上就是我在实际使用 CodeX 编程时的一些高效技巧和避坑心得，真的都是无保留实践总结。

不过，现在 CodeX CLI 还有一个不太方便的操作，那就是不能管理和恢复会话，相信在后续的版本中都会补齐，后续更新。

未完待续，接下来会继续分享更多 CodeX 的心得体验、高级使用技巧，公众号持续分享 AI 实战干货，关注「AI技术宅」公众号和我一起学 AI。

AI 不会淘汰程序员，但不会用 AI 的除外，会用 AI 的程序员才有未来！

版权声明： 本文系公众号 "AI技术宅" 原创，转载、引用本文内容请注明出处，抄袭、洗稿一律投诉侵权，后果自负，并保留追究其法律责任的权利。