開始使用你的
Claude Code

Claude 不只是一個聊天網站——它在網頁、手機、Office、終端機都有對應的工具。先把帳號和這幾個入口準備好，後面學什麼都能立刻動手試。照著下面四步走一次即可。

# 1. 開「PowerShell」(不是 CMD)，貼上這行、按 Enter 安裝
irm https://claude.ai/install.ps1 | iex

# 2. 在你要工作的資料夾開終端機，啟動 Claude（啟動方式見第 02 章）
claude

# 1. 開「終端機」(Terminal)，貼上這行、按 Enter 安裝
curl -fsSL https://claude.ai/install.sh | bash

# 2. 在你要工作的資料夾開終端機，啟動 Claude（啟動方式見第 02 章）
claude

$old = [Environment]::GetEnvironmentVariable("Path","User")
[Environment]::SetEnvironmentVariable("Path", $old + ";$env:USERPROFILE\.local\bin", "User")

$env:Path += ";$env:USERPROFILE\.local\bin"

裝好之後，真正的開始很簡單：更新 → 啟動 → 登入。這一段把每天開工會用到的幾個指令講清楚，包含怎麼登出、換成另一個帳號。

先決定在哪開終端機

Claude 的工作範圍就是你啟動它時、終端機所在的那個資料夾——它讀寫檔案都以這裡為基準。所以第一步是先讓終端機停在你要工作的資料夾，之後打的所有指令（更新、啟動）都在這個終端機視窗裡進行。

開工前先更新

# 1. 先更新到最新版
claude update

啟動 Claude Code

更新完，在同一個終端機輸入 claude 就正式啟動。第一次啟動會要你登入授權（見下一段）。

# 2. 啟動 Claude（工作範圍＝這個終端機所在的資料夾）
claude

初次登入

第一次啟動 claude 時，它會跳出瀏覽器要你用 Claude 帳號授權登入（就是你在步驟 1 註冊的那個帳號）。按下允許、回到終端機，看到歡迎畫面就代表登入成功，之後同一台機器不用每次重登。若沒自動跳出，可在 Claude Code 裡輸入 /login 手動觸發。

第一次啟動還會先問你要哪種終端機配色主題（深色／淺色等），用方向鍵選、Enter 確認即可——之後想改隨時用 /theme（詳見第 03 章）。完成後出現「Welcome back」歡迎畫面就能開始用了。

登出與換帳號

想換成另一個帳號（例如從個人換成公司帳號）時：先 /logout 登出目前帳號，再 /login 重新用另一個帳號登入即可。

切換模型

隨時可用 /model 切換 Claude 的模型——複雜任務用強模型、輕量任務用快又省的模型，兼顧品質與成本。各模型差異與適用情境詳見第 07 章。

每天要盯著終端機好幾小時，看得順眼才坐得久。這裡有兩層可以調，先搞懂差別就不會白忙：① Claude Code 的內建主題（從預設裡選）、② 終端機本身的配色（你想要的任意 RGB 配色）。

① Claude Code 內建主題

在 Claude Code 裡輸入 /theme 即可切換主題。內建有 6 種：

② 終端機本身的配色（真正的自訂）

背景色、字體顏色、那套你喜歡的調色盤，全都是終端機程式在管，跟 Claude Code 無關。在哪裡跑 Claude Code，就去那個程式設定：

• VS Code 內建終端機：設定 → 搜尋 terminal，或用 workbench.colorCustomizations 自訂 terminal.* 顏色；整體配色跟著 VS Code 的佈景主題走
• iTerm2（macOS）：Settings → Profiles → Colors，可直接套用 Color Presets 或匯入 .itermcolors 配色檔
• Windows Terminal（Win11）：設定 → 設定檔 → 外觀 / 色彩配置，可選內建配色或在 settings.json 自訂每個顏色

▸ 實作示範：Windows Terminal 改色彩配置（6 張實機圖）展開 ▸

Windows Terminal 內建多種配色，不必匯入任何檔案，從選單點一下就換。下面用 Solarized Light 示範——操作對任何配色都一樣（想要牛皮紙暖色就改選 Novel）。每張圖可點開放大。

預備：先確認電腦有「Windows Terminal」

按 Win 鍵，輸入「終端機」或「Terminal」。若跳出「終端機」（圖示是黑底 >_）就直接用；找不到的話開 Microsoft Store 搜尋「Windows Terminal」安裝（免費）。Windows 11 通常已內建，多半不必裝。

1

開啟「設定」

看視窗最上方分頁列，分頁右邊有個向下箭頭 ∨ → 點它 → 選「設定」（或直接按 Ctrl + , 逗號鍵）。

2

選設定檔，進「外觀」

設定頁左側清單捲到「設定檔」這一區，點你平常用的那個（如 Windows PowerShell）→ 再點「外觀」。

小提醒

左側單獨那個「色彩配置」項目不是這裡要點的——那頁只是在「定義顏色」，不是幫某個分頁挑配色。要挑配色一定要先點某個「設定檔」再進去。

3

找到「色彩配置」下拉

在「外觀」頁的「文字」區，會看到「色彩配置」下拉選單（預設多半是 Campbell）。

4

點開下拉，挑一個配色

點開下拉，裡面有 One Half、Solarized、Tango… 一堆內建配色。示範選「Solarized Light」（暖色想要牛皮紙質感就選 Novel）。

5

按「儲存」

選好後，右下角按「儲存」讓設定生效。

6

完成

回 Claude Code、開一個新分頁，終端機配色就換好了 ✅

想讓每個分頁都預設套用

在步驟 2 改點最上面的「預設值」（而不是個別設定檔），再做步驟 3～5，就能一次套用到所有分頁。

想幫 Claude Code 加裝新能力時，最常被搞混的就是這兩個詞。一句話分清楚：Skill 是「一個能力」，Plugin 是「一包能力」。而最關鍵的誤會是——裝 skill 不一定要用 /plugin，要看它是怎麼發布的。

Skill — 單一能力（一個 SKILL.md）

一個 skill 本質就是一個 SKILL.md 檔。放進 ~/.claude/skills/<名稱>/（全域）或專案的 .claude/skills/，Claude Code 啟動時自動偵測載入，不需要任何安裝指令。需要時 Claude 自己會用，或你用 /<名稱> 直接叫它。「裸 skill」的取得方式：

• npx skills add <github 網址> — 社群 CLI（非官方），自動把 GitHub 上的 SKILL.md 抓進你的 skills 資料夾
• 或自己 git clone 到 ~/.claude/skills/，效果一樣

npx skills add majidmanzarpour/threejs-game-skills --skill '*' -a claude-code -g -y

Plugin — 一包能力（套組）

Plugin 是更大的整合單位，可以一次打包多個 skills、斜線指令、hooks、MCP 連接，附一份 plugin.json 說明檔，上架到 marketplace（市集）。要用 /plugin 這個管理介面去搜尋安裝。裝一個 plugin = 批次裝進一整組能力。（plugin 裡的 skill 會帶命名空間，叫起來像 /外掛名:skill名。）

以 frontend-design 為例（走 Plugin 這條路）

Frontend Design 是 Anthropic 官方出的能力，讓 Claude 產出的網頁跳脫「AI slop」（紫色漸層、Inter 字體、千篇一律的卡片），改成有設計意圖的版型、配色、層次。它是以 plugin 發布的，所以走 /plugin 安裝：

# 在 Claude Code 裡輸入，開啟外掛管理介面
/plugin
# → 在官方 marketplace 瀏覽，找到 frontend-design → 安裝

# 安裝後不必重開，直接重新載入
/reload-plugins

告訴它你要的「風格」——丟網址或截圖

裝好 frontend-design 之後，最快讓成品貼近你心中樣子的方法，就是給它一個參考對象。你不必會講設計術語，直接給範本就好：

• 貼一個網址：把你喜歡的網站連結丟進對話框，說「我想要這種風格的網站」——Claude 會參考它的版型、配色與字體調性
• 貼一張截圖：看到順眼的畫面就截圖、直接拖進或貼進對話框（手機截圖也行），說「照這個感覺做」——一張圖比一整段形容精準得多

實戰：讓它從無到有，做出一頁主題網站

用一個完整例子串起來——這裡用「教育部 AI 人才方舟計畫（簡稱 AI 方舟）」當題目，看 Claude Code 怎麼一條龍從零幫你生出成品。你只要給主題，再在每一步幫忙確認、修正就好：

幫網頁加上動畫：anime.js 與 Lottie

先釐清一個容易混的點：frontend-design 是裝在「Claude」上的 skill（管整體設計）；而 anime.js 和 Lottie 是「前端動畫庫」——不是裝在 Claude，而是引入到你的網頁裡。要讓畫面動起來就靠這兩個，引入一行、動畫邏輯交給 Claude 寫。

anime.js——做互動、進場、數字遞增這類「程式即時運算」的動效。你不用自己處理引入，直接跟 Claude 說「用 anime.js 幫這個網頁加個進場動畫」，它就會把該載入的東西接好、把動畫寫好。

Lottie——播放複雜的現成插畫／吉祥物動畫（設計師做好的）。重點：它不適合手寫，正確流程是「去現成庫挑檔，再讓 Claude 嵌進來」：

把下面這段直接複製進你的 CLAUDE.md（第 06 章），之後 agent 做網頁就會自動照這套選動效工具，你不必再每次解釋：

動效工具預設：簡單效果用 CSS／Animate.css、客製互動用 anime.js、
複雜插畫用現成 Lottie 檔；勿手寫 Lottie JSON。

＊ 想看 Animate.css / anime.js / Lottie 三種動畫實際差在哪？這裡有一頁實測對比（可重播的範例＋對照表）→ 三種網頁動畫方式對比

收尾：幫網頁加一顆 favicon（分頁小圖示）

favicon（讀作 fav-icon，「favorite icon」）就是瀏覽器分頁標籤、書籤、我的最愛清單上那顆小圖示。沒設定的話，分頁只會顯示一個灰灰的空白地球或預設圖——網站看起來就少一味、像沒做完。加上一顆，整體質感立刻完整。它通常是一個叫 favicon.ico 的小檔，放在網站根目錄，再用一行 <link> 掛進 <head>。

一樣不用你開繪圖軟體——把你想要的樣子用白話講給 Claude，它會直接畫好、輸出多尺寸 .ico、再幫你掛進每一頁。例如：

幫這個網站做一顆 favicon：沿用站上的配色，
畫一個終端機 >_ 提示符的圖示，輸出 favicon.ico 並掛進 head

網頁在你電腦上做好了，怎麼讓別人也能打開？這一步叫「部署（deploy）」——把檔案放上一個會給你公開網址的服務。對新手最友善、又免費的選擇是 Vercel。而且整個過程不用你動手，交給 Claude Code 就好。

讓 Claude 自己裝好工具

部署要用到 Vercel CLI（一個命令列工具），但你不必先自己去裝。直接跟 Claude 說「幫我把這個網頁部署到 Vercel」，它會自己把工具裝起來、帶你登入、再完成部署。背後跑的大致是這幾行：

# 1. 安裝 Vercel CLI（Claude 會自己跑，你不用先裝）
npm install -g vercel

# 2. 第一次要登入（會跳出瀏覽器授權，用 GitHub / Email 都行）
vercel login

# 3. 在網頁專案資料夾裡部署
vercel          # 產生一個預覽網址
vercel --prod   # 正式上線到你的主網址

跑完它會回給你一個 https://你的專案.vercel.app 的網址，丟給任何人都能打開。

兩條路：直接上傳，還是先過 GitHub？

同樣是上線，有兩種做法，差在你要不要版本紀錄與自動更新：

＊ 另一個熱門選擇是 Cloudflare Pages——免費額度更大、流量大或想長期省成本時很適合，同樣能連 GitHub 自動部署，只是上手沒 Vercel 那麼順。新手想最快看到成果，先用 Vercel 就好，之後再依需求評估。

更輕量的分享：Artifacts（產出物）

部署適合「一個完整網站」；但有時你只是想把 Claude 這次做出來的東西——一張圖表、一份進度檢核、一個方案比較——快速變成一個能用瀏覽器打開的頁面，不想大費周章架站。這時可以用 Artifacts。

直接跟 Claude 說「把這個做成 artifact」，它會把成果寫成一頁 HTML、發布到 claude.ai 上一個私人網址（發布前會先問你同意），並自動幫你開啟。之後 session 繼續，同一個網址會原地更新——所以特別適合「邊做邊看進度」，手機點連結就能追。

常見用途：把 PR 的修改逐行加註解走一遍、用資料做成儀表板、把長任務做成邊跑邊打勾的進度檢核表、把幾個設計方案並排比較。

每次開新對話，Claude 的記憶都是一片空白。要讓它跨對話記住你的規則，靠的是一種叫 CLAUDE.md 的純文字檔——啟動時會自動讀進記憶。把「希望 Claude 每次都遵守的規則」寫進去，它就不會每次都要你重講。

關鍵：在哪開終端機，決定載入哪份規則

Claude Code 會從你開終端機的資料夾，沿著目錄一路往上層，把每一層找到的 CLAUDE.md 全部讀進來。所以同一個原則很重要：「在哪裡開終端機」就決定了這次載入哪些規則。

兩層放法（實務）

• 處理跨專案的事（例如安裝共用 skill）：在桌面上層開終端機 → 載入大政策那份 CLAUDE.md
• 處理某個專案：直接在那個專案資料夾開終端機 → 同時載入上層大政策＋這個專案自己的規則

第一天，該寫什麼進 CLAUDE.md？

很多新手一裝好就想把規則寫好寫滿——其實不必硬擠。你還不知道自己的使用習慣，寫一堆用不到的，每次開機都吃 context、還可能互相打架（官方建議單一 CLAUDE.md 控制在 200 行內）。但有三件小事值得第一天就設進全域 ~/.claude/CLAUDE.md，因為每個專案都適用、馬上省事：

• 語言：「一律用繁體中文、台灣用語回我」——不然它常回英文或簡體
• 風格：「回答先講重點、別長篇大論」——省你讀字、也省 token
• 你是誰：「我是國小老師／資訊組長，舉例盡量貼近教學、校園情境」——給的範例更對味

一句話交辦就好，例如：

# 跟 Claude 說
請記進我的全域 CLAUDE.md：①一律繁體中文台灣用語
②回答先講重點別長篇 ③我是國小老師，舉例貼近校園情境

真實案例：CLAUDE.md 讓它「自動照規矩做事」

一個校園網路管理的實例，看 CLAUDE.md 怎麼省下「每次都要重講規則」的工：

平常在一個資料夾裡，放著日常網路盤點的檔案——全校 IP 配置表（CSV）、網管交接記憶（md），還有一份 CLAUDE.md，裡面寫好配發原則（例如：避開保留位址與網段的頭尾、優先給連續空號）。

某天衛生所行動醫院臨時來要 4 個空的 IP。打開 Claude Code，只說一句「行動醫院需要 4 個空的 IP，幫我找出來、做一張可列印的配置表」——它就讀 CSV 比對出未配發的 IP、自動依 CLAUDE.md 的配發原則挑掉頭尾、選出 4 個，再產出一張可直接列印成 A4 的 HTML 配置表。

選對模型：強、平衡、快省

Claude 有不同等級的模型，差別在能力 vs 速度／花費的取捨。複雜任務用強模型、輕量任務用快模型，品質與成本就能兼顧。

相對成本由貴到省：Fable 5 ＞ Opus ＞ Sonnet ＞ Haiku。隨時用 /model 切換，或在 /config 設成預設。

查用量：/usage

在 Claude Code 裡輸入 /usage，會打開一個畫面顯示目前的用量：本次 session 的 token 與估算花費；訂閱方案（Pro／Max／Team）還會看到方案額度的使用比例、活動統計，以及用量是花在哪些 skill／子代理／plugin／MCP 上。在畫面中按 d / w 可切換看最近 24 小時 / 7 天。

讓用量常駐在狀態列

/usage 是「打開來查」；如果你想像現在這樣隨時瞄一眼，可以把用量放進底部狀態列常駐顯示。最簡單的做法——用 /statusline 加一句白話描述，Claude 會自動幫你產生腳本、寫進設定：

# 在 Claude Code 裡輸入，用白話描述你要顯示什麼
/statusline 顯示模型名稱、context 使用百分比和進度條

它會把腳本存到 ~/.claude/ 並更新 settings.json，之後狀態列就會持續顯示模型、context 用量、花費等資訊（可顯示的欄位包含 context 百分比、本 session 估算花費等）。想移除就再輸入 /statusline 清除狀態列。

# 目標長相
Opus 4.8  [░░░░░░░░░░] --%  $0.0000  13m23s  5h 47%(55m)  7d 27%(5d0h)

/statusline 狀態列從左到右顯示：模型名稱、context 使用進度條和百分比、
本次花費(美元)、這次 session 已用時間、5 小時用量視窗(已用%和剩餘時間)、
7 天用量視窗(已用%和剩餘時間)

撞到用量上限了？別慌——進度不會丟

訂閱方案有滾動式的 5 小時用量視窗。額度用完時，Claude Code 會停下來問你：要等視窗重置，還是改用額外用量（extra usage，另計費）。很多人第一次遇到會慌——尤其進度還沒收尾、連 /logout 都被那個提示卡住——但先記住一件事：

救援首選：換帳號，無損接回

如果你有第二個 Claude 帳號，最乾淨的做法是換過去繼續——每個帳號有各自獨立的 5 小時額度：

# 1. 先脫離那個卡住的提示：按 Esc 中斷當前動作；
#    要完全退出就按 Ctrl+C 兩下（放心，退出不會丟資料）
claude logout              # 2. 登出目前這個沒額度的帳號
claude login               # 3. 登入你的第二個帳號
# 4. cd 回原本的工作目錄，接回「同一個」 session：
claude --continue          # 接最近一次（也可寫 claude -c）
claude --resume            # 或叫出選單挑指定 session

--continue 會讀回完整脈絡、從你斷掉的地方接著做。session 存在本機、不綁帳號，換帳號登入照樣接得回來。

備案：把 session 交接給別的工具

如果第二帳號也沒額度、或你想換去還有額度的其他工具繼續，因為 session 就存在硬碟，可以「跨工具接手」。先看各工具接回自己 session 的指令：

要跨工具接手（例如把 Claude 的進度丟去還有額度的 Codex／Gemini），有兩條路：

# A. 社群工具 continues（需 Node.js）：另開終端機、cd 到專案目錄
npx continues              # 選那個 Claude session → 選要接手的工具

# B. Grok 內建的接手 skill（隨 Grok 安裝就有，是官方 bundled skill）
/resume-claude            # 在 Grok 裡接手最近的 Claude Code session
/resume-codex             # 接手 Codex
/resume-cursor            # 接手 Cursor

Claude 在一次對話裡，會把整段聊天記錄都放在它的「context 視窗」（短期記憶）。對話越長，這個視窗越滿——回應變慢、花費變高，快塞滿時 Claude 還會自動把舊內容摘要壓縮，細節可能因此糊掉。所以「適時清理 context」是用得順不順的關鍵。

/clear — 清空，重新開始

當你切換到不相關的新任務時，輸入 /clear 把目前對話清空、context 歸零。留著上一個任務的舊內容只會拖慢速度、增加花費，又容易讓 Claude 被無關脈絡干擾。換題目就清，是最該養成的習慣。

/compact — 壓縮，但保留脈絡

如果你還想延續同一件事、但對話已經很長，用 /compact 讓 Claude 把前面的內容摘要壓縮、騰出空間又不完全失憶。還能指定保留重點，例如 /compact 著重在程式碼修改和 API 用法。（其實接近滿的時候系統也會自動壓縮。）

收尾習慣：clear 前先存進度（/clear-prep）

這裡有個容易忽略的陷阱：/clear 一下去，這次對話的進展就沒了。但別忘了 section 04 講的——CLAUDE.md 會跨對話留存。所以正確的收尾順序是：先把進度寫進專案的 CLAUDE.md，再 /clear，下次開新對話就能無縫接上。

/clear-prep 就是為此做的自訂指令：清空前先自動把這次 session 的進展、決定、待辦寫進當前專案的 CLAUDE.md。（這類 / 開頭的自訂指令你可以自己做一個——把固定流程包成一句指令。）

# 收尾的正確順序
/clear-prep   # 1. 先把這次進度寫進專案 CLAUDE.md
/clear        # 2. 再清空 context，乾淨地結束

Obsidian 是一款本機優先的筆記軟體：你的筆記就是電腦上一個資料夾裡的一堆 .md 純文字檔（這個資料夾叫 Vault 庫）。把筆記、記帳、行程、靈感都收進來，就是你的「數位大腦」。

安裝：直接叫 Claude Code 幫你裝

Obsidian 本體是個 app，到 obsidian.md 下載就行（三平台都有、個人免費）。但更省事的作法是——在終端機跟 Claude Code 說一句「幫我安裝 Obsidian」，它會用你系統的套件管理器（Windows 的 winget、macOS 的 brew）裝好。這正是 Claude Code 的精神：能用講的，就別自己一步步點。

規劃結構：用「討論」的，不用一個個點設定

Vault 說穿了就是一個資料夾。與其在設定選單裡點來點去，不如在你想當數位大腦的資料夾開終端機、啟動 claude，直接跟它討論你要的結構，它就幫你建好。例如：

# 跟 Claude 說（自然語言就好）
幫我把這個資料夾規劃成我的數位大腦：
最上層分「生活」「工作」兩大類，再建一個 attachments 放所有附件。
生活底下分財務、健康、隨筆；工作底下分系統管理、會議。

交給 Claude Code 操作

把 Vault 準備好之後，cd 進這個資料夾、啟動 claude，你的數位大腦就接上 AI 了。常見玩法：

• 記帳：把帳單照片丟進 attachments，請 Claude 讀出金額、填進你的 markdown 記帳表
• 整理：請它把散亂的筆記分類、加標籤、建索引、找出重複內容
• 產出：請它讀某個主題的筆記，彙整成一篇文章、簡報，甚至像這頁一樣的網頁

最後收幾個讓你用得更快、更省、更順手的小技巧。

claude --dangerously-skip-permissions

當你開始信任 Claude Code，下一步是讓它不關機——跑在一台全天開著的機器上，變成隨時待命的個人助理。你正在看的這頁背後，就有一隻這樣的 Agent 長駐在 VPS 上運作。

① 部署在 VPS 或 Mac mini，全年無休

把 Claude Code 裝在一台不關機的機器上，它就能 24 小時待命：

• 選一台常開的機器：雲端 VPS（如 Hetzner、DigitalOcean、Linode，月費約幾美金）或家裡一台 Mac mini／迷你主機——省電、安靜，適合擺著長跑
• 用排程(cron)讓它自動做事：每天早上自動報天氣、行事曆、股市；定時抓資料整理成摘要推給你。人不在電腦前，它照樣替你跑
• 用通訊軟體當遙控器：把它接上 Discord／Telegram，你在外面用手機丟一句話就能下指令、收結果，像跟真人助理對話

② 多代理交叉查核：雙驗 / 三驗

單一 AI 難免有盲點或幻覺。進階玩法是把同一個問題派給多隻不同家的 Agent 各自獨立作答、再交叉比對——用「會議室裡多人覆核」取代「單人說了算」。

• 雙驗：同一道題同時丟給兩個不同廠牌的 Agent（例如 Claude Code＋另一家 CLI Agent），兩邊互不看對方答案各自查證，再並列出一致處與分歧處
• 三驗：再加第三方獨立作答，標出「三方一致 / 兩方同意一方異議 / 三方各異」，可信度更高
• 鐵律是「盲測」：誰都不先看別人的答案，避免互相帶風向；對任何分歧、或只有一方提到的主張，一律再主動查證後才下定論（單方提及 ≠ 就是幻覺）

最後一個進階玩法，老師特別用得上：用一句話，讓 Claude Code 幫你把一個主題變成一支有動畫、插圖、旁白的影片。教學/概念講解是最常見用途，但宣傳片、活動預告、班級/學校公告、成果回顧、社群短片用的是同一套流程，只差內容不同，全程台灣用語、台灣口音。

① 先搞懂：模型是「導演」，不是「畫筆」

很多人以為某個 AI「會生影片」，其實語言模型（Claude、GPT…）自己不畫畫面、不發聲音，它扮演的是導演：寫腳本、下指令、指揮各種工具產出素材，最後組成影片。真正產出畫面/聲音的是下面這些工具：

• 🖼️ 生圖：codex 的 Image 2（gpt-image-2）——生教學插圖，繁體中文少字也幾乎全對
• 🎬 動畫排版：Remotion（用程式碼寫影片，React 語法）——投影片動畫、圖表、步驟卡
• 🎙️ 旁白：Edge TTS 台灣語音（曉臻／曉雨／雲哲），免費免帳號
• 🈶 字型：Noto Sans TC，解決中文變「豆腐方塊」的問題

② 關鍵理念：資料驅動，做影片＝改一份 JSON

重點不是「每次叫 AI 重寫一整支影片的程式碼」（那樣容易出錯、風格還會飄）。正確做法是把影片內容寫成一份 lesson.json 資料（每一段的旁白、步驟文字、要哪種畫面），再由一套固定的元件庫讀這份資料自動渲染。改內容只要改 JSON，不用碰程式碼。

③ 台灣用語不出戲

流程裡放了一份台灣用語詞彙表當檢查關卡，強制把「視頻→影片、算法→演算法、代碼→程式碼、默認→預設」全部換成台灣講法，成品不會冒出中國用語。

④ 現成的開源工具包

這整套已經包成一個開源專案＋Claude Code skill，Mac／Windows／Linux 都能跑：

• 把 skill 複製到 ~/.claude/skills/，之後對 Claude 說一句「用 taiwan-agent-video 做一支講『什麼是迴圈』的資訊課影片」就會自動跑：寫 lesson.json → 台灣用語檢查 → codex 生圖 → Edge TTS 配音 → 輸出 1080p 影片
• 專案位置：github.com/yongcilin/taiwan-agent-video（MIT 授權，可自由取用）

上一章做影片需要插圖，圖是哪來的？答案是：Claude Code 自己不生圖，但它可以當「總指揮」，調度裝在同一台機器上的其他 CLI 去生圖，補上它不能生圖的缺口，生完再把檔案撈回來用（當插圖、配圖，或餵進第 12 章的影片）。這一章教你把兩個生圖幫手裝起來：OpenAI 的 codex（用 Image 2）和 Google 的 agy（用 Gemini 生圖）。

① 安裝並登入 codex CLI（OpenAI）

# 1. 安裝（需要 Node 環境）
npm install -g @openai/codex
# 2. 啟動：直接在終端機打 codex，就會進入互動介面
codex
# 3. 登入：打 codex login，會開瀏覽器用 ChatGPT 帳號認證（免費/Plus/Pro 都能登）
codex login
# 4. 檢查登入成功
codex login status              # 成功會顯示 Logged in using ChatGPT
# （選用）萬一生圖失敗時，才用這行自我診斷生圖功能在不在
codex features list | grep image  # image_generation 顯示 stable / true 就是好的

codex 生的是 Image 2（gpt-image-2），繁體中文少字幾乎全對，很適合做教學插圖。

② 安裝並登入 agy（Google Antigravity CLI）

安裝指令分作業系統，別用錯——Windows 和 Mac/Linux 不一樣：

# 1. 安裝　〔Windows：用 PowerShell〕
irm https://antigravity.google/cli/install.ps1 | iex
#    〔Mac / Linux：用終端機〕
curl -fsSL https://antigravity.google/cli/install.sh | bash
# 2. ★裝完務必「關掉、重開一個新的終端機/PowerShell 視窗」，PATH 才會更新★
# 3. 初次登入：打 agy 啟動，第一次跑會自動要求 Google 認證
agy
# 4. 檢查裝好了沒
agy --version          # 或 agy models 看模型清單

③ 設定好之後：你只要對 Claude 講白話

①② 裝好登入後就完工了。回到 Claude Code，直接說人話，Claude 會自己判斷用 codex 還是 agy、自己跑指令、把圖撈回來給你。你要做的，就只是說出這樣一句：

＊ 為什麼要點名「調度 agy／用 codex」？因為 Claude Code 自己不會生圖，codex／agy 只是裝在機器上的其他工具——講明要用哪個最準。想更省事：把「生圖時請調度 codex 或 agy」寫進 第 06 章的 CLAUDE.md，之後你連工具都不用提，只說「生一張…的圖」，Claude 就會自己挑。

# A. Claude 幕後派 codex 生圖時，跑的是：
codex exec --skip-git-repo-check --ephemeral "用內建生圖工具產一張：橘貓太空人卡通圖"
#    產物 →  ~/.codex/generated_images/<session>/call_*.png

# B. Claude 幕後派 agy 生圖時，跑的是（非互動加 --dangerously-skip-permissions 免卡核准）：
agy --dangerously-skip-permissions -p "用 generate_image 生成一張橘貓太空人卡通圖，ImageName 用 orange_cat"
#    產物 →  ~/.gemini/antigravity-cli/brain/<session>/<名字>_<時間戳>.jpg

④ 免費版 ChatGPT／Gemini 能用 CLI 嗎？生圖張數限制

能，但都有每日上限，適合少量玩，大量生圖會撞牆：

學 Claude Code 與 AI Agent 一路上會反覆撞到這些詞，這裡用一句白話講清楚（前面章節提過的也收進來，方便回查）。