Codex 完整教學:App、CLI、IDE、Cloud、權限與工作流(2026)
Codex 怎麼用?從產品介面、安裝、權限到真實 repo 工作流,一篇建立 Codex 的完整使用地圖。

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 diffreview
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 規劃 + 人工審閱,給你務實的建議。
Related Reading
延伸閱讀

AI 工程
Codex vs Claude Code vs Cursor:AI Coding Agent 怎麼選(2026)
Codex、Claude Code、Cursor 怎麼選?這篇比較桌面工作台、terminal、IDE、模型與 Provider、權限、團隊工作流,依工程師、接案者與非工程背景使用者給出選型建議。

技術
GPT Image-2 怎麼用?Kie AI 生成圖片、API 串接與模型比較(2026)
GPT Image-2 是 OpenAI 的最新圖像生成與編輯模型。本文教你用 Kie AI 跑 GPT Image-2,包含網頁版使用邏輯、createTask API、callback、R2 保存、prompt 公式與模型比較。

WordPress
我們自己的網站換過三次主機:搬家前該知道的三件事
自家官網換過三次主機,加上客戶案的搬遷,Cloudways、Zeabur、SiteGround 都經手過。這篇不比規格,講三件搬過才知道的事:最麻煩的是圖片、搬家是升級的最好時機、以及理論上沒有搬不動的站。