Codex 终端常用命令与使用场景
一、Codex 是什么？
二、安装 Codex CLI
三、更新 Codex CLI
四、Codex 常用终端命令
codex
作用
启动 Codex 交互式终端界面。
代码块
Plain Text
cd your_project
codex
官方文档说明，运行 codex 会启动一个全屏终端 UI，Codex 可以读取仓库、修改文件、运行命令，并允许你实时审查它的行为。
使用场景
🔔
适合日常开发中直接进入项目，让 Codex 帮你理解或修改代码。
🔔
例如：
•
帮我分析这个 Flutter 项目的目录结构
•
帮我找一下登录页面的入口和状态管理逻辑
•
帮我检查这个页面是否存在 build 方法过重的问题
这是最基础、最常用的方式。
codex “你的问题”
作用
启动 Codex，并直接带上初始 prompt。
代码块
Plain Text
codex "Explain this codebase to me"
官方文档给出的示例就是通过命令行附带初始问题来启动 Codex。
使用场景
当你已经知道要问什么时，可以一行命令直接启动。
代码块
Plain Text
codex "帮我分析这个项目的架构，并指出核心模块"
适合快速进入一个明确任务。
codex exec
作用
以非交互方式执行一次 Codex 任务，适合脚本、CI、自动化流程。
代码块
Plain Text
codex exec "帮我检查当前 diff 中是否存在明显问题"
官方功能页说明，Codex 支持通过 exec 命令来脚本化自动化流程。
使用场景
非常适合自动化 Code Review、CI 检查、批量分析等。
例如：
代码块
Plain Text
git diff | codex exec "请基于当前 diff 做代码审查，只指出新增代码中的问题"
也可以用于生成 MR 描述：
代码块
Plain Text
git diff --stat | codex exec "根据这些变更生成一份简洁的 MR 描述"
如果你想把 Codex 接入 CNB、Jenkins、GitHub Actions、GitLab CI，codex exec 会比交互式 codex 更合适。
codex resume
作用
恢复之前的 Codex 会话。
代码块
Plain Text
codex resume
官方文档说明，Codex 会把会话记录保存在本地，可以通过 codex resume 重新打开之前的会话，避免重复输入上下文。
使用场景
🔔
适合长期任务，比如：
•
一个复杂重构做了几天
执行命令后选择最近的会话继续即可。
codex resume --last
作用
直接恢复当前目录最近一次会话。
代码块
Plain Text
codex resume --last
官方文档说明，codex resume --last 可以跳过选择器，直接恢复当前工作目录最近的会话。
使用场景
•
比如你昨天让 Codex 分析过 Flutter 页面重构，今天继续使用该命令，进入后继续下达任务即可。
codex resume --all
作用
显示所有目录下的历史会话。
代码块
Plain Text
codex resume --all
官方文档说明，–all 可以显示当前工作目录之外的会话。
使用场景
🔔
适合你在多个项目中都使用 Codex，想找回某个历史任务，执行命令后选择对应项目会话即可。
codex exec resume --last
作用
以非交互方式恢复最近会话，并继续执行任务。
代码块
Plain Text
codex exec resume --last "继续修复你上次发现的问题"
官方文档给出的示例包括 codex exec resume --last “Fix the race conditions you found”，说明非交互自动化任务也可以恢复上下文。
使用场景
•
适合自动化连续任务。
codex --cd
作用
指定 Codex 的工作目录。
代码块
Plain Text
codex --cd /path/to/project
官方 CLI 参考说明，–cd 或 -C 可以在 Codex 开始处理请求前设置工作目录。
使用场景
•
适合在脚本中明确指定项目路径，无需提前切换文件夹。
codex --add-dir
作用
给 Codex 额外目录访问权限。
代码块
Plain Text
codex --add-dir ../shared_package
官方 CLI 参考说明，–add-dir 可以给主工作区之外的目录授予额外写访问权限，并且可以重复使用。
使用场景
•
适合多仓库或本地依赖场景，可同时让 Codex 读取主项目与本地依赖库代码。
codex --model
作用
指定本次使用的模型。
代码块
Plain Text
官方 CLI 参考说明，–model 或 -m 可以覆盖配置中的模型。
使用场景
复杂任务使用更强模型，简单任务使用更快模型，按需搭配使用。
codex --profile
作用
加载指定配置 profile。
代码块
Plain Text
codex --profile work
官方 CLI 参考说明，–profile 或 -p 可以从 ~/.codex/config.toml 中加载指定配置 profile。
使用场景
•
适合区分不同项目或不同使用模式，适配团队统一开发规范。
codex -c key=value
作用
临时覆盖配置项。
代码块
Plain Text
codex -c model="gpt-5.5"
官方 CLI 参考说明，Codex CLI 默认继承 ~/.codex/config.toml，命令行中的 -c key=value 会覆盖本次调用的配置。
使用场景
•
适合临时修改某些参数，不想改动全局配置文件。
codex --ask-for-approval
作用
控制 Codex 运行命令前是否需要人工审批。
代码块
Plain Text
codex --ask-for-approval on-request
官方 CLI 参考说明，–ask-for-approval 或 -a 支持 untrusted、on-request、never 等值，用于控制 Codex 何时暂停并请求人工批准。
使用场景
•
日常开发建议开启审批模式，自动化只读场景可按需关闭审批。
codex --dangerously-bypass-approvals-and-sandbox
作用
跳过审批和沙箱限制。
代码块
Plain Text
codex --dangerously-bypass-approvals-and-sandbox
官方文档明确说明，该选项会在没有审批和沙箱的情况下运行每个命令，只应在外部已经加固的环境中使用。
使用场景
•
仅适用于容器、虚拟机、临时测试环境，严禁在正式业务项目使用。
codex --image
作用
把图片作为初始 prompt 附件传给 Codex。
代码块
Plain Text
codex --image screenshot.png "根据这个截图帮我分析 UI 问题"
官方 CLI 参考说明，–image 或 -i 可以把一个或多个图片文件附加到初始 prompt 中，多个路径可以用逗号分隔，也可以重复传入。
使用场景
适合前端、Flutter、UI 还原、Bug 截图分析等场景。
codex --oss
作用
使用本地开源模型提供方。
代码块
Plain Text
codex --oss
官方 CLI 参考说明，–oss 等价于设置 model_provider=“oss”，并会校验 Ollama 是否正在运行。
使用场景
适合本地模型测试、离线实验、低成本代码调试。
codex app-server
作用
启动 Codex 远程 app server。
代码块
Plain Text
codex app-server --listen ws://127.0.0.1:4500
官方功能页说明，可以在拥有代码、凭证和执行环境的机器上启动 app server，然后从另一台机器连接 Codex TUI。
使用场景
•
适合远程开发机、云端打包机远程操控开发。
五、Codex 会话内常用操作
进入 codex 交互界面后，可以像聊天一样输入自然语言，也可以使用一些快捷操作。
输入普通任务
🔔
直接输入开发相关需求即可，适配日常各类开发调试场景。
使用 /model
🔔
作用
切换模型或调整模型相关配置。
官方文档说明，Codex CLI 支持通过 /model 在不同模型之间切换，适配架构设计、代码重构、安全审查等高难度开发工作。
/clear
🔔
作用
清空当前对话，开始新任务。
也可以按 Ctrl + L 只清屏但不开始新对话，适合快速切换开发需求。
/copy
🔔
作用
复制最近一次 Codex 输出。
快捷键 Ctrl + O 也可快速复制，适合复制审查报告、优化方案、开发文档等内容。
/exit
🔔
作用
退出当前 Codex 会话。
也可使用 Ctrl + C 快速关闭交互式会话。
Tab 追加后续任务
🔔
Codex 正在运行任务时，按下 Tab 可提前输入后续需求，排队等待执行，高效完成连续开发任务。
Ctrl + R 搜索历史 prompt
🔔
在输入框中按 Ctrl + R 快速检索过往输入的指令，复用常用审查、开发提示词。
六、典型使用场景
场景 1：快速理解项目
代码块
Plain Text
cd my_flutter_project
codex "帮我分析这个 Flutter 项目的整体架构、主要模块和状态管理方案"
场景 2：查找业务入口
🔔
场景 3：基于 Git Diff 做 Code Review
代码块
Plain Text
git diff | codex exec "请基于当前 diff 做代码审查，只审查新增代码，按 blocker、critical、major、minor、suggestion 分类输出"
场景 4：生成 MR 描述
🔔
借助 git 提交记录快速生成规范简洁的合并请求说明。
场景 5：生成周报
🔔
抓取周期内代码提交记录，自动整理分类生成工作周报。
场景 6：分析构建失败日志
🔔
读取打包、编译报错日志，自动定位问题根源并给出修复方案。
场景 7：辅助 Flutter 重构
🔔
优先让 AI 输出重构方案，确认无误后再执行代码修改，规避线上风险。
场景 8：根据截图分析 UI 问题
🔔
搭配图片指令，快速定位页面样式错乱、布局异常等前端问题。
场景 9：接入自动化 Code Review
🔔
在 CI 流水线中配置指令，固定 JSON 格式输出审查结果，对接各类自动化运维平台。
七、Flutter 项目推荐 Prompt
可自定义规范审查话术，限定代码编写规范、资源使用规则、代码行数限制等，统一团队 Flutter 开发代码风格，搭配执行命令批量审查项目代码。
八、Codex 安全使用建议
•
禁止在正式项目中关闭审批与沙箱限制，规避代码误改、高危命令执行风险
•
严格隔离 .env、密钥、证书、生产配置等敏感文件，限制 Codex 访问权限
•
自动化流水线优先配置只读审查模式，区分代码检查与代码修改权限
•
大型项目重构分步执行，先出方案核验，再分模块迭代修改
九、Codex 与 Claude Code 的区别简单对比
团队依托 OpenAI 生态优先选用 Codex，深耕 Claude 技术体系则适配 Claude Code。
十、常用命令速查表
十一、推荐工作流
•
首次接入项目：进入项目目录启动交互终端，让AI通读项目整体结构，录入项目专属开发规范
•
日常开发：直接启动交互模式，完成页面开发、逻辑优化、代码纠错等日常需求
•
代码提交前：执行diff代码审查，结合原生编译检测双重校验代码质量
•
流水线自动化：配置非交互审查指令，接入CI流程，自动拦截不合规代码合并
十二、总结
Codex CLI 核心价值并非单纯问答交互，而是深度融入全流程开发体系。
🔔
日常开发使用交互式指令，批量自动化任务使用 codex exec，跨场景开发借助会话恢复功能衔接工作内容，搭配目录指定、图片解析、模型切换等能力，可完美适配 Flutter 开发、代码自动化审核、云端运维流水线等各类开发场景，将其打造为团队专属自动化代码助手。