Codex 命令大全
启动命令与全局参数
| 命令 / 参数 |
说明 |
示例 |
codex |
启动交互式对话界面（默认） |
codex |
codex "提示词" |
带初始提示词直接启动 |
codex "帮我优化代码" |
-m / --model |
指定使用的模型 |
-m gpt-5 |
-a / --approval-mode |
设置审批模式 |
-a auto-edit |
-q / --quiet |
静默模式（减少输出） |
-q |
--profile |
使用指定配置 profile |
--profile local |
--no-project-doc |
不读取 AGENTS.md 等项目文档 |
--no-project-doc |
--full-auto |
全自动模式快捷参数 |
codex --full-auto |
-i / --image |
附加图片上下文 |
-i error.png |
--version |
查看当前版本 |
codex --version |
--help |
查看帮助信息 |
codex --help |
交互界面内置命令（斜杠命令）
在 Codex CLI 的交互界面中，你可以使用以下 / 开头的命令：
| 命令 / 参数 |
说明 |
示例 |
/help |
查看所有可用命令列表 |
/help |
/model |
切换当前使用的模型 |
/model gpt-5 |
/approvals |
切换审批模式 |
/approvals |
/clear |
清空当前对话上下文 |
/clear |
/exit 或 /quit |
退出 Codex CLI |
/exit |
/export |
导出当前会话为 JSON 文件 |
/export session.json |
/load |
加载之前保存的会话 |
/load session.json |
/history |
查看对话历史 |
/history |
/undo |
撤销上一次文件修改 |
/undo |
/diff |
查看待确认的文件变更差异 |
/diff |
/status |
查看当前配置状态和账号信息 |
/status |
子命令（exec、apply、resume）
exec 命令 - 非交互式执行
exec 命令让 Codex 在无需交互的情况下执行单次任务，适合脚本和 CI/CD：
# 基本用法
codex exec "更新所有依赖并运行测试"
# 全自动模式（适合自动化流程）
codex exec --full-auto "修复所有 lint 错误"
# 静默模式运行
codex exec -q "生成 API 文档"
# 指定工作目录
codex exec --cwd /path/to/project "重构 utils 目录"
# 在 GitHub Actions 中使用
# - name: Auto-fix lint
# run: |
# npm install -g @openai/codex
# codex exec --full-auto "fix all eslint errors"
apply 命令 - 应用差异
# 将 Codex 生成的最新差异应用到本地
codex apply
# 别名
codex a
resume 命令 - 恢复会话
# 从会话选择器中恢复之前的会话
codex resume
# 直接恢复最近一次会话
codex resume --last
# 从指定文件恢复
codex resume --file session.json
常用快捷键
| 快捷键 |
功能 |
Enter |
发送消息 |
Shift + Enter |
在输入框中换行（多行输入） |
Ctrl + C |
取消当前操作 |
Ctrl + L |
清屏 |
↑ / ↓ |
浏览历史输入记录 |
Shift + 拖拽文件 |
将文件路径附加到输入框 |
Cmd/Ctrl + V |
粘贴图片（macOS 支持） |
Tab |
自动补全文件路径 |
