附錄 B：大學教師的 Codex 入門與跨裝置換手寫作

理解 Codex、ChatGPT、Claude Code、Cursor，以及用 OneDrive 延續教材專案

1 附錄 B：大學教師的 Codex 入門與跨裝置換手寫作

很多老師第一次聽到 Codex，會直覺把它想成「另一個 ChatGPT」。這個理解不算錯，但不夠精準。ChatGPT 比較像是你在瀏覽器或手機上對話的 AI 助理；Codex 則更像是坐在你電腦資料夾裡的協作者，可以閱讀專案檔案、修改檔案、產生 HTML、執行指令、檢查錯誤，甚至協助 commit 與 push 到 GitHub。

如果用「檔案總管」來比喻，ChatGPT 多半是在對話視窗裡回答問題；Codex 則是你打開某個專案資料夾後，讓 AI 在那個資料夾內工作。它不是只寫一段文字給你複製，而是可以直接把文字、圖片、網頁、程式與 Git 版本紀錄整理成一個可以交付的專案。

這也是本專案能從一個想法，逐步變成長個案、短個案、18 週課程、HTML 頁面、圖片資產與 GitHub Pages 的原因。

1.1 一、Codex 與 ChatGPT 的差別

老師可以先用下面這張表建立基本概念。

工具	最容易理解的角色	主要使用情境	對教師的意義
ChatGPT	對話型助理	發想、問答、改寫、摘要、上傳少量檔案討論	適合快速討論想法與產生文字版本
Codex App	本機專案協作者	在指定資料夾中讀寫檔案、產生 HTML、執行測試、整理資產、操作 Git	適合把課程、講義、網頁、資料表做成可管理的專案
Codex CLI	終端機中的 Codex	用指令列操作專案、跑自動化流程、處理大量檔案	適合熟悉命令列或需要重複流程的使用者
Codex Web / Cloud	雲端任務環境	在遠端工作區處理任務、開 PR、處理程式專案	適合團隊或開發流程較成熟的情境

OpenAI 官方文件將 Codex App 定位為桌面工作環境，支援多個專案 thread、Git worktree、automations 與 Git 功能；也就是說，它不是只回答問題，而是把「本機專案」當成工作場域。官方文件也指出，Codex App 可在 macOS 與 Windows 使用。

在教學材料製作上，這個差別非常重要。ChatGPT 可以幫你寫一段課程介紹；Codex 可以在同一個資料夾內建立 index.html、整理 assets/、修改 CSS、產生 PDF 預覽、檢查圖片路徑，最後協助把成果放到 GitHub。

1.2 二、在 Windows 安裝與使用 Codex

對多數老師來說，建議先從 Codex App 開始，而不是一開始就碰 CLI。

1.2.1 1. 安裝 Codex App

依 OpenAI 官方文件，Codex App 可在 Windows 與 macOS 使用。Windows 使用者可以從 OpenAI Codex App 官方頁面前往 Windows 下載連結；目前官方文件提供的是 Windows 下載入口，並要求安裝後開啟 Codex。

基本流程如下：

前往 OpenAI Codex App 官方頁面。
選擇 Windows 版本下載與安裝。
開啟 Codex。
使用 ChatGPT 帳號或 OpenAI API key 登入。
選擇一個專案資料夾。
確認使用 Local 模式，讓 Codex 在本機資料夾中工作。

對老師而言，第 5 步最關鍵。Codex 不是抽象地「知道你的電腦」，而是要你指定一個專案資料夾。舉例來說，本專案的工作資料夾就是：

C:\Users\sonic\OneDrive\Biz Daily\HBR Taiwan\Become Judy\

當你選定這個資料夾，Codex 就會在這個範圍內閱讀、產出與修改檔案。

1.2.2 2. Windows 使用前的建議準備

若只是寫講義、改 HTML、整理資料夾，Codex App 本身已經能處理很多工作。但若你希望它協助發布到 GitHub，建議另外準備：

工具	用途	教師可以怎麼理解
Git	記錄版本、commit、push	教材版本管理工具
GitHub 帳號	放置 repository 與 Pages 網站	公開作品架與版本庫
GitHub Desktop	圖形化操作 Git	不熟命令列時的輔助工具
Node.js	某些網頁工具或 CLI 會用到	網頁工具的執行環境
Python	文件轉換、資料清理、檢查腳本常會用到	本機自動化工具

不必一次全部學會。實務上可以先讓 Codex App 在專案資料夾中工作，再逐步理解 Git 與 GitHub。

1.2.3 3. Windows 上的 Codex CLI

若老師已經熟悉 PowerShell 或終端機，可以使用 Codex CLI。OpenAI 官方文件指出，可用 npm 安裝：

npm i -g @openai/codex

安裝後，在專案資料夾中執行：

codex

第一次執行時，系統會要求使用 ChatGPT 帳號或 API key 登入。官方文件也說明，Codex CLI 可在 macOS、Windows 與 Linux 使用；Windows 可以直接在 PowerShell 中執行，也可以在需要 Linux 原生環境時使用 WSL2。

對一般教師而言，CLI 不是必備。它比較適合需要大量處理檔案、固定自動化流程、或已經習慣命令列的人。

1.3 三、在 Mac 安裝與使用 Codex

Mac 使用者同樣建議先使用 Codex App。

1.3.1 1. 安裝 Codex App

OpenAI 官方文件提供 macOS 下載入口，並區分 Apple Silicon 與 Intel 版本。老師可以依自己的 Mac 選擇：

Mac 類型	應選版本
M1、M2、M3、M4 等 Apple Silicon	macOS Apple Silicon 版本
較舊 Intel Mac	macOS Intel 版本

安裝後流程與 Windows 類似：

開啟 Codex。
使用 ChatGPT 帳號或 OpenAI API key 登入。
選擇專案資料夾。
確認使用 Local 模式。
用自然語言告訴 Codex 要做什麼。

例如：

請先讀取這個專案資料夾，找出目前的 Output、Process 與 References，然後告訴我這個教材專案目前做到哪一步。

1.3.2 2. Mac 上的 Codex CLI

若使用終端機，也可以依官方文件用 npm 安裝：

npm i -g @openai/codex

進入專案資料夾後執行：

codex

對 Mac 使用者來說，CLI 的價值在於可以快速搭配 git、Quarto、Python、Node 等工具。但如果目標是讓老師做教材、網頁與講義，Codex App 通常更直覺。

1.4 四、Codex、Claude Code、Cursor 的對應關係

除了 Codex，老師可能也聽過 Claude、Claude Code 或 Cursor。這些工具都能協助完成類似工作，但角色不同。

產品或工具	所屬公司	大致對應	適合情境
ChatGPT	OpenAI	對話與知識工作助理	發想、改寫、摘要、一般問答
Codex App	OpenAI	本機專案代理	在資料夾內產出教材、HTML、程式、Git 操作
Codex CLI	OpenAI	終端機代理	自動化、批次處理、開發者流程
Claude.ai	Anthropic	對話與文件分析助理	長文閱讀、寫作、分析
Claude Code	Anthropic	代理式程式與專案工具	讀取 codebase、改檔、跑指令、操作 Git
Cursor	Anysphere	AI 程式編輯器與代理工作區	在編輯器中寫程式、改網站、管理 codebase

Anthropic 官方文件把 Claude Code 描述為能讀取 codebase、編輯檔案、執行指令並整合開發工具的 agentic coding tool；它可在 terminal、IDE、desktop app 與 browser 使用。從功能定位看，它與 Codex 屬於同一類：不是單純聊天，而是能在專案中工作。

Cursor 則比較像一套 AI-first 的程式編輯器。官方安裝文件說明，安裝後會讓使用者選擇快捷鍵、主題與 terminal 偏好；當你打開專案時，Cursor 會建立 codebase indexing，讓 AI 對專案更熟悉。若老師已經習慣 VS Code 或想在編輯器中工作，Cursor 會很自然；若老師想用對話方式指揮一個資料夾型專案，Codex App 比較接近本講義示範的流程。

1.4.1 1. Claude Code 的安裝概念

這份講義不以 Claude Code 為主，但老師可以知道它與 Codex 類似。Anthropic 官方文件提供多種安裝方式：

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

macOS、Linux、WSL：

curl -fsSL https://claude.ai/install.sh | bash

Homebrew：

brew install --cask claude-code

WinGet：

winget install Anthropic.ClaudeCode

Anthropic 也說明，Windows 原生使用時建議安裝 Git for Windows；如果沒有 Git Bash，Claude Code 會改用 PowerShell。這一點對 Windows 老師很重要，因為很多 AI 開發工具都會假設本機有 shell、Git 與常用指令。

1.4.2 2. Cursor 的安裝概念

Cursor 官方文件的入門方式相對簡單：

到 cursor.com 按 Download。
執行下載後的安裝程式。
安裝完成後開啟 Cursor。
第一次使用時設定快捷鍵、主題與 terminal。
打開專案後，讓 Cursor 建立索引。

Cursor 官方下載頁也列出 macOS、Windows 與 Linux 版本。它可以完成類似「在專案內改檔、修網站、跑 terminal」的任務，但它的入口是編輯器，而不是 Codex App 這種以 thread 與專案資料夾為核心的桌面代理。

1.5 五、用檔案總管理解跨裝置換手寫作

「換手寫作」指的是：你在 A 電腦用 Codex 做到一半，接著到 B 電腦繼續同一份教材專案，而不需要重頭說明所有背景。

很多老師會以為這件事只要登入同一個 AI 帳號就可以。實際上，對 Codex 這類本機專案工具來說，真正重要的是：兩台電腦能不能看到同一份專案資料夾，以及這份資料夾有沒有清楚的交接紀錄。

以我自己的使用方式為例，我把工作放在 OneDrive 中。這樣在不同裝置上，只要 OneDrive 同步完成，兩台電腦就可以看到同一組檔案。Google Drive 也可以做類似事情。

用檔案總管來比喻：

傳統檔案總管動作	跨裝置 Codex 對應動作	GitHub 對應動作
新增資料夾	建立專案工作區	建立 repository
新增檔案	讓 Codex 產出講義、HTML、圖片、資料表	`git add` 後納入版本管理
修改檔案	讓 Codex 改寫或修正內容	commit 形成版本紀錄
雲端同步	OneDrive 或 Google Drive 讓另一台電腦看到檔案	push 到 GitHub
從另一台電腦打開資料夾	在另一台電腦用 Codex 選同一個資料夾	pull 最新版本
比對哪一版是正式版	看交接檔、輸出檔與 Git 狀態	看 main branch 與 commit log

因此，換手寫作不是「AI 記得所有事情」，而是你建立一套讓 AI 能重新讀取上下文的檔案制度。

1.6 六、建議的跨裝置專案資料夾結構

若老師要長期用 Codex 做課程、講義或個案，建議每個專案都用類似結構：

My Teaching Project/
  00_Admin/
    handoff.md
    decision_log.md
    source_policy.md
  01_Input/
    raw_documents/
    images/
    links.md
  02_Process/
    evidence_table.xlsx
    outline.md
    drafts/
  03_Output/
    syllabus.html
    case.html
    assets/
  04_Archive/

其中最重要的是 00_Admin/handoff.md。這個檔案不需要很長，但要讓下一台電腦上的 Codex 能接手。

建議內容如下：

# Handoff

## 目前做到哪裡
- 已完成長個案 v2。
- 已完成 HTML 初版，但手機版表格仍需檢查。

## 重要決策
- 課程主軸採長個案，不採短個案。
- 圖像使用虛構化角色，不使用真實人物肖像。

## 下一步
1. 檢查 `03_Output/case.html` 的圖片路徑。
2. 產生 PDF 預覽。
3. 檢查是否有教師備註殘留在學生版頁面。

## 不要做的事
- 不要刪除 `01_Input` 原始資料。
- 不要把未查證推論寫成事實。

這個交接檔就像你在資料夾上貼一張便利貼，告訴下一位接手者：現在做到哪裡、下一步是什麼、哪些事情不能碰。

1.7 七、跨裝置換手寫作的標準流程

1.7.1 1. 在 A 電腦結束工作前

請先讓 Codex 做收尾：

請整理本次工作交接，更新 00_Admin/handoff.md。內容包含：已完成項目、尚未完成項目、下一步、重要檔案路徑、不要改動的檔案，以及本次遇到的技術問題。

接著確認三件事：

重要輸出已存到 03_Output。
handoff.md 已更新。
OneDrive 或 Google Drive 已同步完成。

若這個資料夾同時也是 Git repository，還要做：

git status --short
git add 00_Admin/handoff.md 02_Process/ 03_Output/
git commit -m "Update teaching project handoff and outputs"
git push

實務上，不一定每次都要 push。但如果你要跨裝置工作，commit 與 push 是最穩定的正式交接方式。

1.7.2 2. 在 B 電腦開始工作前

先不要急著讓 Codex 寫新內容。請它先讀交接：

請先讀取 00_Admin/handoff.md，並檢查 03_Output 中最新輸出。請用五點以內說明目前專案狀態、下一步，以及你認為開始前需要確認的風險。先不要修改任何檔案。

如果資料夾是 Git repository，先確認是否抓到最新版本：

git pull
git status --short

等 Codex 說明狀態後，再下新的任務。

1.7.3 3. 避免兩台電腦同時改同一份檔案

OneDrive 與 Google Drive 很方便，但它們不是版本管理系統。若兩台電腦同時改同一份 Word、Excel、HTML 或 Markdown，雲端硬碟可能產生「衝突複本」。對 AI 專案來說，這會讓後續判讀變得混亂。

比較安全的規則是：

同一時間只在一台電腦開同一個專案。
換手前先更新 handoff.md。
等同步完成再到另一台電腦開啟。
重要版本用 Git commit 保存。
若發現衝突檔，不要直接刪除，先請 Codex 比對差異。

1.8 八、OneDrive 與 GitHub 的分工

OneDrive 和 GitHub 都像雲端，但用途不同。

工具	主要功能	適合放什麼	不適合做什麼
OneDrive	跨裝置同步檔案	工作中的 Word、Excel、Markdown、圖片、專案資料夾	當成正式版本審查工具
Google Drive	跨裝置與協作同步	共享文件、雲端文件、共同資料夾	管理程式式版本紀錄
GitHub	版本管理與公開發布	HTML、程式、公開講義、GitHub Pages	放私密學生資料或未授權素材

在本專案中，OneDrive 的角色是「讓不同電腦都能看到同一個工作資料夾」；GitHub 的角色是「保存正式版本，並透過 GitHub Pages 對外發布」。兩者不是互相取代，而是分工。

可以這樣理解：

OneDrive 是你的跨裝置檔案櫃。
GitHub 是你的版本管理庫與公開展示架。
Codex 是可以在檔案櫃中幫你整理、寫作、檢查與發布的協作者。

1.9 九、哪些事情可以交給 Codex，哪些仍要人決定

工作	Codex 可以主導	人類必須決定
讀取 handoff	摘要狀態、找待辦、列風險	是否接受 Codex 對狀態的理解
跨裝置檔案檢查	檢查檔案是否存在、找最新輸出	哪一份才是正式版本
HTML 修正	改排版、修連結、檢查圖片	讀者體驗與公開範圍
Git 操作	status、add、commit、push	哪些檔案應該進正式紀錄
GitHub Pages	檢查線上頁面、修 404、驗證資產	是否公開、公開到哪裡
寫作延續	依前一版繼續改寫	教學主張與文類判斷

這個分工可以避免一個常見誤解：AI 不是專案主人。Codex 很適合主導執行、檢查與修復，但教材方向、學生讀者、公開界線、事實查核標準，仍然需要教師負責。

1.10 十、老師可以直接使用的幾個指令

1.10.1 1. 新專案開始

請先閱讀這個資料夾，幫我建立專案盤點。請列出現有資料、缺少資料、可能的輸出形式，以及建議的資料夾結構。先不要修改檔案。

1.10.2 2. 工作結束前交接

請更新 00_Admin/handoff.md，整理本次工作成果、已修改檔案、尚未完成事項、下一步、風險，以及下一位 Codex 接手時要先讀的檔案。

1.10.3 3. 另一台電腦接手

請先讀 00_Admin/handoff.md 與 03_Output 中最新檔案，說明目前專案狀態。先不要修改檔案，等我確認下一步。

1.10.4 4. 檢查 Git 狀態

請檢查 git status，說明哪些檔案是本次相關變更、哪些可能是無關變更。先不要 commit。

1.10.5 5. 發布前檢查

請檢查 HTML 是否可正常開啟、圖片是否載入、手機版是否可讀、是否有不該公開的註記，並產生修正清單。

1.10.6 6. Commit 到 GitHub

請只 stage 本次相關檔案，建立清楚的 commit message，commit 到 main，然後 push 到 GitHub。完成後請檢查線上 GitHub Pages 是否更新。

1.11 十一、給老師的最低可行組合

若你不是工程背景，不需要一開始就理解所有工具。最小可行組合是：

一個同步資料夾：OneDrive 或 Google Drive。
一個專案資料夾：清楚區分 Input、Process、Output。
一個交接檔：00_Admin/handoff.md。
Codex App：選擇專案資料夾後用自然語言指揮。
GitHub：當成果需要公開或保存版本時再使用。

這樣就能開始做跨裝置教材專案。之後再逐步加入 Git、GitHub Pages、Quarto、Playwright、Image Gen 等工具。

真正重要的不是工具數量，而是工作方式：你把教材視為一個可持續演進的專案，而不是一次性的 Word 檔。Codex 的價值，正是在這個專案化過程中被放大。

1.12 十二、參考資料

OpenAI Developers, Codex App。
OpenAI Developers, Codex CLI。
Anthropic, Claude Code overview。
Anthropic, Claude Code setup。
Cursor Docs, Installation。
Cursor, Download Cursor。