OpenAI Codex CLI：你的終端機 AI 程式碼夥伴，上手指南與實用技巧

厭倦了在寫程式、解 Bug 或理解陌生程式碼時不斷切換視窗嗎？來認識 OpenAI Codex CLI，這個直接在你的終端機運行的 AI 助手，讓你的開發流程更順暢、更有效率。本文將帶你快速上手，並解答你可能有的疑問。

你有沒有想過，如果在終端機裡就能有個聰明的 AI 夥伴，能幫你讀懂程式碼、快速修改、甚至自動執行指令，那該有多好？嗯，這個想法現在成真了！OpenAI 推出的 Codex CLI 就是這樣一個酷東西。

老實說，身為開發者，我們常常需要處理一堆雜事：一下子要查文件，一下子要修復惱人的 Bug，有時候還得硬著頭皮去看別人寫的天書（我是說，程式碼）。在不同工具和視窗間跳來跳去，真的挺耗費心神的。

這就是 OpenAI Codex CLI 派上用場的地方了。它是一個開源的命令列工具，把 OpenAI 最新的 AI 推理能力直接帶進你的終端機。你可以把它想像成一個輕量級的程式碼代理人，住在你的電腦裡，隨時準備幫你一把。

等等，這東西會偷看我的程式碼嗎？先講重點！

這大概是大家最關心的問題了。放心！Codex CLI 最棒的一點就是它 在你的本機端運行。這代表什麼？代表除非你主動選擇分享，否則你的原始碼 絕對不會離開你的電腦環境。所有的檔案讀取、修改、執行指令，通通在你自己的機器上完成。只有你的提示、一些高層次的上下文資訊，還有（選擇性的）程式碼差異摘要會被傳送給 AI 模型進行處理。對於注重隱私和安全的開發者來說，這點真的超加分，對吧？

想深入了解技術細節或看看原始碼？可以直接去他們的 GitHub 看看：https://github.com/openai/codex

那… 它到底能幫我做什麼？核心功能一次看

Codex CLI 不只是個噱頭，它可是有真材實料的：

安裝超簡單： 真的不用搞一堆複雜設定。一個 npm install -g @openai/codex 指令（或是用 codex --upgrade 更新）就搞定，馬上就能開始用。是不是很方便？
不只能讀文字： 這傢伙支援「多模態輸入」。意思就是，你不只可以用文字跟它溝通，還可以丟給它螢幕截圖或流程圖，讓它根據這些視覺資訊來產生或修改程式碼。這在理解複雜邏輯或 UI 問題時特別有用！
掌控權在你手： 它提供三種不同的「批准模式」（後面會詳細說明），你可以決定要讓 AI 自動化到什麼程度，從僅提供建議到全自動執行，彈性十足。
專注，不分心： 因為完全在終端機裡運作，你不需要一直切換視窗，可以更專注在你的程式碼和任務上。對於喜歡快速迭代的開發者來說，這簡直是福音。

三種模式，任君挑選：了解批准模式 (Approval Modes)

Codex CLI 的核心之一就是它的批准模式，讓你在效率和安全之間找到平衡點。

1. 建議模式 (Suggest) - 你的安全網 (預設)

AI 能做什麼： 只能讀取檔案。它會「提議」修改內容或執行 shell 指令，但 必須等你按下同意，它才會真的動手。
何時使用： 當你想要安全地探索新功能、請 AI 幫忙做程式碼審查，或是學習一個你不熟的程式碼庫時，這是最保險的選擇。

2. 自動編輯模式 (Auto Edit) - 信任，但要驗證

AI 能做什麼： 可以自動讀取和寫入檔案。不過，在執行任何 shell 指令之前，它還是會先問過你。
何時使用： 當你需要進行一些重構工作，或是做大量重複性的編輯，但又想留意潛在的副作用（例如執行指令可能造成的影響）時，這個模式就很方便。

3. 全自動模式 (Full Auto) - 放手去做（但要小心！）

AI 能做什麼： 在一個受限制的「沙盒」環境裡，它可以自動讀取、寫入檔案，並且執行指令。這個沙盒環境通常沒有網路連線，且範圍僅限於目前的專案目錄。
何時使用： 對於比較耗時的任務，像是修復一個壞掉的建置流程，或是快速建立一個新功能的原型，你可以讓 AI 在這個模式下工作，自己則可以去泡杯咖啡休息一下。

專業提示： 如果你的專案目錄沒有使用版本控制（像是 Git），在你切換到 Auto Edit 或 Full Auto 模式之前，Codex CLI 會貼心地跳出警告。這點真的很重要，確保你有後路可退！

馬上動手玩：快速入門指南

想試試看了嗎？跟著以下步驟，超級簡單：

安裝： 打開你的終端機，輸入：
```
npm install -g @openai/codex
```
驗證： 你需要設定你的 OpenAI API 金鑰。執行這個指令（記得把 <OAI_KEY> 換成你自己的金鑰）：
```
export OPENAI_API_KEY="<OAI_KEY>"
```
（小提醒：根據你的 shell 環境，設定環境變數的方式可能略有不同，例如 Zsh 可能需要寫入 .zshrc）
開始玩（建議模式）： 進入你的專案目錄，輸入 codex，然後就可以開始問問題了，例如：
```
codex "幫我解釋一下這個 repo 的主要功能。"
```
或者
```
codex "找出這個檔案裡的潛在 bug：src/utils.js"
```
切換模式： 如果想嘗試其他模式，可以在啟動時加上對應的參數：
- 自動編輯模式：codex --auto-edit
- 全自動模式：codex --full-auto （或者在 Codex CLI 運行中，輸入 /mode 也可以切換模式）
檢視結果： Codex CLI 會直接在終端機印出它建議的程式碼修改（通常是 diff 格式）或打算執行的 shell 指令。你可以選擇批准 (approve)、拒絕 (reject)，或者自己再調整一下。

你可能還想知道… (FAQ 整合)

這裡整理了一些大家可能會好奇的問題：

Codex CLI 用的是哪個 AI 模型？ 預設情況下，為了追求速度和效率，它使用的是 o4-mini 模型。但你也可以指定使用 OpenAI Responses API 支援的任何模型，例如：codex -m o3。如果你是 OpenAI 的認證開發者，還有機會在 API 回應中看到模型的「思考鏈」(chain of thought) 摘要，幫助你了解 AI 是如何得到答案的。
我的程式碼真的安全嗎？會被上傳嗎？ 再強調一次：不會。所有跟你的檔案內容相關的操作（讀、寫、執行）都在你的本機進行。只有你的提示、一些高層次的上下文和選擇性的 diff 摘要會送到 OpenAI 的伺服器。
要怎麼在運行中切換批准模式？ 很簡單！你可以在一開始啟動 Codex CLI 時就用參數指定 (--suggest, --auto-edit, --full-auto)，或者在對話過程中，隨時輸入斜線指令 /mode 來進行切換。
支援哪些作業系統？ 官方正式支援 macOS 和 Linux。Windows 上的支援目前還是實驗性質，可能需要搭配 WSL (Windows Subsystem for Linux) 才能順暢運作。
AI 卡住了或超時了怎麼辦？ 別慌，試試這幾招：
1. 檢查你的網路連線是不是穩定，因為 AI 需要透過 API 呼叫來運作。
2. 試著按下 CTRL + C 來中斷當前的步驟，然後可以請 Codex CLI 繼續之前的任務。
3. 如果你正在用 Full Auto 模式，確認一下沙盒環境是否有足夠的權限去存取它需要讀寫的目錄。
如何更新 Codex CLI 到最新版本？ 隨時想更新，只需要在終端機執行：
```
codex --upgrade
```
它就會自動去抓最新的版本了。

結語：是時候讓 AI 助你一臂之力了！

OpenAI Codex CLI 真的是一個蠻有潛力的工具，它把強大的 AI 直接整合到我們最熟悉的開發環境——終端機裡。無論你是想快速理解程式碼、減少重複性工作，還是需要一個小幫手來除錯，它都能提供一定程度的幫助。

最重要的是，它尊重你的程式碼隱私，並且讓你保有最終的控制權。

還在等什麼？馬上安裝來玩玩看吧！說不定你會發現，有這位 AI 夥伴在，寫程式真的可以變得更輕鬆有趣。

前往 GitHub Repo 了解更多：https://github.com/openai/codex

OpenAI Codex CLI：你的終端機 AI 程式碼夥伴，上手指南與實用技巧

等等，這東西會偷看我的程式碼嗎？先講重點！

那… 它到底能幫我做什麼？核心功能一次看