學習用單一指令在 macOS 或 Ubuntu 安裝 OpenAI Codex CLI、完成 ChatGPT 登入、更新版本，並解決 snap 與 local bin 路徑衝突，立即在終端機使用 AI 程式碼代理。
簡介
OpenAI Codex CLI 是在終端機中檢視、修改程式碼並執行本機工具的 coding agent。官方為 macOS 與 Linux（含 Ubuntu） 提供相同的獨立安裝程式，安裝與更新皆使用同一條指令，無需預先安裝 Node.js 或 npm。
安裝前準備
- 開啟終端機：
- macOS：Terminal.app 或 iTerm2
- Ubuntu：
Ctrl+Alt+T或從 Applications 開啟
- 確認網路連線正常
- 使用一般使用者帳號執行即可（不需
sudo）
官方安裝指令（macOS / Ubuntu 通用）
curl -fsSL https://chatgpt.com/codex/install.sh | sh
注意：網址必須是純文字 URL，勿貼上 Markdown 連結語法。
安裝完成後，關閉並重新開啟終端機，或執行 source ~/.bashrc（或對應的 shell 設定檔）重新載入環境。
驗證安裝
codex --version
若顯示版本號即代表安裝成功。
首次啟動與登入
- 進入專案資料夾（建議在 Git repository 內）：
cd ~/path/to/your-project git status codex - 依畫面提示選擇 Sign in with ChatGPT，在瀏覽器完成登入與授權後返回終端機。
- OpenAI 建議使用 ChatGPT 帳號登入；Plus、Pro、Business、Edu、Enterprise 方案可透過方案使用 Codex，亦可改用 API key（需額外設定）。
基本使用範例
進入 Codex 後可直接輸入自然語言指令：
Explain this project structure and identify the main entry point.
Review the uncommitted changes and point out likely bugs. Do not modify files.
Codex 可在本機 repository 中檢查檔案、提出或套用修改、執行既有開發工具。使用中可透過 /permissions 管理執行指令與修改檔案的權限界線。
更新到最新版
官方將更新與安裝設計為同一條命令，再執行一次即可：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
完成後重新開啟終端機並確認版本：
codex --version
依原安裝方式更新
| 原本安裝方式 | 更新指令 |
|---|---|
| 官方 installer（Ubuntu / macOS） | `curl -fsSL https://chatgpt.com/codex/install.sh |
| npm | npm install -g @openai/codex@latest |
| Homebrew（macOS） | brew upgrade --cask codex |
提醒：勿依賴舊教學的
codex --upgrade；官方 GitHub issue 已確認該旗標文件引用被移除且功能不可靠。
替代安裝方法
若組織政策禁止執行遠端 shell installer：
- npm（跨平台）：
npm install -g @openai/codex - Homebrew（macOS）：
brew install --cask codex - 官方 Release Binary：適合固定版本或離線部署，可從 GitHub Releases 下載。
安全考量：不想直接 curl | sh
可先下載腳本檢閱再執行：
curl -fsSL https://chatgpt.com/codex/install.sh -o /tmp/codex-install.sh
less /tmp/codex-install.sh
sh /tmp/codex-install.sh
CI 或非互動式安裝可設定環境變數：
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh
常見問題排除
codex: command not found
- 關閉並重新開啟終端機
- 執行
command -v codex與codex --version - 若仍找不到，重新執行官方安裝程式
Bash 優先找到過期的 /snap/bin/codex
現象：執行 codex 報錯，但官方 installer 實際安裝在 ~/.local/bin/codex。
立即修復：
type -a codex
alias codex 2>/dev/null
若顯示 codex is /snap/bin/codex，清除 shell 指令快取並確認新位置：
hash -r
ls -l ~/.local/bin/codex
~/.local/bin/codex --version
若能顯示版本號，直接執行 ~/.local/bin/codex。
永久修復：將 ~/.local/bin 放到 PATH 最前面：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
hash -r
再測試：
command -v codex
codex --version
codex
正常應回傳 /home/<user>/.local/bin/codex。
若仍指向 /snap/bin/codex：搜尋並移除殘留 alias 或函式：
grep -nE 'alias codex|/snap/bin/codex|function codex' ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null
若發現 alias codex='/snap/bin/codex'，移除該行：
sed -i '\|/snap/bin/codex|d' ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null
source ~/.bashrc
hash -r
最後再次確認 command -v codex 與 codex --version。
關鍵點：錯誤並非「找不到 Snap 路徑」，而是 Bash 已找到
/snap/bin/codex但該舊執行檔已不存在。切勿為了修復而把/snap/bin加回 PATH。
結語
OpenAI Codex CLI 以單一指令完成跨平台安裝與更新，搭配 ChatGPT 帳號即可在終端機直接協助程式碼審查、重構與除錯。掌握 PATH 衝突排除與替代安裝方式，能確保在各種環境政策下順利部署。