Codex CLI · 常用命令
v0.141.0GitHub
适用场景
快速查启动参数、审批模式、slash 命令、自动化脚本写法
面向读者
已装好 Codex CLI,想熟悉日常用法的开发者
TL;DR
codex 启动 → /help 查命令 → --approval-mode full-auto 全自动 → -q 非交互脚本
启动方式
命令
效果
codex进入交互式对话(最常用)
codex "帮我写一个 README"带初始 prompt 启动,直接进入对话
codex -q "帮我写一个 README"非交互模式,结果输出到 stdout,适合脚本
codex --approval-mode full-auto全自动模式,免确认执行所有操作(含 shell)
审批模式(--approval-mode)
Codex 用审批模式控制 AI 的执行权限,共三档:
模式
行为
suggest(默认)Codex 仅建议,每步需你手动确认并应用
auto-edit自动写文件,但 shell 命令仍需确认
full-auto自动写文件 + 自动执行 shell,无需任何确认
# 启动时指定模式
codex --approval-mode full-auto
codex --approval-mode auto-edit
# 也可以在 ~/.codex/config.toml 里固定
# approval_mode = "auto-edit"常用启动参数
命令
说明
--approval-mode <mode>设置审批模式:suggest / auto-edit / full-auto
--model <model-id>指定模型,如 gpt-5.5、gpt-5.4、gpt-5.4-mini
-q / --quiet非交互模式,结果输出 stdout
--notify任务完成后发送桌面通知
--no-project-doc跳过 AGENTS.md 上下文注入
--no-git-context跳过 git diff / log 上下文注入
--dangerously-auto-approve-everything跳过所有确认(等同 full-auto + 无沙箱)
--config显示当前 config.toml 文件路径
--version查看版本号
--help查看所有参数
会话内 Slash 命令
进入交互界面后,以 / 开头输入以下命令:
Slash 命令
说明
/help查看所有可用命令
/exit退出 Codex
/clear清空当前对话,重新开始
/history查看本次会话历史
/log打开日志文件
/model <model-id>切换模型(无需重启)
/approval <mode>切换审批模式(无需重启)
非交互模式(脚本场景)
# 一次性执行,结果输出到终端
codex -q "用中文总结一下这个 PR 的改动"
# 全自动 + 非交互,适合 CI
codex -q --approval-mode full-auto \
"检查 src/api.ts 里有没有 SQL 注入漏洞,输出 Markdown 报告"
# 把结果传给其他命令
codex -q "生成 .gitignore for Node.js 项目" > .gitignore指定模型
# 启动时指定
codex --model gpt-5.5
# 在 ~/.codex/config.toml 里固定
# model = "gpt-5.5"当前可用模型:
模型
特点
gpt-5.5当前主力,代码能力最强;有效上下文约 272K(见下方说明)
gpt-5.4上一代主力,稳定性高;支持 1M 上下文
gpt-5.4-mini轻量版,速度快、成本低,适合简单任务
AGENTS.md(上下文文件)
Codex 读取项目根目录的 AGENTS.md 作为持久上下文(类似 Claude Code 的 CLAUDE.md):
# 初始化一个 AGENTS.md 模板
codex "请为这个项目生成一份 AGENTS.md,概述技术栈和代码规范"AGENTS.md 支持嵌套:子目录里的 AGENTS.md 会被当前目录的覆盖。