Codex CLI 安裝小記

Codex CLI 安裝小記

OS: macOS 14.3

codex-cli: 0.47.0

現在 Coding Agent 我使用 CLI 的比例越來越高

今天來寫 Codex CLI 安裝小記

官網

• https://developers.openai.com/codex/cli/

• https://github.com/openai/codex

安裝 Codex CLI

• 可以使用 npm 或是 Homebrew 安裝, 因為是 macOS, 我習慣用 brew 安裝

使用 brew 安裝

% brew  install  codex

• 這邊補充一下, 因為是透過 brew 來安裝, 因為 coding agent 升版都很快, brew 預設不會自動升級, 提供下列 brew 常用指令

• brew outdated - 列出目前可以升級的套件

• brew info codex - 列出 codex 目前最新穩定版本與安裝資訊

• brew  upgrade  codex - 升級 codex 套件

另外一個狀況就是執行 codex 的時候如果有新版本也會詢問是否要升級

如下圖

檢查版本

% codex  --version

codex-cli 0.47.0

第一次登入 codex 的時候會要求登入 ChatGPT 或是 確認使用 API Key 方式, 這個部分細節可以參考官方文件

• https://github.com/openai/codex/blob/main/docs/authentication.md 

• 使用 codex login 來進行登入 

• 在家目錄 ~/.codex 內會有 auth.json 可以參考

執行 Codex  CLI

% codex

這邊蠻有趣的一個點是, 

如果執行的目錄沒有版控

• 預設會詢問授權後進行修改或執行 ( Require approval of edits and commands )

如果執行的目錄有版控

• 預設則是一路到底 :p ( Yes, allow Codex to work in this folder without asking for approval )

進入之後可以開始輸入對話或是使用相關功能

列出一些常用的功能

可以用 /status 觀察資訊

用 /model 選擇模型

用 /approvals 選授權方式

用 /init 分析目錄與建立 AGENTS.md

• 這點覺得很有用, 預設是英文的 AGENTS.md 可以請他換成中文的

用 /mcp 列出目前 MCP

另外補充一些其他的

使用非互動方式執行 codex

% codex  exec  --skip-git-repo-check "請介紹虎斑貓"

% codex  --search

• 啟用搜尋模式 (預設沒有啟動)

% codex  resume

• 從之前對話繼續

先這樣, 感覺又向前一步

~ enjoy it

References

• https://developers.openai.com/codex/cli/

• https://github.com/openai/codex