Codex 常用命令速查表

发表于 2026-05-03 分类于 AI工具阅读次数：本文字数： 5.1k 阅读时长 ≈ 9 分钟

为什么需要一份速查表

Codex 日常使用时，真正高频的不是所有命令，而是几个固定场景：启动一个会话、指定项目目录、继续上次上下文、切换模型、处理权限、管理插件、做一次代码审查。

如果每次都从完整帮助文档里找命令，效率不高。更实用的方式是按场景整理一份速查表，需要时直接查对应段落。

本文只总结 Codex CLI 和会话相关命令，不展开 Superpowers、Blogpowers 这类插件自己的技能命令。

启动与继续会话

最基本的入口是直接运行 codex。如果不带子命令，Codex 会进入交互式 CLI。

命令	用途	示例
`codex`	启动交互式会话	`codex`
`codex "prompt"`	带初始问题启动会话	`codex "帮我检查这个 Hexo 博客结构"`
`codex -C <DIR>`	指定工作目录启动	`codex -C D:\blog\blog`
`codex resume`	从历史会话选择一个继续	`codex resume`
`codex resume --last`	直接继续最近一次会话	`codex resume --last`
`codex resume --all`	显示所有会话，不只看当前目录	`codex resume --all`
`codex fork`	从历史会话分叉新会话	`codex fork`
`codex fork --last`	从最近会话分叉	`codex fork --last`

resume 适合继续之前没有完成的上下文。fork 更适合从同一个上下文开一个新方向，例如原会话在写博客，分叉出来专门做一次结构调整。

如果是在具体项目里工作，我更倾向于显式加上 -C：

1	codex -C D:\blog\blog

这样会话从一开始就知道工作根目录，后续读写文件时不容易跑偏。

非交互式执行

如果只想让 Codex 执行一次明确任务，不需要进入完整交互界面，可以用 exec。

命令	用途	示例
`codex exec "prompt"`	非交互式执行一次任务	`codex exec "总结 package.json 里的脚本"`
`codex e "prompt"`	`exec` 的别名	`codex e "检查 README 是否过期"`
`codex exec -C <DIR> "prompt"`	指定目录执行一次任务	`codex exec -C D:\blog\blog "列出最近的博客草稿"`
`codex exec resume --last`	继续最近的非交互式会话	`codex exec resume --last`
`codex exec --json "prompt"`	用 JSONL 输出事件	`codex exec --json "分析这个项目"`
`codex exec -o <FILE> "prompt"`	把最后回复写入文件	`codex exec -o result.md "生成一份摘要"`

exec 适合自动化或一次性检查。交互式写代码、写文章时，还是直接用 codex 更方便。

项目与权限相关命令

Codex 运行命令时会受到沙盒和审批策略影响。这个机制的目标是控制文件写入、网络访问和高风险命令。

命令或选项	用途	示例
`-C <DIR>`	设置主要工作目录	`codex -C D:\blog\blog`
`--add-dir <DIR>`	增加额外可写目录	`codex -C D:\blog\blog --add-dir C:\superpowers\blogpowers`
`-s read-only`	只读沙盒	`codex -s read-only`
`-s workspace-write`	允许写工作区	`codex -s workspace-write`
`-s danger-full-access`	关闭沙盒限制，风险很高	`codex -s danger-full-access`
`-a on-request`	由模型判断何时请求审批	`codex -a on-request`
`-a never`	不请求审批，失败直接返回	`codex -a never`
`--dangerously-bypass-approvals-and-sandbox`	跳过审批和沙盒	`codex --dangerously-bypass-approvals-and-sandbox`

日常使用里，workspace-write 通常够用。danger-full-access 和 --dangerously-bypass-approvals-and-sandbox 不适合作为默认选择，除非你已经在外部环境里做好隔离。

如果任务需要访问两个目录，例如博客目录和本地插件目录，可以用：

1	codex -C D:\blog\blog --add-dir C:\superpowers\blogpowers

这样比临时切目录更清楚。

模型与配置命令

模型、配置 profile、临时配置覆盖，都是启动会话时常见的控制项。

命令或选项	用途	示例
`-m <MODEL>`	指定模型	`codex -m gpt-5.5`
`-p <PROFILE>`	使用配置 profile	`codex -p writing`
`-c key=value`	临时覆盖配置	`codex -c model="gpt-5.5"`
`--enable <FEATURE>`	临时启用功能	`codex --enable some_feature`
`--disable <FEATURE>`	临时关闭功能	`codex --disable some_feature`
`--search`	启用实时网页搜索工具	`codex --search`
`--no-alt-screen`	禁用终端 alternate screen	`codex --no-alt-screen`
`codex features list`	查看功能开关	`codex features list`
`codex features enable <NAME>`	在配置中启用功能	`codex features enable some_feature`
`codex features disable <NAME>`	在配置中关闭功能	`codex features disable some_feature`

-c 的值会按 TOML 解析。简单的模型覆盖可以这样写：

1	codex -c model="gpt-5.5"

如果只是本次会话需要联网查资料，可以临时加：

1	codex --search

如果经常在终端复用滚动历史，--no-alt-screen 很有用：

1	codex --no-alt-screen

登录、更新和补全

这类命令不一定每天用，但配置环境时很常见。

命令	用途	示例
`codex login`	登录 Codex	`codex login`
`codex login status`	查看登录状态	`codex login status`
`codex login --with-api-key`	从标准输入读取 API key 登录	`printenv OPENAI_API_KEY
`codex logout`	删除本地认证信息	`codex logout`
`codex update`	更新 Codex	`codex update`
`codex completion powershell`	生成 PowerShell 补全脚本	`codex completion powershell`
`codex completion zsh`	生成 zsh 补全脚本	`codex completion zsh`

登录状态异常时，先用 codex login status 看清楚当前状态，再决定是否重新登录。

插件入口与管理

插件管理属于 Codex 扩展能力。本文只写入口，不展开具体插件的命令。

命令	用途	示例
`codex plugin --help`	查看插件管理帮助	`codex plugin --help`
`codex plugin marketplace --help`	查看 marketplace 管理帮助	`codex plugin marketplace --help`
`/plugins`	在 Codex 会话中打开插件入口	`/plugins`

如果插件已经写进 ~/.codex/config.toml，但当前会话里看不到，通常需要重启 Codex 会话。插件和技能一般是在会话启动时加载的。

例如本地配置里可能有：

1 2	[plugins."blogpowers@local"] enabled = true

如果重启后仍然不可用，再检查 marketplace 路径、插件目录和 .codex-plugin/plugin.json。

MCP 相关命令

MCP 用来给 Codex 接入外部工具或服务。常用入口如下。

命令	用途	示例
`codex mcp list`	列出 MCP server	`codex mcp list`
`codex mcp get <NAME>`	查看某个 MCP server 配置	`codex mcp get openaiDeveloperDocs`
`codex mcp add ...`	添加 MCP server	`codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp`
`codex mcp remove <NAME>`	删除 MCP server	`codex mcp remove openaiDeveloperDocs`
`codex mcp login <NAME>`	登录某个 MCP server	`codex mcp login example`
`codex mcp logout <NAME>`	退出某个 MCP server	`codex mcp logout example`
`codex mcp-server`	以 MCP server 方式启动 Codex	`codex mcp-server`

MCP 命令适合在需要官方文档、外部系统或自定义工具时使用。普通博客写作不一定需要它。

代码审查与补丁应用

Codex 也可以用非交互式命令做代码审查，或者把最近一次 agent 生成的 diff 应用到本地。

命令	用途	示例
`codex review`	运行代码审查	`codex review`
`codex review --uncommitted`	审查 staged、unstaged 和 untracked 变化	`codex review --uncommitted`
`codex review --base <BRANCH>`	审查相对某个分支的变化	`codex review --base main`
`codex review --commit <SHA>`	审查某个提交	`codex review --commit abc1234`
`codex apply`	应用最近一次 agent 生成的 diff	`codex apply`
`codex a`	`apply` 的别名	`codex a`

review 适合在提交前做一轮风险检查。apply 更适合你明确知道最近一次 diff 是你想要的改动时使用。

沙盒调试和低频命令

有些命令不是日常写博客高频操作，但排查环境时可能用到。

命令	用途	示例
`codex sandbox --help`	查看沙盒命令	`codex sandbox --help`
`codex sandbox windows ...`	在 Windows restricted token 下运行命令	`codex sandbox windows --help`
`codex debug --help`	查看调试工具入口	`codex debug --help`
`codex app`	启动 Codex 桌面 app 或安装器	`codex app`
`codex cloud`	浏览 Codex Cloud 任务，实验功能	`codex cloud`

这些命令建议按需查，不需要背。

常见排错路径

命令不可识别时，先确认当前安装版本暴露了哪些命令：

1	codex --help

子命令不确定时，继续查子命令帮助：

1
2
3

codex mcp --help
codex plugin --help
codex exec --help

插件看不到时，先确认配置，再重启会话：

1	Select-String -Path C:\Users\rust\.codex\config.toml -Pattern "plugins"

认证异常时，查登录状态：

1	codex login status

项目目录不对时，重新用 -C 指定：

1	codex -C D:\blog\blog

需要确认功能开关时：

1	codex features list

这些排错命令不复杂，但能省掉很多猜测。

使用建议

这份速查表不是完整文档，而是日常入口整理。真正应该记住的只有几个模式：

启动项目用：

1	codex -C <project>

继续上下文用：

1	codex resume --last

一次性任务用：

1	codex exec "task"

查命令用：

1	codex <command> --help

管理插件从：

/plugins

开始。

其他低频命令不必强记。遇到具体场景时，再回到这份表里补充即可。