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 

Ubuntu 24.04 LTS 使用 NVM 安裝 node.js 版本小記

Ubuntu 24.04 LTS 使用 NVM 安裝 node.js 版本小記

OS: Ubuntu 24.04 LTS on GCP

目前 Gemini CLI 版本升級的很快 (寫文章當下為 0.8.2), 需求的 Node.js 版本也從之前的 18 修改為 20 以上的版本

今天寫這篇 Blog 就是紀錄如何調整 Ubuntu 24.04 LTS node.js 版本

• 以目前 Ubuntu 24.04 LTS 預設的 node.js 18 是無法執行 Gemini CLI

如果詢問 Gemini CLI 如何升級 Ubuntu 24.04 的 Node.js 版本,他可能會首推 nvm

• 如果在 node.js 下載的頁面 https://nodejs.org/en/download  上, 你也會看到 nvm 會放在預設選項 

以下是 nvm 說明 (取自 Gemini CLI)

nvm (Node Version Manager) 是一個非常實用的命令列工具，它允許您在同一台電腦上安裝和管理多個不同的 Node.js 版本。

nvm 是一個 shell 腳本，它不會汙染您系統原生的套件管理器（如 apt 或 brew）。它將 Node.js 版本安裝在您的家目錄 (~/.nvm) 下的一個子目錄中，並透過修改您的 PATH 環境變數來讓您輕鬆切換要使用的版本。

nvm 的主要優點

• 版本隔離：您可以在電腦上同時擁有 Node.js v16, v18, v20 等多個版本，並為不同的專案指定不同的版本。

• 輕鬆切換：只需一個簡單的指令，就可以在幾秒鐘內切換當前終端機 (terminal) 工作階段所使用的 Node.js 版本。

• 無需 sudo：因為 Node.js 和全域安裝的 npm 套件都儲存在您的家目錄下，所以在執行 npm install -g <package> 時不再需要 sudo 權限，避免了潛在的權限問題。

• 方便測試：您可以輕易地測試您的應用程式在不同 Node.js 版本下的相容性。

• 專案版本鎖定：透過在專案根目錄下建立一個 .nvmrc 檔案，團隊成員可以自動同步並使用專案指定的 Node.js 版本。

安裝 nvm

$ curl  -o-  https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh  |  bash

讓 nvm 指令生效

$ source  ~/.bashrc

• 可以觀察 ~/.bashrc 內容

列出所有可安裝的遠端版本

$ nvm  ls-remote

$ nvm  ls-remote | grep  'Latest LTS'

         v4.9.1   (Latest LTS: Argon)

        v6.17.1   (Latest LTS: Boron)

        v8.17.0   (Latest LTS: Carbon)

       v10.24.1   (Latest LTS: Dubnium)

      v12.22.12   (Latest LTS: Erbium)

       v14.21.3   (Latest LTS: Fermium)

       v16.20.2   (Latest LTS: Gallium)

       v18.20.8   (Latest LTS: Hydrogen)

       v20.19.5   (Latest LTS: Iron)

       v22.20.0   (Latest LTS: Jod)

列出已安裝版本

$ nvm  ls

            N/A

iojs -> N/A (default)

node -> stable (-> N/A) (default)

unstable -> N/A (default)

lts/* -> lts/jod (-> N/A)

lts/argon -> v4.9.1 (-> N/A)

lts/boron -> v6.17.1 (-> N/A)

lts/carbon -> v8.17.0 (-> N/A)

lts/dubnium -> v10.24.1 (-> N/A)

lts/erbium -> v12.22.12 (-> N/A)

lts/fermium -> v14.21.3 (-> N/A)

lts/gallium -> v16.20.2 (-> N/A)

lts/hydrogen -> v18.20.8 (-> N/A)

lts/iron -> v20.19.5 (-> N/A)

lts/jod -> v22.20.0 (-> N/A)

• 目前尚未安裝

安裝最新穩定版 (LTS)

$ nvm   install  --lts

Installing latest LTS version.

Downloading and installing node v22.20.0...

Downloading https://nodejs.org/dist/v22.20.0/node-v22.20.0-linux-x64.tar.xz...

###################################################################################################################################### 100.0%

Computing checksum with sha256sum

Checksums matched!

Now using node v22.20.0 (npm v10.9.3)

Creating default alias: default -> lts/* (-> v22.20.0)

再次觀察

$ nvm  ls

->     v22.20.0

default -> lts/* (-> v22.20.0)

iojs -> N/A (default)

unstable -> N/A (default)

node -> stable (-> v22.20.0) (default)

stable -> 22.20 (-> v22.20.0) (default)

lts/* -> lts/jod (-> v22.20.0)

lts/argon -> v4.9.1 (-> N/A)

lts/boron -> v6.17.1 (-> N/A)

lts/carbon -> v8.17.0 (-> N/A)

lts/dubnium -> v10.24.1 (-> N/A)

lts/erbium -> v12.22.12 (-> N/A)

lts/fermium -> v14.21.3 (-> N/A)

lts/gallium -> v16.20.2 (-> N/A)

lts/hydrogen -> v18.20.8 (-> N/A)

lts/iron -> v20.19.5 (-> N/A)

lts/jod -> v22.20.0

• 這邊可以觀察到使用中與預設都設定為 22.20.0

$ node  -v

v22.20.0

$ npm  -v

10.9.3

安裝特定版本

$ nvm  install  20.10.0

Downloading and installing node v20.10.0...

Downloading https://nodejs.org/dist/v20.10.0/node-v20.10.0-linux-x64.tar.xz...

###################################################################################################################################### 100.0%

Computing checksum with sha256sum

Checksums matched!

Now using node v20.10.0 (npm v10.2.3)

再次觀察

$ nvm  ls

->     v20.10.0

       v22.20.0

default -> lts/* (-> v22.20.0)

iojs -> N/A (default)

unstable -> N/A (default)

node -> stable (-> v22.20.0) (default)

stable -> 22.20 (-> v22.20.0) (default)

lts/* -> lts/jod (-> v22.20.0)

lts/argon -> v4.9.1 (-> N/A)

lts/boron -> v6.17.1 (-> N/A)

lts/carbon -> v8.17.0 (-> N/A)

lts/dubnium -> v10.24.1 (-> N/A)

lts/erbium -> v12.22.12 (-> N/A)

lts/fermium -> v14.21.3 (-> N/A)

lts/gallium -> v16.20.2 (-> N/A)

lts/hydrogen -> v18.20.8 (-> N/A)

lts/iron -> v20.19.5 (-> N/A)

lts/jod -> v22.20.0

• 觀察使用中箭頭 已經指向 v20.10.0

• 指令觀察 node -v / npm -v 也換成相對應的版本

安裝最新的 node.js  20 版本

$ nvm  install  20

Downloading and installing node v20.19.5...

Downloading https://nodejs.org/dist/v20.19.5/node-v20.19.5-linux-x64.tar.xz...

###################################################################################################################################### 100.0%

Computing checksum with sha256sum

Checksums matched!

Now using node v20.19.5 (npm v10.8.2)

nvm alias default 20

觀察資訊

$ nvm  ls

       v20.10.0

->     v20.19.5

       v22.20.0

default -> lts/* (-> v22.20.0)

iojs -> N/A (default)

unstable -> N/A (default)

node -> stable (-> v22.20.0) (default)

stable -> 22.20 (-> v22.20.0) (default)

lts/* -> lts/jod (-> v22.20.0)

lts/argon -> v4.9.1 (-> N/A)

lts/boron -> v6.17.1 (-> N/A)

lts/carbon -> v8.17.0 (-> N/A)

lts/dubnium -> v10.24.1 (-> N/A)

lts/erbium -> v12.22.12 (-> N/A)

lts/fermium -> v14.21.3 (-> N/A)

lts/gallium -> v16.20.2 (-> N/A)

lts/hydrogen -> v18.20.8 (-> N/A)

lts/iron -> v20.19.5

lts/jod -> v22.20.0

切換 node.js 版本

$ nvm  use  22.20.0

Now using node v22.20.0 (npm v10.9.3)

觀察資訊

$ nvm  ls

       v20.10.0

       v20.19.5

->     v22.20.0

default -> lts/* (-> v22.20.0)

iojs -> N/A (default)

unstable -> N/A (default)

node -> stable (-> v22.20.0) (default)

stable -> 22.20 (-> v22.20.0) (default)

lts/* -> lts/jod (-> v22.20.0)

lts/argon -> v4.9.1 (-> N/A)

lts/boron -> v6.17.1 (-> N/A)

lts/carbon -> v8.17.0 (-> N/A)

lts/dubnium -> v10.24.1 (-> N/A)

lts/erbium -> v12.22.12 (-> N/A)

lts/fermium -> v14.21.3 (-> N/A)

lts/gallium -> v16.20.2 (-> N/A)

lts/hydrogen -> v18.20.8 (-> N/A)

lts/iron -> v20.19.5

lts/jod -> v22.20.0

設定預設版本

$ nvm  alias  default  20

default -> 20 (-> v20.19.5)

• 所謂的預設版本就是開了終端機, 預設會使用的 node.js 版本

觀察資訊

$ nvm  ls

       v20.10.0

       v20.19.5

->     v22.20.0

default -> 20 (-> v20.19.5)

iojs -> N/A (default)

unstable -> N/A (default)

node -> stable (-> v22.20.0) (default)

stable -> 22.20 (-> v22.20.0) (default)

lts/* -> lts/jod (-> v22.20.0)

lts/argon -> v4.9.1 (-> N/A)

lts/boron -> v6.17.1 (-> N/A)

lts/carbon -> v8.17.0 (-> N/A)

lts/dubnium -> v10.24.1 (-> N/A)

lts/erbium -> v12.22.12 (-> N/A)

lts/fermium -> v14.21.3 (-> N/A)

lts/gallium -> v16.20.2 (-> N/A)

lts/hydrogen -> v18.20.8 (-> N/A)

lts/iron -> v20.19.5

lts/jod -> v22.20.0

補充 .nvmrc 進行版本管理

• 在專案目錄下如果有 .nvmrc 檔案, 在檔案中可以寫入想使用的 node.js 版本, 例如 20.10.0

• 如果版本已安裝, 可以使用 nvm use 指令去搜尋是否有 .nvmrc 檔案並切換到該版本

• 如果版本未安裝, 可使用 nvm install 來進行安裝

==== 同場加映 使用 apt 方式 調整系統 node.js 版本 ====

在大部分的時候, 如果是新的系統, 我可能還是會採取 apt 方式來調整系統的 node.js 版本

原因為

• nvm 適合開發人員使用, 他安裝的路徑都是在個人家目錄 (~/.nvm/versions/node), 也就是說只對個人有效 

• 系統未必知道相關設定, 例如 cron job, 所以如果執行 cron job 可能還是使用 node.js  18.x 版本, 也許會產生錯誤

以下紀錄使用 nodesource 來源 增加 node.js 20 版本方式

安裝相關套件

$ sudo  apt  update  &&  sudo apt  install -y  ca-certificates curl  gnupg

建立 key 使用目錄

$ sudo  mkdir  -p  /etc/apt/keyrings

取得 gpg key

$ curl  -fsSL  https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key  |  sudo  gpg --dearmor  -o  /etc/apt/keyrings/nodesource.gpg

設定要使用的 node.js 版本

$ NODE_MAJOR=20

新增 repo

$ echo  "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

執行 apt update

$ sudo  apt  update

安裝 node.js 

$ sudo  apt  install  nodejs  -y

驗證安裝

$ node -v

$ npm -v

這樣又往前一步

~ enjoy it