启动命令与全局参数

命令 / 参数

说明

示例

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 命令 - 非交互式执行
# 基本用法
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

自动补全文件路径

更多推荐