Codex 完整教學:App、CLI、IDE、Cloud、權限與工作流(2026)

Codex 怎麼用?從產品介面、安裝、權限到真實 repo 工作流,一篇建立 Codex 的完整使用地圖。

Codex 完整教學:App、CLI、IDE、Cloud、權限與工作流(2026)

Codex 完整教學:App、CLI、IDE、Cloud、權限與工作流

Codex 是 OpenAI 的 coding agent。它不只回答程式問題,還能進入你的專案、讀檔、修改程式、跑指令、測試結果,最後把變更整理給你審核。

真正的差別不是「它會不會寫 code」。現在很多 AI 都會。Codex 有價值的地方,是把讀專案、動手修改、執行驗證、回報結果串成同一個工作流程。

如果你只記得一件事,記這句就好:

Codex 不是幫你把程式打快一點,而是幫你把「理解到驗收」這段流程收在同一個工作台。

Codex 適合拿來做什麼?

Codex 最適合處理有明確專案上下文、可以驗證結果的工作。

任務適合程度原因
讀陌生 repo、整理架構能直接搜尋與讀取多個檔案,不用手動貼上下文。
修 bug、補測試可以修改後立即跑測試,再依結果調整。
小型功能開發適合從需求拆解、實作到驗收。
大型重構中高能做,但要切小範圍並逐步 review。
完全沒有規格的新產品Codex 能實作,產品判斷仍要由人負責。
不看 diff、直接全自動上線AI 能執行,不代表每個決定都正確。

想先理解它為什麼值得用,可以接著看 為什麼 Codex 真正省下的是專案切換成本

Codex App、CLI、IDE Extension、Cloud 差在哪?

四種介面使用的是同一個 Codex 概念,但工作位置不同。

介面最適合特點
Codex App同時規劃、執行、review 多個工作桌面工作台,適合管理 thread、檔案、終端與變更。
Codex CLI熟悉終端機的工程師從目前目錄啟動,速度直接、容易接 shell 工作流。
IDE Extension想在編輯器旁協作編輯 code 時就近提問、修改與 review。
Codex Cloud平行或離線交付任務把工作交給雲端環境執行;目前雲端任務不能自行更換預設模型。

不知道從哪個開始,先看 Codex 四種使用介面的完整差異

Codex 怎麼開始?

新手最容易犯的錯,是一進專案就說「幫我重構全部」。

比較好的第一個任務,是先讓 Codex建立專案地圖:

先不要修改任何檔案。

請讀取目前專案並回答:
1. 主要入口在哪裡?
2. 前端、API、資料庫與設定檔分別在哪裡?
3. 測試怎麼執行?
4. 這個功能最可能涉及哪些檔案?
5. 修改前有哪些風險需要確認?

這個動作看起來慢,後面反而省時間。你不用一邊改、一邊才發現它根本理解錯資料流。

完整安裝與第一個任務流程,請看 Codex 安裝與新手上手教學

一套不容易翻車的 Codex 工作流

我會把 Codex 任務固定拆成五步。

Step 1:先限定目標

不要只寫「幫我優化網站」。改成:

目標:修正手機版結帳頁按鈕被遮住的問題。
範圍:只處理 checkout 頁面與共用 modal。
不要改:付款 API、資料庫 schema、其他頁面的樣式。
驗收:375px 與 430px viewport 都能完整看到按鈕。

Step 2:要求先讀再動

先讓 Codex 說明相關檔案、資料流與修改方案。它判斷錯時,你能在成本最低的地方攔下來。

Step 3:只做最小修改

一次只解一個問題。不要把修 bug、換框架、整理命名、更新依賴包成同一個任務。

Step 4:執行驗證

驗證方式要事先說清楚:

  • 單元測試
  • 型別檢查
  • lint
  • build
  • Playwright 或瀏覽器實測
  • git diff review

Step 5:看結果,不只看摘要

Codex 說「完成」不是驗收。你要確認實際 diff、測試輸出與使用者流程。

Codex 權限怎麼理解?

Codex 能讀寫檔案、執行 shell、使用網路與工具,因此權限設定不是麻煩,是工作邊界。

設定面向作用
Sandbox決定可讀寫哪些路徑、能不能使用網路。
Approval policy決定哪些動作執行前需要你確認。
Workspace trust決定專案內 .codex/config.toml 等設定是否載入。
Hooks / Rules在工具呼叫與修改流程前後加上檢查或限制。

新專案建議先採 workspace write + 需要時詢問。等測試與規則補齊,再逐步放寬,不要第一天就把所有限制拆掉。

Codex 模型怎麼選?

官方目前建議複雜 coding、computer use、研究工作先使用 gpt-5.5;較輕量工作或 subagent 可以考慮 gpt-5.4-mini

你也可以在 ~/.codex/config.toml 設定預設模型:

model = "gpt-5.5"
model_reasoning_effort = "high"

需要接 Ollama、LM Studio、Azure 或 OpenAI-compatible Provider,請看 Codex 自訂模型與 Provider 設定教學

Codex、Claude Code、Cursor 怎麼選?

不用找一個永遠的冠軍,先看你的工作位置。

需求優先考慮
桌面多工作管理、OpenAI 生態Codex
Terminal-first、Claude 工作流成熟Claude Code
編輯器內即時改 code、GUI 優先Cursor

完整選型請看 Codex、Claude Code、Cursor 比較

Codex 適合個人還是團隊?

個人使用時,Codex 最先省下的是找檔案、重複查資料、跑驗證的時間。

團隊導入時,真正重要的是 AGENTS.md、測試、權限、review 與工作切分。沒有這些基礎,AI 只會讓不一致的程式碼更快進入 repo。

導入判斷可以看 Codex 適合誰與團隊導入方式

常見問題

Codex 是 ChatGPT 裡的聊天模型嗎?

不是只靠聊天回答。Codex 是 coding agent 產品,能在授權環境中讀檔、修改、執行指令與驗證工作。

Codex 可以不用寫程式嗎?

可以用自然語言操作,但你仍需要判斷需求、風險與結果。非工程師應從小型、可回復、容易驗收的任務開始。

Codex 可以使用自訂模型嗎?

可以。Codex 能連到支援 Responses API 或 Chat Completions API 的 Provider;官方已把 Chat Completions 支援標記為將淘汰,新的設定應優先使用 Responses API。

Codex App、CLI、IDE 的設定共用嗎?

Codex App、CLI、IDE Extension 會共用 Codex 的設定層。個人預設放在 ~/.codex/config.toml,專案設定可放在可信任 repo 的 .codex/config.toml

Codex 能完全自動寫完並上線嗎?

技術上能串成高度自動化流程,但正式環境仍應保留測試、review、權限與部署檢查。

官方資料

想用 AI 規劃你的網站專案?

把需求講清楚,我們用 AI 規劃 + 人工審閱,給你務實的建議。

MO DESIGN STUDIO

我們專注品牌網站設計、行銷著陸頁與整合式 CMS 流程,協助團隊打造有感的線上體驗。

← 返回部落格