Codex 可以直接在 VS Code 側邊欄中協助你寫程式、改 Bug、解釋專案與執行命令。

1. 準備工作

開始前請確認：

• VS Code 已更新到較新的穩定版本。
• 你可以正常訪問 OpenAI 網站。
• 專案程式碼已在本地開啟（建議使用 Git 倉庫）。

2. 安裝擴充套件

1. 開啟 VS Code 的擴充套件市集（Extensions）。
2. 搜尋並安裝：Codex - Codex - OpenAI's coding agent。
3. 安裝完成後，依提示完成登入授權。

3. 開啟 Codex 側邊欄

你可以透過任一方式開啟：

• 在編輯器右上角點擊 Open Codex Sidebar。
• 使用命令面板（Ctrl + Shift + P）搜尋 Codex 並開啟。

開啟後，Codex 會讀取目前工作區上下文，進入可對話狀態。

4. 常見使用方式

4.1 讓它解釋程式碼

示例提示詞：

1

請解釋這個檔案的核心邏輯，並指出最可能出錯的 3 個地方。

適合你剛接手舊專案時快速建立全域理解。

4.2 讓它實作功能

示例提示詞：

1
2

在現有 API 裡新增一個 /healthz 健康檢查介面，
要求回傳版本號與資料庫連線狀態，並補上基礎測試。

建議把「輸入約束」與「驗收標準」一起寫清楚，產生結果會穩定很多。

4.3 讓它修復問題

示例提示詞：

1
2

這個介面在併發下偶發 500，請先定位根因，再給出最小改動修復方案，
最後列出回歸測試點。

先「定位」再「修復」，能減少誤改與過度重構。

5. 高品質提示詞模板

你可以直接複用下面這個結構：

1
2
3
4
5
6
7

背景：這是一個 <技術棧> 專案，目前目標是 <目標>
約束：不改動 <模組/介面>，相容 <版本/平台>
輸出：
1) 修改檔案列表
2) 關鍵程式碼說明
3) 驗證步驟
4) 風險與回滾方案

這個模板對「多人協作 + 大專案」非常有幫助。

6. 常見問題

6.1 關於免費額度

在對話框輸入 \，然後選擇「狀態」，會出現額度、重置時間等相關資訊。

6.2 改動不符合預期

修改完成後查看審核按鈕，檢查修改細節；不滿意可選擇撤銷按鈕以回退修改。 在後續步驟中可以把需求拆小，分成多個步驟分別執行。 使用 Git 等程式碼管理工具，保持小步提交（small commits），方便回滾。