CLI 基础用法

11.1 基本语法

最基础的一次性执行:

codex "写一个下载文件的 Python 脚本"

Codex 会直接生成代码,3 秒出结果,0 句废话(来自编程指北实测)。

11.2 交互式 REPL 模式

直接输入 codex 回车,进入交互模式:

codex

进入后会出现 >> 提示符,可以连续对话:

>> 把上面的脚本改成并发
>> 加上进度条
>> 保存到 download.py

交互模式特性:

• Tab 补全:像 zsh 一样的补全体验
• Ctrl-R 搜索历史:搜历史命令
• 上下方向键:翻阅历史

11.3 常用参数全解

参数	作用	示例
--sandbox / -s	指定沙箱模式	codex -s workspace-write "..."
--ask-for-approval / -a	指定审批策略	codex -a on-request "..."
--model	指定模型	codex --model gpt-5-codex "..."
-i	图片输入(多模态)	codex -i error.png "修掉图中报错"
--profile	切换 Profile	codex --profile work "..."
--verbose / -v	详细输出	codex -v "..."
--auto	自动批准(慎用)	codex --auto "..."
--help	帮助	codex --help

多模态输入(读截图报错)

# 把终端报错截图给它,省掉手打错误信息
codex -i error.png "修掉图中的报错"

这是 Codex 的杀手级功能之一——能读终端截图。

11.4 codex exec:非交互执行(适合 CI)

codex exec 用于非交互式场景,执行完就退出,特别适合 CI/CD 流水线:

# 跑通 pytest,自动 pip install → 跑测试 → 回退失败的 commit
codex exec "跑通 pytest"

编程指北实测:它会自动装依赖、跑测试、回退失败 commit,CI 即视感。

11.5 codex apply:应用补丁

codex apply 用于把一个补丁应用到代码,适合“我有一份 diff,让它落地”的场景。

11.6 codex resume:恢复会话

codex resume

恢复之前保存的会话,继续上下文。配合 /export 和 /load 可以持久化(见第 20 章)。

11.7 整仓重构工作流

这是 Codex 最强大的场景之一。来自编程指北的实战示例:

# 给整个 Go 项目加 ctx 传值
codex "给整个 Go 项目加 ctx 传值"

工作流:

1. Codex 先出计划(列出要改哪些文件、怎么改)
2. 让你批每一块 diff(逐个确认或拒绝)
3. 再批量应用

这个过程有“安全感 +1”——你始终在掌控,不会一下子改一大片。

11.8 常用 10 行命令清单

来自编程指北整理的“10 行命令带你飞”:

场景	输入	体感
1. 直接下指令	codex "写一个下载文件的 Python 脚本"	3 秒出代码,0 句废话
2. 交互模式	codex 回车 → >> 把上面的脚本改成并发	Tab 补全、Ctrl-R 搜历史,手感像 zsh
3. 图片报错	codex -i error.png "修掉图中的报错"	能读终端截图,省掉手打错误信息
4. 整仓重构	codex "给整个 Go 项目加 ctx 传值"	先出计划 → 批 diff → 批量应用
5. 一键运行	codex exec "跑通 pytest"	自动 pip install → 跑测试 → 回退失败 commit

11.9 默认权限与 –auto

默认是 ask 权限,不会动你文件。先让它出方案,再 codex --auto 批量执行。

# 先只读探路
codex -s read-only "分析这个项目结构,给出重构建议"

# 确认方案后,自动执行
codex --auto "按上面的建议重构"

资料来源

• 编程指北 csguide.cn——10 行命令带你飞、整仓重构工作流
• CSDN《Codex 完整指南(四)》——CLI 命令体系(exec/apply/resume 等)
• 头条《Codex CLI 命令参数与用法详解》——-s -a 参数说明
• FastGPTPlus——多模态输入 -i error.png