11 min給工具使用者

Codex 教學:安裝、第一個任務與權限

第一次用 Codex,先選 App 或 CLI 並開啟獨立練習資料夾。本篇用虛構客服素材,逐步完成只讀核對、規劃、限縮寫入、欄位與來源驗收、保留 v1 修訂 v2,以及出錯後從乾淨 inputs 復原。

Aaron Huang系統、產品與 AI 實作

第一次用 Codex,先選一個可重做的練習資料夾,把讀取範圍和輸出檔名寫清楚,核對它看到了什麼,再讓它寫入;最後以原始資料、來源編號與保留的舊版驗收。這篇的客服練習包已附固定輸入、預期答案與 v1/v2 實際成果,可逐欄比對。

Codex 適合處理「有明確範圍、能由人驗收」的工作:讀一組檔案、整理出交接表、指出缺漏,或在指定專案修改程式。這次把工作拆成讀取、計畫、寫入、核對與修訂五個步驟;詳細權限、備份與工作交付判斷可接著閱讀文末的系列指南。

先選入口:App 重視可見操作,CLI 重視資料夾與命令列

如果你想用圖形介面選資料夾、查看變更,從 ChatGPT 桌面 App 內的 Codex 開始;如果你平常已在 PowerShell 或終端機工作,從 Codex CLI 開始。兩者的共同要求是:開啟的必須是練習資料夾,不是桌面、下載資料夾或公司共享磁碟的上層。

入口 適合的第一種工作 開始時要確認
ChatGPT 桌面 App 想以圖形介面選資料夾、看計畫與變更的人 目前工作區、選到的資料夾、任何寫入或命令請求
Codex CLI 已習慣在終端機進入專案資料夾的人 PowerShell 目前路徑,再啟動 codex
IDE 整合 已在支援的編輯器開發專案的人 開啟的是正確 workspace,而非整個磁碟

官方產品與安裝入口會隨帳號、產品版本和作業系統調整,開始前以 OpenAI Codex 文件 和 Codex CLI 文件 為準。公司裝置先遵守組織規定;不要為了安裝而停用安全控制。

Codex 新手工作流程:選入口、開啟小型專案、描述交付與限制、先檢視計畫與權限、核對檔案變更和檢查結果。

自製圖解:Gwarket / Aaron Huang · CC BY 4.0 ·

安裝、登入與費用:只設定這次練習需要的路徑

App 路徑:安裝後只開練習資料夾

從 ChatGPT 下載頁 安裝桌面 App,登入後選 Codex。建立或開啟本篇的練習資料夾時,先確認畫面顯示的完整路徑;若它顯示的是上層資料夾,返回重選。第一次練習不需要連接雲端服務、公司資料或瀏覽器帳號。

CLI 路徑:先進入資料夾,再啟動 Codex

Windows PowerShell 可用官方原生安裝器;以下指令見 Codex CLI 0.167.0 官方 README:

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

macOS/Linux 可選同一份 README 的安裝器:

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

已使用 Node.js 的人也可改用 npm;選一種方式安裝即可:

npm install -g @openai/codex

重新開啟終端機,以 codex --version 確認指令可用。接著用 PowerShell 建一個獨立練習資料夾並進入它;已有同名練習資料夾時,請換個新名稱保留舊成果。以下指令只建立資料夾和子資料夾,尚未下載、解壓或執行 Codex:

New-Item -ItemType Directory -Path "$HOME\Documents\codex-practice" -Force
New-Item -ItemType Directory -Path "$HOME\Documents\codex-practice\inputs" -Force
New-Item -ItemType Directory -Path "$HOME\Documents\codex-practice\outputs" -Force
Set-Location "$HOME\Documents\codex-practice"
Get-Location

確認最後一行是 ...\Documents\codex-practice 後才輸入:

codex

依畫面選擇以 ChatGPT 帳號登入。API key 與 ChatGPT 方案是不同的存取和計費路徑;本練習不需要 API key。ChatGPT 方案中的 Codex 存取和用量會變動,請在 ChatGPT pricing 與帳號內當前資訊核對;不要把本文或舊截圖的額度當成承諾。

取得練習檔:只把 inputs 放進工作範圍

下載本站既有的 中文素材與實際成果包;英文讀者可用既有的 英文材料包。中文包是虛構客服教材,不含真實客戶資料;包內的 METHOD.md 說明此固定案例的製作和驗收邊界。

解壓縮後,你會看到四類東西:

位置 用途 這一輪要不要放進 codex-practice
inputs/feedback.txt、inputs/rules.txt 唯一交給 Codex 的原始教材 要;複製到 codex-practice/inputs/
reference/ 事先備好的驗收答案 不要;自己做完才對照
results/v1、results/v2 這次固定教材案例保存的實際成果 不要;留在解壓縮包內比對
result-images/ 依成果排版的資料圖 不要;不是 App 截圖

把 ZIP 解壓到 codex-practice 以外的位置,例如 Documents\codex-practice-materials。接著只複製兩個 inputs;原件保留在解壓位置。完成後,工作資料夾應只包含:

codex-practice/
  inputs/
    feedback.txt
    rules.txt
  outputs/

這樣做的原因很直接:如果把 reference 或 results 一起放進去,Codex 可以先看到答案,你就無法判斷它是否真的依來源整理。

第一回合只讀:確認案件數和規則,不建立檔案

在 App 中開啟 codex-practice,或已在該路徑的 CLI 對話中貼上以下文字。先不要要求它產出表格。

只讀取 inputs 資料夾中的檔案。不要新增、修改、移動或刪除任何檔案。

請列出讀到的檔名,並分別說明它們的用途;再回答:
1. feedback.txt 有幾筆來源紀錄?
2. 有幾個不同案件編號?
3. 哪些案件有缺漏欄位?
4. 哪個案件的狀態互相衝突?請列出來源編號。

回答時不要替缺漏資料補值,也不要判定衝突中的哪一筆比較新或比較正確。

以教材內容核對,應看見 8 筆來源紀錄、6 個案件(C101–C106);C102 缺期限,C104 缺負責人、期限和狀態,C103 的 R04 與 R05 對狀態有衝突。若案件數被算成 8,先追問它如何把來源紀錄合併成案件;不要直接進下一步。

第二回合先看計畫:把「會寫什麼」說清楚

只有在第一回合正確讀到 inputs 後,才貼出下列 prompt:

依 inputs/rules.txt 規劃客服交接表的整理方式,先不要寫檔。

請列出:
- 合併同案件的規則;
- 預計建立的檔案與各自欄位;
- 哪些欄位必須填「待確認」;
- C103 的兩種狀態和各自來源如何保留;
- 你不會做的事。

範圍限制:不排序優先級、不分派負責人、不估期限、不寄送回覆、不連接真實系統。

計畫至少要能導向 6 筆案件、保留 C103 的 R04/R05、把缺漏保持為「待確認」。如果它提議覆蓋較早紀錄、依日期猜狀態,要求先修正計畫。

第三回合才寫入:指定輸出路徑與欄位

計畫確認後,再讓它只寫入 outputs/v1:

現在只在 outputs/v1 建立 handoff.csv 與 questions.md,其他檔案都不要修改。

handoff.csv 必須有:案件編號、問題類型、問題摘要、負責人、期限、狀態、來源編號。
questions.md 必須列出仍需要人工確認的事項、案件編號與來源。

依 rules.txt 合併案件;缺少負責人、期限或狀態時填「待確認」;狀態衝突時狀態也填「待確認」,並在摘要和 questions.md 保留 R04、R05 的兩種說法。完成後停止,列出建立的檔案與尚未確認的事項。

這段 prompt 的重點不是措辭漂亮,而是把讀取來源、允許寫入位置、欄位、衝突處理和停止條件放在同一次交辦中。

用欄位、來源與衝突驗收輸出

打開 outputs/v1/handoff.csv 和 outputs/v1/questions.md;CSV 用 UTF-8、逗號分隔開啟,日期欄先當文字讀。用下表逐項檢查,而不是只問 Codex「有沒有做對」。

要檢查的事 正確結果
筆數與來源 6 筆案件,R01–R08 全部可回查
C101 合併 R01、R02;負責人小林、期限 2026-10-23、狀態處理中
C102 期限為「待確認」,來源 R03
C103 狀態為「待確認」;摘要或待確認清單同時保留 R04 的「已完成」與 R05 的「仍待修正」
C104 負責人、期限、狀態全為「待確認」,來源 R06
questions.md 共涵蓋 5 個待確認欄位:C102 一項、C103 一項、C104 三項

完成自己的核對後,再開啟 ZIP 中的 reference/expected-handoff.csv 與 reference/expected-questions.md。參考答案容許摘要的文字不同,但不能把缺漏補成事實、漏掉來源,或替 C103 決定狀態。

results/v1/ 和 results/v2/ 是此固定教材案例留存的實際原始成果,不是預期答案重建的示例。它們顯示 v2 只把 handoff.csv 的來源欄移到摘要後;兩版 questions.md 相同。這是用來對照「保留舊版後改一個具體欄位」的材料,不能推估每個模型或環境都會得到相同文字。

指出差異再修訂:保留 v1,另存 v2

如果輸出有錯,不要只說「請重做」。把案件、欄位、來源和預期行為一起說清楚,例如:

請保留 outputs/v1,不要覆寫。
在 outputs/v2 建立修正版。

修正 C103:狀態必須是「待確認」,並在問題摘要與 questions.md 保留
R04「已完成」和 R05「仍待修正」及其來源;不要選其中一筆覆蓋另一筆。

其餘案件欄位若無必要,不要改動。完成後列出 v2 與 v1 的差異。

這種修訂請求可以驗證兩件事:它有沒有精準處理衝突,和它有沒有尊重「不要覆寫 v1」的範圍。若只是練習欄位順序,也可要求 v2 把來源欄移到問題摘要後,其他值不變,接著逐欄比對 v1/v2。

停止、保存與復原:先確認檔案,再回到乾淨副本

取消任務或關閉視窗不會替你自動撤回已寫入的檔案。停止後先看 outputs/、確認是否多了預期以外的檔案;要保存就保留 outputs/v1、outputs/v2 與一份未改動的 inputs 副本。練習失控、inputs 被修改或結果難以追查時,最穩妥的復原不是猜哪一步改錯,而是建立新的 codex-practice,從 ZIP 的原始 inputs/ 重新複製兩檔,再從第一回合開始。

第一次練習只需要讀兩個虛構檔、寫兩個輸出檔。看到它要求讀取其他私人資料夾、安裝來源不明的工具、上傳資料或連接真實系統時,先拒絕並縮小範圍。需要深入設定時,見 Codex 權限設定;想把可交付與不可交付的差別拆清楚,見 Codex 工作交付判斷。

下一步按問題前進

資料來源與查證範圍

查證日期:2026-11-08。

  • OpenAI Codex 文件 — 產品與官方文件入口。
  • OpenAI Codex CLI 文件 — CLI 安裝、啟動與登入的現行官方說明。
  • ChatGPT pricing — 方案與 Codex 存取以帳號當前顯示為準。
  • 本文的中文 ZIP — 虛構 inputs、預期答案、固定案例的 v1/v2 成果、方法與 SHA-256 清單;其中的實際成果只證明該固定材料案例,並非一般成功率或介面操作測試。

追蹤 Gwarket

有新的實測工具或作者自製的 Skill 時,寄到你的信箱。

訂閱後先寄給你一份每月更新的 AI 工具與 Skill 清單。有新的實測或作者自製 Skill 才寄信,隨時可以退訂。隱私權說明

快完成了,請到信箱收確認信點信裡的按鈕確認訂閱,就會收到工具清單的下載連結。沒看到的話,看一下垃圾郵件或「促銷內容」分頁。

也可以在這些平台追蹤: