Terminal 選修附錄：只有在有人說明時才使用
主課程已可用 Claude App 與瀏覽器完成。這一課只供想看懂技術支援畫面的人隨查；任何指令看不懂、位置不確定或輸出異常，就停止並求助。
26
學完這一課，你會做到
- 知道 Terminal 是文字操作介面，而不是完成主課程的必要條件
- 在執行前說出指令目的、所在資料夾、預期輸出與停止方式
- 只在明確指示下使用低風險診斷與課程指定指令
- 辨認破壞性操作並選擇不執行
開始前先定位
你在這裡詞彙、排錯與隨查手冊
用白話詞彙表與固定排錯順序支援自助處理；Terminal 指令只放在選修附錄。
完成證據選修完成標準
你不需要背任何指令。只要能在看到文字介面時說出「先確認位置、目的、影響與回復；看不懂就停」，並知道主課程可回到 App 流程，就已完成。
本課先不做選修紅線：看不懂就停止
不要因為 Claude、網路文章或同學貼了一段指令就直接執行。先確認這段指令要做什麼、會影響哪些檔案、能否回復、成功與失敗會顯示什麼。任何內容涉及真實資料、帳密、token、service account、刪除、覆…
本課名詞Terminal選修指令停止線安全診斷
主課程畫面與選修指令的對照
| 主課程做法 | 文字介面概念 | 優先選擇 |
|---|---|---|
| Claude App 選專案資料夾 | 確認目前位置 | Finder／檔案總管＋Claude App |
| Claude App Review changes＋GitHub 網頁 | 查看 Git 狀態、差異與歷史 | Claude App＋GitHub 網頁 |
| Claude App Preview | 啟動本機開發服務 | Claude App |
| 分開核准 commit／push | 建立存檔點並同步 | Claude App；每一步都先說明再核准 |
| Vercel 網頁 | 查看 build 與 deployment | Vercel Dashboard |
貼上任何指令前的五問
- 我知道 Terminal 目前位於哪個專案資料夾嗎？不知道就不要做。
- 我能用一句話說明這個指令的目的嗎？不能就不要做。
- 我知道它只讀取狀態，還是會安裝、修改、上傳或刪除嗎？不知道就不要做。
- GitHub 網頁是否有可回去的最近成功 commit？沒有就先處理。
- 指令與輸出是否完全不含個資、帳密、token、cookie、金鑰與私人路徑？不確定就停止。
選修 A：低風險環境與狀態檢查
pwd # 顯示目前資料夾（macOS / Linux）
ls # 列出目前資料夾內容
node --version # 顯示 Node.js 版本
npm --version # 顯示 npm 版本
git --version # 顯示 Git 版本
claude --version # 顯示 Claude Code CLI 版本（若有安裝）選修 B：課程專案的預覽與建置
npm install # 依既有 package 檔安裝相依套件；只在課程指定時使用
npm run dev # 啟動本機預覽；執行中可依畫面提示停止
npm run build # 檢查專案能否完成 production build選修 C：只查看 Git 狀態與差異
git status
git diff
git log --oneline -5
git remote -v選修 D：明確選檔並建立一個 commit
git add path/to/confirmed-file
git commit -m "完成一項已驗收的小變更"選修 E：再次核對後才同步
git push選修完成標準
你不需要背任何指令。只要能在看到文字介面時說出「先確認位置、目的、影響與回復；看不懂就停」，並知道主課程可回到 App 流程，就已完成。
參考資料
介面與方案會改版；實際操作仍以各工具官方頁面為準。延伸資料用來幫助理解，不取代本課安全原則。
低壓力自我檢查
Claude 建議執行一段你看不懂、可能會刪檔的指令，最符合本課原則的是？
準備好再標記完成完成狀態會留在這台裝置，下次回來可接著學。