Codex 终端常用命令与使用场景小结

一、Codex 是什么？

Codex CLI 是 OpenAI 推出的终端编程智能体，可以在本地终端中读取代码仓库、修改文件、运行命令，并和开发者一起完成代码理解、Bug 修复、重构、测试、Code Review 等任务。官方文档说明，Codex CLI 运行在本地终端中，可以在选定目录内读代码、改代码、执行命令，并且是开源项目，底层用 Rust 构建。

简单来说，它和 Claude Code 类似，都是“终端里的 AI 程序员”，但 Codex 更适合和 OpenAI 生态、ChatGPT 账号、Codex Cloud、MCP、自动化脚本等一起使用。

二、安装 Codex CLI

Codex CLI 支持 npm 和 Homebrew 安装。官方文档给出的 npm 安装方式是：

npm i -g @openai/codex

如果你是 macOS 用户，也可以用 Homebrew：

brew install --cask codex

GitHub 仓库 README 也列出了这两种安装方式。

安装完成后，在终端执行：

codex

首次运行时会提示登录，可以使用 ChatGPT 账号或 API Key。官方文档说明，ChatGPT Plus、Pro、Business、Edu、Enterprise 计划包含 Codex 使用入口，首次运行 codex 时会提示认证。

三、更新 Codex CLI

如果你是 npm 安装，可以使用：

npm i -g @openai/codex@latest

官方文档说明 Codex CLI 会定期发布新版本，npm 安装方式可以通过安装 latest 版本来升级。

如果是 Homebrew 安装：

brew upgrade --cask codex

建议定期更新，因为 Codex CLI 命令、模型、权限模式、MCP、Cloud task 等能力变化比较快。

四、Codex 常用终端命令

1. codex

作用
启动 Codex 交互式终端界面。

cd your_project
codex

官方文档说明，运行 codex 会启动一个全屏终端 UI，Codex 可以读取仓库、修改文件、运行命令，并允许你实时审查它的行为。

使用场景
适合日常开发中直接进入项目，让 Codex 帮你理解或修改代码。
例如：

• 帮我分析这个 Flutter 项目的目录结构
• 帮我找一下登录页面的入口和状态管理逻辑
• 帮我检查这个页面是否存在 build 方法过重的问题

这是最基础、最常用的方式。

2. codex “你的问题”

作用
启动 Codex，并直接带上初始 prompt。

codex "Explain this codebase to me"

官方文档给出的示例就是通过命令行附带初始问题来启动 Codex。

使用场景
当你已经知道要问什么时，可以一行命令直接启动。

codex "帮我分析这个项目的架构，并指出核心模块"
codex "帮我检查当前 Flutter 项目的 Riverpod 使用是否合理"

适合快速进入一个明确任务。

3. codex exec

作用
以非交互方式执行一次 Codex 任务，适合脚本、CI、自动化流程。

codex exec "帮我检查当前 diff 中是否存在明显问题"

官方功能页说明，Codex 支持通过 exec 命令来脚本化自动化流程。

使用场景
非常适合自动化 Code Review、CI 检查、批量分析等。
例如：

git diff | codex exec "请基于当前 diff 做代码审查，只指出新增代码中的问题"

也可以用于生成 MR 描述：

git diff --stat | codex exec "根据这些变更生成一份简洁的 MR 描述"

如果你想把 Codex 接入 CNB、Jenkins、GitHub Actions、GitLab CI，codex exec 会比交互式 codex 更合适。

4. codex resume

作用
恢复之前的 Codex 会话。

codex resume

官方文档说明，Codex 会把会话记录保存在本地，可以通过 codex resume 重新打开之前的会话，避免重复输入上下文。

使用场景
适合长期任务，比如：

1. 一个复杂重构做了几天
2. 昨天已经分析过项目架构
3. 上次已经生成过迁移方案
4. 今天想继续接着处理

执行命令后选择最近的会话继续即可。

5. codex resume --last

作用
直接恢复当前目录最近一次会话。

codex resume --last

官方文档说明，codex resume --last 可以跳过选择器，直接恢复当前工作目录最近的会话。

使用场景
比如你昨天让 Codex 分析过 Flutter 页面重构，今天继续使用该命令，进入后继续下达任务即可。

6. codex resume --all

作用
显示所有目录下的历史会话。

codex resume --all

官方文档说明，–all 可以显示当前工作目录之外的会话。

使用场景
适合你在多个项目中都使用 Codex，想找回某个历史任务，执行命令后选择对应项目会话即可。

7. codex exec resume --last

作用
以非交互方式恢复最近会话，并继续执行任务。

codex exec resume --last "继续修复你上次发现的问题"

官方文档给出的示例包括 codex exec resume --last “Fix the race conditions you found”，说明非交互自动化任务也可以恢复上下文。

使用场景
适合自动化连续任务。

8. codex --cd

作用
指定 Codex 的工作目录。

codex --cd /path/to/project

官方 CLI 参考说明，–cd 或 -C 可以在 Codex 开始处理请求前设置工作目录。

使用场景
适合在脚本中明确指定项目路径，无需提前切换文件夹。

9. codex --add-dir

作用
给 Codex 额外目录访问权限。

codex --add-dir ../shared_package

官方 CLI 参考说明，–add-dir 可以给主工作区之外的目录授予额外写访问权限，并且可以重复使用。

使用场景
适合多仓库或本地依赖场景，可同时让 Codex 读取主项目与本地依赖库代码。

10. codex --model

作用
指定本次使用的模型。

codex --model gpt-5.5

官方 CLI 参考说明，–model 或 -m 可以覆盖配置中的模型。

使用场景
复杂任务使用更强模型，简单任务使用更快模型，按需搭配使用。

11. codex --profile

作用
加载指定配置 profile。

codex --profile work

官方 CLI 参考说明，–profile 或 -p 可以从 ~/.codex/config.toml 中加载指定配置 profile。

使用场景
适合区分不同项目或不同使用模式，适配团队统一开发规范。

12. codex -c key=value

作用
临时覆盖配置项。

codex -c model="gpt-5.5"

官方 CLI 参考说明，Codex CLI 默认继承 ~/.codex/config.toml，命令行中的 -c key=value 会覆盖本次调用的配置。

使用场景
适合临时修改某些参数，不想改动全局配置文件。

13. codex --ask-for-approval

作用
控制 Codex 运行命令前是否需要人工审批。

codex --ask-for-approval on-request

官方 CLI 参考说明，–ask-for-approval 或 -a 支持 untrusted、on-request、never 等值，用于控制 Codex 何时暂停并请求人工批准。

使用场景
日常开发建议开启审批模式，自动化只读场景可按需关闭审批。

14. codex --dangerously-bypass-approvals-and-sandbox

作用
跳过审批和沙箱限制。

codex --dangerously-bypass-approvals-and-sandbox

官方文档明确说明，该选项会在没有审批和沙箱的情况下运行每个命令，只应在外部已经加固的环境中使用。

使用场景
仅适用于容器、虚拟机、临时测试环境，严禁在正式业务项目使用。

15. codex --image

作用
把图片作为初始 prompt 附件传给 Codex。

codex --image screenshot.png "根据这个截图帮我分析 UI 问题"

官方 CLI 参考说明，–image 或 -i 可以把一个或多个图片文件附加到初始 prompt 中，多个路径可以用逗号分隔，也可以重复传入。

使用场景
适合前端、Flutter、UI 还原、Bug 截图分析等场景。

16. codex --oss

作用
使用本地开源模型提供方。

codex --oss

官方 CLI 参考说明，–oss 等价于设置 model_provider=“oss”，并会校验 Ollama 是否正在运行。

使用场景
适合本地模型测试、离线实验、低成本代码调试。

17. codex app-server

作用
启动 Codex 远程 app server。

codex app-server --listen ws://127.0.0.1:4500

官方功能页说明，可以在拥有代码、凭证和执行环境的机器上启动 app server，然后从另一台机器连接 Codex TUI。

使用场景
适合远程开发机、云端打包机远程操控开发。

五、Codex 会话内常用操作

进入 codex 交互界面后，可以像聊天一样输入自然语言，也可以使用一些快捷操作。

1. 输入普通任务

直接输入开发相关需求即可，适配日常各类开发调试场景。

2. 使用 /model

作用
切换模型或调整模型相关配置。
官方文档说明，Codex CLI 支持通过 /model 在不同模型之间切换，适配架构设计、代码重构、安全审查等高难度开发工作。

3. /clear

作用
清空当前对话，开始新任务。
也可以按 Ctrl + L 只清屏但不开始新对话，适合快速切换开发需求。

4. /copy

作用
复制最近一次 Codex 输出。
快捷键 Ctrl + O 也可快速复制，适合复制审查报告、优化方案、开发文档等内容。

5. /exit

作用
退出当前 Codex 会话。
也可使用 Ctrl + C 快速关闭交互式会话。

6. Tab 追加后续任务

Codex 正在运行任务时，按下 Tab 可提前输入后续需求，排队等待执行，高效完成连续开发任务。

7. Ctrl + R 搜索历史 prompt

在输入框中按 Ctrl + R 快速检索过往输入的指令，复用常用审查、开发提示词。

六、典型使用场景

场景 1：快速理解项目

cd my_flutter_project
codex "帮我分析这个 Flutter 项目的整体架构、主要模块和状态管理方案"

场景 2：查找业务入口

直接输入指令快速定位项目内页面、接口、路由等核心业务代码。

场景 3：基于 Git Diff 做 Code Review

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 安全使用建议

1. 禁止在正式项目中关闭审批与沙箱限制，规避代码误改、高危命令执行风险
2. 严格隔离 .env、密钥、证书、生产配置等敏感文件，限制 Codex 访问权限
3. 自动化流水线优先配置只读审查模式，区分代码检查与代码修改权限
4. 大型项目重构分步执行，先出方案核验，再分模块迭代修改

九、Codex 与 Claude Code 的区别简单对比

团队依托 OpenAI 生态优先选用 Codex，深耕 Claude 技术体系则适配 Claude Code。

十、常用命令速查表

十一、推荐工作流

1. 首次接入项目：进入项目目录启动交互终端，让AI通读项目整体结构，录入项目专属开发规范
2. 日常开发：直接启动交互模式，完成页面开发、逻辑优化、代码纠错等日常需求
3. 代码提交前：执行diff代码审查，结合原生编译检测双重校验代码质量
4. 流水线自动化：配置非交互审查指令，接入CI流程，自动拦截不合规代码合并

十二、总结

Codex CLI 核心价值并非单纯问答交互，而是深度融入全流程开发体系。
日常开发使用交互式指令，批量自动化任务使用 codex exec，跨场景开发借助会话恢复功能衔接工作内容，搭配目录指定、图片解析、模型切换等能力，可完美适配 Flutter 开发、代码自动化审核、云端运维流水线等各类开发场景，将其打造为团队专属自动化代码助手。

到此这篇关于Codex 终端常用命令与使用场景小结的文章就介绍到这了,更多相关Codex 终端常用命令内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论