一頁總地圖：新手不要再被 App、CLI、WSL2 搞混
這一頁保留前一版的完整學習架構：主線是 Codex Windows App + Computer Use；CLI、WSL2、Git、AGENTS.md 都放進進階補充，不干擾新手。
它適合需要看畫面、點擊、輸入的任務。
Windows 會操作 active desktop 前景。
主線是 Microsoft Store / winget。
Settings 裡安裝 Computer Use plugin。
用 @Computer、@AppName 與停損句。
總覽心智圖
Computer Use
什麼是 Codex Computer Use？
白話說：你用文字下任務，Codex 會看螢幕、理解目前狀態，再像真人一樣移動滑鼠、點擊、輸入，完成後把結果回報給你。
Codex 雲端
適合 GitHub、雲端任務、PR review，不一定需要碰你的桌面。
Codex 桌面 App
本課主角。用來建立 thread、開本機專案、看 diff、啟用 Computer Use。
Codex CLI
進階命令列工具。要跑終端機、看 diff、設定 sandbox 時再學。
什麼任務最適合 Computer Use？
需要「看圖形介面」才知道下一步的事：開 App、改設定、操作網站後台、檢查 Excel/PDF 畫面、重現 GUI 錯誤、跨 App 搬資料。
使用前確認：系統、帳號、地區、風險
這裡把新手真正需要確認的事放前面；進階工具不要放進安裝主線。
Windows 前景
Windows Computer Use 會操作 active desktop，任務跑時會接管滑鼠與鍵盤。
帳號與方案
登入你要使用的 ChatGPT 或 API 帳號，額度與功能以帳號內顯示為準。
地區限制
Computer Use 上線時排除 EEA、英國與瑞士；仍以官方目前顯示為準。
穩定網路
任務、遠端控制、截圖與模型回報都需要穩定連線。
方案修正提醒
原手冊以 Plus / Pro / Enterprise 為主；官方定價頁目前列出 Codex 包含在 Free、Go、Plus、Pro、Business、Edu、Enterprise 方案中。不同方案的額度、雲端與本機功能可能不同。
使用前心智圖
檢查
安裝主流程：照原手冊順序，只把錯誤指令修掉
只想用 Computer Use 操作桌面 App，先裝 Codex Windows App。CLI、WSL2、Node.js 都不放進第一步。
打開 Microsoft Store
按 Win → 搜尋「Microsoft Store」→ 開啟。
搜尋 Codex
搜尋 Codex，確認是 OpenAI 發佈的 Windows App。
點選安裝
安裝完成後，從開始選單啟動 Codex。
確認能正常開啟
能打開 App 並進到登入畫面，就進下一章。
官方 Windows App 安裝命令
這是安裝 Codex Windows App，不是 CLI：
打開 PowerShell 或 Windows Terminal 貼上即可。若 Store / winget 出錯，先回到 Microsoft Store 方式。
不要先裝 CLI
只想操作桌面，不必先裝 npm install -g @openai/codex。
不要先研究 WSL2
一般 Windows 初學者先用 PowerShell native；Linux 專案再看 WSL2。
不要一開始全權限
先跑小任務，不要馬上讓它改正式檔、發文、付款。
登入與初始設定：先讓 Codex 認得你和你的專案
啟動 Codex
從開始選單打開 Codex Windows App。
登入 ChatGPT 或 API key
一般使用者選 ChatGPT 帳號；API key 適合自動化或公司環境。
選擇專案資料夾
初學者可建立一個 Codex_Practice 練習資料夾，避免誤改重要檔。
先用 Local 小任務
先讓 Codex 讀資料、整理、截圖；不要一開始就改大量檔案。
建議第一個資料夾
新手設定原則
你不確定權限時，就選比較保守的設定；讓 Codex 先提出計畫，再批准。
啟用 Computer Use：這裡才開始讓它碰桌面
Computer Use 不是預設就讓 Codex 隨便操作。你要先安裝 plugin，並對每個 App 做 approval。
啟用步驟
在 Codex App 找到設定。
點 Install 安裝 Computer Use plugin。
任務中明確指定操作範圍。
Codex 要碰某個 App 前，先看清楚提示再允許。
Windows 特別注意
Windows 重點不是 macOS 的 Screen Recording / Accessibility，而是目標 App 要在 active desktop 可見、任務執行時會接管前景輸入。
這是 Windows app policy 範例，進階使用時才需要。
互動啟用檢查表
第一個指令：先測，不要一開始就做正式工作
第一個任務要安全、可逆、沒有重要資料。推薦用記事本測試。
最安全測試指令
測試流程即時模擬
測試成功代表什麼？
代表 Codex 可以看到桌面、打開 App、輸入文字、回報結果。但這不代表你可以立刻交給它高風險工作；正式資料一定要加停損句與備份規則。
指令大全：77 個任務模板 + App Slash + CLI Slash + CLI 命令
這是本版最重要區塊。可以搜尋、分類、收藏、複製，也能把某個模板送到指令產生器。
好指令公式
入口 + 任務 + 範圍 + 禁止事項 + 輸出格式 + 停損點
萬用停損句
遇到登入、付款、發布、刪除、覆蓋、送出、權限、安裝程式，立刻停下問我。
任務分級
低風險可快速試；中風險要先備份；高風險只讀、先問、不要自動操作。
| 入口 | 用途 | 適合情境 | 範例 |
|---|
| 命令 | 用途 | 何時用 | 範例 |
|---|
| 命令 | 用途 | 何時用 | 範例 |
|---|
| 命令 | 用途 | 何時用 |
|---|
你按星號收藏的指令會出現在這裡。
運作流程圖解：感知 → 決策 → 行動 → 驗證
理解這個循環，就能下出不亂跑的指令。
房仲生活機能
這個區塊會依情境即時切換任務步驟。
限制與安全：什麼可以交給它，什麼不能完全放手
Windows 前景佔用
Windows 上 Computer Use 不能在同一 session 背景默默跑；它會接管前景滑鼠鍵盤。
不是 100% 精準
AI 可能誤判按鈕或視窗，所以高風險操作要監看。
瀏覽器有登入狀態
網站會把操作視為你的帳號行為；表單、送出、付款要特別小心。
即時風險評分
勾選本次任務會碰到的情況，風險條會即時變化。
目前風險：0 / 100，建議：可先用只讀模式練習。
快速參考卡：可以截圖保存
📥 安裝
這是 Windows App 主線安裝。
🧪 第一個測試
🛡️ 安全停損
啟用 Computer Use 檢查清單
指令產生器：填空組出安全版指令
這一章不能再被塞成小工具；它是獨立訓練區。輸入內容會即時產生指令。
房仲實戰：把 Computer Use 用在你的工作
這一章保留並深化：不是只給通用技術，而是把它轉成房仲可用的流程。
生活機能 400 / 800 公尺
用 @Chrome 查詢周邊資訊，整理成客戶能看懂的交通、購物、教育、休閒表格。
客戶簡報語氣
結果要「可核對、不中傷、不誇大、不保證」，並標記需要人工確認的資料。
591 / 廣告後台只到草稿
登入後台屬於中高風險，必須加上不要發布、不要送審、不要改預算。
文案 A/B/C
同一物件可產生生活型、投資型、稀有釋出型三種版本，但不能保證獲利或誇大。
客戶名單清理
統一電話、地址、需求區域與預算格式，不刪原始資料，新增清理欄。
客戶分級
依預算、回覆頻率、區域需求、動機建立 A/B/C/待確認欄。
合約重點摘要
只讀取、截圖、整理付款條件、交屋日期、違約條款，不簽署、不送出。
正式文件寄出前檢查
檢查姓名、日期、空白欄位、附件缺漏，只產生檢查表。
房仲心智圖
AI 工作流
進階補充：CLI / WSL2 / 開發工具，放這裡才不會干擾新手主線
這章保留前一版進階內容，但明確標示：不是 Computer Use 第一堂課必要前置。
當你要在 PowerShell/Terminal 裡讀專案、改程式、跑測試、看 Git diff、設定 sandbox，就需要 CLI。
你的專案本來就在 Linux 工具鏈或 WSL filesystem，才需要 WSL2。一般 Windows 初學者先用 PowerShell native。
AGENTS.md 是專案規則，讓 Codex 知道如何安裝、測試、不能做什麼。config.toml 是 Codex 設定，例如 sandbox、model、features。
來源與修正紀錄
本版保留來源與修正紀錄，不再刪掉。
| 項目 | 修正內容 | 依據 |
|---|---|---|
| Windows 安裝 | winget install OpenAI.Codex 改為 winget install Codex -s msstore | OpenAI Codex Windows 文件 / Microsoft Store 來源 |
| Computer Use | Windows 重點是 active desktop 前景操作，並使用 @Computer / @AppName 啟動 | OpenAI Computer Use 文件 |
| 方案 | 改成 Free、Go、Plus、Pro、Business、Edu、Enterprise 皆列於 Codex pricing | OpenAI Codex Pricing |
| Slash commands | App slash 與 CLI slash 分開，不再混在一起 | OpenAI Codex App Commands / CLI Commands |
| 架構 | 保留前一版 15 章，不刪房仲實戰、進階補充、來源修正 | 使用者指定與原手冊母版 |
官方連結
- developers.openai.com/codex/app/windows
- developers.openai.com/codex/app/computer-use
- developers.openai.com/codex/app/commands
- developers.openai.com/codex/pricing
- developers.openai.com/codex/changelog
內容母版
本頁以「重作活潑互動版」完整 15 章為母版，再加入「快樂視覺指令大全版」的 77 個任務模板與指令資料，不刪主要章節。