CHEATSHEET
Codex CLI 速查表
OpenAI Codex CLI 的斜杠命令、子命令、全局参数、快捷键与 config.toml 常用配置，点击即可复制。
更新于 2026-08-10 · 来源： Codex CLI 参考文档、config.toml 完整参考、Codex 开源仓库
斜杠命令（会话内）
在 Codex 交互式会话的输入框里输入 / 呼出
| 命令 | 说明 | 大白话 | |
|---|---|---|---|
/init | 生成 AGENTS.md 骨架，写入给 Codex 的项目指引 | 让 Codex 先摸底项目，写份说明书 | |
/status | 显示当前会话配置（模型、审批策略、沙箱模式等） | 看看现在用的什么模型、权限松紧 | |
/permissions | 调整审批与沙箱权限边界 | 调审批和沙箱的松紧 | |
/model | 会话中途切换模型与推理强度 | 聊到一半想换个模型或推理档位 | |
/review | 审查当前改动，查找问题 | 让它自己挑挑当前改动的毛病 | |
/agent | 查看或切换 agent 线程 | 看看现在挂的是哪个 agent 线程，或者切一个 | |
/subagents | 查看子代理线程 | 看看有哪些子代理在跑 | |
/diff | 查看当前 Git 改动 | 看看改了啥，还没提交的那些 | |
/copy | 复制最近一次输出到剪贴板（等价于 Ctrl+O） | 复制刚才的输出，跟按 Ctrl+O 一样 | |
/compact | 压缩对话摘要，节省 token | 对话太长了，先压缩一下省 token | |
/rename | 给当前会话改名 | 给这次会话起个好记的名字 | |
/clear | 清空上下文，开始新对话 | 另起一局，上下文清空 | |
/delete | 删除当前会话 | 这次会话不要了，删掉 | |
/archive | 归档当前会话 | 先归档，不占列表但没删 | |
/plugins | 浏览已安装的插件 | 看看都装了哪些插件 | |
/skills | 浏览可用的 skill | 看看有哪些技能包能用 | |
/hooks | 浏览已配置的生命周期 hook | 看看配了哪些自动触发的脚本 | |
/memories | 配置记忆（memories）相关设置 | 管理它记住的那些东西 | |
/feedback | 向 Codex 团队反馈问题 | 有意见？直接反馈给 Codex 团队 | |
/logout | 退出登录 | 退出当前账号 |
CLI 子命令
在终端里以 `codex <subcommand>` 的形式调用
| 命令 | 说明 | 大白话 | |
|---|---|---|---|
codex | 启动交互式终端 UI | 不带参数直接敲，进交互式界面 | |
codex resume | 重新打开当前仓库最近的一次会话 | 接着上次在这个仓库聊的往下继续 | |
codex fork | 从之前的会话分支出一个新会话 | 从某次历史会话分个岔，开个新的 | |
codex archive | 归档一个会话 | 把某个会话归个档 | |
codex unarchive | 恢复一个已归档的会话 | 把归档的会话拿回来 | |
codex delete | 永久删除一个会话 | 彻底删掉一个会话，不可恢复 | |
codex exec | 非交互式运行 Codex（脚本、CI 场景），别名 codex e | 跑脚本/CI 用，不进交互界面，一次性跑完拿结果 | |
codex review | 分析代码改动，提交前本地代码审查 | 提交代码前，先让它本地过一遍 | |
codex apply | 应用云端会话生成的 diff，别名 codex a | 把云端会话生成的改动落到本地 | |
codex login | 登录 Codex 账户 | 登录账号 | |
codex logout | 退出登录 | 退出当前账号 | |
codex doctor | 生成诊断报告，排查安装与配置问题 | 环境不对劲？先跑这个查体检报告 | |
codex update | 检查 CLI 是否有更新 | 看看 CLI 有没有新版本 | |
codex features | 管理 feature flag | 开关一些实验性功能 | |
codex mcp | 管理 MCP 服务器连接，接入外部工具 | 接外部工具，比如数据库、Jira 这些 | |
codex plugin | 安装或移除插件 | 装/卸插件 | |
codex sandbox | 在沙箱环境中运行指定命令 | 不放心某条命令，先丢沙箱里跑跑看 | |
codex app-server | 启动开发用的 app-server | 本地起个开发用的后端服务 | |
codex cloud | 把当前工作转移到 Codex 云端环境执行 | 本地跑不动，或想解放终端，丢到云上跑 |
全局 Flag
可加在 `codex` 及大多数子命令后面
| 命令 | 说明 | 大白话 | |
|---|---|---|---|
--model | 覆盖配置文件里的模型选择，短写 -m | 临时换个模型，不用改配置文件 | |
--sandbox | 设置沙箱策略：read-only / workspace-write / danger-full-access，短写 -s | 定这次跑代码的权限有多大 | |
--ask-for-approval | 控制审批提示：untrusted / on-request / never，短写 -a | 定哪些操作要先问过你 | |
--cd | 设置工作目录，短写 -C | 跑之前先切到指定目录 | |
--config | 以 key=value 形式覆盖某项配置，短写 -c | 临时改一项配置，不用去改文件 | |
--image | 把图片作为视觉上下文附加进 prompt，短写 -i | 带张图给它看，当上下文用 | |
--profile | 叠加一份额外的 profile 配置文件，短写 -p | 叠加一套预设配置，快速切场景 | |
--search | 需要时切换到联网搜索 | 这次需要联网查资料 | |
--remote | 连接远程 app-server | 连到别处已经跑着的 app-server | |
--oss | 使用本地开源模型 provider | 用本地的开源模型，不走 OpenAI |
快捷键
| 命令 | 说明 | 大白话 | |
|---|---|---|---|
@ | 搜索并插入文件路径 | 打 @ 搜文件路径，不用手敲全名 | |
Ctrl+R | 搜索 prompt 历史 | 翻一翻以前敲过的 prompt | |
Tab | 把当前输入排进下一轮执行队列 | 先别执行，排到下一轮队列里 | |
Enter | Codex 执行中按下，把新指令注入当前这一轮 | 它还在跑，你又想起一句要补充的，直接敲回车插进去 | |
Esc Esc | 输入框为空时连按两下，编辑并从上一条消息重新分叉 | 手滑了？连按两下 Esc，回去改上一条重发 | |
/exit | 关闭当前会话，等价于 Ctrl+C | 结束这次会话，跟 Ctrl+C 一个效果 | |
! | 前缀 + 命令，直接运行本地 shell 命令 | 前面加个感叹号，直接跑本地命令 |
config.toml 常用键
默认路径 ~/.codex/config.toml，项目内可用 .codex/config.toml 覆盖部分项
| 命令 | 说明 | 大白话 | |
|---|---|---|---|
model = "gpt-5.5" | 指定默认使用的模型 | 写死默认用哪个模型，不用每次敲 --model | |
model_provider = "openai" | 选择模型 provider | 换个模型供应商 | |
model_reasoning_effort = "medium" | 推理强度：minimal / low / medium / high / xhigh | 定默认的推理力度，简单活儿调低省钱 | |
approval_policy = "on-request" | 审批策略：untrusted / on-request / never | 定默认多爱问你，untrusted 最谨慎、never 最放权 | |
sandbox_mode = "workspace-write" | 沙箱模式：read-only / workspace-write / danger-full-access | 定默认的沙箱松紧 | |
sandbox_workspace_write.network_access = true | 允许沙箱内的进程联网 | 沙箱模式默认不让联网，这里开个口子 | |
default_permissions = ":workspace" | 使用内置命名权限档案：:read-only / :workspace / :danger-full-access | 省事写法，直接套一档现成的权限组合 | |
[mcp_servers.<id>] | 注册一个 MCP 服务器（command / args / enabled 等） | 在配置文件里常驻一个 MCP 服务器，不用每次手动连 | |
[model_providers.<id>] | 自定义模型 provider（base_url / env_key 等） | 接一个非官方或自建的模型服务 | |
history.persistence = "save-all" | 会话历史落盘策略：save-all / none | 定会话记录要不要存盘 | |
web_search = "live" | 联网搜索模式：disabled / cached / indexed / live | 定默认的联网搜索行为 | |
[tui]
theme = "..." | 终端 UI 主题与外观设置 | 换个终端界面主题 | |
notification_method = "auto" | 通知方式：auto / osc9 / bel | 任务跑完了怎么通知你 | |
personality = "pragmatic" | 回复风格：none / friendly / pragmatic | 定它说话的风格，专业还是随和 | |
agents.max_concurrent_threads_per_session = 4 | 单会话内子代理最大并发数 | 一个会话里最多同时开几个子代理 | |
[[hooks.PreToolUse]] | 注册生命周期 hook：工具调用前触发 | 工具调用前先跑个自己的脚本，比如做校验 | |
[projects."/path/to/project"]
trust_level = "trusted" | 按项目路径设置信任级别，影响是否加载项目内配置 | 给某个项目路径单独定信任级别 |