直接答案
围绕日常工作流整理命令,而不是罗列全部参数;所有可用项仍应以本机 codex --help 为准。
这篇内容解决什么问题
查询 Codex CLI 常用命令、参数和会话恢复方法
从本机帮助发现真实能力
Codex CLI 更新较快,文章无法替代当前二进制的帮助文本。先用顶层帮助确认子命令,再对具体子命令运行 --help。
严格配置模式适合发现已经失效或拼错的配置字段,但应先在非生产工作区验证升级影响。
codex --version
codex --help
codex exec --help
codex review --help
codex mcp --help
codex features list启动交互会话并限定上下文
不带子命令运行 codex 会进入交互界面。-C 指定工作根目录,-m 临时选择模型,-i 附加图片;这些参数只服务当前调用。
额外可写目录必须显式通过 --add-dir 提供,不要为了访问一个邻接目录扩大整个沙箱。
codex -C /path/to/repo
codex -C /path/to/repo -m gpt-5.6-sol "解释当前测试失败,不要修改文件。"
codex -C /path/to/repo -i /path/to/screenshot.png "定位截图中的界面回归。"恢复、分叉与管理会话
resume 继续已有会话并保留上下文,fork 从历史会话创建新的工作方向。两者都支持 --last 快速选择最近会话;不带参数时使用选择器更稳妥。
恢复前仍要检查当前仓库和分支,历史上下文不会替你保证工作树与上次完全相同。
codex resume
codex resume --last
codex fork --last
codex archive --help
codex unarchive --help用参数做一次性覆盖
-c 接受 TOML 值,可以覆盖 config.toml 的顶层或嵌套字段。一次性覆盖适合验证假设,确认有效后再决定是否写入持久配置。
沙箱与审批有专用参数,优先使用 -s 与 -a,命令意图比通用 -c 更清晰。
codex -m gpt-5.6-sol -s read-only -a untrusted
codex -c model_reasoning_effort=high "分析这个失败测试的根因。"
codex --enable goals
codex --disable goals脚本使用 exec,差异审查使用 review
codex exec 面向非交互调用,可以从参数或标准输入读取任务。codex review 面向当前仓库差异,能够审查未提交内容、相对某个基线分支的变化或单个提交。
自动化时必须检查退出码,并把 JSONL 事件与最终文本分开保存;不要通过搜索自然语言“成功”判断任务状态。
codex exec -C /path/to/repo "运行相关测试并解释失败,不要修改文件。"
codex review --uncommitted
codex review --base main
codex review --commit "$(git rev-parse HEAD)"补全、升级与诊断
completion 根据 shell 生成补全脚本;具体加载方式由 shell 决定。update 用于升级支持自更新的安装,若由包管理器托管,应保持同一升级渠道。
doctor 会检查安装、配置、认证与运行环境。分享报告前仍应自行检查内容,避免把路径或组织信息发送到公开工单。
codex completion zsh > /tmp/_codex
codex update
codex doctor --summary
codex doctor --json > /tmp/codex-doctor.json官方来源与核验范围
本文以公开官方文档为事实依据;命令和配置可能随客户端版本变化,执行前请同时核对对应来源。
查看技术核验方法