Codex CLI 速查表 — 完整参考

⌨️ 键盘快捷键

常规控制

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 <文件> 附加图片文件

目录与配置文件

--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 检查执行策略规则