一、Codex 是什么？

Codex CLI 是 OpenAI 推出的終端編程智能體，可以在本地終端中讀取代碼倉庫、修改文件、運行命令，并和開發(fā)者一起完成代碼理解、Bug 修復(fù)、重構(gòu)、測試、Code Review 等任務(wù)。官方文檔說明，Codex CLI 運行在本地終端中，可以在選定目錄內(nèi)讀代碼、改代碼、執(zhí)行命令，并且是開源項目，底層用 Rust 構(gòu)建。

簡單來說，它和 Claude Code 類似，都是“終端里的 AI 程序員”，但 Codex 更適合和 OpenAI 生態(tài)、ChatGPT 賬號、Codex Cloud、MCP、自動化腳本等一起使用。

二、安裝 Codex CLI

Codex CLI 支持 npm 和 Homebrew 安裝。官方文檔給出的 npm 安裝方式是：

npm i -g @openai/codex

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

brew install --cask codex

GitHub 倉庫 README 也列出了這兩種安裝方式。

安裝完成后，在終端執(zhí)行：

codex

首次運行時會提示登錄，可以使用 ChatGPT 賬號或 API Key。官方文檔說明，ChatGPT Plus、Pro、Business、Edu、Enterprise 計劃包含 Codex 使用入口，首次運行 codex 時會提示認證。

三、更新 Codex CLI

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

npm i -g @openai/codex@latest

官方文檔說明 Codex CLI 會定期發(fā)布新版本，npm 安裝方式可以通過安裝 latest 版本來升級。

如果是 Homebrew 安裝：

brew upgrade --cask codex

建議定期更新，因為 Codex CLI 命令、模型、權(quán)限模式、MCP、Cloud task 等能力變化比較快。

四、Codex 常用終端命令

1. codex

作用
啟動 Codex 交互式終端界面。

cd your_project
codex

官方文檔說明，運行 codex 會啟動一個全屏終端 UI，Codex 可以讀取倉庫、修改文件、運行命令，并允許你實時審查它的行為。

使用場景
適合日常開發(fā)中直接進入項目，讓 Codex 幫你理解或修改代碼。
例如：

• 幫我分析這個 Flutter 項目的目錄結(jié)構(gòu)
• 幫我找一下登錄頁面的入口和狀態(tài)管理邏輯
• 幫我檢查這個頁面是否存在 build 方法過重的問題

這是最基礎(chǔ)、最常用的方式。

2. codex “你的問題”

作用
啟動 Codex，并直接帶上初始 prompt。

codex "Explain this codebase to me"

官方文檔給出的示例就是通過命令行附帶初始問題來啟動 Codex。

使用場景
當你已經(jīng)知道要問什么時，可以一行命令直接啟動。

codex "幫我分析這個項目的架構(gòu)，并指出核心模塊"
codex "幫我檢查當前 Flutter 項目的 Riverpod 使用是否合理"

適合快速進入一個明確任務(wù)。

3. codex exec

作用
以非交互方式執(zhí)行一次 Codex 任務(wù)，適合腳本、CI、自動化流程。

codex exec "幫我檢查當前 diff 中是否存在明顯問題"

官方功能頁說明，Codex 支持通過 exec 命令來腳本化自動化流程。

使用場景
非常適合自動化 Code Review、CI 檢查、批量分析等。
例如：

git diff | codex exec "請基于當前 diff 做代碼審查，只指出新增代碼中的問題"

也可以用于生成 MR 描述：

git diff --stat | codex exec "根據(jù)這些變更生成一份簡潔的 MR 描述"

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

4. codex resume

作用
恢復(fù)之前的 Codex 會話。

codex resume

官方文檔說明，Codex 會把會話記錄保存在本地，可以通過 codex resume 重新打開之前的會話，避免重復(fù)輸入上下文。

使用場景
適合長期任務(wù)，比如：

1. 一個復(fù)雜重構(gòu)做了幾天
2. 昨天已經(jīng)分析過項目架構(gòu)
3. 上次已經(jīng)生成過遷移方案
4. 今天想繼續(xù)接著處理

執(zhí)行命令后選擇最近的會話繼續(xù)即可。

5. codex resume --last

作用
直接恢復(fù)當前目錄最近一次會話。

codex resume --last

官方文檔說明，codex resume --last 可以跳過選擇器，直接恢復(fù)當前工作目錄最近的會話。

使用場景
比如你昨天讓 Codex 分析過 Flutter 頁面重構(gòu)，今天繼續(xù)使用該命令，進入后繼續(xù)下達任務(wù)即可。

6. codex resume --all

作用
顯示所有目錄下的歷史會話。

codex resume --all

官方文檔說明，–all 可以顯示當前工作目錄之外的會話。

使用場景
適合你在多個項目中都使用 Codex，想找回某個歷史任務(wù)，執(zhí)行命令后選擇對應(yīng)項目會話即可。

7. codex exec resume --last

作用
以非交互方式恢復(fù)最近會話，并繼續(xù)執(zhí)行任務(wù)。

codex exec resume --last "繼續(xù)修復(fù)你上次發(fā)現(xiàn)的問題"

官方文檔給出的示例包括 codex exec resume --last “Fix the race conditions you found”，說明非交互自動化任務(wù)也可以恢復(fù)上下文。

使用場景
適合自動化連續(xù)任務(wù)。

8. codex --cd

作用
指定 Codex 的工作目錄。

codex --cd /path/to/project

官方 CLI 參考說明，–cd 或 -C 可以在 Codex 開始處理請求前設(shè)置工作目錄。

使用場景
適合在腳本中明確指定項目路徑，無需提前切換文件夾。

9. codex --add-dir

作用
給 Codex 額外目錄訪問權(quán)限。

codex --add-dir ../shared_package

官方 CLI 參考說明，–add-dir 可以給主工作區(qū)之外的目錄授予額外寫訪問權(quán)限，并且可以重復(fù)使用。

使用場景
適合多倉庫或本地依賴場景，可同時讓 Codex 讀取主項目與本地依賴庫代碼。

10. codex --model

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

codex --model gpt-5.5

官方 CLI 參考說明，–model 或 -m 可以覆蓋配置中的模型。

使用場景
復(fù)雜任務(wù)使用更強模型，簡單任務(wù)使用更快模型，按需搭配使用。

11. codex --profile

作用
加載指定配置 profile。

codex --profile work

官方 CLI 參考說明，–profile 或 -p 可以從 ~/.codex/config.toml 中加載指定配置 profile。

使用場景
適合區(qū)分不同項目或不同使用模式，適配團隊統(tǒng)一開發(fā)規(guī)范。

12. codex -c key=value

作用
臨時覆蓋配置項。

codex -c model="gpt-5.5"

官方 CLI 參考說明，Codex CLI 默認繼承 ~/.codex/config.toml，命令行中的 -c key=value 會覆蓋本次調(diào)用的配置。

使用場景
適合臨時修改某些參數(shù)，不想改動全局配置文件。

13. codex --ask-for-approval

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

codex --ask-for-approval on-request

官方 CLI 參考說明，–ask-for-approval 或 -a 支持 untrusted、on-request、never 等值，用于控制 Codex 何時暫停并請求人工批準。

使用場景
日常開發(fā)建議開啟審批模式，自動化只讀場景可按需關(guān)閉審批。

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

作用
跳過審批和沙箱限制。

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

官方文檔明確說明，該選項會在沒有審批和沙箱的情況下運行每個命令，只應(yīng)在外部已經(jīng)加固的環(huán)境中使用。

使用場景
僅適用于容器、虛擬機、臨時測試環(huán)境，嚴禁在正式業(yè)務(wù)項目使用。

15. codex --image

作用
把圖片作為初始 prompt 附件傳給 Codex。

codex --image screenshot.png "根據(jù)這個截圖幫我分析 UI 問題"

官方 CLI 參考說明，–image 或 -i 可以把一個或多個圖片文件附加到初始 prompt 中，多個路徑可以用逗號分隔，也可以重復(fù)傳入。

使用場景
適合前端、Flutter、UI 還原、Bug 截圖分析等場景。

16. codex --oss

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

codex --oss

官方 CLI 參考說明，–oss 等價于設(shè)置 model_provider=“oss”，并會校驗 Ollama 是否正在運行。

使用場景
適合本地模型測試、離線實驗、低成本代碼調(diào)試。

17. codex app-server

作用
啟動 Codex 遠程 app server。

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

官方功能頁說明，可以在擁有代碼、憑證和執(zhí)行環(huán)境的機器上啟動 app server，然后從另一臺機器連接 Codex TUI。

使用場景
適合遠程開發(fā)機、云端打包機遠程操控開發(fā)。

五、Codex 會話內(nèi)常用操作

進入 codex 交互界面后，可以像聊天一樣輸入自然語言，也可以使用一些快捷操作。

1. 輸入普通任務(wù)

直接輸入開發(fā)相關(guān)需求即可，適配日常各類開發(fā)調(diào)試場景。

2. 使用 /model

作用
切換模型或調(diào)整模型相關(guān)配置。
官方文檔說明，Codex CLI 支持通過 /model 在不同模型之間切換，適配架構(gòu)設(shè)計、代碼重構(gòu)、安全審查等高難度開發(fā)工作。

3. /clear

作用
清空當前對話，開始新任務(wù)。
也可以按 Ctrl + L 只清屏但不開始新對話，適合快速切換開發(fā)需求。

4. /copy

作用
復(fù)制最近一次 Codex 輸出。
快捷鍵 Ctrl + O 也可快速復(fù)制，適合復(fù)制審查報告、優(yōu)化方案、開發(fā)文檔等內(nèi)容。

5. /exit

作用
退出當前 Codex 會話。
也可使用 Ctrl + C 快速關(guān)閉交互式會話。

6. Tab 追加后續(xù)任務(wù)

Codex 正在運行任務(wù)時，按下 Tab 可提前輸入后續(xù)需求，排隊等待執(zhí)行，高效完成連續(xù)開發(fā)任務(wù)。

7. Ctrl + R 搜索歷史 prompt

在輸入框中按 Ctrl + R 快速檢索過往輸入的指令，復(fù)用常用審查、開發(fā)提示詞。

六、典型使用場景

場景 1：快速理解項目

cd my_flutter_project
codex "幫我分析這個 Flutter 項目的整體架構(gòu)、主要模塊和狀態(tài)管理方案"

場景 2：查找業(yè)務(wù)入口

直接輸入指令快速定位項目內(nèi)頁面、接口、路由等核心業(yè)務(wù)代碼。

場景 3：基于 Git Diff 做 Code Review

git diff | codex exec "請基于當前 diff 做代碼審查，只審查新增代碼，按 blocker、critical、major、minor、suggestion 分類輸出"

場景 4：生成 MR 描述

借助 git 提交記錄快速生成規(guī)范簡潔的合并請求說明。

場景 5：生成周報

抓取周期內(nèi)代碼提交記錄，自動整理分類生成工作周報。

場景 6：分析構(gòu)建失敗日志

讀取打包、編譯報錯日志，自動定位問題根源并給出修復(fù)方案。

場景 7：輔助 Flutter 重構(gòu)

優(yōu)先讓 AI 輸出重構(gòu)方案，確認無誤后再執(zhí)行代碼修改，規(guī)避線上風(fēng)險。

場景 8：根據(jù)截圖分析 UI 問題

搭配圖片指令，快速定位頁面樣式錯亂、布局異常等前端問題。

場景 9：接入自動化 Code Review

在 CI 流水線中配置指令，固定 JSON 格式輸出審查結(jié)果，對接各類自動化運維平臺。

七、Flutter 項目推薦 Prompt

可自定義規(guī)范審查話術(shù)，限定代碼編寫規(guī)范、資源使用規(guī)則、代碼行數(shù)限制等，統(tǒng)一團隊 Flutter 開發(fā)代碼風(fēng)格，搭配執(zhí)行命令批量審查項目代碼。

八、Codex 安全使用建議

1. 禁止在正式項目中關(guān)閉審批與沙箱限制，規(guī)避代碼誤改、高危命令執(zhí)行風(fēng)險
2. 嚴格隔離 .env、密鑰、證書、生產(chǎn)配置等敏感文件，限制 Codex 訪問權(quán)限
3. 自動化流水線優(yōu)先配置只讀審查模式，區(qū)分代碼檢查與代碼修改權(quán)限
4. 大型項目重構(gòu)分步執(zhí)行，先出方案核驗，再分模塊迭代修改

九、Codex 與 Claude Code 的區(qū)別簡單對比

團隊依托 OpenAI 生態(tài)優(yōu)先選用 Codex，深耕 Claude 技術(shù)體系則適配 Claude Code。

十、常用命令速查表

十一、推薦工作流

1. 首次接入項目：進入項目目錄啟動交互終端，讓AI通讀項目整體結(jié)構(gòu)，錄入項目專屬開發(fā)規(guī)范
2. 日常開發(fā)：直接啟動交互模式，完成頁面開發(fā)、邏輯優(yōu)化、代碼糾錯等日常需求
3. 代碼提交前：執(zhí)行diff代碼審查，結(jié)合原生編譯檢測雙重校驗代碼質(zhì)量
4. 流水線自動化：配置非交互審查指令，接入CI流程，自動攔截不合規(guī)代碼合并

十二、總結(jié)

Codex CLI 核心價值并非單純問答交互，而是深度融入全流程開發(fā)體系。
日常開發(fā)使用交互式指令，批量自動化任務(wù)使用 codex exec，跨場景開發(fā)借助會話恢復(fù)功能銜接工作內(nèi)容，搭配目錄指定、圖片解析、模型切換等能力，可完美適配 Flutter 開發(fā)、代碼自動化審核、云端運維流水線等各類開發(fā)場景，將其打造為團隊專屬自動化代碼助手。

到此這篇關(guān)于Codex 終端常用命令與使用場景小結(jié)的文章就介紹到這了,更多相關(guān)Codex 終端常用命令內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論