Codex 入門教學:在 ChatGPT 裏用 Codex 寫代碼(網頁版 / CLI / IDE)

OpenAI Codex 有網頁版(雲端)、命令行 CLI、IDE 插件和桌面 App 幾種用法。本文講清怎麼選、怎麼裝、怎麼用 ChatGPT 帳號登入,並跑通第一個任務。

NNathaniel bigo··原創首發·AI 輔助撰寫
12 分鐘讀完
資料核對於 2026-10-07 · 依據官方文檔與公開資料整理 Plus 帳號
本文根據 OpenAI 官方文檔(原 developers.openai.com/codex,現已遷到 learn.chatgpt.com/docs)和官方 GitHub 倉庫整理,核對日期 2026-10-07;截圖引用自官方頁面和公開教學並註明出處。Codex 更新很快,入口名稱和額度以官方說明為準。

適用於誰

  • 已有 ChatGPT 帳號(尤其是 Plus / Pro),想讓 AI 直接幫你寫代碼、修 bug、做代碼審查的人。
  • 搜「chatgpt 怎麼用 codex」「codex 教學」,分不清網頁版、CLI、插件有什麼區別的新手。
  • 會用 Git 最好;不會也能先從 IDE 插件或桌面 App 開始。

結論先說

  1. Codex 是 OpenAI 的編程智能體,用 ChatGPT 帳號登入即可使用,不必單獨申請 API Key。
  2. 怎麼選:
  • 代碼在 GitHub 上、想讓它在雲端慢慢幹活並提 PR → 網頁版(雲端,Codex Cloud);
  • 習慣終端、想讓它在本機讀寫文件、跑命令 → CLI;
  • 主要在 VS Code / Cursor / Windsurf 裏寫代碼 → IDE 插件。
  1. 套餐差別:官方定價頁寫 Free 和 Go 也包含 Codex,但只是「有限」使用,主要在 ChatGPT 桌面 App 裏(官方註明逐步開放);網頁雲端、CLI、IDE 插件這些完整入口從 Plus 起提供。各入口共用同一份套餐額度。
  2. 不管哪種方式,先讓它解釋項目,再給一個小任務,看完改動再合併。

步驟

方式一:網頁版(雲端運行,Codex Cloud)

按 2026-10 的官方文檔,雲端任務的入口在 ChatGPT 裏:

  1. 在網頁版或桌面 App 打開 ChatGPT 並登入(官方 GitHub README 裏的 chatgpt.com/codex 入口連結仍然保留)。
  2. 新建任務時選擇 Work in → Cloud,打開 Select environment。已有環境直接選;沒有就點 Create environment。
  3. 選擇要處理的 GitHub 倉庫並點 Get started,首次會提示連接 GitHub。Codex 會自己檢查倉庫、安裝依賴和工具、試跑流程,缺什麼資訊會在對話裏問你。
  4. 看一遍它準備好的配置和測試結果,儲存後點 Publish,等出現「Environment published」。之後每個任務都從這個環境的快照開始,各自有獨立的工作區,可以同時開好幾個,電腦關機也不影響。
  5. 點 Start a new task,用中文描述需求,例如「找出登入接口沒有做參數校驗的地方並補上,附帶測試」。
  6. 任務完成後查看改動的文件和測試結果,不滿意就繼續追加要求;滿意後提交或創建 Pull Request,在 GitHub 上審核合併。

Codex 網頁版 2025 年發佈時的官方配圖:輸入任務、選擇倉庫和分支,下方是任務列表

圖片來源:OpenAI 官方公告《Introducing Codex》。這是早期介面,現在的入口是 ChatGPT 裏的 Work in → Cloud,介面以實際為準。

官方配圖:雲端任務完成後的結果頁,包含改動摘要、測試結果和改動文件列表

圖片來源:OpenAI 官方公告《Introducing Codex》(早期介面)

據第三方教學(Flavio Copes,2026-10)介紹,舊版「手寫環境配置腳本」的體驗現在叫 Codex Cloud (Legacy),網上較早的教學如果讓你粘貼 setup 腳本,說的就是舊版。雲端功能需要 ChatGPT 帳號,只用 API Key 登入時沒有云端功能(官方定價頁)。

方式二:Codex CLI(命令行)

安裝(來自官方 GitHub README 和 CLI 文檔):

Mac / Linux:

bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows(在新開的 PowerShell 窗口裏運行):

powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

也可以用包管理器:

bash
npm install -g @openai/codex
# 或(macOS)
brew install --cask codex

用安裝腳本或 npm 裝的,想更新時再運行一遍同一條安裝命令即可;Homebrew 用 brew upgrade --cask codex。npm 包聲明的 Node.js 版本要求是 16 及以上(npm 包資訊裏的 engines 字段),官方 README 沒有單獨寫 Node 要求。

在 Windows PowerShell 裏運行官方安裝命令,提示 Codex CLI 安裝成功

圖片來源:Analytics Vidhya

登入與第一個任務:

bash
cd 你的項目文件夾
codex

首次啟動會列出幾種登入方式:Sign in with ChatGPT(瀏覽器登入,用套餐額度)、Sign in with Device Code(在另一台裝置上用一次性代碼登入)、Provide your own API key(按 API 用量計費)。新手選第一項,在瀏覽器裏完成登入即可。

Codex CLI 首次啟動時的登入方式選擇

圖片來源:Analytics Vidhya

然後直接輸入:

text
介紹一下這個項目的結構和入口文件

官方示意圖:在 Codex CLI 裏讓它解釋代碼庫,它會先列計劃再去讀文件

圖片來源:openai/codex 官方 GitHub 倉庫

官方建議在任務前後各做一次 Git 提交,方便出問題時回退。

常用命令:

命令作用
/init生成 AGENTS.md,寫入給 Codex 的項目說明
/permissions設定它改文件、跑命令前要不要問你(例如在 Auto 和 Read Only 之間切換)
/model切換模型和推理強度
/review審查當前改動、找問題
/status查看當前會話配置和 token 用量
codex resume回到當前倉庫之前的對話
codex exec "任務"非交互模式,適合腳本和自動化

也支持用 API Key 登入,但需要額外配置,而且沒有云端相關功能,新手建議直接用 ChatGPT 帳號。

方式三:IDE 插件(VS Code / Cursor / Windsurf)

  1. 在 VS Code 擴展市場搜尋 Codex,認準發佈者 OpenAI、擴展 ID openai.chatgpt;Cursor、Windsurf 用的是同一個擴展。
  2. 安裝後點側邊欄的 Codex 圖標;找不到就打開命令面板運行 Codex: Open Codex Sidebar,然後用 ChatGPT 帳號登入。
  3. 打開文件或選中一段代碼後提問,它可以直接引用當前文件和選中內容,改動在編輯器裏以 diff 形式審閱,只保留你想要的部分。
  4. 大任務可以從插件裏交給雲端去跑,跑完回到編輯器裏看結果。

官方配圖:IDE 裏的 Codex 面板(右側)和它給出的多文件改動 diff(左側)

圖片來源:OpenAI Codex IDE 擴展官方文檔

JetBrains IDE 和 Xcode 有各自的原生集成(JetBrains 在 AI Chat 裏選 Codex,Xcode 在編碼助手裏選 Codex)。另外,現在的「Codex 桌面 App」已經併入 ChatGPT 桌面 App(macOS / Windows,Linux 另有安裝說明),在 App 裏選 Codex 即可;CLI 裏運行 codex app 會打開已安裝的桌面 App,沒裝則啟動安裝程序。

任務描述怎麼寫效果更好

  • 說清楚範圍:指明文件或模組,例如「只改 src/auth 目錄,不要動數據庫結構」。
  • 說清楚驗收標準:例如「改完後運行測試命令,全部通過再交付」。項目的測試命令最好寫進 AGENTS.md,它就能自己去跑。
  • 一次一件事:一個任務只解決一個問題,結果更容易審核,也更省額度。
  • 先審再合併:不論哪種方式,都要自己看一遍改動;雲端任務的 PR 也建議走正常的代碼審查流程。

常見問題

Q:免費帳號能用 Codex 嗎?

能用一部分。官方定價頁把 Free 和 Go 的 Codex 標為「有限」,說明裏寫的是在桌面 App 裏使用(逐步開放);網頁雲端、CLI、IDE 插件從 Plus 起提供,CLI 登入介面上也寫着「Plus、Pro、Business、Enterprise 套餐包含用量」。想要完整入口和更高額度可以開通 Plus:/chongzhi/chatgpt-plus。

Q:Windows 上 PowerShell 提示禁止運行腳本?

官方命令裏已經帶了 -ExecutionPolicy ByPass,請完整複製那一整行,不要只複製引號裏的部分。另外,官方倉庫的安裝說明文檔裏系統要求一欄仍寫着「Windows 11 通過 WSL2」,和 README 提供的 PowerShell 原生安裝命令不完全一致;原生安裝遇到問題時可以改在 WSL2 裏用 Mac / Linux 那條命令,以官方說明為準。

Q:額度怎麼算?

官方定價頁說明:Plus 和 Business 標準版按每 5 小時給出一個用量估算範圍,可能另有每週上限;Pro 目前沒有 5 小時限制。本地對話和雲端任務共用同一份額度,雲端任務通常消耗更多。同樣的任務消耗也可能不同,模型選擇、上下文長度、推理強度、工具調用都會影響用量,具體以 ChatGPT 裏的用量面板為準。

Q:Codex 和 ChatGPT 聊天裏直接讓它寫代碼有什麼不同?

聊天只是給你代碼片段;Codex 能讀整個倉庫、直接改文件、運行測試,並以 diff / PR 的形式交付。

Q:AGENTS.md 有什麼用?

相當於給 Codex 的「項目說明書」:怎麼構建、怎麼測試、代碼規範。寫一次,之後每次任務都會參考。

參考資料

  • Codex 官方倉庫(安裝命令):https://github.com/openai/codex
  • Codex CLI 文檔:https://learn.chatgpt.com/docs/codex/cli
  • Codex IDE 插件文檔:https://learn.chatgpt.com/docs/codex/ide
  • Codex 雲端文檔:https://learn.chatgpt.com/docs/cloud
  • Codex 套餐與額度:https://learn.chatgpt.com/docs/pricing
  • 命令參考:https://learn.chatgpt.com/docs/developer-commands
  • ChatGPT 桌面 App:https://learn.chatgpt.com/docs/app
  • ChatGPT 套餐對比:https://chatgpt.com/pricing
  • 截圖來源:OpenAI《Introducing Codex》、openai/codex README、Codex IDE 文檔、Analytics Vidhya《How to Install Codex CLI》
需要開通或續費?ChatGPT Plus 充值 →

Nathaniel 的更多內容

  1. 01

    AI 學習路線:零基礎從哪開始,6 個階段、每階段該讀哪幾篇教學(2026)

    AI 學習路線怎麼走?給零基礎的人一條循序漸進的路徑:先選一個助手用順,再學提問,再用進日常工作,按需學做圖做影片,守住私隱與版權,最後進階自動化和編程。每個階段都配了本站對應的教學。

    其他 AI 工具0
  2. 02

    AI 瀏覽器有哪些:Perplexity Comet、Opera Neon、Dia、Brave Leo 與 Edge Copilot 的官方說法對照

    AI 瀏覽器有哪些?按官方頁面整理 Perplexity Comet、Opera Neon、Dia、Brave Leo 和 Edge 裏的 Copilot:官方自述的定位、支持的平台、免費還是訂閱,以及 Gemini、Claude 的 Chrome 方案和已停用的 ChatGPT Atlas。

    其他 AI 工具0
  3. 03

    即夢國際版 Dreamina 是什麼:官方站入口、能生成什麼、免費積分和模型(2026)

    即夢國際版 Dreamina 是什麼?官方站是 dreamina.capcut.com,是一個圖片、影片和數字人一體的 AI 創作平台。按官方首頁和 FAQ 講:能生成什麼、免費用戶每天 120 積分、列出的 Seedance 與 Seedream 模型,以及和國內即夢怎麼區分。

    其他 AI 工具0
  4. 04

    Kimi K3 Coding Plan 是什麼、怎麼用:Kimi Code 會員、模型 ID、套餐價格和額度規則

    Kimi K3 Coding Plan 是什麼?按 Kimi 官方文檔核對:官方現在叫 Kimi Code,是 Kimi 會員權益裏的編程服務,Plus 及以上才有;講 K3 等模型 ID、國內新套餐價格、三種客戶端、第三方工具接入和額度規則。

    Kimi0
  5. 05

    DeepSeek V4 Pro 和 Flash 的區別與 API 價格:官方價格頁逐項對照(高峰與空閒時段)

    DeepSeek V4 Pro 和 Flash 有什麼區別、API 怎麼收費?按 DeepSeek 官方價格頁(2026-10-19 查詢)列出兩個模型的版本、上下文、圖像理解、並發和每百萬 token 價格,說明高峰與空閒時段的計費差別和舊模型名怎麼處理。

    其他 AI 工具0
  6. 06

    GPT-6 Pro(Astra)怎麼用、哪些套餐有:怎麼選到 Pro 檔、用量限制和 Pro 三檔價格

    GPT-6 Pro(Astra)怎麼用、哪些套餐有?按 OpenAI 幫助中心核對:聊天裏 Pro 檔給 Pro 100、Pro 200、Business 和 Enterprise;Plus 在 Work 和 Codex 裏含 Astra。講怎麼選到、用量上限和官方 Pro 價格。

    ChatGPT0

同產品的其他教學

  1. 01

    ChatGPT 搜尋怎麼用:聯網搜尋、查看來源與結果不準怎麼辦

    ChatGPT 能聯網搜尋最新資訊並附上來源連結。本文按官方幫助中心講清怎麼手動開啟搜尋、怎麼看引用來源、本地結果不準的原因(位置設定)、搜尋按鈕不見了怎麼排查,以及什麼時候該用深度研究。

    ChatGPT0
  2. 02

    ChatGPT 出現 network error 怎麼辦:長回答中斷、連接失敗與公司網絡的處理方法

    ChatGPT 提示 A network error occurred 或 websocket 連接錯誤、長回答寫到一半斷掉?本文按官方幫助中心講清原因、個人排查步驟,以及公司網絡需要放行的域名、WebSocket 和語音端口。

    ChatGPT0
  3. 03

    AI商品圖怎麼做:從實拍原圖到白底圖、場景圖、模特圖的完整流程

    用 AI 做電商商品圖,怎麼既好看又不「貨不對板」?本文按 OpenAI、Google 官方提示指南整理一套流程:拍好原圖 → 摳圖白底 → 場景合成 → 模特上身 → 檢查細節,附提示詞模板,並提醒廣告法對商品展示真實性的要求。

    ChatGPT其他 AI 工具0
  4. 04

    AI 做 PPT 哪個好:直接生成文件、Office 插件、Google 幻燈片、專用工具四條路線對比

    AI 做 PPT 用哪個?不排名,按官方文檔對比四條路線:在 ChatGPT / Claude 對話裏直接生成 pptx、用 PowerPoint 裏的 AI 插件、用 Google 幻燈片裏的 Gemini、用 Gamma 等專用工具;講清各自能不能編輯、套不套得了模板、適合什麼場景,並給出通用的五步做法。

    ChatGPTClaude0
  5. 05

    Codex CLI 怎麼安裝、怎麼更新:官方 4 種安裝命令(腳本、npm、Homebrew)、查看版本和 codex update

    Codex CLI 怎麼裝、怎麼更新?官方有 macOS/Linux 與 Windows 的安裝腳本、npm、Homebrew 四種方式,更新多是重跑同一條命令。本文原樣列出官方命令,講查版本、codex update 和首次登入。

    ChatGPTCodex0
  6. 06

    ChatGPT 公式怎麼複製到 Word、公式亂碼怎麼辦:用 Word 自帶的 LaTeX 輸入,什麼寫法會不識別

    ChatGPT 給的公式粘進 Word 亂碼?Word(Microsoft 365)支持 LaTeX 輸入:Alt + = 插入公式區,格式選 LaTeX,粘貼後轉成專業格式。按微軟文檔講步驟、寫法對照和不識別的關鍵詞。

    ChatGPT0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~