常用命令与斜杠命令速查
本文按当前公开源码整理常用入口，重点覆盖日常会反复用到的命令。选项会随版本变化，遇到不一致时以 codex --help 与 codex <子命令> --help 的输出为准。
常用子命令
| 命令 | 作用 |
|---|---|
codex | 启动交互式 TUI |
codex "提示词" | 带着初始提示进入交互式会话 |
codex exec "提示词" | 非交互执行一次任务，结果打印到终端 |
codex review | 非交互地审查当前改动 |
codex resume | 恢复历史会话；--last 直接继续最近一次 |
codex fork | 从历史会话分叉出新会话 |
codex apply | 把 Codex 生成的最新 diff 应用到工作区 |
codex login / codex logout | 登录或清除本机凭据 |
codex mcp | 管理 MCP 服务器；codex mcp login <名称> 处理登录 |
codex plugin | 管理插件 |
codex sandbox | 在 Codex 提供的沙箱中运行命令 |
codex doctor | 诊断安装、配置、认证与运行环境 |
codex update | 更新到最新版本 |
codex completion <shell> | 生成 shell 补全脚本 |
codex agents | 打开智能体命令中心，浏览与切换会话 |
codex queue | 给已有会话排队一条消息 |
codex archive / codex unarchive / codex delete | 归档、取消归档、永久删除会话 |
codex cloud | 浏览云端任务并在本地应用改动（实验性） |
codex features | 查看功能开关 |
交互式会话常用选项
| 选项 | 作用 |
|---|---|
-m, --model <模型> | 指定模型 |
-s, --sandbox <模式> | read-only、workspace-write、danger-full-access |
-a, --ask-for-approval <策略> | on-request 或 never（交互式入口） |
-C, --cd <目录> | 指定工作根目录 |
--add-dir <目录> | 追加可写目录，可重复 |
-i, --image <文件> | 附加图片到初始提示 |
--search | 启用原生 Responses 联网搜索工具（无逐次审批） |
-p, --profile <名称> | 叠加 $CODEX_HOME/<名称>.config.toml |
-c <键=值> | 临时覆盖配置，可重复 |
--approve-for-me | 以 workspace-write 运行，审批走自动复核 |
--dangerously-bypass-approvals-and-sandbox | 同时跳过审批与沙箱，风险极高 |
--no-alt-screen | 使用内联模式，保留终端滚动历史 |
--no-daemon | 不经过共享后台服务 |
--strict-config | 遇到未知配置键直接报错 |
--worktree | 在新的托管 Git worktree 中运行 |
codex exec 常用选项
codex exec 适合脚本、CI 和一次性任务。它不会进入 TUI，默认把过程与结果打印出来。
| 选项 | 作用 |
|---|---|
--json | 以 JSONL 输出事件，便于程序解析 |
-o, --output-last-message <文件> | 把最后一条消息写入文件 |
--output-schema <文件> | 用 JSON Schema 约束最终输出结构 |
--skip-git-repo-check | 允许在非 Git 仓库中运行 |
--ephemeral | 不把会话文件持久化到磁盘 |
--ignore-user-config | 不加载用户 config.toml，认证仍使用 CODEX_HOME |
--ignore-rules | 不加载用户与项目的执行策略 .rules 文件 |
--color <模式> | 控制输出颜色 |
示例：
codex exec --json -o /tmp/last.txt "列出所有失败的测试并给出修复建议"
codex exec --skip-git-repo-check "解释这个目录里的构建脚本"注意：-a 是交互式入口的选项；在 codex exec 中调整审批策略，请用 -c approval_policy="..."。
斜杠命令
在交互式 TUI 的输入框中输入 / 会打开命令列表。以下为当前源码中可见的常用项，实际顺序与可用性可能随版本或功能开关变化。
| 命令 | 作用 |
|---|---|
/model | 选择模型与推理强度 |
/permissions | 选择 Codex 被允许执行的操作 |
/plan | 切换到 Plan 模式 |
/review | 审查当前改动并查找问题 |
/init | 生成一个 AGENTS.md |
/compact | 压缩对话，避免触及上下文上限 |
/new | 在会话中开始一个新对话 |
/resume | 恢复已保存的会话 |
/fork | 分叉当前对话 |
/worktree | 在新的 worktree 中开始或继续对话 |
/diff | 显示 git diff（含未跟踪文件） |
/mention | 引用一个文件 |
/status | 查看当前会话配置与 token 用量 |
/mcp | 列出 MCP 工具；/mcp verbose 或 /mcp login <名称> |
/skills | 查看并使用技能 |
/hooks | 查看与管理生命周期钩子 |
/memories | 配置记忆的使用与生成 |
/agents | 打开智能体命令中心 |
/subagents | 在本会话的子智能体之间切换 |
/plugins | 浏览插件 |
/apps | 管理应用 |
/usage | 查看账号用量或重置用量限制 |
/config | 调整 Codex 偏好 |
/theme | 选择语法高亮主题 |
/vim | 切换输入框的 Vim 模式 |
/ps | 列出后台终端 |
/stop | 停止所有后台终端 |
/cd / /pwd | 切换或显示当前工作目录 |
/export | 把对话导出为 Markdown |
/copy | 复制最后一条回复或其一部分 |
/logout | 退出登录 |
/quit | 退出 Codex |
组合示例
# 只读调查，不写文件
codex -s read-only -a on-request "梳理这个仓库的请求处理链路"
# 日常开发，追加一个共享目录
codex -s workspace-write --add-dir ../shared "实现缓存层并补测试"
# 在 CI 中非交互运行，输出 JSONL 与最后一条消息
codex exec --json -o result.txt --skip-git-repo-check "运行测试并总结失败原因"