使用 IDE 命令

Codex IDE extension commands 可以讓你從 VS Code Command Palette（命令面板）控制 Codex，也可以繫結成 keyboard shortcuts（快捷鍵）。

這些命令不是 prompt 模板，而是編輯器級操作：把選區加入當前 thread、把當前檔案加入 thread、新建 thread、開啟 sidebar、建立 Codex panel、處理待辦註釋。它們的價值在於減少上下文搬運，讓你在程式碼附近直接組織任務。

flowchart LR
    Cmd["Codex IDE 命令"]
    A["📥 喂上下文<br/>addToThread<br/>addFileToThread"]
    B["🪟 切任務空間<br/>newChat<br/>newCodexPanel<br/>openSidebar"]
    C["🛠 做區域性任務<br/>implementTodo"]
    Cmd --> A
    Cmd --> B
    Cmd --> C
    A -.->|高頻| KEY1["建議綁快捷鍵"]
    B -.->|中頻| KEY2["保持預設 / 自定義"]
    C -.->|按團隊習慣| KEY3["可選繫結"]

分配快捷鍵

給 Codex command 分配或修改 key binding（快捷鍵）：

1. 開啟 Command Palette。macOS 用 Cmd+Shift+P，Windows / Linux 用 Ctrl+Shift+P。
2. 執行 Preferences: Open Keyboard Shortcuts。
3. 搜尋 Codex 或 command ID，例如 chatgpt.newChat。
4. 選擇 pencil icon（鉛筆圖示），輸入你想繫結的快捷鍵。

擴充套件命令

命令怎麼用

addToThread

chatgpt.addToThread 把當前選中的程式碼範圍加入當前 thread。

適合：

• 讓 Codex 解釋一段複雜函式。
• 讓 Codex 基於一段錯誤實現做最小修復。
• 讓 Codex 對一個 diff 片段給 review。

使用時不要一次選太多。更好的方式是先選關鍵函式、錯誤堆疊對應程式碼、型別定義或測試斷言，再用文字說明目標。

示例任務：

这段函数在空数组时返回了错误状态。请只修改这里相关逻辑，并补一个覆盖空数组的测试。

addFileToThread

chatgpt.addFileToThread 把整個檔案加入當前 thread。

適合：

• 檔案本身不長，且函式之間強相關。
• 你需要 Codex 理解元件、hook、測試檔案的完整結構。
• 你要讓 Codex 對單檔案做重構建議。

不適合：

• 超長檔案，尤其是包含生成程式碼、快照、依賴鎖檔案。
• 你只需要其中一個函式或一個型別定義。
• 涉及多個檔案的架構問題，這時應該用 @file 或讓 Codex 自己檢索專案。

newChat

chatgpt.newChat 建立新 thread。macOS 預設是 Cmd+N，Windows / Linux 預設是 Ctrl+N。

當任務目標、上下文範圍、風險等級發生變化時，應該開新 thread。例如：

• 從“解釋程式碼”切換到“修改程式碼”。
• 從一個 bug 切換到另一個 bug。
• 從本地小修切換到 cloud delegation。

繼續在舊 thread 裡塞無關任務，會讓上下文變髒，也會讓 Codex 更容易沿用不再適用的假設。

implementTodo

chatgpt.implementTodo 讓 Codex 處理選中的待辦註釋。

適合把明確、區域性、可驗證的待辦交給 Codex，例如：

// 待办：读取 items[0] 前先处理 empty response

不適合把模糊的產品需求寫成待辦註釋後直接交給 Codex，例如：

// 待办：make this better

如果待辦註釋不夠清楚，先補充約束：期望行為、不能改的邊界、驗證方式，再讓 Codex 實施。

newCodexPanel

chatgpt.newCodexPanel 建立新的 Codex panel。

適合並行觀察兩個任務：

• 一個 panel 保持當前實現任務。
• 另一個 panel 做只讀解釋或方案比較。

不要用多個 panel 同時修改同一組檔案。需要並行時，應該明確檔案邊界，否則容易產生衝突。

openSidebar

chatgpt.openSidebar 開啟 Codex sidebar panel。

適合繫結成快捷鍵，用來快速回到 Codex 面板。它不會自動傳送 prompt，也不會改變當前許可權。

推薦快捷鍵策略

常見工作流

解釋陌生程式碼

1. 選中關鍵函式。
2. 執行 chatgpt.addToThread。
3. 提問：這段程式碼輸入、輸出、副作用和失敗模式分別是什麼？
4. 如果需要更多上下文，再加入呼叫方或測試檔案。

修復一個小 bug

1. 選中錯誤函式或失敗測試。
2. 執行 chatgpt.addToThread。
3. 描述現象、期望行為、驗證命令。
4. 讓 Codex 先給修改計劃，再執行。
5. 讓 Codex 跑對應測試並解釋 diff。

從待辦到補丁

1. 確認待辦註釋寫得具體。
2. 選中待辦註釋。
3. 執行 chatgpt.implementTodo。
4. Review Codex 的修改範圍。
5. 跑最小測試，必要時補測試。

多執行緒但不衝突

1. 用 newCodexPanel 開一個只讀 panel 做解釋或調研。
2. 保持另一個 panel 專注當前修改任務。
3. 不讓兩個 panel 同時寫同一批檔案。
4. 合併上下文時，用人工總結，而不是直接讓兩個 thread 混在一起。

失敗模式

自檢清單

• 你是否至少會用 addToThread 和 addFileToThread 精準提供上下文？
• 新任務是否會用 newChat 隔離舊上下文？
• 待辦註釋是否足夠具體，能讓 Codex 直接驗證完成狀態？
• 多 panel 是否只用於獨立任務或只讀分析？
• 快捷鍵是否避免覆蓋 IDE 原有高頻操作？

官方資料

• OpenAI Codex IDE extension
• Codex IDE extension commands
• Codex IDE extension slash commands

接下來去哪