用 VS Code 搭配 OpenAI Codex 打造 AI 程式輔助開發環境
🧠 一、什麼是 OpenAI Codex
-
Codex 是 OpenAI 的 AI 程式碼代理，可以自動產生、修改、審查程式碼、甚至執行測試與命令。
-
它同時支援 CLI (命令列) 與 IDE 擴充套件，你可以在 VS Code 內直接操作。
-
Codex 可以從提示（Prompt）或規格（Spec）開始，在整個程式庫中穿梭，協助產生或修正程式碼。
⚙️ 二、環境準備
1. 安裝 VS Code
-
前往 VS Code 官方網站下載並安裝。
-
開啟後確認版本是否為最新（建議版本 > 1.80）。
2. 訂閱 ChatGPT 並啟用 Codex
-
Codex 功能目前已包含於 ChatGPT Plus、Pro、Business、Enterprise 等方案。
-
全新的免費方案與 Go 方案也有提供 Codex 限時使用。
📥 三、安裝 Codex 擴充套件
1. 透過 VS Code Marketplace 安裝
-
開啟 VS Code → Extensions（擴充套件）視窗
-
搜尋：
Codex或OpenAI Codex -
安裝官方插件
👉 安裝後可在側邊欄看到 Codex 控制面板。
⚠️ 註：有些用戶回報在 Windows 上可能會出現沙盒讀取權限提示，可以從設定選擇「Full Access」以允許完整操作（這是 VS Code 擴充套件的選項）。
📡 四、基本設定與登入
1. 使用 CLI 登入（可選）
-
安裝 Codex CLI：
npm i -g @openai/codex
或
brew install codex
⚠️ 安裝前需先安裝 Node.js 或 Homebrew。
-
登入：
codex login
2. 在 VS Code 中與 ChatGPT 帳戶連動
-
打開擴充套件後，依照提示使用 ChatGPT 帳戶登入（可能需要連 GitHub 帳號做授權）。
💡 五、實際使用 Codex（VS Code 版）
1. 指令模式
-
在 Codex 側邊欄輸入自然語言 prompt，例如：
請幫我重構這個函式 -
Codex 會在你專案中自動編輯程式碼（可預覽修改內容）。
2. 單一檔案協作
-
選擇單一檔案中的部分（例如一段 function），然後向 Codex 提問：
用更效能更好的方式重寫這段 Python 邏輯
3. 自動生成測試案例
-
Codex 可以依據你現有程式碼，為你生成單元測試：
幫我為這個 Class 生成 Jest 測試套件
🚀 六、進階使用技巧
1. Prompt Engineering 提升效率
-
清楚描述需求與輸出格式（例如：「請用 TDD 方式，先生成失敗測試，再產生實作」）。
-
透過多輪互動精煉解法。
2. Agents.md 引導大型專案
-
在專案根目錄建立 Agents.md 來告訴 Codex 如何操作你的程式庫（例如工作流程、測試指令）。
-
這有助於讓 Codex 在處理大型專案時保留語境與一致性。
3. CLI + VS Code 整合
-
在 VS Code 終端機中執行 CLI 任務，例如：
codex run "修復所有 ESLint 警告" -
可以結合擴充套件與 CLI 兩者優點。
🛠 七、常見問題
| 問題 | 解決方式 |
|---|---|
| Codex 不讀專案檔案 | 確認你開啟的資料夾是專案根目錄，且已給予 Full Access 權限。 |
| CLI 登入卡住 | 確認網路與 Node.js 安裝正確，重新執行 codex logout 後再執行 codex login。 |
| 功能不如預期 | 嘗試使用更清楚、具體的 prompt，並透過多輪對話逐步細化需求。 |
🏁 八、結語
透過將 Codex 直接整合進 VS Code 的方式，你可以：
✔️ 在本地 IDE 即時產生、修改程式碼
✔️ 用自然語言實現複雜 refactor 或重構
✔️ 輕鬆生成測試與修復 bugs
✔️ 快速建立大型專案的自動化流程
留言
張貼留言