註冊
ChatGPTCodex

Codex VS Code 擴展怎麼裝、不加載怎麼辦：側邊欄入口、Windows 缺 C++ 工具、WSL 設定和登入方式

Codex 的 VS Code 擴展 ID 是 openai.chatgpt，裝好後點側邊欄的 Codex 圖標，看不到就用命令面板運行 Codex: Open Codex Sidebar。本文按官方文檔整理安裝、登入、不加載時的排查：Windows 缺 C++ 工具、WSL 設定、啟動設定。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-10-28 · 依據官方文檔與公開資料整理 Plus 帳號
本文根據 Codex 官方文檔《Codex IDE extension》《IDE extension settings》《Windows sandbox》《Authentication》整理，資料核對於 2026-10-28。官方沒有「擴展不加載」的專門排查頁，本文按官方入口和設定整理。配圖為本站整理的示意圖，不是軟件截圖。

適用於誰

  • 想在 VS Code（或 Cursor、Windsurf）裏裝 Codex 的人；
  • 裝好了但側邊欄沒有 Codex，或點了沒反應的人；
  • 在 Windows 或 WSL 裏用的人。

結論先說

  1. 官方擴展的 ID 是 openai.chatgpt，VS Code、Cursor、Windsurf 都用這個擴展。
  2. 打開方式：點側邊欄的 Codex 圖標；看不到圖標，就打開命令面板，運行 Codex: Open Codex Sidebar。
  3. 登入：未登入介面選 Sign in with ChatGPT，或選 Use API Key，輸入密鑰後點 OK。
  4. Windows 上裝好但沒反應：官方說可能是系統缺 C++ 開發工具，需要 Visual Studio Build Tools（C++ 工作負載）和 Microsoft Visual C++ Redistributable（x64），裝好後完全重啟 VS Code。
  5. 項目在 WSL 裏：設定 chatgpt.runCodexInWindowsSubsystemForLinux，改動會重新加載 VS Code。

在 VS Code 裏裝 Codex 擴展

圖：本站根據 Codex 官方文檔：Codex IDE extension 整理的示意圖

一、安裝和打開

官方步驟：安裝或啟用 Codex 後，登入，在編輯器裏開始對話。VS Code 及兼容的編輯器用 Codex 擴展；Xcode 和 JetBrains IDE 提供各自的集成。

  • Xcode：打開編碼助手，新建對話，選 Codex 作為智能體；
  • JetBrains：打開 AI Chat 並選 Codex；
  • 開始第一個對話時，官方建議先在任務前後做 Git 檢查點，方便撤銷改動。

登入方式的區別（ChatGPT 帳號與 API 密鑰）見 /guides/codex-cannot-sign-in-send-message-connect；入門總覽見 /guides/codex-getting-started。

二、不加載、沒反應，逐項排查

Codex 擴展不加載：對照排查

圖：本站根據 Codex 官方文檔 整理的示意圖

1. 側邊欄沒有圖標

官方寫明：圖標不可見時，用命令面板運行 Codex: Open Codex Sidebar。想讓每次啟動 VS Code 都自動聚焦 Codex 側邊欄，把設定 chatgpt.openOnStartup 設為 true（預設是 false）。設定在 VS Code 裏搜尋 @ext:openai.chatgpt 或設定名即可，也可以在擴展的齒輪圖標裏選 Codex Settings > Open config.toml 打開配置文件。

2. Windows 上裝好了但沒反應

官方《Windows sandbox》裏的「IDE extension is installed but unresponsive」：系統可能缺 C++ 開發工具，部分原生依賴需要它。需要裝 Visual Studio Build Tools（C++ 工作負載）和 Microsoft Visual C++ Redistributable（x64）。官方給的 winget 命令是 winget install --id Microsoft.VisualStudio.2022.BuildTools -e。裝完後要完全重啟 VS Code。沙箱本身的問題見 /guides/codex-windows-sandbox-setup-failed。

3. 項目在 WSL 裏

設定 chatgpt.runCodexInWindowsSubsystemForLinux（僅 Windows，預設 false）：在 WSL 可用時讓 Codex 跑在 WSL 裏，適合倉庫和工具鏈在 WSL2 的情況，修改後會重新加載 VS Code。

4. 想用插件，但 IDE 裏沒有

官方明確：IDE 擴展不支持插件，要瀏覽和安裝插件，用桌面 App 或命令行，見 /guides/codex-plugins-where-to-install。

5. 其他常用設定

官方列了幾個擴展設定：chatgpt.commentCodeLensEnabled 在 TODO 註釋上方顯示 CodeLens；chatgpt.followUpQueueMode 決定運行中發的消息是排隊（queue）還是插入當前回合（steer）；chatgpt.composerEnterBehavior 決定 Enter 是否直接發送；chatgpt.localeOverride 設介面語言，留空自動檢測；chatgpt.cliExecutable 只用於開發，手動覆蓋內置的可執行文件可能讓擴展的部分功能失效。這些 chatgpt.* 設定屬於擴展，不寫進 config.toml。

三、和桌面 App 同時用

官方說明：桌面 App 和 IDE 擴展在同一項目裏打開時，會共享活動對話和編輯器上下文；在 App 輸入框打開 IDE context 就能讓 Codex 用你編輯器裏打開的文件。提示「This is open in another app」的情況見 /guides/codex-vscode-open-in-another-app。

常見問題

Q：擴展登入後沒有額度？

額度按你的 ChatGPT 套餐算，見 /guides/codex-usage-limits；想開通 Plus 可以看 /chongzhi/chatgpt-plus。

Q：Cursor 裏能裝嗎？

官方文檔把 Cursor 列在可裝擴展的編輯器裏，同樣用 openai.chatgpt。Cursor 自己的功能和 Codex 的對比見 /guides/cursor-vs-claude-code-vs-codex。

Q：其他報錯怎麼對照？

見 /guides/codex-common-errors-summary。

參考資料

  • Codex 官方文檔：Codex IDE extension — https://learn.chatgpt.com/docs/codex/ide
  • Codex 官方文檔：IDE extension settings — https://learn.chatgpt.com/docs/developer-settings
  • Codex 官方文檔：Windows sandbox — https://learn.chatgpt.com/docs/windows/windows-sandbox
  • Codex 官方文檔：Authentication — https://learn.chatgpt.com/docs/auth
需要開通或續費？ChatGPT Plus 充值 →

Nathaniel 的更多內容

  1. 01

    ChatGPT Plus 和 Business 怎麼選：從個人角度看，一個人用、和同事共用、個人聊天遷移分別怎麼辦

    一個人用選 Plus 還是 Business？官方的區別是：Plus 是個人訂閱，Business 是組織的共享工作區，至少 2 個付費席位，數據不用於訓練。本文從個人視角整理幾種情況怎麼選，以及加入 Business 後個人帳號和聊天怎麼處理。

    ChatGPT0
  2. 02

    Codex 新手第一天：從開通到第一個任務，安裝、登入、權限、額度和準備清單

    第一次用 Codex 怎麼上手？官方的流程是：有 ChatGPT 帳號，安裝桌面 App、CLI 或 IDE 擴展，登入，選一個項目文件夾，發一個小任務，任務前後用 Git 做檢查點。本文按官方文檔整理第一天的步驟和準備清單。

    ChatGPTCodex0
  3. 03

    Codex 怎麼讀 AGENTS.md：全局和項目的讀取順序、override 文件、32 KiB 上限，以及沒生效怎麼排查

    Codex 在開始工作前會讀 AGENTS.md。官方寫明讀取順序：先全局（~/.codex），再從項目根逐級走到當前目錄，每個目錄最多一個文件，後面的覆蓋前面的，合併大小預設上限 32 KiB。本文只講 Codex 的讀取規則和排查。

    ChatGPTCodex0
  4. 04

    Codex Cloud（雲端任務）怎麼用：創建環境、發佈、開始第一個雲端任務，以及什麼時候該用雲端

    Codex Cloud 讓編碼任務在 OpenAI 託管的電腦上運行，電腦睡眠時也能繼續，可在網頁、手機、桌面 App 上開始和繼續。本文按官方文檔整理創建並發布環境、開始第一個任務的步驟，以及雲端和本地怎麼選。

    ChatGPTCodex0
  5. 05

    Codex 怎麼切換模型和思考強度：命令行 /model、桌面 App 模型選擇器、config.toml 預設值與官方選擇建議

    Codex 怎麼換模型、調思考強度？命令行裏輸入 /model 回車選擇，用 /status 確認；桌面 App 用模型選擇器；想固定預設值在 config.toml 裏設 model。本文按官方文檔整理步驟，並附官方對 Luna、GPT-6.1 Sol、Astra 的選擇建議。

    ChatGPTCodex0
  6. 06

    Codex 命令行常用命令一頁看：codex、exec、resume、review、cloud 和會話裏的斜槓命令（官方文檔列出的）

    Codex CLI 有哪些常用命令？本文只寫官方命令參考裏列出的：codex、exec、resume、review、cloud 等，以及會話裏的 /model、/status、/compact、/diff 等斜槓命令和快捷鍵。

    ChatGPTCodex0

同產品的其他教學

  1. 01

    Codex 命令被自動審核拒絕怎麼辦：Auto-review 是什麼、/approve 怎麼放行、連續被拒為什麼會中斷

    Codex 的命令被 Auto-review 自動審核拒絕，不是普通的沙箱報錯。官方說明：審核智能體拒絕後，主智能體要改用更安全的做法或停下問你；命令行裏可用 /approve 對被拒動作批准重試一次；連續被拒會觸發斷路器中斷回合。

    ChatGPTCodex0
  2. 02

    Codex VS Code 提示「This is open in another app」怎麼辦：App 和 IDE 擴展同步對話的官方規則

    Codex VS Code 擴展提示 This is open in another app？官方沒有逐字解釋這句話，但文檔寫明桌面 App 和 IDE 擴展在同一項目裏會共享活動對話和編輯器上下文，並支持互相打開對話。本文按官方同步規則整理合理的處理辦法。

    ChatGPTCodex0
  3. 03

    ChatGPT 生圖怎麼做透明背景：官方怎麼說、提示怎麼寫、沒做出來怎麼排查，以及 API 的 png 與 webp 要求

    ChatGPT 生圖能做透明背景嗎？官方幫助中心寫明 ChatGPT Images 可以按指令讓背景透明。本文整理官方步驟、局部編輯方法、提示寫法，以及開發者用 API 時必須設定 background 為 transparent 並用 png 或 webp。

    ChatGPT0
  4. 04

    ChatGPT Business 和 Pro 的區別：一個面向團隊、一個面向個人，席位、價格、GPT-6 Pro 額度和數據訓練對比

    ChatGPT Business 和 Pro 怎麼選？官方的區別是：Business 是組織用的共享工作區，按席位計費，至少 2 席，數據不用於訓練；Pro 是個人訂閱，分 100、200、500 三檔。本文按官方頁面整理，價格標注 2026-10 查詢。

    ChatGPT0
  5. 05

    ChatGPT Business 怎麼開通、怎麼加成員：席位、角色、邀請和 CSV 批量導入的官方步驟

    ChatGPT Business（原 Team）怎麼開通、怎麼邀請同事？官方步驟是登入後選 Business、選席位和計費方式、結帳，再到工作區設定的 Members 裏邀請。本文按官方幫助中心整理席位、角色和批量導入，價格標注 2026-10 查詢。

    ChatGPT0
  6. 06

    ChatGPT 和 Codex 合併了嗎、是什麼關係：新桌面 App 裏的 Chat、Work、Codex 三個入口怎麼分

    ChatGPT 和 Codex 合併了嗎？官方的說法是：新的 ChatGPT 桌面 App 把 Chat、Work 和 Codex 放在同一個 App 裏，但 Codex 仍是獨立視圖，歷史分開，網頁和手機上不能選 Codex。本文按官方幫助中心整理它們的關係和各自的用法。

    ChatGPTCodex0

0 條評論

登入 後參與評論

還沒有評論，來搶沙發～