Codex CLI 速查表

Codex CLI v0.118.0 更新于:2026年4月2日
⌨️ 键盘快捷键
常规控制
CtrlC 取消输入/中断
CtrlL 清屏
CtrlG 在编辑器中打开提示
EscEsc 撤销上一操作
浏览提示历史
运行时
Enter / Tab 批准待执行操作
前缀
@ 文件引用 + 自动补全
! 直接 shell 命令
/ 斜杠命令
⚡ 斜杠命令
模型与模式
/model 切换模型
/fast 切换快速模式
/plan 计划模式(只读)
/review 审查变更
/diff 显示变更差异
/permissions 查看/更新权限
/theme 更改颜色主题
会话
/clear 清空对话
/compact 压缩上下文
/copy 复制上次回复
/status 显示会话状态
/fork 分支会话
/resume 恢复会话
/new 新会话
/exit 关闭交互会话
项目与配置
/init 创建 AGENTS.md
/mention 引用文件/上下文
/agent 切换/管理代理
/apps 管理应用
/personality 设置个性
/experimental 切换实验功能
工具与其他
/mcp MCP 服务器管理
/ps 列出运行中的进程
/skills 列出可用技能
/feedback 提交反馈
/logout 注销
🖥️ CLI 参数
基本用法
codex "提示" 以初始提示启动
--model 设置模型
-i <文件> 附加图片文件
目录与配置文件
--cd <目录> 更改工作目录
--add-dir <目录> 添加附加目录
--profile <名称> 使用命名配置
搜索与自动化
--search 启用实时搜索
--full-auto 全自动审批模式
本地与开源
--oss 使用开源模型
--local-provider 使用本地模型
功能控制
--enable <标志> 启用功能标志
--disable <标志> 禁用功能标志
--config key=val 覆盖配置值
会话
-c 继续上次会话
--sandbox 设置沙箱模式
--json JSON 输出格式
🚀 Exec 与脚本
执行模式
codex exec "提示" 非交互执行
codex e "提示" exec 的短别名
--full-auto 跳过所有审批提示
cat f | codex exec 管道输入 + 提示NEW
输出
--json JSON 输出格式
--ephemeral 无会话持久化
-o <文件> 输出到文件
--output-last-message 最终自然语言摘要
会话管理
codex resume 恢复会话(选择器)
codex resume --last 恢复最近的会话
codex resume --all 所有会话(任意目录)
codex fork 分支会话
环境变量
CODEX_API_KEY API 密钥环境变量
🤖 模型与配置
可用模型
gpt-5.4 最强大(推荐)
gpt-5.3-codex 编码优化
gpt-5.4-mini 快速且经济的 mini
gpt-5.3-codex-spark 近乎即时编码(仅 Pro)
配置文件位置
~/.codex/config.toml 用户配置(全局)
.codex/config.toml 项目配置(本地)
配置选项
model 默认模型
approval_policy 审批行为
sandbox_mode 沙箱类型
web_search "cached" | "live" | "disabled"
personality 代理个性
reasoning_effort 思考深度
log_dir 日志目录路径
review_model 审查模型覆盖
tui.theme TUI 颜色主题
🔓 功能与审批
功能标志
codex features list 显示所有标志
codex features enable 持久启用
codex features disable 持久禁用
apps 启用应用
fast_mode 快速响应
multi_agent 多代理
unified_exec 统一执行
undo 撤销操作
审批模式
Auto 工作目录内读写运行
Read-only 仅浏览文件
Full Access 全部访问含网络 ⚠️
沙箱模式
macOS seatbelt 内置沙箱
Linux Landlock 内核级沙箱
codex sandbox 在沙箱下运行命令
🔌 MCP
CLI 命令
codex mcp list 列出 MCP 服务器
codex mcp show 显示服务器详情
codex mcp add 添加 MCP 服务器
codex mcp remove 移除 MCP 服务器
codex mcp login OAuth 登录
codex mcp logout 移除凭证
传输方式
--url 流式 HTTP(推荐)
-- <命令> Stdio 启动命令
服务器模式
codex mcp-server 以 MCP 服务器运行
交互式
/mcp MCP 管理界面
☁️ 云端与代理
云端命令
codex cloud 云任务选择器
codex cloud exec 在云端运行任务
codex cloud list 列出云端任务
--attempts N 最优 N 次运行(1–4)
应用
codex apply 应用云端差异到本地
AGENTS.md
AGENTS.md 项目代理配置文件
/init 创建 AGENTS.md
/agent 切换代理
子代理
Subagents 生成子代理
[agents] config config.toml 中的代理设置
其他命令
codex login 认证(ChatGPT 或 API 密钥)
codex completion Shell 补全(bash/zsh/fish)
codex app 启动桌面应用(macOS)
codex execpolicy 检查执行策略规则