# Coolkid AI Lab — llms-full.txt

> Claude Code 新手入門的全過程，從安裝到做出第一個能用的工具，免費公開給沒有工程背景的普通人。想有人帶著做，另有一對一陪跑，先從 30 分鐘免費諮詢開始。

> 收錄新手教學連載 + 免費工具的完整文章內容(markdown),供 AI agent 一次抓取。
> 索引(短)版見 https://www.coolkidlab.com/llms.txt(完整全站連結清單)。SEO Journey 連載與其他頁的完整內容請依索引 URL 抓 HTML。
> 最後更新:2026-09-04

## 新手教學(成長史)— 完整內容

## 第一次用 AI 做網站：不會寫程式硬著頭皮上線

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-beginner-make-website.html
> 第一次用 Claude Code 做網站的完整 step-by-step：30-60 分鐘做出能上線的條件式問答工具。含資料夾命名、AI 規劃模式切換、GitHub + Vercel 部署完整指令。

短答給趕時間的人：不會寫程式也做得出能上線的小網站，卡住的地方多半是環境設定跟指令怎麼下，不是程式碼。三件事先知道就少繞路。第一，資料夾名稱只用英文，我用中文命名，Claude Code 讀進去整個變問號，卡了 1 小時。第二，Windows 跑指令跳出一整片紅字，那是電腦的安全設定擋住，跟 AI 寫的程式碼無關，用系統管理員開 PowerShell 跑一次 Set-ExecutionPolicy 就過。第三，AI 常常只交一份規劃，沒動到檔案，開頭補一句「不要規劃，直接動手改 [檔名] 的 [功能]」。整套做到 Vercel 上線 30 到 60 分鐘。

我朋友開的投資理財教育公司想要一個小工具，讓使用者測自己的投資個性。這件事就丟給我做。

我不會寫程式，以前看到 HTML 這幾個字都會頭痛。但用 Claude Code 一陣子之後，還是硬著頭皮接了下來。

中間踩了 4-5 個雷才上線。

這篇把當初撞過的牆整理成一篇教學，一步一步帶你做完。

讀完你會做出一個能公開上線的「條件式問答工具」。

投資個性測驗、MBTI、新手引導的篩選器、產品推薦器這些都算，任何「照使用者條件挑題目」的需求都套得上。

30-60 分鐘可以全部跑完，動手之前要先準備四樣東西。

Claude Code 要先裝好，還沒裝的先看 Windows 安裝那篇。資料夾要用英文命名。

Vercel 帳號跟 GitHub 帳號各申請一個，兩個都是免費的。

另外要有 Anthropic 的 Pro 訂閱，一個月 US$20。

### 第一次用 AI 做網站要從哪裡開始？

從「正確命名一個英文資料夾」開始。聽起來很笨，但這是新手最常卡住的第一關。

我自己第一次用中文資料夾名稱，Claude Code 讀進去整個變問號，卡了整整 1 小時，才發現問題出在這裡。

正確的開檔流程有三步。

1. 在桌面新建一個資料夾，名稱用英文加連字號，例如 my-quiz-site。中文、空格、特殊符號都不要用。
2. 打開 PowerShell（Windows）或 Terminal（Mac），用 cd C:\Users\你的名字\Desktop\my-quiz-site 進到資料夾。
3. 輸入 claude 啟動 Claude Code，這個資料夾就變成 AI 的工作目錄，後面所有檔案都會建在這裡。

資料夾這關過了之後，下一關是電腦本身的安全設定。Windows 使用者最容易在這裡卡住。

### 為什麼 AI 寫程式會跳一片紅字，電腦安全設定要怎麼處理？

AI 那麼強，但連我電腦上的安全設定、權限這些雜事，都不會自己處理。

資料夾改好之後第一次叫 Claude Code 跑指令，畫面跳出一整片紅字，AI 在旁邊解釋了一堆我聽不懂的東西。

後來才發現不是 AI 的錯。是我的電腦不讓我這樣執行指令，跟 AI 寫的程式碼沒有關係。

那第一次遇到紅字，到底要先改哪一個設定？Windows 的解法，是用系統管理員身分打開 PowerShell。

輸入 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 之後按 Enter。跳出確認的時候打 Y。

設定一次就終身有效。詳細的步驟看「Claude Code Windows 安裝踩雷實錄」那篇第 3 節。

Mac 幾乎不會遇到這關。如果跳出 sudo 提示，輸入電腦密碼按 Enter，就會過。

Mac 預設的安全設定，比 Windows 寬鬆很多。

這裡可以整理出一個分工。AI 是幫你寫東西的助手，你的電腦歸你自己管。

電腦的環境、設定、權限這些東西，最後還是要自己懂一點基本概念，因為電腦這一層沒設好，AI 再厲害也動不了。

### 卡住的時候，新手要怎麼判斷問題出在哪一層？

新手最容易把所有問題都丟給 AI 去修。但畫面出問題的時候，第一個該懷疑的是哪一層？

先分清楚問題在哪一層，AI 才能幫對忙。下面是我自己找問題的順序，從最常見的排到最少見的，照著從上往下看一遍，大概就知道問題是卡在哪一層。

- 畫面有亂碼或問號 → 通常是檔案命名或編碼問題。先檢查資料夾名稱裡有沒有中文或特殊符號。
- PowerShell 或 Terminal 跳紅字 → 通常是電腦安全設定或環境變數，跟 AI 寫的程式碼沒關係。先看第 2 節的解法。
- 自己電腦看得到、網路上看不到 → 還沒部署到雲端，要 push 到 GitHub + Vercel。看第 6 節。
- AI 一直在規劃但沒真的改檔 → 要明確下指令「不要規劃，直接動手改 [檔名]」。看第 4 節。
- 改完看不到效果 → 瀏覽器快取或 Vercel 部署延遲，用無痕視窗打開，才不會被舊版畫面誤導。

先判斷再請 AI 動手。這樣可以省掉 90% 的卡關時間。

我現在遇到問題一定先做這一步。

### 怎麼讓 AI 從「規劃模式」切到「動手模式」？

用明確的指令告訴 AI「不要規劃，直接動手」就好。

AI 預設會先給你一份規劃文件，看起來很專業，但不會真的改到檔案。

新手第一次用很容易被漂亮的規劃唬過去，以為 AI 已經做完了。

我自己卡過一次。請 AI 照使用者填進去的條件給出不同題目，AI 回了一份「執行策略」，又附上一份「優先順序」的排序清單。

規劃寫完之後，Claude Code 跟我說「我不記得有什麼計畫，你想要我改什麼？」那一刻真的謝囉。

那句範本到底該怎麼寫才有用？我每次要 AI 真的動工，開頭都會講這一句。

「不要規劃，直接動手改 [檔名] 的 [功能]。需要的時候才回報進度。」

這個範本可以省掉 1-2 次無效規劃。

寫程式碼的時候，我會把 [檔名] 換成 index.html，把 [功能] 換成「年齡篩選邏輯」這種具體的東西。講得越具體，AI 越不會自己多想。

### 第一個能跑的網站怎麼從 0 做到 100？

下面用「條件式問答工具」當範例，一步一步做完一輪。

做完你會有一個小網站，能照使用者填進去的年齡跟身份，自動挑出對應的題目。

投資個性測驗、MBTI、新手引導的篩選器，背後都是同一套做法，換掉題目跟標籤，就會變成完全另一個工具。

1. 步驟 1：跟 AI 講清楚需求。在 Claude Code 輸入：「我想做一個 [主題] 測驗網站。每題有屬性標籤，使用者輸入年齡跟身份，系統照條件挑出 10 題隨機抽。請建一個 index.html 加一個 quiz.js，題目用 JSON 結構放在 data.js。不要規劃，直接建檔。」
2. 步驟 2：給 AI 樣本題目。準備 5-10 題範例題目給 AI 看格式，像是：{ q: '20 歲剛出社會應該優先做什麼？', tag: ['young', 'low-asset'], options: [...] }。AI 會照這個結構產生剩下的題目。題目給得越具體，AI 生出來的越接近你要的。
3. 步驟 3：在自己電腦上看效果。資料夾裡有 index.html，直接點兩下用瀏覽器打開。輸入年齡跟身份按下去，看有沒有跳出對應的題目。沒對的就把錯誤截圖丟回 Claude Code，說「這裡卡住了，看怎麼修」。
4. 步驟 4：邏輯對上之後再加美化。叫 AI 用 Tailwind CSS、NES.css 或任何你喜歡的 CSS 框架做介面。一句指令就好：「幫我用 [風格] 重做介面，保留現有功能不要改邏輯。」
5. 步驟 5：寫 README.md。叫 AI 寫一份 README 說明這個專案是什麼、怎麼跑、怎麼部署，為下一步上架 GitHub 做準備。

跑完五步，你已經有一個能在自己電腦上跑的網站。

看到「20 歲、剛出社會」跳出珍奶的題目、「60 歲、資產 1000 萬以上」跳出信託退休理財的題目，那個「邏輯對上了」的瞬間會很有感。

新手大概會冒出一句「乾，我居然真的做出來了」。

下一步是把這個網站公開上線。

（補充：本範例工具示範用，不構成投資建議，也不推薦任何金融商品。）

### 做完之後怎麼把網站從「自己電腦」公開到「全世界」？

東西在自己電腦上跑起來之後，要怎麼讓別人也打得開？用 GitHub 做版本控管，用 Vercel 做部署。

兩個都免費，五分鐘就設定完。

之後改完程式碼，會自動重新部署。下面是完整的五個步驟。

1. 步驟 1：註冊 GitHub 帳號（github.com），建一個新的 repository，名稱跟資料夾一樣，例如 my-quiz-site。要設成 Public，之後 Vercel 免費方案才用得了。
2. 步驟 2：在 Claude Code 跟 AI 說：「把現有資料夾 push 到 GitHub repo [your-username]/my-quiz-site，需要的話幫我 init git。」AI 會跑 git init、git add、git commit、git remote add、git push 整套指令。第一次推上去會問 GitHub 帳號密碼，照填就好。
3. 步驟 3：註冊 Vercel 帳號（vercel.com），用 GitHub 帳號登入最快。點 Add New → Project，找剛剛推上去的那個專案，按 Deploy。Vercel 會自動偵測檔案結構，1-2 分鐘部署完。
4. 步驟 4：部署完 Vercel 會給你一個網址，例如 my-quiz-site.vercel.app。用手機打開那個網址實際測一遍功能，能跑就過關。
5. 步驟 5：之後每次改完程式碼，在 Claude Code 講「push 到 GitHub」，Vercel 偵測到變動會自動重新部署，1-2 分鐘新版就上線。不需要手動上傳任何東西。

用手機打開那個公開的網址，看到自己做的東西在外面真的能用，那個瞬間的成就感，會讓人想馬上動手做下一個東西。

這種信心比技術本身值錢，技術可以慢慢學，但相信自己做得出來，才會有下一次動手的動力。

### 不想自己做、想直接被帶怎麼辦？

找人一對一帶你做，從安裝到上線一次走完，不用自己研究。

上面這套流程自己跑完大概要 30-60 分鐘，前提是有耐心把整篇文章讀完，也願意在卡住的時候自己動手找問題。下面三條中了任何一條，可能就不適合自己跑。

- 沒時間自己研究、看長文會頭痛
- 想要一個專屬於你領域的工具（像是客戶新手引導的篩選器、產品推薦器、品牌測驗），不是公版範例
- 卡住的時候不想自己去 Stack Overflow 找答案

這時候可以直接找 不想自己研究我教你（規劃中）。

一對一帶你把整套跑完，從需求釐清、Claude Code 安裝、第一個專案上線，到公開紀錄過程的帳號開起來。

好處是不用自己找問題，不用讀長文，卡住的時候有人可以問。代價是要付費。

適合沒時間自己研究、不想看長文，又想直接從 0 做到 1 的人。

### Summary

第一次用 AI 做網站，一步一步的完整流程。1) 用英文命名的資料夾開檔。2) Windows 跑 Set-ExecutionPolicy 處理電腦安全設定。3) 卡住先判斷是哪一層的問題（檔名、環境、部署、規劃模式）。4) 用「不要規劃，直接動手改 [檔名]」這句指令範本切換 AI 的模式。5) 五步建出條件式問答工具（投資測驗、MBTI、新手引導篩選器都能套）。6) GitHub 加 Vercel 五步部署上線，之後改完程式碼會自動重新部署。全部跑完 30-60 分鐘。沒時間自己跑，就看上面的 不想自己研究我教你。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。
- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **PowerShell**：Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。
- **編碼（encoding）**：電腦儲存文字的方式。Windows 中文環境常用 Big5，多數程式假設 UTF-8，兩邊對不上就變亂碼 — 所以資料夾、檔案建議用英文命名。
- **提交（commit）**：Git 的一個存檔點：把這次改動連同一句說明記錄下來，之後隨時可以回到這個版本。
- **無程式碼（no-code）**：不寫程式、用拖拉跟設定做出應用的工具或方法。AI 代理出現後，「會描述需求」比「會不會寫程式」更關鍵。
- **HTML**：網頁的骨架語言，定義「這是標題、這是段落、這是圖片」。

### FAQ

**Q: 第一次用 AI 做網站要會寫程式嗎？**

不需要。用 Claude Code 這種 AI 寫程式的工具，你的角色是「把需求講清楚」加「驗證對不對」，不是自己寫每一行程式碼。我自己是全職交易者，完全沒有寫程式背景，跟著本文一步一步做，30-60 分鐘可以做出第一個能上線的網站。比較重要的是知道怎麼跟 AI 講需求，還有卡住的時候怎麼判斷是哪一層出問題（看本文第 3 節）。

**Q: AI 寫網站需要付費工具嗎？**

需要 Anthropic Pro 訂閱（US$20/月）才能用 Claude Code。GitHub 跟 Vercel 都免費。一個月成本 US$20，相當於 NT$650 左右，跟 Netflix 差不多。如果只想試試看再決定要不要付，Pro 月繳可以隨時停。完全免費的替代方案有 Cursor 免費版或 GitHub Copilot 免費版，但對非工程師來說，Claude Code 的中文對話跟「直接改檔案」用起來最順。

**Q: AI 做的網站怎麼免費部署上線？**

Vercel 免費方案最適合非工程師。流程是把專案推到 GitHub（免費），Vercel 用 GitHub 帳號登入，點 Add New Project 選那個專案，按 Deploy，1-2 分鐘給你一個 .vercel.app 網址。之後每次改完程式碼推到 GitHub，Vercel 偵測到會自動重新部署，不用手動上傳。完整步驟看本文第 6 節。

**Q: AI 卡在「規劃模式」一直不動手怎麼辦？**

用明確的指令範本：「不要規劃，直接動手改 [檔名] 的 [功能]。需要的時候才回報進度。」AI 預設會先給規劃文件，看起來很專業但不會真的改到檔案。指令裡明講「不要規劃」，再指定具體的檔名跟功能，AI 才不會空轉。我自己每次要 AI 真的動工都會用這個範本，可以省掉 1-2 次無效規劃。詳細看本文第 4 節。

**Q: AI 第一次寫的 code 跑不起來怎麼辦？**

先判斷錯誤在哪一層，再決定怎麼修。從最常見的排下來：1）資料夾命名有中文，改成英文。2）電腦安全設定擋住，PowerShell 跳紅字，跑 Set-ExecutionPolicy。3）瀏覽器快取沒清，用無痕視窗打開。4）AI 沒真的改到檔案，用「不要規劃，直接動手」指令。5）部署延遲，等 1-2 分鐘讓 Vercel 重新部署。找問題的順序看本文第 3 節，這個順序可以省 90% 的卡關時間。

**Q: 第一個 AI 網站專案做什麼題材最好上手？**

做「自己每天會用、家人會用、朋友需要」的小工具最好上手。技術門檻低，需求也清楚，做完馬上能用，新手建立信心最快。像是條件式問答工具（投資測驗、MBTI）、待辦清單、家庭行事曆、童裝庫存管理頁、家族 LINE 機器人。不要挑「我要做一個訂閱制產品來賺錢」這種題目當第一個，需求太大會中途放棄。我自己第一個專案是幫朋友的投資理財教育公司做的條件式問答工具，第二個是給老婆童裝店的庫存管理頁，都是身邊真實的需求。

---

## Vercel 部署還是舊版？我以為很快，改了 3 小時

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-vercel-deploy-not-working.html
> Vercel 部署不更新完整 troubleshoot SOP:3 層同步診斷(本機 / GitHub / Vercel)、部署前 5 步 checklist、什麼時候該重寫不該修補的決策框架。新手避開卡 3 小時的雷。

短答給趕時間的人：改完程式碼、正式網站卻還停在舊版，多半是自己電腦、GitHub、Vercel 這三層有一層沒接好，程式碼本身沒問題。三層各跑各的，任何一層斷掉，網站就不會更新。照順序查三件事：github.com 上專案最新一筆 commit（把改動送出去的那次紀錄）的時間是不是剛剛，vercel.com 的 Deployments 最新一筆是 Ready 綠燈還是 Failed 紅燈，最後用無痕視窗打開正式網址，免得瀏覽器拿舊畫面騙你。這份清單跑一遍大概 1 分鐘。我自己不知道有這三層，卡了 3 小時。

稍微熟悉 AI 寫程式之後，我又靈機一動，想幫賣童裝的老婆做一個用手機就能管庫存、又能看當月營收的小網頁。

原本以為功能不複雜，加幾個欄位、再放幾個查詢按鈕，一個晚上應該就能收工。

一開始真的很順。做完之後在自己電腦上打開，每個按鈕都會動，數字也都對。

結果我想加一個「搜尋庫存」功能的時候，撞上做網站以來最玄的一次卡關。

自己電腦看得到，網路上的正式網站卻完全沒有變化。

這一卡就是 3 小時。前半段我一直在把消失的功能補回來，後半段我開始懷疑自己是不是哪一步做錯了，偏偏翻來覆去怎麼找都找不到那一步。

這篇把那 3 小時的痛，重整成一步一步照著做的教學。

讀完你會做出三樣東西。第一樣是一個手機就能打開的庫存管理小頁，第二樣是一份部署前的 5 步檢查清單，讓你下次不用再花 3 小時在同一個地方繞。

第三樣是一套判斷方法，讓你知道什麼時候該砍掉重寫、什麼時候繼續修比較快。整套跑完大概 30 到 60 分鐘。

### 為什麼自己電腦看得到、Vercel 上的正式網站卻完全沒變化？

因為「自己電腦」「GitHub」「Vercel」是三個獨立的地方，不是同一個檔案。

新手最容易把這三層當成一層，但這三層其實各跑各的。

自己電腦上有，不代表 GitHub 上也有。GitHub 收到了，也不代表 Vercel 已經換成新版。

任何一層斷掉，網站就停在舊版。

我自己卡 3 小時就是這個原因。搜尋庫存的功能在自己電腦點下去會跳出結果，但 Vercel 的網址打開，畫面像沒事人一樣。

那 3 小時我一直把消失的東西補回來，也一直重傳，但每次打開網址還是同一個舊畫面。

問題不在程式碼本身，而是三層裡面有一層沒接好。

卡住的時候先不要急著叫 AI 修。退一步問自己一句話就好，到底是哪一層沒有同步？

下面 5 個問題照順序問一遍，可以定位九成的部署問題。

- 我自己電腦上的版本是最新的嗎？（編輯器右上角有沒有「未存檔」小圓點）
- 檔案有沒有真的存好？（按 Ctrl+S 確定一次）
- 有沒有送上 GitHub？（打開 github.com 的專案，看最新一筆 commit 的時間是不是剛剛）
- Vercel 有沒有重新部署？（vercel.com 打開專案看 Deployments 頁籤最新一筆狀態）
- 我打開的網址是真的正式網站嗎？（不是 localhost、不是預覽網址，是 .vercel.app 或自訂網域）

照順序問下來，第一個讓你答「不確定」或「沒有」的那一層，就是問題所在。

先修那一層，不要跳著修。

### Vercel 部署不更新，最常見的 3 個原因是什麼？

下面 3 個原因，涵蓋我自己跟身邊新手九成五的部署不更新案例。從最常見的開始排。

原因 1，程式碼沒有送上 GitHub。

改完檔案之後，我以為 Vercel 會自己發現，但 Vercel 只看 GitHub 上的那個專案，沒送上去等於什麼都沒發生。

怎麼確認？在 Claude Code 跟 AI 問一句「剛剛改的東西有 push 到 GitHub 嗎」，沒有就請 AI 直接送上去。

也可以自己打開 github.com 上的專案，看最新一筆 commit 的時間是不是剛剛。

原因 2，瀏覽器的快取在騙你。

程式碼跟 Vercel 兩邊其實都對了，但你電腦上的瀏覽器為了省流量，直接把之前存下來的舊畫面拿出來給你看。

要怎麼分辨？用無痕視窗打開正式網址，無痕視窗不會吃舊快取。Chrome 按 Ctrl+Shift+N，Safari 按 Cmd+Shift+N。

無痕視窗看得到新版，那就是被快取騙了。

原因 3，Vercel 部署失敗了，但你不知道。

Vercel 收到新的 commit 會自動跑一次建置，建置失敗的時候不會主動發信通知你，除非你<a href="/newbie-pitfalls/site-not-updating-after-push.html">自己去把通知設定打開</a>。

那要去哪裡看？打開 vercel.com 的專案，點 Deployments 頁籤，看最新一筆是 Ready 綠燈還是 Failed 紅燈。

紅燈就點進去看 Build Log，找出哪一行是紅字。

### 怎麼建立部署前的 5 步檢查清單？（避免下次再卡 3 小時的 SOP）

我自己卡完那 3 小時之後，整理出下面這份 5 步檢查清單。

每次要上線之前先跑一遍，每一層都確認過再送上去，就不會再出現「咦，怎麼沒更新」的那一刻。

1. 步驟 1，自己電腦能不能跑？在自己電腦打開測試畫面點按鈕，看新功能會不會出現。沒出現就先在自己電腦修好，不要急著送上去。
2. 步驟 2，檔案有沒有存好？看編輯器右上角有沒有「未存檔」的小圓點。有就按 Ctrl+S 存一次。Claude Code 改檔案會自動存，但你手動加的註解可能漏存。
3. 步驟 3，有沒有送上 GitHub？打開 github.com 你的專案，看 Commits 那欄最新一筆的時間是不是剛剛。不是就回 Claude Code 跟 AI 講「push 到 GitHub」。
4. 步驟 4，Vercel 有沒有重新部署成功？打開 vercel.com 專案 → Deployments → 最新一筆要是 Ready 綠燈。看到紅燈 Failed 就點進去看 Build Log。
5. 步驟 5，用無痕視窗打開正式網址確認。避免被瀏覽器的舊快取騙。看到新版才算真的部署成功。

5 步跑下來大概 1 分鐘。

拿 1 分鐘換掉一整晚的鬼打牆，這筆帳怎麼算都划算。

### 什麼時候該砍掉重寫、什麼時候繼續修比較快？（我自己用的判斷方法）

卡到後面，我發現一件跟直覺相反的事。

很多時候「重寫一份乾淨的版本」，比「一個一個把錯誤修掉」還要快。

但這件事有適用條件，不是每次卡住都該重寫。那什麼時候該重寫？我自己是照兩組訊號判斷的。

下面這幾個是該重寫的訊號。

- 同一個錯誤修 3 次以上還是會再跑出來
- 改 A 功能會壞 B 功能、改 B 功能會壞 C 功能（牽一髮動全身）
- AI 自己也說「這個狀況有點詭異」「我也找不到原因」
- 前面被反覆修改超過 5 次，整個專案結構已經看不懂
- 你自己打開程式碼，都不知道哪一段在做什麼了

這幾個訊號代表繼續修就好。

- 錯誤訊息明確指到某一行、某個檔案
- 這是新加的功能第一次跑壞，沒有影響到其他部分
- Claude Code 一句話就能定位問題
- 整體結構還清楚，只是某個小功能沒接好

決定重寫之後，指令可以照下面這樣下。

「請把目前這個專案的所有功能整理成一份清單，然後乾淨地重寫一份。功能清單包含：[列出你要的功能]。重寫的時候不要參考舊版有問題的部分，從零開始寫。」

最後那句「不要參考舊版」很重要。少了這一句，AI 很容易把舊版的問題一起複製到新版去。

### 手機可用的庫存管理頁怎麼從 0 做到 100？（5 個步驟做完）

下面用「童裝庫存管理頁」當範例，一步一步做完整套。

做完你會有一個手機打得開的小管理頁，可以新增商品、看目前庫存、搜尋商品名稱，也可以整理當月的營收數字。

範例是童裝，但任何「小型品項管理」的需求都套得上。像是餐廳菜單、咖啡店耗材、媽媽手作的材料，或是二手交易的帳本。

1. 步驟 1，跟 AI 講清楚需求。在 Claude Code 輸入：「我想做一個手機可用的庫存管理小頁。功能有四個。1) 新增商品（名稱、進貨價、售價、庫存數量）。2) 列出所有商品。3) 搜尋商品名稱。4) 看當月營收，自動加總。資料用 LocalStorage 存就好，不需要資料庫。請建 index.html + app.js + style.css，用 Tailwind CSS。不要規劃，直接建檔。」
2. 步驟 2，在自己電腦看效果。資料夾裡的 index.html 直接點兩下用瀏覽器打開，新增 2-3 個商品測功能。手機版面用瀏覽器的開發者工具切成手機尺寸看（Chrome 按 F12 → Toggle device toolbar）。看不順就叫 AI 修「在 768px 以下要 ___」這種具體指令。
3. 步驟 3，加搜尋功能。一句指令：「在現有 index.html 加一個搜尋框，輸入關鍵字就即時過濾商品列表，不用按 Enter。不要動其他功能。」這一步就是我自己第一次撞到 Vercel 不更新那個雷的地方，跑完記得用第 3 節的 5 步檢查清單確認一次。
4. 步驟 4，部署到 Vercel。把資料夾送上 GitHub → Vercel 連專案 → Deploy。詳細做法看「第一次用 AI 做網站」那篇第 6 節。1-2 分鐘就會給你一個 .vercel.app 網址。
5. 步驟 5，加到手機桌面。用手機 Safari 或 Chrome 打開 .vercel.app 網址 → 分享 → 加到主畫面。圖示會出現在桌面，點下去全螢幕打開，用起來像一個 App。老婆從此看庫存不用再打網址。

5 步跑完，你手上就有一個家人或自己每天會打開的小管理頁，整套大概 30 到 60 分鐘。

真正決定你做不做得出來的，是知不知道每一步該怎麼跟 AI 講，技術本身難不難反而是其次。

### 不想自己找問題、卡關就想放棄怎麼辦？

上面這套部署 SOP 跟重寫的判斷方法，自己跑得起來。

但前提是你有耐心一步一步找問題，也願意把整篇文章看完。如果下面任何一條講的就是你，可能不適合自己來。

- 卡 30 分鐘以上就會放棄，不想再繼續查
- 想要一個專屬於你領域的小工具（不是公版庫存管理）
- 需要接真的資料庫（Supabase / Firebase），而不是 LocalStorage

可以直接找 不想自己研究我教你（規劃中）。

一對一帶你從需求釐清、Claude Code 安裝、第一個專案上線，一路到 Vercel 部署 SOP，整套跑一遍。

好處是不用自己找問題，也不用看長文，卡關的時候有人帶著，5 分鐘就解決。代價是要付費。

適合沒時間自己研究、卡關就會放棄，又希望一次就把東西做好的人。

### Summary

Vercel 部署不更新的完整排查流程。第一，自己電腦、GitHub、Vercel 是 3 個獨立的層，任何一層斷掉就停在舊版。第二，部署不更新最常見的 3 個原因是程式碼沒送上去、瀏覽器快取騙人、Vercel 建置失敗你不知道。第三，部署前先跑 5 步檢查清單（自己電腦 → 存檔 → 送上 GitHub → Vercel Ready → 無痕視窗驗證）。第四，該重寫的訊號是同一個錯誤修 3 次、AI 自己也說詭異、專案結構已經看不懂。第五，手機可用的庫存管理頁有完整 5 個步驟可以照著做。整套跑完大概 30 到 60 分鐘。卡關就想放棄的人，看上面 不想自己研究我教你。

### 名詞解釋

- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。
- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **提交（commit）**：Git 的一個存檔點：把這次改動連同一句說明記錄下來，之後隨時可以回到這個版本。
- **快取（cache）**：把載過的資源暫存起來，下次直接用、不重新下載。網站變快的最便宜手段之一。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。

### FAQ

**Q: Vercel 部署完不更新怎麼辦？**

從最常見的排下來檢查 3 件事。第一，程式碼有沒有送上 GitHub？打開 github.com 你的專案看 commit 時間。第二，是不是瀏覽器快取在騙你？用無痕視窗（Ctrl+Shift+N）打開正式網址。第三，是不是 Vercel 建置失敗你不知道？打開 vercel.com 專案的 Deployments 頁籤，看最新一筆是 Ready 還是 Failed。詳細的部署前 5 步檢查清單看本文第 3 節。

**Q: 自己電腦看得到、Vercel 上沒變化是為什麼？**

因為「自己電腦」「GitHub」「Vercel」是 3 個獨立的地方，不是同一個檔案。新手最容易把這 3 層當成一層。任何一層斷掉，正式網站就停在舊版。九成九的「自己電腦看得到、Vercel 沒變化」都是因為程式碼沒送上 GitHub，或者送上去了但 Vercel 建置失敗。檢查順序看本文第 1 節那 5 個診斷問題。

**Q: AI 寫的程式碼一直修不好要重寫嗎？**

看訊號決定。該重寫的訊號是同一個錯誤修 3 次以上、改 A 壞 B、AI 自己也說「狀況詭異」、整個專案結構看不懂。可以繼續修的訊號是錯誤訊息明確指到某一行、新加的功能第一次跑壞、Claude Code 一句話就能定位問題。判斷方法詳細看本文第 4 節。重寫的指令範本是「請把所有功能整理成清單，乾淨重寫一份，不要參考舊版有問題的部分。」

**Q: Vercel 免費方案有什麼限制？**

Vercel 免費方案（Hobby）對非工程師的個人專案完全夠用，有 100 GB 流量/月、無限部署次數、自動 HTTPS、自訂網域。限制是每次部署的建置時間上限 45 分鐘、商業用途要升級 Pro（US$20/月）、Serverless Function 執行時間上限 10 秒。做庫存管理頁、心理測驗、個人網站、小工具這種規模都在免費方案範圍內。我自己從 2026 年 4 月中跑到現在沒撞到任何限制。

**Q: 瀏覽器一直顯示舊版怎麼辦？**

用無痕視窗（Chrome 跟 Edge 是 Ctrl+Shift+N、Safari 是 Cmd+Shift+N）打開正式網址。無痕視窗不吃瀏覽器快取，看到的就是伺服器上的真實版本。如果無痕看到新版、一般視窗看到舊版，表示程式碼跟部署都對了，純粹是瀏覽器快取的問題。強制重新整理（Ctrl+Shift+R）可以逼瀏覽器重抓一次，或是清掉這個網域的 cookie 跟快取。

**Q: Claude Code 改完檔案要怎麼 push 到 GitHub？**

在 Claude Code 直接跟 AI 說「把剛剛的改動 push 到 GitHub」，AI 會自己跑 git add . / git commit -m 'xxx' / git push 整套指令。第一次送上去會問 GitHub 帳號密碼或 personal access token。之後只要在 Claude Code 講「push」，AI 就會幫你送。如果跳出認證失敗的錯誤，要到 GitHub Settings → Developer settings → Personal access tokens 產生一個新的 token 貼進來。

---

## AI Agent 實戰｜Claude Code 做交易日誌 App

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-built-my-trading-journal.html
> 用 Claude Code 做交易日誌 PWA：使用情境設計法、5 個必備功能、一鍵加到手機桌面。非工程師 30-60 分鐘做出每天真的會打開的工具，step-by-step 照著做就有。

短答給趕時間的人：不會寫程式也做得出來。我是全職交易者，用 Claude Code 做了一個交易日誌，再做成 PWA（用網頁做的 App，可以加到手機桌面點開）。30 到 60 分鐘跑完，中間改了 3 到 5 輪。差別在需求怎麼寫。直接說「幫我做一個交易日誌」，AI 會給你一個欄位塞滿、打開一次就不想再開的東西。先寫開盤前、進場時、平倉後、週末檢討這 4 個使用情境，各自要看什麼、要記什麼，寫完再叫 AI 動手。資料存在自己手機裡，沒有伺服器也沒有訂閱。本工具僅供個人記錄，不構成投資建議。

我是一個全職交易者，不會寫程式。

每天要記交易、看勝率、檢討情緒，還要回顧策略。

Excel、Notion、Google Sheets 我都試過，每一個都卡卡的，就是不對。

後來我用 Claude Code 自己做了一個 PWA 交易日誌，做到每天真的會打開的程度。

這篇把整個流程重整成一步一步的做法，讀完你手上會多出三樣東西。

一份用「使用情境」寫出來的工具需求清單。

一個能在手機桌面像 App 一樣打開的 PWA，還有一個只屬於你、別人偷不走的個人工具。

範例是交易日誌，但任何「現成工具總差一點」的個人需求都套得上，像是閱讀記錄、健身追蹤、運勢日記、創作素材庫。

30-60 分鐘可以全部跑完。

前置條件有四個：Claude Code 已經裝好，資料夾路徑是英文，有 Vercel 帳號，有 GitHub 帳號，後面兩個都免費。

本範例工具僅供個人使用，不構成投資建議，也不推薦任何金融商品。

### 什麼時候該自己做工具，什麼時候用現成的？

如果你符合下面任 2 條以上，自己做會比現成工具好用。

- 現成工具用了一陣子，覺得「就是差那麼一點」，講不出哪裡卡，但就是不順
- 你的工作流有一些別人覺得「沒道理」，但你自己很需要的小細節
- 資料想留在自己手上，不想被綁在 SaaS 訂閱裡
- 市面上做這個領域的工具，普遍欄位塞太多、畫面太滿
- 想要的功能組合很特定，沒有一個現成工具完全符合

這 5 條我自己都中。

Excel 在手機上很難打，Notion 的統計要自己手刻，Google Sheets 沒辦法記情緒這種半結構化的資料。

市面上「給 1000 個人用的工具」一定有妥協，自己做「只給你 1 個人用的工具」，可以剛好對位。

這個落差，就是用 Claude Code 做工具的甜蜜點。

### 怎麼用「使用情境」設計一個你會每天打開的工具？

新手最容易犯的錯，是直接叫 AI「幫我做一個交易日誌」。

AI 會做出一個，但介面塞得很滿，欄位一大堆，打開一次就不想再打開了。

問題出在哪？多半是你給的需求太抽象，跟 AI 寫得好不好無關。

該做的是先寫「使用情境」，再叫 AI 動手。

每天會怎麼用、什麼時候打開、那一刻最需要看到什麼，把這些寫成具體場景再餵給 AI。

那要怎麼寫？下面是我自己在用的 4 個情境模板。

1. 情境 1，開盤前。要看什麼資訊，才能讓我準備好今天的交易？例如昨天的勝率、上週的累計盈虧、最近 3 筆交易的情緒紀錄。
2. 情境 2，進場時。要記什麼，之後才檢討得動？例如標的、進場價、停損、為什麼進場（一句話），還有進場時的情緒。
3. 情境 3，平倉後。要記什麼，統計才有意義？例如盈虧、有沒有按原計畫走、出場時的情緒。
4. 情境 4，週末檢討。要看什麼，下週才改得動？例如勝率走勢、情緒對盈虧的影響、最賺錢跟最賠錢的策略。

把這 4 個情境寫清楚再給 AI，做出來的東西會是「給每天用的人」設計的。

不是「給資料完整」設計的。

一個工具會不會被打開，關鍵在有沒有貼近你每天的動線，跟功能齊不齊全關係不大。

其他領域的需求也一樣，健身、閱讀、運勢都可以套這 4 個情境，把「交易」換成你的主題就好。

### 交易日誌 PWA 怎麼從 0 做到 100？

下面用「交易日誌」當範例，把 5 步完整走一次。

範例是交易，但任何「個人記錄類工具」都套得上，閱讀記錄、健身追蹤、運勢日記、創作素材庫，把功能名稱換掉就好。

1. 步驟 1，把第 2 節的 4 個情境寫成需求文件給 AI。在 Claude Code 輸入：「我想做一個 PWA 個人日誌。使用情境有 4 個：[貼上你寫的 4 個情境]。資料用 LocalStorage 存就好，不需要資料庫。請建 index.html、app.js、style.css，用 Tailwind CSS。手機優先設計，桌面也要能用。不要規劃，直接建檔。」
2. 步驟 2，在自己電腦看效果。把資料夾裡的 index.html 雙擊用瀏覽器打開，跑一次完整的使用流程，開盤前查、進場記、平倉記、週末看統計。任何一步覺得卡，就截圖丟回 Claude Code，說「這裡卡住了，應該改成 ___」。改個 3-5 輪，你會跑出真的順手的版本。
3. 步驟 3，加圖表。叫 AI 用 Chart.js 加 3 個圖，累積盈虧曲線、勝率走勢、情緒對盈虧的散點圖。一句指令：「加 Chart.js 圖表，3 個圖：1) 累積盈虧，2) 勝率走勢，3) 情緒對盈虧。資料來源是 LocalStorage 已經存好的交易紀錄。」
4. 步驟 4，加風險控制警示。叫 AI 加上「日損超標跳警告」「週損超標鎖介面」這種硬規則。對交易者來說，這個比統計圖還重要，可以強迫自己停損停手。一句指令：「加日損 -X% 跳全螢幕紅色警告，週損 -X% 鎖定新增交易功能 7 天，X 自己定義。」
5. 步驟 5，部署到 Vercel，再加到手機桌面。推上 GitHub，Vercel 連專案，按 Deploy，細節看「第一次用 AI 做網站」第 6 節。手機用 Safari 或 Chrome 打開 .vercel.app 網址，按分享，加到主畫面。下一節教怎麼做成真的像 App。

跑完這 5 步，你會有一個能在手機桌面像 App 一樣打開的個人日誌。

30-60 分鐘可以全部跑完。

資料存在 LocalStorage，等於只在你自己手機裡，沒有伺服器、沒有訂閱，別人也偷不走。

### 怎麼把網頁做成像 App 一樣加到手機桌面？

PWA 的全名是 Progressive Web App，作用是讓網頁假裝自己是 App。

加到手機桌面之後有自己的圖示，點下去全螢幕打開，不會看到瀏覽器的網址列。

對個人工具來說，PWA 就夠用了，不需要真的去開發 iOS 或 Android App。

做 PWA 需要 3 個檔案，叫 AI 一句話就能搞定。

指令是：「請把這個專案改成 PWA，加 manifest.json 跟 sw.js，圖示先用一個漸層方塊頂著，之後再換。manifest 設成 standalone 模式，主題色自己挑。」AI 會自動把檔案建好。

一個能用的 PWA，必備下面 3 件事。

1. manifest.json，定義 App 名稱、圖示、開啟方式、主題色。standalone 就是全螢幕，不顯示瀏覽器工具列。
2. sw.js，也就是 service worker，讓 App 就算離線也能打開，這是 PWA 必備的。
3. 在 index.html 的 <head> 加上 <link rel="manifest"> 跟相關的 <meta> 標籤

怎麼確認 PWA 真的在跑？

手機用 Safari 打開 .vercel.app 網址，按分享，只要看得到「加入主畫面」這個選項，設定就是對的。

加完之後從桌面點圖示，打開來像 App，沒有網址列跟 Safari 工具列，就成功了。

### 做給自己用跟做給市場用，差別在哪裡？

用 Claude Code 做工具最大的優勢，是「可以做別人覺得沒道理的功能」。

因為這個工具是給你自己用的，不是給市場用的。

差在哪裡？下面攤開來看。

- 給市場用：要服務 1000 個人，所以欄位要齊全，介面要中性，還要避免冒犯任何族群。妥協很多。
- 給自己用：只服務你 1 個人，所以可以做「拜財神功能」「抽籤頁」「個人偏好的特殊統計」這種別人覺得沒道理的東西。剛好對位。
- 給市場用：要考慮新手引導，要寫教學，要客服，還要顧轉換率。這是一整套商業模式。
- 給自己用：你就是用戶，不需要新手引導，做出來就直接用，沒有適應期。
- 給市場用：介面要適合 1000 種人，所以要拉很多設定選項出來。
- 給自己用：介面對你順就好，可以把你的偏好直接寫死，不留設定。簡單直接。

我自己的交易日誌，有一頁是拜財神加抽籤的地方。

做交易的人會懂，這是儀式感跟定錨。

給市場做的工具不會放這種東西，給自己做的就可以，而這個差別，決定了你會不會每天打開。

### 不想自己做、想直接被帶怎麼辦？

上面這套自己跑大概 30-60 分鐘，前提是有耐心，而且願意改個 3-5 輪。

如果你符合下面任何一條，可能就不適合自己跑。

- 不想花時間寫「使用情境」這種需求釐清
- 想接雲端資料庫，像 Supabase 或 Firebase，做多裝置同步
- 需要更複雜的功能，例如多帳戶、用 API 接券商、自動匯入交易紀錄

可以找「不想自己研究我教你」這個服務（規劃中）。

一對一帶你從需求釐清、4 個情境設計、Claude Code 操作，到 PWA 部署整套跑完。

好處是不用自己找問題、不用看長文，卡關有人帶，5 分鐘就解掉。

代價很直接，就是要付費。

適合沒時間自己研究、想直接拿到專屬工具，或是卡關就會放棄的人。

### Summary

用 Claude Code 做個人 PWA 交易日誌的完整做法：1) 決策框架，5 條中 2 條就值得自己做。2) 用 4 個使用情境寫需求，分成開盤前、進場時、平倉後、週末檢討，不要直接叫 AI 寫程式。3) 5 步建出 PWA，從寫需求、在自己電腦調、加圖表、加風險警示，到部署再加到手機桌面。4) PWA 必備 3 個檔案，manifest.json、sw.js，還有 head 裡的相關標籤。5) 給自己用跟給市場用的差別，一個是剛好對位，一個是對 1000 人妥協。30-60 分鐘可以全部跑完。範例是交易日誌，閱讀記錄、健身追蹤、運勢日記都套得上。本工具僅供個人使用，不構成投資建議。

### 名詞解釋

- **PWA（漸進式網頁應用）**：讓網頁能「安裝」到手機桌面、像 App 一樣全螢幕開啟的技術，不用上架 App Store。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。
- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。
- **資料庫（database）**：專門儲存、查詢大量資料的系統。網站的會員、留言、紀錄都放這裡。
- **Supabase**：免費起步的雲端資料庫服務，提供資料庫＋登入驗證＋API，個人專案很夠用。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **LocalStorage（瀏覽器本機儲存）**：資料只存在你自己這台電腦的瀏覽器裡，換一台裝置或清掉瀏覽器資料就沒了。適合做「先演一次」的假登入，不適合真的會員系統。

### FAQ

**Q: 用 AI 做個人工具要會寫程式嗎？**

不需要。用 Claude Code 這類工具的時候，你的角色是把使用情境寫清楚，再驗證做出來順不順，不是自己寫每一行程式碼。我是全職交易者，完全沒有寫程式背景，30-60 分鐘就能做出一個在手機桌面像 App 一樣用的個人日誌。真正要學的是「使用情境設計法」，看本文第 2 節，不是學程式語言。

**Q: PWA 是什麼？跟 App 有什麼差別？**

PWA 的全名是 Progressive Web App，是用網頁技術做出來的 App。可以加到手機桌面，有自己的圖示，點下去全螢幕打開，看起來跟用起來都像 App。差別在這裡：iOS 或 Android 的真 App 要寫 Swift 或 Kotlin，要過 App Store 審核，還要繳開發者費用。PWA 用 HTML、JS、CSS 做，直接從網址加到桌面，零審核零費用。對個人工具來說，PWA 就夠用了。詳細怎麼做看本文第 4 節。

**Q: 交易日誌資料存在哪裡安全？**

個人用建議用 LocalStorage，存在自己手機或電腦裡，零雲端零訂閱，別人偷不走，缺點是換裝置要重新匯入。要多裝置同步，可以接 Supabase（免費 500 MB）或 Firebase。最不建議的是放在別人的 SaaS 工具裡，一旦停止服務或漲價，你的資料就被綁住。我自己用 LocalStorage 加上每個月手動匯出一次 JSON 備份，3 年沒掉過資料。

**Q: AI 做的工具可以加到手機桌面嗎？**

可以，做成 PWA 就行。需要 3 個檔案：manifest.json 定義 App 名稱跟圖示，sw.js 也就是 service worker，讓離線也能打開，還要在 index.html 的 head 加 link rel='manifest'。叫 Claude Code 一句話搞定：「請把這個專案改成 PWA，加 manifest.json 跟 sw.js，圖示自動生成。」做完之後手機用 Safari 或 Chrome 打開網址，按分享，加入主畫面。詳細看本文第 4 節。

**Q: 為什麼直接叫 AI「做一個交易日誌」效果很差？**

因為需求太抽象，AI 會做出一個資料很完整、但介面塞得很滿的東西，打開一次就不想再打開。該做的是先寫「使用情境」，再叫 AI 動手。每天什麼時候會用，那一刻最需要看到什麼，把這些寫成具體場景再餵給 AI。我自己用 4 個情境當模板，分別是開盤前、進場時、平倉後、週末檢討，套到任何主題都通用。詳細看本文第 2 節。

**Q: 做給自己用的工具沒辦法賺錢嗎？**

個人工具有 3 條變現路。第一條，把製作過程公開記錄下來，吸引同樣需求的人付費請你帶他做。第二條，把工具開源放在 GitHub，累積技術上的名聲，之後接案或求職都用得到。第三條，工具夠成熟之後把個人化的部分抽掉再公開，做成 SaaS，這條最難，不建議當第一目標。我自己走第 1 條，把交易日誌的製作過程拆成公開記錄的內容，吸引同樣是交易者、又想用 AI 做工具的人來看。商業是副作用，主軸還是工具自己用。

---

## Threads 自動發文機器人｜Claude Code 教學

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-daily-thread-auto-poster.html
> 不用 n8n、不裝平台。用 Claude Code 做 Threads 自動發文機器人：voice profile 萃取、GitHub trending 選題、Windows 編碼解法、token 續期。非工程師 30 分鐘上線。

短答給趕時間的人：每天自動發 Threads 的小機器人，難的不是技術，是寫出來像不像你。先萃一份 voice profile（寫給 AI 看的「我平常怎麼講話」說明書）：把自己過去 8 到 15 篇真實貼文丟給 Claude 分析，第一版大概 70 分，再自己校對兩三輪，之後每次寫稿先讓 AI 讀這份文件。素材來源挑每天有新東西、又抓得到公開資料的，我選 GitHub 當天的熱門專案。Windows 要先處理中文變問號，在程式最上面加一行 sys.stdout.reconfigure(encoding='utf-8')。整套 30 到 60 分鐘跑得完。

我每天都想分享一點東西到 Threads，把做東西的過程公開記下來。

但「想分享」跟「想的到怎麼寫分享文」，是兩件事。

很多時候我打開 App，想了 10 分鐘，然後又關掉，因為腦袋空空，不知道要講什麼。

後來我用 Claude Code 做了一個小機器人，每天晚上 8 點自動跑。

機器人會挑 GitHub 當天熱門的專案，用我的口吻寫一段介紹，再發到 Threads。

上線到現在沒出過狀況，發出去的貼文，也很少有人看出是機器人寫的。

這篇是一步一步的教學，讀完你會做出三樣東西。

一份自己的 voice profile 文件，作用是讓 AI 寫得像你，而不是像一台機器。

一個會自動抓素材、生稿、發文的小機器人，還有一個到點觸發的排程。

範例是 Threads 加 GitHub，但任何「自動發文機器人」都套得上，像是 X、LinkedIn、IG 文案、Bluesky。

30-60 分鐘可以全部跑完。

### 自動發文機器人為什麼對 build-in-public 這麼重要？

持續公開記錄最難的地方，其實是每天晚上累了之後，不想再花腦力選題、寫稿、貼出去。

問題不是「沒料可以寫」。

動作門檻比內容門檻高得多。這才是真正的關卡。

自動發文機器人解決的就是動作門檻，把「每天要分享什麼」這件事，從你的待辦清單上拿掉。

選素材來源該看什麼？我自己抓 3 個原則。

- 每天都有新內容，不會重複，像是 GitHub trending、Hacker News、各家更新紀錄、PapersWithCode
- 跟你的品牌軸線對齊，我做 AI workflow 所以選 GitHub trending，交易者可以選 finviz 或 TradingView，設計師選 Awwwards
- 有公開 API 或 RSS，不用寫爬蟲去對抗反爬機制

我選 GitHub trending。三條原則剛好都中。

每天有新的熱門專案，跟我的 AI workflow 品牌對齊，而且有公開 API 抓得到。

其他軸線的素材，可以用 RSS，或自己寫一個簡單的爬蟲，下面的步驟一樣都能套。

網路上搜「Threads 自動發文」，教學幾乎都在教 n8n 或推薦現成平台。n8n 是拖拉式自動化工具，不用寫程式，但要自己架伺服器或付月費，改邏輯得回介面拉線。現成平台更簡單，但功能受限、口吻也沒辦法調到像你。

我選 Claude Code 寫 Python，理由是整套邏輯一個檔案，壞了看 log 就知道哪裡炸，voice profile 可以調到家人看不出是 AI。兩條路都能到，看你比較怕寫程式還是比較怕拉節點。不確定要不要做自動化的人，可以先看<a href="/newbie-pitfalls/repetitive-work-automation-start.html">這篇判斷流程</a>。

### 怎麼讓 AI 寫出來的東西像你，而不是像機器人？

做自動發文機器人，最重要的其實是「寫出來像不像你」，技術反而是其次。

如果貼文長得像 ChatGPT 那種工商風格，大家一看就知道是機器人，發了還不如不發。

要讓 AI 寫得像你，得先餵一份「voice profile」當教材。

voice profile 的萃取，分成下面 4 個步驟。

1. 步驟 1，收集樣本。把過去 8-15 篇自己寫的真實貼文整理成一個檔案，Threads、X、LinkedIn 都可以。8 篇是最低門檻，15 篇最理想，少於 8 篇 AI 抓不出規律。
2. 步驟 2，把樣本丟給 Claude 分析。指令範本：「請從下面 N 篇我寫的貼文，萃取出我的 voice profile，包含開頭習慣、句法特徵、用詞偏好、情緒詞彙、結尾習慣，還有我絕對不會寫的東西，也就是反指紋。輸出格式是條列，每條附 1-2 個範例。」
3. 步驟 3，校對加補強。Claude 萃出來的第一版通常只有 70 分，要自己看一遍，補上哪些招牌詞沒抓到，刪掉哪些是 Claude 瞎掰的。改個 3-5 輪會出 85 分的版本。
4. 步驟 4，存成 voice_yourname.md。之後每次叫 AI 寫東西，就先把這份文件丟給 AI 讀。AI 會照你的招牌寫，不再是那種 ChatGPT 工商口吻。

我自己的 voice profile 裡面有這些：場景直入的開頭，段落中間用空格停頓，招牌的「(是有屁用」，招牌的「鍋」字。

還有不放 emoji 的進度更新型貼文，以及「免費仔」「普通聰明人」這種自我貼標籤。

完整版本放在 Lab 的記憶層。

AI 拿到這份文件之後寫出來的東西，多數場合家人朋友都看不出是 AI 寫的。

### Threads 自動發文機器人怎麼從 0 做到 100？（5 步做完）

下面用「GitHub trending 到 Threads」當範例。

兩端都可以換，把 GitHub trending 換成你的素材來源，把 Threads 換成 X 或 LinkedIn，整套架構完全不變。

1. 步驟 1，跟 Claude Code 講需求。輸入：「我想做一個每天晚上 8 點自動發 Threads 的小機器人。流程是這樣：1) 抓 GitHub trending 當天前 5 個專案，2) 隨機挑 1 個，3) 讀我的 voice_coolkid.md，用我的口吻寫一段 200 字內的介紹，4) 發到我的 Threads 帳號。請建一個 Python 專案，requirements.txt 寫清楚要裝什麼。不要規劃，直接建檔。」
2. 步驟 2，設定 Threads API 帳號。Threads 走 Meta Graph API，去 developers.facebook.com 建 App，加 Threads 產品，再拿 access token。細節看官方文件，AI 也能一邊帶你做。第一次設定大概 15 分鐘。
3. 步驟 3，在自己電腦試跑。在資料夾打開 PowerShell 跑 python bot.py，看會不會抓到 GitHub 專案、寫出貼文、發到 Threads。先用測試帳號發 1-2 則確認流程通，再切到正式帳號。
4. 步驟 4，處理 Windows 中文編碼這個雷，做法看下一節。中文發出去變成問號，是 Windows 預設 cp950 編碼造成的。先把這個雷處理掉，自動發文才會真的發成中文。
5. 步驟 5，設定每天 8 點自動跑。用 Windows 工作排程器，或是 Vercel 加上 cron-job.org，比較看下下節。設完就不用每天手動跑，機器人自己會起床發文。

跑完這 5 步，機器人就開始每天自動發文了。

發出去 1-2 週，你會發現一件事。壓力真的小很多。

「每天要分享什麼」不再壓在頭上，剩下的就是有靈感的時候，自己出手寫一篇。

做之前先知道兩個雷：Threads 的 access token 預設只有 60 天效期，過期機器人就停擺。Meta 有提供展延 API，到期前呼叫一次可以再延 60 天，不處理的話兩個月後某天會收到 401 錯誤。另外 API 有每日發文上限，個人帳號一天 250 則，每天發 1-2 則完全不用擔心。

### 中文在 Windows PowerShell 變成亂碼怎麼解？

這是我自己卡了 2 小時的雷。

Python 在 Windows PowerShell 跑的時候，印中文或用 API 送中文，會變成「???」加上一堆奇怪符號。

原因是 Windows PowerShell 預設用 cp950，也就是 Big5，Python 預設用 UTF-8，兩邊編碼對不上就變亂碼。

解法有 3 個，下面從最輕的排到最重的。

1. 解法 1（推薦）：在 Python 檔案最上面加 import sys; sys.stdout.reconfigure(encoding='utf-8')。這一行讓 Python 強制用 UTF-8 輸出，不管 PowerShell 預設是什麼編碼。
2. 解法 2：把貼文先寫進一個 .txt 檔案，開檔的時候指定 encoding='utf-8'，程式再去讀那個檔案發送，不要把中文字直接放在 print 或 subprocess 裡傳。
3. 解法 3（一勞永逸）：在 PowerShell 跑 chcp 65001，把終端機改成 UTF-8。但這條只對當下那個視窗有效，重開 PowerShell 又會變回 cp950。

我自己用解法 1 加解法 2 當雙保險，中文用 API 送出之後，Threads 那邊正常顯示，不會變問號。

Mac 用戶完全不會遇到，因為 Mac 預設就是 UTF-8。

這個雷在其他自動化工具上也會碰到，像是 IG 機器人、X 機器人、LINE 機器人，學會一次之後就一直用得到。

### 怎麼讓機器人每天 8 點自己起床跑？

讓機器人每天定時跑有 3 種方式，下面從免費排到付費。

1. 方式 1（最簡單），Windows 工作排程器（Task Scheduler）。這是 Windows 本來就有的功能，開始選單搜「工作排程器」，建立工作，設定每天 20:00 觸發，動作填執行 python C:\path\to\bot.py。免費。缺點是電腦關機機器人就不會跑。
2. 方式 2（推薦），cron-job.org 免費 cron 加上 Vercel Function。把機器人包成一個 API 端點部署到 Vercel（免費），再讓 cron-job.org 每天 8 點 GET 一次那個網址觸發。永久免費，電腦關機照跑。
3. 方式 3（進階），GitHub Actions cron。在 .github/workflows/ 寫一個 cron schedule，每天 8 點觸發 GitHub Action 跑機器人。完全免費，而且跟程式碼放在一起好管理。缺點是要懂 GitHub Actions 的設定。

第一個機器人建議用方式 1，也就是 Windows 工作排程器。

15 分鐘設定完。零學習成本，單機就跑得起來。

後面真的需要 24 小時不間斷，再升級到方式 2 或方式 3。

我自己現在用方式 2，cron-job.org 加 Vercel Function 永久免費，<a href="/newbie-pitfalls/threads-auto-post-silent-fails.html">電腦關機機器人照樣跑</a>。

### 不想自己從頭設定怎麼辦？

上面這套自己跑大概 30-60 分鐘，不含 Threads API 帳號的申請時間。

- Threads API 帳號要設定，但你看到 developers.facebook.com 的介面就頭痛，可以使用<a href="https://www.coolkidlab.com/workflows/threads-auto-poster.html" target="_blank" rel="noopener">Threads 自動發文機器人</a>我做的引導式agent帶你去註冊
- 不想自己萃取 voice profile，<a href="https://www.coolkidlab.com/workflows/voice-profile-extraction.html" target="_blank" rel="noopener">Voice profile 萃取 workflow</a>有我做好的引導式agent可以帶你萃取你的語氣
- 想要更複雜的觸發條件，例如熱度達到某個門檻才發，或是上次發完間隔 8 小時才再發

可以找「<a href="https://www.coolkidlab.com/service.html" target="_blank" rel="noopener">不想自己研究我教你</a>」這個服務。

一對一帶你從帳號設定、voice profile 萃取、機器人開發，到定時排程整套跑完，順便看過第一週發出去的內容，一起調口吻。

好處是不用自己啃英文官方文件，卡關有人帶，5 分鐘就解掉。

代價很直接，就是要付費。

適合想加速公開記錄、又不想自己找問題的人。

### Summary

Threads 自動發文機器人的完整做法：1) 先認清動作門檻比內容門檻高。2) 為什麼選 Claude Code 不用 n8n：不用架伺服器、邏輯一個檔案、voice profile 調到家人看不出。3) voice profile 萃取分 4 步，收集樣本、丟給 Claude 分析、校對補強、存檔重複用。4) 機器人開發分 5 步，講需求、設定 API、自己電腦試跑、處理編碼雷、設排程。5) Windows cp950 中文亂碼的解法，是在 Python 加一行 sys.stdout.reconfigure 改成 utf-8。6) 排程有 3 種選擇，Windows 工作排程器、cron-job.org 加 Vercel、GitHub Actions cron。7) Threads API token 60 天會過期，要設自動續期或手動延；每日上限 250 則。30 分鐘可以全部跑完。範例是 Threads 加 GitHub，X、LinkedIn、IG、Bluesky 都套得上。沒時間自己設定的話，看上面那段「不想自己研究我教你」。

### 名詞解釋

- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **Threads**：Meta 旗下的文字社群平台。本站的社群引流主戰場之一，相關自動發文流程有整篇教學。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **編碼（encoding）**：電腦儲存文字的方式。Windows 中文環境常用 Big5，多數程式假設 UTF-8，兩邊對不上就變亂碼 — 所以資料夾、檔案建議用英文命名。
- **Python**：入門門檻最低的主流程式語言之一，資料處理、自動化、AI 領域的首選。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **API 金鑰（API key）**：服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- **爬蟲（crawler）**：自動瀏覽網頁、把內容抓回去的程式。Google 靠爬蟲收錄網頁，AI 公司靠爬蟲收集資料。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。
- **voice profile（語氣檔）**：一份描述「你怎麼寫」的文件：句法、開頭結尾習慣、用詞、節奏，以及你絕對不寫的東西。給 AI 讀規則，比丟一堆範例有效。
- **RSS（網站更新訂閱）**：網站提供的一份機器讀的更新清單，程式訂閱之後就能自動知道有新文章，不用一直去開網頁看。

### FAQ

**Q: AI 寫的貼文怎麼讓人看不出是機器人寫的？**

用 voice profile 萃取法。先收集自己過去 8-15 篇真實貼文，丟給 Claude 分析，萃出一份 voice profile，裡面包含開頭習慣、句法、用詞、招牌、反指紋，存成 voice_yourname.md。之後每次叫 AI 寫東西，先讀這份文件，AI 就會照你的招牌寫，多數場合家人朋友看不出是 AI。詳細看本文第 2 節。重點是要有「反指紋」清單，也就是你絕對不會用的詞，AI 才不會偷偷塞進去。

**Q: Threads 有開放 API 給個人開發者嗎？**

有。Threads 走 Meta Graph API，個人開發者可以免費申請。流程是去 developers.facebook.com 建 App，加 Threads 產品，再產生 access token。第一次設定大概 15 分鐘，因為 Meta 的介面有點繞。設完之後，可以用 Python 或 Node.js 程式自動發文。免費方案有用量上限，每天幾百則，個人公開記錄用完全夠。

**Q: Windows PowerShell 跑 Python 中文變亂碼怎麼解？**

Windows 預設用 cp950，也就是 Big5，Python 預設用 UTF-8，兩邊編碼對不上就變亂碼。最簡單的解法，是在 Python 檔案最上面加 import sys; sys.stdout.reconfigure(encoding='utf-8')，強制用 UTF-8 輸出。或者把要發的中文先寫進 .txt，開檔時指定 encoding='utf-8'，讓程式讀檔案再發送。Mac 不會遇到這個雷，因為 Mac 預設就是 UTF-8。詳細看本文第 4 節。

**Q: Python 自動發文機器人怎麼定時觸發？**

有 3 種方式：1) Windows 工作排程器，本來就有，免費，但電腦關機就不跑。2) cron-job.org 加 Vercel Function，永久免費，24 小時都在跑。3) GitHub Actions cron，免費，而且跟程式碼放在一起。新手建議用方式 1，因為 15 分鐘就設定完，後面真的需要不間斷再升級到方式 2 或 3。詳細看本文第 5 節。我自己用方式 2 一路跑下來，cron-job.org 從沒漏過。

**Q: Build-in-public 自動化會不會變得不真誠？**

看你怎麼用。如果整篇都是 AI 寫的，你完全不看就發出去，讀者會察覺，那就變成反效果。我自己的工作流是這樣：機器人自動抓素材、生第一版稿，但我會在發出去前看一眼，不滿意就改個 1-2 行，或是重抓素材。AI 解決的是「動作門檻」，也就是每天要找東西分享這件事，真正有靈魂的內容還是自己出手。機器人省下來的時間，反而讓我有餘裕寫真正想寫的東西。

**Q: 用 AI 機器人發文會被 Threads 或 X 封號嗎？**

用官方 API 發文不會。Threads、X、LinkedIn 都允許開發者用官方 API 自動發文。會被封號的是這幾種：用第三方爬蟲假冒人類點擊、發垃圾廣告、買假帳號互按、用機器人衝粉絲。個人公開記錄，用官方 API 發自己寫的內容，哪怕是 AI 協助寫的，都完全在規則內。我自己一路跑下來，沒被警告過。

**Q: Threads 自動發文一定要用 n8n 嗎？**

不一定。n8n 是目前最多人教的做法，用拖拉節點串 API，好處是不用寫程式。但你要自己架 n8n 伺服器或付月費，改邏輯得回介面拉線。另一條路是用 Claude Code 寫 Python，整套邏輯一個檔案，壞了看 log 就知道哪裡炸，而且 voice profile 能調到非常像你自己寫的。第三種是用現成平台像 AUTOPO 或 GenApe，不用設定但口吻客製化有限。本文教的是 Claude Code 路線，不確定要不要做自動化的人可以先看<a href="/newbie-pitfalls/repetitive-work-automation-start.html">自動化入門判斷流程</a>。

**Q: Threads API 的 token 會過期嗎？怎麼續期？**

會，預設 60 天到期。Meta 有提供 token 展延 API，在到期前呼叫一次就能再延 60 天。可以在機器人裡加自動續期邏輯，每次跑的時候檢查 token 剩餘天數，低於 7 天就自動延。或者簡單一點，設個日曆提醒每 50 天手動延一次。不處理的話，某天機器人會突然不發文，看 log 會看到 401 Unauthorized 錯誤。

---

## AI Agent 實戰｜Claude Code 讀新聞生圖發 IG

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-ig-news-auto-poster.html
> AI Agent 實戰紀錄 — 用 Claude Code 做 IG 自動發文機器人 step-by-step:4 頁設計法、多模型分工把成本降到 1/10、Python 自動生圖、AI 警語為什麼必加。

短答給趕時間的人：Threads 機器人的文字原封不動貼到 IG，看起來就是一則沒做圖的廢文，因為 IG 的讀者是用滑的，眼睛只給你一秒。做法是把一篇拆成 4 頁圖：封面一句話 20 到 25 字、重點 5 到 6 條短標籤、白話解析 150 到 200 字、最後一頁放 AI 產出的警語。省錢的關鍵是每頁配不同等級的模型，讀新聞挑題目跟排重點交給便宜的小模型，封面跟解析才動用大模型。全部丟給最強的那個，一篇 50 到 80 美分，分工之後剩 5 到 10 美分。我自己每天發 4 到 6 篇，一個月大概 NT$200。

Threads 那個自動發文機器人跑順之後，我就想做一個 IG 版本。

但 IG 跟 Threads 不是同一種東西。

IG 是圖片優先。讀者用滑的，文字只是旁邊的配角。

我第一次直接把 Threads 機器人的輸出貼到 IG，看起來就像一則沒做圖的廢文。

後來我做了一個小機器人，每半小時讀一次 AI、台股、美股的新聞。

挑到值得寫的那一則，就自動產出 4 頁 IG 圖，封面、重點、白話解析、警語各一頁，最後直接發到 IG 帳號上。

已經跑了 3 個月，每個月的成本大概 NT$200，比我原本估的便宜非常多。

省下來的錢，靠的是「多模型分工」這個做法。

這篇是一步一步的教學，讀完你可以做出三樣東西。

一套 IG 的 4 頁設計版型，一個把成本壓到十分之一的多模型機器人架構，還有一支用 Python 自動生 PNG 圖的程式。

範例是 IG 加新聞，但任何「圖文加多頁」的自動發文場景都套得上。

30-60 分鐘可以全部跑完。

### 為什麼 IG 機器人不能直接照抄 Threads 機器人？

Threads 是純文字，一則上限 500 字。讀者在那邊是在「閱讀」。

IG 那邊圖片先決定一切。讀者的手指一直在滑，眼睛只給你一秒。

同一段文字放到兩邊，為什麼 IG 那邊就沒人看？

因為在 IG 的版面上，一則沒有設計過的純文字，看起來就跟廢文沒兩樣，讀者手指滑過去，連停下來看一眼都不會。

Threads 機器人只要解決「選題加寫稿」，IG 機器人還要多解決「設計成可以滑的圖」跟「寫適合 IG 的文案」這兩件事。

多一層需求，就要多拆一個角色。

我自己第一次就是直接把 Threads 的文字丟到 IG，結果完全沒人看。

發了 3 篇之後，我重新設計成圖片優先的版本，互動率立刻上去了幾倍。

平台的閱讀模式，決定了機器人的架構。

同一套輸出換個平台就貼，讀者不會買單。

下面 3 個平台，對應的機器人設計差在哪裡？

- Threads 跟 X 是純文字，機器人只要解決選題加寫稿，做法看第 5 篇那一篇。
- IG 跟 Threads 圖文是圖片優先，機器人要多解決「設計成可以滑的多頁圖」這一層，也就是本篇的主軸。
- LinkedIn 是長文加商務語境，機器人解決選題、寫稿，再改成 LinkedIn 的口吻。架構跟 Threads 機器人一樣，只是 voice profile 換成正式版。

### IG 4 頁設計法是什麼？（封面 / 重點 / 解析 / 警語）

一篇 IG 貼文，表面上是一則貼文，實際上是 4 個各自獨立的任務。

每一頁的功能都不一樣，AI 寫的方式當然也不能一樣。

所以一篇 IG 貼文，到底該怎麼拆成 4 頁？

下面是我自己在用的版型。

1. 第 1 頁 封面。功能是用一句話讓人想滑進去，20-25 字、大字、高對比，像是「Anthropic 推出 Claude 4.7」配上紅色的警示底色。寫法上用 Claude 4.5 或 GPT-5，這一句要夠有力。
2. 第 2 頁 重點。用 5-6 個短標籤把新聞拆給人快速看完，每條 10 字以內，條列排版。寫法上用 Claude 3.5 Haiku 這種便宜的小模型就夠，這一頁要的是結構，不是文采。
3. 第 3 頁 白話解析。把專有名詞用人話解釋給新手聽，150-200 字，資訊密度要高。寫法上用 Claude 4.5 或 GPT-5，要能把行話翻成國中生都聽得懂，這一頁是整個 IG 機器人最有價值的地方。
4. 第 4 頁 警語。明說這則貼文是 AI 自動產出的，文案固定，視覺低調。寫法上直接把字串寫死在程式裡，不用呼叫 AI。

把每一頁的功能拆清楚之後，每一頁就可以配不同層級的 AI，成本因此省下 10 倍。

配法看下一節。這裡先記住拆頁這件事。

新手最常犯的錯，是 4 頁都丟同一個籠統的指令，交給最強的那個模型。

這樣做每篇的成本是分工版的 10 倍，品質卻沒有比較好，多花的那些錢，就這樣一天一天白白燒掉，你還不一定發現得了。

### 怎麼把 AI 成本降到 1/10？（多模型分工法）

核心觀念很簡單，<a href="/newbie-pitfalls/ai-built-family-line-bot.html">不是每一件事都需要動用最強的 AI</a>。

我把機器人內部的工作，拆成「過濾員」「寫稿人」「結構工」3 種角色。

那要怎麼判斷哪件事該用哪一種模型？

看的是這件事重不重要。再看一天要做幾次。每種角色都配一個對應層級的模型。

1. 過濾員，用小模型，像是 Claude 3.5 Haiku 或 GPT-5 nano。工作是每半小時讀 30 則新聞清單，快速判斷哪一則值得發、哪一則跳過。次數多但每一次都很簡單，要的就是快跟便宜，每一則大概 1 美分以下。
2. 結構工，一樣用便宜的小模型。工作是產出第 2 頁那 5-6 個短標籤，這種純結構化的任務，小模型就處理得來。
3. 寫稿人，用大模型，像是 Claude 4.5 或 GPT-5。只在過濾員選出一則新聞之後才啟動，負責第 1 頁封面跟第 3 頁白話解析這兩個品質要求高的部分，一篇大概 5-10 美分。

成本可以直接對比。全部用大模型的那個版本，一篇大概要 50-80 美分。

分工版一篇只要 5-10 美分，中間整整差了 10 倍。

我自己的 IG 機器人每天發 4-6 篇，一個月的成本大概 NT$200，比 Netflix 還便宜。

換算下來，每篇 NT$1.5。

這個觀念在其他自動化工具上一樣通用。

Threads 機器人、LinkedIn 機器人、新聞摘要機器人、客服機器人，全都可以用「過濾員加寫稿人」的分工把成本壓下來。

先想清楚這件事重不重要，再決定要用哪一個模型，不要每一件事都丟給最強的那一個。

### IG 自動發文機器人怎麼從 0 做到 100？（5 步做完）

下面用「新聞變成 IG 4 頁」當範例，兩端都可以換掉。

把新聞換成你自己的素材來源，像是 PapersWithCode 的論文、每天的股票異動，或是競爭對手的更新紀錄。

把 4 頁版型換成你自己的設計，中間那一整套機器人架構完全不用動。

1. 步驟 1，跟 Claude Code 講需求。輸入：「我想做一個 IG 自動發文機器人。流程是這樣：1) 每半小時讀 [新聞來源 RSS] 的 30 則最新，2) 用 Claude 3.5 Haiku 過濾哪一則值得發，3) 選中的那則用 Claude 4.5 寫成 4 頁內容，封面 25 字、重點 6 條、解析 200 字、警語固定，4) 用 Pillow 生 4 張 PNG，5) 發到我的 IG 帳號。請建一個 Python 專案，requirements.txt 寫清楚要裝什麼。不要規劃，直接建檔。」
2. 步驟 2，申請 IG Graph API。跟 Threads 一樣去 developers.facebook.com，建立 App，加上 Instagram Graph API 產品，再拿 access token。要先把 IG 帳號切成 Business Account 才能用 API，個人帳號不行。第一次設定大概 20 分鐘。
3. 步驟 3，設計 4 頁版型。在 Photoshop、Figma 或 Canva 裡設計一個 1080x1080 的版型，4 頁的佈局固定下來，包含封面框、標題位置、字體、顏色跟底色。導出空白的版型 PNG，機器人再用 Pillow 把文字塞進固定位置。視覺一致，IG 帳號才有辨識度。
4. 步驟 4，解決中文字型問題，這是 Windows 的雷。Pillow 畫中文字的時候會找不到字型。解法是下載思源黑體或 Google Noto Sans TC，放在專案資料夾裡，程式裡指定字型的檔案路徑，像是 ImageFont.truetype('./fonts/NotoSansTC.ttf', 48)。Mac 預設的字型路徑就有中文字型，這一步可以跳過。
5. 步驟 5，部署加排程。跟 Threads 機器人第 5 節一樣有 3 種方式，Windows 工作排程器（Task Scheduler）、cron-job.org 配 Vercel，或是 GitHub Actions 的 cron。IG 適合每半小時跑一次，不是每天 8 點，cron 設 */30 * * * * 就好。

跑完上面這 5 步，機器人就開始<a href="/newbie-pitfalls/threads-auto-post-silent-fails.html">每半小時自動發文</a>了。

整套 30-60 分鐘可以跑完。

每個月的成本在 NT$200 上下，裡面是 OpenAI 或 Anthropic 的 API 費用，Vercel 免費，cron-job.org 也免費。

### 怎麼用 Python 自動生 IG 圖？（Pillow 5 行核心程式碼）

Pillow（PIL）是 Python 最常用的圖片處理套件，不用學設計也能畫圖。

不會設計的人要怎麼自動生出一張圖？

核心邏輯只有 5 行。其他都是重複的：

1. 1) 開底圖：img = Image.open('./templates/page1.png')
2. 2) 設字型：font = ImageFont.truetype('./fonts/NotoSansTC.ttf', 48)
3. 3) 開畫筆：draw = ImageDraw.Draw(img)
4. 4) 寫字進固定位置：draw.text((100, 200), '今日重點', font=font, fill='white')
5. 5) 存檔：img.save('./output/post_001_page1.png')

4 頁就是把這 5 行重複跑 4 次。

機器人會自動把 AI 寫好的 4 頁文字塞進去，5 秒就生完 4 張 1080x1080 的 PNG。

視覺風格固定，字體也固定，永遠不會跑掉。

這對 IG 帳號是好事，觀眾一滑過去，就認得出這是同一個帳號發的。

還有一個進階做法，是用 fal.ai 或 Stable Diffusion 自動生封面圖的背景。

這樣每一篇都有自己專屬的插畫，版型卻還是固定的，視覺豐富度大概多五成，帳號的辨識度也不會被打亂。

代價是每篇多花 US$0.05。

我自己沒有做這一層，因為固定的底色已經夠用了，你如果想做，在生圖那一段加一行呼叫 API 的程式就好，不會多花多少工。

### 為什麼一定要加 AI 警語？

每一篇貼文都要自動加上一行：「此貼文由 AI 自動產出，作為個人資訊蒐集與觀點記錄」。

老實說是 AI 寫的，會不會反而沒人要看？

一開始我也這樣擔心，跑了 3 個月之後，反而很慶幸有加。原因有 3 個。

- 觀眾知道是 AI 寫的，期待值會降下來，反而不會挑剔語氣，或是細節上的小錯
- 萬一 AI 寫出有錯的東西，警語讓觀眾知道這是資訊蒐集的紀錄，不是我親手寫的觀點，後續下架修正也不會被讀者出征
- IG 對 AI 內容越來越敏感，Meta 從 2025 年開始會自動標記沒有揭露的 AI 內容，自己先誠實標明，反而能避開平台的懲罰

這裡有一個觀念要先講清楚。

自動化不等於不負責任，AI 寫的東西還是會出現在你的帳號上，內容出了問題，讀者找的還是你。

警語的作用，是讓觀眾知道這些內容是怎麼來的，這本身就是負責的一部分。

如果做的是財經、投資或醫療類的機器人，警語還要更明確，加上「不構成投資建議」跟「不構成醫療建議」這兩句。

### 不想自己從頭設定怎麼辦？

上面這一整套自己跑，大概要 30-60 分鐘。

這還不含把 IG 切成 Business Account 的時間，也不含 4 頁版型的設計時間。

如果你符合下面任何一條，可能就不適合自己跑。

- IG 還停在個人帳號，不想切成 Business Account，怕影響粉絲的體驗
- 不會用 Photoshop 或 Figma 設計版型
- 想要更複雜的機器人，像是多帳號管理、自動回應留言，或是跨平台同步

可以找「不想自己研究我教你」這個服務（規劃中）。

一對一帶你從 IG API 申請、4 頁版型設計、機器人開發，到定時排程整套跑完，順便把 voice profile 跟視覺風格一起調好。

好處是不用自己摸索 Meta 的開發者介面，有人幫你設計版型，卡住 5 分鐘就解掉。

代價很直接，就是要付費。

適合想加速 IG 經營、又不想自己找問題的人。

### Summary

IG 自動發文機器人的完整做法：1) IG 的讀者是用滑的，Threads 機器人的輸出不能直接照抄過來。2) 4 頁設計法，封面、重點、解析、警語各一頁。3) 多模型分工把成本壓到十分之一，過濾員用 Haiku，寫稿人用 Claude 4.5 以上。4) 機器人開發分 5 步，講需求、申請 IG API、設計 4 頁版型、解決中文字型的雷、設排程。5) Pillow 5 行核心程式碼就能自動生 PNG。6) 一定要加 AI 警語，自動化不等於不負責任，平台從 2025 年開始查 AI 內容。每個月成本 NT$200，30-60 分鐘可以全部跑完。沒時間自己設定的話，看上面那段「不想自己研究我教你」。

### 名詞解釋

- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **Python**：入門門檻最低的主流程式語言之一，資料處理、自動化、AI 領域的首選。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **API 金鑰（API key）**：服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **Threads**：Meta 旗下的文字社群平台。本站的社群引流主戰場之一，相關自動發文流程有整篇教學。

### FAQ

**Q: IG 自動發文機器人怎麼做？**

5 個步驟：1) 把 IG 帳號切成 Business Account。2) 去 developers.facebook.com 申請 IG Graph API 的 access token。3) 設計 4 頁固定版型，封面、重點、解析、警語各一頁。4) 用 Python 加 Pillow 自動把 AI 寫好的內容塞進版型生成 PNG。5) 用 cron-job.org 配 Vercel 設定每半小時自動跑。30-60 分鐘可以全部跑完，每個月成本大約 NT$200，也就是 OpenAI 或 Anthropic 的 API 費用。完整的一步一步做法看本文第 4 節。

**Q: IG 機器人一個月 API 成本多少？**

用「多模型分工」的話，每個月大約 NT$200。做法是把機器人內部的任務拆開，過濾員用 Claude 3.5 Haiku 這種便宜的小模型，每天讀 30 則新聞挑出哪一則值得發，寫稿人用 Claude 4.5 這種貴的模型，只寫選中那一則的封面跟解析。這樣比全部用大模型省 10 倍。每天發 4-6 篇，大概是 NT$6-10 一天。詳細看本文第 3 節。

**Q: Pillow 畫中文字找不到字型怎麼辦？**

Windows 跟 Mac 的 Pillow 預設字型都不含中文，要自己手動指定。解法是下載思源黑體或 Google Noto Sans TC，兩個都免費商用，放在專案的 fonts 資料夾裡，程式裡寫 ImageFont.truetype('./fonts/NotoSansTC.ttf', 48)。然後 draw.text((x, y), '中文字', font=font, fill='white') 就會正常顯示中文。Mac 的系統字型路徑裡也有中文字型可以用，但要跨平台的話，建議還是把字型檔案帶在專案裡。

**Q: IG 自動發文需要切 Business Account 嗎？**

需要。IG Graph API 只支援 Business Account 跟 Creator Account，個人帳號（Personal）沒辦法用 API 自動發文。切換的步驟是進 IG App 的 Settings，選 Account，再選 Switch to Professional Account，然後挑 Business 或 Creator。免費，隨時可以切回個人。切完之後可以看數據分析，也可以放聯絡按鈕，缺點是不能再設定限時動態只給好友看的功能。

**Q: AI 自動發文一定要加警語嗎？**

強烈建議加。3 個原因：1) 讀者的期待會降低，不會挑剔細節。2) AI 寫錯的時候，警語能保護你不會被讀者出征。3) IG 跟 Meta 從 2025 年開始查沒有揭露的 AI 內容，自己先誠實標明能避開平台懲罰。財經、投資、醫療類的機器人警語要更明確，加上「不構成投資建議」跟「不構成醫療建議」。我自己的 IG 機器人每一篇都加，沒有因此降低觸及，反而更安全。詳細看本文第 6 節。

**Q: IG 機器人跟 Threads 機器人可以共用程式碼嗎？**

可以共用「素材選題加 AI 寫稿」這一層，不能共用「輸出格式加平台發送」這一層。我自己的架構是這樣：core 模組負責讀 RSS、過濾、寫稿，Threads 跟 IG 共用，platform 模組再分成 Threads 版跟 IG 版，前者是純文字 500 字，後者是 4 頁版型加 Pillow 生圖。共用 core 可以省下 70% 的開發時間。之後要加第三個平台，像是 LinkedIn，也只要多寫一個 platform/linkedin.py 去接 API 就好。

---

## 我用 AI 做了 14 頁產品網站：分階段上線法

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-built-a-real-product-website.html
> 用 Claude Code 做多頁產品網站 step-by-step：先 mock 全貌再分階段填內容、給 AI「世界觀」比給指令有效。一個非工程師做出 14 頁付費產品的方法論。

短答給趕時間的人：14 頁的產品網站做得出來，關鍵在順序，不在技術。先讓 AI 把 14 頁一次生出假版：內容全是佔位文字，圖用灰色方塊，會員登入先在瀏覽器本機演一次。結構先對。再一頁一頁換成真的。給 AI 的要是一句話的視覺世界觀，再加一份寫下配色、字體、留白的設計說明，風格就不用每頁重想。上線分 3 階段：只做畫面、真會員加後台、接金流串自動化，每個階段做完都能跑。每天 2 到 3 小時，2 到 3 週跑完能收錢的第一版。真內容不算在裡面，我自己填了 2 個月。手上還沒有一個自己每天在用的小工具，就先做那個再回來。

前面做的工具都是「給自己用」的，像是交易日誌、自動發文機器人、簡單的個人網站。還沒有做過第一個網站的人，先從<a href="/newbie-pitfalls/ai-make-website-guide.html">非工程師用 AI 上線網站的 5 階段</a>開始，這篇直接進多頁產品站。

但「給自己用」跟「給別人用」，是兩個完全不同的層級。中間隔的東西比想像中多。

當我想做一個有付費方案、有會員區、還有研究文章的真正產品，複雜度一下子就跳好幾級，整個做法都不一樣了。

14 頁要設計，認證系統要做，還要長得像一個真正的專業品牌，不能一看就知道是自己隨手做出來的東西。

後來我用 Claude Code 做了一個 14 頁的產品網站，分 3 階段 2-3 週做到能收錢，真內容不算在裡面，後面另外花時間慢慢補齊。

裡面有 4 個付費方案、會員儀表板、文章系統，還有一套完整的視覺風格。

真正的重點其實是「分階段方法論」，不是技術。產品是慢慢長出來的，很少有一次就做完的。

這篇是一步一步的教學，讀完你手上會多出三樣東西，而且每一樣都能直接拿去用。

一份 14 頁以上的網站全貌假版，一套「世界觀導向」的設計系統，還有一份 3 階段分批上線的計畫，每個階段做完都能跑。

範例是教育平台，但 SaaS、課程平台、媒體網站、作品集都套得上。

能收錢的第一版 2-3 週可以跑完，真內容是另一段路。

### 「給自己用」跟「給別人用」到底差在哪？

給自己用的工具只要「我會用」就好，給別人用的產品卻要做到讓一個陌生人從完全不認識你，一路走到願意掏錢付費。

中間這條路長很多，而且每一頁都有自己要負責的事，少了一頁整條路就斷掉。

下面是這 14 頁的角色分工。

1. 說服層（3 頁）：首頁、產品介紹、方案比較。負責讓陌生人從想了解，變成想付費。
2. 信任層（3 頁）：關於、客戶見證、研究文章。負責建立可信度。
3. 轉換層（2 頁）：申請入會、結帳。負責把「想付費」變成「付了費」。
4. 服務層（4 頁）：會員儀表板、課程、直播、作業。負責付費之後的體驗。
5. 支援層（2 頁）：商品、消費紀錄、個人設定。負責長期黏著。

每一層的功能完全不同，設計要達成的目標也不一樣，不能用同一套標準做完。

新手最容易犯的錯，是把 14 頁全部當成「同等重要」來做，結果每一頁都做不深。

那要怎麼快速生出全貌，再分階段把每一頁做深？下一節就講這個。

### 為什麼要先做出全貌假版，再回頭填內容？

本能是「一頁一頁做到完美」，但 14 頁的產品為什麼這樣做一定會卡住？

首頁要連到課程頁，但課程頁還沒做。方案頁要寫「會員可以看的研究」，但研究頁也還沒做。

會員儀表板要顯示「你正在上的課程」，但整套課程資料都還沒接起來。

每一頁都依賴別的頁，等於沒有一頁是真的跑得起來的，你只能一直在原地打轉。

該做的是先把 14 頁全部用假版生出來，再回頭一頁一頁換成真的。

所有頁面都在，內容是佔位文字，圖是預設的灰色方塊，會員系統先用最簡單的本地端模擬撐著，登入登出都是演的。

這樣你可以看到整個網站的全貌，導覽連得起來，頁面切換很順，每一頁都「在那邊」。

內容是假的，結構是真的。

假版階段的指令範本：「請用 Claude Code 建一個 14 頁的網站架構，所有頁面都用佔位內容（範例文字 或範例文字），所有圖用灰色方塊代替，會員系統用 LocalStorage 模擬。重點是頁面切換要順，導覽要對，結構要完整。不要花時間在內容跟設計細節，先讓全部會動。」

假版做完之後，你到底拿到什麼好處？

第一，突然看到全貌，你會發現有幾頁其實沒那麼重要，可以先放著。

第二，合夥人、客戶、老婆可以實際點點看給回饋，不用只聽你口頭描述。

第三，後面填內容的時候有目標，不會做到一半就迷路，也不用整段重寫。

### 怎麼給 AI 一個「世界觀」，讓設計自動對齊？

設計真正在做的事，是「定一個明確的世界觀，然後讓所有東西都長成同一個樣子」。

不是把單一頁面做漂亮而已。

AI 在這件事上比想像中強，但你真正該餵進去的是世界觀，還是需求？

定世界觀分成下面 4 個步驟。

1. 步驟 1，用一句話定義產品的「視覺隱喻」。例如「建築師工作室的藍圖」「日本傳統茶室」「Y2K 賽博龐克」「Apple Newton 復古科技」。越具體越好，越抽象 AI 越亂猜。
2. 步驟 2，翻譯成 5 個視覺要素。把隱喻翻成可以執行的設定：配色（3-4 色）、字體（中文跟英文各 1 套）、形狀語言（圓角、直角、手繪）、留白密度（緊密、寬鬆）、特殊紋理（網格、噪點、漸層）。寫成一份 design_system.md。
3. 步驟 3，跟 AI 講世界觀，不要講需求。指令範本：「這個專案的世界觀是 [一句話隱喻]，視覺要素看 design_system.md。請用這個世界觀重做 [頁面名]，所有元件要符合世界觀。」AI 會自動把線條粗細、留白比例、字級對比、配色節奏對齊。
4. 步驟 4，第一頁做完之後就鎖住，後面所有頁都拿這一頁當「視覺基準」。指令範本：「請參考 [基準頁].html 的視覺風格做下一頁，所有元件用同一套設計系統。」

我自己的「方舟藍圖」用的是「建築師工作室藍圖」這個世界觀。

整套配色是深宇宙紫加米色紙張，再用螢光青點綴，字體選工程感的粗體英文，底紋再鋪上一層淡淡的工程藍圖網格。

14 頁的設計風格高度一致，新加任何元件都不用再想風格，速度快上幾倍。

### 怎麼把 14 頁產品分成 3 階段上線？

全貌假版做完之後，接下來就是「分階段把假的換成真的」，一次換一塊。

我自己分成 3 個階段，每個階段做完都能上線、都能跑，只是功能逐步打開。跑完這 3 個階段就是 MVP，真的能註冊、能付費。

1. 階段 0（第 1 週），純前端加上 LocalStorage 假會員系統。14 頁全部做成假版，設計風格鎖定。網站上線到 Vercel，會員系統是假的，但能登入登出。利害關係人可以點點看給意見。
2. 階段 1（第 2 週），接上真的會員系統。把 LocalStorage 換成 Supabase Auth，可以真的註冊、登入、忘記密碼。會員資料存在雲端，後台管理介面也在這一階段建起來。階段 0 的假內容大部分還在，但已經有真的會員。
3. 階段 2（第 3 週），把會員資料跟付費系統對接。用 Stripe 或 TapPay 接金流，付完款之後會員等級自動升級，再串 n8n 自動偵測等級變化。會員儀表板顯示真的訂閱狀態。跑到這裡就能收錢了。

這 3 個階段跑完就能收錢，但網站上大部分還是假文字。真內容是另一段路：把假文字逐步換成真的研究文章、課程影片、教材，後台編輯系統也在這時候補完。這一段我自己花了 2 個月，而且是邊上線邊填，不是等填完才上線。

分階段到底好在哪裡？

第一，你隨時看得到產品目前的樣子，不會做到一半看不到希望。

第二，每個階段都有里程碑，士氣維持得住，不會做到懷疑人生。

第三，就算中途決定砍掉某個功能，前面做的也不會白費，因為那些頁面在假版階段就已經一次先做好放在那裡了。

新手最容易犯的錯，是想連真內容都填完才上線，中間完全不給別人看。

結果做了 2 個月還沒上線，士氣崩盤，最後半途而廢。

該做的是階段 0 第 1 週就上線。內容全是假的也沒關係。

別人看得到你還在做，你才不會自己先放棄。

### 用 AI 做產品網站要走哪 5 個步驟？

把上面的方法論濃縮成 5 個可以直接照著跑的步驟。

1. 步驟 1，列出 14 頁清單跟角色分工。用第 1 節的 5 層分類法（說服、信任、轉換、服務、支援），把所有頁分類，確認哪些頁是核心，哪些是支援。
2. 步驟 2，寫一份 design_system.md，做法看第 3 節那 4 步。一句話世界觀，加 5 個視覺要素，再加範例引用。這份文件之後每次叫 AI 寫頁面都會用到。
3. 步驟 3，用 Claude Code 一次生出 14 頁假版。指令：「請建一個 14 頁的網站架構，頁面清單：[列出 14 頁]。所有頁用佔位內容，視覺風格參考 design_system.md。技術選 Next.js 加 Tailwind，或純 HTML 加 CSS 加 JS。會員系統用 LocalStorage 模擬。導覽連起來，可以點點看。不要規劃，直接建檔。」
4. 步驟 4，推上 GitHub 再用 Vercel 部署。階段 0 上線，分享給合夥人、老婆、早期客戶點點看給回饋。這時候你會發現「啊原來這頁不需要」「啊那邊應該加個功能」。
5. 步驟 5，按第 4 節的 3 階段時間表逐步上線。每個階段做完都推上去，順便通知利害關係人。2-3 週後就能註冊、能收費，真內容再邊上線邊填。

跑完這 5 步，你會有一個 14 頁、真的能收費的產品網站，不是只有一份作品集。

這 3 個階段 2-3 週可以跑完，每天大概花 2-3 小時。

順序是先讓自己看得到東西，再回頭把細節做深，網站能早點上線就早點上線，剩下的慢慢修到滿意為止。

### 不想自己從頭設定怎麼辦？

上面這套自己跑到能收錢大概要 2-3 週，每天 2-3 小時。如果你符合下面任何一條，可能就不適合自己跑。

- 想做的是真正的 SaaS，要接金流、會員跟後台，複雜度不只 14 頁
- 沒有設計背景，寫 design_system.md 不知道怎麼下手
- 想要全套品牌設計，logo、配色、視覺識別都要，不只是網站

如果不想自己從頭摸索，可以找「不想自己研究我教你」這個服務（規劃中）。

一對一帶你從產品線框稿開始，把設計系統定出來，14 頁假版一次生完，再照 3 階段跑到產品對外上線、能註冊能收費為止。

好處是有人幫你做設計選擇，卡關 5 分鐘解決，2-3 週把能收錢的第一版做到位。

代價很直接，就是要付費。

適合想做真正的產品但沒有設計背景、或是想加速上市的人。

### Summary

用 AI 做多頁產品網站的完整做法：1) 先把 14 頁分成說服、信任、轉換、服務、支援這 5 層角色。2) 先做出全貌假版，再回頭填內容，先動起來再對細節。3) 給 AI 的是「世界觀」，不是「需求」，用一句話隱喻加 5 個視覺要素，寫進 design_system.md。4) 分 3 階段上線，從純前端到真會員加後台，再到接金流串自動化，每個階段都能跑。5) 五個步驟一步一步做完，列頁面、寫設計系統、生 14 頁假版、部署、分階段上線。能收錢的第一版 2-3 週可以跑完，真內容我自己再填了 2 個月。範例是教育平台，SaaS、課程平台、媒體網站、作品集都套得上。沒有設計背景的話，看上面那段「不想自己研究我教你」。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **Supabase**：免費起步的雲端資料庫服務，提供資料庫＋登入驗證＋API，個人專案很夠用。
- **SaaS（軟體即服務）**：訂閱制的雲端軟體服務。新手第一個專案不建議直接挑戰這個，範圍太大。
- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。
- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。
- **HTML**：網頁的骨架語言，定義「這是標題、這是段落、這是圖片」。
- **CSS**：網頁的造型語言，管顏色、字體、排版跟動畫。
- **最小可行產品（MVP, Minimum Viable Product）**：先做出「能用的最簡版本」給真實使用者驗證，再決定要不要繼續加功能，避免閉門造車。
- **n8n**：把不同服務串起來自動跑的工具：「有人付款」就自動「升級會員等級、寄信、更新表格」，不用自己寫程式接每一支 API。開源可以自己架，也有雲端版。
- **LocalStorage（瀏覽器本機儲存）**：資料只存在你自己這台電腦的瀏覽器裡，換一台裝置或清掉瀏覽器資料就沒了。適合做「先演一次」的假登入，不適合真的會員系統。
- **Stripe**：國際的線上收款服務，讓網站能收信用卡、處理訂閱自動扣款，不用自己去接每一家銀行。
- **TapPay**：台灣本地的線上收款服務，做的事情跟 Stripe 同一類：讓網站能收信用卡、處理金流。
- **JavaScript**：網頁的程式語言：瀏覽器裡會動的東西（按鈕、動畫、互動）幾乎都是它做的。Node.js 讓它也能在電腦本機執行。
- **Next.js**：蓋網站用的框架，把換頁、抓資料這些每個網站都要做的雜事先搭好架子，不用每一頁從零寫起。
- **Tailwind**：寫網頁外觀的捷徑：不另外開一個樣式檔，直接在標籤上寫顏色、間距這些關鍵字就能改長相。

### FAQ

**Q: 用 AI 做多頁產品網站要從哪裡開始？**

從「列 14 頁清單跟角色分工」開始，不要從「做第一頁」開始。用 5 層分類法把頁面分好：說服層（首頁、產品介紹、方案），信任層（關於、見證、研究），轉換層（申請、結帳），服務層（會員、課程、直播、作業），支援層（商品、紀錄、設定）。先看清楚 14 頁各自的角色再做假版，才不會做到一半發現結構錯了。詳細看本文第 1 節。

**Q: 怎麼讓 AI 設計出來的網站不像 template？**

給 AI 的要是「世界觀」，不是「需求」。具體做法有四步：1) 用一句話定義視覺隱喻，例如「建築師藍圖」「Y2K 賽博龐克」，越具體越好。2) 翻譯成 5 個視覺要素寫進 design_system.md，包含配色、字體、形狀、留白、紋理。3) 跟 AI 講世界觀，不要講需求。4) 第一頁做完就鎖住當基準，後面所有頁都參考那一頁。詳細看本文第 3 節。

**Q: 14 頁產品網站要做多久？**

分兩段看。用「先做全貌假版，再分 3 階段上線」這套方法，做到能收錢是 2-3 週，每天大概 2-3 小時。階段拆解是這樣：第 1 週純前端加假會員，14 頁假版全部上線。第 2 週接 Supabase Auth，後台一起建。第 3 週接 Stripe 金流，再串 n8n 自動偵測會員等級。真內容是另一段路，我自己花了 2 個月才填完，這 2 個月網站早就上線在收錢，是邊做邊補的。新手最容易犯的錯剛好相反，是堅持真內容填完才肯上線，結果卡了 2 個月還沒上線，最後放棄。該做的是第 1 週就上線，哪怕內容全是佔位文字。詳細看本文第 4 節。

**Q: 為什麼一頁一頁做產品會卡住？**

因為 14 頁互相依賴。首頁要連課程頁，但課程頁還沒做。方案頁要寫「會員可以看的研究」，但研究頁還沒做。會員儀表板要顯示「你正在上的課程」，但什麼都還沒接起來。每一頁都依賴別的頁，沒有一頁是真的跑得起來的。該做的是先把全部做成假版，讓結構先對，再回頭填內容。詳細看本文第 2 節。

**Q: Mock 階段該用什麼技術？**

新手建議用純 HTML 加 CSS 加 JS 加 Tailwind，或是 Next.js 加 Tailwind。會員系統先用 LocalStorage 模擬就好，後面階段 1 才換成 Supabase Auth。圖片用灰色方塊，或用 placeholder.com 這類服務生成佔位圖。文字直接放範例文字。重點是「結構真，內容假」。技術不要選太複雜的，免得假版階段就卡在學框架上。

**Q: 分階段上線跟一次做完有什麼差別？**

差很多。分階段的好處：1) 隨時看得到產品目前的樣子，不會做到一半看不到希望。2) 每個階段都有里程碑，士氣維持得住。3) 利害關係人早期就能給回饋，不用等 2 個月。4) 中途砍功能，前面也不會白做。一次做完的問題：1) 做 2-3 個月看不到上線，士氣容易崩盤。2) 利害關係人只能聽你描述。3) 中途砍功能，前面的工夫全白費。新手多數都死在「想一次做完美」這個陷阱裡。詳細看本文第 4 節。

---

## 你正在看的這個 Lab：串起個人品牌宇宙

> Source: https://www.coolkidlab.com/newbie-pitfalls/building-this-lab-itself.html
> 建個人品牌 Lab 容器完整 step-by-step：為什麼模板不夠、視覺世界觀 4 步驟、SEO/視覺/內容三軸協同。一個非工程師把 8 個專案串成個人品牌宇宙的方法論。

短答給趕時間的人：個人品牌容器就是一個把散在各平台的作品全部裝進來的網站。我這個 Lab 就是那個容器，前面做過的專案全裝在裡面。問題不在做得不夠多。散裝最傷的是別人找不到你。容器要補的是入口、樞紐、證明、下一階段這 4 件事。做法分 5 步：先寫需求跟視覺世界觀，用 Claude Code 一次生出 14 頁假版，加上前台直接編輯的架構，再補 SEO，最後每週推進一點。每天 2 到 3 小時，4 到 6 週上線第一版。手上還沒有幾個做完的專案，就先去做小工具，容器晚一點再做。

你正在看的這個網站，就是我拿來裝前面所有專案的那一個。

在這之前我做了交易日誌、Threads 機器人、IG 機器人、產品網站、SEO 陪跑，還有 LINE 機器人。

最後我做了一個容器，把上面全部裝進來。那個容器就是這個 Lab。

做容器之前，這幾個專案各做各的，彼此不相通。每一個都跑得不錯，但沒有一個「家」。

交易筆記在 Notion、貼文在 Threads、工具在 GitHub，Lab 文章想寫，卻不知道要丟去哪。

每次有人問我「你的東西都放在哪？」，我都答不出來。

這篇是一步一步的教學，讀完你會做出四樣東西：1) 一份「個人品牌容器」需求清單，2) 一個跟你靈魂對上的視覺世界觀，3) 一個能在前台直接編輯的「活網站」架構，4) SEO、視覺、內容三條線一起前進的長期節奏。

我的例子是 AI workflow 加上交易，但只要你想把散裝的作品串成個人品牌，這一套都套得上。

4-6 週就能上線第一版。

### 為什麼需要個人品牌容器？

散裝專案最大的問題，很少是做得不夠多。真正的問題是別人找不到你這個人。

你做了 5 個專案，散在 5 個不同的平台上，連你自己都很難跟別人講清楚，想多認識你的話，到底應該去哪裡看？

這件事對個人品牌很傷。

如果連一個固定入口都給不出來，演算法給你的觸及就只是消耗品，今天發完明天就沒了，一年下來什麼都留不住。

個人品牌容器可以解決下面這 4 個問題：

1. 問題 1（入口）：陌生人想了解你，<a href="/newbie-pitfalls/ai-built-link-in-bio-site.html">有一個固定網址可以去</a>，不用在 5 個平台之間亂找。
2. 問題 2（樞紐）：所有外部來的觸及，不管是 Threads、IG、GitHub 還是講座，最後都導到這裡，把流量留下來變成訂閱、電子報名單或付費客戶。
3. 問題 3（證明）：客戶問你「有什麼可以證明你會做」，直接給網址就好，不用講半天，整個容器就是長期可以查證的證明。
4. 問題 4（下一階段）：以後要做電子報、課程、社群、付費內容，都有地方可以接上去。沒有容器，這些東西只會變成散落的碎片。

做容器之前，你會覺得這種東西沒什麼必要，反正散裝也用得下去。

做完之後你會發現，以前做過的每一樣東西，其實都是這個容器的拼圖。

容器本身比裡面裝的東西更能定義一個人。這句話我是做完才懂的。

### 為什麼模板和 Notion 公開頁不夠？

想偷懶直接套模板的話，通常會撞到三道牆。

下面是 3 個常見方案的問題：

1. 方案 1，Wix 或 Squarespace 模板：這些模板長得像設計師作品集、軟體工程師履歷、行銷顧問頁面這 3 種，但你可能哪一種都不是，找不到對應你身分的模板。
2. 方案 2，Notion 公開頁：乾淨又好寫，但每個用 Notion 做的網站都長得一樣。觀眾打開之後不會有「這個人不一樣」的感覺，長得跟別人一樣，等於沒有被記住。
3. 方案 3，Substack 或 Medium：寫作體驗很好，但你只是租了平台上的一個帳號。平台哪天收掉或改演算法，你就沒了，網域跟資料都不在自己手上。

個人品牌容器有三個關鍵需求：跟靈魂對上的視覺世界觀，自己的網域加上資料控制權，還有能一直長大而不被框死。

3 個都要，模板做不到全部。

我的做法是用 Claude Code、Vercel、GitHub 自己蓋一個。

技術門檻沒有想像中高，前面幾篇文章都教過，自由度是 100%，視覺風格可以跟你的審美對齊，之後想長成什麼樣子都加得上。

### 怎麼定義跟靈魂對上的視覺世界觀？

視覺風格在個人品牌裡的作用，比較接近一道過濾器。

觀眾看一眼就會決定要不要留下來，篩選速度比 SEO 標題還要快。

那要怎麼把世界觀定義出來？

下面 4 個步驟是我自己走過一遍的順序：

1. 步驟 1，列出你長期被吸引的 3 到 5 樣東西。判斷標準是你會不會反覆回去看，只是覺得好看的不算。我自己列的是 8-bit 像素遊戲、復古 RPG、藍圖手稿、占卜牌組、深宇宙星圖，這些就是你審美的底層材料。
2. 步驟 2，找出這些東西的共同特徵。我那份清單的共同點是有時間感、以深色為主、帶神祕學符號、有收藏感，而且都不是當下流行的東西。寫成一句話就是「深宇宙感、像素遊戲風、神祕學收藏感」，這句話就是你的世界觀。
3. 步驟 3，把世界觀翻成 5 個視覺要素：配色 3 到 4 色、中英各一套字體、形狀語言、留白密度、特殊紋理。我的 Lab 是深紫加米色加螢光綠、像素字加工程體、銳利直角、寬鬆留白、8-bit 像素紋理，全部寫進 design_system.md。
4. 步驟 4，把第一頁鎖定成基準頁，後面每一頁都參考這一頁。視覺風格鎖定之後，每加一個新元件都不用再重想一次，滑鼠移上去怎麼動、按鈕長什麼樣、卡片怎麼排，都已經有預設答案。網站會像有自己基因的東西一樣長大。

視覺世界觀做對之後，這個 Lab 打開來就不像「又一個作品集」。

喜歡深宇宙、像素、神祕學的人會留下來，不對盤的人會直接離開。

會走掉的人本來就不會找你合作。所以這對個人品牌是好事。

### 什麼是「活網站」？怎麼做前台直接編輯架構？

活網站是登入後能直接在頁面上改文字、存檔即生效的架構，省掉每次改一個字都要重新發佈的流程。

靜態網站是有代價的。

每改一個字，都要回去動原始檔案，重新發佈，再等 1 分鐘才看得到。

對於寫文章常常邊寫邊改的人來說，這個流程慢到會讓人放棄，最後網站文案越看越爛，你卻連回頭修的力氣都沒有，這樣要怎麼長期經營？

解法是把網站做成「活的」，也就是可以在前台直接編輯。

登入之後，網站上每一段文字、每個按鈕、每條連結旁邊，都會浮出一個編輯框，按下去就能改，存檔就生效，完全不用回去動原始檔案。

改網站的速度，從每次 5 分鐘變成每次 5 秒。

前台直接編輯的架構拆開來看有 4 個元件：

1. 元件 1，預設內容寫在建置腳本裡，等於一份寫死的備援文字，任何狀況下畫面上都有東西可以顯示。
2. 元件 2，用 Supabase 存一張「覆寫」表，管理者改過的字都存進這張表。每次產生頁面的時候，再把預設內容跟覆寫的內容合併起來。
3. 元件 3，前端的編輯浮層：管理者登入之後，每段文字旁邊會出現一個鉛筆圖示，按下去打開行內編輯框，改完存進 Supabase。
4. 元件 4，用 Supabase Auth 鎖住管理者身分。一般訪客看不到鉛筆圖示，只會看到合併之後的最終文字。

技術上確實有點複雜，權限、儲存、安全性都要處理。但做完就一勞永逸。

網站會從一件蓋出來放著的作品，變成一個你每天還在裡面活動的地方。

可以一邊跟人聊天一邊調文案，看到不順眼的字當場改掉，寫文章也直接在前台寫。

詳細做法看 inline-edit-overlay 那一篇。

### 怎麼讓 SEO、視覺、內容三條線不打架？

先把設計系統、內容範本、SEO 檢查清單鎖好，再用每週、每月、每季的固定節奏各推一點，三條線就不會互相拖後腿。

做容器最麻煩的地方，真的是技術嗎？

真正麻煩的是 SEO、視覺、內容三條線要同時前進，而且每一條都會碰到另外兩條。

下面是這 3 條線常見的衝突：

1. SEO 對上視覺：SEO 想加結構化資料，想加更多文字密度，視覺想留白，想把畫面放在第一位。沒有節制的話，文字密度一路衝高，整頁會變成內容農場那種樣子，很難看。
2. 視覺對上內容速度：複雜的視覺效果，像是動畫、漸層、字型，都會拖慢 PageSpeed，也會影響使用者體驗跟頁面體驗那塊的評分。沒有節制的話，LCP 會從 1.2 秒變成 8 秒，讀者根本等不下去。
3. 內容對上品質：想拚數量，一週寫 5 篇，但寫太快品質就會變差。這種單薄的內容通常排不上去，也幫不到整個網站，不如慢一點，把每一篇寫扎實。

我後來放棄讓三條線同時做到最好，改成只要三條線不打架。這樣每週反而都推得動。

先把架構鎖好，也就是設計系統、內容範本、還有一份 SEO 檢查清單，之後每週各推進一點點，不用每次都重新做決定。

下面是我自己實際在跑的三段節奏：

1. 每週：寫 2 篇文章，修 1 個視覺細節，改 1 個 SEO 設定。比起一次想做到完美，這樣健康很多。
2. 每月：月底跑一次盤點，看 PageSpeed、GSC、GA4 跟視覺一致性，哪一條線拖慢進度，那個月就補強哪一條。
3. 每季：重新看一次設計系統跟內容主題清單，需要的話就整個重整。容器一直在長大，方向也會跟著調整。

### 做個人品牌 Lab 要走哪 5 個步驟？

把上面這些做法濃縮成 5 個步驟，4 到 6 週就能上線第一版：

1. 步驟 1（第 1 週），寫需求加上視覺世界觀。先列出容器要解決的 4 個問題，也就是入口、樞紐、證明、下一階段，再照本文第 3 節的 4 個步驟定義視覺世界觀，最後產出 design_system.md 跟 14 頁清單。
2. 步驟 2（第 2 週），用 Claude Code 一次做出 14 頁的假版。指令可以這樣寫：「請建一個個人品牌 Lab 網站，14 頁清單是［列出］，視覺風格參考 design_system.md，技術用 Next.js 加 Tailwind 或純 HTML。所有頁面先放假內容，導覽連起來，部署到 Vercel。」
3. 步驟 3（第 3 週），加上前台直接編輯的架構。照本文第 4 節那 4 個元件，接上 Supabase Auth、覆寫表跟前端編輯浮層。這一步技術門檻最高，但做完之後，寫文章的門檻幾乎降到 0。
4. 步驟 4（第 4 週），把 SEO 結構補上去。照「我用 AI 從 0 開始學 SEO」那篇的 4 個必做動作走：sitemap、PageSpeed、內部連結、E-E-A-T。做完就可以上線第一版。
5. 步驟 5（第 5 到 6 週起），開始長期經營，每週 2 篇文章加 1 個視覺細節加 1 個 SEO 設定。3 個月之後，容器會有 30 篇以上的內容、100 條以上的內部連結，SEO 數據也開始長。

跑完這 5 步，你的個人品牌容器第一版就上線了。

容器這種東西沒有「完成」的一天。只有今天長成的樣子。

下次你再回來看，這個網站應該又不一樣了，這就是個人品牌宇宙好玩的地方。

### 不想自己從頭設定怎麼辦？

上面這一套自己跑，大概要 4 到 6 週，每天投入 2 到 3 小時。

如果你符合下面任何一條，可能不太適合自己來：

- 想要一整套品牌設計，包含 logo、配色、視覺識別、名片，不只是一個網站
- 前台直接編輯的技術門檻太高，Supabase、登入驗證、編輯浮層都得自己處理
- 想要有人一對一帶你定義視覺世界觀，因為這一步需要對自己的審美有意識

可以找「不想自己研究我教你」，這個服務還在規劃中。

一對一帶你從需求釐清開始，經過視覺世界觀、14 頁假版、前台編輯，一路做到 SEO 上線，整套流程一次走完。

好處是有人幫你設計世界觀，卡住 5 分鐘就解決，4 到 6 週一次到位。代價是要付費。

適合想做出一個真正的個人品牌容器，又不想自己一個人找問題的人。

### Summary

個人品牌容器的完整步驟：1) 散裝專案的 4 個致命問題，入口、樞紐、證明、下一階段。2) 為什麼模板跟 Notion 不夠，差異化會死在這裡。3) 視覺世界觀 4 步驟，列出你反覆回去看的東西、找出共同特徵、翻成 5 個視覺要素、第一頁鎖定當基準。4) 活網站的前台編輯架構 4 元件，寫死的預設文字、Supabase 覆寫表、編輯浮層、登入驗證。5) SEO、視覺、內容三條線的協同節奏，分成每週、每月、每季。6) 5 個步驟，4 到 6 週上線第一版。容器本身比裡面的東西更能定義一個人。沒有設計背景的話，看上面的「不想自己研究我教你」。

### 名詞解釋

- **SEO（搜尋引擎優化）**：讓網站在 Google 搜尋結果排得更前面的一整套方法，涵蓋技術體質、內容品質、連結結構三層。
- **Supabase**：免費起步的雲端資料庫服務，提供資料庫＋登入驗證＋API，個人專案很夠用。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **PageSpeed Insights**：Google 提供的免費網站速度體檢工具，輸入網址就給 0-100 分跟逐項改善建議。
- **Threads**：Meta 旗下的文字社群平台。本站的社群引流主戰場之一，相關自動發文流程有整篇教學。
- **電子報（newsletter）**：定期寄到訂閱者信箱的內容。社群觸及看演算法臉色，訂閱名單是自己帶得走的資產。
- **Substack**：電子報平台：免費起步，內建訂閱管理跟付費功能，寫了直接寄給訂閱者。
- **內部連結（internal link）**：站內文章互相連的連結，幫讀者跟搜尋引擎理解「哪些內容相關、哪一頁重要」，是成本最低的 SEO 訊號。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。

### FAQ

**Q: 為什麼要做個人品牌容器？散裝在不同平台不行嗎？**

散裝有 4 個致命問題。入口不存在，陌生人問你的東西在哪，你答不出來。樞紐不存在，外部流量留不下來，演算法給的觸及是消耗品。證明不可信，客戶問你會做什麼，你只能用講的，不能直接給網址。下一階段沒地方接，電子報、課程、付費內容都沒有歸屬。容器就是把這 4 個問題一次解決。詳細看本文第 1 節。

**Q: 個人網站用 Wordpress / Wix 模板就好為什麼要自己蓋？**

模板長得像設計師作品集、軟體工程師履歷、行銷顧問頁面這 3 種，但你可能哪一種都不是。Notion 公開頁每一個都長得一樣，沒有差異化。Substack 你只是租了一個帳號，網域不在你手上。個人品牌容器的關鍵是跟靈魂對上的視覺世界觀、自己的網域，還有能持續長大，模板做不到全部。詳細看本文第 2 節。

**Q: 怎麼定義「跟靈魂對上」的視覺世界觀？**

分成 4 個步驟。先列出你長期被吸引的 3 到 5 樣東西，判斷標準是你會不會反覆回去看。再找出共同特徵，寫成一句話的世界觀。接著翻成 5 個視覺要素，也就是配色、字體、形狀、留白、紋理，寫進 design_system.md。最後把第一頁鎖定成基準頁，後面每一頁都參考這一頁。我自己的世界觀是「深宇宙感、像素遊戲風、神祕學收藏感」，所有視覺決定都從這句話長出來。詳細看本文第 3 節。

**Q: 什麼是「活網站」？跟一般靜態網站差在哪？**

活網站就是可以在前台直接編輯的網站。管理者登入之後，每段文字旁邊會出現一個鉛筆圖示，按下去打開行內編輯框，改完存進資料庫，不用回去動原始檔案。改網站的速度從每次 5 分鐘變成每次 5 秒。架構有 4 個元件：寫死的預設文字、Supabase 覆寫表、前端編輯浮層、登入驗證保護。對寫文章常常邊寫邊改的人來說，差別非常大。詳細看本文第 4 節。

**Q: 做個人品牌 Lab 要多久？**

照本文的 5 個步驟走，4 到 6 週可以上線第一版，每天投入 2 到 3 小時。第 1 週寫需求跟視覺世界觀，第 2 週用 Claude Code 做出 14 頁假版，第 3 週加上前台編輯架構，第 4 週補 SEO 結構正式上線，第 5 週起進入長期經營的每週節奏。3 個月之後會有 30 篇以上的內容，SEO 數據開始長，第一個陪跑案件也可能成交。詳細看本文第 6 節。

**Q: SEO / 視覺 / 內容怎麼同時做不打架？**

不要追求三條線同時最好，只要三條線不打架就好。先把架構鎖好，也就是設計系統、內容範本、SEO 檢查清單，再用每週、每月、每季的節奏推進。每週寫 2 篇文章加 1 個視覺細節加 1 個 SEO 設定，每月盤點 4 個指標看哪一條線拖慢進度，每季重看設計系統跟內容主題，需要的話就整個重整。詳細看本文第 5 節。

---

## Claude Code Windows 安裝：4 步驟＋錯誤排除

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-windows-setup.html
> Claude Code Windows 安裝教學：PowerShell 官方 4 步驟、Git Bash、PATH、TLS 等常見錯誤。另把我 2026 年用 npm 舊法踩過的坑分開說清楚。

短答給趕時間的人：Windows 10、11 都能跑 Claude Code。第一次安裝，先裝 Git for Windows，再用 PowerShell 貼上官方指令 irm https://claude.ai/install.ps1 | iex；重開 PowerShell 後輸入 claude，就能開始登入。現在的 native 安裝不用先裝 Node.js，也會自動更新。我 2026 年 4 月照舊教學用 npm 安裝，曾碰過 PowerShell 執行原則、中文路徑和 PATH 三個問題；那是舊安裝路線的紀錄，不代表現在每個 Windows 使用者都會遇到。這篇先帶你走現在的官方 4 步驟，再依畫面上的錯誤訊息排查。

我這台是 Windows 11 主力機，從 2026 年 4 月中用到現在。

第一次想跟著 YouTube 學裝的那天，我找了 4、5 部影片，畫面幾乎都是 Mac。

教學裡的 brew、Terminal 和路徑寫法，通通對不到我的 Windows。

跟著做，第一步 brew install 就卡住。

Windows 沒有 Homebrew。不是我少裝一步，而是照錯作業系統的教學。

繞過去之後，第二個是紅字，第三個是亂碼。

一個下午就這樣過去了。後來回頭看，真正的問題不是 Windows 不能用，而是我把 Mac 步驟、npm 舊裝法和現在的官方裝法混在一起。

後來我把錯誤訊息逐一拆開，才知道哪些是 npm 舊裝法留下的環境問題，哪些才是現在仍可能遇到的 Windows 安裝問題。

兩者要分開看，才不會拿舊解法去修新安裝。

這篇把那一個下午的經驗，重整成現在仍能照做的步驟。

讀完你會做出什麼？一台 Windows 跑得起來的 Claude Code 環境。

可以開始用 AI 寫程式、做網站、跑自動化。

### 安裝前先準備什麼？PowerShell、Git 與登入方式

先給答案，可以，而且不難。

Windows 10（1809 以上）跟 Windows 11 都能跑 Claude Code。Windows 有自己的 PowerShell 安裝指令，不需要照抄 Mac 的 brew 指令。

下面是開始前要備齊的東西。現在第一次安裝不用先裝 Node.js。

- 作業系統：Windows 10（1809 以上）或 Windows 11（64-bit）
- <mark><strong>不用先裝 Node.js</strong></mark>：官方 native 安裝法直接下載獨立程式。舊教學第一步都叫你去裝 Node.js，那是 npm 舊裝法才需要的
- <mark><strong>PowerShell 5.1 或以上</strong></mark>：Windows 內建。按 Win 鍵搜尋 PowerShell；如果視窗開頭是 PS C:\，就是對的。不要把下一節的 irm 指令貼進 CMD
- <mark><strong>可用的登入或計費方式</strong></mark>：Claude Code 可以用 Claude 付費方案登入，也可以接 Anthropic Console 的 API 計費。方案與價格會變，安裝前以 <a href="https://claude.com/pricing" target="_blank" rel="noopener">Anthropic 官方價格頁</a>為準
- <mark><strong>Git for Windows</strong></mark>：官方新手流程先安裝它，Claude Code 也會用到 Git Bash。從 <a href="https://git-scm.com/downloads/win" target="_blank" rel="noopener">git-scm.com</a> 下載；如果你只用 PowerShell 執行工具，Claude Code 也有 PowerShell 支援，但新手先照官方流程最省事

跟 Mac 教學最大的差別在哪？就在開頭那一行。

Mac 教學常出現 brew install，那是 Mac 專用的軟體安裝工具，Windows 沒有也不需要。

對應到 Windows 就是下一節那行 irm 開頭的官方安裝指令，一行搞定。

新手不要被 brew install 嚇到，直接跳過。

### Claude Code 在 Windows 怎麼裝？（PowerShell 4 步驟完整指令）

下面 4 步依照 Anthropic 的 Windows 新手流程整理。

我 4 月裝的時候還是 npm 舊法，問題比較多；現在新裝直接走 native 安裝。

每一步，都附完整指令、預期看到什麼、卡住怎麼辦，指令照貼進 PowerShell 就行。

1. 第 1 步：先安裝 Git for Windows，再打開 PowerShell。輸入 irm https://claude.ai/install.ps1 | iex 後按 Enter。這是官方的 native 安裝指令，會下載獨立程式，不用先裝 Node.js。注意要貼在 PowerShell（視窗提示字元開頭是 PS C:\）；如果跳「irm 不是內部或外部命令」，通常是開到 CMD 了。
2. 第 2 步：關掉 PowerShell 重開一個，輸入 claude --version 按 Enter。有吐出版本號就是裝好了。跳「無法辨識的詞彙」先確認真的有關掉重開，還是不行就跳到第 3 節問題 3 看解法。
3. 第 3 步：進到你要工作的資料夾。先在桌面新建一個資料夾，例如 my-project，回到 PowerShell 輸入 cd C:\Users\你的名字\Desktop\my-project。英文名稱不是 Claude Code 的硬性規定；我會先用英文，是為了減少其他舊套件或腳本處理路徑時出錯的變數。
4. 第 4 步：啟動 Claude Code。在資料夾裡輸入 claude 按 Enter。第一次會跳出登入流程，把 PowerShell 顯示的網址貼到瀏覽器，登入 Anthropic 帳號，再把回傳的驗證碼貼回 PowerShell 就完成。

怎麼確認真的裝好了？

PowerShell 視窗應該變成一個對話介面，左下角顯示「>」等你輸入。

先輸入「請只讀取這個資料夾，告訴我有哪些檔案，不要修改」按 Enter。Claude 能列出檔案，才算真的進到正確專案。

如果輸入 claude 跳「無法辨識的詞彙」，先重開 PowerShell；仍失敗再看第 3 節的 PATH 解法。

PATH 就是系統找程式的那份路徑清單。

舊的 npm 安裝教學還看得到，但現在官方已把 native 安裝列為建議路線。除非你正在維護既有 npm 環境，第一次安裝不需要繞回舊法。

我 2026 年 4 月就是這樣裝的，第 3 節保留了那段舊路線的實際錯誤，方便照舊教學卡住的人對照。

除非你本來就有 Node 環境，不然新裝沒理由選這條。

另一個備案是 winget install Anthropic.ClaudeCode，winget 是 Windows 本來就有的軟體安裝指令。

WinGet 預設不會自動更新，之後要自己跑 winget upgrade Anthropic.ClaudeCode；官方也提供開啟套件管理器自動更新的環境變數。新手不想多管理一層，仍以 native 安裝最單純。

### 安裝失敗怎麼辦？先對照這 4 種錯誤

不要看到紅字就一次改一堆 Windows 設定。先找錯誤訊息裡最接近下面哪一種，再只修那一件事。

前 4 種是官方文件目前列出的 Windows 安裝問題。最後再補我用 npm 舊法碰過的狀況。

如果畫面和本文不同，先停下來確認你開的是 PowerShell、使用的是 native 安裝指令，不要把 Mac、npm 和 WinGet 三套步驟混著跑。

官方 Windows 安裝與排錯資料，我都連到 <a href="https://code.claude.com/docs/en/terminal-guide" target="_blank" rel="noopener">Claude Code 新手指南</a>和 <a href="https://code.claude.com/docs/en/troubleshoot-install" target="_blank" rel="noopener">安裝疑難排解</a>。

下面的順序從最容易誤判的地方開始。

問題 1：跳出「irm 不是內部或外部命令」

現象：貼上安裝指令後，畫面說找不到 irm。

原因：irm 是 PowerShell 的指令。你多半開到 CMD，而不是 PowerShell。

解法：關掉目前視窗，按 Win 鍵搜尋 PowerShell。確認提示字元開頭是 PS C:\，再貼一次官方安裝指令。

不要為了這個錯誤去改 Execution Policy；那修不到開錯終端機的問題。

問題 2：跳出「Claude Code on Windows requires git-bash」

原因：Claude Code 找不到 Git Bash。先安裝 Git for Windows，關掉 PowerShell 後重開，再試一次。

如果 Git 已經安裝但仍找不到，可以依官方指引設定 CLAUDE_CODE_GIT_BASH_PATH，讓 Claude Code 指向 git-bash.exe 的實際位置。

不知道安裝在哪裡時，不要猜路徑；先在開始選單找到 Git Bash，再查看檔案位置。

問題 3：輸入 claude 跳「無法辨識的詞彙」

現象：安裝看似完成，但重新打開 PowerShell 後，系統仍找不到 claude。

先做最小動作：把所有 PowerShell 和 Windows 終端機視窗關掉再重開。安裝程式剛更新的 PATH，舊視窗不一定看得到。

仍失敗，再檢查使用者 PATH 裡有沒有 C:\Users\你的名字\.local\bin。native 安裝程式會把 claude 放在這裡。

PATH 是 Windows 尋找程式的清單。只補缺少的那一條，不要刪掉原本內容。

我自己的錯誤截圖就在下面。那次是舊 npm 安裝，位置不同，但「安裝完成、系統找不到指令」的判斷方式相同。

如果安裝的是 npm 舊版入口，才去檢查 C:\Users\你的名字\AppData\Roaming\npm；不要把 npm 路徑加到 native 安裝的問題裡。

問題 4：TLS、下載失敗或防毒軟體鎖住安裝檔

如果錯誤提到 TLS，官方建議先在同一個 PowerShell 工作階段啟用 TLS 1.2，再重新執行安裝指令。

如果錯誤提到 .claude\downloads 檔案被使用中，可能是另一個安裝程序或防毒軟體正在掃描下載檔。

先確認沒有另一個 Claude Code 安裝在跑，再重試。不要直接關閉整台電腦的防毒；若公司電腦受管理，交給 IT 判斷。

另外，Claude Desktop 的舊版本可能在 Windows 上攔到 claude 指令。已安裝桌面版的人，先更新 Desktop 再測一次。

我舊 npm 安裝還碰過兩件事：PowerShell 執行原則擋住 npm 產生的 .ps1 入口，以及部分舊工具處理中文路徑時亂碼。

這兩件事保留作為歷史經驗，不當成現在 native 安裝的必要步驟。尤其不要一看到紅字，就先永久放寬整台電腦的腳本執行限制。

中文資料夾也不是 Claude Code 的禁用規則。我現在仍偏好用 my-project 這類英文路徑，是為了減少其他舊套件、部署腳本或跨平台工具出錯，不是宣稱 Windows 中文路徑一定會壞。

如果你正卡在 npm 舊教學，最乾淨的做法通常是停下來，改走本文第 2 節的 native 安裝，而不是繼續替舊環境補洞。

需要更細的登入與 API Key 排錯，可以接著看 <a href="/newbie-pitfalls/claude-code-api-key-login.html">Claude Code 登入一直失敗怎麼辦</a>。

如果是安裝後卡住、沒有回應，則看 <a href="/newbie-pitfalls/claude-code-stuck-not-responding.html">Claude Code 卡住時的判斷順序</a>，不要重裝到把原本設定一起洗掉。

裝完打 claude 跳「不是內部或外部命令」？多半是 PATH 沒接上，<a href="/newbie-pitfalls/claude-code-install-failed.html">6 步排查表</a>從 PATH 到版本一步步走完，10 分鐘定位。

### 不想碰終端機？Claude Desktop 也能開本機專案

我現在也會用 Claude Desktop。它的 Code 分頁已經整合 Claude Code，不必另外先裝 CLI 或 Node.js。

對第一次接觸的人，桌面版的好處不是能力比較強，而是少記幾個終端機指令。

Windows 本機工作階段仍需要 Git。若 Desktop 找不到專案或無法建立工作階段，先確認 Git for Windows 已安裝。

CLI 和 Desktop 可以這樣選：

- 想先打開資料夾、用視覺介面交辦：選 Claude Desktop 的 Code 分頁
- 想把指令、Git 和專案流程看得更清楚：用本文的 PowerShell CLI 安裝
- 已經在用 Linux 工具鏈：再考慮 <a href="/newbie-pitfalls/claude-code-wsl.html">WSL 路線</a>，新手不用一開始就多裝一層系統

兩個入口可以共用同一個專案，重點是不要同時讓兩個工作階段修改同一批檔案。

如果要從桌面版開始，直接看 <a href="https://code.claude.com/docs/en/desktop-quickstart" target="_blank" rel="noopener">Anthropic Desktop 快速入門</a>。

如果要跟著終端機教學，先確認對方示範的是 PowerShell、CMD、Git Bash 還是 WSL。四個視窗看起來都像在打指令，實際語法不同。

看到 brew 或 sudo，代表那段多半是 Mac 或 Linux 指令，不要直接貼進 PowerShell。

先找 Windows 對應步驟，比貼上後再解紅字省時間。

### Claude Code 裝完之後，第一個專案怎麼開？

第一個專案該挑什麼？不要挑「我要做一個 SaaS」。

挑「我老婆會用、我每天會用、我家人會用」的小工具。

技術門檻低，需求清楚，做完馬上能用。

新手建立信心的速度最快。

我自己第一個專案，是給老婆做的童裝庫存管理頁。

從零到上線在 Vercel 花了一個下午，但中間部署卡了 3 小時。

我第一次部署時，曾卡在「自己電腦看得到、網路上卻沒變化」。那是部署流程問題，不是 Windows 使用者必然會遇到。

詳細紀錄寫在另一篇：我以為再補一段就好，結果改了 3 小時，「重寫比修補快」的啟示。

連結在下方相關文章區。

建議裝完 Claude Code 之後直接接著看那篇，把第一次部署會遇到的問題一起避開。

### 裝好後第一天怎麼用？先做可逆的小任務

裝好不代表要立刻把整個網站交給 AI。第一天先做一個可逆、能驗證的任務。

我會照下面順序測，哪一步不對就停在那裡，不往下放大範圍。

1. 第 1 步：叫 Claude 只讀取資料夾，列出檔案與用途，不做修改。先確認它站在正確的位置
2. 第 2 步：挑一個文字檔，請它提出修改建議，但不要直接改。看它是否理解你的目的
3. 第 3 步：允許它改一個能用 Git 還原的小地方，改完先看 diff，再決定是否保留

我後來能用 Claude Code 維護網站，不是因為安裝完就突然會寫程式，而是每次只多放一點權限。

如果你還不知道專案要怎麼擺，可以接著看 <a href="/newbie-pitfalls/claude-code-project-structure.html">Claude Code 專案結構怎麼整理</a>。

### Summary

Claude Code 可以在 Windows 10、11 使用。第一次安裝先裝 Git for Windows，再在 PowerShell 執行 irm https://claude.ai/install.ps1 | iex；重開 PowerShell，確認 claude --version，再進入專案資料夾執行 claude。遇到錯誤時先看文字：找不到 irm 通常是開到 CMD；找不到 git-bash 就檢查 Git；找不到 claude 先重開視窗，再看 .local\bin 是否在 PATH；TLS 或下載檔被鎖則依官方疑難排解處理。我 2026 年用 npm 舊法碰過 Execution Policy、中文路徑和 npm PATH，但那是歷史經驗，不是現在 native 安裝人人必做的設定。裝好後先讓 Claude 只讀、再提建議、最後才改一個能還原的小地方。

### 名詞解釋

- **native 安裝（原生安裝）**：官方提供的獨立安裝方式：一行指令下載完整程式，不依賴 Node.js 這類其他環境，裝完會自動更新。2026 年官方文件的推薦裝法。
- **Node.js**：讓電腦能執行 JavaScript 程式的基礎環境。npm 舊裝法才需要先裝它；現在官方推薦的 native 裝法不用。免費，從官網 nodejs.org 下載安裝。
- **LTS（Long Term Support）**：軟體的「長期支援版」，最穩定、官方維護最久的版本。下載 Node.js 時選綠色的 LTS 按鈕就對了。
- **npm**：裝 Node.js 時附帶的套件管理工具，像程式界的 App Store — 一行指令就能安裝各種工具。Claude Code 的舊裝法用它裝；2026 年起官方推薦改用 native 安裝。
- **PowerShell**：Windows 本來就有的指令視窗：用打字下指令的方式操作電腦，Claude Code 就在這裡面跑。按 Win + X 可以叫出來。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **執行原則（Execution Policy）**：Windows 控制 PowerShell 指令碼能否執行的安全設定。它可能影響 npm 舊安裝產生的 .ps1 入口，但不是現在每個 native 安裝錯誤的通用解法。
- **PATH（環境變數）**：系統的「去哪裡找程式」清單。native 安裝通常使用使用者目錄下的 .local\bin；npm 舊安裝則可能在 AppData\Roaming\npm，兩種路徑不要混著加入。
- **編碼（encoding）**：電腦儲存與解讀文字的規則。我曾碰過舊工具處理中文路徑時亂碼，但中文資料夾不是 Claude Code 的禁用規則；英文路徑只是較保守的跨工具做法。
- **Vercel**：把網站免費發佈到網路上的服務：做好的網站丟上去就有正式網址。第一次部署會撞的雷，見下方相關文章。
- **Homebrew（brew）**：Mac 專用的軟體安裝工具，Windows 沒有也不需要。Mac 教學看到 brew install 開頭的指令，Windows 用戶直接跳過。

### FAQ

**Q: Windows 可以用 Claude Code 嗎？**

可以。Windows 10（1809 以上）和 Windows 11 都能跑 Claude Code。官方 native 安裝不用先裝 Node.js；Windows 新手流程會先準備 Git for Windows，再從 PowerShell 執行安裝指令。我自己從 2026 年 4 月起用 Windows 11，早期 npm 舊裝法碰過的問題已在本文另行標示，不會混成現在人人必做的步驟。

**Q: Claude Code 怎麼裝？（Windows 版完整 4 步驟）**

Windows 安裝 Claude Code 4 個步驟：1）安裝 Git for Windows，打開 PowerShell，輸入 irm https://claude.ai/install.ps1 | iex；2）關掉 PowerShell 重開，輸入 claude --version；3）用 cd 進到工作資料夾；4）輸入 claude，跟著畫面完成登入。英文資料夾名稱是我減少跨工具問題的保守做法，不是 Claude Code 的硬性規定。

**Q: Claude Code 免費版收費嗎？**

Claude Code 可以使用 Claude 付費方案登入，也可以接 Anthropic Console 的 API 計費。方案名稱、額度與價格可能調整，本文不寫死月費；安裝當天請看 Anthropic 官方價格頁與 Claude Code 文件。

**Q: Claude Code 跟 Claude 一樣嗎？**

不一樣。Claude 是 Anthropic 的 AI 服務；Claude Code 是讓 Claude 讀取專案、修改檔案、執行指令的開發工具。它不只存在於命令列，也能從桌面版、編輯器與網頁入口使用。只想討論與寫初稿，用一般 Claude 對話就夠；需要它碰本機專案，才用 Claude Code。

**Q: Claude Code Windows 跟 Mac 哪個比較好用？**

核心工作都能做，但終端機、路徑、Git Bash 與 WSL 的處理方式不同，不能用一個百分比概括。跟教學時先確認對方使用的是 PowerShell、CMD、Git Bash、WSL 還是 Mac Terminal，比直接比較哪個系統快更有用。

**Q: Windows 沒有 Homebrew 怎麼辦？**

Homebrew（brew）主要用在 macOS 與 Linux。Windows 不需要先補裝 brew；安裝 Claude Code 時，直接用官方 PowerShell 指令或 WinGet。其他軟體不能一律照這個方式換算，應回到該工具的 Windows 安裝文件。

---

## AI Agent 實戰｜LINE 機器人幫全家管行程

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-built-family-line-bot.html
> AI Agent 實戰紀錄 — 永久免費 LINE 機器人 step-by-step：FastAPI + Supabase + Render 三件套、Auto-reply 必關設定。一個非工程師用 Claude Code 做的家族行程管家。

短答給趕時間的人：做得出來，而且每個月 0 元。四樣東西湊起來就夠用：FastAPI 寫機器人的主程式、Supabase 存資料、Render 部署，再加 cron-job.org 每分鐘戳一次負責定時提醒。順便讓免費方案的服務不會閒置休眠。從申請 LINE 帳號到上線大約 4 到 6 小時。最容易卡住的是 LINE 後台預設開著的自動回覆，會蓋掉你自己寫的機器人邏輯。沒有任何錯誤訊息，我翻了 30 分鐘紀錄檔才知道。真正難的其實不在技術。機器人上線之後家人到現在都還沒加，只有我一個人在用。

我家常常出狀況。長輩看醫生的日期忘了，繳費單過期才發現，接小孩的時間也沒對齊。

我們家 LINE 群裡長期有人在喊「明天誰要去哪裡」。

但訊息一直被洗下去，到當天就沒人記得。

我想做的東西很簡單，就是一個 LINE 機器人。

家人可以直接在私聊跟機器人說「明天下午3點 媽媽 醫院回診 提前1小時提醒」，機器人記下來，時間到了自動推播給對的人。

需求很簡單，但真的動手做，照樣遇到三個問題。

這篇把整個流程重整成一步一步的做法，讀完你會做出一個永久免費的家族行事曆 LINE 機器人。

用到的四樣東西是 FastAPI、Supabase、Render，再加上 cron-job.org。

範例是家族行程，但任何「LINE 私聊指令型機器人」都套得上，像是個人提醒、健身打卡、讀書心得記錄、客戶常見問答。

4-6 小時可以全部跑完。

### LINE 機器人該用群組，還是一對一私聊？

直覺想法是，我們家本來就有 LINE 群，機器人加進群就好。

但寫了幾行程式之後，我發現群組有兩個問題。

第一，群組訊息會被洗掉。

每個家人都在傳貼圖、轉新聞、討論晚餐，行程指令很容易就被埋掉。

機器人也分不清楚，誰是要新增行程，誰只是在聊天。

第二，通知的精準度很差。

如果推播傳到群組，全家都會收到「媽媽明天看醫生」這則提醒。

不相關的人會覺得煩，真正該收到的人，在訊息海裡也一樣容易漏掉。

後來改成一對一私聊，再用一組邀請碼把家人綁成同一個家族。

每個家人各自跟機器人對話，新增行程的時候指定通知對象，時間到了，機器人就私訊那個人。

家人要先用同一組邀請碼綁進同一個家族，媽媽新增的「醫院回診」，才找得到爸爸來通知。

做完之後回頭看，群組跟私聊真正的差別，其實是「資料邊界」，不是技術選型。

群組是公共空間，一對一才有清楚的「誰要做什麼給誰」這層關係。

### 資料庫要選 Supabase 還是 Render PostgreSQL？

FastAPI 寫好之後，要找個地方存資料。

Render 自己有 PostgreSQL，但那不在免費方案裡，Supabase 則是給 500 MB 免費空間。

家裡一年新增 3,650 筆行程，也佔不到 1 MB，Supabase 綽綽有餘。

但 Supabase 給我的連線字串開頭是 postgresql://，貼進 .env 跑起來就直接報錯。

我以為是密碼打錯，重設了一次，還是不行。

後來才發現，我用的 SQLAlchemy 非同步驅動要的是 postgresql+asyncpg:// 開頭，差一個字母，套件就找不到。

這種驅動前綴的問題，AI 看一眼錯誤堆疊就知道，但你不知道要問什麼的時候，會卡很久。

後來我養成一個習慣，先把錯誤訊息整段丟給 AI，請 AI 先告訴我這是哪一層的問題。

是驅動、是設定、是帳號密碼，還是防火牆？分清楚了，再決定要不要改程式。

### 為什麼 LINE 機器人只會回「感謝您加為好友」？（Auto-reply 一定要關）

Render 部署完，webhook 設好，我傳了第一句「你好」測試。

結果機器人回我：「感謝您加為好友！我們會盡快回覆您。」

我整個傻住，回去翻 Render 的紀錄檔。

我自己寫的那段處理程式，完全沒有被呼叫過。

是我程式寫壞了？webhook 沒接到？還是網路有問題？

翻了 30 分鐘紀錄檔，一條線索也沒有。

最後我把整段丟給 AI 看，AI 一句話就點醒我：「你 LINE Developers Console 的 Auto-reply messages 有沒有關？」

那個設定我完全沒關過。

LINE 預設會用一段制式訊息回覆新好友，這段訊息會「先」於 webhook 觸發，等於蓋掉我自己寫的機器人邏輯。

回 console 把 Auto-reply 跟 Greeting messages 都關掉，再傳一次「你好」，機器人就正常回應了。

這個問題<a href="/newbie-pitfalls/threads-auto-post-silent-fails.html">沒有任何錯誤訊息</a>，沒有紀錄檔，也沒有錯誤堆疊。

新手幾乎都會碰到，因為這是 LINE 平台的「貼心預設」，不是程式寫錯。

要寫 LINE 機器人之前，先把 Auto-reply 跟 Greeting 都關掉，省下 30 分鐘。

### Render 2025 砍掉免費 cron 之後怎麼辦？（改用 cron-job.org）

機器人跑起來之後，要做的是「時間到自動推播」這件事。

我以為 Render 會幫我跑 cron job，畢竟我在 render.yaml 裡就寫了一個 cron service。

結果部署的時候，Render 跳出一行訊息：「Cron Jobs are not available on the free tier.」

這是 2025 年中改的規定，免費方案不能跑 cron 了。

我那一刻心想完了，難道要開始付每個月 $7？

後來 AI 建議我用 cron-job.org，那是一個獨立的免費 cron 服務，每分鐘可以戳一次網址。

我在 Render 的 web service 裡寫了一個 /api/cron/dispatch 端點。

cron-job.org 每分鐘 GET 一次，端點就去檢查資料庫有沒有要發的通知，有就發出去。

這個做法意外比 Render 本來就有的 cron 還好用。

每分鐘戳一次，同時達成兩件事。

一個是派發到期的通知，另一個是喚醒 Render 免費方案的 web service，免得閒置 15 分鐘就自動休眠。

對我來說算是一石二鳥。

教訓是，當平台砍掉免費功能，外面通常已經有獨立的免費替代品。

先不要急著掏錢訂閱。

### 機器人的自然語言解析，一定要接 AI 嗎？

機器人的招牌功能，是讓家人可以直接傳一句「明天下午3點 媽媽 醫院回診 提前1小時提醒」。

機器人自動解析出時間、對象、事項，還有要提前多久提醒。

我第一個想法是接 Claude API，把整句訊息丟過去，請 Claude 回傳結構化的 JSON。

準確度應該很高，畢竟 LLM 處理自然語言這種東西特別強。

但寫到一半，我停下來算了一次成本。

如果每個家人每天傳 5 則訊息，每則都要呼叫一次 API，一個月就是幾百上千次。

這個專案的核心是「永久免費」，每個月固定花錢呼叫 AI，方向就不對了。

改成用 regex 加上一份中文時間詞典。

明天、後天、下下週這種詞，先對應成日期的偏移量，「下午3點」用 regex 抓出來。

「媽媽」「爸爸」這種家人稱謂，就拿家族成員清單去比對。

寫起來笨笨的，但是 0 元，0 延遲，也不用 API key。

AI 時代學到最反直覺的一件事，是不用什麼都接 AI。

regex 解得掉的，就不要花掉一次 API 呼叫。

AI 是好工具，但不是萬能解，尤其當你的專案限制是「永久免費」的時候。

### 機器人上線之後，怎麼讓家人真的開始用？

老實說，機器人已經上線了，但目前只有我一個人在用。

家人到現在都還沒加。

我自己每天傳 2-3 則：「明天下午4點 接小孩」「後天早上 繳水費」「下週三 媽媽 健檢 提前1天提醒」。

一週下來，確實一次都沒有忘記過。

但「我自己在用」跟「全家都在用」，是兩個世界。

家人不會主動去加機器人，要先看到實際的好處才會動。

下一步是先在 LINE 群組轉發我自己被準時提醒的截圖，讓家人覺得「這個東西好像有用」，再請他們掃 QR code 加好友。

做工具最難的其實是讓使用者真的開始用，不是技術。

這條 build-in-public 還沒走完，下一篇再回報家人用起來的進度。

### 永久免費的 LINE 機器人，怎麼從 0 做到 100？（5 步做完）

把上面 5 個問題整合進實作流程，下面這 5 步，就可以做出一個真的跑得起來的 LINE 機器人。

1. 步驟 1，申請 LINE 帳號並且關掉 Auto-reply。去 developers.line.biz/console 建 Provider，再建 Messaging API channel，拿 Channel secret 跟 Channel access token。Messaging API 分頁裡的 Auto-reply messages 跟 Greeting messages 一定要先關掉，理由看第 3 節。
2. 步驟 2，用 Supabase 建資料庫。到 supabase.com 註冊，按 New project，拿連線字串。注意 SQLAlchemy 的非同步驅動要把 postgresql:// 改成 postgresql+asyncpg://，理由看第 2 節。
3. 步驟 3，用 Claude Code 寫 FastAPI 機器人。指令範本：「請建一個 FastAPI 專案，功能：1) /api/line/webhook 接 LINE 訊息，2) 用 regex 解析中文時間（明天下午3點、後天、下週三）加上對象（家人姓名）跟事項，3) 存到 Supabase，4) /api/cron/dispatch 端點檢查到期通知並且推播出去。資料庫 schema 自己設計，requirements.txt 寫清楚。」
4. 步驟 4，部署到 Render。先 push 上 GitHub，到 render.com 連 repo，設好環境變數（LINE_CHANNEL_SECRET、LINE_CHANNEL_ACCESS_TOKEN、DATABASE_URL），按 Deploy。拿到 .onrender.com 網址，貼回 LINE Developers Console 的 webhook URL 設定。
5. 步驟 5，設定 cron-job.org 觸發 dispatch。到 console.cron-job.org 註冊，按 CREATE CRONJOB，URL 填 https://你的-app.onrender.com/api/cron/dispatch，Schedule 選每分鐘，加一個 X-Cron-Secret header，按 CREATE。每分鐘戳一次同時做兩件事，一個是派發到期通知，一個是喚醒 Render 免費方案的 web service，理由看第 4 節。

跑完這 5 步，機器人就上線了。

4-6 小時可以全部跑完，這包含 LINE 帳號申請、Supabase 設定，還有部署時找問題的時間。

每月成本 NT$0，Render、Supabase、cron-job.org 這三樣的免費方案都是永久免費。

### 不想自己從頭設定怎麼辦？

上面這套自己跑大概要 4-6 小時。如果你符合下面任何一條，可能就不適合自己跑。

- LINE Developers Console、Render、Supabase 這 3 個平台的介面，看到就頭痛
- 想要更複雜的機器人，像是多家族管理、跟 Google Calendar 同步、語音輸入
- 希望 LINE 機器人接金流（電商型機器人）

可以找「不想自己研究我教你」這個服務（規劃中）。

一對一帶你從 LINE 帳號申請、Supabase 跟 Render 設定、機器人開發，到部署整套跑完。

好處是不用自己摸索 3 個平台的介面，卡關有人帶，5 分鐘就解掉，4-6 小時一次到位。

代價很直接，就是要付費。

適合想做 LINE 機器人、但不想自己找問題，或是想要客製化功能的人。

### Summary

永久免費 LINE 機器人的完整做法：1) 群組還是一對一私聊，看資料邊界決定。2) Supabase 免費資料庫，加上 asyncpg 驅動前綴這個雷。3) LINE 的 Auto-reply 跟 Greeting 一定要關，不關的話，機器人訊息會被預設回覆蓋掉。4) Render 2025 砍掉免費 cron，改用 cron-job.org 替代，每分鐘戳一次，同時派發通知跟喚醒 web service。5) 自然語言解析用 regex 而不是 LLM，永久免費就不要付 API 費用。6) 五步一步一步做完，從 LINE 申請、Supabase 建庫、Claude Code 寫 FastAPI、Render 部署，到 cron-job.org 觸發。每月成本 NT$0，4-6 小時可以全部跑完。範例是家族行事曆，個人提醒、健身打卡、客戶常見問答都套得上。

### 名詞解釋

- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **Render**：雲端程式代管服務，免費方案能跑小型後端程式（例如 LINE 機器人）。免費版 15 分鐘沒流量會休眠，喚醒要 15-50 秒。
- **LINE 機器人**：在 LINE 裡自動回覆、主動推播訊息的機器人。台灣家庭幾乎人人用 LINE，是自動化通知的最佳入口。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **Supabase**：免費起步的雲端資料庫服務，提供資料庫＋登入驗證＋API，個人專案很夠用。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **Webhook**：「事件發生時，A 服務自動通知 B 服務」的機制。例如有人傳訊息給你的 LINE 機器人，LINE 就透過 webhook 把訊息轉給你的程式處理。
- **資料庫（database）**：專門儲存、查詢大量資料的系統。網站的會員、留言、紀錄都放這裡。
- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。
- **環境變數（environment variable）**：放在系統層、不寫進程式碼的設定值，最常用來放 API 金鑰等機密，避免跟著程式碼被公開。
- **API 金鑰（API key）**：服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。

### FAQ

**Q: LINE 機器人怎麼做？永久免費可能嗎？**

可以。技術上用四樣東西：FastAPI 當後端，Supabase 當資料庫（500 MB 免費），Render Web Service 負責部署（免費方案），cron-job.org 負責定時觸發（免費）。每月成本 NT$0。完整五個步驟：1) LINE Developers 申請帳號並關掉 Auto-reply，2) Supabase 建資料庫，3) Claude Code 寫 FastAPI，4) Render 部署，5) cron-job.org 設定每分鐘觸發。4-6 小時可以全部跑完。詳細看本文第 7 節。

**Q: 為什麼 LINE 機器人收到「感謝您加為好友」？**

因為 LINE Developers Console 預設開啟 Auto-reply messages，新好友會收到一段制式回覆，這段訊息會「先」於你的 webhook 觸發，等於蓋掉自己的機器人邏輯。解法是去 Messaging API 分頁，把 Auto-reply messages 跟 Greeting messages 都關掉。這個雷沒有錯誤訊息，也沒有紀錄檔，新手幾乎都會碰到，浪費 30 分鐘以上。詳細看本文第 3 節。

**Q: Render 2025 砍掉免費 cron 怎麼辦？**

用 cron-job.org 免費替代。在 Render web service 寫一個 /api/cron/dispatch 端點，讓 cron-job.org 每分鐘 GET 一次。一石二鳥，一邊派發到期通知，一邊喚醒 Render 免費方案的 web service，避免閒置 15 分鐘就休眠。設定 5 分鐘搞定，永久免費。教訓是當平台砍掉免費功能，外面通常已經有獨立的免費替代品，先不要急著付費。詳細看本文第 4 節。

**Q: LINE 機器人自然語言 parser 一定要接 AI 嗎？**

不一定，要看情境。簡單的「明天下午3點 媽媽 醫院」這種固定格式，用 regex 加中文時間詞典就夠了，明天、後天、下下週對應成日期，下午3點用 regex 抓，家人姓名查清單。0 元，0 延遲，也不用 API key。AI 留給真的需要理解上下文的場景，例如「老媽下次回診那天」要從歷史紀錄推算。每個月固定呼叫 API，對「永久免費」的專案來說方向不對。詳細看本文第 5 節。

**Q: LINE 機器人該用群組還是 1-on-1 私聊？**

看資料邊界。群組適合公共功能，像是投票、答題、群組查詢，缺點是訊息會被洗掉，通知精準度也差。一對一適合個人提醒這種有清楚對象的功能，每個用戶各自跟機器人對話，通知比較精準。家族行事曆我選一對一，再用邀請碼綁定家族，每個家人各自對話，新增行程時指定通知對象，時間到了機器人就私訊那個人。詳細看本文第 1 節。

**Q: Supabase 連線字串貼進 .env 跑不起來怎麼辦？**

多半是驅動前綴的問題。Supabase 給的字串開頭是 postgresql://，但 SQLAlchemy 的非同步驅動要 postgresql+asyncpg:// 才跑得動。差一個字母，套件就找不到，而且完全不會報你看得懂的錯。解法是把 postgresql:// 改成 postgresql+asyncpg://。這種錯誤訊息整段丟給 Claude Code，AI 一眼就能定位到驅動層。詳細看本文第 2 節。

---

## 我用 AI 做 link-in-bio 個人入口：1 天上線

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-built-link-in-bio-site.html
> 用 Claude Code 一天做完 link-in-bio 個人入口：6 個踩坑全紀錄(viewport / Vercel / 圖檔雙後綴)，為什麼不掛主站子網域。非工程師 1 天上線方法論。

短答給趕時間的人：90% 的人應該直接用 Linktree 或 Bento。30 分鐘上線，付費版一個月 270 元，比自己花一天做划算。只有三種情況值得自己動手：有多個品牌要一個中性入口、視覺風格本身就是識別、想拿這件事當公開練技術的案例。避開這些問題之後，照步驟表走 6 到 7 小時，第一次做再加 2 小時緩衝。最花時間的是兩件事。Vercel 免費方案的私人專案只認你註冊帳號的那個信箱，本機設的不一樣就擋掉部署，還有手機版縮放設了兩層，害 IG 內建瀏覽器畫面偏右。光這個就查了 2 小時。

一開始我以為 link-in-bio 用 Linktree 或 Bento 就好。

30 分鐘上線、月費 NT$ 270 也不貴。

但我有 Coolkid AI Lab 跟方舟藍圖兩個獨立品牌，加一個個人社群帳號。

我需要的是一個中性的個人總入口，可以同時連到多個品牌。

Linktree 一個模板所有人共用同一張臉，視覺風格綁死，做不出我要的 GameBoy 復古質感。

所以我決定自己動手做。

用 Claude Code 一天做出來，上線到 link.coolkidlab.com。

中間踩了 6 個從「看起來沒事」到「上線後才發現」的問題。

選錯目錄，把 bio 接到主站，主視覺圖 2.7MB 沒壓縮。

還有 Vercel Hobby 方案的 author email 不對被擋下，圖檔副檔名多了一層，最後是 viewport meta 雙重縮放，害 IG 內建瀏覽器的畫面偏右。

每個問題找原因都花掉 30 分鐘到 2 小時。

這篇是一步一步的教學，讀完你會拿到什麼？

第一，知道什麼時候該自己做，什麼時候直接用 Linktree，我的答案是 90% 的人應該用 Linktree。

第二，避開我親身遇過的那 6 個問題。

第三，用一天的時間表把自己的 bio 站從零做完上線。

範例網域是 link.coolkidlab.com。但 Vercel 免費子網域、Cloudflare Pages、自有短網域，都套得上。

### 決策框架：自己做 link-in-bio 還是用 Linktree？

90% 的人應該直接用 Linktree 或 Bento。

30 分鐘上線，不用維護，流量分析本來就有，月費 NT$ 270 比一天的工程成本便宜。

那什麼時候自己做才真的值得？下面 3 種情況：

1. 你有多個品牌想做一個中性入口（像是 Lab、投資學院、個人作品集），需要切割流量歸因，但又要有一個共同的對外介面。
2. 視覺風格就是品牌的核心識別（你需要 GameBoy 復古、Y2K 賽博龐克、像素 RPG 這類獨特風格），Linktree 的罐頭模板完全做不出來。
3. 你把這件事當成 build-in-public 的案例來練技術，順便學 Vercel 部署、Cloudflare DNS、快取控制、viewport 縮放。產出的文章跟影片還能回頭帶流量。

我屬於第 1 加第 2 種。

兩個品牌要切流量，但又要有共同的個人入口。而且視覺要 GameBoy 機殼風，Linktree 完全做不到。

自己做的成本是一天工程，加上永久的維護責任，像是 DNS、SSL、改連結，都要自己動手。

Linktree Pro 一個月 270 元，省下一天，但失去視覺自由度，也失去 SEO 跟 GA4 的控制權。

如果你不在意這兩件事，直接用 Linktree。

### 品牌切割原則：bio 站為什麼不能掛在主站子頁？

我第一個直覺是把 bio 做成 coolkidlab.com/links，10 分鐘就架好。

但這違反我自己 2026-05-10 寫進 memory 的原則。

那條原則是「Coolkid AI Lab 跟方舟藍圖完全獨立，不共用品牌、流量、工具」。

把方舟的連結，放在 coolkidlab.com 路徑底下，等於 Lab 網域在幫方舟導流。

Google Analytics 看來源網址整個混淆，誰是來看 Lab 內容，誰是來找 Coolkid 這個人，根本分不出來。

解法是拆成獨立的小站。

新開一個 `coolkid-bio` repo、獨立的 Vercel 專案、獨立的網域。

第一版先用 Vercel 免費子網域 `coolkid-bio.vercel.app`，試跑兩天確認沒問題。

後來才綁上 `link.coolkidlab.com` 這個子網域。

子網域在技術 SEO 上仍然歸 coolkidlab.com 這個根網域，所以我另外開了獨立的 GA4 資源，把流量歸因隔開。

裝 GA4 這一步自己就有一個經典陷阱：網站的安全設定(CSP)會把 GA 整個擋掉，儀表板一片零，還以為真的沒人來。我踩過一次，判斷方法和修法記在<a href="/newbie-pitfalls/ga4-csp-trap.html">CSP 擋掉 GA 的踩雷紀錄</a>。

三個做法照乾淨程度排序：

1. 獨立新網域（最乾淨）：買 coolkid.bio、coolkid.dev 或個人姓名 .me。SEO、GA4、GSC 完全跟其他品牌切開。缺點是要多管一個網域、SSL 跟續費。
2. 主站子網域加獨立分析（折衷，我選這個）：link.coolkidlab.com，DNS 走 Cloudflare CNAME 指向 Vercel，GA4 另外開一個資源。SEO 上仍然算 Lab，但流量族群切得開。
3. 主站子頁（最方便但流量會混）：coolkidlab.com/links。Vercel 直接部署，不用設 DNS。但跨品牌的連結全混進主站 GA4，新手要避開。

### 6 個踩坑全紀錄（從「看起來沒事」到「上線才發現」）

按照找問題花掉的時間排序，短的排前面：

1. <mark><strong>選錯目錄（找問題花 30 分鐘）</strong></mark>：SEO repo 底下有 v0.1、v0.2、v3 三個版本，現役只有 v3，v0.1 跟 v0.2 已經歸檔到 _archive/。我前面 30 分鐘都做在 v0.1，才發現預覽伺服器跑的是 v3。動工前先 grep `launch.json` 或 README 確認現役目錄，才不會做白工。
2. <mark><strong>圖檔副檔名雙後綴（找問題花 15 分鐘）</strong></mark>：從圖片編輯器匯出時，不小心存成 `portrait-real.webp.png`，兩個副檔名疊在一起，HTML 引用 `portrait-real.webp` 直接 404，觸發 onerror 備援圖。修法是改名成單一副檔名（`portrait-real.png` 或 `.webp` 任選一個），HTML 的 src 跟著對齊。Windows 檔案總管預設隱藏副檔名，你看不到雙後綴，要從 PowerShell 打 `ls` 才會現形。
3. <mark><strong>主視覺圖 2.7MB 沒壓縮（找問題 5 分鐘、壓縮 1 分鐘）</strong></mark>：原始 PNG 1823×863 直接放上去，部署上線後首屏 LCP 預估 5 到 8 秒（4G 環境），PageSpeed 直接扣分。用 Python PIL 一行壓成 webp、品質 82：`img.resize((1200, h)).save('hero.webp', 'WEBP', quality=82, method=6)`。從 2645KB 壓到 143KB，省了 95%。LCP 估計降到 1 秒以內。
4. <mark><strong>GitHub commit author 不對，Vercel Hobby 方案擋下部署（找問題花 1 小時）</strong></mark>：Vercel Hobby 方案的 <mark><strong>private repo 只允許 project owner 的 commit 觸發建置</strong></mark>。我用的是 GitHub noreply email `weiyin11@users.noreply.github.com`，但 Vercel 帳號註冊用 `try19901125@gmail.com`，兩者不同，Vercel 就把我當成「外人協作者」一律擋下，dashboard 顯示 `Deployment was blocked because the commit author did not have contributing access`。修法：`git config user.email "<vercel-account-email>"`（用 local 限定本 repo）→ `git commit --amend --reset-author` → `git push --force`（private repo 沒有別人，安全）。
5. <mark><strong>viewport meta 寫 `width=460` 加上 JS transform 雙重縮放（找問題花 2 小時）</strong></mark>：我寫 viewport=460，想讓手機瀏覽器自動把 460 的設計 fit 到裝置寬度，同時 JS 的 `fitShellToViewport` 又做了一次 transform scale，兩套縮放機制疊在一起。<mark><strong>IG 跟 Threads 的 App 內建瀏覽器</strong></mark>對 viewport meta 的行為，跟系統 Safari 不一樣，最後畫面偏右、右側被切掉。修法要三個一起做：viewport 改回 `width=device-width, initial-scale=1`，body 加 `display: flex; justify-content: center`，JS 算寬度改用 `Math.floor` 不要用 `Math.ceil`（下一條）。
6. <mark><strong>`Math.ceil` 多算 1px，害 flex 退化成左對齊（找問題花 30 分鐘）</strong></mark>：`Math.ceil(1120 * 0.397) = 445`，比 body 的內容寬度（`460 - padding 16 = 444`）多了 1px，flex 沒有空間置中，就退化成左對齊，看起來偏右一點。這個問題跟 `margin: 0 auto` 失效是同一個根源，只要 1px 溢出就會打破所有置中機制。改成 `Math.floor` 之後完美置中（centerDiff 0.00px）。

整批踩下來，教訓有三條。

第一，動多版本的 repo 之前，先確認哪個目錄是現役的。

第二，Vercel 部署加上自訂網域之後要在哪裡驗證？永遠用實機的 App 內建瀏覽器，預覽工具跟桌機模擬器都不可靠。

第三，CSS 的置中機制，對 1px 的溢出極度敏感，不管是 margin auto 還是 flex。

所以計算寬度永遠用無條件捨去，不要用無條件進位。

### 一天的步驟表（6-7 小時可以全部跑完）

把上面 6 個問題避開之後，一天可以全部跑完。

下面是我的時間表，每一段都已經扣掉找問題的時間：

1. 第 1 步（上午 30 分鐘）決定要不要做。你符合第 1 節那三個條件嗎？符合 1 個以上再動。沒符合就用 Linktree 省下一天。
2. 第 2 步（上午 1 小時）新建獨立 repo。`mkdir coolkid-bio && cd coolkid-bio && git init -b main`。<mark><strong>重點是不要建在主站 repo 的子目錄下</strong></mark>，新建一個獨立目錄跟主站平級。建 `vercel.json` 設快取 header（HTML 用 must-revalidate、靜態檔案用 immutable），再加 `.gitignore` 排除 `.vercel`。
3. 第 3 步（上午 2 小時）用 Claude Code 寫 index.html。指令範本：「請建一個 link-in-bio 單頁網站，視覺風格是 [一句話世界觀，例如『GameBoy DMG 復古機殼』]，包含 4 個區塊：主視覺大圖、彩色社群圖示（IG 跟 Threads 用 inline SVG）、4 個大連結卡片、footer 含 © 跟版本號。純靜態 HTML 加 CSS，不要用 JS framework。」一次到位之後再慢慢修視覺。
4. 第 4 步（中午 30 分鐘）壓縮主視覺圖。用 Python PIL：`from PIL import Image; img = Image.open('hero.png'); img.resize((1200, int(img.height * 1200/img.width)), Image.LANCZOS).save('hero.webp', 'WEBP', quality=82, method=6)`。2.7MB 變 143KB。或者用 squoosh.app 這個網頁工具來壓縮。
5. 第 5 步（下午 1 小時）Vercel 部署加自訂網域。`npm i -g vercel` → `cd coolkid-bio && vercel`（第一次會跑一輪設定問答）→ Vercel Dashboard → Settings → Domains → 加 `link.<yourdomain>.com`。Vercel 會給你 CNAME 目標，通常是 `cname.vercel-dns.com`。
6. 第 6 步（下午 30 分鐘）設定 DNS。Cloudflare → 對應的 zone → DNS → 新增 CNAME：Name 填 `link`，Target 填 `cname.vercel-dns.com`，<mark><strong>Proxy status 必須關掉變成灰雲（DNS only）</strong></mark>，否則 Vercel 的 SSL 會跟 Cloudflare proxy 打架，跳 502 或 521。DNS 生效要 5 到 30 分鐘，Vercel 會自動發 Let's Encrypt SSL。
7. 第 7 步（下午 1 小時）實機驗證，微調 viewport 跟置中。<mark><strong>永遠用真實手機開 IG、Threads、Safari</strong></mark> 點連結驗證，不要靠桌機的預覽工具，App 內建瀏覽器的行為跟桌面差太多。我就是在這一步發現 viewport 雙重縮放，又花了 2 小時排查。

總計大約 6 到 7 小時。

第一次做的人再加 2 小時的緩衝，因為你還不熟悉 Vercel CLI 跟 DNS 設定。

實際工程量取決於什麼？取決於視覺風格有多複雜。

GameBoy 機殼風的主視覺，加上偽元素、機身邊框那些細節，我額外花了 3 小時細修。

### GA4 與流量歸因設計（避免跨品牌混淆）

bio 站如果是個人入口性質、要連很多個品牌，那就開一個新的 GA4 資源。

跟其他品牌完全分開，不要共用主站的 GA4 ID。

為什麼不能共用？因為這兩群訪客的動機完全不同。

主站 GA4 看到的訪客，全是「來看主站內容」的那一群人，而 bio 站的訪客，則是「來找我所有東西」的另一群人。

混在一起算出來的跳出率、停留時間、轉換率，全都是失真的平均值。

但是 `link.coolkidlab.com` 這個子網域有一個限制。在 Google Search Console 裡，這個網址還是歸在 coolkidlab.com 底下。

根網域相同，這一層切不開。

如果你要連 SEO 跟 GSC 都完全切開呢？那就得用獨立網域，像是 coolkid.bio 或 coolkid.dev。

我目前接受這個取捨。子網域在 SEO 上仍然算 Lab，但 GA4 的族群是分開的，比起完全混在一起好多了。

快取策略也要單獨設定。

bio 站的 HTML 用 `Cache-Control` 設 `max-age=0` 加 `must-revalidate`，你改完連結之後，訪客下次進來立刻看到新版。

圖片跟 CSS 這些靜態檔案用 `max-age=31536000` 加 `immutable`，永遠快取到改檔名為止。

改完靜態檔案的內容要強制更新，就在 HTML 的 src 後面加 `?v=YYYYMMDD` 當版本記號。

### 不想自己設定怎麼辦？

上面這套自己跑一天，大概 6 到 7 小時。

那什麼樣的人不適合自己跑？符合下面任何一條就是：

- 不熟悉 git、Vercel CLI、Cloudflare DNS 任何一個，學習曲線比想像中長
- 只有一個品牌，Linktree Pro 一個月 270 元就夠用
- 沒有「視覺風格就是核心識別」的需求，你不在意網站長得像罐頭

符合任何一條，直接用 Linktree Pro 或 Bento.me。基本功能免費，要進階再升級 Pro。

多花 270 元，換省下一天時間，而且不用維護 DNS、SSL、快取設定。

如果你要的是「我要自己做但卡住了」，可以找 不想自己研究我教你（規劃中）。

一對一帶你從 repo 初始化開始，Vercel 部署、DNS 設定、實機驗證，整套跑完。

主要解的是 Vercel Hobby 方案的 author email，還有 viewport 雙重縮放，這種「Google 不到的具體問題」。

### Summary

用 AI 一天做出 link-in-bio 個人入口的完整步驟。（1）什麼時候該自己做：多品牌中性入口、視覺是品牌核心、當成 build-in-public 案例，三個情況符合 1 個以上再動，否則用 Linktree 省一天。（2）為什麼不能掛主站子頁：流量歸因會混淆到無法分析，解法是獨立 repo、獨立 Vercel 專案、子網域，再加獨立的 GA4 資源。（3）6 個踩坑：選錯目錄 30 分鐘、圖檔副檔名雙後綴 15 分鐘、主視覺 2.7MB 沒壓 5 分鐘、Vercel Hobby 方案的 author email 1 小時、viewport 雙重縮放 2 小時、Math.ceil 多 1px 30 分鐘。（4）一天的步驟表：決定 → 新 repo → 寫 HTML → 壓縮圖 → Vercel 部署 → DNS → 實機驗證，6 到 7 小時可以全部跑完。（5）GA4 流量歸因設計：開新資源跟其他品牌切割，子網域仍然在同一個 GSC 資源底下，但 GA4 的族群切得開。範例是 link.coolkidlab.com，獨立網域、vercel.app、Cloudflare Pages 都套得上。

### 名詞解釋

- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。
- **GA4（Google Analytics 4）**：Google 的流量分析工具：訪客從哪來、看了什麼、停多久。GSC 管「搜尋結果上的表現」，GA4 管「進站後的行為」。
- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。
- **SEO（搜尋引擎優化）**：讓網站在 Google 搜尋結果排得更前面的一整套方法，涵蓋技術體質、內容品質、連結結構三層。
- **WebP**：Google 推的圖片格式，同樣畫質下檔案比 PNG / JPG 小很多，常見能省 90% 以上。
- **壓縮（minify）**：把程式碼裡的空白、註解拿掉讓檔案變小，功能完全不變。
- **快取（cache）**：把載過的資源暫存起來，下次直接用、不重新下載。網站變快的最便宜手段之一。
- **提交（commit）**：Git 的一個存檔點：把這次改動連同一句說明記錄下來，之後隨時可以回到這個版本。
- **GSC（Google Search Console）**：Google 給網站主的免費後台：看自己網站在搜尋的曝光、點擊、排名跟索引狀態。做 SEO 的人天天開的儀表板。
- **最大內容繪製（LCP, Largest Contentful Paint）**：頁面上「最大那塊內容」（通常是首圖或大標題）出現所需的秒數。Google 標準 ≤ 2.5 秒。
- **HTML**：網頁的骨架語言，定義「這是標題、這是段落、這是圖片」。

### FAQ

**Q: 自己做 link-in-bio 站值得嗎？什麼時候用 Linktree？**

90% 的人應該用 Linktree 或 Bento，30 分鐘上線、流量分析本來就有，Pro 一個月 270 元。自己做只有 3 種情況真的值得：（1）有多個品牌想做中性入口集中流量；（2）視覺風格是品牌的核心識別，罐頭模板做不出來；（3）把這件事當成 build-in-public 案例，順便練 Vercel、DNS、快取技術。符合 1 條以上再動，沒符合就用 Linktree 省一天。詳細看本文第 1 節。

**Q: bio 站該掛主站子網域還是獨立網域？**

看你的流量歸因需求。要完全切開 SEO 加 GA4 → 買獨立短網域（coolkid.bio、coolkid.dev 或個人名字 .me），最乾淨但要多管一個網域。折衷方案 → 主站子網域（`link.<yourdomain>.com`）加獨立 GA4 資源，子網域的 SEO 仍然歸主站根網域，但 GA4 族群切得開，我自己選這個。最方便但流量會混 → 主站子頁（`<yourdomain>.com/links`），新手要避開，因為跨品牌的連結全混進主站 GA4。詳細看本文第 2 節。

**Q: Vercel Hobby plan 為什麼會 Block 我的 deploy？**

Vercel Hobby 方案規定 <mark><strong>private repo 只允許 project owner 的 commit 觸發建置</strong></mark>。如果你 git config 用的是 GitHub noreply email（例如 `weiyin11@users.noreply.github.com`），跟 Vercel 帳號註冊的 email（例如 `try19901125@gmail.com`）不同，Vercel 就把你當成「外人協作者」一律擋下。Dashboard 會顯示「Deployment was blocked because the commit author did not have contributing access」。修法：`git config user.email "<vercel-account-email>"` → `git commit --amend --reset-author --no-edit` → `git push --force`（private repo 沒有別人，安全）。詳細看本文第 3 節第 4 條。

**Q: viewport meta 怎麼設才能在 IG / Threads in-app browser 置中？**

三件事一起做：（1）viewport meta 用 `width=device-width, initial-scale=1, viewport-fit=cover`，<mark><strong>不要用 `width=460` 強制指定版面寬度</strong></mark>，那會跟 JS 的 transform scale 疊成雙重縮放；（2）body 加 `display: flex; justify-content: center` 置中，不要靠 `margin: 0 auto` 加寬度計算，那對 1px 溢出極度敏感；（3）JS 算舞台寬度用 `Math.floor` 不要用 `Math.ceil`，避免多 1px 害 flex 退化成左對齊。三個一起才會完全解掉。詳細看本文第 3 節第 5 到 6 條。

**Q: Hero 大圖怎麼壓縮？**

用 Python PIL 一行壓成 webp：`from PIL import Image; img = Image.open('hero.png'); img.resize((1200, int(img.height * 1200/img.width)), Image.LANCZOS).save('hero.webp', 'WEBP', quality=82, method=6)`。我自己把 2.7MB 的 PNG 壓到 143KB，省了 95%。品質 82 是甜蜜點，80 以上肉眼看不出差異，70 以下可能出現壓縮痕跡。替代工具是 squoosh.app，網頁版、免裝 Python。LCP 從預估的 5 到 8 秒（4G）降到 1 秒以內。詳細看本文第 3 節第 3 條。

**Q: 一天真的能做完嗎？**

照本文的步驟走、避開那 6 個坑，6 到 7 小時可以全部跑完。時間分配：決定要不要做 30 分鐘、新 repo 加 vercel.json 1 小時、Claude Code 寫 HTML 2 小時、壓縮主視覺圖 30 分鐘、Vercel 部署 1 小時、Cloudflare DNS 30 分鐘、實機驗證 1 小時。第一次做的人再加 2 小時緩衝，因為還不熟悉 Vercel CLI 跟 DNS 操作。實際工程量取決於視覺風格多複雜，越獨特的主視覺、機身邊框、偽元素，細修就越花時間。

---

## Claude Code vs Cursor：非工程師怎麼選

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-vs-cursor.html
> claude code 跟 cursor 該選哪個？一個完全不會寫程式的全職交易者的真實選擇 + 公正對照表(Cursor 贏的地方照列)。網路上的比較都是工程師視角，這篇補上非工程師視角。

短答給趕時間的人：完全不想看程式碼、想用「講話」把東西做出來，選 Claude Code;想要一個有畫面、看著程式碼一行行改、未來想學寫程式，選 Cursor。兩個都是 Pro 每月 US$20。我自己是非工程師，選了 Claude Code，理由跟「效能跑分」無關，是「我根本不想看到程式碼」。

這裡先誠實講一件事。我從 2026 年 4 月中開始主力用 Claude Code，Cursor 只實際開來試過，加上查官方文件與公開評測。

所以下面對照表 Cursor 的部分我盡量引客觀資料，不裝深度體驗。

我能給你的獨家，是「一個真正的非工程師為什麼這樣選」。

這正好是網路上一堆比較文缺的，因為那些文章幾乎都是工程師寫的，結論常常是「新手選 Cursor」。

這篇為什麼值得你看？

你 Google「claude code vs cursor」跑出來前 10 名，清一色談「重構能力、context window、日常編碼速度」。

那是給會寫程式的人看的。

如果你跟我一樣不會寫程式，你要問的問題根本不一樣。

### Claude Code 和 Cursor 一句話差在哪？

<a href="/newbie-pitfalls/claude-code-what-is.html">Claude Code</a> 是「在終端機裡用自然語言下指令，AI 直接動手」。

讀檔、改檔、裝套件、跑指令、部署，你用講的，它執行。

Cursor 是「一個像 VS Code 的編輯器，AI 在你打程式碼時旁邊幫你補完、改區塊」。

你還是在編輯器裡工作，AI 是助手。

對非工程師來說，最關鍵的差別是什麼？

Claude Code 你可以完全不看程式碼，用講的就好;Cursor 預設你會一直看到程式碼(雖然是 AI 幫你寫)。

前者你「指揮」，後者你「駕駛」。

### Claude Code vs Cursor 對照表（非工程師視角）

有一件事先說在前面。下面這張表我刻意把 Cursor 贏的地方也標出來(打 ✅)，因為一張全部都說自己選的工具好的對照表，沒有參考價值。

所以我的結論是這樣。純看「強不強」，大型任務 Claude Code 佔優、日常編碼 Cursor 順手。

但對非工程師，真正的分水嶺不是強弱，是「我想不想看到程式碼」。

### 一個非工程師為什麼選 Claude Code？3 個理由

- 我不想看到程式碼。Claude Code 我用講的、它動手，我只看結果(網站長怎樣、機器人有沒有發)。Cursor 我還是會一直看到一堆看不懂的程式碼，反而焦慮。
- 它能一條龍跑完整套。裝套件、改多個檔、跑指令、部署 Vercel，全在終端機裡，我不用在編輯器裡點來點去找檔案。
- 「看不懂程式碼」反而逼我放手。因為看不懂，乾脆完全信任它的 plan mode，專注在「我要什麼」而不是「它怎麼寫」。這對非工程師其實是優勢，不是劣勢。

### 那什麼人該選 Cursor？（誠實說 Cursor 贏的地方）

「新手選 Cursor」這個網路共識沒有錯，那是對「想學寫程式的新手」講的。下面這幾種人，Cursor 確實比較適合：

- 你已經會用 VS Code，Cursor 幾乎零學習成本。
- 你想「順便學寫程式」，看著程式碼改學得到，用 Claude Code 你會學很少。
- 你喜歡看著紅綠對照確認每個改動，Cursor 的圖形介面比終端機安心。
- 你常做小範圍、即時的程式碼微調，Cursor 的行內補完更快。

所以這不是「Claude Code 比較好」，是「<a href="/newbie-pitfalls/which-ai-tool-to-start.html">你是哪種新手</a>」。

想學程式碼就選 Cursor;不想碰程式碼、只想把東西做出來，就選 Claude Code。

### 30 秒決策：不知道怎麼選？

- 完全不想看程式碼、用講的就好，選 Claude Code。
- 想看著程式碼學、未來想會寫程式，選 Cursor。
- 已經熟 VS Code，選 Cursor。
- 想要的是「裝、改、部署一條龍自動跑」，選 Claude Code。
- 還是不確定的話，兩個都 US$20，各用一週，選你比較不焦慮的那個。

### Summary

Claude Code 跟 Cursor 對非工程師的真正分水嶺，不是「誰比較強」，是「你想不想看到程式碼」。Claude Code 是終端機用講的、它動手，可以完全不看程式碼，適合「不想碰程式碼、只想把東西做出來」的人;Cursor 是 VS Code 式的編輯器，有視覺化的紅綠對照，看著程式碼改，適合「想順便學寫程式」或「已經熟 VS Code」的人。網路共識「新手選 Cursor」是對想學程式的新手說的。我一個完全不會寫程式的交易者選了 Claude Code，用它做了整個網站和幾個自動化機器人。兩個都是每月 US$20，不確定就各試一週。

### 名詞解釋

- **Cursor**：內建 AI 的程式編輯器，跟 Claude Code 同類，但走「圖形介面編輯器」路線而非終端機路線。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **無程式碼（no-code）**：不寫程式、用拖拉跟設定做出應用的工具或方法。AI 代理出現後，「會描述需求」比「會不會寫程式」更關鍵。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。

### FAQ

**Q: Claude Code 和 Cursor 哪個適合新手？**

看你是哪種新手。想學寫程式、已經熟 VS Code → Cursor(這也是網路上工程師的共識);完全不想碰程式碼、只想用講的把東西做出來 → Claude Code。兩個 Pro 方案都是 US$20/月，不確定就各試一週，選你比較不焦慮的那個。

**Q: Claude Code 和 Cursor 可以同時用嗎？**

可以，很多資深開發者這樣：Claude Code 跑重活(整庫重構、多檔修改、部署)，Cursor 做日常小修。但對非工程師，建議先專心用一個，不用一開始就兩個一起學。

**Q: 非工程師完全不會寫程式，能用 Claude Code 嗎？**

能。Claude Code 就是設計成讓你用自然語言下指令、它動手執行。我自己完全不會寫程式，用 Claude Code 做了這整個網站 + 幾個自動化機器人。安裝步驟看「Claude Code Windows 安裝踩雷實錄」那篇。

**Q: Cursor 比較便宜還是 Claude Code 便宜？**

一樣。兩個的 Pro 方案都是每月 US$20。差別不在價格，在互動方式：Claude Code 是終端機對話，Cursor 是編輯器。選工具不用看價格，看你想不想看到程式碼。

**Q: Claude Code vs Cursor 哪個比較強？**

看用途。大型重構、整庫分析、自主多步任務，Claude Code 佔優(1M context window);日常編碼速度、行內補完、視覺化的紅綠對照，Cursor 順手。但對非工程師，「強不強」不是重點，「我能不能不看程式碼把事做完」才是。

---

## 重複工作吃掉每天 2 小時？三條件挑對第一件

> Source: https://www.coolkidlab.com/newbie-pitfalls/repetitive-work-automation-start.html
> 重複工作的問題不是難，是每件都太小不值得停下來處理。三個條件挑出第一件該自動化的事：每天做、步驟固定、做錯也不會怎樣。非工程師的真實過程，從交易日誌開始。

短答給趕時間的人：重複工作之所以難擺脫，問題不在難度，而在每一件都不夠大到讓你停下來處理。把零散的 10 分鐘加起來，常常超過 2 小時。自動化真正的起點，是先抓出「每天都做、步驟都一樣、做錯了也不會怎樣」的那件事，學程式反而排在後面。

先說清楚，我不是工程師。

我會的程式大概就是國中資訊課的程度，而且還忘光了。

但從 2026 年 4 月中開始，我把好幾件每天重複做的事丟給 AI 去跑：交易日誌的整理、社群貼文的排程、家裡長輩群組的雜事。

我沒有變成程式設計師，我只是學會了一件更前面的事，怎麼看出哪件事根本不該由我手動做。

這篇不教你寫程式，講的是更前面那一步。

你每天到底有多少時間，是被「不該你做的事」吃掉的？

### 重複工作偷走的時間，比你感覺到的多很多

你不會記得今天花了多少時間在重複工作上，因為重複工作從來不是一大塊。

是早上把昨天的數字抄進表格的 8 分鐘，是同樣一段話貼到三個群組的 5 分鐘，是每篇貼文手動排版的 15 分鐘。

每件都小到不值得停下來，於是你每天做、每天忘、隔天再做一次。

我自己第一次真的去算，是在做交易記錄的時候。

我每天收盤後手動把當天的單整理成日誌，一次大概 20 幾分鐘。

乘上一個月是多少？光這一件事就吃掉我超過 10 個小時。

重點不是哪一件事很花時間，是這些「不夠大到讓你處理」的小事，加起來大到會偷走你整個下午。

### 自動化的第一件事，該怎麼挑？

大部分人卡在「我又不會寫程式」，所以連想都不敢想。

但真正的起點跟程式無關。那要從哪裡開始？你要先挑對第一件值得自動化的事。

我自己用三個條件來篩，挑出來的成功率最高：

1. 條件 1：每天或每週都會做。一次性的事不值得，重複才有複利。
2. 條件 2：步驟每次都一樣。流程固定 AI 才接得住，每次都要臨場判斷的先別碰。
3. 條件 3：做錯了也不會出大事。從低風險的開始，壞了重來就好，不要拿報稅或匯款當練習。

第三條最容易被忽略，但其實最重要。我一開始差點挑的是下單通知系統，每天做、步驟固定，前兩條都過了。但通知出錯可能讓我錯過行情或重複進場，代價太高，根本不適合拿來練手。

新手最常犯的錯就是挑了一件「很想自動化」但風險很高的事，結果出包一次就嚇到不敢再試。先從壞了也沒差的開始，成功一次之後，你自然會知道下一件該挑什麼。

我的第一件，就是那個交易日誌。

每天做、格式固定、整理錯了頂多重貼一次，完全符合上面那三條。

我把流程講給 AI 聽，讓它幫我把零散的紀錄整理成固定格式。

我從每天 20 分鐘，變成貼上去、看一眼、收工。

那不算什麼厲害的工程，卻是我第一次發現「原來這種事真的可以不用我做」的轉捩點，從那之後我看事情的角度就變了。

### 你不需要先變強，你需要先開始

我知道你現在在想什麼，因為那也是我 2026 年 4 月中剛開始時想的：「這些聽起來都要會寫程式吧。」

我後來做的東西，每天定時自動發的社群貼文、幫家裡長輩處理雜事的小機器人，沒有一個是我「學會程式」之後才做的。

最近的一件是簡報。每週要交的那種，AI 生成完我還想換版面、改動畫、只重做某一頁，於是動手做了 <a href="/workflows/shiftdeck.html">一個做完還能自己改的簡報工具</a>。一樣是先挑一件夠小、又天天煩我的事。

順序其實是反過來的，我先挑了一件夠小的事，硬著頭皮開始，過程中卡住就問 AI，邊做邊學。

能力是做出來的，不是準備好的。

我以為要先準備好才能動手。後來發現，是動手的過程本身在準備我。

### Summary

重複工作偷走的時間比你感覺到的多，因為每一件都小到不值得處理，加起來卻是整個下午。自動化的起點是挑對第一件事，不是先去學程式：每天都做、步驟固定、做錯也不會出大事，三個條件都符合的成功率最高。第三條最容易被跳過，但挑錯風險等級是新手放棄的頭號原因。別等到變強才開始，能力是在動手的過程中長出來的。想看挑對之後實際長什麼樣子，往下接交易日誌與自動發文那兩篇。

### 名詞解釋

- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **無程式碼（no-code）**：不寫程式、用拖拉跟設定做出應用的工具或方法。AI 代理出現後，「會描述需求」比「會不會寫程式」更關鍵。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。

### FAQ

**Q: 完全不會寫程式，真的能做自動化嗎？**

能。這篇講的起點跟寫程式無關，是先挑出一件每天做、步驟固定、低風險的事。動手過程卡住的地方再問 AI，邊做邊學，不需要先學完程式。

**Q: 第一件該自動化的事怎麼挑？**

用三個條件篩：每天或每週都會做、步驟每次都一樣、做錯了也不會出大事。三個都符合的成功率最高。從笨到不行的小事開始，不要拿金流、報稅這種高風險的事來練習。

**Q: 自動化要花多少時間才看得到效果？**

因事而異，但建議先花 30-60 分鐘試一件小的。重點不是一次到位，是先做出第一個「原來這真的可以不用我做」的成功經驗，後面才接得下去。

**Q: 自動化會不會出錯反而更麻煩？**

所以第一件要挑「做錯了也不會怎樣」的事。低風險的事就算跑錯，重來一次就好，這也是為什麼不建議新手從金流或法律相關的事開始。

---

## 不會寫程式，還有可能自己做出工具跟網站嗎？

> Source: https://www.coolkidlab.com/newbie-pitfalls/no-code-can-i-build.html
> 以前「不會寫程式」幾乎等於「做不出來」，現在這條線移動了。這篇用一個非工程師的真實經驗，講清楚你現在做得到什麼、會卡在哪，以及為什麼講清楚比會寫程式更關鍵。

短答給趕時間的人：可以，而且門檻比你想的低很多。過去「不會寫程式」幾乎等於「只能花錢請人，或者乾脆放棄」。現在 AI 把這條線往下移了一大截，你要做的變成把想法講清楚給 AI 聽，讓 AI 寫，你負責跑跑看、告訴 AI 哪裡要改。

我會的程式趨近於零。但我現在用的這個網站、每天在跑的幾個小工具，都是我自己做出來的。

我沒有去報程式班，也沒有把哪本教科書從第一頁讀到最後一頁。

我只是換了一種做事的方式。

我不打算跟你說「很簡單，人人都會」，那種話是騙人的。

真的動手做，還是有幾個地方會讓你卡住，我等一下會老實講。

這篇要回答的其實只有一個問題：不會寫程式的人，到底還做不做得到？

### 不會寫程式，現在做東西還會卡在哪？

三年前，一個不會寫程式的人想做一個網站或小工具，路大概只有兩條：花錢請人，或者放棄。

現在多了第三條路可以走。

你把想做的東西描述給 AI 聽，AI 幫你把程式寫出來，你負責跑跑看、指出哪裡不對、讓 AI 改掉，來回幾次就有一個能動的版本。

整個過程你打進去的字都是中文，從頭到尾沒有一行程式碼。

程式現在是 AI 在寫。你要負責的變成兩件事：講清楚你要什麼，還有出錯的時候不要就這樣把視窗關掉。

### 用 AI 做東西，真正要會的是什麼？

把 2026 年 4 月中到現在拆開來看，我真正在做的只有兩件事，而且兩件都跟寫程式沒有關係：

1. 把想法講清楚：你想做的東西，能不能<a href="/newbie-pitfalls/how-to-prompt-ai.html">拆成一句一句具體的話</a>？像是「我要一個頁面，上面有標題、三個區塊、最下面放一個按鈕」。能講到這種程度，AI 就接得住。講不清楚的話，再強的工具也幫不了你。
2. 出問題的時候不要放棄：一定會出錯。做得出東西的人跟半路停下來的人，差別常常不在能力，而在看到紅字之後的下一步。一個直接把視窗關掉，一個把紅字複製給 AI，問這是什麼意思、要怎麼修。

這兩件聽起來都很基本，但真正把新手卡在原地的幾乎都是這裡，很少是程式本身太難。

好消息是，講清楚跟不放棄，你在工作跟生活裡早就練過很多次了。

做得出東西的人，多半只是比較不怕卡住而已。卡住的時候回頭多問一句，通常就過去了。

### 能做得出來，那過程會不會很痛苦？

我不想賣你一個太美的故事。我自己最常犯的錯，是一開始就想做太大。

第一個專案就挑功能一大堆的東西，結果改到第三天還在原地打轉。

後來我學乖了，先做一個小到不行、但真的跑得起來的版本。想把這個做法接成完整路徑，可以看<a href="/newbie-pitfalls/ai-make-website-guide.html">我從 0 上線網站的 5 個階段</a>，先能用，再一項一項往上加。

能跑的醜東西，遠勝過想像中很完美、但永遠做不完的東西。

另一個坑，是以為哪裡壞掉就修哪裡。

如果同一個地方改了三次以上都還是不對，你該問的是：<a href="/newbie-pitfalls/frontend-backend-database.html">問題真的出在那幾行嗎</a>？

很多時候是一開始的結構就歪了，這種情況重寫會比一直修補快得多。

這件事我繞了很久才想通。

### Summary

不會寫程式，現在仍然做得出個人網站跟自己要用的小工具。因為你要做的已經不是從頭寫程式，而是把想法描述給 AI，由 AI 寫出來，你負責測試跟指出哪裡要改。難的地方在於把需求講清楚，還有出錯的時候願意繼續問下去。當然不會完全無痛。第一個專案別挑太大的，看到紅字不要馬上關掉視窗，同一個地方修三次還是不對就該重寫。能跑的陽春版，遠勝過永遠做不完的完美版。

### 名詞解釋

- **無程式碼（no-code）**：不寫程式、用拖拉跟設定做出應用的工具或方法。AI 代理出現後，「會描述需求」比「會不會寫程式」更關鍵。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。

### FAQ

**Q: 完全零基礎，真的能自己做出網站嗎？**

能。你要做的已經不是從頭寫程式，而是把想做的東西描述給 AI，由 AI 寫出來，你負責測試跟修正。整個過程主要打進去的字都是中文。難的地方是把需求講清楚，還有出錯的時候願意繼續問下去。

**Q: 那我還需要學程式嗎？**

不需要先學完才開始。能力是在動手的過程裡長出來的。卡住的時候問 AI 那一段在做什麼、要怎麼改，比先讀完一本教科書有效得多。想再往下走一步，之後回頭把基礎讀起來也不遲。

**Q: 做出來的東西能用嗎，還是只是玩具？**

個人用途、小型網站、自己要用的小工具完全可用。但如果是要承受大量使用者、牽涉金流或資安的商業系統，還是建議找專業工程師，不該交給新手的練習作品。

**Q: 第一個專案該做什麼？**

做一個小到不行、但能完整跑起來的東西。別一開始就挑功能很多的大專案，那是新手最常見的卡死原因。能跑的陽春版，遠勝過做不完的完美版。

**Q: 同一個地方改了好幾次還是不對，怎麼辦？**

先問問題是不是出在更前面的地方。同一個地方改了三次以上都還是不對，通常不是那幾行的問題，是一開始的結構就歪了。這種情況重寫整個區塊會比一直修補快得多。不要怕砍掉重來，比繼續在原地打補丁有效。

---

## AI 工具這麼多，非工程師到底該從哪個開始？

> Source: https://www.coolkidlab.com/newbie-pitfalls/which-ai-tool-to-start.html
> 面對一堆 AI 工具不知道選哪個，是正常的——但「先選工具」本身就是錯的順序。這篇教你用「你想做什麼」反推該用什麼，而不是被工具名單淹死。

短答給趕時間的人：不要問「哪個 AI 工具最強」，要問「我想做出什麼」。工具多到讓人不知道從哪裡下手，是因為你想先把工具選對了再開始，但真正該有的順序其實跟你想的剛好相反。先確定你要做的事，再用這件事反推工具，選擇瞬間就從幾十個縮到兩三個。

每隔幾天就有人跟你說「這個 AI 神器你一定要用」，清單越列越長，你越看越焦慮，結果是一個都沒真的開始用。

我懂這種感覺。我剛開始那陣子，有一半時間花在看別人推薦的工具，打開來玩一玩然後又關掉。

真正做出東西，是我停止「找最強工具」之後才開始的。

工具清單你已經有太多了。

這篇不列清單，給的是一個讓你自己判斷該從哪一個開始的方法。

### 工具太多不是你的問題，但「先選工具」是錯的順序

你卡住，跟懂不懂沒什麼關係，問題出在起點：「我該用哪個 AI 工具」這句話本身就沒有答案，因為缺了一個前提。

就像問「我該買哪台車」。不先講你要載貨還是市區代步，這題要怎麼答？

AI 工具也是同一回事。

工具是拿來做事的。先確定你想做的事，那件事會自己把工具範圍縮到剩兩三個。你要挑的是最適合這件事的那一個，至於誰最強，跟你現在要做的事關係不大。

### 用「你想做什麼」反推工具

所以你到底想做出什麼？

把你想做的事大致分成三類，方向就清楚了：

- 你想寫東西 / 想事情（寫文章、整理想法、做研究）→ 從一個你用得順的對話式 AI 開始就好，先把「跟 AI 一起想事情」練熟。
- 你想做出網站或工具 → 你需要的是<a href="/newbie-pitfalls/ai-coding-tools-compare.html">能實際幫你動手寫、還能跑起來的環境</a>，而不只是聊天框。
- 你想自動化重複的雜事（定時發文、整理資料）→ 你要找的是能「<a href="/newbie-pitfalls/ai-agent-vs-chatgpt.html">按流程做事</a>」的工具，重點在能不能照你給的步驟一路跑完。

這三類會有重疊，同一個工具常常兩類都做得來。真正要先想清楚的還是你這個月最想解決哪一件事。

一旦你說得出「我想做 X」，剩下的選擇就只有兩三個，而且哪一個都能開始。

第一個工具的任務就是讓你跨出第一步，不必陪你一輩子。

### 一直換工具，為什麼反而做不出東西？

剛開始我每看到一個新工具就想換，總覺得「下一個一定會更好」。

結果每一個都只摸到皮毛，每一次都要從零開始適應，幾個月下來一個成品都沒做出來。

後來我才懂，剛起步的那段時間裡，不同工具之間的差距，其實都遠遠小於「你還不熟這個工具」本身造成的差距。

與其一直換，不如挑一個能做你想做的事的工具，一路用到做出第一個成品為止。

怎麼算「做完一件」？網站有人打得開、貼文真的自動發出去，這種看得到結果的程度。

等你真的用到覺得這個工具不夠了，你自然會知道下一個該換什麼。

那是你用經驗換來的判斷，比推薦清單上的名字可靠得多。

工具會一直更新，但「把一個工具用到做出東西」這段經驗不會過期。先做完一件，再想換更好的。

### Summary

面對一堆 AI 工具不知道從何選起，跟你懂不懂沒關係，是順序錯了。別問哪個最強，先確定你想做什麼：想寫東西就用對話式 AI，想做網站就用能動手寫的環境，想自動化就找能按流程做事的工具。事情一旦定下來，選擇就剩兩三個。最後一個提醒，別一直換工具，剛起步的時候，工具之間的差距小於你還不熟造成的差距，先用一個做出第一個成品再說。

### FAQ

**Q: 新手第一個 AI 工具該選哪個？**

沒有通用答案，要看你想做什麼。想寫東西或想事情，從一個順手的對話式 AI 開始。想做網站或工具，需要能實際動手寫、還能跑起來的環境。想自動化雜事，找能照流程做事的工具。先把事情定下來，工具範圍自然就縮小了。

**Q: 免費的工具夠用嗎，還是一定要付費？**

新手起步的階段，免費或低價方案通常就夠你做出第一個成品，也夠你確認這條路適不適合自己。等你用到免費版真的不夠、也很清楚自己缺哪個功能，再升級也不遲。還沒開始就先煩惱要不要付費，反而最浪費時間。

**Q: 工具一直更新，現在學會不會很快就過時？**

工具會過時，但「把一個工具用到做出東西」這段經驗不會。按鈕的位置會變，可是「怎麼把需求講清楚、怎麼找出哪裡出錯、怎麼判斷該不該換工具」這幾樣基本功，換到下一個工具一樣管用。

**Q: 可以同時學很多個工具嗎？**

不建議。新手同時學好幾個，最常見的結果是每個都只摸到皮毛，什麼都沒做成。先用一個做出第一個成品，把一件事從頭走完一次，再去學第二個。

---

## AI 只會回答？3 個能直接交辦的任務

> Source: https://www.coolkidlab.com/newbie-pitfalls/chatgpt-from-asking-to-doing.html
> AI 不只會回答。用回覆客戶、整理會議待辦、比較訂閱方案 3 個範例，看懂怎麼把問題改成可驗收的任務，以及何時該換 Claude Code 或 Codex。

短答給趕時間的人：「問 AI 問題」和「叫 AI 做事」中間隔著一道門檻，跟你選哪個工具關係不大，關鍵在你交給 AI 的是什麼。問問題，你給的是一個疑問，AI 回你一段文字。叫 AI 做事，你要給的是一個講清楚的任務，再加上一個 AI 能真的動手的地方。多數人停在前面那一半，把 AI 當成更聰明的搜尋引擎在用。

你大概也是這樣用 AI 的：有問題就問一句，AI 回你一大段。你看一看、複製需要的部分，結束。

這樣用沒有錯，只是你用到的是 AI 一小部分的能力，剩下那一大半一直沒被打開。

先把這篇說的 AI 講清楚：回信、摘要、比較表這類成品，留在對話框就能完成。真的要碰檔案、跑指令或接服務，才需要能動手的 <a href="/newbie-pitfalls/what-is-ai-agent.html">AI Agent</a>。

同一個 AI，其實可以從「回答你」再往前一步，變成「幫你把一件事從頭做到尾」。

我自己也卡在「只會問問題」很久，久到以為 AI 就只能這樣用。後來才一步一步跨過去。

那道門檻到底長什麼樣子？

跨過去之後，你手上一堆重複的事就有機會直接交出去，不用再自己一件一件做。

### 「問問題」和「叫 AI 做事」差在哪裡？

差別其實很簡單，只是很多人從來沒往這個方向想過。用了兩三年還是同一套。

問問題的時候，你給的是一個疑問（「這個怎麼用？」），AI 給你一段說明，主導權整個在你手上，AI 只負責回答。

叫 AI 做事的時候，你給的是一個任務（「幫我把這 50 筆資料整理成這個格式」），AI 直接產出成品，換你來檢查。

差別不在指令變長，而是你有沒有交代完成條件。下面 3 個任務都能直接在一般對話框裡做，不用先裝新工具。

1. <strong>回覆客戶信。</strong>只問一句是「這封信怎麼回？」這句沒有交代背景、語氣、長度，也沒說要的是建議還是一封完整回覆。改成交辦：「下面是客戶抱怨延誤的來信。先列出對方最在意的 3 件事，再寫一封 150 字內的回覆，承認延誤、說明新交期、不要推責，也不要直接寄出。」你拿到的是一封可以逐句檢查的草稿。
2. <strong>把會議紀錄變成待辦。</strong>只問一句是「幫我整理會議紀錄」，每個人想像的整理方式都不一樣。改成交辦：「把下面的會議紀錄整理成表格，欄位是待辦、負責人、期限、尚未確認。缺少的資料標成待確認，不要自己猜。」你拿到的是一張可以直接追工作的清單。
3. <strong>比較訂閱方案。</strong>只問一句是「哪個方案比較好？」AI 很容易替你做一個沒有條件的結論。改成交辦：「比較下面 3 個方案，列出每月成本、核心功能、限制與適合誰。如果資料不足，先問我最多 3 個問題，不要替我決定。」你拿到的是一張能拿來做最後選擇的比較表。

下次別只丟「問題」，試著交一個「任務」過去。問題問完你也只是知道了，事情還是得自己做。你會發現一堆原本自己手動在做的事，其實可以直接交出去。

### 從對話到做事，中間要補上兩樣東西

要讓 AI 真的幫你做事，你要補上的不是更聰明的問法。真正缺的是下面這兩樣東西。

1. <a href="/newbie-pitfalls/how-to-prompt-ai.html">一個講清楚的任務</a>：把「我想要的成品長什麼樣」講到具體。「幫我寫一下」這種講法 AI 只能亂猜，換成「幫我寫一封給客戶的道歉信，語氣誠懇、三段、不要太正式」就準得多。你講得越具體，AI 做得越準。
2. 一個 AI 能動手的地方：只是要文字產出，對話框就夠用。但你如果要 AI 幫你「操作」東西（整理檔案、定時發文、跑一整個流程），就得把 AI 放進一個<a href="/newbie-pitfalls/what-is-ai-agent.html">能真的動手的工具</a>裡。這一步就是多數人沒跨過去的地方。

會卡住的多半都是第二樣。

把任務講清楚，練幾次就會了。難的是後面那一樣，你得去碰一個從來沒用過的工具。

判斷工具時先看成品放在哪裡。回信、摘要、比較表只要在對話框裡產出，用 ChatGPT 或 Claude 的一般對話就夠。要讀寫本機檔案、跑指令或修改程式庫，再換成 Claude Code 或 Codex。需要跨服務搬資料，則選能取得相關服務權限的 Agent 或自動化工具，而且只開任務需要的權限。

如果你還是不確定手上的任務該留在對話框，還是交給會動手的工具，可以用<a href="/newbie-pitfalls/ai-agent-vs-chatgpt.html">這 3 個問題判斷該選一般對話、能處理多步任務的 Work，還是程式工具 Codex</a>。

### 不用一步到位，從「半自動」怎麼開始？

我知道「讓 AI 自動幫你做事」聽起來還很遠，但你真的不用一次跳到全自動。

我自己是從半自動開始的：先讓 AI 幫我把一件事做掉八成，剩下那兩成我自己手動收尾，做錯了也還來得及擋下來。

等我確定 AI 做得夠穩，再慢慢把收尾那一段也交出去。

我現在每天定時自動發出去的社群貼文、幫家裡處理雜事的小幫手，都是這樣一點一點從「半自動」長成「全自動」的。

沒有哪一個是一開始就放手不管的，全部都經過一段我盯著看的日子。

這篇文章的改版也是一個還在運作的半自動案例。我先決定要保留什麼，核准標題和修改方向，AI 才去讀原始檔、補內容、重建網站。最後我會自己看過文稿與正式頁面，確認事實、語氣和連結都沒有跑掉，再決定能不能上線。

我沒有把最後一步交出去，因為每篇文章的取捨都不同。「有沒有改得更好」不能只靠建置成功判斷。這就是它到現在仍然保留人工收尾的原因。

有一條界線不能跳過：你自己驗收不了的成果，就不要交給 AI。金流、法律、醫療與健康這類高風險任務，不適合拿來當新手的自動化練習，需要專業判斷的部分仍要交給合格的人。

當同一個任務每次都照固定步驟重跑，就可以接著把它整理成一條<a href="/newbie-pitfalls/what-is-ai-workflow.html">AI 工作流</a>。如果還找不到第一件值得交出去的事，先從<a href="/newbie-pitfalls/repetitive-work-automation-start.html">每天最常重做的工作</a>下手。

想看一個從半自動一路跑到定時執行的完整例子，可以接著看<a href="/newbie-pitfalls/ai-daily-thread-auto-poster.html">我怎麼做出每天自動發 Threads 的小機器人</a>。

不要等到「完全信任」才開始自動化。先讓 AI 做八成、你自己看著兩成，信任會在這個過程裡慢慢長出來。

### Summary

AI 不只會回答，也能幫你把事做完。先把「幫我用一下」改成有背景、完成條件與輸出格式的任務，回覆客戶、整理會議待辦、比較訂閱方案都能直接在對話框完成。需要讀寫本機檔案、跑指令或修改程式庫時，再換 Claude Code 或 Codex。跨服務搬資料則要選能取得相關權限的 Agent 或自動化工具。先讓 AI 做大部分，你保留驗收與收尾。自己驗收不了的成果，以及金流、法律、醫療與健康等高風險任務，不要交給 AI 自動處理。

### 名詞解釋

- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **無程式碼（no-code）**：不寫程式、用拖拉跟設定做出應用的工具或方法。AI 代理出現後，「會描述需求」比「會不會寫程式」更關鍵。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **Codex**：OpenAI 的程式型 AI 代理，跟 Claude Code 同類：能讀寫你的檔案、跑指令、動手把功能做出來。

### FAQ

**Q: ChatGPT 除了問問題還能做什麼？**

ChatGPT 可以直接完成回覆客戶、整理會議待辦、比較訂閱方案等任務。關鍵不是把問題問得更長，而是交代背景、完成條件、輸出格式，以及哪些資料不足時不能猜。

**Q: 怎麼讓 AI 幫我做事而不只是聊天？**

給 AI 兩樣東西。一是講清楚的任務，把你要的成品講具體，不要只說「幫我用一下」。二是能動手的地方，純文字產出的話對話框就夠用，要操作東西才需要接到能實際執行的工具裡。

**Q: 讓 AI 自動做事，安全嗎？**

看你交給 AI 什麼事。低風險、做錯能重來的事（整理資料、排程發文）很適合。金流、法律、健康這類高風險的事，不該在新手階段就交給自動化。建議從半自動開始，AI 做八成、你收尾兩成，信任夠了再放手。

**Q: 我不會寫程式，也能讓 AI 幫我做事嗎？**

可以。回信、摘要與比較表在一般對話框就能完成，不需要寫程式。需要讀寫本機檔案、跑指令或修改程式庫時，才需要 Claude Code 或 Codex。跨服務搬資料則要選能取得相關服務權限的 Agent 或自動化工具。

---

## AI 會取代我的工作嗎？一個非工程師的誠實想法

> Source: https://www.coolkidlab.com/newbie-pitfalls/will-ai-replace-my-job.html
> 「AI 會不會取代我」是這兩年最多人焦慮的問題。這篇不給罐頭安慰，用非工程師的視角，把問題換成你能行動的版本：與其問會不會被取代，不如問你能不能變成用 AI 的人。

短答給趕時間的人：與其問「AI 會不會取代我」，不如問「我能不能變成那個用 AI 的人」。過去兩年真正被影響的，很少是整個職業一夕消失，多半是「會用 AI 的人」，接走了「不會用的人」原本每天在做的事。這中間的差距跟聰不聰明沒什麼關係，多半只是誰先動手去試而已。

我是一個全職交易者，不是工程師。「AI 取代工作」這種新聞我也在看，看的時候心裡一樣會涼一下。

所以這篇我不打算給你「放心啦不會啦」這種罐頭安慰。那種話聽完的當下有用，隔天早上你不是還是一樣焦慮嗎？

我想做的是把這個問題拆開來看。「會不會被取代」是一個你越想越無力的問題。

但這個問題可以換掉。換成另一個你真的有得選的版本之後，整件事就沒那麼嚇人了。

### 「會不會被取代」為什麼是一個問了也沒用的問題？

這個問題最麻煩的地方，是答案永遠不在你手上。

技術怎麼走、公司怎麼決定、整個產業怎麼變，這些都是你控制不了的東西。你想再久也不會有結論。

所以你越想只會越焦慮，最後通常什麼都沒做，繼續每天上班、繼續擔心。想了三個月之後，你的處境有變好嗎？

我在市場待久了，學到一件事：把注意力一直放在自己控制不了的事情上，是我看過最快把一個人的心態拖垮的方法。

市場不會照我的意思走。但我今天要不要出手、看錯了認不認，這些都是我能決定的。

AI 這件事，其實也是一樣。

「會不會被取代」的答案不在你手上，問再多次都一樣。改成問「我要不要開始用」，你今天就可以給自己一個答案。

### 真正在發生的事，沒有新聞講的那麼戲劇化

看看身邊實際在發生的事，你會發現「整個職業一夕消失」其實很少。

更常見的是另一種變化，安靜到你當下不會察覺。

同樣一份工作，本來要花一整個下午才做得完，現在有人用 AI 半小時就交出來了，而且做出來的東西品質還不差。

久了，那些花一整個下午的人，就慢慢被花半小時的人比下去了。那你想當哪一個？

所以這件事真正的分界，落在會用 AI 的人跟還沒開始用的人之間。人跟機器誰比較強，反而不是這幾年的重點。

我自己就是現成的例子。

從 2026 年 4 月中開始，我把交易日誌的整理、社群貼文的排程、還有家裡長輩群組那些回不完的雜事，一件一件交給 AI 去處理。

我沒有因此變成更厲害的人。只是那些本來會吃掉我時間的事，現在不再吃掉我的時間了。

真正會被取代的，是那些不會用 AI、又不打算開始學的人。不會用只是你現在的狀態，不肯學才是自己選的，這兩件事差很遠。

### 該不該現在學？要從哪一件小事開始？

該。但「學 AI」不是叫你去考證照，也不是叫你讀完一本厚書，那兩種偏偏是最容易讓人在第三天就半途而廢的方式。

真正有用的開始，小到有點好笑。

挑一件你每天都在做、步驟固定、做錯也不會出大事的小事，交給 AI 試試看。

1. 步驟 1：先停止問「會不會被取代」。這題沒有對你有用的答案，再想下去只是耗掉你的力氣。
2. 步驟 2：挑一件每天都做、又很煩的小事（整理紀錄、回固定訊息、排版貼文都行），當你的第一個練習。
3. 步驟 3：今天就花 30 分鐘，把那件事描述給一個 AI 工具聽，讓 AI 幫你做做看。做得爛沒關係，重點是你從「擔心的人」變成「動手的人」。

你會發現，焦慮在你開始動手的那一刻就少了一大半。

問題當然還在，只是你從站在原地等，變成正在做一點什麼。這種感覺差很多。

能力就是這樣一點一點累積起來的，先動手的人才有機會慢慢變強。

### Summary

「AI 會不會取代我」這個問題的答案不在你手上，越想越無力。把問題換成「我要不要變成那個用 AI 的人」，答案立刻回到你身上。真正在發生的事，是「會用 AI 的人」接走了「不用的人」原本在做的工作，整個職業一夕消失反而少見。該不該現在學？該。但別去考證照、讀厚書，挑一件每天都做、做錯也不嚴重的小事，今天花 30 分鐘交給 AI 試試。焦慮在你動手那一刻就少一半。想看實際從哪件小事開始，往下接自動化起點那篇。

### FAQ

**Q: AI 真的會取代我的工作嗎？**

與其問會不會，不如看真正在發生的事：整個職業一夕消失很少，更常見的是「會用 AI 的人」用更短的時間做完同樣的事，慢慢比下「不用的人」。所以關鍵在你要不要成為那個用 AI 的人，這件事的決定權在你手上。

**Q: 我該現在開始學 AI 嗎？**

該，而且越早把焦慮換成行動越好。但「學」不是去考證照或讀完一本書，那最容易半途而廢。真正的起點是挑一件每天都做、步驟固定、做錯也不會出大事的小事，今天花 30 分鐘交給 AI 試做。先動手，能力會在過程中慢慢累積起來。

**Q: 我不是工程師，學 AI 來得及嗎？**

來得及。我自己就是非工程師、全職交易者，程式只有國中資訊課的程度。從 2026 年 4 月中開始，靠著「挑小事、邊做邊問」做出了好幾個自己每天在用的工具。你的背景只決定起點在哪，能走多遠還是看你有沒有開始。

**Q: 一直很焦慮 AI，但不知道做什麼，怎麼辦？**

焦慮多半來自「一直在想、卻從沒動手」。最快的解法是行動：今天就打開一個 AI 工具，挑一件你每天在做的煩雜小事讓 AI 幫你做。你會發現焦慮在動手那一刻就少一半，因為你從站著等，變成正在做一點什麼。

---

## 非工程背景、年紀也不小，還學得會用 AI 嗎？

> Source: https://www.coolkidlab.com/newbie-pitfalls/non-engineer-can-i-learn-ai.html
> 「我不是理工的，學得會嗎？」「年紀大了還來得及嗎？」非工程師常見的自我懷疑。這篇用全職交易者、程式只有國中程度的真實經驗告訴你：背景跟年紀沒你想的那麼關鍵。

短答給趕時間的人：學得會。我自己是全職交易者，不是工程師，程式只有國中資訊課的程度，而且早就忘光了，照樣從 2026 年 4 月中開始做出好幾個每天都在用的工具。背景決定你的起點，不決定你的終點。真正把人卡在原地的，通常是「我不是這塊料」這個念頭。

「我不是理工的，學得會嗎？」「都這個年紀了還來得及嗎？」這兩個問題我太熟了。

因為 2026 年 4 月中，它們也是壓在我心裡的兩塊石頭。

這篇不會跟你喊「相信自己一定可以」，那種話誰都會講，講完你還是一樣不知道自己到底行不行，隔天照樣不會動手。

我想用自己的底，老實跟你算一下：背景跟年紀到底會影響多少？

### 先亮我的底，你才知道這話有沒有資格講

我不是工程師，沒讀過資訊相關科系，全職在做的事情是交易。

我會的程式大概就是國中那堂資訊課教過的程度，畢業之後就沒再碰過，到現在早就忘得差不多，連變數是什麼都講不出來。

第一次打開 AI 工具想做點東西的時候，我連檔案要放進哪個資料夾都會卡住。

我講這些不是要賣慘。

接下來那句「非工程師也學得會」，是從一個真的非工程師嘴裡講出來的，不是某個本來就會寫程式的人回頭跟你說一句「很簡單啦」。

如果一個連資料夾都會放錯的交易者都做得出來，那這件事的門檻，大概沒有你想的那麼高。

### 不是工程師，為什麼沒你想的那麼要命？

關鍵在於，你現在做事情的方式已經跟三年前完全不一樣了。

以前要做出一個工具，你得自己會寫程式，不然就得花錢請人做。

現在換成你把想做的東西用中文講清楚，AI 負責寫出來、你負責測試跟修。

整個過程你打進去的字都是中文，不是一行一行的程式碼。

所以真正在考你的，從「會不會寫程式」變成了「會不會<a href="/newbie-pitfalls/how-to-prompt-ai.html">把一件事講清楚</a>」。

另一件是卡住的時候，你肯不肯回頭再多問一句，而不是默默把視窗關掉。

這兩件事都不是工程師的專利。

一個會把客訴講清楚的客服、一個會把需求說明白的老闆，反而常常比埋頭寫程式的人更吃得開。

把事情講清楚、出錯不放棄，這兩個是你本來就在用的能力。只是以前沒人告訴你，它們現在比會寫程式還值錢。

### 年紀大了，是不是真的學比較慢？

年紀的真實影響比你想的小，但也不是零。影響的地方跟多數人猜的不一樣。

真正被年紀影響的，是「願不願意忍受一開始的笨拙」，不是「學不學得會」。

年輕人比較不怕看起來笨，所以什麼都敢試一次。試壞了再說。

年紀上去之後，我們更怕「做不好被笑」，於是還沒開始就先勸退自己。

擋住你的其實是面子，不是腦袋。

1. 步驟 1：把「我不是這塊料」當成要檢查的假設，不是已經成立的結論。你只是還沒試，不是試過不行。
2. 步驟 2：允許自己當一天的笨蛋。第一次做什麼都會卡、都會醜，這跟年紀無關，是每個人的第一天都長這樣。
3. 步驟 3：挑一件小事今天就動手，不要等「準備好」。準備好這件事不會自己來，是你做著做著才慢慢有的。

我不是先變強才做得出東西，順序其實是反過來的：先硬著頭皮開始，邊做邊卡邊問，能力才一點一點長出來。

你拿自己的第一天去比別人的第一百天，當然會覺得自己不行。

但那不公平。你該比的是今天的你，跟那個還沒開始的你。

### Summary

非工程背景、年紀不小，照樣學得會用 AI。我自己是全職交易者、程式只有國中程度，從 2026 年 4 月中開始做出好幾個每天在用的工具。因為你現在做的不再是寫程式，而是把想法用中文講清楚給 AI，由 AI 寫、你來修，考的是表達跟不放棄。年紀擋住的其實是「怕做不好被笑」的面子，不是腦袋。把「我不是這塊料」當假設去檢查，允許自己當一天笨蛋，挑件小事今天就開始。想看一個非工程師實際做了什麼，往下接那幾篇實作紀錄。

### FAQ

**Q: 不是理工 / 資訊背景，學得會用 AI 嗎？**

學得會。現在做東西已經不用自己寫程式，你把想做的事用中文講清楚給 AI，由 AI 寫、你來測試跟修。真正考的是「會不會把事講清楚」「卡住肯不肯多問」，這些不是工程師的專利。我自己是全職交易者、非本科，照樣做得出每天在用的工具。

**Q: 年紀大了還學得來嗎？**

來得及。年紀影響的其實是「怕做不好被笑」的心理，不是腦袋。年輕人比較敢亂試，年紀上去後我們容易還沒開始就勸退自己。把這層面子放下、允許自己一開始笨拙，年紀就不再是障礙。學不學得會，跟幾歲關係不大。

**Q: 完全沒有基礎，第一步該做什麼？**

挑一件你每天都在做、步驟固定、做錯也不會出大事的小事，今天就花點時間描述給 AI，讓 AI 幫你做做看。別等「準備好」才開始。準備好不會自己來，是你動手之後才慢慢有的。第一次醜、卡關都正常，那是每個人的第一天。

**Q: 我會的程式趨近於零，這樣也行嗎？**

行。我會的程式也大概只有國中資訊課的程度，還忘光了。重點是把寫程式這件事交給 AI，你負責講清楚要什麼、跑跑看、指出哪裡不對。能力是在一次次動手裡長出來的，不是先學完才開始。

---

## AI Workflow 是什麼？5 步驟＋3 個實作案例

> Source: https://www.coolkidlab.com/newbie-pitfalls/what-is-ai-workflow.html
> AI Workflow 是把觸發、資料、AI 處理、輸出與人工檢查串成固定流程。用 Threads 發文、IG 新聞與 LINE 行程提醒 3 個親手做過的案例，帶你判斷什麼值得自動化。

短答給趕時間的人：AI Workflow（AI 工作流）會先把一件重複工作的 5 個位置排好，包括什麼時候開始、資料從哪來、AI 做什麼、結果送去哪，以及誰負責檢查。流程可以全自動，也可以保留人工確認。下次遇到同一件事，就不用重新想、重新貼、重新走一遍。

「AI Workflow」這個詞現在到處都是。

我剛開始也以為，AI Workflow 只是把 ChatGPT 多問幾次，再把步驟寫成清單。

後來真的做了自動發文、新聞整理與 LINE 行程提醒，我才發現，真正的差別在整件事有沒有固定路線。

這篇先不列軟體名單。我會把一條 AI Workflow 拆成 5 個步驟，再拿 3 個已經跑過的案例來對照。

看完你會知道什麼算 Workflow、Workflow 跟 AI Agent（會自己判斷下一步的 AI 助理）差在哪，也能判斷手上的工作值不值得自動化。

先把名詞講清楚，再決定要不要動手。

### AI Workflow 是什麼？先看完整流程的 5 個步驟

一條 AI Workflow 通常可以拆成 5 個步驟。工具可以換，這 5 個位置不太會變。

先把這 5 個步驟排開來看，比背平台名稱容易。

前 4 步決定流程能不能跑，第 5 步決定流程出錯時你會不會知道。

我早期只顧著讓機器人把事情做完，沒有把成功與失敗記清楚。結果有一次中間斷掉，表面沒報錯，我到對帳才發現少了 3 篇。

所以現在我不再把「AI 有產出」當完成。輸出有沒有真的送達、失敗會不會通知，都是 Workflow 本身的一部分。

一開始不用追求全自動。高風險或容易出錯的步驟，先保留人工確認，流程會比較穩。

一條能用的 AI Workflow，會先畫好固定路線，也會清楚標出哪一步交給 AI、哪一步由人確認。

### 直接用 AI，和做成 Workflow 差在哪？

大部分人用 AI 的方式是：打開對話框、貼資料、下指令、複製答案，再貼到另一個地方。

這樣沒有錯，但下次遇到同一件事，你還是得全部重來。AI 幫你省了思考時間，操作仍要自己從頭走一遍。

做成 Workflow 後，資料從哪來、AI 要做什麼、結果去哪裡，以及失敗時怎麼處理，都會留在同一條流程裡。

你可以按一個按鈕啟動，也可以設成每天自動執行。半自動和全自動都算，差別只在誰按下開始。

每次都要重新決定步驟、重新複製貼上，屬於單次使用 AI。把步驟固定下來，下次可以照同一套再跑，才開始像 Workflow。

每天或每週會重複、步驟固定，而且做錯還來得及補救的工作，最適合拿來做第一條 Workflow。

如果你還不確定怎麼把一句問題改成可以檢查的任務，可以先看<a href="/newbie-pitfalls/chatgpt-from-asking-to-doing.html">回信、會議待辦與方案比較的 3 個交辦範例</a>，把單次交辦講清楚，再來固定流程。

如果你還不知道該挑哪一件，可以先看<a href="/newbie-pitfalls/repetitive-work-automation-start.html">我怎麼從重複工作裡找第一個自動化題目</a>。

先找到重複路線，再談工具。順序反過來，很容易裝了一堆東西卻不知道要自動化什麼。

判斷方式很簡單：下次同一件事來了，你是重新做一次，還是讓留下來的固定流程再跑一次？

### 3 個我親手做過的 AI Workflow，實際怎麼跑？

下面 3 個都是我目前真的跑過、壞過，也修過的流程。

把 3 個案例放進同一張表，就能看出使用的工具不同，步驟安排仍然相同。

Threads 流程的完整過程在<a href="/newbie-pitfalls/ai-daily-thread-auto-poster.html">Claude Code 自動發 Threads 實戰</a>。如果想看可以照著做的版本，再接著看<a href="/workflows/threads-auto-poster.html">Threads 自動發文 Workflow</a>。

IG 新聞流程拆在<a href="/newbie-pitfalls/ai-ig-news-auto-poster.html">讀新聞、生圖再發 IG 的實作紀錄</a>。LINE 行程提醒則寫在<a href="/newbie-pitfalls/ai-built-family-line-bot.html">全家共用的 LINE 行程管家</a>。

我沒有一開始就把整套流程交出去。每一條都是先手動跑，確定輸入與輸出正確，再逐段減少人工操作。

所以我不建議新手一開始就追求「全自動」。能穩定重跑的半自動流程，比偶爾成功、失敗又不通知的全自動流程有用。

### AI Workflow 跟 AI Agent 差在哪？

Workflow 的下一步由人先排好。AI Agent 會依照任務當下的情況，自己判斷下一步。

Workflow 會照人事先設定的條件往下跑。Agent 接到目標後，會自己找資料、選工具，遇到變化再決定接下來怎麼做。

兩者可以一起用。一條 Workflow 可以在其中某一步叫 AI Agent 做事，一個 AI Agent 也可以照著固定 Workflow 反覆執行。

如果這兩個名詞還會混在一起，可以接著看<a href="/newbie-pitfalls/what-is-ai-agent.html">AI Agent、ChatGPT 與 Workflow 的完整差異</a>。

### 新手怎麼做第一條 AI Workflow？從半自動開始

不用先裝一堆平台。拿一件你已經熟悉的重複工作，照下面 5 步跑一次就好。

1. 選一件每週至少做一次、步驟大致固定、做錯還能補救的工作。先避開金流、法律、健康與重要帳號權限。
2. 自己手動跑一次，把每個動作照順序寫下來。你現在如果還講不清楚，就先不要自動化。
3. 標出觸發、資料、AI 處理、輸出與檢查這 5 個位置，確認每個位置都有答案。
4. 先只自動化中間最固定的一段，起點與最後檢查先留給自己。連續跑對幾次，再往前後延伸。
5. 替流程加紀錄與失敗通知。沒有紀錄的自動化，壞掉時只會安靜消失。

跑完這 5 步，即使還沒有全自動系統，你也會有一條可以重複、可以檢查，而且知道壞在哪裡的流程。

先確認每次都能跑對，再慢慢減少人工操作。流程出錯時找得到原因，接著才增加自動化。

### Summary

AI Workflow 是把觸發、取得資料、AI 處理、輸出動作與檢查這 5 個位置排成固定流程。它可以半自動，也可以全自動。關鍵不是完全沒有人，而是同一件事下次不用重新想、重新貼、重新走一遍。我親手跑過 Threads 自動發文、IG 新聞發文與 LINE 行程提醒，三條工具不同，骨架都是同一套。Workflow 是固定路線，AI Agent 是能自己判斷下一步的執行者，兩者可以一起用。新手先挑低風險的重複工作，手動跑熟，只自動化最固定的一段，最後補上紀錄與失敗通知。

### 名詞解釋

- **AI 工作流（AI workflow）**：把一件事的多個步驟串成「AI 自動跑完」的流程，例如「抓新聞 → 寫摘要 → 排版 → 發文」全自動，人只看結果跟把關。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **LINE 機器人**：在 LINE 裡自動回覆、主動推播訊息的機器人。台灣家庭幾乎人人用 LINE，是自動化通知的最佳入口。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。

### FAQ

**Q: AI workflow 到底是什麼意思？**

AI Workflow（AI 工作流）是把一件重複工作的固定路線留下來：什麼時候開始、資料從哪來、AI 做什麼、結果送去哪，以及誰負責檢查。它可以由人按下開始，也可以排程自動跑。重點是下次不必重新決定與操作每一個步驟。

**Q: AI workflow 跟直接用 ChatGPT 差在哪？**

直接用 ChatGPT 時，你通常要自己貼資料、下指令、複製答案，再把結果送到下一個地方。AI Workflow 會把這條路固定下來，下次可以照同一套重跑。它不一定全自動，也可以保留人工開始與確認。

**Q: AI Workflow 跟 AI Agent 差在哪？**

Workflow 是人先排好的固定路線，AI Agent 是能根據目標與現況自己判斷下一步的執行者。兩者可以一起用：Workflow 中間某一步可以交給 Agent，一個 Agent 也能反覆執行固定 Workflow。

**Q: 做 AI workflow 是不是要很懂程式？**

不用。先把自己已經會做的工作照順序寫下來，再用工具接起其中最固定的一段。開始與檢查可以先由自己處理，連續跑對幾次再增加自動化。我自己的自動發文與家庭行程提醒也是這樣逐段長出來的。

**Q: 什麼樣的事適合做成 AI workflow？**

每天或每週會重複、步驟固定、輸入資料找得到，而且做錯還能補救的工作最適合。一次性的事不值得設定。金流、法律、健康與重要帳號權限等高風險流程，也不適合拿來當新手第一條 Workflow。

---

## AI 給的答案不滿意？Prompt 3 要素＋案例拆解

> Source: https://www.coolkidlab.com/newbie-pitfalls/how-to-prompt-ai.html
> AI Prompt 怎麼寫？用「這封也回一下」這個真實場景，拆解同一段對話為何一句話就夠、換到新對話要補哪些資料、邊界與驗收條件。

AI Prompt 怎麼寫？先寫清楚 3 組資訊：任務與成品、背景與資料、邊界與驗收。Prompt 不必很長；如果同一個對話已經有背景，一句「這封也回一下」也能工作。真正的判準不是字數，而是 AI 還需要猜多少，以及你能不能檢查成品。

Prompt 就是你交給 AI 的文字、圖片、檔案或指令。這個詞聽起來像技術，其實平常打進對話框的內容都算。

我用 AI 幫忙回工作信件。前一封剛處理完，我只打了「這封也回一下」，AI 就知道該用什麼語氣、哪些事能答應、哪些要先問主管，連信件格式都照上一封。不是這句話很神，是同一段對話前面已經把規則講完了。

換到一個全新的對話，這句話就只剩一堆空白要猜。這篇不給萬用咒語，直接用同一個回信的例子拆解給你看：哪些資訊不能少，什麼時候一句話就夠。

### Prompt 不是越長越好，重點是少讓 AI 猜

最常見的狀況是這樣：你在新對話裡只說「幫我回這封信」，AI 只知道你要回信，不知道對方是誰、你們之前談到哪，也不知道你要一句話帶過還是一封正式回覆。

所以 AI 只能先給一份多人都用得上的通用清單。內容可能沒有錯，但你看完還是不知道該先做哪一件。

這種答案對你沒有用，不代表模型一定不夠聰明，也不代表你要把 Prompt 寫成一篇作文。

先找出 AI 還缺哪一塊：你的現況、要交付的成品、能用的資料，還是不能碰的邊界。缺什麼補什麼，比一直加形容詞有效。

我剛開始也常把空泛答案歸因成工具不夠強，換模型之後才發現，同一個問題只要補上手上的資料與驗收方式，結果就會差很多。

但 Prompt 不是所有問題的答案。如果資料本身沒有提供、工具沒有權限，或任務超出模型能力，寫得再漂亮也補不出不存在的證據。

所以先判斷是「AI 不知道你要什麼」，還是「AI 根本拿不到完成任務需要的東西」。前者能靠 Prompt 改善，後者要補資料、權限或換工具。

判斷 Prompt 好不好，不看字數。看 AI 還要猜幾件事，以及做完後你能不能明確判斷成品有沒有過關。

### 一個可執行的 Prompt，先補齊 3 組資訊

我把現在交辦工作時反覆會用到的內容拆開，最後留下 3 組。

不用背縮寫，照順序問自己下面三件事就好：

1. 第 1 組，任務與成品：要 AI 做什麼，最後要交什麼？例如「幫我回覆這封客戶來信，寫一封可以直接寄出的正式回覆」。動詞跟成品一起講，才不會只拿到建議。
2. 第 2 組，背景與資料：現在是什麼狀況，判斷要看哪些資料？像是「對方是合作兩年的老客戶，這次問的是交期能不能提前，附上原信和上次的報價單」。沒有一手資料時，也要說能用哪些來源。
3. 第 3 組，邊界與驗收：什麼不能碰，怎樣才算完成？舉例來說，「價格不能自己報，超過我權限的請對方聯繫主管。語氣專業但不要冷，寫完先給我看，不要直接寄」。

如果要從零開始，可以先照這個骨架填：我要完成［任務］；成品要是［格式］；請使用［資料］；不要碰［邊界］；完成前請檢查［驗收條件］。不知道哪格要寫時，再請 AI 先列出缺少的資訊。

三組資訊不是固定表格。小問題可能只需要任務，會改檔案、發佈或碰真實資料的工作，才需要把邊界與驗收講完整。

這個做法也對得上兩份官方文件。<a href="https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices" rel="noopener">Anthropic 官方提示詞寫法</a>強調清楚、明確的指令，以及補上背景、格式與限制；<a href="https://developers.openai.com/api/docs/guides/prompt-engineering" rel="noopener">OpenAI 官方提示詞指南</a>也把要求、範例、相關背景與測試列進穩定產出的做法。

我自己的版本多加了一個「驗收」，因為我現在不是只拿 AI 來聊天。信寄出去收不回來，數字報錯客戶會追問，完成不能只靠 AI 自己說了算。

如果你還不知道驗收條件，可以先要求 AI 把任務重述一遍，列出準備怎麼做、缺哪些資料、最後會交什麼。你看過再讓 AI 動手。

### 同一個回信任務：一句話什麼時候夠？

這次的原句是「這封也回一下」。放在已經合作一段時間的對話裡，這句其實夠用。

前面的紀錄已經交代客戶關係、回信語氣、能答應的範圍和格式。短句只是接上一封，不是從零開始。

但把同一句丟進新對話，AI 可能語氣太隨便、答應你其實不能答應的事，或格式完全不對。不是 AI 故意亂做，而是新對話裡沒有你之前交代過的規則。

我如果要在新對話交辦，會先講：「這是一封老客戶問交期的信。我們合作兩年關係不錯，但這次可能來不及。語氣專業溫和，不能直接說做不到，要建議替代方案。附上原信和報價單。」

接著加上：「報價跟交期的數字不要自己編，超出我權限的請對方找我主管。寫完先給我過目，確認沒問題再寄。」

這段沒有套任何神奇公式，只是把 AI 原本要猜的事情填完。

如果第一次結果仍不對，我不會整段重寫。我會指出哪一塊不合格，比方說「語氣對了但你自己編了一個交期，我沒給你這個數字」，再沿用其他已經正確的部分。

這也會讓下一步更清楚：如果你已經能把成品與邊界說明白，可以接著看<a href="/newbie-pitfalls/chatgpt-from-asking-to-doing.html">哪些任務能直接交給 AI 做</a>；如果成品需要第二層把關，再看<a href="/newbie-pitfalls/ai-review-pipeline.html">我怎麼讓另一個 AI 做審查</a>。

最短的補救句不是「請更專業」，而是指出哪個成品沒過關、給一個正確例子，再說其他部分保留。

### Summary

AI Prompt 不必越寫越長。要讓 AI 少猜，先補齊 3 組資訊：任務與成品、背景與資料、邊界與驗收。同一段對話已有背景時，一句「這封也回一下」也能工作；換到新對話，就要把對方是誰、能答應什麼、語氣和格式補回去。AI 答不好時，先分辨是需求不清楚，還是缺資料、權限或工具。前者補 Prompt，後者要補條件。

### 名詞解釋

- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。

### FAQ

**Q: prompt 是什麼意思？**

Prompt 是你交給 AI 的輸入，可以是文字、圖片、檔案或指令。一般聊天時，就是你打進對話框的內容；長任務裡，前面的對話、附上的資料與專案規則也會一起形成它能用的背景。

**Q: 為什麼 AI 給我的答案都很空泛？**

常見原因是 AI 不知道你的現況、要交付什麼，或怎樣才算完成。但也可能是缺資料、缺權限，或工具根本做不到。先分辨是哪一種，再決定要補 Prompt、補資料，還是換工具。

**Q: 一個好問題該包含什麼？**

一個能執行的 Prompt 可以先檢查 3 組資訊：任務與成品、背景與資料、邊界與驗收。小問題不用全部寫滿，會改檔案、發佈或碰真實資料的工作，才需要把邊界與驗收講完整。

**Q: 怎麼讓 AI 給我「針對我」的答案，而不是通用答案？**

可以先叫 AI 重述任務，列出它理解的目標、會用的資料、不能碰的範圍與完成條件。你確認缺口後再讓它動手，比一直要求「更詳細、更專業」更容易修正方向。

---

## Claude Code 是什麼？非工程師能做出什麼

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-what-is.html
> Claude Code 是 Anthropic 出的 AI 命令列工具，會自己讀寫檔案、執行指令、把任務做完。非工程師看版，白話定義加 3 個真實案例：交易日誌、機器人、這整個網站。

短答給趕時間的人：Claude Code 是 Anthropic 出的 AI 命令列工具。跟你打開 Claude.ai 對話最大的差別是，Claude Code 會自己讀寫你電腦的檔案、執行指令、串接 API，把一整套任務做完，不是只給建議。需要 Anthropic Pro 訂閱（US$20/月）。Claude Code 跟 Cursor 編輯器，其實是同一種東西，都叫做「AI Agent」，只是用起來不一樣。至於 ChatGPT，那是另一個層級的工具。

「Claude Code」這個詞，我第一次聽到就會錯意了。以為就是「Claude 加上能寫程式」，就這樣而已。

到底跟我已經在用的 Claude.ai 對話，差在哪？當時完全搞不清楚。

後來自己裝起來用了之後才懂。那跟對話介面，是兩種完全不同的使用體驗。

我繞了一圈才搞懂的東西，這篇就用大白話講一次：Claude Code 到底是什麼？

還有跟 Claude 對話、Cursor、ChatGPT 怎麼分，以及一個完全不會寫程式的人，能拿 Claude Code 做出什麼。

### Claude Code 是什麼？一句話講完

Claude Code，是 Anthropic 在 2025 年正式推出的 AI 命令列工具。Anthropic，就是出 Claude 的那家公司。

你裝在自己電腦上，在終端機打 claude，就會進入一個對話介面。

終端機在 Windows 上，是 PowerShell。在 Mac 上，則是 Terminal。

你說一句想做什麼，Claude Code 就自己去做：讀你電腦上的檔案、寫程式碼、執行指令、串接外部 API。整套任務做完，才回來找你。

重點在那句「會自己動手」。

你跟 ChatGPT 對話，得到的是一段字。複製貼上、修改、存檔，都要你自己來。

Claude Code 不一樣。你說「幫我把這個資料夾下所有 .txt 檔合併成一個」，它真的會去動手做。

做完還會回你一句「好了，我合併成 merged.txt 放在桌面」。

對話 AI 是「給建議」，Claude Code 是「動手做」。差別在權限，Claude Code 碰得到你電腦裡的檔案，跟誰比較聰明沒有關係。

### Claude Code 跟「對話 AI」差在哪？

最容易搞混的，是 Claude Code 跟你平常在用的對話 AI（Claude.ai、ChatGPT 這類）到底差在哪。

差別不在誰比較聰明，是互動方式整個不一樣。

對話 AI 是問答形式，你打字問，得到一段字，結果還是要自己複製貼上、自己動手做。

Claude Code 屬於另一種，叫 AI Agent：你說想做什麼，直接讀寫檔案、執行指令，把事情做完。

Cursor 也是 AI Agent 這一類，只是長在編輯器裡，Claude Code 長在終端機。

選工具先問自己「我要這個工具幫我做什麼」。聊天用對話 AI，要動手做事用 AI Agent。Claude Code、Codex、Cursor、ChatGPT 的實際分工，看 <a href="/newbie-pitfalls/ai-coding-tools-compare.html">AI 寫程式工具怎麼選？非工程師 3 個月實際分工</a>。

### 3 個真實案例：非工程師用 Claude Code 能做什麼？

我是非工程師，完全不會寫程式。

但從 2026 年 4 月中開始，我用 Claude Code 做出 10 個自動化流程，還有這整個網站。

下面三個真實案例，給你看非工程師能做到什麼範圍：

1. 案例 1，給自己用的工具：交易日誌 PWA。我每天收盤要記交易，以前用 Excel 20 分鐘，後來叫 Claude Code「幫我做一個能在手機上開、有情緒和盈虧分析的交易日誌」，從零到上線半天搞定。不會寫程式但能講清楚「我要什麼」，Claude Code 就做得出來。
2. 案例 2，自動化：每天 8 點自動發 Threads 的機器人。我設好一次之後，機器人每天自己整理、自己發，我只看結果。從寫 Python 腳本到部署 GitHub Actions 我完全不懂，但跟 Claude Code 講「我要每天 8 點抓 GitHub trending 用我口吻寫繁中介紹發 Threads」，Claude Code 就把整套架起來。
3. 案例 3，整個網站：你正在看的這個 Lab。從第一行 HTML 到部署 Vercel 到 SEO 全部優化，都是我跟 Claude Code 一句一句講出來的。我會的是「想清楚我要什麼網站」加上「看到結果不滿意說哪裡要改」，程式碼全部是 Claude Code 寫的。

範圍大概是：你能講清楚的事，Claude Code 都能動手做給你。

真正卡住的地方，多半是你自己還沒想清楚要什麼。工具能不能做到，反而很少是問題。

所以這個工具，對非工程師反而有優勢。我們不被既有的寫法綁住，可以直接用使用情境，描述自己要的東西。

### Summary

Claude Code 是 Anthropic 出的 AI 命令列工具，你裝在電腦上，在終端機跟它說想做什麼，Claude Code 會自己讀寫檔案、執行指令、把整套任務做完。跟 Claude.ai 對話最大的差別是「會自己動手」，不是只給建議，屬於 AI Agent 這類工具，跟 Cursor 編輯器是同類但定位不同（命令列 vs 編輯器框架），跟 ChatGPT 是不同層級的東西（動手 vs 聊天）。非工程師也能用。我自己從 2026 年 4 月中開始做了 10 個自動化流程，加上這整個網站。工具的能力很少是關鍵，真正難的地方，多半在你想不想得清楚「我要什麼」。想實際裝起來跑，接下來 Windows 安裝那篇有完整指令。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **Cursor**：內建 AI 的程式編輯器，跟 Claude Code 同類，但走「圖形介面編輯器」路線而非終端機路線。
- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **PowerShell**：Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。

### FAQ

**Q: Claude Code 是什麼？**

Claude Code 是 Anthropic（出 Claude 的那家公司）2025 年推出的 AI 命令列工具，你裝在自己電腦上，在終端機（Windows 是 PowerShell、Mac 是 Terminal）打 claude 進入對話介面，你跟它說想做什麼，Claude Code 會自己讀寫檔案、執行指令、串接 API，完成整套任務。跟 Claude.ai 對話最大的差別是「會自己動手」。

**Q: Claude Code 跟 Claude.ai 對話差在哪？**

Claude.ai 對話是你打字、它回字，結果還是你自己複製貼上動手。Claude Code 是命令列工具，會直接讀寫你電腦的檔案、執行指令、把任務做完。關鍵在權限，Claude Code 碰得到你電腦裡的檔案，跟誰比較聰明沒有關係。想聊天用前者，想做事用後者。

**Q: Claude Code 跟 Cursor 差在哪？**

兩個都是 AI Agent 類工具（會自己動手做事的 AI），但定位不同。Cursor 是「AI 內建在編輯器裡」，主打打字時即時補完加上編輯器內對話，適合已經會寫程式的人。Claude Code 是「AI 直接住在終端機」，沒有編輯器框架，主打跑整套任務（做網站 / 寫機器人 / 跑自動化），非工程師反而比 Cursor 容易上手。

**Q: Claude Code 多少錢？**

需要 Anthropic Pro 訂閱，US$20/月。沒有完全免費版可以用。對比起來，如果你拿它做一個機器人、做一個網站，等於每月省下幾十小時手動操作的時間，對「想用 AI 做事」的非工程師回本很快。

**Q: 非工程師可以用 Claude Code 嗎？**

可以，反而比工程師更有優勢。工程師會被「我習慣這樣寫」綁住，非工程師沒這包袱，直接用「我想要這樣的工具」描述需求，Claude Code 反而做得更好。我自己從 2026 年 4 月中開始做了 10 個自動化流程，加上這整個 Lab 網站，完全不會寫程式。

---

## AI Agent 是什麼？跟 ChatGPT/workflow 差在哪

> Source: https://www.coolkidlab.com/newbie-pitfalls/what-is-ai-agent.html
> AI Agent 是什麼？會自己動手做事的 AI — 讀寫檔案、執行指令、串 API，跟只給建議的 ChatGPT 不同。非工程師大白話講差別、跟 workflow 差在哪，還有能幫你做什麼。

短答給趕時間的人：AI Agent 是「會自己動手做事的 AI」，例如 Claude Code、Cursor 這類能讀寫你電腦檔案、執行指令、串 API 的 AI。跟 ChatGPT 只能對話不同，AI Agent 可以實際幫你寫程式、跑腳本、把整套任務做完。Agent 是執行者，workflow 是你給 Agent 的 SOP，兩個合起來等於「不用你動手的自動化分身」。

「AI Agent」這個詞從 2024 年底開始紅，2025 年變主流關鍵字。

但我去看大部分文章，要嘛太技術（講 LangChain、ReAct framework 那些），要嘛太雞湯（「AI Agent 將顛覆一切」）。

中間那一層，「這到底是什麼東西」，反而沒人講清楚。

這篇用我自己做出 10 個 workflow 的非工程師視角來講。

AI Agent 是什麼、跟 ChatGPT 怎麼分、跟 workflow 是什麼關係，還有能幫一個不會寫程式的人做什麼。

### AI Agent 是什麼？一句話講完

AI Agent 到底是什麼？就是「會自己動手做事的 AI」。

ChatGPT、Claude.ai 這類對話 AI 只能回字給你。你要自己把字複製出來，自己改，自己存檔。

AI Agent 不一樣。

AI Agent 有權限碰你的電腦或某個系統。可以直接讀寫檔案、執行指令、發 API 請求，把整套任務做完。

最直白的比喻是這樣。對話 AI 像個只能說話的顧問，跟你討論完，還是你自己回家動手。

AI Agent 像個會做事的助理。你跟他說「幫我把這份報表整理一下、發給張經理」，他真的去做。

目前非工程師最容易接觸的 AI Agent，是 Claude Code 跟 Cursor。

兩個都是 AI Agent 工具，差別在使用介面。Claude Code 是命令列，Cursor 是編輯器。

背後做的事是一樣的。讓 AI 真的動手做事，而不是只回字。

對話 AI =「給建議」，AI Agent =「動手做」。差別不是聰明程度，是有沒有權限執行真實動作。

### ChatGPT 是 AI Agent 嗎？跟 workflow 又差在哪？

這 3 個詞最容易混，到底差在哪？

下面用一張對照表講清楚：

順序是這樣：對話 AI 是基礎能力，大腦會想。AI Agent 是把這個大腦接上手腳，能動作。workflow 是你寫好的 SOP，決定要動什麼。

一個 AI Agent 可以跑很多不同 workflow，一個 workflow 也可以拆給多個 AI Agent 接力。

AI Agent 是執行者，workflow 是劇本，對話 AI 是大腦。3 個合起來才是完整自動化。

### AI Agent 能做什麼？非工程師的 3 個實際案例

「會自己動手」這件事對非工程師有什麼用？

以前你想自動化一件事，要嘛找付費 SaaS（每月燒錢），要嘛雇人寫程式（一次幾萬）。

AI Agent 出現後，你跟 AI 講需求，整套自動化就做好了。成本只剩 Claude Pro US$20/月。

1. 案例 1，內容自動化。我用 Claude Code 這個 AI Agent 做了「每天 8 點自動發 Threads 的機器人」。整套包含抓 GitHub trending、用我的口吻寫繁中介紹、串 Threads API 發文、處理 token 失效自動續期。我設好一次，跑了兩個多月沒碰過。
2. 案例 2，家庭工具。LINE 機器人幫全家管行程。家人在 LINE 一句話「明天 3 點 媽媽 醫院回診」，Claude Code 寫的解析程式自動讀懂、存進資料庫、到點自動推提醒。我家現在每天用，完全不用碰程式。
3. 案例 3，內容創作。我用 Claude Code 做了你正在看的這個 Lab(網站 + 產生 136 篇文章頁面的系統 + SEO 自動化)。從第一行 HTML 到部署 Vercel 到 GEO audit 81/100，完全沒寫一行程式碼，都是跟 AI Agent 一句一句講出來的。

範圍是：你能講清楚的事，AI Agent 都能動手做。

難的不是技術。是「想清楚要它做什麼」。

所以這波 AI Agent 趨勢對非工程師反而是好消息。我們的優勢就是會想需求，不被既有寫法綁住。

### Summary

AI Agent 是「會自己動手做事的 AI」，例如 Claude Code、Cursor 這類能讀寫檔案、執行指令、串 API 的 AI。跟 ChatGPT 這種對話 AI 最大的差別是「能執行動作」，不只是給建議。3 個概念釐清：對話 AI 會想，AI Agent 能動，workflow 是 SOP。順序是大腦、手腳、劇本，3 個合起來才是完整自動化。非工程師也能用，我自己用 Claude Code 這個 AI Agent 做了 10 個 workflow 加整個網站，完全沒寫程式。難的不是技術，是想清楚要它做什麼。想看 AI Agent 實際做出來的東西，接下來 Threads 自動發文那篇有整套公開。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **Cursor**：內建 AI 的程式編輯器，跟 Claude Code 同類，但走「圖形介面編輯器」路線而非終端機路線。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。

### FAQ

**Q: AI Agent 是什麼？**

AI Agent 是「會自己動手做事的 AI」，例如 Claude Code、Cursor 這類能讀寫檔案、執行指令、串 API 的 AI 助手。跟 ChatGPT 只能對話不同，AI Agent 可以實際幫你寫程式、跑腳本、發 API 請求，把一整串任務做完，而不是只給建議。對非工程師來說，等於請了一個 24 小時待命的工程師。

**Q: AI Agent 跟平常在用的 AI 聊天工具是同一種東西嗎？**

不是同一種。差別在「動手」。聊天工具（像 ChatGPT）只能回字給你，你要自己複製貼上、自己改、自己存檔，結果動手的還是你。AI Agent 有權限碰你的電腦或某個系統，可以直接讀寫檔案、執行指令、把任務做完。一句話：一個是會說話的顧問，一個是會做事的助理。想知道自己該從哪一類開始，可以看 <a href="/newbie-pitfalls/ai-agent-vs-chatgpt.html">AI Agent vs ChatGPT：差在哪、該從哪一類開始</a>。

**Q: AI Agent 跟 AI workflow 差在哪？**

AI Agent 是執行者(會動手的 AI)，workflow 是劇本(你寫好的步驟組合)。AI Agent 是 Claude Code 或 Cursor 這類工具，workflow 是「每天 8 點抓資料、用 AI 寫稿、發 IG」這種 SOP。一個 AI Agent 可以跑很多不同 workflow，一個 workflow 也可以拆給多個 AI Agent 接力。

**Q: 非工程師可以用 AI Agent 嗎？**

可以，而且對非工程師反而有優勢。工程師會被「我習慣這樣寫」綁住，非工程師沒這包袱，直接用「我想要這樣的東西」描述需求。我自己是非工程師，從 2026 年 4 月中開始用 Claude Code 這個 AI Agent 做了 10 個 workflow 加整個 Lab 網站，完全沒寫程式。難的不是技術，是想清楚要它做什麼。

**Q: 有哪些 AI Agent 適合新手？**

目前對非工程師最友善的兩個是 Claude Code 跟 Cursor，兩個都是 AI Agent 工具。Claude Code 是命令列介面，適合做整套任務(網站、機器人、自動化)。Cursor 是編輯器內 AI，適合已經會寫程式的人。新手我推薦 Claude Code，因為不需要懂編輯器介面，直接用對話描述需求即可。Anthropic Pro US$20/月。

---

## AI Agent 跟 ChatGPT 差在哪？一般人該怎麼選

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-agent-vs-chatgpt.html
> AI Agent 是做事方式，ChatGPT 是產品。用 3 個問題判斷該留在一般 Chat、改用多步任務的 Work，還是把程式工作交給 Codex。

短答給趕時間的人：AI Agent 是一種「會規劃、使用工具並執行多步任務」的做事方式，ChatGPT 是一個產品。現在 ChatGPT 裡的一般 Chat 適合快速問答，Work 適合研究、處理檔案與產出完整成果，程式工作另有 Codex。真正要問的是：這次只要答案，還是要 AI 讀檔案、改資料或跑完整流程？後者才需要 Agent 式工作，而且只給完成任務需要的權限。

我自己這條路是走過的。先當了很長一段時間的純 ChatGPT 用戶，覺得「AI 真好用，但每次都要自己貼來貼去」。

2026 年 4 月中第一次用 Claude Code。才發現原來 AI 可以不用我手動，自己跑整套。

兩類到今天並用三個多月。

我原本也把它們分成兩類，直到 ChatGPT 把入口拆成 Chat、Work 與 Codex。現在更準確的分法是「快速對話」與「Agent 式工作」，不是把 ChatGPT 整個產品放到 Agent 的對面。

這篇先把名詞拆正，再用 3 個問題判斷這次任務該停在對話，還是交給 Agent。想看 Claude Code 跟 ChatGPT 在我一天裡怎麼分工，再接著看<a href="/newbie-pitfalls/claude-code-vs-chatgpt.html">工具實戰那篇</a>。

### 先拆開兩個名詞：ChatGPT 是產品，AI Agent 是做事方式

2026 年再問「AI Agent vs ChatGPT」，最容易踩的坑是拿一種做事方式去對比一個產品。ChatGPT 的一般 Chat 適合快速問答；Work 適合研究、分析資料與製作文件、試算表或報告；Codex 則專門處理程式與程式庫。<a href="https://help.openai.com/en/articles/20001275-chatgpt-work-and-codex" rel="noopener noreferrer">OpenAI 最新的 ChatGPT Work 與 Codex 說明</a>列出的就是這三種分工。

所以我不再用「ChatGPT 是顧問，Agent 是助理」當完整定義。這句話只適合描述一般 Chat 與 Work、Codex 這類 Agent 式工作的差別。

比較準確的說法是：一般對話把答案交給你，Agent 會在你允許的工具與權限內繼續做動作。兩種入口可能就在同一個產品裡。

別先比品牌。先看你這次要的是答案，還是完成後可驗收的結果。需要登入、讀檔、修改資料或跨多個步驟時，再考慮 Agent。

### 這次任務要聊天還是開 Agent？問 3 個問題

不用背表格。我自己是問三個問題，答案會自己浮出來：

1. 問題 1，完成後是不是還要有人替你操作？如果答案拿回來後，你仍得登入網站、搬資料或改檔案，Agent 才可能省下後半段工作。只要解釋、腦力激盪或初稿，一般對話通常更快。
2. 問題 2，任務是否跨好幾個步驟或工具？例如先查資料、再整理表格、最後更新系統，適合 Agent。只問一個事實或改一句文案，開 Agent 反而增加等待與確認。
3. 問題 3，你願意開多少權限？Agent 能做事，是因為你讓它碰網站、檔案或連接的服務。任務涉及郵件、帳號與私人資料時，只開需要的工具，敏感輸入自己接手，做完再檢查權限。

前兩題都是「要」，而且第三題的權限範圍你能接受，才值得開 Agent。

只需要答案或一小段文字，就留在一般對話。這不是功能比較弱，而是少一層操作與風險。

例如「幫我想文章開頭」用一般 Chat 就好。「讀這份資料、整理成表格，再更新指定欄位」才適合 Work；若要改程式、跑測試或操作程式庫，就改用 Codex 或 Claude Code。

如果你現在還只會丟一句問題，可以先看<a href="/newbie-pitfalls/chatgpt-from-asking-to-doing.html">3 個把問題改成可驗收任務的實際範例</a>，先把交辦方式練熟，再決定要不要開 Agent。

### 一般人怎麼開始？先從任務升級，不用先換品牌

不用先學完一整套 Agent 名詞。從你現在的工作挑一件有明確完成條件、做錯也容易回復的小事，第一次只開最少權限。

- <mark><strong>只想問問題、整理想法</strong></mark>：留在一般對話。先把目標、背景與輸出格式講清楚，這個能力之後開 Agent 仍然用得到。
- <mark><strong>每次拿到答案還要自己搬資料</strong></mark>：試一個 Agent 任務。選可以檢查的工作，例如整理檔案或更新一張測試表，不要第一次就把整個信箱交出去。
- <mark><strong>想做網站、機器人或長期自動化</strong></mark>：再看<a href="/newbie-pitfalls/ai-coding-tools-compare.html">AI 寫程式工具的實際分工</a>。這時選的是 Claude Code、Codex、Cursor 或其他工作入口，不是在回答 ChatGPT 能不能當 Agent。

我自己的路徑是先長期使用 ChatGPT，2026 年 4 月中才開始用 Claude Code。這段經驗仍然有用，但不是每個人都要照同一個月份表。

如果重來一次，我會從第一個「答案拿到後還要重複動手」的任務開始試 Agent。

真正的升級點不是用了幾個月，而是你能不能說清楚完成條件，並在動作發生後驗收結果。

Agent 會做事，也代表錯誤可能從一段文字變成真的外部動作。

因此第一步不是放更多權限，而是挑一件範圍小、可回復、能檢查的任務。

### Summary

AI Agent 是一種會規劃、使用工具並執行多步任務的做事方式，ChatGPT 是一個產品。現在一般 Chat 負責快速對話，Work 處理較長的多步任務，Codex 處理程式工作。判斷這次要用哪個入口，問 3 件事：完成後是否還要人工操作、任務是否跨多個步驟或工具、你願意開多少權限。一般人的第一個 Agent 任務應該範圍小、可回復、能驗收。

### 名詞解釋

- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **Cursor**：內建 AI 的程式編輯器，跟 Claude Code 同類，但走「圖形介面編輯器」路線而非終端機路線。
- **Codex**：OpenAI 的程式型 AI 代理，跟 Claude Code 同類：能讀寫你的檔案、跑指令、動手把功能做出來。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。

### FAQ

**Q: AI Agent 跟 ChatGPT 差在哪？**

AI Agent 是做事方式，ChatGPT 是產品，兩者不是同一層級的名詞。ChatGPT 裡的一般 Chat 適合快速問答，Work 適合較長的多步任務，Codex 處理程式工作。真正差別是這次只要答案，還是需要 AI 在你授權後繼續執行多個動作。

**Q: 什麼樣的任務適合交給 AI Agent？**

適合 Agent 的任務通常有 3 個特徵：完成後仍需要操作網站或檔案、步驟跨越多個工具、結果有清楚的驗收方式。例如整理一批資料後更新表格。只問一個問題、改一句文字或腦力激盪，使用一般對話更快。

**Q: 我已經會用 ChatGPT，還需要學 AI Agent 嗎？**

不一定要換產品，可以先在 ChatGPT 裡分辨一般 Chat、Work 與 Codex。當你發現每次拿到答案後還要重複搬資料、整理檔案或執行多個步驟，就值得試 Work；程式任務則用 Codex。第一次挑範圍小、可回復、能檢查的任務，並只開必要權限。

**Q: AI Agent 是不是會取代 ChatGPT？**

這個問法把做事方式和產品混在一起。ChatGPT 已把快速對話與 Agent 式工作分成 Chat、Work 與 Codex，所以不是誰取代誰。比較有用的問題是：這次只需要回答，還是需要 AI 使用工具完成動作。

**Q: 非工程師該從哪一類 AI 開始？**

先從一般對話練習講清楚目標與輸出，再從一件小而可驗收的任務試 Agent，不必等待固定的 1 個月或 3 個月。涉及網站、郵件、檔案與帳號時，只開完成任務需要的權限，敏感資料自己輸入，完成後再核對結果。

---

## AI Agent 可以做什麼？10 個非工程師真實案例

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-agent-can-do-what.html
> AI Agent 可以做什麼？你能講清楚的事它都能動手做。非工程師親手做了 10 個應用範例：自動發文、交易日誌、LINE 機器人、市場掃描，附完整實作流程與踩坑紀錄，可照抄。

短答給趕時間的人：AI Agent(例如 Claude Code)可以做的事，範圍是「你能講清楚的事它都能動手做」。具體 5 大類：(1) 內容自動化(Threads、IG 自動發文機器人) (2) 個人工具(交易日誌 PWA、行程管家 LINE 機器人) (3) 跨市場與資料掃描 (4) 元-workflow(品牌與語氣指紋萃取) (5) 系統整合(Claude Code 跨對話 checkpoint)。我這個非工程師從 2026 年 4 月中開始，做了 10 個，整套工具組合加上出錯全公開，可照抄。

「AI Agent 可以做什麼？」這個問題，我看過太多文章答得很玄。

要嘛只給「概念上能做 X、Y、Z」，要嘛只有 1-2 個示範案例。

沒有人系統性地把「一個非工程師從零開始做得出來的東西」，一次列清楚。

這篇就是要補這個洞。

我用 Claude Code 做的 10 個 AI Agent 案例，按使用情境分 5 大類列出來。

每個案例都連結到完整 workflow 詳文，有興趣可以直接照抄。

### 5 大類分類框架：AI Agent 到底能做什麼？

把我做的 10 個案例歸類後，實際上是 5 種模式，不是 10 種完全不同的東西。

掌握這 5 類，你就能套到自己的情境：

這 5 類，大概覆蓋 80% 非工程師會做的 AI Agent workflow。

你的情境不一定全配。挑 1 類最痛的開始。

下面的 10 個應用案例都是我親手做的實作範例，不是轉述別人的企業導入。每個都從零開始，附工具選擇與出錯紀錄，非工程師照著做就能跑。

5 類不是用來「集滿」，是用來「找到你最該做的那一類」。

### 10 個真實案例(每個都可照抄 整套 stack 與踩坑公開)

下面每個案例我都有完整 workflow 詳文，含工具組合的選擇、整套 prompt 模板、撞過的雷。點進去可以直接照抄。

1. <mark><strong>內容自動化 1，Threads 每天 20:00 自動發文機器人</strong></mark>：抓 GitHub trending 用我口吻寫繁中介紹發 Threads，兩個多月穩定。<a href="/workflows/threads-auto-poster.html">看完整 workflow</a>
2. <mark><strong>內容自動化 2，IG 新聞自動發文機器人</strong></mark>：監測 RSS、兩階 LLM (Haiku 過濾 + Opus 寫稿) 省成本到 1/10、Pillow 自動生圖。<a href="/workflows/ig-news-bot.html">看完整 workflow</a>
3. <mark><strong>個人工具 1，交易日誌 PWA</strong></mark>：單一 HTML 加上 Firebase 同步加上情緒×盈虧分析加上拜財神抽籤。已經天天用了 4 個月。<a href="/newbie-pitfalls/ai-built-my-trading-journal.html">看完整實戰紀錄</a>
4. <mark><strong>個人工具 2，家族行程管家 LINE 機器人</strong></mark>：家人在 LINE 一句話「明天 3 點 媽媽 醫院」，機器人自動讀懂，再加上 cron 提醒。永久免費的三樣工具：FastAPI、Supabase、Render。<a href="/workflows/family-line-bot.html">看完整 workflow</a>
5. <mark><strong>資料掃描 1，Market Scanner</strong></mark>：掃 4 市場 (美股 / 台股 / 加密 / 期貨) 最強標的，三指標加權評分。每天 1 小時手刷盤縮成「打開看排名」。(交易類工具依 Lab 紅線不開源)
6. <mark><strong>資料掃描 2，GA4 倒推 ChatGPT referral 來源</strong></mark>:4 個方法倒推「ChatGPT 從哪個 prompt 引用我」，全免費版。<a href="/workflows/ga4-chatgpt-referral.html">看完整 workflow</a>
7. <mark><strong>元-workflow 1，Brand profile lockdown</strong></mark>：把過去經歷餵 AI 當顧問，3-5 天反覆訪談挖出「哪些個性能變品牌」。<a href="/workflows/brand-profile-lockdown.html">看完整 workflow</a>
8. <mark><strong>元-workflow 2，Voice profile 萃取</strong></mark>：從 9 篇舊文用 Claude Code 萃出「語氣指紋」markdown，AI 寫稿立刻像你。<a href="/workflows/voice-profile-extraction.html">看完整 workflow</a>
9. <mark><strong>系統整合，Claude Code 跨對話 checkpoint 系統</strong></mark>：用 .project/ 加上 SessionStart hook 修「每開新對話就忘」，跨 100 加上對話沒再浪費 token 重述。<a href="/workflows/claude-code-checkpoint-system.html">看完整 workflow</a>
10. <mark><strong>BONUS，Coolkid AI Lab 整個網站</strong></mark>：你正在看的這個 Lab，從第一行 HTML 到部署 Vercel 到 GEO audit 81/100，全部我跟 Claude Code 一句一句講出來的。<a href="/newbie-pitfalls/building-this-lab-itself.html">看完整心路歷程</a>

10 個案例都不是「教學示範」，是我自己每天或每週真的在用的東西。

每個都公開原理、工具組合，還有踩過的雷，非工程師照著抄就能跑。

### 4 種人推薦：你該從哪個開始？

有選擇困難症嗎？按下面 4 類人的建議：

- <mark><strong>內容創作者</strong></mark>：從 Threads 機器人開始。設一次長期跑，每天自動曝光，你只出方向。投資報酬率最快看到。
- <mark><strong>有家人或朋友想用的痛點</strong></mark>：從家族 LINE 機器人開始。家人實際用了會給你回饋，改進的動力強。
- <mark><strong>想做自己的工具</strong></mark>：從交易日誌這種個人工具開始。為自己做最容易堅持，因為你每天會打開，不會半途放掉。
- <mark><strong>每週要交簡報的上班族</strong></mark>：從 <a href="/workflows/shiftdeck.html">簡報工具</a> 開始。做出來的檔案還能自己換版面、改動畫、單頁重做，改過一次就知道跟以前差在哪。

通用原則：選一個「每天痛」的事，不要選「最炫的」。

每天痛代表每天有動力用，動力決定你會不會一直改到能用為止。

我做的 10 個，都是先解自己每天的痛點才動手，沒有一個是「先學技術再想做什麼」。

### 企業版：AI Agent 進公司，能實際做到哪些事(2026-07 新增)

上面 10 個，都是個人與個人品牌的案例。

2026 年 7 月我接了一個真實委託：幫一家十人以下的食品批發商做 AI 流程健檢與導入規劃。

那一趟把「小公司能導入什麼」，完整走了一遍。

請注意「性質」那一欄。

六項裡只有兩項真的用到 AI(需要模型判斷的事)，其他是流程自動化與系統。

這是我做完健檢之後，最想講的一件事。

企業導入最大的迷思是「什麼都想沾 AI」，但多數痛點的解法，其實是把紙本變系統、把重複動作變自動。

AI Agent 在這裡，真正的角色有兩個。

少數「要判斷」的環節，它上場當大腦。

更重要的是，上面那套訂單全流程系統的展示原型(拿去給對方實際點按的可操作版本)，是我這個非工程師指揮 AI Agent 做出來的。

功能是不是 AI 不重要。做得出來、有人用，才重要。

導入的順序也有講究。

我給那家公司的建議分三步：先數位化(紙本與口頭交辦進系統)、再自動化(重複動作讓機器自己跑)、最後才是 AI(需要判斷的事交給模型)。

起點不是挑工具，是從「最常重做、白工最多的那個流程」開始盤點。

順序走對，每一步做完就能用，不用等整套完工才見效。

一句話帶走：公司要導入的不是「AI」，是「解掉最痛的那個流程」，AI Agent 是把解法快速做出來的那雙手。

想知道自己的公司(或你自己的日常流程)能從哪一段開始？這種「先盤點痛點、再談工具」的流程健檢，就是我 <a href="/service.html">一對一陪跑服務</a> 的起手式。有免費諮詢，聊完你至少會帶走一張自己的流程清單，要不要繼續都沒關係。

### Summary

AI Agent 可以做什麼？範圍是「你能講清楚的事它都能動手做」。具體 5 大類：內容自動化、個人工具、資料掃描、元-workflow、系統整合。我用 Claude Code 從 2026 年 4 月中開始做了 10 個案例，從每天自動發 Threads 的機器人、家族 LINE 行程管家、交易日誌 PWA、4 市場掃描排名，到把網站做給 ChatGPT 看懂的 GEO 系統，每個都連結到 workflow 詳文可照抄。選擇困難就從「每天痛的事」開始：內容創作者選 Threads 機器人、有家人痛點選 LINE 機器人、想做自己工具選交易日誌。別選最炫的，選最痛的。想看完整 workflow 圖書館往下接。2026-07 新增企業版：實際輔導一家十人以下批發商的導入清單，掃碼登記、電子簽收、自動日報、AI 訊息整理、AI 流程健檢。關鍵分界是多數企業痛點的解法是自動化不是 AI，AI Agent 的角色是把系統快速做出來。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **Threads**：Meta 旗下的文字社群平台。本站的社群引流主戰場之一，相關自動發文流程有整篇教學。
- **LINE 機器人**：在 LINE 裡自動回覆、主動推播訊息的機器人。台灣家庭幾乎人人用 LINE，是自動化通知的最佳入口。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **PWA（漸進式網頁應用）**：讓網頁能「安裝」到手機桌面、像 App 一樣全螢幕開啟的技術，不用上架 App Store。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **Render**：雲端程式代管服務，免費方案能跑小型後端程式（例如 LINE 機器人）。免費版 15 分鐘沒流量會休眠，喚醒要 15-50 秒。
- **Supabase**：免費起步的雲端資料庫服務，提供資料庫＋登入驗證＋API，個人專案很夠用。
- **引薦流量（referral）**：從其他網站的連結點進來的流量。ChatGPT 引用你的內容帶來的點擊就屬於這一類。

### FAQ

**Q: AI Agent 可以做什麼？最短答案？**

AI Agent (例如 Claude Code) 可以做的事範圍是「你能講清楚的事它都能動手做」。具體 5 大類：內容自動化 (Threads / IG 機器人) / 個人工具 (交易日誌、行程管家) / 資料掃描 (跨市場 / 跨來源) / 元-workflow (品牌 / 語氣指紋萃取) / 系統整合 (補既有工具缺口)。我從 2026 年 4 月中開始做了 10 個案例，非工程師全可照抄。

**Q: AI Agent 一定要會程式才能做嗎？**

不用。我是非工程師，完全不會寫程式。難的不是「寫程式」，是「想清楚要做什麼」。Claude Code 這類 AI Agent，你用自然語言描述需求，它負責寫程式。10 個案例中沒一個我自己寫過半行程式碼，但每個我都清楚「我要它做什麼、卡住怎麼找問題」。

**Q: 做一個 AI Agent workflow 要多久？**

看複雜度。最簡單的 (Threads 機器人從零到上線) 30 分鐘，整段 prompt 複製給 Claude Code 它幫你建好骨架。中等的 (交易日誌 PWA) 半天到一天。複雜的 (家族 LINE 機器人含 FastAPI + Supabase + Render 部署) 1-2 天。重點不是技術難度，是「想清楚要它做什麼」這段。

**Q: 這 10 個案例都要付月費嗎？**

Claude Code 訂閱必要(每月 US$20)。其他大部分用免費服務：GitHub Actions(Threads 機器人排程)、Firebase 免費方案(交易日誌同步)、Supabase 加 Render 加 cron-job.org 這三樣永久免費(LINE 機器人)、GA4 加 GSC 加 Bing 三樣免費(referral 倒推)。10 個 workflow 總成本只有 Claude Code 的每月 20 美元。

**Q: 我做的 case 跟你的不同怎麼辦？**

更好。我列 10 個是要當啟發，不是讓你照抄。看 5 大類分類，套到你自己情境：你有什麼每天痛的事？每週重複勞動？家人有什麼需求？選一個改成你的案例。Claude Code 一樣能幫你做，過程一樣可以照本文的工具組合、踩坑、心法。

**Q: 有推薦的 AI Agent 工具嗎？**

看你要做什麼。我個人用 <a href="/newbie-pitfalls/claude-code-what-is.html">Claude Code</a>，這篇 10 個案例全部都是用它做的。你用自然語言講需求，它幫你寫程式、部署、除錯，不用自己寫半行。如果想先試免費的，ChatGPT 的 GPTs 或 Coze 也能做簡單的自動化，但複雜度和彈性差一截。建議先從一件小事開始試，不要先選工具。

**Q: AI Agent 只有企業能用嗎？個人也能做？**

個人不但能做，常常比企業更快看到效果。企業導入要過簽核、資安、整合既有系統，個人想到就能動手。這篇 10 個案例全部都是個人應用：<a href="/workflows/threads-auto-poster.html">自動發 Threads 貼文</a>、家人用的 LINE 機器人、自己的交易日誌。你不需要有公司、不需要有團隊，一個人加一個 AI Agent 就能跑起來。

**Q: 小公司(10 人以下)也適合導入 AI Agent 嗎？**

適合，前提是你有一個天天發生的流程痛點。滿足這個前提的話，小公司常常比大公司更快看到效果，流程短、決策快，一個痛點解掉整家公司都有感。我實際輔導的案例是一家十人以下的食品批發商：第一步不是上 AI，是把紙本與 LINE 訊息裡的訂單流程數位化，再讓日報自動化，最後才在「訊息整理」這種需要判斷的環節用 AI。預算有限就照這個順序走，每一步做完就用得到。

---

## Claude Code vs ChatGPT：一天實際怎麼配著用

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-vs-chatgpt.html
> Claude Code 跟 ChatGPT 怎麼配著用？對照表講介面、費用、權限的實際差別，加上我一天怎麼在兩邊交接，還有多裝一個 Claude Code 要先知道的三件事。

短答給趕時間的人：Claude Code 跟 ChatGPT 不是同類工具，不能直接比強弱。ChatGPT 開瀏覽器就能用，聊天問答，結果你自己動手。Claude Code 跑在終端機(打指令的那個文字視窗)，會讀寫你的檔案、執行指令、把整套任務做完。實際用起來是兩個都開著，先在 ChatGPT 把需求問到自己講得清楚，再把那段話整段貼給 Claude Code 去做。多裝一個之前先知道三件事：訂閱是兩筆各付各的、要先裝命令列工具、做完你要自己打開檔案確認有沒有做對。

「Claude Code vs ChatGPT」這個問題，我看過很多人問。

但答案常常用工程師視角講。例如「Claude Code 寫程式比較強」「ChatGPT 對話比較自然」。

這對非工程師不夠用。

我們在意的是「我現在用 ChatGPT 用得好好的，要不要再多裝一個？」

這篇用我自己的真實視角講。先當純 ChatGPT 用戶，2026 年 4 月中才加上 Claude Code，到今天兩邊並用三個多月。

講的是實際用起來的差別，介面差在哪、費用怎麼算、權限給到哪裡，我一天怎麼在兩邊交接，還有多裝一個要付什麼代價。

還不確定「AI Agent」是哪一類東西的，先看 <a href="/newbie-pitfalls/ai-agent-vs-chatgpt.html">AI Agent vs ChatGPT 那篇</a>把類別分清楚，這篇直接進工具。

### Claude Code vs ChatGPT 對照表(實際用起來差在哪)

下面這張表，是我 4 月中裝上 Claude Code 之後，一邊做網站、一邊跑自動化，兩邊並用三個多月才整理出來的。

比的不是誰強，是同一件事在兩邊做起來差多少：

重點是這兩個要一起用。不用二選一。

ChatGPT 不會被 Claude Code 取代。反過來也一樣。兩個解的問題層次不同。

我自己 80% 時間是「ChatGPT 想策略，丟給 Claude Code 實作」這種分工。

兩邊交接的東西，就是一段講清楚的需求。ChatGPT 幫你把需求問到講得出來，Claude Code 拿那段話去做。

### 我一天實際怎麼在兩個之間切換？

其實不用每次都停下來想「該用哪個」。我自己是照著三種場面走，久了不太需要判斷。

1. 場面 1，還沒想清楚要什麼的時候，開 ChatGPT。像是「幫我整理 GEO 跟 SEO 差別」「這篇文章開頭怎麼寫比較好」。這種要來回問的事，網頁介面比終端機順，回得也快。
2. 場面 2，已經知道要什麼、只差有人做，開 Claude Code。舉例來說「做一個交易日誌網頁，手機能開」「每天 8 點抓資料發 Threads」「把這 100 個 .txt 合併成一份 markdown」。這種要真的產出檔案的事，Claude Code 直接做完，不用你複製貼上。
3. 場面 3，兩邊接力，我最常用的就是這種。先在 ChatGPT 把想法問到自己講得清楚，再把那段需求描述整段貼進 Claude Code。交接的東西就是那一段文字，沒有什麼特別的格式要轉。

切換的成本比想像中低。

交接物就是一段文字，兩邊都吃得下。

所以真正花時間的是把需求想到自己講得清楚，也就是想明白你到底要什麼、做出來要長什麼樣，而那件事在哪一邊做都一樣。

### 多裝一個 Claude Code，要先知道哪三件事？

裝完不會自動變快。下面這三件事，我覺得該先知道：

- <mark><strong>訂閱要付兩筆</strong></mark>：ChatGPT 的方案跟 <a href="/newbie-pitfalls/claude-vs-claude-code.html">Anthropic 的方案</a>各付各的，沒有合在一起的選項。兩邊都留著，一個月就是兩筆 US$20 起跳(2026-07 對照官方說明，價格會調整，以官方為準)。只留一邊也行，看你哪一邊用得比較多。
- <mark><strong>要先裝命令列工具</strong></mark>：Claude Code 不是開網頁就能用，要在終端機(打指令的那個文字視窗)裡跑。這一步是非工程師最容易卡住的地方，Windows 安裝那篇把我遇過的問題都寫下來了。
- <mark><strong>做完要自己確認</strong></mark>：ChatGPT 回錯了，你看一眼就知道。Claude Code 是真的改到你的檔案，做完要自己打開來看。會動手就會動到東西，這一步省不掉。

這三件事都不難，但事先知道跟做到一半才發現，感受差很多。

順序建議：先在 ChatGPT 把需求練到講得清楚，再裝 Claude Code。反過來最容易卡在「我到底要它做什麼」。

### Summary

Claude Code 跟 ChatGPT 不是同類工具，不能直接比強弱。ChatGPT 開瀏覽器就能用，聊天問答，動手的還是你。Claude Code 跑在終端機，會讀寫你的檔案、執行指令、把整套任務做完。實際用起來是兩個都開著：在 ChatGPT 把需求問到自己講得清楚，再整段貼給 Claude Code 去做，交接物就是那段文字。多裝一個之前先知道三件事：訂閱是兩筆各付各的、要先裝命令列工具、做完你要自己打開檔案確認。想先搞懂「AI Agent」這個類別跟 ChatGPT 差在哪，回去看 AI Agent vs ChatGPT 那篇。想直接動手裝，接 Windows setup 那篇。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Cursor**：內建 AI 的程式編輯器，跟 Claude Code 同類，但走「圖形介面編輯器」路線而非終端機路線。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。

### FAQ

**Q: Claude Code 跟 ChatGPT 差在哪？**

差在「動手」。ChatGPT 是對話 AI 用瀏覽器聊天，你問它答，結果動手的還是你自己複製貼上。Claude Code 是 AI Agent 用終端機，有權限直接讀寫你電腦的檔案、執行指令、把任務做完。一句話：ChatGPT 是會說話的顧問，Claude Code 是會做事的助理。

**Q: 有了 ChatGPT Plus，還要再付 Claude Code 的錢嗎？**

是兩筆。ChatGPT 的訂閱跟 Anthropic 的訂閱各付各的，沒有合併方案。兩邊都留，一個月就是兩筆 US$20 起跳(2026-07 對照官方說明，價格會調整，以官方為準)。我自己兩邊都留著，因為用途不重疊。預算只夠一筆的話，先看你比較常做哪一種事：想東西居多留 ChatGPT，要產出檔案居多留 Claude Code。

**Q: Claude Code 要在哪裡用？跟 ChatGPT 的網頁差很多嗎？**

Claude Code 跑在終端機，也就是 Windows 的 PowerShell 或 Mac 的 Terminal，那個打指令的文字視窗。畫面只有文字，沒有按鈕。實際操作跟 ChatGPT 一樣是打一段話給它，差別在回你的時候會真的去改檔案。第一次看到那個視窗會不習慣，用兩天就順了。

**Q: 在 ChatGPT 想好的東西，怎麼交給 Claude Code？**

整段複製貼上就好。我自己是在 ChatGPT 問到自己講得清楚，把最後那段需求描述整段貼進 Claude Code，貼完就照著做。不用轉檔，也沒有特別的格式。這也是為什麼在 ChatGPT 把需求練清楚是有用的，那段文字就是兩邊的交接物。

**Q: Claude Code 跟 Cursor 比哪個更接近 ChatGPT？**

Claude Code 介面跟 ChatGPT 對話比較像(都是文字往返)，只是能動手做事。Cursor 是編輯器內 AI，比較像「VSCode 加上內建 ChatGPT」，Cursor 的 AI 可以直接改你的程式碼，適合已經會寫程式的人。非工程師我推薦 Claude Code，因為不需要懂編輯器介面。

---

## Claude Code 新手村：從 0 到第一個網站

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-guide.html
> Claude Code 中文教學 8 篇依入門順序整理：是什麼 → 跟 ChatGPT / Cursor 差在哪 → Windows 安裝 → 第一個網站 → 部署排錯。非工程師從 2026 年 4 月中走完的路徑。

短答給趕時間的人：Claude Code 新手村這 8 篇，按入門順序排是這樣。先看 Claude Code 是什麼，再看跟 Cursor、ChatGPT 的對照，接著是 Windows 安裝、第一個網站、Vercel 部署排錯，最後是斷點系統。這是一個非工程師全職交易者從 2026 年 4 月中開始走完的路徑，這頁 30-60 分鐘可以看完，整套跑完大概 30 天。

「Claude Code 新手村」這個詞，我搜了一下，發現中文圈幾乎沒有完整的入門路徑。

文章散落各處，看完一篇，接著該看哪一篇？沒有人指引。

這篇就是來補這個洞。

我把自己寫的 8 篇 Claude Code 文章，按「非工程師從 0 到 1」的閱讀順序排成一頁總覽。

適合誰、不適合誰、預計要花多久，全部列清楚。

### 階段 1 認知層：Claude Code 到底是什麼？

階段 1 先不用動手，重點是搞懂「Claude Code 是什麼東西，跟你已經在用的工具差在哪」。

少了這一層直接跳到階段 2，很容易卡住。

- <mark><strong><a href="/newbie-pitfalls/claude-code-what-is.html">📖 Claude Code 是什麼？跟 Claude / Cursor / ChatGPT 差在哪</a></strong></mark>，用一句話加一張對照表，講清楚這 4 個工具怎麼分。讀完你會知道「為什麼需要 Claude Code」。預計 8 分鐘。
- <mark><strong><a href="/newbie-pitfalls/claude-code-vs-cursor.html">📖 Claude Code vs Cursor：一個非工程師為什麼選了 Claude Code</a></strong></mark>，兩個 AI Agent 工具的選擇對比。網路上的比較大多是工程師視角（都說新手選 Cursor），這篇補上非工程師視角。預計 10 分鐘。
- <mark><strong><a href="/newbie-pitfalls/claude-code-vs-chatgpt.html">📖 Claude Code vs ChatGPT：一天實際怎麼配著用</a></strong></mark>，已經會 ChatGPT 的人讀，會知道為什麼還要學 Claude Code，兩個又該怎麼分工。預計 8 分鐘。

### 階段 2 安裝與第一個專案（30-60 分鐘動手）

階段 2 開始動手，需要 Anthropic Pro 訂閱，每個月 US$20。

沒裝 Node.js、不會用 PowerShell 也別擔心，那幾篇文章裡都有一步一步、從頭帶到尾的完整做法。

- <mark><strong><a href="/newbie-pitfalls/claude-code-windows-setup.html">📖 Claude Code Windows 安裝踩雷實錄（2026）</a></strong></mark>，Windows 11 上從 2026 年 4 月中跑到現在的非工程師，完整一步一步走過一次。4 步指令，加上 3 個 Windows 專屬的雷怎麼解。預計 30 分鐘，含找問題的時間。
- <mark><strong><a href="/newbie-pitfalls/claude-code-beginner-make-website.html">📖 第一次用 AI 做網站：一個非工程師的真實心路歷程</a></strong></mark>，第一次跟 Claude Code 合作，做一個能上線的工具。30-60 分鐘做出一個條件式問答工具，測驗、MBTI、客戶新手引導都能套。
- <mark><strong><a href="/newbie-pitfalls/claude-code-vercel-deploy-not-working.html">📖 Vercel 部署不更新？重寫比修補快的啟示</a></strong></mark>，第一次部署到 Vercel 幾乎一定會遇到的雷。自己電腦看得到、網路上看不到的時候怎麼找問題，什麼時候該重寫而不是補。預計 20 分鐘讀完，但實戰可能花 1-2 小時。

### 階段 3 進階：機器人、自動化、斷點系統

階段 3 不是每個人都要看。

接下來想做什麼？三個方向可以選，做機器人、做工具，或是解決跨對話失憶。

- <mark><strong><a href="/newbie-pitfalls/ai-daily-thread-auto-poster.html">📖 AI Agent 實戰：我用 Claude Code 做了每天自動發 Threads 的 AI 機器人</a></strong></mark>，Claude Code 排程任務（scheduled-tasks）的第一個實戰專案。如果你想做內容自動化，從這篇開始。
- <mark><strong><a href="/workflows/claude-code-checkpoint-system.html">📖 Claude Code 跨對話不失憶：斷點系統 + 兩個 hook + 全專案儀表板</a></strong></mark>，Claude Code 重度用戶用來解決「每次開新對話就忘」的一套系統。一次設好，之後跨 100 次以上的對話都不用再浪費 token 重述。
- <mark><strong><a href="/newbie-pitfalls/ai-agent-can-do-what.html">📖 AI Agent 可以做什麼？10 個非工程師真實案例</a></strong></mark>，看 10 個我用 Claude Code 做的案例，包含 Threads 機器人、IG 機器人、LINE 機器人、交易日誌、market scanner，選一個你最想做的當下一步。

### 整套跑完要花多久時間？

如果你跟我一樣是非工程師，下面是一個合理的 30 天時程估計。

1. 第 1 週：讀階段 1 那三篇認知文，含思考大概 3-5 小時，順便訂閱 Claude Code Pro
2. 第 2 週：跑階段 2 的 Windows 安裝，再做出第一個網站，含找問題大概 10-15 小時
3. 第 3 週：部署到 Vercel，解掉第一波踩的坑，開始想第二個專案，大概 10 小時
4. 第 4 週：從階段 3 挑一篇實作，Threads 機器人或交易工具任選，大概 15-25 小時

30 天結束的時候，你手上應該有一個能上線的網站，一套自己每天在用的自動化流程，還有一個跨對話的斷點系統。

這就是「Claude Code 從 0 到能用」的階段成果。

之後就是不斷做新專案，慢慢把經驗累積起來。

### Summary

Claude Code 新手村 8 篇按入門順序分成 3 個階段。階段 1 是認知層 3 篇，講是什麼、跟 Cursor 差在哪、跟 ChatGPT 差在哪。階段 2 是安裝與第一個專案 3 篇，講 Windows 安裝、做網站、Vercel 部署排錯。階段 3 是進階的 3 個方向，機器人、斷點系統、案例總覽。這是一個非工程師全職交易者從 2026 年 4 月中開始走完的路徑，合理的 30 天時程是這樣：第 1 週認知，第 2 週安裝動手，第 3 週部署解坑，第 4 週從階段 3 挑一個實作。30 天後你會有一個能上線的網站、一套自動化流程，還有一個跨對話的斷點系統。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。
- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。
- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **Cursor**：內建 AI 的程式編輯器，跟 Claude Code 同類，但走「圖形介面編輯器」路線而非終端機路線。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **Threads**：Meta 旗下的文字社群平台。本站的社群引流主戰場之一，相關自動發文流程有整篇教學。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。

### FAQ

**Q: Claude Code 新手村是什麼？**

這是 Coolkid AI Lab 把 Claude Code 入門 8 篇文章，按非工程師的閱讀順序整理成的一頁總覽。從「Claude Code 是什麼」，到「做第一個網站」，再到「跑第一個自動化機器人」，一共分成 3 個階段。這是一個非工程師全職交易者從 2026 年 4 月中開始走完的路徑，新手可以直接照著順序讀。

**Q: 我可以跳順序讀嗎？**

可以，但不建議。階段 1 的認知層只要 30 分鐘讀完，跳過直接看實作，會卡在「不知道為什麼要這樣做」。階段 2 的安裝是一定要跑的，沒裝就什麼都動不了。階段 3 可以選自己想做的方向，不用全部讀完。

**Q: Claude Code 一定要付費嗎？**

要。Anthropic Pro 每個月 US$20，沒有完全免費的版本可以用。對比起來，如果你拿它做出一個機器人、一個網站，等於每個月省下幾十小時的手動操作，對「想用 AI 做事」的非工程師來說回本很快。

**Q: 我是 Mac 用戶，這個路徑適合嗎？**

階段 1 的認知、階段 2 的第一個網站、階段 3 的全部都適用。只有階段 2 的安裝那篇是 Windows 版，Mac 用戶可以略過，Mac 安裝比較簡單，brew install 五分鐘就搞定。其他文章都不分作業系統。

**Q: 讀完這個 hub 我能做什麼？**

如果 30 天的時程跟完，你會有三樣東西：一個能上線的網站，做給自己或家人用。一套自動化流程，Threads 機器人或交易工具任選。還有一套 Claude Code 跨對話的斷點系統，不用每次重新交代一遍。後續就是不斷做新專案，把經驗累積起來。

---

## 不會寫程式怎麼用 AI 做網站？5 階段實作

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-make-website-guide.html
> 不會寫程式也能用 AI 做網站，但仍要決定需求、檢查結果與處理部署。非工程師用 Claude Code 從 0 上線的 5 階段、真實卡點與工具選擇。

短答給趕時間的人：不會手寫程式，也可以用 AI 做出網站，但不是按一下就完成。我是非工程師，2026 年 4 月中開始用 Claude Code，第一個網站花了一個下午上線，其中部署就卡了 3 小時。後來把同一套做法用在這個 136 篇文章的網站與 13 個工作流，再整理成 5 階段：選小問題、說清楚需求、做出最小版本、部署、用真實使用慢慢修。

「不會寫程式可以做網站嗎？」這個問題我自己問過。

以前我以為選項只有兩種：自己學會寫程式，或被網站模板限制。

2026 年 4 月中開始用 Claude Code 後，我才多看到第三條路。

我不必手寫每一行程式，但要把需求講清楚、看懂畫面哪裡不對、測試功能，最後確認部署真的上線。

這篇是整條路徑的主幹文，把「非工程師用 AI 做網站」一次講清楚。

我把自己走過的路拆成 5 階段：挑小問題、選工具、做出最小版本、部署、再長成個人品牌網站。

這不是保證幾小時完成的捷徑，而是一條可以從小成果開始、每一步都能驗收的路。

適合誰？完全不會寫程式，但想要一個「真的屬於自己、能自由改」的網站。

下面兩種人不太適合。

只想要 link-in-bio 一頁就好的，有專門那篇 1 天搞定。

想做高流量的 SaaS 或電商的，這篇只到個人品牌等級。

### 階段 1：不會手寫程式，仍然能做網站嗎？

先給短答，答案是可以。

要換掉的前提不是「程式已經不重要」，而是「每一行都必須由我親手寫」。AI 可以產生程式，但需求、資料安全、測試與上線結果仍然要有人負責。

新的分工是：我說清楚給誰用、要解決什麼、完成後怎麼驗收，AI 把需求轉成檔案與程式。第一版出來後，我實際打開、點按鈕、找問題，再請它修。

我沒有手寫每一行程式碼，但也不是完全不用碰技術。檔案位置、網址、帳號權限與錯誤訊息，仍要在出問題時一項一項確認。

「會講需求」聽起來很模糊，<a href="/newbie-pitfalls/how-to-use-ai-agent.html">具體是什麼意思</a>？

是能講出「我要一個讓家人記行程的網站」、「我要一個能在手機上開的交易日誌」、「我要一個放我所有連結的個人入口頁」這種使用情境的描述。

不是「我要用 React 加 TypeScript 加 Tailwind 做網站」那種技術需求。

非工程師的優勢不是比工程師更會做網站，而是更容易先從使用情境描述需求。

「我要讓家人用手機記行程」比「幫我用某個框架」更接近真正問題。技術選擇可以請 AI 解釋，但誰會用、資料放哪、什麼算完成，不能全部外包。

AI 把手寫程式的門檻降低了，沒有拿走需求、測試與部署責任。第一站先求能用、能回復、能驗收。

### 階段 2 工具選擇(10 分鐘讀)：Claude Code、ChatGPT、Cursor、免寫程式的工具怎麼選？

用 AI 做網站的入口很多。先不要問哪個最強，先看你要不要長期維護、願不願意碰專案檔案，以及網站是否涉及登入、付款或敏感資料。

下面的選法以我實際走過的 Claude Code 路線為主，其他工具只列適用情境，不用容易過期的固定價格判斷。

我最後選 Claude Code，不代表每個非工程師都該選它。

它適合我，是因為我要長期改同一個網站，也願意學會看檔案、版本紀錄與部署結果。

如果你只要一頁介紹、不打算維護，拖拉式工具通常更快。

如果網站要登入、付款或保存私人資料，先縮小功能，必要時找專業工程師檢查安全與資料處理。

那什麼時候不該選 Claude Code？

你只要一頁 link-in-bio，沒打算後續一直改，那就用 linktree 那種 1 天搞定的工具就好。

你完全不想碰任何命令列，Wix 適合你。

你要做高流量電商，找 Shopify 或者專業團隊。

選工具先看後續責任。只要一頁，選最快上線的入口。要長期維護，才值得學會管理檔案、版本與部署。

### 階段 3：用 5 步做出第一個可上線版本

假設你選了 Claude Code。

我第一個網站花了一個下午，其中部署卡了 3 小時。你的時間會受功能、安裝與排錯影響，所以先把目標訂成「今天做出能打開的最小版本」，不要拿固定分鐘數逼自己。

1. <mark><strong>步驟 1：選入口並完成安裝</strong></mark>。我走 Claude Code 路線，Windows 現行安裝與登入方式整理在<a href='/newbie-pitfalls/claude-code-windows-setup.html'>Claude Code Windows 安裝</a>。價格與方案會變，動手前直接看官方頁面，不把舊文章的數字當報價單。
2. <mark><strong>步驟 2：用 3 句話定義最小版本</strong></mark>。寫出給誰用、解什麼問題、完成後要能做哪 3 件事。例如「給家人用的行程頁，手機能開，可以新增、刪除與看清單，不先做登入」。
3. <mark><strong>步驟 3：先要求計畫，再做第一版</strong></mark>。把 3 句需求交給 AI，先請它列出檔案、步驟與風險。確認後再做最小版本。登入、付款與資料庫先不要塞進第一版。
4. <mark><strong>步驟 4：用真實動作驗收</strong></mark>。不要只看畫面漂亮。用手機開一次、按過每個按鈕、重新整理、輸入錯誤資料，再把實際結果與預期差異交給 AI 修正。
5. <mark><strong>步驟 5：部署後再從公開網址重測</strong></mark>。可用 Vercel、Netlify 或 GitHub Pages。部署完成不等於成功，要打開公開網址確認版本、手機畫面與主要操作，再把可回復的版本紀錄留下來。

第一個網站建議選「給自己用」或「給家人用」的小工具，不要選「給市場用的產品」。

理由是什麼？給自己用的工具，改的動力最強，因為你每天打開都會看到痛點，而給市場用的要等別人回饋才知道哪裡要改，速度慢上幾倍。

我自己第一個網站，是給老婆做的童裝庫存管理頁。

從零到上線花了一個下午，部署那段卡了 3 小時。「本機看得到、公開網址沒有更新」是我真的遇過的問題，但不是每個人都會碰到，也不只一種原因。

詳細看 <a href='/newbie-pitfalls/claude-code-vercel-deploy-not-working.html'>Vercel 部署不更新踩雷實錄</a>。

### 階段 4 部署：Vercel、Netlify、GitHub Pages 怎麼選？

做完 HTML 在自己電腦看得到，要怎麼讓陌生人也能開？

這就是「部署」。個人靜態網站常見的起點有 Vercel、Netlify 與 GitHub Pages，免費方案的用途與額度會變，上線前要看各平台現行條款。

我目前用 Vercel，理由主要是 GitHub 推送後會自動部署，也能產生預覽網址。

對我這種會持續更新內容的人，自動部署比手動上傳省事。

Vercel Hobby 是個人、非商業用途的免費方案，而且有用量上限，不是「永久無流量上限」。現行額度與限制請看<a href='https://vercel.com/docs/plans/hobby' rel='noopener noreferrer'>Vercel Hobby 官方文件</a>。

HTTPS、CDN 與預覽部署是我留下來使用的功能，但平台選擇仍要看網站用途。

如果網站開始商業化或超過免費方案限制，就要重新看方案，不能因為第一版免費就假設永遠免費。

這個 Lab 與我的幾個個人專案目前部署在 Vercel。這只證明它符合我現在的用途，不代表任何規模都能一直用免費方案。

我會看實際用量與平台條款，而不是用訪客數猜還剩多少額度。

部署最常踩的雷是「本地看得到、Vercel 看不到」。

我會先查 3 類原因。第一是檔名大小寫不一致，Windows 本機可能看不出來，部署到 Linux 環境才出錯。

第二是路徑用了 Windows 的反斜線，沒改成正斜線。

第三是 git push 根本沒成功。

詳細解法看 <a href='/newbie-pitfalls/claude-code-vercel-deploy-not-working.html'>Vercel 部署排錯</a>。

### 階段 5 個人品牌應用：從 link-in-bio 到完整網站

做出第一個工具或網站之後，個人品牌應用有 3 種常見模式，按複雜度排序：

1. <mark><strong>等級 1：Link-in-Bio 個人入口</strong></mark>(1 天上線)：一頁放你所有社群連結加簡介。適合 IG、Threads 的「網站」連結。我做的 link.coolkidlab.com 就是這個。詳細看 <a href='/newbie-pitfalls/ai-built-link-in-bio-site.html'>link-in-bio 個人入口 6 踩坑與 1 天上線方法論</a>。
2. <mark><strong>等級 2：個人品牌入口站</strong></mark>(1-2 週)：About 頁加作品集加聯絡。比 link-in-bio 多了敘事跟 SEO 入口。適合自由工作者、創作者。
3. <mark><strong>等級 3：內容加服務型網站</strong></mark>(1-3 個月)：像這個 Coolkid AI Lab，多篇文章、自動化 SEO、服務頁、訂閱機制。適合想做 build-in-public 或內容創業的人。我做這個 Lab 用 Claude Code 從 0 做起來，目前 136 篇文章、GEO 盤點分數 81/100。

該選哪一個等級？看你「3 年內想做什麼」。

想單純有個網路名片，選等級 1。

想做自由工作者展示作品，選等級 2。

想做內容、教學、服務，選等級 3。

等級 1 到 3 可以漸進升級，不用一開始就決定。

### 新手最常撞的 5 個坑 (與解法)

- <mark><strong>坑 1：想一次到位做完美</strong></mark>。第一版永遠不該完美，1.0 上線之後照讀者回饋改 2.0 才有用。解法：每次只追求「比現在好一點」，設一個期限，強迫自己把不完美的版本推上線。
- <mark><strong>坑 2：工具選得比需求還早</strong></mark>。還不知道網站給誰用，就先糾結 Claude Code、Wix 或框架。解法：先寫出使用者、問題與 3 個驗收動作，再選能最快完成那個版本的工具。
- <mark><strong>坑 3：把路徑問題都怪給中文</strong></mark>。我確實遇過 Windows 中文路徑與編碼問題，但不是中文資料夾一定會壞。解法：新專案先用英文、數字與連字號降低變數，出錯時仍要看真正的錯誤訊息。
- <mark><strong>坑 4：部署成功就以為網站已更新</strong></mark>。本機版本、GitHub 提交與線上部署可能不是同一版。解法：依序看 git status、遠端提交、部署紀錄，再從公開網址確認實際內容。
- <mark><strong>坑 5：把做完畫面當成做完網站</strong></mark>。至少要用手機開一次、按過主要功能、測錯誤輸入與重新整理。能打開不代表能使用，公開網址驗收才算完成。

### Summary

不會手寫程式也能用 AI 做網站，但 AI 不會替你決定需求、驗收結果或承擔資料安全。我的 5 階段是：挑一個小問題、選適合長期責任的工具、做出最小版本、部署後從公開網址重測、再用真實使用慢慢擴充。第一個網站花了我一個下午，其中部署卡了 3 小時。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **native 安裝（原生安裝）**：官方提供的獨立安裝方式：一行指令下載完整程式，不依賴 Node.js 這類其他環境，裝完會自動更新。2026 年官方文件的推薦裝法。
- **Node.js**：讓電腦能執行 JavaScript 程式的基礎環境。Claude Code 的 npm 舊裝法才需要先裝它；2026 年官方推薦的 native 一行安裝不用。免費，從官網 nodejs.org 下載安裝。
- **PowerShell**：Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。
- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。
- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。
- **無程式碼（no-code）**：不寫程式、用拖拉跟設定做出應用的工具或方法。AI 代理出現後，「會描述需求」比「會不會寫程式」更關鍵。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **SEO（搜尋引擎優化）**：讓網站在 Google 搜尋結果排得更前面的一整套方法，涵蓋技術體質、內容品質、連結結構三層。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **HTML**：網頁的骨架語言，定義「這是標題、這是段落、這是圖片」。
- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **Cursor**：內建 AI 的程式編輯器，跟 Claude Code 同類，但走「圖形介面編輯器」路線而非終端機路線。
- **Codex**：OpenAI 的程式型 AI 代理，跟 Claude Code 同類：能讀寫你的檔案、跑指令、動手把功能做出來。
- **SaaS（軟體即服務）**：訂閱制的雲端軟體服務。新手第一個專案不建議直接挑戰這個，範圍太大。
- **Tailwind**：寫網頁外觀的捷徑：不另外開一個樣式檔，直接在標籤上寫顏色、間距這些關鍵字就能改長相。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。

### FAQ

**Q: 不會寫程式真的能用 AI 做網站嗎？**

可以，但更準確的說法是「不用親手寫每一行程式」。你仍要說清楚給誰用、完成後要能做什麼，並實際測試與確認部署。我從 2026 年 4 月中開始用 Claude Code，第一個網站花了一個下午，其中部署卡了 3 小時。

**Q: Claude / ChatGPT / Cursor 哪個做網站最好？**

沒有固定第一名。只要一頁介紹、很少修改，可以先用拖拉式工具。想長期維護專案檔案，我自己選 Claude Code。已習慣程式編輯器的人可看 Cursor。符合資格的付費方案也可用 ChatGPT Work 處理多步任務，程式開發則另有 Codex。先看用途與後續責任，再看品牌。

**Q: 用 AI 做網站要多少錢？**

成本至少分成 AI 工具、網域與部署 3 塊，而且方案會變。第一版可以先用免費網址與個人專案方案驗證，但 Vercel Hobby 限個人、非商業用途，也有用量上限。不要把文章裡的舊價格當報價單，訂閱前直接看官方方案頁。

**Q: 我做的網站只給家人 / 自己用，需要學這套嗎？**

很適合拿來當第一個專案，因為使用者就在身邊，問題也容易驗收。我第一個網站就是給家人用的小工具。先不做登入、付款與敏感資料，從手機能開、能完成 3 個動作的最小版本開始。

**Q: 我做完網站要怎麼讓人看到？**

先確認公開網址真的能開，再談推廣。內容型網站可逐步做 SEO 與 AI 搜尋引用，社群則適合分享實作過程與取得早期回饋。兩條路可以並行，但第一步都是確認讀者從公開網址能完成你設計的動作。

**Q: 我做了模板覺得醜，可以叫 AI 改視覺嗎？**

可以，但不要只丟一句「做得像某品牌」。附上目前截圖，指出想保留與想改的地方，再要求 AI 先列視覺差異。改完要檢查手機版、文字對比、按鈕與圖片尺寸。我自己的 Lab 也用過參考圖加 AI 實作的流程，但每一輪仍要人工驗收。

---

## Claude 跟 Claude Code 差在哪？一份訂閱兩邊用

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-vs-claude-code.html
> Claude 是瀏覽器裡的 AI 聊天，Claude Code 是裝在電腦裡幫你動手做事的工具。同一顆大腦，Pro 訂閱一份兩邊通用。差在哪、何時用哪個、錢怎麼算，這篇一張表講完。

短答給趕時間的人：Claude 跟 Claude Code 是同一家公司(Anthropic)的兩個入口，用的是同一系列 AI 模型，差在身體不同。Claude 是網頁跟 App，你用聊天的方式問。Claude Code 是裝在電腦裡的工具（終端機、桌面 App、網頁版都有），能讀寫你的檔案、執行指令、把整件事做完。一句話：同一顆大腦，一個坐櫃檯跟你聊，一個進你家幫你做。Pro 訂閱(US$20/月，2026-08)一份兩邊通用，不用付兩次。

「claude 跟 claude code 差別」這個詞，開始有人搜進 Lab。

我才發現我寫過 <a href="/newbie-pitfalls/claude-code-vs-chatgpt.html">Claude Code vs ChatGPT</a>、<a href="/newbie-pitfalls/claude-code-vs-cursor.html">vs Cursor</a>，偏偏沒寫過最容易混淆的這組。

同一家公司、名字只差一個字，難怪搞混。

這篇用我自己兩邊都天天用的視角講清楚：差在哪、為什麼有兩個、什麼時候用哪個，還有錢怎麼算。

這篇是寫給非工程師的，術語文末有小辭典。

### Claude vs Claude Code 一張對照表

先看表，再講為什麼。重點只有一個：這不是「普通版 vs 進階版」，是同一個 AI 的兩種用法：

同一顆大腦、兩個身體：Claude 坐在櫃檯跟你聊，Claude Code 進你家幫你做事。

### 搞混不是你的問題：為什麼會有兩個？

會搞混，其實很正常。

因為「Claude」這個名字一次當了三種東西：AI 模型的名字(像引擎)、聊天網站的名字(claude.ai)，還有品牌名。

Claude Code 則是第四個東西，一個用同系列模型的「工具」。

差別的核心在哪？在權限。

網頁版 Claude 是隔著櫃檯的。你貼什麼它看什麼，會回答、寫初稿，甚至做出單頁小工具，但碰不到你的電腦。

(單頁小工具叫 Artifacts，是聊天視窗裡直接跑的小網頁。)

Claude Code 是你請進家裡的。最早只有終端機版本，現在也有<a href="https://claude.ai/download" rel="noopener">桌面 App</a> 跟<a href="https://claude.ai/code" rel="noopener">網頁版</a>，不用打指令也能用。它看得到你指定資料夾裡的檔案，能自己開檔案改內容，也能執行指令。

所以它能把「做一個網站」從頭到尾做完，而不是給你一堆程式碼要你自己想辦法。

我自己的真實分工：想事情、寫文案初稿、問概念用網頁版 Claude，做東西用 Claude Code。

你現在看的這個網站(136 篇文章)、每天 20:00 自動發 Threads 的機器人、幫全家管行程的 LINE 機器人，全是 Claude Code 做的。

網頁版做不了這些事，它碰不到你的電腦。

### 3 個情境：什麼時候該用哪個？

用我從 2026 年 4 月中雙開到現在的經驗，拆成 3 個情境：

1. 情境 1，問問題、寫東西、想點子 → 網頁版 Claude。「幫我看這段文案哪裡怪」「解釋一下什麼是 API」「幫我想 10 個標題」。這種一來一往的對話，開瀏覽器最快，手機上也能用。
2. 情境 2，要產出會留在你電腦裡的東西 → Claude Code。「做一個記帳網頁」「把這 50 個檔案重新命名」「每天自動抓資料發文」。判斷法很簡單：如果做完之後應該有個檔案或網站存在，就是 Claude Code 的事。
3. 情境 3，不確定算哪種 → 先丟網頁版聊。把想法聊清楚(要做什麼、給誰用、長怎樣)，再把聊完的結論貼給 Claude Code 動工。我做這個網站的第一版就是這樣：網頁版聊了一小時的規劃，Claude Code 一個下午做出來。

一個誠實的邊界：網頁版真的什麼都做不了嗎？其實 Artifacts 能做出「單頁小工具」，像測驗頁、計算機這種。

如果你只需要這種等級，還不用學 Claude Code。

但 Artifacts 做不了多頁網站，碰不了你的檔案，也沒辦法定時自動跑。

要跨過這條線，就是 Claude Code 的地盤。

### 錢怎麼算？(一份訂閱兩邊通用)

最多人問的其實是這題：「我訂了 Claude Pro，用 Claude Code 要再付一次嗎？」

不用。Pro 訂閱(US$20/月，2026-08 查，以官方頁面為準)同時涵蓋網頁版跟 Claude Code，同一個帳號登入就好。

- <mark><strong>只想聊天問答</strong></mark>：免費版 Claude 就能開始，不用花錢。
- <mark><strong>想開始用 Claude Code 做東西</strong></mark>:Pro US$20/月，兩邊都能用。我自己從 Pro 用起(後來量大才升 Max 5x)，從 2026 年 4 月中開始做出 10 個自動化工具。
- <mark><strong>用量很大(整天掛著跑)</strong></mark>：有更高階的 Max 20x(US$200/月)。新手不用考慮，額度撞到再說。

注意一件事：兩邊共用的是「訂閱跟用量額度」，不是聊天紀錄。

網頁版聊的內容，Claude Code 不會自動知道，要自己把結論帶過去。

這是我一開始想錯的地方。

我以為兩邊是同一個對象，其實是同一顆大腦的兩次見面。

訂閱一份就好：免費版聊天 → Pro US$20 解鎖 Claude Code → 額度不夠再看 Max。

### Summary

Claude 跟 Claude Code 是 Anthropic 的兩個入口，用同一系列模型：Claude 是瀏覽器聊天(問答、寫作、單頁小工具)，Claude Code 是電腦端工具(終端機、桌面 App、網頁版都有，能讀寫檔案、執行指令、把整件事做完)。不是普通版跟進階版，是「坐櫃檯」跟「進你家」的差別。何時用哪個：對話用網頁版、要產出留在電腦裡的東西用 Claude Code、不確定就先聊再動工。費用：免費版可聊天，Pro US$20/月(2026-08)一份兩邊通用不用付兩次。想動手，下一步接 Windows 安裝那篇 30 分鐘上手。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。

### FAQ

**Q: Claude 跟 Claude Code 差別是什麼？**

同一家公司(Anthropic)、同一系列 AI 模型，差在身體：Claude 是網頁/App，用聊天的方式互動，碰不到你的電腦;Claude Code 是裝在電腦裡的工具（終端機、桌面 App、網頁版都有），能讀寫你的檔案、執行指令、把任務整件做完。一句話：同一顆大腦，一個坐櫃檯跟你聊，一個進你家幫你做事。

**Q: 訂了 Claude Pro,用 Claude Code 要另外付錢嗎？**

不用。Pro 訂閱(US$20/月，2026-08 查)同時涵蓋網頁版 Claude 跟 Claude Code，同一個帳號登入即可，共用同一份用量額度。免費版帳號可以用網頁聊天，但 Claude Code 需要 Pro 以上的訂閱(或改用 API 按量計費)。

**Q: Claude Code 用的模型跟網頁版一樣嗎？**

一樣是 Claude 系列模型(Fable / Opus / Sonnet 等)。所以不是「Claude Code 比較聰明」，聰明程度相同，差在 Claude Code 有權限動手：讀寫檔案、執行指令、串接服務。現在除了終端機，還有桌面 App 跟網頁版(claude.ai/code)可以用。網頁版 Claude 像隔著玻璃給建議，Claude Code 是捲起袖子下場做。

**Q: 網頁版 Claude 可以做網站嗎？**

可以做「單頁小工具」：網頁版的 Artifacts 功能能在聊天視窗裡直接做出測驗頁、計算機這類單頁互動網頁。但它做不了多頁網站、不能碰你電腦的檔案、不能部署上線、也不能定時自動執行，要做真的能上線的網站或自動化，就需要 Claude Code。

**Q: 非工程師該從 Claude 還是 Claude Code 開始？**

先用免費的網頁版 Claude 把「怎麼把需求講清楚」練熟(1-2 個月)，想開始做東西再升 Pro 用 Claude Code。如果你已經很會用 ChatGPT 或網頁版 Claude，可以直接跳 Claude Code，我自己是非工程師，照這條路 4 個月做出 136 篇文章的網站跟 13 個自動化工具。

---

## AI 寫程式工具怎麼選？實測 4 款分工比較

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-coding-tools-compare.html
> Claude Code、Codex、ChatGPT、Cursor 怎麼選？我用 AI Agent 架站與改稿 3 個月後，把親自用過的分工、沒用過的界線，以及 30 秒選擇方法攤開。

短答給趕時間的人：不用先找最強的 AI。先問這件事要不要碰你電腦裡的檔案。只要討論、找方向、寫初稿，用 ChatGPT 或網頁版 Claude 就好；要讀專案、改檔案、跑指令，再選 Claude Code、Codex 或 Cursor 這類會動手的 AI 工具。三個都能動手，差別已經不是「誰會不會改程式碼」，而是你想從終端機、桌面版，還是編輯器開始。我不會寫程式，這 3 個月的實際分工是 Claude Code 負責網站長期施工，Codex 負責第二輪審查與局部任務，聊天工具負責先把問題想清楚。Cursor 我沒有實際使用，所以只列官方能力，不把資料整理冒充實測。

這不是一篇工具跑分榜。

我是完全不會寫程式的非工程師。這 3 個月，我用 Claude Code 維護這個網站和自動化工具，後來也開始把局部改稿、檢查與不同做法交給 Codex。

真正讓我卡住的，不是哪一個模型分數最高，而是同一件事到底該丟進聊天視窗、Claude Code，還是 Codex。

用過的部分，我寫自己的工作分配；沒用過的 Cursor，我只照官方功能說明，不假裝有使用心得。

下面先用 3 個問題把選項縮小，再看我目前怎麼分工。

### 30 秒選擇法：先回答 3 個問題

1. 問題 1：這件事要不要碰你電腦裡的檔案？只需要討論、查資料、寫初稿，ChatGPT 或網頁版 Claude 就夠。需要讀專案、改檔案、跑測試或執行指令，才需要 Claude Code、Codex、Cursor 這類會動手的 AI 工具。
2. 問題 2：你要一次做完，還是長期維護？只做一個小工具，可以先用聊天工具的畫布或 Artifacts 試做。網站、自動化、固定產出這類會一直改的東西，要把規則、檔案和驗證留在同一個專案裡，AI 工具才不會每次從零開始。
3. 問題 3：你想從哪個工作入口開始？已經習慣程式編輯器，可以看 Cursor；偏好在專案資料夾裡直接交辦，可以看 Claude Code 或 Codex。現在三者都能讀檔、改檔和跑指令，選擇重點是工作入口、既有訂閱，以及你願不願意把專案規則整理好。

先看工作要不要碰檔案，再看你想從哪個入口交辦。工具名稱放到最後，選擇會簡單很多。

三題走完，通常只剩一兩個合理選項，不必先把每一套功能研究完。

我以前會卡住，是因為直接比較工具，卻沒有先說清楚這件工作最後要交出什麼。

### 我現在怎麼分工？先看工作，不看跑分

表裡的「我的用法」是我的工作現況，不是全工具的客觀排名。

Claude Code 目前仍是主力。不是因為 Claude Code 永遠最強，而是我的網站規則、檔案結構和長期設定已經放進同一個專案，交辦時不用每次重新解釋。Claude Code 現在可從終端機、編輯器、桌面版與網頁使用，這裡寫的是我的入口，不是完整介面清單。

這個網站（136 篇文章）和 13 個自動化工具，是我用會動手的 AI 工具一段一段做出來的。

Codex 現在是第二條路。我會把局部改稿、程式檢查或同一需求的另一種做法交給 Codex，再回頭比對兩邊結果。第二套工具對我最有價值的地方，不是多一個聊天視窗，而是多一雙會讀檔、會驗證的眼睛。

ChatGPT 和網頁版 Claude 我仍當顧問用。事情還沒想清楚時先在聊天視窗拆問題；要真的改網站，再把定案交給會動手的 AI 工具。

Cursor 我沒有實際使用。<a href="https://docs.cursor.com/agent" rel="noopener">官方文件</a>顯示 Agent 模式（自動執行模式）也能探索專案、修改多個檔案和執行指令，所以不能再簡化成「Cursor 只適合補程式碼」。這一欄只能當入口差異，不是我的實測結論。

OpenAI 的 <a href="/newbie-pitfalls/claude-code-vs-codex.html">Codex 實測對照</a>已經另外整理。現在我會同時用 Claude Code 和 Codex，選擇不只看訂閱哪一家，也看這次需要延續既有專案脈絡，還是想換一套工具重新檢查。

Claude Code 和 Codex 都能讀取、修改並執行本機專案，但操作介面、規則檔與工作延續方式不同。對我來說，兩套工具比較像兩條施工路線，不是完全相同的替代品。

Google 的 <a href="https://github.com/google-gemini/gemini-cli" rel="noopener">Gemini CLI（終端機 AI 工具）</a>也仍在維護，官方專案提供檔案操作、終端機指令與 MCP。

我目前沒有 Gemini CLI 的實際使用經驗，所以不把 Gemini CLI 塞進推薦排名。

這篇要回答的是我怎麼選，不是把每個有名字的工具都湊進表格。

### 四篇延伸對照，你現在該看哪一篇？

- <mark><strong><a href="/newbie-pitfalls/claude-vs-claude-code.html">Claude 跟 Claude Code 差別</a></strong></mark>：最多人混淆的一組，同一家公司，名字只差一個字。搞不清楚「我訂的 Pro 到底涵蓋哪個」就看這篇，3 分鐘解惑。
- <mark><strong><a href="/newbie-pitfalls/claude-code-vs-chatgpt.html">Claude Code vs ChatGPT</a></strong></mark>：已經會用 ChatGPT 的人看這篇，講的是為什麼還要多學一個，還有兩個怎麼分工。我 80% 的時間是先用 ChatGPT 想策略，再交給 Claude Code 實作。
- <mark><strong><a href="/newbie-pitfalls/claude-code-vs-cursor.html">Claude Code vs Cursor</a></strong></mark>：兩個都能動手改專案，但工作入口不同。那篇保留我當時從非工程師角度整理的差異；Cursor 的現行能力仍要以官方文件為準。

如果你已經在 Claude Code 和 Codex 之間猶豫，直接看 <mark><strong><a href="/newbie-pitfalls/claude-code-vs-codex.html">Claude Code vs Codex 實測</a></strong></mark>。那篇談的是我兩邊都用過後，實際怎麼分配工作。

這四篇不用全部看完。

挑你現在最混亂的那一組就好。看完回到這頁，再決定下一件工作從哪個入口開始。

### 選工具最常犯的 3 個錯誤

1. 一直問哪個 AI 最強：「最強」沒有固定答案。換成「我要讓 AI 讀這個網站專案、改完後自己跑檢查」，需要的能力和入口才會浮出來。
2. 只看功能表，不看自己的工作方式：同樣能改檔案，有人想留在編輯器，有人想直接對資料夾交辦。入口不順，再多功能也只會放著。
3. 把資料整理寫成實測：我沒有用過 Cursor 和 Gemini CLI，就不替這兩套工具下好不好用的結論。官方能力可以查，使用感受不能靠想像補完。

前兩個錯誤我都犯過。

最浪費時間的不是選錯一次，而是每看到一個新工具就重做整套工作方式。

先拿下一件真實工作試一套：能交付、能驗證、下次接得回來，再決定要不要長期用。

### Summary

AI 寫程式工具不用先比誰最強。第一步先看工作要不要碰本機檔案：討論、找方向、寫初稿，用 ChatGPT 或網頁版 Claude；要讀專案、改檔案、跑測試與指令，再看 Claude Code、Codex、Cursor 這類會動手的 AI 工具。現在三者都能動手，差別主要在工作入口、既有訂閱與專案規則。我的實際分工是 Claude Code 負責網站長期施工，Codex 負責第二輪審查與局部任務，聊天工具負責先把問題想清楚。Cursor 與 Gemini CLI 沒有實際使用，所以只列官方能力，不下使用結論。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **Cursor**：內建 AI 的程式編輯器，跟 Claude Code 同類，但走「圖形介面編輯器」路線而非終端機路線。
- **Codex**：OpenAI 的程式型 AI 代理，跟 Claude Code 同類：能讀寫你的檔案、跑指令、動手把功能做出來。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **MCP（Model Context Protocol）**：讓 AI 工具安全連接外部服務（瀏覽器、行事曆、資料庫）的通用接口標準，由 Anthropic 推出。
- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。

### FAQ

**Q: AI 寫程式工具這麼多，非工程師該怎麼選？**

先問工作要不要碰你電腦裡的檔案。只要討論、查資料或寫初稿，用 ChatGPT、網頁版 Claude 這類聊天工具；需要讀專案、改檔案、跑測試或執行指令，再選 Claude Code、Codex、Cursor 這類會動手的 AI 工具。三者現在都能動手，差別主要是終端機、桌面版或編輯器等工作入口，以及你的既有訂閱和專案規則。

**Q: Claude Code、Cursor、ChatGPT 可以只用一個嗎？**

可以，但先分清楚你選的是聊天工具，還是會動手的 AI 工具。我的配置不是平均使用每一套：Claude Code 負責網站長期施工，Codex 負責第二輪審查與局部任務，ChatGPT 和網頁版 Claude 負責把問題想清楚。Cursor 我沒有實際使用，所以不把官方功能整理寫成心得。

**Q: 免費能用到什麼程度？什麼時候該付費？**

先用聊天工具的免費方案練習把需求說清楚，也可以用官方提供的免費或試用額度測一個小任務。當你需要 AI 長期讀取同一個專案、修改多個檔案、執行測試或自動化流程，再評估付費的 AI 執行工具。不要只看月費，還要看用量限制、模型成本與你是否真的會把這套工具接進工作。

**Q: 為什麼工程師都推 Cursor，這裡卻推 Claude Code？**

因為每個人的工作入口不同。我不會寫程式，Claude Code 又已經累積這個網站的規則與專案脈絡，所以 Claude Code 目前是我的主力；這不等於 Cursor 只能給工程師。Cursor 官方的 Agent 模式（自動執行模式）也能探索專案、修改多個檔案和執行指令。我沒有實際使用 Cursor，因此只說入口差異，不替 Cursor 下使用結論。

---

## AI Agent 怎麼用？非工程師第一次上手 5 步

> Source: https://www.coolkidlab.com/newbie-pitfalls/how-to-use-ai-agent.html
> AI Agent 怎麼用？非工程師第一次上手 5 步：挑一件小事、裝工具、用「背景+目標+限制」下任務、邊看邊修、存成工作流。另附第一次該給哪些權限，以及三個階段。

短答給趕時間的人：AI Agent(會動手做事的 AI)的用法跟 ChatGPT 不同。你不是問問題，是交辦任務。第一次上手 5 步：(1) 挑一件「每天做、步驟固定、做錯也沒關係」的小事 (2) 裝一套 agent 工具(我用 Claude Code) (3) 用「背景+目標+限制」三段式把任務講清楚 (4) 在旁邊看、該答就答、走歪就暫停 (5) 做成功後把整套指令存起來，變成可重複的工作流。第一個任務 30-60 分鐘內可完成。

「ai agent 怎麼用」這個詞，開始有人搜進 Lab。

我回頭看自己寫過的：AI Agent 是什麼(定義)、可以做什麼(案例)。

偏偏沒寫「所以我現在到底要按哪裡？」

對第一次動手的人，這才是真正卡住的地方。

這篇就補這個洞。一個完全沒寫過程式的人，第一次用 AI Agent 的操作順序。

我用自己 2026 年第一次上手的真實過程當範例，包含當時卡住的地方。

### 第一次用 AI Agent，操作上跟 ChatGPT 差在哪？

使用 ChatGPT 要學的是怎麼問，用 AI Agent 你練的是怎麼交辦：給目標、給限制，讓它自己拆解步驟動手。

用 ChatGPT 的動作是「問」：你問、它答，你自己動手。

用 AI Agent 的動作是「派」：你給一個目標，它自己拆步驟、動手做，最後回報結果。

這個差別決定了整個用法。

所以要練的東西也換了，不是問問題的技巧，是怎麼把一件事交代清楚。

所以「怎麼用」的答案是什麼？不是先學指令，是先想清楚你要派什麼事給 AI。

我看過最多人卡住的點就在這裡。

工具裝好了，盯著畫面不知道要打什麼，因為沒有事先想好要派的事。

ChatGPT 你練的是「怎麼問」，AI Agent 你練的是「怎麼交辦」。

### AI Agent 怎麼用？第一次上手的 5 個步驟

五步：挑一件做錯也不會怎樣的小事、裝一套工具、用「背景＋目標＋限制」下任務、在旁邊看著隨時喊停、成功後把做法存起來反覆使用。

以下是我會給 2026 年 4 月中的自己的版本。

工具用 Claude Code 示範(Pro 訂閱 US$20/月，2026-07)，但這 5 步換成其他 agent 工具一樣成立：

1. 第 1 步，挑一件小事當第一個任務。標準三條：每天或每週都在做、步驟固定、做錯了也不會怎樣。例如把一個亂糟糟的資料夾按日期整理、把 20 個檔案重新命名、做一個單頁的個人連結頁。不要挑「做一個完整網站」，第一次就挑大的，卡住了你分不清是工具問題還是任務太大。
2. 第 2 步，裝工具。我用 Claude Code:Windows 的話照我的安裝實錄走，4 步指令、30 分鐘內裝完，3 個常見的雷那篇都有解法(文末相關文章有連結)。裝完在終端機(那個黑色的指令視窗)打 claude 能進到對話，就算完成。
3. 第 3 步，用「背景+目標+限制」下第一個任務。背景：「桌面上有個叫 photos 的資料夾，裡面 200 多張照片檔名很亂」。目標：「幫我按拍攝月份分成子資料夾」。限制：「先列出你的計畫給我看，我說 OK 再動手;不要刪除任何檔案」。這三段講清楚，成功率遠高於一句「幫我整理照片」。
4. 第 4 步，在旁邊看，該答就答、走歪就暫停。Agent 做事過程會問你問題(「發現 30 張沒有日期資訊，要放進『未分類』嗎？」)，大方回答就好，會問代表 agent 在確認而不是壞掉。看到方向不對，直接打字說「停，不是這樣，我要的是⋯」。你不是在打斷它，是在把方向拉回來。我第一次用的時候不敢暫停，看著東西越改越歪，後來才知道隨時可以介入。
5. 第 5 步，成功之後，把這次的講法存起來。把你這次「背景+目標+限制」的完整訊息存成筆記，下次同類任務直接改幾個字重用，這就是工作流(workflow)的雛形：設定一次，重複使用。做到這步，你已經從「用 AI」跨到「用 AI Agent」了。

時間感：第 1 步想清楚 10 分鐘，第 2 步安裝 30 分鐘(只需一次)，第 3 到第 5 步的第一個任務，20-30 分鐘。

第一天總共一小時出頭。之後每次派任務只要幾分鐘。

### 第一次用 AI Agent 最常卡在哪三個地方？

卡住的通常不是技術：不敢讓它碰自己的檔案、它反問時愣住、第一次就要求太多。三個都是心理關卡。

工具會裝，步驟會抄。真正讓人放棄的，是這 3 個心理關卡：

- <mark><strong>不敢讓它碰自己的檔案</strong></mark>。解法是第一個任務用「複製出來的測試資料夾」做，原始檔案另外備份。我第一次也是先拿一個丟了也不心疼的資料夾練習，確認動作可以預期之後，才敢派正式的事。
- <mark><strong>它問問題時愣住</strong></mark>。agent 中途問你「A 還是 B？」很正常，那是在跟你再確認一次，不是出錯。用你回答同事的方式回答就好，講人話，不用講「程式話」。
- <mark><strong>一次要求太多</strong></mark>。「幫我做網站，要有會員系統跟金流」這種第一天必炸。拆小：今天先做一頁、明天加第二頁。Agent 擅長把一件事做完，不擅長讀你心裡那張沒講出來的大藍圖。

### 第一個任務長什麼樣？我自己的真實範例

我的第一個任務是一頁瀏覽器打得開的問答測驗，40 分鐘就能做完，過程中它問了我三個問題。

2026 年我第一次用 Claude Code，派的任務是「做一個能在瀏覽器打開的問答測驗頁」。

用上面的三段式。背景是我完全不會寫程式，要給朋友玩的小測驗。

目標是一頁網頁，5 題選擇題，做完顯示結果。

限制是檔案放在桌面的 quiz 資料夾，做完教我怎麼打開。

過程中 Claude Code 問了我 3 個問題(題目內容、要不要計分、顏色喜好)，40 分鐘後桌面出現一個雙擊就能玩的網頁。

那次之後我照第 5 步把講法存下來。

同一套流程後來長成你現在看的這個網站(136 篇文章)、每天 20:00 自動發文的 Threads 機器人，還有幫全家管行程的 LINE 機器人。

全部從那個小測驗頁開始。

完整過程我寫在<a href="/newbie-pitfalls/claude-code-beginner-make-website.html">「第一次用 AI 做網站」那篇</a>。

下一站：如果你做完了第一個任務，想看看別人都拿 AI Agent 做什麼，可以接「AI Agent 可以做什麼？10 個真實案例」，挑下一個目標。

想直接照抄現成的自動化，Workflows 圖書館 10 套全部公開。

### 第一次用 AI Agent，該給它哪些權限？

第一個任務挑一個全新的專案，不要拿現有的重要檔案開刀。做壞了整個刪掉重來，成本很低。

以 Claude Code 為例，它動手前會問你可不可以，那是刻意設計的閘門，不是它不會做。

新手最常見的兩個極端：一種是每次都按拒絕，結果什麼都做不成;另一種是嫌煩全部放行，等於把整台電腦權限都交出去。

我自己的分法是這樣。

- 讀寫檔案：只開放這次要做的那個專案資料夾，不要整顆硬碟;推上 GitHub 之後就算改壞了，拉回上一版的成本也不高
- 跑指令：看不懂就叫它先用白話文解釋這行會做什麼
- 帳號密碼：不給。真的需要登入的服務，我自己登入好再讓它接手畫面
- 網路連線：查資料可以，但要它把來源網址列出來，方便我自己去對

一直按可不可以按到煩了，再去調設定，做法在<a href="/newbie-pitfalls/claude-code-permissions.html">權限設定那篇</a>。

密碼到底能不能給、分幾層給，我另外寫了<a href="/newbie-pitfalls/ai-agent-give-passwords.html">一篇專門講這件事</a>。

順序不要顛倒。先在錯得起的範圍裡練到動作可以預期，再決定要不要放寬。

### 用到什麼程度算會用了？三個階段

第一階段是派得動一次性的小任務，第二階段是同一套講法存起來重複用，第三階段是它自己定時跑、你只看結果。

多數人卡在第一跟第二階段中間。

區別不在工具更強，而是有沒有把成功那次的做法留下來。

每次都重新打一段話，第五次跟第一次一樣慢;存成範本改幾個字，第五次只要一分鐘。

第三階段才是真正省時間的地方，也是<a href="/newbie-pitfalls/ai-daily-thread-auto-poster.html">每天自動發文的機器人</a>那類東西的起點。

這三階段講的是自動化這條線。做產品或做網站是另一條路，不用套這張階段表。

不用急著跳。第一個任務做完、存下做法、明天用同一份範本再跑一次，你就已經在第二階段了。

### Summary

AI Agent 怎麼用？核心是把動作從「問」換成「派」：你給任務，AI 動手做完。第一次上手 5 步：(1) 挑一件每天做、步驟固定、做錯沒關係的小事 (2) 裝工具(Claude Code，Windows 30 分鐘) (3) 用「背景+目標+限制」三段式下任務 (4) 有問題就答、走歪就暫停 (5) 成功後把講法存成可重複的工作流。最常卡的三點：不敢讓它碰檔案(用測試資料夾練習)、被問問題時愣住(講人話回答)、一次要求太多(拆小)。我的第一個任務是 40 分鐘做出一頁測驗網頁，4 個月後長成 136 篇文章的網站跟 13 個自動化工具。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。
- **AI 工作流（AI workflow）**：把一件事的多個步驟串成「AI 自動跑完」的流程，例如「抓新聞 → 寫摘要 → 排版 → 發文」全自動，人只看結果跟把關。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。

### FAQ

**Q: AI Agent 怎麼用？第一步是什麼？**

第一步不是裝工具，是先挑好第一個任務：一件每天或每週都在做、步驟固定、做錯也不會怎樣的小事(整理資料夾、批次改檔名、做一頁小網頁)。任務想好了再裝工具(例如 Claude Code)，然後用「背景+目標+限制」三段式把任務講清楚交給 agent。第一個任務 30-60 分鐘內可完成。

**Q: 不會寫程式可以用 AI Agent 嗎？**

可以，我自己就是完全不會寫程式的非工程師。用 AI Agent 考的不是程式能力，是「把事情講清楚」的能力：你用中文描述背景、目標、限制，agent 負責動手。我 4 個月做出 136 篇文章的網站跟 13 個自動化工具，全程沒寫過一行程式，卡住的時候就把錯誤訊息貼回去問。

**Q: 第一個任務該挑什麼？**

挑「小、固定、可失敗」的：把亂的資料夾按日期整理、把幾十個檔案批次重新命名、做一個單頁的個人連結頁或小測驗。判斷標準是做壞了也不心疼、30-60 分鐘能看到結果。不要挑「做一個完整的電商網站」，第一次就挑大任務，卡住時你分不清是工具問題還是任務太大。

**Q: 用 AI Agent 該用什麼工具開始？**

非工程師我推薦 Claude Code(我自己在用的)：終端機介面但互動是打字對話，Pro 訂閱 US$20/月(2026-07)，Windows 照安裝教學 30 分鐘上手。會寫程式的人也可以考慮 Cursor(編輯器型)。工具其實是次要的，5 步流程(挑小事、裝工具、三段式下任務、邊看邊修、存成工作流)換哪套工具都成立。

**Q: AI Agent 的用法跟 ChatGPT 差在哪？**

動作不同：ChatGPT 是「問」，你問它答，動手的是你;AI Agent 是「派」，你給目標，它自己拆步驟、動手、回報。所以要練的技能也不同：用 ChatGPT 練怎麼問問題，用 AI Agent 練怎麼交辦任務(背景+目標+限制講清楚)。已經會用 ChatGPT 的人上手 agent 會快很多，因為「講清楚」的基本功是通用的。

**Q: 第一次用 AI Agent 要給它哪些權限才安全？**

第一個任務挑一個全新的專案，不要拿現有的重要檔案開刀，做壞了整個刪掉重來;讀寫權限只開放那個專案資料夾，不要整顆硬碟。跑指令看不懂就叫它先用白話文解釋這行會做什麼。帳號密碼不要給，需要登入的服務自己登入好再讓它接手。全部按拒絕會什麼都做不成，全部放行等於把整台電腦權限交出去，兩個極端都不對。

**Q: 用 AI Agent 用到什麼程度算會用了？**

三個階段：派得動一次性的小任務是第一階段;把成功那次的「背景＋目標＋限制」存成範本、同類任務改幾個字重用是第二階段;讓它定時自己跑、你只看結果是第三階段。多數人卡在第一跟第二階段中間，區別不是工具變強，是有沒有把成功那次的做法留下來。這張階段表講的是自動化這條線，做產品或網站是另一條路。

---

## Threads 機器人兩個「沒報錯卻沒發」的靜默坑

> Source: https://www.coolkidlab.com/newbie-pitfalls/threads-auto-post-silent-fails.html
> Threads 自動發文機器人穩定跑兩個多月，最難抓的是「沒報錯卻也沒發」的靜默坑：long-lived token 約 60 天悄悄失效、Graph API 要先建 container 再 publish。

我用 Claude Code 做了一個每天定時自動發 Threads 的小機器人（機器人＝一段幫你自動做事的程式），穩定跑了兩個多月。

這段時間遇過的問題裡，最難抓的不是那種會跳紅字報錯的。

報錯的至少你知道哪裡壞了。最麻煩的是「<mark><strong>沒報錯，但也沒發</strong></mark>」的靜默失敗。

某天你滑到自己的 Threads，才發現它已經好幾天沒動靜，程式卻一句錯都沒噴。

這種靜默失敗特別花時間，因為你連從哪查起都不知道。

這篇把我遇到的兩種靜默失敗，攤開來講。

一個是登入用的 token（token＝一組讓程式代你發文的通行碼）會悄悄過期，一個是 Threads 的發文方式不是一步到位。

兩個都有具體症狀、根因、修法。

讀完你會知道怎麼讓「沒報錯卻沒發」變成抓得到的東西。5 分鐘讀完。

### 靜默坑一：token 60 天悄悄過期，機器人從此不發也不報錯

先講答案：Threads 的 long-lived token（長效通行碼）大約 60 天就會失效。

而且失效那天不會跳任何錯。機器人照常跑，照常結束。就是沒真的發出去。

為什麼這個問題我最久才抓到？因為前 59 天都好好的，你完全不會防。

token 你可以想成「代替你發文的臨時通行證」。

Threads 給的這張證有效期約 60 天，到期後拿去發文，對方只會安靜地當沒看到，不會跟你說「你過期了」。

於是機器人每天照跑，你以為一切正常。

其實已經連續好幾天，貼了個寂寞。

修法兩步，照做就不會再被靜默掉：

1. Step 1，排一個「每週自動換新通行證」的小工作。token 在到期前是可以拿舊的去換一張新的，把這個「換新通行證」的動作（技術上叫 refresh token）設成每週自動跑，就永遠不會走到 60 天那條線。
2. Step 2，記下你上次換 token 的日期，設一個快到期前提醒你的鬧鐘（例如抓第 50 天，離 60 天大限還有緩衝）。就算自動換證哪天壞了，你也會在爆掉前收到提醒，而不是等某天滑到自己帳號才發現。

### 靜默坑二：Threads 發文不是一步，container 沒等好就 publish 會失敗

先講答案：Threads 的 Graph API（Graph API＝Meta 給程式用的官方發文介面）發文是「兩段式」。

先建一個裝內容的 container（容器），中間等它就緒，再 publish（正式送出）。

很多人直覺就一步 publish。

結果 container 還沒 ready，發文就失敗。

白話講：第一步你把貼文內容交給 Threads，它先幫你放進一個暫存的容器，回你一個容器編號。

這個容器不是瞬間就準備好的，需要一點點時間。

第二步你才拿那個編號說「這個，發出去」。

如果你第一步做完立刻做第二步、中間不等，容器還沒備好，Threads 就會失敗。

修法很簡單：在建 container 和 publish 中間，加一個大約兩秒的等待。

就這麼簡單。但沒人第一次會知道要等。

文件常常只給你兩個步驟，不會提醒你中間要停一下。加了這個等待，發文成功率就穩了。

### 真正的功課：怎麼讓「沒報錯卻沒發」變得抓得到？

先講答案：靜默失敗之所以難，是因為不留痕跡。

所以解法只有一個。逼程式留下痕跡。

在流程的每一步都加一行 log（log＝程式的執行紀錄，把「我做到哪、結果是什麼」寫下來），事後一對照就知道斷在哪。

我這兩次會卡那麼久，共同原因就是「中間沒紀錄」。

token 過期那次，我只在最後看有沒有發出去，沒發就一頭霧水。

後來我在「拿到 token」「建 container」「publish 回應」每一步都印一行紀錄。

下一次一出事，我一眼就看到是 token 那步回了空的，馬上抓到重點，不用再從頭掃一次。

這也是我從 2026 年 4 月中做自動化到現在，最大的體會。

會顯示錯誤的問題其實好處理，因為錯誤逼你當下處理。

真正拖垮你的是「安靜地壞掉」。

所以任何無人看管、自己在背景跑的東西，都要先想好一件事：哪天默默死了，我怎麼會知道？

### 一句話總結，跟這篇的位置

Threads 機器人的兩種靜默失敗，整理如下。

token 約 60 天悄悄過期，做法是排每週 refresh 加 50 天提醒。

發文要先建 container 等約兩秒再 publish，中間別急。抓靜默失敗的通用解法只有一個：每步加 log，逼程式留下痕跡。

這篇接在「每天 8 點自動發 Threads 的小機器人」那篇後面。

那篇講怎麼把機器人做出來，這篇講上線兩個多月後怎麼安靜地壞掉。

做出來只是起點，顧得住才算數。

同款「表面看起來沒事最危險」的教訓，我在別的地方也撞過：AI 幫我寫的內容看起來合理、其實是唬爛，帶最多流量的頁悄悄把整站的主題拖歪。都是沒有紅字，數據也不會馬上難看的那種壞法。

下一站，我會把 2026 年 4 月中以來做過的幾個自動化機器人遇過的問題，整理成一份總集。

### Summary

我做的 Threads 自動發文機器人穩定跑兩個多月，最難抓的是「沒報錯卻沒發」的靜默坑。坑一：long-lived token 約 60 天靜默失效，機器人照跑但沒真發，修法是排每週自動 refresh + 記錄換 token 日期、設個快到期提醒（例如第 50 天）。坑二：Threads Graph API 發文是兩段式，要先建 container 再 publish，中間沒等約兩秒、container 沒 ready 就會失敗。抓靜默失敗的通用解法：每一步加 log 逼它留痕跡，出事一眼定位。核心體會：會顯示錯的坑好處理，安靜壞掉的最致命，任何背景自動跑的東西都要先想好「它默默死了我怎麼會知道」。5 分鐘讀完。

### FAQ

**Q: Threads 機器人沒報錯卻不發文，是怎麼回事？**

最常見是 long-lived token（長效通行碼）到期了。Threads 的 token 約 60 天失效，而且失效不會跳錯，機器人照常跑完、就是沒真的發出去。修法：排一個每週自動 refresh token 的小工作（到期前拿舊的換新的），再記下換 token 日期、設個快到期提醒（例如第 50 天）當保險。並在每步加 log，才抓得到是哪一步靜默斷掉。

**Q: Threads Graph API 發文一直失敗怎麼辦？**

Threads 發文是「兩段式」，不是一步：先建一個裝內容的 container（容器），等它就緒，再 publish（送出）。如果建完 container 立刻 publish、中間不等，容器還沒 ready 就會失敗。修法：在建 container 和 publish 中間加約兩秒的等待。這步文件常常沒提醒，所以第一次做幾乎都會踩。

**Q: 為什麼「沒報錯」的失敗比會報錯的更難處理？**

因為它不留痕跡。會顯示錯的至少告訴你哪裡壞、逼你當下處理；靜默失敗是機器人照跑照結束，你根本不知道出事，可能好幾天後才偶然發現。解法是逼它留痕跡：在流程每一步加一行 log（執行紀錄），事後一對照就知道斷在哪一步，不用從頭猜。

**Q: 這些坑只有 Threads 會遇到嗎？**

不只。任何「無人看管、在背景自動跑」的東西都有靜默失敗的風險，像 IG 自動發文、排程爬蟲、定時通知都一樣。通行碼會過期、外部接口會有你沒預期的步驟、免費服務會默默改規則。做任何背景自動化前，先問自己一句：「它哪天默默死了，我怎麼會知道？」把這個答案（通常就是 log + 提醒）先做進去。

---

## Claude Code 裝好卻跑不了？Windows 6 步排查

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-install-failed.html
> Claude Code 裝好打 claude 卻跳「不是內部或外部命令」？不是裝壞，是環境沒接上。最快解法：irm 或 winget 一行重裝。想自己排查照 6 步檢查表走，10 分鐘定位。

短答給趕時間的人：先講最快的路。2026 年官方推薦的裝法是 native 一行安裝(下載獨立程式、不靠 Node.js 那層環境;PowerShell 跑 irm https://claude.ai/install.ps1 | iex)，舊教學會遇到的問題大半直接繞過。照舊教學用 npm 裝到一半卡住的，與其繼續 debug，直接改走這條，快的話幾分鐘就結束。堅持排查 npm 裝法的，照這個順序：(1) node -v 有沒有 22 以上 (2) npm -v 打得出版本嗎 (3) PowerShell 有沒有擋指令碼 (4) 安裝指令跑完有沒有紅字 (5) 重開終端機再打 claude (6) 還不行就跑 claude doctor。每步 1-2 分鐘，10 分鐘內能定位問題在哪一層。

我自己第一次裝的時候在第 5 步卡了半小時。

裝明明成功了，打 claude 卻說找不到命令，差點以為要重灌。

後來才知道只是沒重開終端機。

這篇把我裝機加上後來幫別人排查累積的問題，整理成一個照順序走就好的排查表。

### 先試最短路徑：官方 native 一行安裝(2026 推薦裝法)

2026 年的官方文件已經把 native 安裝列為推薦裝法。

一行指令下載獨立程式，不用 Node.js、不用 npm，裝完還會自動更新。

下面 6 步排查裡，有 4 步在查 Node 跟 npm 環境，而 native 裝法根本沒有這幾層。

所以裝不起來的人先試這行，快的話幾分鐘就結束了：

這裡有兩個地方要注意。

第一，要貼在 PowerShell 不是 CMD。

視窗提示字元開頭有 PS(像 PS C:\Users\你)才是 PowerShell，貼錯視窗會跳「irm 不是內部或外部命令」。

第二，裝完把終端機關掉重開，再打 claude --version 驗證。

這條走得通，下面 6 步都不用看。

走不通(通常是公司網路或權限鎖住)，或你就是要用 npm 裝法，再往下排查。

另一個選項是 WinGet，Windows 內建的套件管理工具：

WinGet 不用貼在 PowerShell，CMD 也能跑。裝完一樣重開終端機驗證。

irm 跟 WinGet 二選一就好，裝出來的東西一樣，只是入口不同。

### 先看症狀：你卡在哪一步？

不同症狀對應不同原因，先對號入座再往下跳：

### 第 1-2 步：Node.js 跟 npm 的地基

npm 這條裝法，要靠 Node.js(一個讓 JavaScript 在你電腦上執行的環境)來安裝。

官方要求 22 以上版本(2026-07 查，以官方文件為準;native 裝法完全不用這層，見第 0 節)。先打這兩行確認地基：

兩行都要吐出版本號(例如 v22.x.x 跟 10.x.x)才算過。

常見的失敗有哪三種？

第一，完全沒裝，去 nodejs.org 下載 LTS(長期支援版)，安裝時記得勾 Add to PATH。

第二，版本低於 22，重裝 LTS 蓋過去。

第三，node 有版本、npm 沒有，那是安裝時沒勾完整元件，重跑安裝檔選修復。

裝完 Node 一定要「關掉終端機重開」再驗證，舊視窗讀的是開啟當下的 PATH，看不到新裝的東西。

### 第 3-4 步：PowerShell 擋路跟權限紅字

Windows 特有的第一個問題：PowerShell 預設不給跑指令碼。

npm 相關的命令會吐一行字，「因為這個系統上已停用指令碼執行」。

解法是把執行原則放寬到 RemoteSigned(只放行本機指令碼，不影響安全性太多)：

跑完選 Y 確認，重開 PowerShell 再裝一次。

第二個問題是安裝時整片 EACCES 或 EPERM 紅字，那是權限問題。

自己的電腦好辦。用「以系統管理員身分執行」開 PowerShell 重跑。

公司電腦呢？多半是 IT 政策鎖住，別硬繞(可能違反公司規範)，直接找 MIS 開權限。

確認地基都好之後，安裝指令本體只有一行：

### 第 5-6 步：裝完的最後一哩(最多人卡在這)

安裝顯示成功、打 claude 卻說找不到命令，這就是我當初卡半小時的地方。

原因跟第 2 步一樣。

npm 全域安裝會把 claude 放進一個資料夾，這個資料夾要透過 PATH 讓終端機找到。而 PATH 是終端機「開啟當下」讀的。

解法一行都不用打。把終端機整個關掉、重開、再打 claude。

第一次啟動會跳出瀏覽器要你登入 Anthropic 帳號授權(OAuth，用你的帳號幫工具開門、不用把密碼給它)。

這步卡住通常是什麼原因？

可能是瀏覽器沒自動跳出(手動複製終端機顯示的網址)，也可能是<a href="/newbie-pitfalls/claude-code-api-key-login.html">公司網路擋了授權頁</a>，換個熱點試一次就能分辨。

全部都試過還不行呢？讓它自己體檢。

啟動後打 /doctor，它會列出安裝狀態跟問題。

或者把終端機的錯誤訊息整段貼給網頁版 Claude 問，排查自己的錯誤訊息，本來就是 AI 最擅長的事之一。

口訣：地基(node 與 npm)，路障(執行原則與權限)，重開終端機，最後 /doctor。9 成問題活不過第 5 步。排查到心累，回第 0 節換 native 裝法，一行指令繞過整條 npm 安裝路線。

### Summary

Claude Code 裝好卻跑不了，9 成是環境問題，不是安裝檔問題。打 claude 跳「不是內部或外部命令」，通常只要把終端機關掉重開就好，PATH 是開啟當下讀的。最快解法：改用 2026 官方推薦的 irm 一行安裝(PowerShell 跑 irm https://claude.ai/install.ps1 | iex)或 WinGet(winget install Anthropic.ClaudeCode，CMD 也能跑)，不經過 Node 與 npm，大半的雷直接繞過。要排查 npm 裝法照 6 步：(1) node -v 確認 22 以上 (2) npm -v 有版本號 (3) PowerShell 執行原則放寬到 RemoteSigned (4) EACCES 紅字用系統管理員重跑、公司電腦找 MIS (5) 裝完關掉終端機重開再打 claude (6) 還不行打 /doctor 自我體檢。每步 1-2 分鐘，10 分鐘內定位。

### 名詞解釋

- **native 安裝（原生安裝）**：官方提供的獨立安裝方式：一行指令下載完整程式，不依賴 Node.js 這類其他環境，裝完會自動更新。2026 年官方文件的推薦裝法。
- **Node.js**：讓電腦能執行 JavaScript 程式的基礎環境。Claude Code 的 npm 舊裝法才需要先裝它；2026 年官方推薦的 native 一行安裝不用。免費，從官網 nodejs.org 下載安裝。
- **npm**：裝 Node.js 時附帶的套件管理工具，像程式界的 App Store — 一行指令就能安裝各種工具。Claude Code 的舊裝法用它裝；現在官方推薦改用 native 一行安裝。
- **PATH（環境變數）**：系統的「去哪裡找程式」清單。指令打了卻顯示找不到，九成是程式所在的資料夾沒被加進這份清單。
- **執行原則（Execution Policy）**：Windows 的安全限制，預設擋下外來的指令檔。PowerShell 跳紅字常是它造成的，用系統管理員身分設定一次就解除。
- **PowerShell**：Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **OAuth（帳號授權登入）**：「用你的帳號幫工具開門」的標準流程：跳出瀏覽器讓你登入原服務，工具拿到授權後就能代你操作，全程不用把密碼交給工具。
- **LTS（Long Term Support）**：軟體的「長期支援版」，最穩定、官方維護最久的版本。下載 Node.js 時選綠色的 LTS 按鈕就對了。
- **WinGet**：Windows 內建的套件管理工具，像是應用程式商店的指令版。打一行指令就能安裝、更新、移除軟體，不用自己去網站下載安裝檔。

### FAQ

**Q: Claude Code 安裝失敗最常見的原因是什麼？**

9 成是環境問題：Node.js 沒裝或版本低於 22、npm 路徑沒進 PATH、PowerShell 執行原則擋住指令碼、或裝完沒重開終端機。真正安裝檔本身的問題很少見。照「node -v → npm -v → 執行原則 → 裝 → 重開終端機 → /doctor」的順序排查，10 分鐘內能定位。更快的路：改用官方 native 一行安裝(irm https://claude.ai/install.ps1 | iex)，不經過 Node/npm，這些雷大半直接消失。

**Q: 不想排查了，有沒有最快讓 Claude Code 裝起來的方法？**

有。2026 年官方推薦的 native 安裝法：打開 PowerShell(提示字元開頭是 PS 的那種視窗)，貼 irm https://claude.ai/install.ps1 | iex 按 Enter，裝完關掉終端機重開，打 claude --version 有版本號就完成。它下載的是獨立程式，不用 Node.js、不用 npm、還會自動更新，舊教學 6 步排查裡的 Node 與 npm 雷全都沒有。走不通通常只剩兩種原因：公司網路擋下載，或權限被 IT 鎖住。

**Q: npm 不是內部或外部命令怎麼辦？**

代表終端機在 PATH(系統的程式尋找路徑清單)裡找不到 npm。三個解法照順序試：(1) 還沒裝 Node.js → 去 nodejs.org 裝 LTS 版，安裝時勾 Add to PATH (2) 剛裝完 → 關掉終端機重開，PATH 是開啟當下讀的 (3) 裝了也重開了還是沒有 → 重跑 Node 安裝檔選「修復」。

**Q: PowerShell 顯示「因為這個系統上已停用指令碼執行」怎麼解？**

這是 Windows 的預設安全設定，不是壞掉。打 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 然後按 Y，把執行原則放寬到「本機指令碼放行」，重開 PowerShell 再裝一次就過。-Scope CurrentUser 只影響你自己的帳號，不動系統全域設定。

**Q: 裝完打 claude 卻說找不到命令？**

最常見的卡點，解法最簡單：把終端機整個關掉、重新開啟、再打一次 claude。原因是 npm 全域安裝把程式放進的資料夾，要靠 PATH 讓終端機找到，而 PATH 是終端機開啟當下讀取的，舊視窗看不到新裝的東西。我自己第一次裝就在這卡了半小時，差點重灌。

**Q: 公司電腦裝不了 Claude Code 怎麼辦？**

安裝時整片 EACCES 或 EPERM 權限紅字、或執行原則改不動，多半是 IT 政策鎖住了。不建議自己找方法繞過(可能違反公司資安規範)，直接找 MIS 說明需求請他們開權限或代裝。真的不行，可以先用網頁版 Claude(免安裝)練「把需求講清楚」的基本功，回家再用自己的電腦跑 Claude Code。

**Q: 打 claude 顯示「不是內部或外部命令」怎麼辦？**

這是最常見的卡點，不代表安裝失敗。意思是終端機在 PATH(系統找程式的清單)裡找不到 claude 這個程式。最常見的原因就是裝完沒重開終端機，把視窗整個關掉、重新開一個、再打 claude 試一次。重開了還是一樣，可能是安裝路徑沒有被自動加進 PATH，最簡單的處理方式是改用 irm 或 winget 重裝一次，讓安裝程式重新設定路徑。

**Q: WinGet 跟 irm 安裝差在哪？**

裝出來的東西一樣，差在入口。irm 那行要貼在 PowerShell 裡跑(CMD 不吃)，WinGet 則是 Windows 內建的套件管理工具，PowerShell 跟 CMD 都能用。兩個都是官方推薦的裝法，都不需要 Node.js，裝完都會自動更新。選哪個都行，公司電腦如果 PowerShell 被鎖，試試看 winget install Anthropic.ClaudeCode 能不能跑。

---

## Claude Code 中文亂碼？Windows 3 步修好

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-chinese-garbled.html
> Claude Code、Codex、VS Code 中文變 ??? 或 UnicodeEncodeError？不是 AI 的錯，是 Windows CP950 舊編碼。3 步修好，加碼 PYTHONUTF8 跟 PowerShell .ps1 假語法錯誤。

短答給趕時間的人：Windows 終端機預設用 CP950，也就是繁中的舊編碼。這張表跟現代程式預設的 UTF-8 對不上。中文於是變成 ??? 、方塊字，或者 Python 直接吐 UnicodeEncodeError。AI 沒寫錯，是環境編碼對不上。修法 3 步。第 1 步，終端機打 chcp 65001 切 UTF-8。第 2 步，Python 程式設 PYTHONIOENCODING=utf-8。第 3 步，檔案存對格式：.ps1 要存 UTF-8 with BOM、.env 絕對不要 BOM。

這是我的 Threads 自動發文機器人遇過最玄的一次。

程式邏輯全對，在 Claude Code 裡跑也正常，排程半夜自動跑就跳 UnicodeEncodeError。

查了很久才發現，同一支程式，誰來執行、用什麼編碼環境執行，結果會不一樣。

這篇把 Windows 中文編碼的三層問題一次講清楚，讓你少走我那幾個晚上的冤枉路。

這篇拿 Claude Code 當例子，但 Codex、Cursor、VS Code 的終端機都一樣——只要是在 Windows 上用 AI 寫程式的工具，碰到中文亂碼的原因跟修法都相同。

### 30 秒懂原理：中文為什麼會變亂碼？

文字在電腦裡是數字，「編碼」就是數字跟字的對照表。

全世界現在通用的表叫 UTF-8，但 Windows 繁中版的終端機，預設還在用 1990 年代的舊表 CP950。

兩邊用不同的表講話，中文就變成 ??? 或方塊。

像拿不同版本的密碼本對暗號。

所以亂碼有三個可能的案發現場，要分開查。

第一是終端機顯示層，程式輸出 UTF-8，終端機卻用 CP950 讀。

第二是 Python 執行層，程式要輸出中文，但執行環境的輸出編碼是 CP950。這時候就直接報 UnicodeEncodeError: cp950。

第三是檔案儲存層，檔案本身存錯格式，打開就是亂的。

下面三步一層一層解決。

### 第 1 步：終端機切 UTF-8(顯示層)

終端機看到亂碼，先打這行把當前視窗切到 UTF-8：

65001 就是 UTF-8 的代碼頁編號。

這行只對當前視窗有效，重開就恢復 CP950。

想一勞永逸有沒有辦法？有，Windows 11 可以改系統設定。

路徑是設定 → 時間與語言 → 語言與地區 → Windows 顯示語言 → 變更系統地區設定。

進去勾選「Beta: 使用 Unicode UTF-8 提供全球語言支援」，勾完重開機，全系統就預設 UTF-8。

注意少數老舊軟體可能因此顯示異常，遇到再取消勾選就好。

### 第 2 步：Python 設輸出編碼(執行層，排程掛掉 9 成是這個)

AI 寫的 Python 程式印中文，報 UnicodeEncodeError: cp950。

最典型的情況是「在 Claude Code 裡跑正常、丟去 Windows 排程就掛掉」，因為排程執行的環境沒有繼承你終端機的編碼設定。

最穩的解法是設環境變數，讓 Python 一律用 UTF-8 輸出：

設完永久版要重開終端機才會生效。

這一步就是我 Threads 機器人那幾個晚上的答案。

程式沒錯，錯在排程器執行時的環境是乾淨的 CP950，跟我平常開著 UTF-8 終端機測試的環境不同。

這就是 Windows 中文版的「在我電腦上可以跑」。

Python 3.7 之後還有一個更全面的環境變數叫 PYTHONUTF8。上面的 PYTHONIOENCODING 只管「印出去」的部分，PYTHONUTF8 設成 1 之後，讀檔案、寫檔案、印東西全部自動用 UTF-8，一次到位。

兩個都設不衝突。保險起見我兩個都設了，反正只要設一次就永久生效。

判斷口訣：手動跑正常、自動跑就掛掉 → 查環境變數。連手動跑都掛掉 → 先做第 1 步再做這步。

### 第 3 步：檔案存對格式(儲存層，兩條鐵律)

最後一層問題出在檔案本身的儲存格式。

UTF-8 有一個小變體叫「UTF-8 with BOM」，檔案開頭多 3 個隱形位元組當記號。

麻煩在哪裡？Windows 有些東西一定要這個記號，有些東西碰到就掛掉。

背下面兩條鐵律就夠了：

- <mark><strong>.ps1(PowerShell 指令碼)含中文 → 一定要 UTF-8 with BOM</strong></mark>。沒有 BOM，PowerShell 5.1 會用 CP950 去讀，中文註解全成亂碼、字串比對莫名失敗，還可能報一堆看起來像語法錯誤的 UnexpectedToken。但你的語法其實是對的。
- <mark><strong>.env(環境變數設定檔)→ 絕對不要 BOM</strong></mark>。很多程式讀 .env 是逐字元解析，開頭那 3 個隱形位元組會讓第一行的變數名稱多出看不見的字元，程式讀到的是「(BOM)API_KEY」而不是「API_KEY」，值永遠讀不到，而且錯誤訊息完全看不出原因。

叫 AI 動手時，直接把規則講清楚。

像是「這個 .ps1 存 UTF-8 with BOM」「.env 存 UTF-8 不要 BOM」。Claude Code 聽得懂，一次做對比事後找問題快得多。

用記事本另存新檔時要看清楚，編碼下拉選單裡的「UTF-8」是無 BOM，「具有 BOM 的 UTF-8」才有，別選反。

### 加碼：.ps1 報「語法錯誤」，為什麼真兇是編碼？

PowerShell 有一個獨家的雷，前面三步都修不到，值得單獨講。

AI 幫你寫了一個 .ps1，也就是 Windows 的自動化指令檔。裡面有中文註解，一跑就跳紅字「UnexpectedToken」或「指派運算式無效」。

看起來像程式寫錯了。

拿回去問 AI，AI 看了說語法沒問題，然後你們就開始鬼打牆，改語法改半天，越改越糊。

真相是這根本不是語法錯誤。

真兇是 PowerShell 5.1，也就是 Windows 本來就附的那一版。這一版用舊編碼表去讀你的 UTF-8 檔案，中文的位元組被拆爛。後面整段程式碼跟著解析壞掉。

這個雷特別麻煩的地方有兩個。

第一，報錯的行號常常指在真正出錯位置的「之後」幾行，你會一直盯著一段完全沒問題的程式碼看。

第二，錯誤訊息裡從頭到尾沒有「編碼」兩個字，只會一直跟你說語法錯。

- <mark><strong>「測試」變成「皜祈岫」這種看得出是字、但完全不通的字</strong></mark> → UTF-8 內容被舊編碼(Big5)誤讀。.ps1 含中文又沒存 BOM，就是這一型。
- <mark><strong>中文變成 ??? 或 � 方塊</strong></mark> → 方向相反，舊編碼的內容被當成 UTF-8 讀，常見於老工具輸出的檔案。認出方向，就知道該修檔案還是修終端機。

這個雷還有一個最坑新手的特性：在別人的電腦上明明跑得動。

我 2026-07-20 在自己機器實測過。

同一份含中文、沒有 BOM 的 .ps1，在我這台開過「Beta UTF-8」系統選項的電腦上直接跑得過，那個設定就是第 1 步結尾提過的。

而照 PowerShell 5.1 的讀檔規則，沒開這個設定的預設 Windows 就會出錯，我自己的出錯紀錄裡就躺著一筆這種紅字。

所以教學影片的截圖都正常、你照著做卻爆炸，原因是兩台電腦的系統編碼設定根本不同，跟你手殘沒關係。

修法有三種，挑一個就好。

最省事是直接叫 AI：「把這個 .ps1 重存成 UTF-8 with BOM」，Claude Code 一句話就處理掉。

手動派：記事本開檔，另存新檔，編碼選「具有 BOM 的 UTF-8」。

釜底抽薪派：請 AI 寫 .ps1 時要求註解全用英文，檔案裡沒有中文，存什麼格式都不會出事。

判斷口訣：.ps1 報語法錯但你看不出哪裡錯 → 先查編碼，再查語法。報錯那行往「前面」找，行號會騙人。

### Summary

Windows 中文亂碼分三層排查。第一層是顯示層，終端機預設 CP950，打 chcp 65001 切 UTF-8，想永久就開系統的 Beta UTF-8 選項。第二層是執行層，Python 報 UnicodeEncodeError: cp950，設 PYTHONIOENCODING=utf-8 環境變數，或者用 PYTHONUTF8=1 讓讀寫全自動 UTF-8（兩個都設更保險）。「手動跑正常、排程跑就掛掉」9 成是這個。第三層是儲存層，兩條鐵律：.ps1 含中文要 UTF-8 with BOM、.env 絕對不要 BOM。加碼一個 PowerShell 專屬雷：.ps1 報 UnexpectedToken 這種假語法錯誤，報錯的行號還會指錯位置，真兇是編碼。原理一句話：Windows 的舊編碼表跟現代程式的 UTF-8 對不上。Claude Code、Codex、Cursor、VS Code 終端機都適用，只要在 Windows 上用 AI 寫程式工具碰到中文亂碼，修法都一樣。

### 名詞解釋

- **編碼（encoding）**：電腦儲存文字的方式。Windows 中文環境常用 Big5，多數程式假設 UTF-8，兩邊對不上就變亂碼 — 所以資料夾、檔案建議用英文命名。
- **BOM（Byte Order Mark）**：檔案開頭 3 個隱形位元組的記號，用來標示「這是 UTF-8」。Windows 兩條鐵律：.ps1 含中文要有它、.env 絕對不能有它 — 存反了都會炸，而且錯誤訊息看不出原因。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **PowerShell**：Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。
- **環境變數（environment variable）**：放在系統層、不寫進程式碼的設定值，最常用來放 API 金鑰等機密，避免跟著程式碼被公開。
- **Python**：入門門檻最低的主流程式語言之一，資料處理、自動化、AI 領域的首選。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **Cursor**：內建 AI 的程式編輯器，跟 Claude Code 同類，但走「圖形介面編輯器」路線而非終端機路線。
- **Codex**：OpenAI 的程式型 AI 代理，跟 Claude Code 同類：能讀寫你的檔案、跑指令、動手把功能做出來。
- **VS Code**：微軟出的免費程式編輯器，很多人拿它搭 AI 外掛寫程式。Windows、Mac 都能裝，裡面有內建終端機可以跑指令。

### FAQ

**Q: Claude Code 輸出中文變成 ??? 或亂碼怎麼辦？**

先打 chcp 65001 把終端機切到 UTF-8(Windows 繁中終端機預設用 1990 年代的 CP950 舊編碼，跟現代程式的 UTF-8 對不上)。這行只對當前視窗有效。要永久生效，去系統設定開「Beta: 使用 Unicode UTF-8 提供全球語言支援」再重開機。AI 沒寫錯程式，是環境編碼的問題，重下 prompt 沒有用。

**Q: PowerShell 跑 .ps1 報 UnexpectedToken 或「指派運算式無效」,但語法明明是對的？**

9 成是編碼問題：.ps1 含中文但存成「UTF-8 無 BOM」，PowerShell 5.1 用舊編碼表讀，中文位元組被拆爛、後面整段解析跟著壞，就跳出看起來像語法錯誤的訊息。兩個辨認特徵：報錯行號常指在真正位置之後幾行、錯誤訊息從頭到尾不提編碼。修法：把檔案重存成 UTF-8 with BOM(記事本另存選「具有 BOM 的 UTF-8」，或者直接叫 AI 做)，或者整份 .ps1 都不用中文。

**Q: PowerShell 中文變成「皜祈岫」這種怪字，跟變成 ??? 是同一個問題嗎？**

同一種病，方向相反。看得出是字但完全不通(「測試」變「皜祈岫」)，那是 UTF-8 內容被舊編碼 Big5 誤讀，常見於 .ps1 沒存 BOM，要修的是檔案(補 BOM 或改存法)。變成 ??? 或 � 方塊，那是舊編碼的內容被當成 UTF-8 讀，或者終端機顯示不出來，要修的是終端機(chcp 65001)。先認方向再動手，不然會修錯邊。

**Q: Python 報 UnicodeEncodeError: cp950 怎麼修？**

設環境變數 PYTHONIOENCODING=utf-8，強制 Python 一律用 UTF-8 輸出。當次測試用 set PYTHONIOENCODING=utf-8。永久生效用 PowerShell 打 [Environment]::SetEnvironmentVariable('PYTHONIOENCODING','utf-8','User') 然後重開終端機。特別是「手動跑正常、排程自動跑就掛掉」的情況，排程環境不會繼承你終端機的編碼設定，一定要用環境變數解決。

**Q: 為什麼程式在 Claude Code 裡跑正常，排程執行就出現編碼錯誤？**

因為執行環境不同：你的終端機可能已經切了 UTF-8，但 Windows 排程器啟動程式時用的是乾淨的預設環境(CP950、沒有你設過的當次變數)。解法是把編碼設定寫進「使用者層級環境變數」(PYTHONIOENCODING=utf-8)，讓任何環境執行都吃得到。這是我的 Threads 自動發文機器人實際踩過的坑，查了好幾個晚上。

**Q: UTF-8 跟 UTF-8 with BOM 差在哪？哪些檔案該用哪個？**

BOM 是檔案開頭 3 個隱形位元組的記號。兩條鐵律：.ps1(PowerShell 指令碼)含中文一定要「with BOM」，否則 PowerShell 用舊編碼讀，會亂碼甚至報假的語法錯誤。.env(環境變數檔)絕對不要 BOM，否則第一個變數名稱會多出隱形字元、值永遠讀不到。記事本另存時「UTF-8」= 無 BOM、「具有 BOM 的 UTF-8」= 有，別選反。

**Q: Codex 或 Cursor 也會中文亂碼嗎？**

會。只要是在 Windows 上跑的 AI 寫程式工具，不管是 Codex、Cursor 還是 VS Code 的終端機，碰到中文亂碼的原因跟修法都跟 Claude Code 一模一樣。根源是 Windows 預設的 CP950 舊編碼跟程式預設的 UTF-8 對不上，這篇的三步全部適用，不用另外找教學。

**Q: PYTHONUTF8 跟 PYTHONIOENCODING 差在哪？**

PYTHONIOENCODING 只管「印出去」的部分，解決的是 Python 印中文跳 UnicodeEncodeError 的問題。PYTHONUTF8 是 Python 3.7 以後才有的，設成 1 之後讀檔、寫檔、印東西全部自動用 UTF-8，管得更全面。兩個都設不衝突，保險起見建議都設。

---

## Claude Code 額度多久重置？Pro 限制與 5 招

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-usage-limits.html
> Claude Code 額度每 5 小時重置，另有每週上限。教你從 Settings > Usage 與 /status 查看用量，分清額度限制與對話長度，附 5 個省法與實測誤報。

短答給趕時間的人：Claude Code 顯示 limit（用量限制），先到 Claude 帳號的 Settings > Usage（設定裡的用量頁）查看 5 小時與每週用量，終端機可先輸入 /status（狀態指令）確認登入與方案。Pro 的 5 小時用量會定期重置，另有固定時間重置的每週上限。用量限制跟單一對話太長是兩回事。前者要等重置、升級或啟用用量點數，後者用 /compact 壓縮對話或開新對話。下面先教你判斷撞到哪一層，再分享我實際中斷一次後留下的 5 個省法。

我自己常常在撞過上限 ， 但有一次特別奇怪。

螢幕跳出「You've hit your monthly spend limit」，當下正在跑一批自動化任務，直接斷在半路。

事後比對才發現，我實際撞的是週使用上限。

但那陣子 Claude Code 有一波 bug，跳出的錯誤訊息常跟實況對不上(這句就是誤報之一，X上類似的回報不少)。

那次之後我才認真研究限制怎麼分層、什麼行為用最兇。

這篇是整理後的版本：先搞懂機制，再講怎麼省。

### Claude Code 額度多久重置？先分清 3 種限制

AI 的用量單位叫 token(一個中文字約 1-2 個 token)。

重點在這裡。你「說的」跟它「讀的」都算。

你貼一個 500 行的檔案給它，Claude Code 每次思考都要重讀一次這段脈絡，燒的量遠超過你打的那兩句話。

為什麼有人一天用不完、有人兩小時就撞牆？

差別不在誰問得多，在誰的對話裡裝著多少東西。

先做第一個判斷。你看到的是用量限制，還是單一對話太長？如果畫面寫 reached your limit、usage limit 或附重置時間，先查 Settings > Usage，也就是帳號設定裡的用量頁。終端機輸入 /status，則能確認目前登入帳號與方案狀態。

如果不是額度用完，而是對話脈絡塞滿了，就用 /compact 壓縮或開新對話。這種情況不用乾等 5 小時，完整判斷方式可看<a href="/newbie-pitfalls/claude-code-context-limit.html">Claude Code 記憶滿了的 3 個解法</a>。

訂閱的限制結構分三層。以下依 2026 年 8 月的<a href="https://support.claude.com/en/articles/14552983-models-usage-and-limits-in-claude-code">Claude Code 用量與限制說明</a>整理，日後仍可能調整。

第一層是 5 小時用量窗口。窗口內用完就要等畫面顯示的時間重置。

第二層是每週用量上限。它會在帳號固定的時間重置，額度較高的 Max 方案另有<a href="/newbie-pitfalls/claude-fable-usage-limit.html">全模型與 Sonnet 專用兩條限制</a>。

第三層是選配的用量點數。前兩層用完後仍想繼續，可以按標準 API 費率另外付費，並設定每月花費上限。

剩餘用量先看 Claude 帳號的 Settings > Usage。依<a href="https://support.claude.com/en/articles/8325606-what-is-the-pro-plan">Claude Pro 官方說明</a>，這裡會顯示 5 小時與每週限制的用量，以及下一次重置時間。

撞到時的訊息長得像 limit reached 或 spend limit，附帶重置時間或升級連結。

看到這些字樣，第一反應應該是「用完了」而不是「壞掉了」，不用重裝。

多補一條實戰經驗：工具快速更新期偶爾會誤報。訊息寫的層級跟實況對不上時，先看 Settings > Usage，再用 /status 確認登入帳號與方案狀態。

判斷口訣：報 limit = 額度問題(等重置)；報 error = 程式問題(看錯誤訊息)；沒反應 = 環境問題(查安裝那篇)。

### 5 個省額度實戰：我現在怎麼避免工作中斷

這 5 個習慣是我撞牆之後養成的，排序照 CP 值：

1. 換主題就開新對話。舊對話有的東西會一直被重讀。修 A 網站聊了 50 輪之後轉頭問 B 專案，那 50 輪還在計費範圍裡。一件事一個對話，做完就關，是最有感的一招。
2. 講重點，別把 AI 當搜尋引擎。「幫我看這個函式為什麼出錯」貼相關的 20 行，勝過貼整個 500 行檔案再問「有沒有問題」。你貼的每個字，AI 都要反覆讀。
3. 同一份大檔案別重複貼。檔案在專案資料夾裡，Claude Code 自己會去讀，而且讀檔比你貼上省，因為可以挑著讀。把檔案丟進工作資料夾再叫它看，別複製貼上。
4. 長對話用 /compact 壓縮。對話太長時打 /compact，前面的內容會被摘要成重點、丟掉細節，腦容量跟計費脈絡一起變小。感覺 AI 開始恍神或變慢，就是該壓縮的時候。
5. 大任務挑時段開跑。重置窗口約 5 小時，把「會跑很久的大批次任務」排在你接下來幾小時不需要 AI 的時段(例如睡前)，就算跑到撞牆，重置時你剛好回來。

我那次撞的是第二層，也就是週上限(雖然當下跳的訊息誤寫成 monthly spend limit)。

平常更常撞的是 5 小時限額。

但教訓都一樣，是第 5 點的反面：大批次任務排在工作日正中間，<a href="/newbie-pitfalls/ai-agent-stops-halfway.html">斷在半路</a>、剩下的工作還得等重置。

所以現在大任務一律睡前跑。

### 該等重置、啟用用量點數，還是升級 Max？

照上面 5 個方法還是天天撞牆，才考慮升級。

目前個人方案有 Pro、Max 5x 與 Max 20x。價格與額度可能調整，直接看<a href="https://claude.com/pricing">Claude 官方定價頁</a>。

判斷標準很簡單。你每週因為等重置損失幾小時？

如果等待已經影響到正事，升級的錢換回來的時間是划算的。

如果只是偶爾撞一次，就照 Settings > Usage 顯示的時間等重置。不要因為每月一兩次的不便，直接升到更高方案。

另一條路是啟用<a href="https://support.claude.com/en/articles/12429409-manage-usage-credits-for-paid-claude-plans">用量點數</a>。方案內額度用完後，後續用量會按標準 API 費率另外計費，必須由你在 Settings > Usage 主動開啟。

這跟訂閱額度是兩筆帳。想嚴格控制成本，就不要開啟，或先設每月花費上限。

我自己是 Max 5x 就夠。

從 2026 年 4 月中開始做了 10 個自動化工具，還有自己的網站以及團隊的網站，撞牆次數不少，但都排在睡前所以不影響工作。

我現在的處理順序很固定。先看 Settings > Usage，再看訊息是 5 小時窗口、每週上限，還是單一對話太長。

5 小時窗口就等畫面上的重置時間，每週上限就把剩餘工作拆開排程。若只是對話太長，直接用 /compact 或開新對話，不用乾等。

### Summary

Claude Code 報 limit 不是壞掉，是用量暫時到頂。先到 Settings > Usage 查看 5 小時窗口、每週上限與下一次重置時間，再用 /status 確認登入帳號與方案。若是單一對話太長，用 /compact 或開新對話，不用乾等。想繼續使用，可以等重置、主動啟用用量點數，或在等待已影響工作時升級方案。5 個省法是換主題開新對話、只給必要資訊、讓工具自己讀檔、長對話用 /compact、大任務挑時段。我實際撞過週上限，當下卻誤顯示 monthly spend limit，所以最後要以帳號用量頁為準。

### 名詞解釋

- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。
- **rate limit（用量限制）**：服務商限制你在一段時間內能用多少次的機制。撞到不是壞掉，是「這個時段的量用完了」，等重置或升級方案。
- **context（上下文視窗）**：AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **大型語言模型（LLM, Large Language Model）**：ChatGPT、Claude 這類 AI 背後的技術：讀過海量文字後，學會理解與生成人類語言的模型。

### FAQ

**Q: Claude Code 顯示 limit 訊息是壞掉了嗎？**

通常不是壞掉，而是用量暫時到頂。先到 Claude 帳號的 Settings > Usage 看 5 小時與每週用量，以及下一次重置時間。終端機輸入 /status 可以確認目前登入帳號與方案。重裝不會增加額度。

**Q: Claude Code Pro 的額度到底有多少？**

官方沒有公布每個人固定能問幾次，因為用量會受模型、任務長度、檔案大小與對話脈絡影響。Pro 有 5 小時用量窗口，另有每週上限。直接看 Settings > Usage 的剩餘量與重置時間，比拿別人的使用次數套在自己身上準。

**Q: 怎麼讓 Claude Code 的額度撐久一點？**

我現在固定做 5 件事。換主題就開新對話，只貼必要的程式碼，檔案留在專案裡讓 Claude Code 自己讀，長對話用 /compact，大批次任務排在不急著繼續用 AI 的時段。這些做法不能增加官方額度，但能減少重複讀取不必要脈絡。

**Q: Pro 不夠用該升級 Max 還是改用 API？**

先看 Settings > Usage，確認你常撞的是 5 小時窗口還是每週上限。如果等待已經反覆打斷正事，再比較 Max 與用量點數。用量點數是在訂閱額度用完後，按標準 API 費率另外付費，適合偶爾需要多跑一段。每天都不夠用，再考慮較高方案。

**Q: 撞到月上限(monthly spend limit)怎麼辦？**

先到 Settings > Usage 對照實際狀態。這可能是你啟用用量點數後設定的每月花費上限，也可能是錯誤訊息與實況不一致。我 2026 年 7 月遇過一次，畫面寫 monthly spend limit，實際撞到的卻是每週上限。確認是真正的花費上限後，再決定調高上限或停止額外計費。大任務中斷時先記下剩餘工作，不要立刻重跑同一批。

---

## Claude Code 卡住沒反應？5 個原因與解法

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-stuck-not-responding.html
> Claude Code 卡住、當機、掛了？先別重開。5 個原因依序查：等你確認、長任務在跑、context 滿了、網路斷線、真的卡死。附三階中斷法（Esc→Ctrl+C→重開）與官方故障確認。

短答給趕時間的人：Claude Code 看起來卡住，5 個原因照機率排：(1) 在等你按確認，往上捲，可能有個權限詢問停在那 (2) 長任務正常在跑，有轉圈動畫就是在工作，大任務跑 10 分鐘很正常 (3) context 滿了變慢，打 /compact 壓縮 (4) 網路問題，看有沒有連線錯誤字樣 (5) 真的異常，按 Esc 中斷，不行再關終端機重啟。真當機很少，9 成是前兩種。

「它是不是死了？」是我 2026 年 4 月中剛上手那陣子最常有的疑問。

有次我等了 5 分鐘，以為當機，直接砍掉終端機。

結果那時候 Claude Code 正在改一個大檔案。斷在半路，檔案改了一半，收拾殘局比原本等下去還久。

這篇整理一套判斷法：什麼時候該等、什麼時候該中斷、怎麼中斷才安全。

### 先判斷：它是在工作、在等你、還是真的死了？

重開之前先花 30 秒判斷狀態，對照這張表：

最容易誤判的是第 2 種：Claude Code 問了你問題，你沒看到，雙方互等。重開前先往上捲一頁。

還有一種不在表裡：Anthropic 那邊在當機。先去 <a href="https://status.anthropic.com">status.anthropic.com</a> 看一眼，紅的或黃的就是官方故障，你這邊不管重開幾次都一樣，等它恢復就好。

### 最常見的兩種「假卡住」

<mark><strong>假卡住 1：權限確認在等你。</strong></mark>

Claude Code 對有風險的動作會先停下來問你要不要放行，例如執行指令、改系統設定，這是保護機制不是故障。

如果你切去做別的事，回來只看到畫面停著，很像當機。

解法是往上捲，看到選項就回答。常做的同類操作，可以在詢問時選「這個工作階段都允許」，之後就不會一直停下來等。

<mark><strong>假卡住 2：長任務正常在跑。</strong></mark>

「幫我把這 30 個檔案都改掉」這種任務，要一個一個讀、改、驗證，幾分鐘很正常。

怎麼分辨？看畫面有沒有在動：轉圈、逐字輸出、工具呼叫的紀錄一條條冒出來，有動靜就是在做事。

真的不放心，等這輪做完後跟 Claude Code 說「以後長任務每完成一個步驟回報一次」，你就看得到進度。

### 怎麼安全地中斷？(比砍終端機好的做法)

看到方向跑歪、或你想改指令，不用砍視窗。

按 <mark><strong>Esc 一次</strong></mark>就能中斷當前動作，對話跟已完成的工作都還在。

你可以直接打字修正方向：「停，不是這樣，我要的是⋯」。這是最該學的一顆按鍵，中斷之後畫面會停在原地等你的新指示。

Esc 沒動靜？試 <mark><strong>Ctrl+C</strong></mark>。最常見的情境是 Claude Code 幫你啟動了一個 dev server、跑測試、或連進資料庫 CLI 這類會佔住畫面的外部程式。Esc 中斷不了那個外部程式，Ctrl+C 通常可以。斷完 Claude Code 會自己接回來。

Esc 跟 Ctrl+C 都沒反應，才輪到下一步。

關掉終端機視窗、重開、在同個資料夾重啟 Claude Code，畫面會問你要不要接續上次的對話，選要就接得回來。

也可以用 claude --continue 接回。

強制重開的風險是「<a href="/newbie-pitfalls/claude-code-rewind-not-working.html">改到一半的檔案</a>」。重啟後第一件事，就是請 Claude Code 檢查剛才改到哪、有沒有改一半的檔案，讓它自己收尾。

我那次砍終端機的教訓就在這裡。

當時 Claude Code 正在大改一個檔案，強制中斷後檔案只改了一半，而我又看不懂程式，連哪裡斷掉都看不出來。

花了更多時間才把狀態找回來。後來學會的順序是：先 Esc、再說話、真不行才重開。

### 反覆卡的話，是這兩個習慣在害你

偶爾卡是正常，天天卡通常是使用習慣的問題。

<mark><strong>對話太長</strong></mark>。堆了幾十輪歷史的對話，每次回應都變慢，還會開始忘東忘西。

換主題就開新對話，長對話定期 /compact，細節看 <a href="/newbie-pitfalls/claude-code-context-limit.html">context 那篇專文</a>。

<mark><strong>任務太大一口吞</strong></mark>。「幫我重構整個專案」這種等級的任務，跑很久，中間又問不到進度。

拆成「先改這個資料夾」「先處理這 5 個檔」，每段 10 分鐘內能完成，卡住的損失也小。

<mark><strong>版本太舊不更新</strong></mark>。Claude Code 更新很頻繁，舊版偶爾有已經修掉的 bug 會造成卡住（像之前 v2.1.27 就有初始化卡死的問題，v2.1.29 修掉了）。養成定期跑 claude update 的習慣。不確定環境有沒有其他問題，打 <a href="/newbie-pitfalls/claude-code-install-failed.html">/doctor</a> 讓它自動檢查。

### Summary

Claude Code 卡住、當機、掛了？5 個原因照機率排：(1) 在等你按權限確認，往上捲看，最容易誤判 (2) 長任務正常在跑，有轉圈或逐條紀錄就是在工作，10 分鐘內別慌 (3) context 滿了變慢，/compact 壓縮 (4) 網路斷線，看 connection 字樣 (5) 真的卡死，三階中斷：先 Esc（對話保留）、再 Ctrl+C（對付佔住畫面的外部程式）、都沒用才重開終端機用 claude --continue 接回。重開後第一件事：叫它檢查有沒有改一半的檔案。也可能是 Anthropic 那邊當機，先去 status.anthropic.com 看狀態頁。天天卡就是習慣問題：對話太長、任務太大、版本太舊不更新，跑 claude update 和 /doctor。

### 名詞解釋

- **context（上下文視窗）**：AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。

### FAQ

**Q: Claude Code 一直轉圈沒回應，是當機了嗎？**

先別重開，30 秒判斷：有轉圈動畫或工具紀錄一條條出現 = 正常工作中，大任務跑 10 分鐘很常見;完全靜止 + 往上捲發現有個問題或選項停著 = 它在等你回答(最容易誤判的情況);回應越來越慢 = context 快滿，打 /compact。真的完全沒動靜，按 Esc 中斷再下指令，Esc 也沒反應才重開終端機。

**Q: Claude Code 跑到一半想中斷怎麼辦？**

按 Esc 一次。它會停下當前動作，對話跟已完成的工作都保留，你可以直接打字修正：「停，方向不對，我要的是⋯」。不要直接砍終端機，改到一半的檔案會停在半成品狀態。Esc 無效才關視窗重開，重啟後用 claude --continue 接回上次對話，並先叫它檢查有沒有改一半的檔案。

**Q: Claude Code 為什麼停著不動，好像在等什麼？**

很可能真的在等，等你。它對有風險的動作(執行指令、大量修改)會先停下來徵求同意，如果你剛好切去別的視窗，回來就只看到它靜止，雙方互等。往上捲一頁，看到權限詢問就回答。常見的同類操作可以選「這個工作階段都允許」，減少之後停下來的次數。

**Q: Claude 當機了嗎？怎麼確認是不是官方問題？**

先去 status.anthropic.com 看狀態頁。紅色或黃色就是 Anthropic 那邊在維修或出狀況，你這邊不管重開、重裝、換網路都沒用，等官方恢復就好。狀態頁全綠才輪到查自己這邊。也可以搜 Reddit 的 r/ClaudeAI 或 X 上搜 Claude down，如果一堆人同時在喊，就不是你的問題。

**Q: 如何重啟 Claude Code？**

最安全的順序：先按 Esc 中斷當前動作（對話保留），接著直接下新指令。Esc 沒反應就按 Ctrl+C。都沒用才關掉終端機視窗，在同個資料夾重新打 claude，它會問你要不要接續上次對話，選要就接得回來。也可以用 claude --continue 直接接回。重開後第一件事：叫它檢查有沒有改一半的檔案。

**Q: Claude Code 越用越慢是什麼原因？**

9 成是對話堆太多東西：每次回應它都要重讀整段對話歷史，幾十輪之後自然變慢，還會開始恍神忘事。解法：打 /compact 把歷史壓縮成摘要;或做完一件事就開新對話，別把不相關的任務全塞同一個對話裡。這同時也省額度，長對話是燒 token 最快的使用方式。

---

## Claude Code 怎麼登入？API Key 跟訂閱別搞混

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-api-key-login.html
> Claude Code 兩種登入：Pro 訂閱瀏覽器授權、API key 按量計費。API key 怎麼從 console 申請、環境變數怎麼設定，加上瀏覽器沒跳出的排解跟 key 安全鐵律。

短答給趕時間的人：Claude Code 有兩種身分驗證方式，搞混會多花錢。第一種是訂閱制，多數人走這條。有 Pro(US$20/月)就在第一次啟動時用瀏覽器登入 Anthropic 帳號，完成授權即可使用，完全不用碰 API key。第二種是 API 制。去後台生一把 API key，設成 ANTHROPIC_API_KEY 環境變數，按用量計費，適合自動化排程，或者偶爾大量使用的型態。已經訂了 Pro 就別再買 API 額度，訂閱登入就涵蓋了。

「我訂了 Pro，為什麼教學叫我去生 API key？」

因為網路上很多教學，寫在訂閱制涵蓋 Claude Code 之前。

也有一些是寫給工程師的自動化場景，所以這篇把兩條路、常見卡點，跟 API key 的安全放法，一次講清楚。

安全放法那一段真的很重要，別跳過。

### 兩種登入方式：你該走哪條？

判斷方法一句話就講完。

你是「人坐在電腦前用」，走訂閱登入。

你要「程式在沒有人的時候自己跑」，像是排程機器人、伺服器上的自動化，那個環境才需要 API key。

我自己的 Threads 機器人跟 LINE 機器人都是後者，但我平常做網站、寫東西的時候，全部都是訂閱登入。

### 訂閱登入的 3 個常見卡點

1. 瀏覽器沒自動跳出：終端機上其實印了一條授權網址，手動複製到瀏覽器開，登入完成就接上了。常發生在預設瀏覽器設定怪怪的機器上。
2. 公司網路卡在授權頁：有些公司防火牆會擋外部的授權流程。分辨的方法是手機開熱點讓電腦連，能登就是公司網路的事，找 MIS 處理；還是不能登，才是帳號問題。
3. 登入了卻說沒有權限：通常是帳號沒有有效訂閱，免費帳號登入不能用 Claude Code；也可能是登到另一個帳號，公司信箱跟個人信箱搞混。打 /logout 登出，確認用有訂閱的那個帳號重登。

這三個卡點，我自己或幫別人排查的時候全都遇過。

共通點是什麼？問題幾乎都不在 Claude Code 本身。

而是瀏覽器、公司網路、帳號，這三件周邊的事。

### API key 的正確放法(安全鐵律，別跳過)

先講怎麼拿到 key，再講怎麼安全地放。

第一步，到 console.anthropic.com 登入。左邊選單點 API Keys，再點 Create Key，取個名字，key 就生好了。這串 key 只會顯示一次，關掉就看不到了，要馬上複製存起來。

第二步，加信用卡。左邊選單的 Billing 進去設定付款方式。沒加的話 key 生了也不能用，跑程式會回錯誤。

新帳號通常有一小筆免費試用額度，實際金額以後台 Billing 頁面顯示為準，用完才開始扣卡。

key 拿到之後，下一步是放到對的地方。這邊有一條鐵律。

如果你走 API 這條，先記住一條鐵律：<mark><strong>key 絕對不寫進程式碼</strong></mark>。

API key 等於你的錢包。

寫在程式裡、跟著上傳 GitHub，等於把錢包公開在網路上，有人撿到就能燒掉你的額度，而且這種盜刷每天都在發生。

掃 GitHub 找 key 的機器人是全自動的。

正確做法是什麼？放環境變數，程式執行的時候才讀進來：

設完重開終端機才會生效。

專案要分開管理的話，把 key 放在專案資料夾的 .env 檔。

.env 要存 UTF-8 但是不要 BOM，<a href="/newbie-pitfalls/claude-code-chinese-garbled.html">原因看編碼那篇</a>，另外要確認 .gitignore 有擋住 .env，這樣程式讀得到、Git 也傳不出去。

萬一 key 不小心外洩了怎麼辦？貼到公開的地方、傳給別人看過，都算外洩。

去後台把那把 key 作廢、生一把新的，別心存僥倖。

三不：不寫進程式碼、不傳進聊天室 / 截圖、不 commit 進 Git。一要：洩漏就立刻作廢重生。

### Summary

Claude Code 身分驗證有兩條路。第一條是訂閱登入，有 Pro(US$20/月)的人第一次啟動用瀏覽器授權就能用，不用碰 API key。卡住的話查三點：授權網址手動複製開、換熱點分辨是不是公司網路的問題、打 /logout 確認登對帳號。第二條是 API key，給自動化排程這種「沒有人在場」的場景。申請三步：到 console.anthropic.com 生 key（只顯示一次要馬上複製）、去 Billing 加信用卡、設 ANTHROPIC_API_KEY 環境變數。新帳號通常有免費試用額度，用完按 token 計費。安全鐵律：key 不寫進程式碼、不 commit、放 .env 要配 .gitignore，洩漏立刻作廢重生。已經訂了 Pro 就別再買 API 額度，訂閱就涵蓋日常使用。

### 名詞解釋

- **API 金鑰（API key）**：服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- **OAuth（帳號授權登入）**：「用你的帳號幫工具開門」的標準流程：跳出瀏覽器讓你登入原服務，工具拿到授權後就能代你操作，全程不用把密碼交給工具。
- **環境變數（environment variable）**：放在系統層、不寫進程式碼的設定值，最常用來放 API 金鑰等機密，避免跟著程式碼被公開。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **PowerShell**：Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。

### FAQ

**Q: Claude Code 需要 API key 嗎？**

多數人不需要。有 Pro 訂閱(US$20/月)的話，第一次啟動時用瀏覽器登入 Anthropic 帳號授權就能用，完全不碰 API key。需要 API key 的是「程式在沒有人的時候自己跑」的場景，像是排程機器人、伺服器自動化。那個執行環境沒辦法開瀏覽器登入，才用 key 驗證、按量計費。

**Q: Claude Code 登入時瀏覽器沒有跳出來怎麼辦？**

終端機畫面上有印一條授權網址，手動複製到任何瀏覽器打開、登入你的 Anthropic 帳號完成授權，終端機那邊就會自動接上。如果在公司網路連授權頁都開不了，用手機熱點試一次，能登就是公司防火牆的問題，找 MIS 處理。

**Q: API key 應該放在哪裡才安全？**

放環境變數，絕對不寫進程式碼。Windows 用 PowerShell 打 [Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY','你的key','User') 設定使用者層級變數。專案要分開管就放 .env 檔(UTF-8 不要 BOM)並且確認 .gitignore 有擋住。key 寫在程式裡跟著上傳 GitHub = 錢包公開在網路上，掃 key 的機器人是全自動的，被盜刷是遲早的事。

**Q: API key 不小心外洩了怎麼辦？**

立刻去 Anthropic 後台把那把 key 作廢(revoke)、生一把新的，並且更新你環境變數或 .env 裡的值。不要心存僥倖，「只是貼在群組一下」「截圖有打碼一半」都算外洩，作廢重生只要 2 分鐘，被盜刷的額度可是真金白銀。順手檢查兩件事：程式碼裡有沒有寫死的 key、Git 歷史有沒有 commit 過 .env。

**Q: 訂閱登入跟 API key 可以同時用嗎？**

可以，而且是常見的組合。平常人在電腦前用訂閱登入，包月划算。排程自動化的環境用 API key，按量計費、不用瀏覽器。兩邊計費分開：訂閱的額度歸訂閱、API 的用量歸 API 帳單。我自己就是這樣配的，日常開發走 Pro 訂閱，Threads 機器人那類半夜自己跑的程式走 API。

**Q: Claude API key 怎麼申請？**

到 console.anthropic.com 登入，左邊選單點 API Keys，再點 Create Key，取個名字就生好了。key 只會顯示一次，要馬上複製存起來。第一次用 API 還要去 Billing 加信用卡，沒加的話 key 有了也不能用。生好之後設成 ANTHROPIC_API_KEY 環境變數，Claude Code 啟動時就會自動讀到。

**Q: Claude API 有免費額度嗎？**

新帳號通常有一小筆免費試用額度，實際金額跟期限以 console.anthropic.com 後台的 Billing 頁面為準，用完之後按 token 用量計費。如果你只是「人坐在電腦前用 Claude Code」，走 Pro 訂閱（US$20/月）就好，不需要碰 API，也不用擔心按量計費的事。

---

## Agent 為什麼越來越笨？Claude Code/Codex

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-context-limit.html
> AI Agent 用久了開始忘記事情、重複犯錯，不一定是模型變笨。先看 context 是否被對話與檔案塞滿，再依 Claude Code 或 Codex 選壓縮、開新對話、規則檔與斷點檔。

短答給趕時間的人：Agent 用久了開始忘記事情，不一定是它突然變笨，常見原因是 context 被對話、檔案、工具輸出和規則塞滿。Claude Code 可以輸入 /context 查看，再用 /compact 或 /clear；Codex 多半會自動整理，換新 task 後則要重新讀專案規則與進度檔。Claude Code 的固定規則放 CLAUDE.md，Codex 放 AGENTS.md，會變動的工作進度另外寫進斷點檔。摘要仍可能漏掉早期細節，所以不要把唯一版本的決策只留在聊天裡。

我第一次遇到的現象，不是跳出一個明確的「記憶已滿」錯誤，而是同一場工作做得越久，Agent 越容易漏掉前面談過的限制。

現在看到 context 百分比升高，我不再靠感覺猜。Claude Code 先輸入 /context；Codex 則看工作畫面的 context／壓縮提示，先找出空間到底花在哪裡。

你只要先回答一件事：接下來還是不是同一個任務？同一件事先整理重點，換題就開新的對話或 task。想換 Agent 仍接回原進度，就把固定規則和工作進度分開存進檔案。

我的網站專案已經跨過 100 個以上的對話與工作階段。真正讓工作接得上的，不是硬撐同一場，而是把規則與進度放回檔案。

### 先確認不是變笨，而是 context 被什麼占滿

context 是 Agent 這一場能同時處理的內容量。Claude Code 輸入 /context 可以查看；Codex 則看工作畫面提供的 context 或壓縮提示。名稱不同，先找出空間用量的目的相同。

不只你打的訊息會算進去。Agent 讀過的檔案、指令輸出、規則檔、載入的技能與系統指示，都會放進同一個 context；Claude Code 常見的是 CLAUDE.md，Codex 常見的是 AGENTS.md。

所以同樣聊 20 輪，讀過 3 個短檔案和讀過 30 個長檔案，剩下的空間完全不同。輪數只能當提示，不能拿來判斷 Agent 是否快滿。

依照 <a href="https://code.claude.com/docs/en/how-claude-code-works">Claude Code 官方文件</a>，接近上限時會先清理較舊的工具輸出，再自動把對話整理成摘要；<a href="https://openai.com/codex/">Codex</a> 也會用壓縮與新工作階段維持長任務，但兩者的介面和觸發方式不完全相同。

context 顯示 100% 也不等於專案壞掉，通常代表這場工作需要整理。先看有沒有正在自動壓縮、是否開始漏掉早期限制，再決定要繼續整理還是換新工作階段。

比較可靠的訊號有三個：context 顯示接近上限、畫面出現自動壓縮提示、Agent 忘記早期決定或重複讀同一批檔案。只有回應變慢，還可能是網路、模型或工具正在執行。

確認是 context 問題後，再看你是否還要繼續同一件事。這個判斷會決定要整理目前工作，還是直接開乾淨的新對話或 task。

### 方法 1：同一件事繼續做，先整理再下指令

任務還沒做完，但 context 已經接近上限，先請 Agent 整理目前進度，再繼續做。Claude Code 可以輸入 /compact；Codex 多半會自動壓縮，也可以直接要求它先列出進度摘要。

不要只叫它「繼續」。在 Claude Code 可以補上保留重點，例如「/compact 保留改過的檔案、測試結果、尚未完成的項目與不能改的限制」；在 Codex 則用同樣的自然語言要求摘要，別把 Claude Code 專用斜線指令硬套過去。

這種寫法比完全交給系統猜更穩，適合同一篇文章、同一個錯誤或同一個功能還要繼續處理的時候。重點不是某個指令，而是先把交接資訊說清楚。

壓縮的代價是細節會變成摘要。結論通常還在，但當時為什麼排除某個方案、哪次測試只是假通過，可能被縮成一句話。這就是你感覺 Agent 越來越笨的常見來源。

我現在會先把重要決定、已改檔案與驗證結果寫進專案檔案，再整理對話。這些資訊有磁碟上的版本，就不必賭摘要會不會保留。

如果工作已經換題，不需要前面的對話，Claude Code 可用 /clear，Codex 可開新的 task 或對話。舊對話仍能從紀錄中找回，這不是把專案檔案刪掉。

但新對話也有代價：少了限制背後的來由，接手的 Agent 可能做出合理卻偏離原計畫的選擇。我把這個實例寫在<a href="/newbie-pitfalls/ai-agent-new-session-drift.html">新對話為什麼會做偏</a>。

### 方法 2：固定規則分開放，CLAUDE.md 與 AGENTS.md 各就各位

有些規則每次開新對話或 task 都要重新交代，像是回覆語言、建置指令、不能修改的資料夾。

這些規則要放進 Agent 會讀的專案規則檔：Claude Code 是根目錄的 CLAUDE.md，Codex 則是 AGENTS.md。規則跟工具對上，換對話就不用從頭交代。

固定規則檔在新工作階段會重新載入，所以真正不能漏掉的規則，比留在對話前半段可靠。Codex 可用官方建議的 /init 產生 AGENTS.md 起點。

不過規則檔也會佔 context。Claude Code 官方文件建議 CLAUDE.md 控制在 200 行內；Codex 的 AGENTS.md 也應保持短，只留下每場都需要的規則。

我的判斷方式很簡單：同一條規則糾正到第 2 次，就評估是否寫進對應的 CLAUDE.md 或 AGENTS.md。

只在特定工作才需要的長說明不要全部塞進去。可以拆成獨立規範或技能，規則檔只留一行「遇到什麼情況要去哪裡讀」。

如果你還沒寫過，可以先看<a href="/newbie-pitfalls/claude-code-claude-md.html">CLAUDE.md 怎麼寫</a>；Codex 使用者則可從官方的 <a href="https://help.openai.com/en/articles/11369540-use-the-codex-app-for-enabling-multiple-codex-agents-in-parallel">Codex /init 說明</a>開始。兩者都先從 3 行起步，比直接複製一大份規則安全。

### 方法 3：用開源斷點系統，換 Agent 也能接著做

CLAUDE.md 或 AGENTS.md 適合放不常變動的規則，但目前做到哪裡、改了哪些檔案、下一步是什麼，每一場都會改變。

這些狀態適合另外寫進斷點檔，例如專案裡的 progress.md，不要讓規則檔變成每天都要重寫的工作日誌。

收工前我會叫 AI 記錄 5 件事：完成項目、改過的檔案、實際跑過的驗證、尚未完成的工作與下一步需要的輸入。

開新對話或 task 後，第一句先叫 Agent 讀斷點檔，再用 Git 的狀態檢查指令 <code>git status</code> 和實際測試校對，就能接著做。

新工作階段拿到的是乾淨空間，專案狀態則從磁碟重新讀取。這比期待 Agent 從一場很長的對話裡自己抓重點穩定。

這套方法是我維持網站專案的核心。整個專案跨過 100 個以上的工作階段，換 Claude Code 或 Codex 後仍然可以接回原進度。

我現在把斷點拆成兩層：精簡狀態控制在 30 行內，只放當前階段、下一步與阻塞事項；長脈絡放另一個檔案，需要時才讀。這種格式不綁任何一家 Agent。

這樣既不會每場開工先塞一大包舊資料，也保留了重要決策的來由。換 Agent 如果做出不同選擇，還能回頭對照，不用靠印象爭論。

我也把這套方法做成可直接安裝的<a href="/workflows/claude-code-checkpoint-system.html">跨對話斷點系統</a>，原始碼與安裝指令都公開在 GitHub。它不會讓 Agent 永久記住所有對話，而是用狀態檔和開場自動載入，把上次的進度重新交回去。

先確認 context 花在哪裡。同一件事先整理重點；換題就開新對話或 task。Claude Code 用 CLAUDE.md，Codex 用 AGENTS.md，變動進度一律放斷點檔。

### Summary

Agent 顯示 context 100%，不代表只能放棄這場工作。先看對話、檔案、工具輸出與規則用了多少空間：Claude Code 可用 /context，Codex 看 context 與壓縮提示。接近上限時系統可能整理對話，但摘要會漏掉早期細節。三種處理方式：同一件事先整理並指定保留重點；換題開新對話或 task；固定規則分別放 CLAUDE.md 或 AGENTS.md，會變動的進度與驗證結果寫進斷點檔。我的網站專案跨過 100 個以上的工作階段，靠 30 行內的精簡狀態加長脈絡檔接續，而不是把所有內容留在同一場。

### 名詞解釋

- **context（上下文視窗）**：AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。
- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。
- **大型語言模型（LLM, Large Language Model）**：ChatGPT、Claude 這類 AI 背後的技術：讀過海量文字後，學會理解與生成人類語言的模型。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **Codex**：OpenAI 的程式型 AI 代理，跟 Claude Code 同類：能讀寫你的檔案、跑指令、動手把功能做出來。

### FAQ

**Q: Agent 為什麼越用越笨，開始忘記前面說的話？**

先確認 context 是否接近上限。Agent 的 context 會放入對話、讀過的檔案、工具輸出、規則檔與其他指示，接近上限時系統可能清理或壓縮，摘要仍可能漏掉早期細節。Claude Code 可用 /context、/compact、/clear；Codex 則看 context 提示、要求整理，或開新的 task。

**Q: 整理目前對話和開新 task 差在哪？Claude Code、Codex 要怎麼選？**

同一件事還要繼續，就先要求 Agent 列出改過的檔案、測試結果、未完成項目與不能改的限制，再整理 context。Claude Code 可用 /compact；換題才用 /clear 或開新對話。Codex 可讓目前工作先做摘要，或直接開新 task。舊對話和專案檔案都不會因此被刪除。

**Q: CLAUDE.md、AGENTS.md 是什麼？該寫什麼進去？**

它們都是專案固定規則檔：Claude Code 讀 CLAUDE.md，Codex 讀 AGENTS.md。適合放回覆語言、建置指令與不能修改的範圍；會變動的進度不要塞在裡面。兩者都應保持短，只留下每場都需要的規則，特定任務的長說明另外存放。

**Q: 怎麼讓 Claude Code 或 Codex 跨對話記住專案進度？**

把會變動的進度寫進斷點檔。至少記錄完成項目、改過的檔案、實際驗證、未完成工作與下一步輸入。新對話或 task 先讀斷點，再用 git status 和測試校對。我目前把精簡狀態控制在 30 行內，長脈絡另放檔案，需要時才讀，已用這套接續 100 個以上的工作階段。

---

## Claude Code MCP 是什麼？一行指令裝好工具

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-mcp-guide.html
> MCP 是 AI 的 USB 接口：裝一個 server，Claude Code 就多一套工具(試算表/資料庫/瀏覽器)。什麼時候需要、claude mcp add 一行接法、挑 server 的 3 個安全原則。

短答給趕時間的人：MCP(Model Context Protocol)是 Anthropic 2024 年底發布的開放標準，可以想成「AI 的 USB 接頭」。裝一個 MCP server(照這個標準做好的工具包)，Claude Code 就多一套能直接用的工具：查你的試算表、讀資料庫、控制瀏覽器、發訊息。接法對使用者來說，就一行指令 claude mcp add。難的不是裝，是想清楚你需不需要。本來就有的能力夠用，就別裝。

MCP 大概是 2025-2026 年被講到爛，但非工程師版解釋最少的詞。

我第一次查的時候，整頁都是 protocol、client-server 架構圖。

看完還是不懂。不知道「所以我能拿它幹嘛」。

這篇用我自己從 2026 年 4 月中每天在用的視角，講人話版。

### 用 USB 比喻，一次搞懂 MCP 是什麼？

Claude Code 本來就會兩件事：讀寫你電腦的檔案，還有執行指令。

但碰不到「外面的東西」。像你的 Google 試算表、公司資料庫、瀏覽器裡的網頁。

以前要接這些，每個服務都要工程師寫一套專屬接法。

MCP 把接法標準化了。

就像 USB 統一了接頭，任何照標準做的裝置插上就能用。

所以現在的情況是這樣：各家做好「MCP server」，你把 server 接上 Claude Code，工具箱就變大。

一個 server 等於一組工具，例如試算表 server，提供的就是讀寫試算表的能力。

對你來說感受很直接：本來只能「幫我改這個檔案」，接了之後可以「幫我把試算表 A 欄的資料整理好寫回去」，或是「開瀏覽器去查這三個網站的價格」。

一句話：Claude Code 是會做事的助理，MCP 是讓這個助理「拿到更多工具」的標準接頭。

### 先過這一關：你真的需要 MCP 嗎？

誠實講：很多人不需要。怎麼判斷？看你的任務卡在哪。

卡在「AI 碰不到某個外部服務」才需要 MCP;卡在寫程式、改檔案、跑指令，本來就有的能力全都做得到，裝了只是好看。

我自己的真實用量參考：日常做網站、寫文章，9 成時間只用本來就有的能力。

真正離不開 MCP 的，是「<a href="/newbie-pitfalls/claude-browser-automation.html">叫它開瀏覽器驗證網頁改動</a>」，還有「接行事曆或訊息服務」這幾件事。

先用本來就有的功能把基本功練熟，碰到 Claude Code 摸不到的東西再回來裝。

這個順序不要反過來。

### 怎麼接？(一行指令 + 兩個檔案位置)

接一個 MCP server 的標準動作(以官方文件為準，2026-07):

那個啟動指令去哪找？

每個 MCP server 的說明頁都會給你一段「複製貼上」的安裝指令，你要做的就是複製、貼上、跑。

接完重啟 Claude Code，問一句「你現在有哪些工具？」就能確認接上了。

需要登入的服務(試算表、訊息)，第一次使用會跳授權畫面，跟手機 App 要權限一樣。

兩個管理位置：個人層級是你所有專案都能用，專案層級寫在專案的 .mcp.json，只有這個專案用。

非工程師記一個原則就好：自己用就放個人層級，跟著特定專案走就放專案層級。

用 claude mcp list 可以看目前接了哪些。

### 挑 server 的 3 個原則(安全這關別偷懶)

1. 來源要可信。MCP server 拿到的權限跟你給 AI 的一樣大，能讀你授權的資料。優先用官方出的、或大專案維護的 server;來路不明的 server 等於讓陌生人進你家，再方便都別裝。
2. 用不到就拆掉。每個接上的 server 都會佔一點 AI 的腦容量，因為 Claude Code 要記住有哪些工具可用。裝了三個月沒用到的，claude mcp remove 拆掉，工具箱不是越大越好。
3. 權限給最小。授權時能選範圍就選最小，只給某個資料夾、某一份試算表，不要整個帳號。這跟給 App 權限同一個道理：夠用就好。

### Summary

MCP(Model Context Protocol)是 Anthropic 發布的開放標準，像 AI 的 USB 接頭：裝一個 MCP server，Claude Code 就多一套工具(試算表、資料庫、瀏覽器、訊息服務)。需求判斷：卡在「AI 碰不到外部服務」才需要，做網站改檔案這些本來就有的能力就夠，我自己 9 成時間用不到 MCP。接法一行 claude mcp add 加上重啟確認;個人層級全專案通用、專案層級寫 .mcp.json。挑選 3 原則：來源可信(server 權限跟你給 AI 的一樣大)、用不到就拆(佔腦容量)、授權給最小範圍。

### 名詞解釋

- **MCP（Model Context Protocol）**：讓 AI 工具安全連接外部服務（瀏覽器、行事曆、資料庫）的通用接口標準，由 Anthropic 推出。
- **MCP server（工具伺服器）**：照 MCP 標準做好的工具接口，一個 server 提供一組能力（查資料庫、發訊息、控制瀏覽器）。裝上它，AI 就多一套能直接使用的工具。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **OAuth（帳號授權登入）**：「用你的帳號幫工具開門」的標準流程：跳出瀏覽器讓你登入原服務，工具拿到授權後就能代你操作，全程不用把密碼交給工具。

### FAQ

**Q: MCP 是什麼？用一句話解釋？**

MCP(Model Context Protocol)是讓 AI 接上外部工具的標準接頭，像 USB 統一了接法：任何照標準做的工具(MCP server)，接上 Claude Code 就能直接用。接上試算表 server 就能讀寫你的試算表、接上瀏覽器 server 就能開網頁操作，等於把「會做事的助理」升級成「工具箱可以擴充的助理」。Anthropic 2024 年底發布，現在是業界通用標準。

**Q: MCP server 跟 MCP 是什麼關係？**

MCP 是「標準」，MCP server 是「照標準做出來的工具包」，像 USB 是規格、隨身碟是產品。一個 server 提供一組相關能力：試算表 server 管讀寫試算表、瀏覽器 server 管開網頁點按鈕、資料庫 server 管查資料。你要什麼能力，就去找對應的 server 來接，用 claude mcp add 一行指令裝上。

**Q: 不會寫程式能裝 MCP server 嗎？**

能。裝的動作就是複製官方說明頁給的指令、貼到終端機跑、重啟 Claude Code，跟裝瀏覽器外掛的難度差不多。真正要動腦的是前面的判斷：你需不需要？本來就有的能力(讀寫檔案、執行指令)夠用就不用裝。卡住的話把錯誤訊息貼給 Claude 問，Claude 對自己的生態很熟。

**Q: MCP 安全嗎？要注意什麼？**

標準本身安全，風險在你接了什麼 server:server 拿到的權限跟你授權的一樣大，能讀你給的資料。三個原則：(1) 只用官方或知名專案的 server，來路不明的別裝 (2) 授權範圍給最小，能只給一份文件就別給整個帳號 (3) 用不到的 server 用 claude mcp remove 拆掉。跟手機 App 權限管理是同一套邏輯。

**Q: MCP、Skills、Hooks 差在哪？**

三個都是 Claude Code 的擴充機制，管不同的事：MCP 給的是「新工具」(接外部服務，像多一隻手)、Skills 給的是「新知識」(教它特定領域的做事方法，像 SOP 手冊)、Hooks 給的是「自動規矩」(固定時機自動執行的動作，像家規)。順序建議：基本操作熟了先接 MCP，有重複套路再寫 Skill，想強制自動化才設 Hook。後兩個各有專文教學。

---

## Claude Code Skills 教學：讓 AI 記住你的 SOP

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-skills-guide.html
> Skills 是 Claude Code 的知識外掛：資料夾+SKILL.md 把你的 SOP 寫成說明書，AI 對到任務自動照做。跟 CLAUDE.md 的分工、第一個 skill 20 分鐘寫法、3 個寫壞法。

短答給趕時間的人：Skill 是 Claude Code 的知識外掛，一個資料夾裡放一份 SKILL.md，也就是你的做事方法說明書，AI 碰到對得上的任務會自動翻出來照做。跟 CLAUDE.md 的差別在載入方式：CLAUDE.md 每場都讀，放通用規則;skill 按需載入，放特定情境的完整 SOP，所以 skill 可以寫很長，卻不佔平常的腦容量。第一個 skill 20 分鐘能寫好，而且可以叫 AI 幫你寫。

我發現自己每次要 AI 寫社群貼文，都要重新交代一次語氣規則。

別用啟發體、數字要具體、結尾別雞湯。每次講，每次漏。後來我把整套規則寫成一個 skill。

現在只要說「寫篇貼文」，Claude Code 自己會把規則翻出來套。

這篇講 skill 是什麼、跟 CLAUDE.md 怎麼分工、第一個 skill 怎麼寫。

### Skill 是什麼？跟 CLAUDE.md 差在哪？

兩個都是「把你的要求變成 AI 的預設行為」。差在載入方式。

CLAUDE.md 是常駐，每次開場都整份讀進腦裡，適合放每場都需要的通用規則，像語言、專案背景、禁區。

skill 是按需，平常只記得「有這個技能，是幹嘛用的」，那是一行描述。

碰到對得上的任務，才把整份內容翻出來。

判斷口訣其實很簡單。

這條規則「每場都用得到」就進 CLAUDE.md;「特定任務才用得到、但一用就要整套」就寫成 skill。

我的實例：「回覆用繁中」在 CLAUDE.md。

「寫 SEO 文章的完整規範」是幾千字的檢查清單，做成一個 skill。寫文章時才需要，平常帶著純浪費。

### 20 分鐘，第一個 skill 怎麼寫？

一個 skill 最小只需要兩樣：一個資料夾，加裡面一份 SKILL.md。

放在個人層級的 skills 資料夾(所有專案通用)，或專案的 .claude/skills/(跟著專案走)。

SKILL.md 的骨架大概長這樣：

最關鍵的一行是開頭的 description。

AI 靠這一行判斷「現在這個任務，要不要翻這本手冊」。

寫法是講清楚「什麼時候用」加「涵蓋什麼」，像上面那樣具體。

如果寫得太模糊會怎樣？

像「關於寫作的技能」這種，AI 永遠對不上，skill 就變成裝飾品。

還有一個偷吃步。整個 skill 可以叫 Claude Code 幫你寫。

「我每次要你做 X 都要交代這些規則(貼上你常講的話)，幫我整理成一個 skill，放到 skills 資料夾」。

寫完之後怎麼確認有沒有生效？

開新對話、丟一個相關任務，看它有沒有自動照規矩來。

沒有就回頭把 description 寫得更明確。

### 3 個常見寫壞法(我都犯過)

1. 寫成教科書。skill 裡塞滿背景知識跟理論，但 AI 要的是「可執行的步驟跟判斷標準」。改法：每條規則都寫成「做什麼、不做什麼」，能給範例就給對照(❌ 這樣寫 / ✅ 那樣寫)。
2. description 太模糊。「內容創作技能」對不上任何具體任務。改法：把觸發情境寫進去，像「幫我寫社群貼文、想標題、改文案時使用」。你會怎麼跟它說話，就把那些關鍵詞寫進 description。
3. 一個 skill 包山包海。寫作、部署、回報全塞一包，結果每個情境都載入一堆不相關的規則。改法：一個 skill 管一件事，寧可拆三個小的。

檢驗標準：新對話不提任何規則，只說「寫篇貼文」。它自動守你的規矩，skill 才算寫成了。

### Summary

Skill 是 Claude Code 的知識外掛：資料夾加一份 SKILL.md，把特定情境的完整 SOP 寫成說明書，AI 對到任務自動翻出來照做。跟 CLAUDE.md 的分工：每場都要的通用規則放 CLAUDE.md(常駐、要精簡)，特定任務的整套方法寫 skill(按需載入、可以很長)。第一個 skill 20 分鐘：一個資料夾加一份 SKILL.md，frontmatter 的 description 最關鍵，要寫清楚什麼時候用，也可以直接叫 AI 幫你生成。3 個寫壞法：寫成教科書(要可執行步驟)、description 模糊(永遠不會觸發)、包山包海(一個 skill 管一件事)。檢驗方式：新對話不提規則，它自動照做才算成。

### 名詞解釋

- **skill（技能包）**：Claude Code 的知識外掛：一個資料夾放一份說明書（SKILL.md），教 AI 特定領域的做事方法。對到相關任務時 AI 會自己翻出來照著做。
- **context（上下文視窗）**：AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。

### FAQ

**Q: Claude Code 的 skill 是什麼？**

AI 的知識外掛：一個資料夾放一份 SKILL.md，把你某類任務的做事方法(語氣規則、流程步驟、檢查清單)寫成說明書。AI 平常只記得「有這個技能」的一行描述，碰到對得上的任務才把整份翻出來照做，所以內容可以很詳細，卻不佔平常的腦容量。效果是同樣的規矩不用每個新對話重教一遍。

**Q: Skill 跟 CLAUDE.md 差在哪？該用哪個？**

載入方式不同：CLAUDE.md 每場開工全文讀(常駐)，適合每場都需要的通用規則，要精簡;skill 按需載入，適合特定情境的完整 SOP，可以很長。判斷口訣：「每場都用得到」進 CLAUDE.md，「特定任務才用、一用就要整套」寫 skill。舉例來說，「回覆用繁中」放 CLAUDE.md，「寫文章的三千字規範手冊」做成 skill。

**Q: 不會寫程式能自己做 skill 嗎？**

能，skill 本體就是一份 Markdown 文字檔，沒有半行程式。更省力的做法是叫 Claude Code 幫你生：「我每次要你做 X 都要交代這些(貼上你常講的規則)，幫我整理成 skill 放到 skills 資料夾」。你要做的只有驗收：開新對話丟相關任務，看它是否自動照規矩;沒觸發就把 description 改具體一點。

**Q: 為什麼我寫的 skill 都沒有被觸發？**

9 成是 description 寫太模糊。AI 靠 description 那一行判斷「這個任務要不要翻這本手冊」，而「內容創作相關」對不上任何具體任務。改法：把你實際會說的話寫進去，例如「幫我寫社群貼文、想標題、改文案時使用」。另外檢查檔案位置(個人層級 skills 資料夾或專案 .claude/skills/)跟 SKILL.md 的 frontmatter 格式(--- 包起來的 name 加 description)有沒有寫對。

---

## Claude Code Hooks 教學：AI 會忘，鉤子不會

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-hooks-guide.html
> CLAUDE.md 寫規則是「拜託 AI 記得」，hook 是「系統強制執行」：固定時機自動跑檢查。5 個時機點配真實用例、第一個 hook 10 分鐘設好，叫 AI 幫你設即可。

短答給趕時間的人：hook(掛鉤)是在 Claude Code 的固定時機自動執行你指定動作的機制，像開場自動載入進度、改完檔案自動跑檢查、收工自動記錄。跟寫在 CLAUDE.md 的規則差在強制力：規則是「拜託 AI 記得做」，AI 可能忘。hook 是「系統到點就執行」，不經過 AI 的記性。設定寫在 settings.json，第一個 hook 可以叫 AI 幫你設，10 分鐘搞定。

會想用 hook，通常是被同一件事煩到。

我的情況是「AI 改完程式常忘記跑檢查」。

在 CLAUDE.md 寫了「改完要檢查」，8 成會做，但就是有那 2 成忘記，而炸掉的都在那 2 成裡。

後來把檢查做成 hook：只要 Python 檔被改了，檢查自動跑，有問題當場擋下來。

從此不靠 AI 的記性。這篇講 hook 是什麼、什麼該用 hook、第一個怎麼設。

### Hook 是什麼？跟「寫規則」差在哪？

CLAUDE.md、skill 都是「用文字影響 AI 的行為」，那 hook 呢？

AI 讀了、理解了、大部分時候照做，但本質是「拜託」，忙起來會漏。

hook 不走這條路，而是設定在系統層的自動開關，到了指定時機，系統直接執行你指定的指令。

時機例如「AI 剛改完一個檔案」。AI 記不記得無所謂，反正一定會跑。

判斷該用哪個？一句話：「希望它做」寫規則，「必須每次都做」設 hook。

格式檢查、安全掃描、進度記錄這種「漏一次就可能出事」的，都是 hook 的守備範圍。

規則是家教(通常有效)，hook 是門禁(刷卡才能過)。重要的事交給門禁。

### 5 個時機點，配我實際在用的例子

hook 可以掛在這些時機(名稱以官方文件為準，2026-07):

表裡每一條，都是我電腦上真的在跑的 hook。

其中最有感的是兩個。

SessionStart 載斷點，跨對話接關不靠自己記得，就是 checkpoint 那篇的自動化版。

PostToolUse 跑檢查，AI 寫的 Python 有問題，存檔當下就被檢查工具擋下來要求修正，不會等到執行才炸。

### 第一個 hook 動手做：改完 Python 自動檢查

hook 設定放在 settings.json，個人層級或專案 .claude/ 都可以。

概念長這樣：PostToolUse 時機、對到編輯動作、跑檢查指令：

非工程師會怕嗎？這段 JSON 不用自己手寫。

打開 Claude Code 直接說：「幫我設一個 hook，每次你改完 .py 檔就自動跑 ruff 檢查，設定寫到我的 settings.json」。

讓 AI 自己給自己上規矩，它對這套設定格式比誰都熟。

設完要驗收：隨便改一個 Python 檔，看檢查有沒有自動跑。

這裡有兩個安全提醒。

第一，hook 執行的是真實指令，叫 AI 設的時候看一眼寫進去的 command 是什麼，別放你看不懂的東西。

第二，hook 自己壞掉會很吵，每次觸發都報錯，AI 做什麼都被打斷。

感覺不對就先把那段設定拿掉，修好再放回來。

### 先從一個開始：什麼事值得做成 hook？

千萬別一口氣設一堆。

從「你被煩最多次的那件事」開始。

AI 常忘記跑檢查就設 PostToolUse。每個新對話都要重新交代進度，就設 SessionStart 載斷點。怕碰到不該碰的資料夾，就設 PreToolUse 攔截。

一個 hook 穩定跑順了，再加下一個，不用急。

我的順序參考：第一個設的是 PostToolUse 檢查，因為最痛。

第二個是 SessionStart 載斷點，配合斷點檔，完整做法在 checkpoint 系統那篇。

之後才慢慢長出其他的。

hooks、skills、MCP 三樣齊了之後，Claude Code 就從「很會做事的助理」變成「有你的 SOP、你的門禁、你的工具箱的分身」。

這也是這系列三篇想帶你走到的地方。

附帶一提：裝了 hook 不代表有在跑。我曾經設了 30 幾個安全掃描 hook，幾個月後才發現設定檔放錯位置，全部從頭到尾沒有執行過。怎麼驗證、還有哪些 AI 寫程式碼常見的資安漏洞，整理在〈<a href="/newbie-pitfalls/ai-code-security-review-mistakes.html">用 AI 做產品，你有考慮到資安風險嗎？</a>〉。

### Summary

Hook 是在 Claude Code 固定時機自動執行指定動作的機制，跟 CLAUDE.md 規則的本質差別是強制力：規則靠 AI 記得(會漏)，hook 由系統到點執行(必跑)。「希望它做」寫規則、「必須每次做」設 hook。5 個時機：SessionStart(開場載進度)、UserPromptSubmit(送話時附時間)、PreToolUse(動手前攔截)、PostToolUse(改完自動檢查)、Stop(收工檢查紀錄)，每個我都有真實在用的例子。設定在 settings.json，第一個 hook 直接叫 AI 幫你設(「改完 .py 自動跑檢查」),10 分鐘搞定。原則：從最痛的一件開始，跑穩再加。

### 名詞解釋

- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。
- **JSON**：程式之間交換資料的通用格式，長得像一層層的「名稱：內容」清單，人眼也讀得懂。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **Python**：入門門檻最低的主流程式語言之一，資料處理、自動化、AI 領域的首選。

### FAQ

**Q: Claude Code 的 hook 是什麼？**

在固定時機自動執行你指定動作的機制：開場自動載入進度、AI 改完檔案自動跑檢查、收工自動記錄。設定寫在 settings.json。跟寫規則的差別在強制力，CLAUDE.md 的規則靠 AI 記得(忙起來會漏)，hook 由系統到點執行，不經過 AI 的記性，漏一次就出事的檢查都該用 hook。

**Q: Hook 跟 CLAUDE.md 的規則差在哪？**

「拜託」跟「強制」的差別。CLAUDE.md 寫「改完檔案要跑檢查」，AI 讀了、大部分照做，但有 2 成機率忘記，炸掉的都在那 2 成。hook 設「PostToolUse 時自動跑檢查指令」，是系統層的門禁：AI 改完檔案，檢查一定執行。判斷口訣：希望它做 → 寫規則;必須每次都做 → 設 hook。

**Q: 不會寫程式能設定 hooks 嗎？**

能，用最偷懶也最實際的方法：叫 Claude Code 幫自己設。直接說「幫我設一個 hook：每次你改完 .py 檔自動跑 ruff 檢查，寫進 settings.json」，它對自己的設定格式最熟。你要做的是(1) 看一眼它寫的 command 內容合不合理 (2) 驗收：叫它改個檔案，看檢查有沒有自動跑。JSON 看不懂沒關係，會驗收就好。

**Q: Hook 有哪些觸發時機？**

常用 5 個：SessionStart(每次開場，適合自動載入專案進度)、UserPromptSubmit(你每送出訊息，適合附加即時資訊如時間)、PreToolUse(AI 動手前，適合攔截高風險動作)、PostToolUse(AI 改完檔案後，適合自動檢查/格式化)、Stop(回合結束，適合檢查紀錄有沒有更新)。完整清單以官方文件為準。從你最痛的一個時機開始設，穩了再加。

**Q: Hooks、Skills、MCP 該先學哪個？**

順序：先把基本操作跟 CLAUDE.md 用熟(零門檻) → 碰到「AI 摸不到外部服務」再接 MCP → 發現同一套做法每次都要重教，寫成 skill → 發現有些檢查「靠它記得」會漏，設 hook 強制。三件套各管一塊：MCP 給工具、skill 給知識、hook 給紀律，都到位後，你的 Claude Code 就是照你規矩做事的分身。

---

## Claude Code vs Codex CLI：差在哪怎麼選

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-vs-codex.html
> 兩邊功能幾乎一對一(檔案/指令/MCP/skills/hooks)，入門都是 US$20/月。真正的選擇軸：你已訂哪家、慣用哪個模型。附我兩邊用量數據(約 8:1)與 Gemini CLI 免費終止現況。

短答給趕時間的人：Codex CLI 是 OpenAI 版的 Claude Code，同樣是終端機裡的 AI agent，功能面幾乎一對一(讀寫檔案、執行指令、MCP、skills、hooks、subagents 兩邊都有)，入門價位也都是每月 US$20(2026-07 查)。真正的選擇軸不在功能清單，而是兩件事：(1) 你已經訂了哪家，ChatGPT 方案含 Codex、Claude 方案含 Claude Code，先用你付過錢的 (2) 你慣用哪個模型的風格。先講清楚：我主力用 Claude Code;Codex 是近一個月才開始在特定任務上搭配(本機用量約 8:1)，所以這篇是規格對照加上主力視角，不是對等的深度實測。

會寫這篇是因為 hub 總表留了一個洞。

市場上另外兩個 agent 型 CLI(OpenAI Codex、Google Gemini CLI)我一直沒放進來。

不是忽略，是要先查證。

查完發現，兩個結論完全不同：Codex 規格穩定，可以對照;Gemini CLI 正在轉型期。

連它最有名的「免費 1000 次/天」都已經在 2026-06-18 終止了。

文末會講這段，免得你被過時文章帶去撞牆。

### 對照表：功能幾乎鏡像，差異在生態(2026-07 一手查證)

看完表你應該有個感覺。

這兩個工具在功能清單上，是互相追著抄的(業界就是這樣互相追)，連擴充機制的名字都一樣，MCP、skills、hooks 全都同名。

所以「哪個功能比較多」在 2026 年還是有效的問題嗎？已經不是了。

半年之內，雙方都會補齊對方有的東西。

### 真正該看的是哪 3 條選擇軸？

1. 你已經付錢給誰。這是最實際的一條。已訂 ChatGPT Plus？Codex 就包含在裡面，先用它，零額外成本。已訂 Claude Pro？同理用 Claude Code。兩邊都沒訂？看第 2 條。
2. 你慣用哪個模型的風格。你平常跟 ChatGPT 對話順，還是跟 Claude 對話順？agent 工具的體驗核心是模型本身，你在網頁版跟誰合拍，用它的 agent 版本就會合拍。這比任何評測都準，因為「合拍」是你自己的資料。
3. 生態綁定。你的其他工具串在哪家？例如你重度用 ChatGPT 的專案功能，Codex 銜接得順;你像我一樣整套自動化都建在 Claude 生態(skills、hooks、MCP 設定全是為它寫的)，換家的搬遷成本遠大於工具差異。

一句話：功能同質化的時代，選「你已經在的生態」，別為了評測分數搬家。

### 我的兩邊真實用量(利益揭露 + 誠實邊界)

先攤數據，再講立場。同一台電腦、兩個工具的真實用量，一邊是 Codex 官方統計頁，一邊是本機紀錄工具算出來的。

先講紀錄的限制：本機工具只算得到「這台電腦、還留著的紀錄」。

我 6 月初重灌過，更早的紀錄已經不在，其他裝置也不算。

所以下面的數字是低估的下限，看比例和量級就好：

口徑警告：官方頁跟本機工具的算法不同(含不含快取、任務怎麼切)，同一張表看量級就好，別逐位互比，例如 Codex 官方算 4.9 億、本機含快取算 5.9 億，量級一致即可互相印證。

數據講完了，來講立場。

我是 Claude Code 主力。Codex 是近一個月才開始搭配，主要用在圖片、視覺類的任務，還有個人的小專案上，量級差了快一個數量級。

我 2026 年 4 月入門時選了 Claude Code。

4 個月做出這個網站(136 篇文章)，跟 13 個自動化工具，整套 skills、hooks、斷點系統都建在上面。

按上面第 3 條，搬遷成本高到沒有動機換，這是慣性不是評測結論。

手感層面的深度心得，我只有 Claude Code 這邊夠格講。

Codex 的用量支撐得起「功能都能動」的證詞，撐不起公道的手感評價。

如果你兩邊都沒訂，想聽一句話嗎？非工程師起步選哪個都不會錯。

選完就深耕，用得深比選得對重要。

### 順帶更新：Gemini CLI 的免費時代結束了(2026-06)

很多 2025 到 2026 年初的文章推薦 Gemini CLI 的理由是「免費 1000 次/天」。

這個資訊已經過時了。Google 於 2026-05-19 官方公告，將 Gemini CLI 轉型為 Antigravity CLI。2026-06-18 起，停止對免費使用者與 AI Pro、Ultra 訂戶提供服務(付費的 Code Assist 企業授權不受影響)。

接替的 Antigravity CLI 定價，在我查證時(2026-07-12)還沒有可靠的一手來源，所以這裡不寫，也先不做對照。

等它穩定下來如果值得比。我再補一篇。

這段放在這裡的目的是什麼？

如果你是被「Gemini CLI 免費」的舊文帶來的，現在你知道該重新評估了。

### Summary

Claude Code 跟 Codex CLI 是 Anthropic 與 OpenAI 的同類 agent 工具，功能面幾乎一對一(檔案、指令、MCP、skills、hooks、subagents 兩邊全有，都支援 Windows 原生)，入門都是每月 US$20(2026-07 一手查證)。選擇軸不在功能：(1) 先用你已訂閱那家的，ChatGPT 方案含 Codex、Claude 方案含 Claude Code (2) 你跟哪個模型對話合拍就用誰的 agent (3) 生態綁定，自動化建在哪家，搬遷成本遠大於工具差異。誠實揭露：我主力 Claude Code;Codex 近一個月才開始在圖片、視覺類任務與小專案搭配(本機紀錄約 8:1;Codex 官方頁 172 任務)，本篇是規格對照加主力視角，不是對等實測。另外，Gemini CLI 免費通道 2026-06-18 已終止(轉型 Antigravity)，舊文的「免費 1000 次」別再信。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **MCP（Model Context Protocol）**：讓 AI 工具安全連接外部服務（瀏覽器、行事曆、資料庫）的通用接口標準，由 Anthropic 推出。
- **skill（技能包）**：Claude Code 的知識外掛：一個資料夾放一份說明書（SKILL.md），教 AI 特定領域的做事方法。對到相關任務時 AI 會自己翻出來照著做。
- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。
- **subagent（子代理）**：AI 派出去的分身：主對話把一件事外包給另一個獨立的 AI 執行，做完只回報結果，不佔用主對話的記憶空間。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。

### FAQ

**Q: Codex CLI 是什麼？**

OpenAI 版的終端機 AI agent，跟 Claude Code 同類：讀寫你電腦的檔案、執行指令、把任務做完，也支援 MCP、skills、hooks、subagents 等擴充機制。包含在 ChatGPT 的訂閱方案裡(Free 可少量試用、Plus US$20/月，2026-07 查)，用 ChatGPT 帳號登入即可，Windows 有原生支援含沙盒模式。

**Q: Codex 跟 Claude Code 哪個比較好？**

功能清單上兩邊幾乎鏡像(2026-07 對照官方文件)，「哪個功能多」已經不是有效問題。實際的選法：(1) 已訂 ChatGPT 就先用 Codex、已訂 Claude 就用 Claude Code，零額外成本 (2) 你平常跟哪個模型對話合拍，就用誰的 agent (3) 自動化生態建在哪家就留在哪家。誠實說：我主力是 Claude Code、沒長期實測 Codex，這是規格對照，不是實測評比。

**Q: ChatGPT Plus 有包含 Codex 嗎？要另外付費嗎？**

有，不用另外付。所有 ChatGPT 方案都含 Codex(Free 基本用量、Plus US$20/月、Pro US$100/月起，2026-07 查證官方定價頁)，用量採 5 小時窗口制，超額可加購。所以已訂 Plus 的人想試 agent 工具，Codex 是零額外成本的起點，先用你付過錢的，好用再談要不要跨家。

**Q: Codex CLI 在 Windows 能用嗎？**

能，原生支援(2026-07 查證官方文件)，還有專門的 Windows 沙盒模式(限制程式權限的保護機制)，部分 Linux 工具的場景官方仍建議搭配 WSL。Claude Code 同樣支援 Windows 原生。兩邊在平台支援上已經沒有明顯差距，別被早期「只能 Mac」的舊文誤導。

**Q: 怎麼查自己在 Claude Code 或 Codex 用了多少 token？**

Claude Code：輸入 /usage 看訂閱額度視窗;想看累計 token，終端機跑 npx ccusage@latest，它讀你電腦裡的對話紀錄，連 Codex 的一起算(本文的用量數據就是這樣來的)。Codex 另有官方統計頁(任務數、累計 token、連續使用天數)。注意兩套統計口徑不同(含不含快取)，比較時看量級，別逐位互比。

**Q: Gemini CLI 還是免費的嗎？**

不是了。Google 於 2026-05-19 公告 Gemini CLI 轉型為 Antigravity CLI,2026-06-18 起停止對免費使用者及 AI Pro / Ultra 訂戶提供服務(企業版 Code Assist 授權不受影響)。網路上大量「Gemini CLI 免費 1000 次/天」的推薦文已過時。接替的 Antigravity 定價目前(2026-07)沒有可靠一手來源，建議等穩定後再評估。

---

## Claude Code Subagent 教學：3 種適合場景

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-subagent-guide.html
> Claude Code Subagent 會在獨立對話空間處理工作，再把結果帶回主對話。整理 3 個適合場景、派工單寫法、額度實坑與自訂分身的現行方式。

短答給趕時間的人：Claude Code Subagent 是在獨立對話空間裡處理一項工作的 AI 分身，完成後把結果帶回主對話。像我掃專案時，分身可以翻 50 個檔案，主對話只收 10 行摘要。一般 Subagent 不會看到主對話完整歷史，所以派工要寫齊背景、任務、邊界與回報格式。簡單問題別派，開分身也會消耗額度。

我第一次被 subagent 救到是掃專案。

當時的任務，是要 AI 盤點電腦裡幾十個資料夾。

如果在主對話裡直接做，翻出來的檔案內容全堆進對話裡，正事還沒開始，context(對話記憶)就滿了。

改成派分身去掃就不一樣。

分身翻分身的，我的主對話繼續做正事，幾分鐘後只收回一份盤點清單。

這篇講 Subagent 是什麼、3 種適合場景、派工單怎麼寫，以及我一次開 30 個分身後，25 個半路停下的額度教訓。

### Claude Code Subagent 是什麼？先理解獨立 context

白話版：主對話是你面前的助理，Subagent 是它為一項明確工作找來的專門幫手。

一般 Subagent 會從獨立的 context 開始，不會直接繼承你和主對話的完整聊天紀錄。它拿到派工內容與可用的專案規則，做完再把結果交回來。

所以「獨立」不等於完全空白，也不等於什麼都會自動知道。派工內容沒寫的前情，不能期待它自己猜到。

Anthropic 的<a href="https://code.claude.com/docs/en/sub-agents" rel="noopener noreferrer">Subagent 官方文件</a>把它定位成獨立對話空間、專用指令與工具權限的工作單位。若要完整帶入目前對話，現行版本另有 fork（帶著現有對話開分支）類型，兩者不要混為一談。

為什麼這樣設計反而是優點？

因為主對話的 context 有限，大量搜尋、日誌與中間結果都留在同一處，真正需要的決策容易被埋住。

「過程很吵、結論很短」的事，最適合外包。

翻幾十個檔案的過程留在分身那邊，主對話只接收最後結果，能降低搜尋過程佔用主對話 context 的程度。

一句話判斷：工作可以獨立完成，而且你只需要最後結果，就考慮 Subagent。過程需要頻繁來回、前後步驟共用大量脈絡，就留在主對話。

### 3 種最划算的場景：什麼時候該派分身？

反例也講清楚。哪些不該派？三兩句能解決的小事。

Subagent 有開場成本。它要讀派工內容、重新理解必要檔案，也可能需要額外確認權限。

簡單問題派工，常常比主對話直接做更慢，也會多消耗一次 context 與額度。

跟現實一樣。交辦一件事給新同事的成本，有時候比自己動手還高。

### 派工單少一塊，分身就會自己猜

一般 Subagent 不會看到主對話完整歷史。它能不能做對，首先取決於你送過去的派工內容。

我現在會寫 4 塊：背景是什麼專案、任務要完成什麼、邊界有哪些不能碰、回報要用什麼格式。

少了背景會答錯題，少了邊界容易改太多，少了回報格式則可能帶回一大段你用不到的過程。

我踩過的坑就是壞派工那句：「幫我查一下那個問題」。

分身根本不知道「那個」是哪個。回來的答案完全不能用。

後來我把每張派工單都當作寫給「第一天上班的新同事」。

他很聰明，但他不知道你腦袋裡的任何前情提要。

另一個用錢學到的教訓：分身也燒額度。

我曾經一口氣派 30 個分身跑批次任務，跑到一半撞上週使用上限，25 個死在半路。

這是我自己的實測，不是每個方案都固定有相同數字。能確定的是分身仍會使用模型與工具，用量不會憑空消失。

大批次派工前，我現在會先縮小每批數量，要求失敗清單，並保留主對話可以接手的進度。

### 把常用分身寫成職位：專案用與個人用分開

每次派工都重寫一次背景很煩？

專案專用的職位放在 .claude/agents/，可以跟專案一起版本控制。每台電腦都要用的個人職位放在 ~/.claude/agents/。每個 Markdown 檔用前置設定寫名稱、用途、工具與模型，正文則是工作規則。

新版 Claude Code 不再用 /agents 開互動式建立精靈。你可以直接叫 Claude 建立職位檔，再打開檔案核對名稱、描述、工具權限與工作規則。想看獨立審查怎麼實際落地，可以接著看<a href="/newbie-pitfalls/ai-review-pipeline.html">AI 寫完、另一個分身審查的流程</a>。

概念跟 skills 一脈相承：skills 是把 SOP 寫成檔案，agents 是把「職位」寫成檔案。

第一次建立 agents 資料夾後，如果當前 session 找不到新職位，重開 Claude Code 再試。這比反覆改召喚句更快排除載入問題。

MCP、Skills、Hooks、Subagent 的角色不同：MCP 接外部工具，Skills 放可重用做法，Hooks 在事件發生時執行規則，Subagent 則隔離一項工作。

四樣都用不代表一定更有效。只在問題真的需要時加，否則載入成本、額度與排錯面也會一起變大。

你的角色會從只下指令，變成<a href="/newbie-pitfalls/claude-code-model-dispatch.html">切工作範圍、寫派工單、驗收結果</a>的人。分身數量不是成果，能不能把結果接回主線才是。

### Summary

Claude Code Subagent 是在獨立 context 裡處理一項工作的 AI 分身，完成後把結果帶回主對話。它適合大量翻找、獨立審查與互不相依的工作，不適合需要頻繁來回或共用大量脈絡的小事。派工單要寫齊背景、任務、邊界與回報格式。分身仍會消耗額度，我曾一次派 30 個，最後 25 個因用量限制停在半路。常用職位可放在專案的 .claude/agents/ 或個人的 ~/.claude/agents/。

### 名詞解釋

- **subagent（子代理）**：AI 派出去的分身：主對話把一件事外包給另一個獨立的 AI 執行，做完只回報結果，不佔用主對話的記憶空間。
- **context（上下文視窗）**：AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。
- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。
- **skill（技能包）**：Claude Code 的知識外掛：一個資料夾放一份說明書（SKILL.md），教 AI 特定領域的做事方法。對到相關任務時 AI 會自己翻出來照著做。
- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。
- **MCP server（工具伺服器）**：照 MCP 標準做好的工具接口，一個 server 提供一組能力（查資料庫、發訊息、控制瀏覽器）。裝上它，AI 就多一套能直接使用的工具。
- **MCP（Model Context Protocol）**：讓 AI 工具安全連接外部服務（瀏覽器、行事曆、資料庫）的通用接口標準，由 Anthropic 推出。
- **SOP（標準作業流程）**：把一件事該做的步驟寫成固定順序，照著跑就不會漏掉哪一步。跟「筆記」的差別是它有順序、而且每次都照同一套走。

### FAQ

**Q: Claude Code 的 subagent 是什麼？**

Subagent 是在獨立對話空間裡處理一項工作的 AI 分身，完成後把結果帶回主對話。它不會直接繼承主對話完整歷史，所以適合大量翻找、獨立審查與可單獨完成的工作。需要完整沿用目前對話脈絡時，要改用 fork，也就是帶著現有對話開分支的類型。

**Q: Subagent 跟直接在主對話做事差在哪？**

差在 context 與工作邊界。Subagent 把搜尋過程與中間結果留在獨立 context，主對話只接結果。需要頻繁來回、前後步驟共用大量脈絡，留在主對話更省事。可以獨立完成、只要最後結果，才適合派分身。

**Q: Subagent 會共用我的額度嗎？**

會。每個分身仍會使用模型與工具，用量不會憑空消失。我實際一次派 30 個分身，最後 25 個因撞到使用限制停在半路。這是個人實測，不代表每個方案都有相同數字。大批次要拆小、保留失敗清單與可接手進度。

**Q: 怎麼讓 Claude Code 開 subagent？派工要注意什麼？**

可以直接要求 Claude 使用某個 Subagent，或建立 .claude/agents/ 的專案職位。派工時寫齊背景、任務、不能碰的邊界與回報格式。一般 Subagent 不會看到主對話完整歷史，所以「幫我查剛剛那個問題」通常不夠。

---

## Claude Code 改壞怎麼辦？Esc 兩下倒帶還原

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-rewind-guide.html
> Claude Code 把程式改壞了？按兩下 Esc 或輸入 /rewind，就能還原程式碼或對話。本文實測怎麼操作、哪些能救回，以及何時必須改用 Git。

短答給趕時間的人：Claude Code Rewind 是內建的後悔藥，按 Esc 兩下(或輸入 /rewind)就能還原程式碼，把 AI 改壞的東西倒帶回去。它在你每次送出一句話之前自動幫專案存檔，不用會 git、不用事先設定。倒帶時可以選：只回檔案、只回對話，或者兩個一起。但有些東西倒不回去，像已經推上線的、terminal 指令做過的事。我實測過：倒帶了對話，推出去的更新原封不動留在線上。

會認真研究這功能，是因為我常遇到一種場景：同一件事想讓 AI 試好幾種做法。

最近一次是幫股票數據站做「籌碼分佈」圖表，同一份數據，前後試了 5 種畫法給主理人挑。

當時我還不知道有 rewind。

走的是另一條路：用 git(工程師的版本存檔工具)自己設存檔點。

這禮拜把官方的 rewind 完整玩了一遍。

這篇講怎麼用、哪些東西救不回來，以及跟我原本那條路的誠實對照。

### Rewind 是什麼？跟 Ctrl+Z 差在哪？

rewind 的邏輯一句話就講得完：Claude Code 在你每次送出指令之前，都會自動幫專案拍一張快照。

所以你隨時可以「回到我下第三個指令之前的樣子」，不用事先做任何設定，存檔是全自動的。

叫出來的方式有兩種。

連按兩下 Esc，或輸入 /rewind，會出現一排時間點讓你挑。

跟你熟悉的 Ctrl+Z 差在哪？差在範圍。

Ctrl+Z 救的是「剛剛打錯的字」，rewind 救的是「AI 這一輪動過的所有檔案」，它可能一口氣改了八個檔，你不用一個一個救。

倒帶時還能選要回什麼：只回檔案(對話繼續)、只回對話(檔案保留)，或者兩個一起回。

我最常用的是只回檔案。

程式回到改壞之前，但 AI 還記得剛剛的討論，你可以接著說「剛剛那樣不行，換個方式」。

白話比喻：rewind 是電玩的自動存檔點，打輸了讀檔重來，而且存檔是系統自動幫你按的，你只管衝。

### 我的真實場景：同一份數據，5 種畫法給主理人挑

先講我還不知道 rewind 時的做法。

場景是股票數據網站的「籌碼分佈圖」，把每天哪些券商據點在什麼價位買賣了多少，畫成一張圖。

同一份數據，呈現方式有很多種，主理人要親眼看到才挑得下去。

我前後做了 5 種：泡泡圖、成本震波圖、鏡像莖圖、價位帶對開圖、疊在 15 分 K 線上的進場位置圖。

當時的做法是用 git 自己設存檔點：每做完一版存一次，要看上一版就跳回去。

最後主理人挑了震波圖。

專案紀錄裡到現在還留著那筆「成本圖回震波」的存檔，整趟試錯路徑全部有跡可循，而且每一版都永遠留著、隨時能並排比較。

代價是你要會 git，而且要記得「先存檔再試下一版」，忘記存，那一版就被蓋掉了。

如果那時有 rewind，同一件事可以更省力：試一版、倒帶、試下一版，存檔點系統自動幫你設。

但「更省力」不等於「更好」。差別在下下段講。

### 實測：哪些回得去，哪些回不去？

這禮拜實測時，我特地做了一個實驗：到底哪些東西回得去？

把對話倒帶回幾個指令之前，然後看哪些東西真的回去了。

結果是對話回去了、電腦裡的檔案也回去了，但已經推上線的那次更新一個都沒少，網站顯示的還是新版。

所以 rewind 的守備範圍要記清楚。

rewind 管的是「<a href="/newbie-pitfalls/claude-code-project-structure.html">AI 在你電腦裡動過的檔案</a>」。

東西一旦離開你的電腦(推上線、進資料庫)，或者是 <a href="/newbie-pitfalls/claude-code-permissions.html">terminal 指令的副作用</a>(裝了套件、刪了檔案)，就超出能倒帶的範圍。

實務上的保命習慣只有一條：改壞的當下先別急著推上線。

還沒推上去，幾乎什麼都救得回;推了，就要走別條路。

### 兩條路誠實對照：事前斷點 vs 事後倒帶

兩條路到底哪一條比較好？誠實說，我現在還講不出孰優孰劣。

這是兩條不同的路，不是新的取代舊的。

我的暫行判斷法是這樣。

一場對話裡的探索，像試個做法、改個樣式，用 rewind，零成本隨時反悔。

要把每個版本都留下來給人挑、或這件事會做好幾天，git 斷點不可取代，因為 rewind 的存檔點不是為「長期保存多個版本」設計的。

給新手的順序建議很簡單。先用 rewind。

它讓你在還不會 git 的階段就敢放手讓 AI 改東西，反正倒帶不用錢。

等哪天你發現自己需要「同時留著五個版本給別人挑」，再學 git 也不遲。

工具的意義是讓你敢動手，不是逼你先上課。

### Summary

rewind 是 Claude Code 本來就有的倒帶機制：每次下指令前自動存檔，連按兩下 Esc 或輸入 /rewind 就能回去，可選只回檔案、只回對話、或兩個一起，零設定、不用會 git。守備範圍是「AI 在你電腦裡動過的檔案」;terminal 副作用(裝套件、刪檔)、已推上線的更新、資料庫資料都回不去(實測：倒帶對話後，推上線的東西原封不動)。跟 git 斷點是兩條路：git 事前設存檔、每版永遠留著，適合給客戶挑版本、跨天專案(我做 5 種籌碼圖給主理人挑就是走這條);rewind 事後隨時倒，適合對話內快速試錯。新手先用 rewind 敢動手，需要長期留版本再學 git。保命習慣一條：改壞當下先別推上線。

### 名詞解釋

- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **提交（commit）**：Git 的一個存檔點：把這次改動連同一句說明記錄下來，之後隨時可以回到這個版本。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。

### FAQ

**Q: Claude Code 把程式改壞了怎麼救回來？**

連按兩下 Esc 或輸入 /rewind，挑一個時間點倒帶。Claude Code 在你每次下指令前都會自動存檔，不用事先設定。可以選只回檔案(對話繼續聊)、只回對話，或兩個一起。前提是壞掉的東西還在你電腦裡;已經推上線或部署出去的，rewind 救不回，要走 git 或重新部署的路。

**Q: Rewind 跟 Ctrl+Z、git 差在哪？**

範圍不同。Ctrl+Z 救單一檔案裡剛打錯的字;rewind 救「AI 這一輪動過的所有檔案」，可能一次八個檔一起回;git 是永久的版本存檔，每一版都留著、跨對話跨機器都在。粗略分工：打錯字用 Ctrl+Z、這場對話內反悔用 rewind、要長期保存多個版本用 git。

**Q: Rewind 有什麼救不回來的？**

三類。一是 terminal 指令的副作用，裝過的套件、刪掉的檔案不會復原;二是已經離開你電腦的東西，像推上線的更新、部署出去的網站、資料庫裡的資料;三是它只追蹤 AI 改的檔案。我實測過：倒帶對話之後，推上線的更新原封不動留在線上。所以改壞的當下先別推上去，幾乎都救得回。

**Q: 不會 git 能放心讓 AI 改程式嗎？**

現在可以比較放心了：rewind 是本來就有的功能、零設定，等於系統自動幫你按存檔，改壞了倒帶就好。新手建議先靠 rewind 放膽試;等出現「要同時留好幾個版本給人挑」「這專案要做好幾週」的需求，再學 git。那是另一條事前設斷點的路，兩條路各有適用場景，不是誰取代誰。

---

## Claude Code 每次重開都忘記？讓它記住你的方法

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-memory-guide.html
> Claude Code 一關掉就忘光？三層記憶讓它記住你：CLAUDE.md 放固定規則、# 隨手記一句、自動記憶讓它自己寫筆記。跟當場對話記憶的差別一次講清，附我真實在用的分工法。

短答給趕時間的人：Claude Code 重開就忘，是因為「對話記憶」本來就是短期的，對話結束就清空，這是設計不是故障。要讓它跨對話記住你，用的是另一套東西，共三層：CLAUDE.md(你手寫的固定規則，每場自動載入)、訊息開頭打 #(隨手記一句，最快)、自動記憶(AI 自己寫筆記，下次開場自己想起來)。三層各管一種事，混著用才順。

我剛開始用的時候，最煩的就是這件事。

每開一個新對話，都要把「我是誰、這專案在幹嘛、哪些東西不能碰」重講一遍，而且每一次都得從頭來過，講到懷疑人生。

後來把三層記憶各就各位，現在新對話開場，AI 自己會說「你上次做到哪、這專案的規矩是什麼」。

我的記憶資料夾現在累積 18 條 AI 自己寫的筆記，從我的帳號名稱到專案路線圖都在裡面。

這篇講三層怎麼分工、各放什麼，還有記憶的坑。

### 「當場的記憶」和「跨對話的記憶」差在哪？

重開就忘，是同一種忘記嗎？其實是兩套系統。

所謂「當場的記憶」指的是什麼？叫 context，也就是這一場對話裝得下多少內容。

對話結束就清空，滿了會恍神。這套的問題看「記憶滿了」那篇。

跨對話的記憶是另一套，寫成檔案存在你電腦裡，重開多少次都還在，不會因為關掉視窗就消失。

白話比喻：context 是上班時腦袋裡想的事，下班就放空。

跨對話記憶是桌上的筆記本，隔天上班翻開就接得上。

這篇整篇講的是筆記本。

### 三層記憶怎麼分工？

我的實際分工是這樣。CLAUDE.md 放鐵律，像「PowerShell 檔案要用特定格式存，不然必出亂碼」這種踩過雷的教訓。

寫進去之後每一場都遵守，再也沒炸過。

臨時想到的用 # 丟一句。

自動筆記我基本不管，AI 自己記自己用。有次我隔了一週回來問某個專案，直接就接上進度，靠的就是那疊筆記。

想看 AI 到底記了你什麼？輸入 <a href="/newbie-pitfalls/claude-code-slash-commands.html">/memory</a> 就能打開來看。

記憶不是黑箱，是放在你電腦裡、看得到也改得了的文字檔。

這點對信任感很重要：記的東西你隨時能刪。

### 兩個坑：塞太多、和過時的筆記

問題一：什麼都塞進 CLAUDE.md。

這個檔每一場對話都會全文載入，等於固定成本，塞得越肥，留給正事的對話記憶就越少，最後連你最在乎的規則都被稀釋掉。

判斷法一句話：「每次都要遵守的」才進 CLAUDE.md。

只有這個專案某階段用的，放專案資料夾。一次性的，講在對話裡就好。

問題二：筆記會過時。

我遇過它自信滿滿引用三週前的舊筆記，但那個檔案早就改掉了。

記憶跟現實脫節，比沒記憶更會誤導。

所以看到引用舊資訊，直接說「這條過時了，刪掉重記」。筆記和 CLAUDE.md 都要新陳代謝，只進不出會越來越不準。

記憶的原則跟筆記本一樣：常翻、會更新的筆記本才有用;只寫不整理的，最後連自己都不信。

### 新手第一步：先寫三行 CLAUDE.md

不用一次把三層都建起來。

第一步只做一件事：在專案資料夾建一個 <a href="/newbie-pitfalls/claude-code-claude-md.html">CLAUDE.md</a>，寫三行。

你是誰(非工程師／職業)、這專案是什麼、絕對不能做什麼(例如「不要動 xx 資料夾」)。

就這樣。下一場對話開始就不一樣了，你會少講很多廢話。

之後的成長路徑很自然。

發現同一句話常用 # 記，就整理進 CLAUDE.md。發現「做事的方法」也想讓 AI 記住，那是 skills 的守備範圍(另一篇)。

專案大到跨好幾週，就加斷點檔(記憶滿了那篇的第 3 個方法)。

記憶、SOP、斷點，三個系統疊起來，就是「跨 100 場對話不失憶」的完整解。

### Summary

Claude Code 重開就忘是設計不是故障：當場的 context(對話結束清空)和跨對話記憶(存成檔案，永遠在)是兩套系統。跨對話記憶三層：CLAUDE.md 放每次都要遵守的固定規則(你手寫，每場自動載入，但別塞肥，它是固定成本)、訊息開頭 # 隨手記一句、自動記憶讓它自己寫筆記(我的累積 18 條，隔週回來能直接接上進度)。/memory 隨時能看能刪，記憶不是黑箱。兩個坑：CLAUDE.md 塞太多吃掉對話記憶、筆記過時比沒筆記更誤導(要新陳代謝)。新手第一步：專案資料夾寫三行 CLAUDE.md，你是誰、專案是什麼、絕對別做什麼。

### 名詞解釋

- **context（上下文視窗）**：AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。
- **skill（技能包）**：Claude Code 的知識外掛：一個資料夾放一份說明書（SKILL.md），教 AI 特定領域的做事方法。對到相關任務時 AI 會自己翻出來照著做。

### FAQ

**Q: Claude Code 怎麼讓它記住我的偏好？**

三層：固定規則寫進 CLAUDE.md 檔案(每場對話自動載入，適合「每次都要遵守」的事);臨時想到的，訊息開頭打 # 加一句話快速記下;新版還有自動記憶，它把學到的事自己寫成筆記，下次開場自己想起來。輸入 /memory 可以看它記了什麼，看得到也刪得掉。

**Q: CLAUDE.md 跟記憶功能差在哪？**

CLAUDE.md 是你手寫的規則書，你寫什麼它每場照做;自動記憶是它自己寫的筆記，記的是相處過程中學到的事(你糾正過它的、專案的進展)。一個由你主導、一個由它累積。實務分工：鐵律進 CLAUDE.md，過程性的交給自動記憶，臨時的用 # 丟。

**Q: 為什麼寫了 CLAUDE.md 它有時候還是忘記？**

兩個常見原因：一是規則寫太多，CLAUDE.md 每場全文載入，塞得越肥，單一規則被稀釋得越淡，重要的事反而被淹沒;二是把「希望它做」跟「必須每次做」混在一起，後者其實該用 hook(系統強制執行，不靠它記得)，見 Hooks 那篇。CLAUDE.md 留給精簡的核心規則，效果最好。

**Q: 記憶會不會越存越多、越來越不準？**

會，這是真坑：筆記會過時，我遇過它自信滿滿引用三週前的舊筆記，但那個檔案早就改掉了。解法是新陳代謝，看到它用過時資訊就叫它刪掉重記;CLAUDE.md 也定期回頭刪掉不再適用的規則。記憶系統跟筆記本一樣，會整理的才有用。

---

## Claude Code 模型怎麼選？額度不夠用的分工法

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-model-switch.html
> Claude Code 的模型可以換，/model 一行切。四級分工：Fable 最強但燒額度，Opus 難題，Sonnet 日常，Haiku 快又省。附我撞過額度上限後的分工法，同樣額度多撐兩三倍。

短答給趕時間的人：Claude Code 是工具，底下真正思考的 AI 模型可以換，輸入 /model 就能挑，當場生效。現在有四個等級，白話版：Fable 是 2026 年年中新出的最強(位階在 Opus 之上，硬仗用)、Opus 難題主力、Sonnet 日常主力(大多數事夠用)、Haiku 快又省(簡單雜活)。額度不夠用的人，第一件該檢查的就是「是不是什麼事都用最大的模型」。換個模型，以我自己的體感，同樣的額度能撐出兩三倍的工作量。

我認真研究模型分工的契機跟正常人一樣 ， 就額度用完了。

七月初撞上週使用上限，當週額度提前見底(完整事故在額度那篇)。

檢討時發現一個問題：我幾乎所有事都用最大的模型，連改個錯字也是。

這就像出門買杯飲料也開超跑，油錢當然爆。

後來把任務分級、模型跟著分工，同樣的額度明顯變耐用。這篇講怎麼換、四個等級差在哪、我的分工法。

### 模型是什麼？跟 Claude Code 是什麼關係？

先把這兩個東西拆開。

Claude Code 是你操作的工具，也就是車。模型是底下真正思考的 AI，也就是引擎。

同一台車可以換引擎：輸入 <a href="/newbie-pitfalls/claude-code-slash-commands.html">/model</a>，會列出可用的模型讓你挑，當場生效，不用重開。

除了 /model，還有幾種換法：啟動時加 <code>--model sonnet</code> 旗標、設環境變數 <code>ANTHROPIC_MODEL</code>、或在 <a href="/newbie-pitfalls/claude-code-settings-guide.html">settings 檔</a>裡指定預設模型。效果一樣，只是適合不同場景（臨時換用 /model，固定偏好用設定檔）。

為什麼要換？因為聰明有價。

越強的模型，每句回答消耗的額度越多。

訂閱制的額度是一池共用的，全程開最大等於全程開超跑，能跑，但油錢傷。

### 四個等級白話對照(+ fast mode 是什麼)

Fable 為什麼要多說兩句？因為是 2026 年年中才出的新等級，位階在 Opus 之上。

「最聰明」的頭銜換人了。

強項是「一次交辦一大包」：你把要的結果講清楚，Fable 自己規劃、自己動手、自己驗證。

適合查很深的錯、大改結構這種一坐下去就是半天的活，也因為做得深，額度吃得最兇。

三個注意。第一，不是預設，要自己在 /model 裡選。

第二，清單裡沒看到，通常是 Claude Code 版本太舊，先跑 claude update。

第三，選了會被記住，之後每一場都自動用，打完硬仗記得換回來，不然額度默默失血。

另外會看到一個 fast mode(快速模式)。

那是讓 Opus 用更快的速度輸出，腦袋一樣，講話變快。輸入 /fast 就能開關。

急著看結果的長任務可以開，別誤會成省錢模式或降級模式。

### 我的分工法(撞過週上限之後)

現在我開工前會先問自己一句：「這件事做錯的代價高嗎？」

代價高的，像動到整個專案結構、查一個卡很久的錯，直接上大的，Opus 起跳。

真的難纏又費時的，整包丟給 Fable。這種事讓小模型試錯三次，燒的額度比一次做對更多。

代價低的，像改文案、跑格式、簡單問答，往下換，結果感覺不出差別，額度省很多。

進階一招：開工時先用 Fable 或 Opus 把整個計畫想清楚，拆好步驟，再切到 Sonnet 照著計畫一步步做。

規劃階段燒的額度不多（主要在想，不在大量產出），但省下的是實作階段反覆修的額度。先花一點讓最聰明的腦袋畫好路線，再讓跑得快的去跑，整體算下來更划算。

一個容易忽略的細節：如果你有用 subagent(分身)，分身也吃同一池額度。

大批次派工前先想這批活需不需要最大的模型，雜活派工時記得指定用小的。

我 7 月那次遇到上限，一半就是被大批次分身加速燒掉的。

口訣：硬仗開超跑、難題開重機、日常開轎車、雜活騎腳踏車，到得了就好，別用馬力證明什麼。

### 新手判斷法：什麼時候該升、什麼時候該降？

不用背規則，用兩個訊號判斷。

該升級的訊號：同一個問題答了兩次都不對，或答案明顯抓不到重點。

別跟它耗，換大的重問一次，通常直接解。

該降級的訊號：你發現自己在做的事「講清楚就能做對」，像改字、搬檔案、照範本產出。這種事大小模型結果一樣，用大的純粹浪費。

最後一個誠實提醒：模型分工是省額度的手段，不是目的。

新手期別為了「最佳化」花太多心思切來切去。

先用預設的把事做完，等你真的碰到額度上限(或看完額度那篇)，再回來套這套分工，那時候你才有自己的手感。

### Summary

Claude Code 的模型可以換：/model 一行指令當場切換，也能用 --model 旗標、環境變數或設定檔指定。現在四等級：Fable 最新最強(硬仗用、燒最兇)、Opus 難題主力(架構、查錯、重要決策)、Sonnet 日常主力(大多數事)、Haiku 快又省(雜活)。fast mode 是 Opus 的加速輸出（/fast 切換），不是降級。分工判斷：做錯代價高的用大模型，講清楚就能做對的事用小模型。進階分工：先用 Fable 或 Opus 規劃，再切 Sonnet 照計畫實作，規劃燒的額度不多但省下實作階段反覆修的成本。subagent 分身共用同一池額度，大批次派工前先想模型等級。

### 名詞解釋

- **大型語言模型（LLM, Large Language Model）**：ChatGPT、Claude 這類 AI 背後的技術：讀過海量文字後，學會理解與生成人類語言的模型。
- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。
- **rate limit（用量限制）**：服務商限制你在一段時間內能用多少次的機制。撞到不是壞掉，是「這個時段的量用完了」，等重置或升級方案。
- **fast mode（快速模式）**：讓 Opus 用更快速度輸出的開關：腦袋一樣、講話變快。它不是省額度模式，也不是降級成小模型；真要省額度，手段是把簡單任務換到小模型。
- **subagent（子代理）**：AI 派出去的分身：主對話把一件事外包給另一個獨立的 AI 執行，做完只回報結果，不佔用主對話的記憶空間。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。

### FAQ

**Q: Claude Code 怎麼切換模型？**

最快的方式是輸入 /model，會列出可用清單，選一個當場生效。也可以啟動時加 --model sonnet 旗標、設環境變數 ANTHROPIC_MODEL、或在 settings 檔指定預設。訂閱制下不同模型消耗額度的速度差很多，Fable 最強也最燒，Opus 難題主力，Sonnet 日常主力，Haiku 最省。

**Q: Claude Fable 是什麼？跟 Opus 差在哪？**

Fable 是 2026 年年中新出的等級，位階在 Opus 之上，官方定位就是「比 Opus 更強的一級」，所以「最聰明」的頭銜換人了。它適合最難、最長的任務：把要的結果講清楚，它自己規劃、動手、驗證。三個注意：①它不是預設，要自己 /model 選 ②清單裡沒看到，先跑 claude update 把版本升上去 ③選了會被記住，之後每場都自動用它，打完硬仗記得換回來，不然額度默默失血。

**Q: Fable、Opus、Sonnet、Haiku 到底差在哪？該用哪個？**

白話版：Fable 是新來的最強，留給硬仗(一次交辦一大包的難活長活);Opus 是難題主力(架構規劃、查詭異的錯、做錯代價高的決策);Sonnet 是日常主力，寫程式改檔案寫稿大多數事夠用；Haiku 快又省，適合改錯字、格式化這類「講清楚就能做對」的雜活。判斷訊號：同一個問題答兩次都不對就升級；照範本的簡單活就降級。

**Q: fast mode 是什麼？會變笨嗎？**

不會。fast mode 是讓 Opus 用更快的速度輸出，腦袋一樣，講話變快，輸入 /fast 就能開關。適合急著看結果的長任務。真要省額度，手段是把簡單任務換到 Sonnet 或 Haiku，不是開 fast mode。

**Q: 可以用 Fable 規劃再用 Sonnet 實作嗎？**

可以，而且很推薦。先用 Fable 或 Opus 把計畫想清楚、拆好步驟，再切到 Sonnet 照著一步步做。規劃階段燒的額度不多（主要在想，產出量不大），但省下的是實作階段反覆修改的額度。先讓最強的腦袋畫好路線，再讓跑得快的去跑，整體更划算。

**Q: 換小模型會不會品質變差？**

看任務。「講清楚就能做對」的事(改字、搬檔、照範本產出)大小模型結果幾乎一樣，用大的純粹浪費；但難題丟給小模型可能試錯好幾輪，燒的額度反而比大模型一次做對更多，省過頭是假省。原則：做錯代價高的別省，代價低的盡量省。

---

## 手機遙控 Claude Code：官方三條路我都用過

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-telegram-remote.html
> 官方 Remote Control、Dispatch、Channels 我都實際用過，還自己做了兩版。這篇講三條官方路怎麼選，以及遙控一次只能操控一個 session 這件事會卡到誰。

短答給趕時間的人：手機要叫得動家裡電腦的 Claude Code，官方有三條路，我都用過。<strong>Remote Control</strong> 在電腦上跑 claude remote-control，手機用 Claude App 接手同一個 session，程式跟檔案都還在你機器上。<strong>Dispatch</strong> 讓你直接從手機發任務，它自己開一個新的來做。<strong>Channels</strong> 把 Telegram 之類的訊息轉進對話裡。三條都不用自己架東西，也不會在你電腦上開任何對外的門，安全性比自架好，大部分人用官方的就夠。我最後自己做了一個，是因為兩件事不符合我的使用情境。一是遙控一次只能操控你事先設定好的那個 session，但靈感是隨機跳出來的，它不會挑那一個。二是我同時付 Claude Code 跟 Codex 兩份訂閱，官方是各家管各家、清單各自分開，換手就得換 App。

起因是一件很日常的事。人在外面，突然想到網站有個東西要改，但電腦在家。

這件事官方有解，而且不只一種。我三條都試過。

最後我還是自己做了一個，不是因為官方的不好，是因為它們不符合我的使用情境。這篇把官方三條路怎麼用先講清楚，再講不符合的地方在哪。

### 官方三條路，差別在誰先動手

三條都有一個共同優點，而且這點很重要：<mark><strong>它們不會在你電腦上開任何對外的門</strong></mark>。官方文件寫得很清楚，你的電腦只發出去的連線，從不接受進來的連線。自架的方案做不到這件事，這是安全上的實質差距。

Dispatch 要 Pro 或 Max 方案。Remote Control 目前是研究預覽階段，但所有方案都能用。

以下對官方功能的描述，Remote Control 是我實際用過的，其餘出自 Claude Code 官方文件的 Remote Control 與 Desktop 兩頁，我逐條對過。Channels 只讀了摘要沒細看。

### 用過之後，兩個不符合我使用情境的地方

Remote Control 我實際用過。它在一種情況下很好用：你人在電腦前做到一半，要離開座位但想繼續盯著。那正是它設計出來要解決的問題，而且解得很不錯。

問題是我的工作方式不是那樣。

<mark><strong>第一個不符合：一次只能操控事先設定好的那個 session。</strong></mark>官方文件寫得很直白，伺服器模式之外，每個 Claude Code 一次只支援一個遠端會話。那個 session 要先在電腦上設定好遙控，手機才接得到。

但靈感是隨機跳出來的，它不會挑在我剛好設定好遙控的那個 session。走在路上想到的可能是三天前那個網站的事，也可能是上週那支影片的事。要能隨時跳到任何一個，我得把每個 session 都設定好遙控，而我電腦上有三百多個，這顯然做不到。

不是「能不能遙控」的差別，是「能遙控幾個 session」的差別。

<mark><strong>第二個不符合：我是雙訂閱。</strong></mark>Claude Code 跟 Codex 我兩份都付。同一件事常常想換另一個做做看，尤其卡住的時候換個腦袋很有用。但官方的路是各家管各家，要換手就得換 App，兩邊的對話清單也是分開的。

所以我做的東西其實是兩件事合在一起：一份所有 session 的列表，加上開新對話時可以選要派哪一個 AI 去做。

順帶澄清一件不能寫錯的事：「從手機開新對話」官方是有的，就是 Dispatch。差別只在它是「你說要什麼、它決定怎麼處理」，我這套是「自己挑專案跟 AI，直接開」。

### 同一個需求，我用四種形狀試過

在自己做之前，我先走過兩條自建的路。這段留著，因為每一次換掉的原因都不是「它做不到」，而是「那個形狀讓我不想拿起手機」。

<strong>第一版：Telegram 傳話機器人（2026 年 7 月）。</strong>手機在 Telegram 打字，家裡電腦上的小程式收到後轉給 Claude Code 做，做完回傳。關鍵設計是給每個 session 綁固定編號才有記憶，這其實就是 Claude Code 本來就有的<a href='/newbie-pitfalls/claude-code-memory-guide.html'>對話續接功能</a>，我只是把入口搬到 Telegram。

用了一個多月，換掉的原因是每次都要先在腦中把指令組好，門檻比想像中高。想到事情還是常常記在備忘錄。

<strong>第二版：遠端連線（8 月底）。</strong>用私有網路工具把手機跟電腦連成同一個內網，直接開電腦的終端機，在裡面打 <code>claude</code> 這個指令。能力最完整，等於人坐在電腦前。

我用一天就受不了。手機打指令每個符號都要切鍵盤，畫面是給坐在電腦前的人看的黑底白字，而且鎖屏就斷線，正在做的工作直接中斷。

<strong>第三版：自架手機聊天室（8 月底）。</strong>被上一版的痛點逼出來的。像 LINE 一樣的列表，一個聊天室就是一個 session，鎖屏不會中斷，能傳截圖、能看它做好的影片。這一版我開源了，<a href='/workflows/claude-chat-mobile.html'>另一篇</a>有完整說明跟下載。

四個版本每一次換掉，都是因為那個形狀讓我不想拿起手機，不是因為它做不到。這件事在紙上想不出來，只能用了才知道。

### 自建的那兩條，安全要上幾道鎖？

官方那三條不用煩惱這段，因為它們根本不在你電腦上開門。但只要你決定自架，就要當成一扇門來管，不管介面是聊天機器人還是網頁。我的三道鎖，缺一不可：

- <mark><strong>只認自己</strong></mark>。Telegram 版是帳號白名單，其他人傳什麼都當空氣。聊天室版是只綁在自己的私有網路上，外網跟家裡的 Wi-Fi 都連不到。這是第一道，也是最重要的一道。
- <mark><strong>想清楚要不要讓 AI 自己動手</strong></mark>。Telegram 版我設定成預設不能改東西，要動手得先手動開。聊天室版因為只有我自己連得到，我選了預設全自動，換來的是手機上不用一直按同意。這是取捨，兩種都合理。
- <mark><strong>危險指令攔截，只碰登記過的地方</strong></mark>。用 hook 擋高風險指令(<a href='/newbie-pitfalls/claude-code-hooks-guide.html'>hooks 那篇</a>講的門禁概念)，而且只能碰事先登記過的資料夾。

如果你只記一句：自架的工具絕對不能直接對公開網路開放。沒有帳號密碼保護的話，任何連得到那個位址的人，等於拿到你整台電腦。要嘛綁在私有網路裡，要嘛就用官方方案。

一個 Windows 特有的問題順便記錄，兩條自建的路都會遇到：程式呼叫 claude 的時候，走捷徑檔會不穩定，要直接指向執行檔本體的完整路徑才會穩。在終端機打 <code>where claude</code> 會印出那串路徑，複製貼進程式裡就好。

### 你該走哪條

我現在的實際用法：主力是自架的聊天室介面，因為我的 session 太多。需要完整操作電腦的時候才切回遠端連線，那個能力還是最強的。

最後一句：官方把最常見的情況做得又穩又安全，先用它。自己做一個的門檻不在技術，在於你要先說得出官方哪裡不合你，而那個答案只有真的用過才講得出來。我是用過三條之後才知道自己要的是什麼形狀。

下一站：第三版那套已經整理成可以給別人用的版本，<a href='/workflows/claude-chat-mobile.html'>手機翻任何一個 session 接著聊</a>那篇有完整說明、截圖與下載。

### Summary

手機操控 Claude Code，官方有三條路，作者都實際用過。Remote Control 在電腦上跑 claude remote-control，手機用 Claude App 接手同一個 session，程式與檔案留在本機。Dispatch 從手機發任務，它自己開新的 session 來做。Channels 把 Telegram 之類的訊息轉進對話。三條都不在你電腦上開對外連接埠，安全性優於自架，大部分人用官方即可。作者仍自建第四條，原因有二：一是遙控一次只能操控事先設定好的那個 session，而靈感隨機出現、不會挑中那一個，三百多個 session 不可能全部預先設定。二是同時訂閱 Claude Code 與 Codex，官方各家管各家、清單分開，換手須換 App。自建路線的安全三道鎖缺一不可：只認自己、想清楚要不要讓 AI 自己動手、危險指令攔截。自架工具絕不能直接對公網開放。

### 名詞解釋

- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。

### FAQ

**Q: 手機可以操控 Claude Code 嗎？**

可以，官方就有三條路。Remote Control 在電腦上跑一行指令後，手機用 Claude App 接手同一個 session，程式跟檔案都還在你機器上。Dispatch 讓你直接從手機發任務，它自己開一個新的來做。Channels 把 Telegram 之類的訊息轉進對話。三條都不用自己架東西，也不會在你電腦上開對外的門。專案在 GitHub 的話，claude.ai/code 的雲端版更省事。

**Q: Remote Control 有什麼限制？**

最實際的一條是：伺服器模式之外，每個 Claude Code 一次只支援一個遠端會話。那個 session 要先在電腦上設定好遙控，手機才接得到，你沒辦法從手機跳到另一個沒設定過的舊 session。session 一多就不可能全部預先設定。另外本機程序必須保持執行，關掉終端機 session 就結束，而且電腦連不上網超過約十分鐘會逾時退出。

**Q: Remote Control 跟 Dispatch 差在哪？**

差在誰先動手。Remote Control 是你人已經在電腦前做到一半，要離開座位但想繼續盯，所以先在那個 session 掛上遙控。Dispatch 是你人在外面才想到事情，直接在手機發任務，它自己判斷要不要開一個新的 session 來做。前者接手既有的，後者開新的。

**Q: 自建手機遙控安全嗎？**

取決於你設多少道鎖，而且先講清楚：官方三條路都不在你電腦上開對外的門，這點自架做不到，安全性本來就輸。真要自架，三道鎖缺一不可：只認自己的帳號或只綁在私有網路上、想清楚要不要讓 AI 不問就動手、危險指令攔截加上只能碰登記過的資料夾。最重要的一句：自架工具絕對不能直接對公開網路開放。

**Q: 不會寫程式能自己做一個嗎？**

能，方法就是叫 Claude Code 幫你做它自己的遙控器。我的三個自建版本都是這樣來的，我沒有從零寫過任何一行。但要注意的反而是安全概念，那個你要自己懂，不能外包。另外先想清楚官方哪裡不合你，說不出來的話就先用官方的。

---

## 讓 Claude 自己開網頁操作：我每天在用的方法

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-browser-automation.html
> Claude 不只能讀網頁，還能自己開瀏覽器點按鈕、填表單、截圖。三種接法白話對照(Chrome 擴充/內建瀏覽器/MCP)，我每天在用的驗收自動化玩法+安全邊界。

短答給趕時間的人：Claude 除了「讀」網頁(貼網址就好)，還能「操作」網頁：自己開瀏覽器、點按鈕、填欄位、捲頁面、截圖回報。三種接法由淺入深：官方 Chrome 擴充(用你平常的瀏覽器)、Claude Code 自己的瀏覽器(乾淨隔離的分頁)、MCP 瀏覽器工具(自由度最高)。我每天用最多的場景是網站驗收：改完網站叫它自己開頁面檢查、截圖給我看，人只看結果。

我大量用這功能的起點，是被自己的網站檢查流程煩到。

每次改完版面，要自己開瀏覽器、看桌機版、看手機版、切深色模式、確認沒跑版。

一輪十分鐘，一天改五次就是五十分鐘。

後來把這整段外包：「改完自己開頁面檢查，深色淺色各截一張圖回報」。從此我只看截圖。

這篇講讀跟操作差在哪、三種接法怎麼選，還有我的安全邊界。

### 「讀網頁」跟「操作網頁」差在哪？

先把這兩件事分清楚。

「讀網頁」實際上是在做什麼？你貼網址，內容被抓回來讀，這是「看」，大部分 AI 都會。

操作網頁是開一個真的瀏覽器，像人一樣點按鈕、填表單、捲動、等頁面載入、截圖，這是「動手」。

差別在能做的事：讀只能處理「內容」，操作能處理「流程」。

登入後才看得到的頁面、要點三層選單才出現的設定、填完表單才知道的結果，都要靠操作。

白話判斷：你的需求用「看」就能解決，貼網址就好;需求裡有「然後點…然後填…」，才需要操作。

### 三種接法，新手從最現成的開始

要選哪一種？其實不難。

一般人從官方 Chrome 擴充開始，裝完你的瀏覽器就多一個 AI 同事。

有在做網站的人，用 Claude Code 自己那個瀏覽器更好用，它在隔離的分頁裡動，不會弄亂你自己開的東西。

MCP 那條路自由度最高，但先看過 MCP 那篇再來。

### 我每天在用的三個場景是什麼？

<mark><strong>場景一：網站驗收自動化(用最兇)。</strong></mark>

改完網站，一句「自己開頁面檢查，手機版和深色模式各截一張回報」就好。

然後就會自己開瀏覽器、調視窗大小、切主題、截圖。

我從每輪十分鐘的手動檢查，變成只看截圖點頭。做網站的人光這招就值回票價。

<mark><strong>場景二：對照著看別人的頁面。</strong></mark>

研究同類網站的結構(標題怎麼下、段落怎麼排)，讓瀏覽器工具開頁面整理成表格，比自己開十個分頁逐一看快得多。

<mark><strong>場景三：表單和流程測試。</strong></mark>

自己網站的訂閱表單、按鈕連結，逐一點過填過，回報哪個壞了。上線前的固定儀式。

### 安全邊界：讀跟看隨便，送出去的自己按

操作的是真的網頁，所以邊界要先講好：哪些可以放手，哪些不行？

我的原則一句話：「讀跟看」的動作隨便做，「會送出去」的動作我自己按。

送出表單、購買、發布、刪除，都算會送出去。

官方的設計也是這個方向：敏感動作會停下來要你確認，不會自己衝。

另外還有兩條實務建議。重要帳號(銀行、金流後台)別讓 AI 自由跑，要用也是你看著螢幕用。

第一次玩先拿自己的網站或公開頁面練手，熟了邊界感再擴大範圍。

工具很強，但方向盤在你手上才叫自動化，鬆手那叫放生。

### Summary

Claude 能「讀」網頁也能「操作」網頁：開真的瀏覽器點按鈕、填表單、捲動、截圖。判斷法：需求用看就能解決→貼網址;需求有「然後點…然後填…」→要操作。三種接法：官方 Chrome 擴充(最現成，用你平常的瀏覽器)、Claude Code 內建瀏覽器(隔離分頁，做網站驗收最好用)、MCP 瀏覽器工具(自由度最高，先懂 MCP)。我每天的用法：驗收自動化(改完網站叫它自己檢查+截圖回報，省掉每輪十分鐘手動檢查)、對照別人頁面結構、表單流程測試。安全邊界一句話：讀跟看隨便，「會送出去」的動作自己按;重要帳號不放手。

### 名詞解釋

- **MCP（Model Context Protocol）**：讓 AI 工具安全連接外部服務（瀏覽器、行事曆、資料庫）的通用接口標準，由 Anthropic 推出。
- **爬蟲（crawler）**：自動瀏覽網頁、把內容抓回去的程式。Google 靠爬蟲收錄網頁，AI 公司靠爬蟲收集資料。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。

### FAQ

**Q: Claude 可以幫我操作網頁嗎？**

可以，而且不只是讀：它能開一個真的瀏覽器，點按鈕、填表單、捲頁面、截圖回報。入門最快的是官方 Chrome 擴充(AI 進駐你平常的瀏覽器);做網站的人用 Claude Code 內建瀏覽器更順(隔離分頁，適合驗收自己的頁面);進階可走 MCP 瀏覽器工具。

**Q: 讓 AI 操作網頁，跟直接貼網址給它差在哪？**

貼網址是「看」：它抓內容回來讀，處理的是資訊。操作是「動手」：像人一樣走流程，登入後才看得到的頁面、點了選單才出現的設定、填完表單才知道的結果，只有操作做得到。判斷法：需求描述裡出現「然後點、然後填」，就是操作的守備範圍。

**Q: 會不會亂點，把我的帳號搞出事？**

設計上「會送出去」的敏感動作(購買、送出表單、發布)會停下來要你確認，不會自己衝。但實務上還是建議：重要帳號(銀行、金流)別讓它自由跑;第一次先拿自己的網站或公開頁面練手。我的原則：讀跟看隨便它，送出去的動作我自己按。

**Q: 改完網站叫 AI 自己檢查，實際上怎麼下指令？**

我每天在用的原句類似：「改完了，自己開頁面檢查排版有沒有跑掉，手機版和深色模式各截一張圖回報」。它會開瀏覽器、調成手機尺寸、切深色模式、逐一截圖，你只看圖。把「檢查」這個動詞外包掉，是做網站的人用這功能最划算的一招。

---

## Claude GitHub App 教學：留言叫 AI 改 code

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-github-app.html
> 在 GitHub issue 留言 @claude，雲端的 Claude 就會檢查、回覆、改 code、開 PR — 電腦關著也能跑。裝法三站、實測三個任務、PR 白話解釋、額度與公開 repo 注意事項。

短答給趕時間的人：Claude GitHub App 等於在你的 GitHub 倉庫開一間值班室。你在 issue 或 PR 留言點名 @claude，雲端的 Claude 就上工：檢查、回覆、改 code、把修改做成提案(PR)等你點頭。跟本機 Claude Code 最大的差別一句話：雲端版跑在 GitHub 的機器上，你電腦關著也能動。裝法三站：裝 App、設 token、放一個 workflow 檔，三站都能叫 Claude Code 自己幫你弄。

先誠實招認：我照流程裝完、跑完第一個任務之後，心裡的感覺是「所以我剛剛到底做了什麼？」

每個步驟都成功，但整體是什麼、跟我平常在終端機用的 Claude Code 差在哪、PR 又是什麼，全部一團霧。

教學都在教步驟，沒人處理裝完之後的茫然。步驟會了，東西還是不懂。

所以這篇順序反過來。

先講清楚你裝的是什麼，再講怎麼裝，最後用我當天的三個真實任務，讓你看它實際怎麼動。

### 一間雲端值班室：你裝的到底是什麼？

先講白話：GitHub 跟 issue 分別是什麼？GitHub 是放你程式碼的雲端倉庫，issue 是倉庫牆上的便條紙，用來記待辦、回報問題。

裝了 Claude GitHub App 之後，倉庫裡多了一個值班的 AI。

你在便條上點名 @claude，它就把那張便條當工作單處理。

私人倉庫只有你能貼便條，所以值班室目前只服務你一個人。別人看不到，也叫不動。

所以雲端版不是本機版的取代品，是補上本機做不到的那塊。

出門在外丟小任務、固定的檢查工作、想留審核紀錄的修改，這些交給值班室。

要來回討論的大工程，還是回終端機。那裡才能一句一句改。

### 裝法三站(每站都能叫 AI 代勞)

1. <mark><strong>裝 App</strong></mark>，到 github.com/apps/claude 按安裝，選要開放的倉庫。我當天才發現自己早就裝過(選了全部倉庫)，先去看一眼，說不定你也裝過。
2. <mark><strong>設 token</strong></mark>，終端機跑 claude setup-token，產生一條走訂閱額度的通行憑證;複製到倉庫設定的 Secrets 裡，名稱填 CLAUDE_CODE_OAUTH_TOKEN。憑證等於鑰匙，只貼在 Secrets，別貼在任何看得到的地方。
3. <mark><strong>放 workflow 檔</strong></mark>，倉庫裡放一個 .github/workflows/claude.yml，寫「看到 @claude 才觸發」。這檔不用手寫，叫 Claude Code 幫你生，記得指定觸發條件，沒有這個條件，每則留言都會燒一次額度。

三站裝完的驗收：開一個 issue，內文寫一個具體的小任務加上 @claude，然後去 Actions 分頁看有沒有跑起來。

第一發建議唯讀任務，例如「檢查某檔案，回報就好，不要改」。

零風險，先看做事的品質。

### 實測三幕：最讓我驚艷的是「停下來問」

<mark><strong>第一幕，唯讀檢查：</strong></mark>我請值班室檢查一個排程設定檔的日期格式。

23 秒回報：6 筆全合法、沒有衝突，還主動提醒有兩筆排在同一天。

而且守住了「不要改任何檔案」這句指令，一個字都沒動。

<mark><strong>第二幕，停下來問(最驚艷):</strong></mark>我丟了一句「幫 README 加一節」。

結果倉庫根本沒有 README。

值班室沒有硬做，而是列出 4 個選項問我要建在哪。

更妙的是回覆格式照著我倉庫裡 CLAUDE.md 的規矩走：需求不明先提問、列選項。

雲端的分身讀了你的家規，而且真的遵守。你在本機立的規矩，值班室一樣照做。

<mark><strong>第三幕，動手改：</strong></mark>我回覆選項後，43 秒就寫好 README。

修改放上「樣品」分支，給我一顆建立提案(PR)的按鈕。

注意，從頭到尾沒有碰我的正式版，合併鍵在我手上。要不要上，我說了算。

### PR 是什麼？還有三個注意事項

PR(Pull Request，修改提案)到底是什麼？用刷牆比喻最好懂。

直接改正式版，等於師傅直接把你家牆刷了。刷完你才看到。

PR 則是師傅先在旁邊立一面樣品牆給你看，你點頭(合併)才正式上牆，搖頭就拆掉，正牆無傷。

單人專案平常感覺不到這道門，但讓 AI 動手時，「人類點頭才算數」就是安全感的來源。

- <mark><strong>留言要帶 @claude</strong></mark>，它只認觸發字，單獨回「1」它不會動，要回「@claude 選 1」。我第一次就漏了。
- <mark><strong>點了 Create PR 不等於建好了</strong></mark>，那顆按鈕開的是表單頁，底下還有最後一顆確認鍵。我當天就停在表單頁以為完成了。
- <mark><strong>倉庫轉公開前要加過濾</strong></mark>，私人倉庫只有你能觸發;轉公開後任何路人留言 @claude 燒的都是你的額度，要先在 workflow 加「只認倉庫擁有者」的條件。

### Summary

Claude GitHub App = 在你的 GitHub 倉庫開一間雲端值班室：issue/PR 留言點名 @claude，它就檢查、回覆、改 code、把修改做成 PR 提案給你審，跑在 GitHub 的機器上，電腦關著也能動，與本機 Claude Code 互補(即時討論回終端機，丟單審核用值班室)，額度同一池。裝法三站：裝 App(github.com/apps/claude)、claude setup-token 產生憑證放進 Secrets(CLAUDE_CODE_OAUTH_TOKEN)、放一個「看到 @claude 才觸發」的 workflow 檔。實測最驚艷的是它發現前提不存在(沒有 README)會停下來列選項問，而且守我倉庫 CLAUDE.md 的規矩。三個坑：留言要帶 @claude 觸發字、Create PR 按鈕後面還有確認鍵、倉庫轉公開前要加擁有者過濾(不然路人燒你額度)。

### 名詞解釋

- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **提交（commit）**：Git 的一個存檔點：把這次改動連同一句說明記錄下來，之後隨時可以回到這個版本。
- **OAuth（帳號授權登入）**：「用你的帳號幫工具開門」的標準流程：跳出瀏覽器讓你登入原服務，工具拿到授權後就能代你操作，全程不用把密碼交給工具。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **PR / Pull Request**：修改提案。改動先放在旁邊的「樣品」分支給人審，審過按合併(merge)才進正式版 — 合併鍵永遠在人類手上，這是讓 AI 動手時的安全門。

### FAQ

**Q: GitHub 留言 @claude 沒反應，是壞了嗎？**

先查三件事：①Claude GitHub App 裝了嗎、有沒有涵蓋這個倉庫(github.com/apps/claude 看得到)②倉庫 Secrets 有沒有 CLAUDE_CODE_OAUTH_TOKEN(終端機跑 claude setup-token 產生)③倉庫有沒有 .github/workflows/claude.yml。三件都在的話，檢查留言內容有沒有帶 @claude，它只認觸發字，單獨回「好」「1」它不會動。

**Q: 它會不會直接改壞我的正式版？**

不會，這正是它的設計：改動一律先放在「樣品」分支，做成 PR(修改提案)給你審，你按合併才進正式版，搖頭就把分支刪掉、正式版無傷。我實測時它連「不要改任何檔案」的唯讀指令都守得住，發現前提不存在(倉庫沒有 README)還會停下來列選項問，不硬做。

**Q: 跟我平常用的 Claude Code 差在哪？**

跑的地方跟互動方式。本機 Claude Code 跑你的電腦、即時來回聊、直接改檔案;GitHub App 跑 GitHub 雲端機器(你電腦關著也能動)、一次一單(留言→跑完→回報)、改動走 PR 提案制。定位互補：日常主力在本機，出門丟小任務、固定檢查、要留審核紀錄的修改交給雲端值班室。注意兩邊燒同一池訂閱額度。

**Q: 公開的 repo 裝這個安全嗎？**

私人倉庫安全(只有你能留言觸發);公開倉庫要小心，任何路人留言 @claude 都會觸發，燒的是你的訂閱額度。轉公開前先在 workflow 觸發條件加上「只認倉庫擁有者/協作者」的過濾。另外 token 是走你訂閱的鑰匙，只放在 GitHub Secrets，絕不寫進程式碼或 commit。

---

## CLAUDE.md 怎麼寫？Claude Code 的說明書

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-claude-md.html
> CLAUDE.md 是每場對話自動載入的規則書：三行起步，進階五欄位(我是誰/專案/鐵律/習慣/目錄)。最大的坑是塞成倉庫 — 越肥越稀釋。長規範外移、主檔留路由，附真實演化史。

短答給趕時間的人：CLAUDE.md 是放在專案資料夾裡的一個文字檔，每次在那個資料夾開對話，Claude Code 都會自動把整份讀進來，等於你寫給 AI 的員工手冊。起步只要三行(你是誰／專案是什麼／絕對別做什麼)，寫熟之後照五個欄位長大。最重要的一條原則：「每一場都要遵守的」才寫進來。這個檔每場全文載入，塞越肥，重要的規則被稀釋得越淡。

我的 CLAUDE.md 從三行開始，從 2026 年 4 月中用到現在，長成一套兩層的規則書。

一份全域的管「我這個人」，每個專案再各有一份管「這個專案的規矩」。

我犯過最典型的錯是塞太肥。

什麼都想讓 AI 記，結果它反而更常忽略重點。2026 年 7 月初大掃除了一次，才學會怎麼瘦身。

這篇把寫法、分層、瘦身，還有「寫了還是不遵守」的解法一次講完。

### CLAUDE.md 是什麼？放哪裡？

CLAUDE.md 就是一個檔名固定的文字檔，不用任何特殊工具，記事本就能寫。

特別的地方在於 Claude Code 對這個檔有約定：開對話時自動全文載入，而且每一場都載，你不用每次提醒去讀。

所以你寫在裡面的話，等於每次開工前都會先被讀一遍的開工須知。

跟「自動記憶」的分工一句話講完：CLAUDE.md 是你手寫的規則書，寫什麼就照什麼。

自動記憶則是 AI 自己寫的筆記，記相處中學到的事。

一個你主導，一個 AI 累積。

兩層的詳細分工在記憶那篇。

### 從三行到五個欄位：我的檔案怎麼長大的

第一天寫三行就夠：你是誰、專案是什麼、絕對別做什麼(記憶篇的起手式)。

用了幾週、開始被同樣的事煩第二次之後，自然會長出更多內容。

我的檔案現在有五個欄位：

表裡的鐵律有哪一條是憑空想的嗎？一條都沒有，全是真的炸過才寫進去的。

「檔案編碼」那條，是我被亂碼整過好幾次才寫下來的。

「附完整路徑」是被「檔案生好了但我找不到在哪」氣過之後加的。

寫的時候順手帶一句為什麼(「不然必亂碼」)，AI 更會當真，而且三個月後回頭看，你也判斷得出這條還需不需要。

### 最大的坑：把 CLAUDE.md 當倉庫塞

CLAUDE.md 每場全文載入，這是最強的地方。那代價呢？

寫越多，每場對話開工前要先吞的東西越多，留給正事的空間(context)就越少，真正要做的事反而被擠掉。

而且規則彼此稀釋，你最在乎的那三條，會被另外五十條淹沒。

我塞最肥的時期，明明寫了規則還是常被忽略。問題不在 AI，在我把手冊寫成了百科全書。

我 2026 年 7 月初做了一次大掃除。

方法就一招：長文件外移。

詳細的規範各自存成獨立檔案，CLAUDE.md 只留一張目錄：遇到什麼情況，去讀哪份檔案。

主檔從什麼都有變成一張目錄，AI 開場變快，也明顯更聽話。

誠實揭露：那次大掃除就是叫 Claude Code 重寫自己的規則書，我只負責看過。

AI 整理自己的手冊，比我手動搬快得多。

寫之前先問一句：「這條是每一場都用得到，還是只有某種情況用得到？」前者留在 CLAUDE.md，後者外移成獨立檔案，目錄留一行就好。

### 寫了它還是不遵守？兩種原因、兩種解

原因一是塞太肥被稀釋。解法就是上一段的瘦身。

原因二比較不明顯：你寫的其實是「必須每次執行」的事，不是「希望遵守」的風格。

AI 是會忘的，再重要的規則寫成文字，都只是「拜託它記得」。

必須 100% 發生的事，像改完檔自動檢查、收工前存進度，該用 hook，讓系統在固定時機強制執行，不靠任何人記得(詳見 Hooks 那篇)。

我的分工是：「風格與判斷」放 CLAUDE.md，「動作與檢查」放 hook。

最後是新陳代謝：規則書是活的。

我的習慣是同一件事糾正第二次，就當場說「把這條寫進 CLAUDE.md」。

讓規則在事故現場出生，然後每隔一陣子回頭刪掉不再適用的。

只進不出的規則書，最後連你自己都不會信。

### Summary

CLAUDE.md 是放在專案資料夾、每場對話自動全文載入的規則書。兩層：全域一份管你這個人(偏好/語言/風格)，每專案一份管專案規矩。起步三行(你是誰/專案是什麼/絕對別做什麼)，進階五欄位(我是誰/專案/鐵律/做事習慣/去哪找東西)，鐵律要從真實事故寫起、帶為什麼。最大的坑是塞成倉庫：每場全文載入，越肥越稀釋，判準是「每一場都用得到才進來」，長規範外移成獨立檔案、主檔留路由目錄(我 2026-07 大掃除實測有效)。寫了不遵守的兩種解：瘦身，以及把「必須 100% 執行」的事改用 hook。規則書要新陳代謝：糾正第二次就寫進去，定期刪過時的。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **context（上下文視窗）**：AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。
- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。
- **skill（技能包）**：Claude Code 的知識外掛：一個資料夾放一份說明書（SKILL.md），教 AI 特定領域的做事方法。對到相關任務時 AI 會自己翻出來照著做。
- **PowerShell**：Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。

### FAQ

**Q: CLAUDE.md 是什麼？一定要寫嗎？**

放在專案資料夾的文字檔，Claude Code 每場對話自動全文載入，等於你寫給 AI 的員工手冊。不寫也能用，但每個新對話都要重新交代背景，講到煩。第一版只要三行：你是誰、專案是什麼、絕對別做什麼，下一場對話立刻有感。

**Q: CLAUDE.md 跟記憶功能、skill 差在哪？**

CLAUDE.md 是你手寫的常駐規則書，每場全文載入;自動記憶是它自己寫的筆記，記相處中學到的事;skill 是按需翻閱的做事方法，對到相關任務才載入。分工：每場都要遵守的規矩進 CLAUDE.md，過程性的交給記憶，某個領域的 SOP 寫成 skill。

**Q: CLAUDE.md 可以寫多長？寫太多會怎樣？**

沒有硬上限，但有隱形成本：它每場全文載入，越肥吃掉越多對話空間，而且規則彼此稀釋，我塞最肥的時期反而最常被忽略規則。判準：「每一場都用得到」才寫進來;情況限定的長規範外移成獨立檔案，CLAUDE.md 留一行目錄「遇到什麼情況去讀哪份檔」。

**Q: 寫進 CLAUDE.md 了，AI 還是不遵守怎麼辦？**

先檢查是不是塞太肥(規則被稀釋，瘦身通常立刻改善);再檢查這條是不是「必須每次執行」的動作，文字規則本質是拜託它記得，必須 100% 發生的事要用 hook 讓系統強制執行。另外規則帶上為什麼(「不然必亂碼」)，遵守率明顯比光禿禿的命令高。

---

## Claude Code 專案資料夾怎麼放？我的整理法

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-project-structure.html
> AI 看得到什麼，取決於你在哪個資料夾開它。三個原則：一專案一資料夾(各帶 CLAUDE.md)、路徑英文命名(亂碼雷)、共用工具集中資源庫先查再造。附真實結構與判斷訊號。

短答給趕時間的人：你在哪個資料夾打開 Claude Code，那裡就是它的辦公桌。預設看得到、改得動的就是那一圈，CLAUDE.md 規則書也是認資料夾的。所以資料夾怎麼放不是潔癖，是直接決定 AI 好不好用。三個原則：一專案一資料夾(各自帶一份 CLAUDE.md)、路徑用英文命名(中文路徑在 Windows 上有亂碼雷)、會重複用的工具集中放一個資源庫資料夾(動手前先查，不重複做)。

我剛開始的時候什麼都丟桌面：網站一夾、機器人的程式跟測試檔散在外面，還有幾個中文命名的資料夾。

後果是 AI 常讀到不相干的東西，我叫 AI 改 A，結果順手動到 B，還遇過中文路徑的亂碼問題。

從 2026 年 4 月中到現在，電腦上專案數長到兩位數，現在的結構是一路修出來的。

這篇講我實際怎麼放、為什麼這樣放，以及什麼訊號出現才需要整理。

### AI 到底看得到哪些檔案？

先建立一個觀念：Claude Code 是「開在某個資料夾裡」的。

你在哪裡打開，那個資料夾就是工作範圍，預設讀寫都在裡面，<a href="/newbie-pitfalls/claude-code-permissions.html">超出範圍的動作會特別問你</a>。

連規則書都是認位置的。

全域的 CLAUDE.md 管你這個人，專案資料夾裡的那份只在這個專案生效(寫法見 CLAUDE.md 那篇)。

換個講法。請師傅來家裡，你帶他進哪個房間，他就整理哪個房間，範圍清楚，他效率高、你放心。

反過來，把整棟房子都開放給他，他光搞清楚狀況就耗掉半天，還可能動到你沒想讓他碰的東西。

「全部丟桌面同一層」就是後者。

### 我的三個原則(附真實結構)

我的實際結構(簡化版)是這樣：桌面上一個 brand 資料夾裝品牌與網站相關的專案，底下每個專案一個子資料夾，各有自己的 CLAUDE.md。

自動化機器人各自獨立一夾，排程各自設。

另外有一個資源庫資料夾，集中放會重複用的工具，像爬蟲、掃描器這類。

配套的一條規則寫在我的全域 CLAUDE.md：「動手寫新工具前，先查資源庫有沒有現成的」。

這條規則從 2026 年 4 月中用到現在，省下的時間比任何技巧都多，因為很多東西以前的自己已經做過了。

英文命名這條補充一句。給「人」看的內容(文章、筆記的內文)當然用中文，要英文的是「路徑」，也就是資料夾名、檔名。

中文路徑大多數時候沒事，那為什麼還要特別改成英文？因為踩到的那一次很難查(亂碼篇講過)。

英文命名等於直接把這整類問題關掉。

### 專案資料夾裡面該長什麼樣？

進到資料夾裡面，我固定留三塊。

第一塊是進度檔：路線圖、斷點紀錄、決策紀錄。

專案一大、對話一多，就靠這些檔案跨對話接關(context 那篇的第 3 個方法)，我每個長專案都有這一區。

第二塊是把暫存跟正式產出分開。實驗性的草稿、跑一次就丟的腳本，集中丟一個暫存資料夾定期清，不跟正式檔案混住。

混住的下場是 AI 引用到過期的草稿版本。

第三塊是機密不寫進檔案。

API 金鑰這類東西不用明文放在專案資料夾裡的檔案(登入篇的「三不」)。

不然哪天你把整個資料夾分享給別人或公開上網，金鑰就跟著出去了。

### 新手第一步：不用重整，從下一個專案開始

先講重要的。別急著把現有的東西全部搬家。

搬資料夾會弄斷既有專案裡寫死的路徑，為了整齊把能跑的東西弄壞，划算嗎？

正確的起手式是從下一個新專案開始套。

建一個英文命名的資料夾，寫三行 CLAUDE.md，以後這個專案都在這個資料夾裡開 Claude Code。

做過一次，下一個專案就自然這樣放了。

至於現有的要不要整理，看訊號。AI 常讀錯檔案、你叫它改這個、結果動到那個，或你自己都要找很久。

出現任何一個，就值得花半小時整理一次(可以叫 Claude Code 自己提搬家計畫，<a href="/newbie-pitfalls/claude-code-plan-mode.html">先看計畫再動手</a>，比較安全)。

什麼訊號都沒有？那就先不動。結構是為了做事，不是為了好看。

### Summary

Claude Code 開在哪個資料夾，那裡就是 Claude Code 的視野與工作範圍，CLAUDE.md 也認資料夾生效，所以資料夾結構直接決定 AI 好不好用。三個原則：一專案一資料夾(範圍清楚、各帶規則書，避免改 A 動到 B)、路徑英文命名(關掉 Windows 中文路徑的亂碼雷)、共用工具集中資源庫加上「動手前先查」這條規則(不重複做同一件事，是我省最多時間的一條)。資料夾內固定三塊：進度檔(路線圖、斷點、決策，跨對話接關)、暫存與正式分開、機密不寫進檔案。新手別急著重整現有專案(搬家會弄斷路徑)，從下一個新專案開始套;AI 常讀錯檔、改錯專案、自己找很久才是該整理的訊號。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **編碼（encoding）**：電腦儲存文字的方式。Windows 中文環境常用 Big5，多數程式假設 UTF-8，兩邊對不上就變亂碼 — 所以資料夾、檔案建議用英文命名。
- **API 金鑰（API key）**：服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **context（上下文視窗）**：AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。

### FAQ

**Q: Claude Code 應該在哪個資料夾打開？**

在你要做事的那個專案資料夾裡開。Claude Code 的預設視野、讀寫範圍、還有專案層的 CLAUDE.md 規則，全都認你開它的位置。在對的資料夾開，讀對檔案、守對規矩;在隨便的位置開，這些全都不確定。一專案一資料夾，就是為了讓「開在哪」永遠有明確答案。

**Q: 資料夾跟檔案可以用中文命名嗎？**

內容裡的中文完全沒問題;建議改英文的是「路徑」，也就是資料夾名與檔名。Windows 上中文路徑大多數時候能用，但有些工具會踩編碼雷：找不到檔案、輸出亂碼(詳見中文亂碼那篇)，而且踩到時很難查。英文命名等於把這一整類問題直接關掉，成本只是取名時多想兩秒。

**Q: Claude Code 可以讀寫專案資料夾以外的檔案嗎？**

可以，但超出工作範圍的動作預設會先問你，這是權限機制在把關。實務建議把「範圍」當第一道安全鎖：專案內的動作放手讓 Claude Code 做，跨到外面的自己按確認。這也是一專案一資料夾的另一個好處：範圍清楚，哪些該問、哪些不用，一目了然。

**Q: 好幾個小專案放同一個資料夾可以嗎？**

起步期可以，東西少的時候混住成本低。該分家的訊號是「規則開始打架」:A 專案要的規矩 B 不適用、CLAUDE.md 越寫越像例外清單，或 AI 常把兩個專案的檔案搞混。出現就拆開，一專案一夾各帶各的規則書，拆完這些問題直接消失。

---

## Claude Code Plan Mode 怎麼用？先規劃再改檔案

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-plan-mode.html
> Claude Code Plan Mode 會先讀專案、提出計畫，不直接改檔案。整理終端機版（CLI）與 Desktop 的開啟方式、核准前要看哪 3 件事，以及何時不必使用。

短答給趕時間的人：Claude Code Plan Mode 是「先研究、再提計畫，核准後才改檔案」的模式。終端機版（CLI）可按 Shift+Tab 切換，或用 /plan 只規劃下一個要求。Claude Desktop 則從輸入框旁的模式選單選 Plan。它適合跨多個檔案、不熟的專案與做錯代價高的改動。只改一句文字時，直接做通常更快。

誠實說，我第一次遇到 Plan Mode 不是學來的，是誤觸。

2026 年 4 月剛入門做第一個網站時，有一段時間 Claude Code「只會出計畫、死都不動手」，我當時完全不知道那是一個模式。

我以為壞了，第一次做網站那篇還列過這個問題。後來才知道，那是被我自己按出來的功能，而且是好功能。

現在角色完全反過來了。

大改動之前我會主動切進去，先看設計圖，再讓 Claude Code 動工。

這篇不只講 Plan Mode 是什麼，也把 CLI 與 Claude Desktop 的操作分開，並整理我核准計畫前一定會看的 3 件事。

### Claude Code Plan Mode 怎麼用？先分清楚操作介面

白話版：Plan Mode 會讓 Claude Code 先讀專案、查現況、提出做法，但不直接修改你的來源檔案。

它仍能讀檔案與執行用來探索的動作，所以不是停擺，也不是只能空想。差別在於真正的修改要等你核准計畫後才開始。

一份值得核准的計畫，至少要說出會動哪些檔案、分成幾步，以及哪一步最可能出錯。只有「我會幫你處理」不算計畫。

這就像裝潢前先看施工圖。圖上連哪面牆要動都沒標，你不會因為它寫得很長就簽名。

操作方式要看你在哪個介面。CLI 可按 Shift+Tab 循環切到 plan，也可在單次要求前輸入 /plan。Claude Desktop 要在 Code 分頁點輸入框旁的模式選單，選 Plan。本站的<a href="/newbie-pitfalls/claude-code-settings-guide.html">Claude Code 設定教學</a>有整理常用模式，<a href="https://code.claude.com/docs/en/permission-modes" rel="noopener noreferrer">Anthropic 的 Plan Mode 文件</a>則用來核對現行操作。

我最早在終端機誤觸 Shift+Tab，才會以為 Claude Code 壞了。Desktop 沒有照搬這組終端機快捷鍵，看到別人的教學時先確認對方用的是哪個介面。

### 我什麼時候主動開(三個場景)

1. 大改動之前，動到整個結構的事(改版、搬移、大重寫)，做錯的代價高。Lab 首頁改版時我就先在計畫模式叫 Claude Code 把改法列成幾個方案，挑一個才動工。事前挑方案花 30 分鐘，省掉的是做完不滿意整組重來的一個下午。
2. 不熟的專案，接手舊東西、或回頭看三個月前自己寫的東西，先切計畫模式說「讀完講給我聽，先不要改」。等現況整理完，你再決定下一步。這時唯讀是一種保護：確定 Claude Code 理解對了，才把工具交出去。
3. 會燒很多額度的長任務，方向錯的長任務等於額度直接蒸發(額度那篇的教訓)。先用一份計畫確認方向，再放手讓 Claude Code 跑，是這類任務最便宜的保險。

這三個做法並不互斥。

計畫模式管「方向對不對」，存檔跟倒帶管「做壞了回得去」。

複雜的大任務我三個都用：先想清楚，開工前存檔，做壞了還能倒帶回去。

### 三個坑：你最可能遇到哪一個？

1. 忘記自己在 Plan Mode，症狀是「只討論、不改檔案」。先看目前模式再重開工具。CLI 看狀態列，Desktop 看輸入框旁的模式選單。確認後切回一般或自動編輯模式即可。
2. 計畫沒看就批准。核准前至少確認 3 件事：會動哪些檔案、分成幾步、哪一步有風險。如果答案含糊，就請它補清楚，不要把長篇文字誤認成完整計畫。
3. 用計畫模式拖延，把計畫改到完美才肯動工，是另一種不動手。計畫是草稿：方向對了就開工，細節做下去本來就會再修，別把計畫模式用成拖延的小理由。

這三個坑我自己都遇過，第一個還不只一次。

共通點是什麼？問題不在功能，在你忘了自己開著什麼模式。

### 新手版起手式：先養一句話的習慣

還不習慣切模式沒關係。

養成一個習慣，效果不會差太多，而且不用記自己在哪個模式。

只想讓下一個要求先規劃，可以在 CLI 輸入 /plan，再接著描述任務。想整段工作都維持規劃狀態，再切到 Plan Mode。

口頭說「先給我計畫，先不要動手」仍有用，但它只是對話要求。Plan Mode 是工具層的限制，適合你真的不能接受 AI 提早改檔案的場合。

我的用法很簡單：小修改用一句話，大改版才切模式。這樣保留安全檢查，也不會讓每件小事都多走一輪批准流程。

等你被「說好先討論、結果它動手了」意外過一次，自然就會想把口頭約定升級成制度。

批准之後，也不是簽了名就不能反悔。

過程中隨時可以按 Esc 暫停、修正方向，真的做壞了還有 rewind 可以反悔。

所以你手上其實有三道關卡：動工前的計畫、中途的 Esc、最壞情況才動用的 rewind。

三道關卡都過了，你才敢把更大的事交給 AI，而差距就是這樣拉開的：敢交辦大事的人，累積速度跟不敢的人完全不同。

### Summary

Claude Code Plan Mode 會先讀專案、提出計畫，核准後才開始修改。CLI 可用 Shift+Tab 切換，或以 /plan 規劃單次要求。Claude Desktop 從輸入框旁的模式選單選 Plan。最適合跨多個檔案、不熟的專案與做錯代價高的工作。核准前要看 3 件事：會動哪些檔案、分成幾步、哪一步有風險。小修改直接做，大改動再把 Plan Mode、git 斷點與 Rewind 串成一套保險。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **Rewind（倒帶）**：Claude Code 內建的復原功能：每次你送出指令前先拍一張檔案快照，按 ESC 兩下或打 /rewind 可以退回之前的狀態。只追蹤 AI 用編輯工具改的檔案，跑指令做的改動不算。

### FAQ

**Q: Claude Code 的 Plan Mode 怎麼開啟跟關閉？**

CLI 可按 Shift+Tab 循環切換模式，也可用 /plan 只規劃下一個要求。Claude Desktop 則從 Code 分頁輸入框旁的模式選單選 Plan。計畫核准後會依你選的執行方式離開 Plan Mode。若 Claude Code 只討論不改檔案，先看目前模式，通常不是工具壞掉。

**Q: Plan Mode 跟直接叫它「先別動手」差在哪？**

兩者方向相同，限制強度不同。口頭要求屬於對話指示，適合小事。Plan Mode 是工具層的規劃狀態，適合跨多個檔案或做錯代價高的工作。我的做法是小修改用一句話，大改版才切模式。

**Q: AI 一直出計畫、就是不動手，是壞了嗎？**

先別重開。CLI 看狀態列，Desktop 看輸入框旁的模式選單。若目前是 Plan，這就是預期行為。切回一般或自動編輯模式後再要求執行。其他卡住原因再看本站的 Claude Code 沒反應排查文。

**Q: 計畫批准之後，它會 100% 照著做嗎？**

不一定。計畫是施工圖，不是逐字劇本。核准前先確認檔案範圍、步驟與風險，執行後再用 git diff 或變更檢視核對結果。中途可以停止修正，做壞了再用 Rewind 或版本紀錄回復。

---

## Claude Code 一直問可不可以？權限設定教學

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-permissions.html
> 每步都先問你，是安全設計不是故障。六種權限模式官方說明白話對照(2.1.258)、設定檔在哪、allow／deny／defaultMode 三個鍵，附我自己那份 14 條 deny 清單可直接抄。

短答給趕時間的人：Claude Code 每個會改變東西的動作(改檔案、跑指令)預設都先問你，這是安全設計不是故障。AI 會犯錯，你是最後一道閘。想少被問，用允許清單：把你信任的動作設成免問，其他照問。我的分界線一句話：「做錯了收得回來嗎？」讀類全放行、專案內的修改放行(有倒帶救得回來)、刪除／發布／送出這類收不回來的，永遠留給自己的手指。

被問到煩，是每個人都會經歷的階段。我自己煩了整整一個月。

做一步問一次，感覺像雇了一個什麼都要請示的助理。你想快，畫面偏要停。

但另一個極端更危險：嫌煩直接全部放行，等於把唯一的煞車拆了。

我從 2026 年 4 月中磨到現在的解法是走中間：允許清單一次放一條，慢慢累積，讓日常幾乎不被打斷，但有幾類動作我到今天一條都沒放行過。

這篇講三個放行等級、我的分界線，還有全自動模式什麼條件下才碰。

### Claude Code 為什麼每一步都要問可不可以？

因為預設不確定是否完整理解。每個會改變東西的動作先問一句，錯誤才會停在「想做」而不是「做了」。

不是笨，是預設不信任自己。

每個會改變狀態的動作，像改檔案、跑指令、裝東西，Claude Code 都先舉手問一句：「我要做這件事，可以嗎？」

因為 AI 真的會犯錯：讀錯意圖、選錯檔案、跑錯指令。這三種我都遇過。

確認機制存在的意義，就是讓錯誤停在「想做」，而不是「做了」。

順帶解掉一個常見的誤會。

<a href="/newbie-pitfalls/claude-code-stuck-not-responding.html">卡住沒反應那篇</a>講過，九成的「沒反應」其實是在等你按確認，畫面上有一個問題等著你，你以為當機了。

所以這篇要解的問題很精確：怎麼少問，但不失控。兩個方向都要，只顧一邊就會出事。

### 不想一直被問，放行有哪三個等級？

三個等級：每次都問、允許清單、全自動。日常主力停在中間那格，把信任的動作設成免問，其他照問。

允許清單怎麼加，兩個入口。

入口一：它問你的時候，選「以後不用再問」那個選項。

這個選項就是在幫你把這條規則寫進清單，累積幾天，常用動作就不再打斷你。

入口二：直接叫 AI 設，「幫我把讀檔和搜尋類的動作加進允許清單」。

AI 知道設定檔在哪、格式怎麼寫。這跟 hooks 篇「第一個 hook 叫 AI 幫你設」是同一招：環境設定類的事，問 AI 最快。

有一件事可以放心：放行紀錄跟著專案走。

專案資料夾裡的設定檔記著這個專案放行過什麼，信任是一個專案一份，不會自動蔓延到別的專案。

你隨時可以叫它唸一遍目前的允許清單，看看有沒有自己沒印象的授權。

### 哪些動作可以設成免問，哪些絕對不要放？

判準只有一句：做錯了收得回來嗎？讀類全放行、專案內的修改放行、刪除發布送出這類永遠手動。

- <mark><strong>讀類，全放行。</strong></mark>看檔案、搜尋、查狀態，看不會弄壞任何東西，而這佔了它日常動作的一大半，光放行這類，打斷就少一大截。
- <mark><strong>寫類，看範圍放行。</strong></mark>專案資料夾內的修改我放行，因為改壞了有 <a href="/newbie-pitfalls/claude-code-rewind-guide.html">rewind 可以倒帶</a>，風險有兜底；跨出專案資料夾的寫入，照問。
- <mark><strong>收不回來的，永遠手動。</strong></mark>刪除、發布上線、把東西送出去(訊息/貼文/郵件)，這類動作錯一次就追不回，倒帶也救不了已經送出去的東西。我到今天一條都沒放行過。

一句判準：「做錯了收得回來嗎？」收得回來的往清單放，收不回來的留給自己的手指。

這跟<a href="/newbie-pitfalls/claude-code-telegram-remote.html">遙控那篇的三道鎖</a>(白名單、預設關、攔截)，是不是同一個道理？

方便和安全之間，用「範圍」切，不是全開或全關二選一。

範圍切得好，你可以同時拿到九成的方便，和關鍵處的安全。不必二選一。

### 全自動模式該不該開？三個條件缺一不可

三個條件同時成立才開：任務只在專案資料夾裡跑、做壞了救得回來、內容不含刪除發布送出。

有一種<a href="/newbie-pitfalls/claude-code-settings-guide.html">「全部別問」的跑法</a>。長任務時很誘人。

睡前丟任務、不用顧著按確認、早上起來收貨。

我真的會用。但只在三個條件同時成立的時候。

①圈好地：任務只在那個專案資料夾裡跑，碰不到別的東西。②做壞可回復：有 rewind 或 git 斷點救得回來。③任務內容不含刪除、發布、送出這類收不回來的動作。

三個缺任何一個，乖乖回允許清單模式。少一個都不行。

最後補一個很多人沒想到的成本。

全自動代表 AI 會自己連跑很多動作，<a href="/newbie-pitfalls/claude-code-usage-limits.html">額度燒得比你在旁邊看著快</a>。

所以就算三個條件都齊，長任務放手前也先想一下值不值。

全自動是把「按確認的時間」換成「額度與風險」，這筆帳每次都要重算。

### 權限模式有哪幾種？設定檔又在哪裡？

2026 年 9 月的 2.1.258 版一共六個模式可選：manual、acceptEdits、plan、auto、dontAsk、bypassPermissions。設定寫在 settings.json 的 permissions 底下。

版本一改選項就會變，看到跟你畫面上不一樣，以你的畫面為準。

六個模式的官方說明是這樣，我把它翻成白話。

- manual（畫面上也叫 default）：標準行為，危險動作才問你。這是預設值
- acceptEdits：改檔案自動放行，跑指令還是問
- plan：計畫模式，完全不動手。它先講計畫，你點頭才換模式開工（<a href="/newbie-pitfalls/claude-code-plan-mode.html">計畫模式那篇</a>講得更細）
- dontAsk：不跳出詢問，但沒事先核准過的動作直接擋掉。跟全放行剛好相反，是「不問也不做」
- auto：交給一個模型判官逐次決定放行或擋下
- bypassPermissions：全部跳過。要另外開一個允許旗標才用得了，等於官方也認為這需要多一道手續

這六句是我從安裝檔裡的官方說明抓出來翻的，不是從別人文章轉的。寬鬆程度由緊到鬆是：plan → manual／dontAsk → acceptEdits → auto → bypassPermissions。

設定檔有兩層：使用者層在你的家目錄底下的 .claude/settings.json，專案層在專案資料夾裡的 .claude/settings.json。專案層只管那個專案。<a href="/newbie-pitfalls/claude-code-settings-guide.html">設定檔那篇</a>有完整的位置與改法。

permissions 底下三個鍵：allow 是允許清單、deny 是禁止清單、defaultMode 是這台機器預設用哪個模式。

deny 是很多人不知道的那一半。

不管模式開得多鬆，寫進 deny 的東西一律擋下來。與其糾結模式要開多鬆，不如先把 deny 寫好，那是唯一一道不管你怎麼設都還在的底線。

### 我自己現在怎麼設？先有護欄才放開模式

我自己現在是全放行，但那是最後一步，不是第一步。

一開始我用 plan 跟 acceptEdits，一步一步來。後來任務越接越大，一次要跑幾十個動作，一直按同意變成主要的時間成本。

所以我改成 bypassPermissions，但同時補上兩層護欄：一份 deny 清單，加上幾個 <a href="/newbie-pitfalls/claude-code-hooks-guide.html">hook</a> 在動作前後做檢查。

順序很重要。<strong>先有護欄，才放開模式</strong>，不是反過來。護欄還沒架好就先開全放行，那不是效率，是賭博。

我那份 deny 清單 14 條，整份貼給你抄：

- Bash(rm -rf *)、Bash(rm -fr *)、Bash(rm -r *)、Bash(rm -R *)　刪整個資料夾的四種寫法
- Bash(sudo *)　用最高權限跑任何東西
- Bash(dd *)　直接寫硬碟區塊，寫錯一次整顆碟報銷
- Bash(mkfs*)　格式化
- Bash(diskutil erase*)　抹掉磁碟（Mac）
- Bash(chmod 777 *)、Bash(chmod -R 777 *)　把權限開到全世界可讀可寫
- Bash(shutdown*)、Bash(reboot*)　關機重開
- Bash(: >*)、Bash(truncate *)　把檔案內容清空

共通點是：這些指令做錯一次都收不回來，跟前面那條分界線是同一個判準，只是換成用清單擋死。

要抄的話直接把這 14 條貼進 settings.json 的 permissions.deny 就行，不會影響你平常的用法。

### Summary

Claude Code 每個會改變東西的動作預設先問你，這是最後一道閘，不是故障；九成「沒反應」其實是在等你按確認。想少被問用允許清單(推薦的中間路線)：問的時候選「以後不用再問」累積放行，或叫 AI 幫你把整類動作加進清單；紀錄跟著專案走，可隨時叫它唸一遍。分界線用「做錯收不收得回來」切：讀類全放行(占日常動作大半)、專案內寫類放行(rewind 兜底)、刪除/發布/送出永遠手動，跟遙控機器人三道鎖同哲學：用範圍切，不是全開全關二選一。全自動模式只在三條件齊備時用：圈好地+可回復+不含收不回來的動作；而且它燒額度比看著快，放手前重算值不值。六種模式的官方說明白話對照與設定檔位置在文中。我自己現在是 bypassPermissions 全放行，但配一份 14 條 deny 清單與幾個 hook 當護欄——順序是先有護欄才放開模式，那份清單文中整份貼出可直接抄。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **權限模式**：Claude Code 決定「哪些動作要先問你」的總開關。2.1.258 版有六種：manual(危險動作才問)、acceptEdits(改檔案免問)、plan(只講計畫不動手)、dontAsk(不問，但沒核准過的直接擋)、auto(交給模型判官逐次決定)、bypassPermissions(全部跳過)。
- **允許清單**：寫在設定檔 permissions.allow 底下的免問名單。把你信任的動作放進去，Claude Code 就不會每次都停下來問，其他沒列到的照樣問。信任一個專案一份，不會蔓延到別的專案。
- **禁止清單**：寫在設定檔 permissions.deny 底下的一份指令黑名單。不管權限模式開得多鬆，清單裡的東西一律擋下來，是唯一一道不隨模式改變的底線，常用來擋 rm -rf、sudo 這類跑錯一次就收不回來的指令。

### FAQ

**Q: 怎麼讓 Claude Code 不要一直問我？**

用允許清單，別直接跳全自動。兩個入口：它問的時候選「以後不用再問」(等於把這條加進清單，累積幾天常用動作就不再打斷)；或直接叫 AI「幫我把讀檔和搜尋類動作加進允許清單」，它知道設定檔在哪。讀類動作占日常大半，光放行這類，被問次數就少一大截。

**Q: 哪些動作可以放心設成免問？哪些千萬別放？**

判準一句：「做錯了收得回來嗎？」讀類(看檔案/搜尋/查狀態)全可放行；專案資料夾內的修改可放行，前提是你有 rewind 或 git 斷點兜底；刪除、發布上線、送出訊息這類收不回來的，永遠手動按，倒帶救不了已經送出去的東西。

**Q: 全自動模式(全部不問)安全嗎？**

條件式安全。三個條件同時成立才考慮：任務圈在單一專案資料夾內、做壞了有 rewind/git 可回復、任務不含刪除/發布/送出類動作，缺一個就回允許清單模式。另外全自動會讓它連跑大量動作，額度燒得比互動時快，長任務放手前先想值不值。

**Q: 「以後不用再問」按錯了，怎麼反悔？**

放行紀錄存在專案的設定檔裡，叫 AI「打開權限設定，把那條移除」就好，不用自己翻格式。建議順手請它把目前的允許清單唸一遍，用了幾週的人常會發現清單裡有幾條自己沒印象的授權，定期檢視跟定期刪 CLAUDE.md 過時規則是同一種衛生習慣。

**Q: Claude Code 的權限設定檔在哪裡？**

兩層。使用者層在家目錄的 .claude/settings.json，管這台機器全部的專案。專案層在專案資料夾裡的 .claude/settings.json，只管那個專案。權限設定在 permissions 這個鍵底下，包含 allow(允許清單)、deny(禁止清單)、defaultMode(預設用哪個模式)。不想自己編輯檔案的話，直接叫 AI 幫你設最快，它知道格式怎麼寫。

**Q: 有沒有辦法讓某些指令永遠不准跑？**

有，寫進 deny 清單。不管你的模式開得多鬆，甚至開了 bypassPermissions 全部跳過，deny 裡的東西一樣會被擋下來。我自己那份 14 條擋的是 rm -rf、sudo、dd、mkfs、chmod 777、shutdown、truncate 這類跑錯一次就回不去的指令，文章裡整份貼出來可以直接抄。順序是先有護欄再放開模式，不是反過來。

---

## Claude Code 斜線指令：重複的長指示變一鍵

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-slash-commands.html
> /compact、/model 之外，斜線指令能自己造：重複打的指示存成範本，/ 加名字直接執行，能帶參數。我的決策紀錄從嫌麻煩變 1 分鐘一筆。附做法 4 步與 skill/hook 分工表。

短答給趕時間的人：斜線指令就是對話裡打 / 開頭的快速指令。/compact、/model 這些本來就有的，你可能已經在用。重點是可以自己造。把你重複打過很多次的那一大段指示存成一個檔案，之後打 / 加名字，整套範本直接生效，後面還能接參數。最快的做法是直接叫 AI「把這段指示存成斜線指令」，Claude Code 自己知道檔案該放哪、格式該怎麼寫。

我對斜線指令有感的瞬間，是「決策紀錄」這件事。

我做重要決策的時候想留一筆紀錄，記下當時是怎麼想的、為什麼選這條路，但每次都要開檔案、想格式、寫完歸檔。

嫌麻煩的結果就是不記。

後來我把整套流程存成一個自訂指令。打一行、口述結論，Claude Code 就按固定格式寫好、編號、歸檔。前後一分鐘。

這件事讓我看清一個問題：我不記決策紀錄，不是因為不會記，是因為嫌麻煩。

指令做的事，就是把麻煩壓到我願意動手的程度。

### 斜線指令是什麼：你其實已經在用了

這個系列一路下來，你已經見過好幾個。/compact 壓縮對話(context 篇)、<a href="/newbie-pitfalls/claude-code-model-switch.html">/model 換模型</a>。還有 /usage 看額度、/memory 看筆記。

這些是本來就有的指令，打 / 會跳出清單，選了就執行。

自訂斜線指令是同一套機制開放給你：一個文字檔等於一個指令，檔案內容就是你想對 AI 說的那段話，檔名就是指令名。

像手機輸入法的罐頭訊息。

差別在罐頭裡裝的不是一句話，是一整套交辦：背景、格式、步驟、去哪找資料，全部一次寫進同一個檔案，下次直接叫出來用。

### 20 分鐘做出第一個，要做哪 4 步？

1. 第 1 步，找素材。翻你最近的對話，哪一大段指示你打過(或貼過)三次以上？那就是第一個指令的內容。重複三次是門檻，沒到三次的，先不值得存成指令。
2. 第 2 步，叫 AI 幫你建。直接說「把這段指示存成一個斜線指令，叫 /名字」。Claude Code 知道檔案該放哪個資料夾、格式怎麼寫，跟 hooks 篇「第一個 hook 叫 AI 幫你設」是同一個做法。環境設定類的事問 AI 最快，你不用先學檔案結構。
3. 第 3 步，開新對話測試。打 /名字，看是不是照範本做。走樣就叫 AI 修範本，改到順為止;範本是檔案，隨時可以再改。
4. 第 4 步，加參數。範本裡可以留「填空格」，指令後面接的字會填進去，同一個指令就能吃不同輸入，例如「/翻譯 接一段文字」「/紀錄 接今天的結論」。

拿我的決策紀錄指令當實例走一遍，那個範本裡到底寫了什麼？

範本裡寫的是「按固定格式建一筆決策紀錄：背景、選項、我選了什麼、為什麼;編號接續現有的;存進指定資料夾」。

之後每次打指令、口述結論，一分鐘歸檔。從 2026 年 4 月中到現在，這個資料夾已經累積成一疊。

全是以前那種「嫌麻煩就算了」的東西。

### 指令、skill、hook 到底差在哪？

三個常一起用，以寫貼文為例。斜線指令開頭，把固定流程一鍵展開。skill 提供方法，自動翻出你的文案規範。hook 收尾，強制跑檢查。

但初學不用全上。先做哪一個？從斜線指令開始最好懂。

因為斜線指令最像你本來就在做的事，就是打字交辦，只是這段話先存成檔案，下次不用重打一遍。

### 三個坑，我自己都掉過

1. 範本沒寫完整。寫的時候假設「AI 記得上下文」，結果新對話一打全走樣。範本要當成寫給「第一天上班的助理」，背景、格式、去哪找資料全寫進去，跟 CLAUDE.md 篇是同一個寫作標準：不依賴任何「AI 應該知道」。
2. 收藏癖。什麼都做成指令，最後指令多到自己都記不住，變成另一種混亂。門檻放在「重複三次」，一次性的事，直接講比較快。
3. 做完就忘。指令做好了，三週後連自己有這東西都忘了。我的解法是把常用指令列進 CLAUDE.md 的目錄區(「要記決策 → 用 /xxx」)，AI 對到相關情境會提醒你，讓規則書幫你記得工具箱裡有什麼。

### Summary

斜線指令是對話裡 / 開頭的快速指令：本來就有的那些(/compact /model /usage)你可能已在用，自訂版就是把重複打的一大段指示存成檔案，檔名等於指令名，打 / 加名字整套範本生效、後面可接參數。做法 4 步：找出重複三次以上的指示，叫 AI 幫你建(Claude Code 知道檔案放哪)，開新對話測試再修，最後加參數吃不同輸入。我的實例：決策紀錄從「嫌麻煩就不記」變成 1 分鐘一筆。跟 skill、hook 的分工：指令是你主動叫的固定流程、skill 是 AI 自動翻的做事方法、hook 是系統強制的檢查。三個坑：範本沒寫完整(要寫給第一天上班的助理)、收藏癖(重複三次才收)、做完就忘(把指令列進 CLAUDE.md 目錄讓 AI 提醒你)。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **斜線指令（slash command）**：Claude Code 對話裡以 / 開頭的快速指令，例如 /compact、/model。除了內建的，也能把自己常用的一段指示存成檔案變成自訂指令，打 / 加名字直接執行。
- **skill（技能包）**：Claude Code 的知識外掛：一個資料夾放一份說明書（SKILL.md），教 AI 特定領域的做事方法。對到相關任務時 AI 會自己翻出來照著做。
- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。

### FAQ

**Q: Claude Code 的自訂斜線指令怎麼建立？**

最快的路是把你常打的那段指示丟給 AI，說「把這段存成一個斜線指令，叫 /名字」。Claude Code 知道檔案該放哪個資料夾、格式怎麼寫，你不用先學結構。建好後開新對話打 /名字 測試，走樣就叫 AI 修範本。手動路線也行：指令就是一個文字檔，檔名等於指令名，內容等於你要說的話。

**Q: 斜線指令跟 skill 差在哪？什麼時候用哪個？**

差在誰觸發：斜線指令是你主動打才執行，適合固定流程(記錄、週報、檢查清單);skill 是 AI 判斷任務相關就自動翻出來，適合某個領域的做事方法(文案規範、程式風格)。簡單記：想「我來叫」用指令，想「AI 自己知道」用 skill;必須 100% 發生、不能靠記得的，用 hook。

**Q: 斜線指令可以帶參數嗎？**

可以。範本裡留「填空格」，指令後面接的內容會填進去，例如 /翻譯 後面貼一段文字、/紀錄 後面講今天的結論，同一個指令吃不同輸入。這是指令從「罐頭訊息」升級成「小工具」的關鍵一步，建議第一個指令跑順之後就試。

**Q: 打了自訂指令沒反應或找不到，怎麼辦？**

三個常見原因：名字打錯(打 / 看清單裡有沒有)、檔案放錯資料夾、或該重開對話讓 Claude Code 重新載入。最快的排查法還是同一個：直接問 AI「檢查我的自訂指令為什麼沒生效」，讓 AI 自己看檔案位置與格式，環境問題交給 AI 自己查，比你爬文快。

---

## Claude Code 要裝 WSL 嗎？Windows 直接跑就好

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-wsl.html
> 2026 年的答案：不用，已原生支援 Windows — 照舊教學先裝 WSL 是繞遠路。WSL 是什麼、誰才需要，我踩過的三個坑：裝半套、兩邊版本各走各的、路徑混用必炸又慢。

短答給趕時間的人：2026 年裝 Claude Code 不需要 WSL，Claude Code 已經原生支援 Windows，照 Windows 安裝篇直接裝就能跑。網路上「第一步：安裝 WSL」的教學是 2025 年早期的產物，當時 Windows 確實要靠 WSL，現在照做是繞遠路。WSL 白話講，就是在 Windows 裡面再開一台「小型 Linux 電腦」的功能，少數需要 Linux 環境的工具用得到，遇到再裝，隨時能補裝。

我 2026 年 4 月入門那天就是直接裝在 Windows 上，全程沒碰 WSL。到今天主力工作也都在原生環境。

但我電腦上確實也跑著 WSL，為了一個天生屬於 Linux 的工具。

而且該遇到的問題我都遇過了：裝半套開不起來、兩邊版本各走各的、路徑混用出錯。

這篇把「要不要裝」的判斷，和真的要裝時的三個問題，一次講清楚。

### 先講答案：2026 年，直接原生裝

Claude Code 剛出的年代(2025 年初)，Windows 上要靠 WSL 才能跑。

所以那個時期的教學都把「裝 WSL」寫成第一步，這些文章現在還排在搜尋結果前面。

但現在的情況已經變了。

官方原生支援 Windows，開 PowerShell 照 Windows 安裝篇走完就能用。

所以看到叫你先裝 WSL 的教學，第一件事要做什麼？看那篇的發文日期。

那 WSL 到底是什麼？

一句白話：微軟讓你在 Windows 裡面再開一台「小型 Linux 電腦」的功能。

Linux 是另一個作業系統家族，伺服器與許多開發工具的老家。

兩台電腦共用你的硬碟，但各自有各自的系統、工具和習慣。

記住「它是另一台電腦」這個畫面，後面三個問題你就都能預判了。

### 那 WSL 什麼時候有用？

先講我自己的誠實現況。

電腦上確實有一個工具跑在 WSL 裡，那東西天生是 Linux 的，硬搬到 Windows 比裝一個 WSL 更折騰。

但那是我從 2026 年 4 月中用到現在的唯一特例。

其他所有專案，包括這個網站、每天在跑的自動化機器人，全在原生 Windows。

之前查證 Codex 那篇時也看到同款注記：少數需要 Linux 工具的場景，官方仍建議搭配 WSL。

關鍵詞是「少數」。WSL 隨時能補裝，不需要預防性安裝。

### 真的要裝的話，會踩到哪三個坑？

1. 裝半套。wsl --install 跑完顯示成功，其實還要重開機才算完;有的電腦還得進 BIOS 把虛擬化功能打開(開機時按特定鍵才進得去的那個設定畫面)。卡在「明明裝了卻開不起來」的人，九成是這兩步沒做完。
2. 兩邊各裝各的。WSL 是另一台電腦：你在 Windows 裝好的 Node.js、設定好的環境，WSL 裡通通沒有，要重裝一份;而且兩邊版本各走各的。我踩過 WSL 裡的 node 版本跳來跳去，Windows 這邊修好的東西，那邊照樣壞。修了半天才想起來，我根本修錯台電腦。
3. 路徑與速度。Windows 的 C:\ 在 WSL 裡叫 /mnt/c，兩套寫法混在同一個指令裡一定出錯;更隱形的是跨系統讀檔很慢，檔案放 Windows、程式跑 WSL(或反過來)，速度可以差好幾倍。原則一句：檔案跟工具住同一邊。

### 判斷表收尾+一個通用提醒

收尾判斷。新手直接原生裝，照 Windows 安裝篇走、亂碼問題配亂碼篇，那兩篇加起來就是你需要的全部。

已經裝了 WSL 而且一切順的人，不用搬，能跑就是好架構。

覺得卡卡的人，問自己一句：「我有用到任何 Linux 限定的東西嗎？」

沒有的話，搬回原生通常一小時內搞定。

這種環境搬家的活，直接叫 Claude Code 教你搬，比爬文快。

最後一個通用提醒。價值超過這篇其他所有內容。

在兩個世界並存的電腦上，遇到怪問題先確認「我現在到底在哪一邊」。

看終端機的提示字串長什麼樣、路徑開頭是 C:\ 還是 /。

我在 WSL 遇到的問題，一半以上原因都是「以為自己在 A，其實在 B」。

搞清楚位置，一半的怪問題自動消失。

### Summary

2026 年裝 Claude Code 不需要 WSL：已經原生支援 Windows，「第一步裝 WSL」是 2025 年早期教學的過時產物，看到先查發文日期。WSL 就是在 Windows 裡再開一台小型 Linux 電腦，兩台共用硬碟但各有系統與工具;用武之地是「某工具只支援 Linux」「常跟 Linux 教學做事」這種少數場景，遇到再裝，隨時能補裝，不用預防性安裝(我 2026-04 起主力全原生，只有一個 Linux 原生工具跑 WSL)。真要裝的三個坑：wsl --install 只裝半套(要重開機、要在 BIOS 開虛擬化)、兩邊各裝各的(Node.js 與環境要重來，版本各走各的，小心修錯台電腦)、路徑與速度(C:\ 在 WSL 叫 /mnt/c，混用一定出錯;跨系統讀檔慢好幾倍，檔案跟工具住同一邊)。通用提醒：遇到怪問題先確認自己在哪一邊。

### 名詞解釋

- **WSL（Windows Subsystem for Linux）**：微軟提供的功能：在 Windows 裡面跑一個 Linux 子系統，像電腦裡再開一台小電腦。需要 Linux 環境的工具靠它就能在 Windows 上用，但檔案與工具分屬兩個世界，混用容易踩坑。
- **Linux**：跟 Windows、macOS 並列的作業系統家族，伺服器與許多開發工具的主流環境。不少教學的指令以它為前提寫成，搬到 Windows 有時要翻譯。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **Node.js**：讓電腦能執行 JavaScript 程式的基礎環境。Claude Code 的 npm 舊裝法才需要先裝它；2026 年官方推薦的 native 一行安裝不用。免費，從官網 nodejs.org 下載安裝。
- **PATH（環境變數）**：系統的「去哪裡找程式」清單。指令打了卻顯示找不到，九成是程式所在的資料夾沒被加進這份清單。

### FAQ

**Q: 2026 年在 Windows 裝 Claude Code,還需要先裝 WSL 嗎？**

不需要。Claude Code 已原生支援 Windows，開 PowerShell 照安裝步驟走就能跑，我 2026 年 4 月入門起全程原生，網站與自動化機器人都在上面做。要求先裝 WSL 的教學是 2025 年早期的產物，照做等於繞遠路;判斷法很簡單：先看那篇教學的發文日期。

**Q: WSL 是什麼？裝了會不會影響 Windows？**

WSL(Windows Subsystem for Linux)是微軟的功能：在 Windows 裡面跑一台「小型 Linux 電腦」，給需要 Linux 環境的工具用。兩邊共存、不會弄壞 Windows，但要知道：它是另一台電腦，佔硬碟空間、工具要另外裝一份、檔案與路徑分屬兩個世界。沒有明確需求的話，不用預防性安裝。

**Q: wsl --install 跑完了，怎麼好像沒裝好？**

九成卡在兩步：一是要重開機才算裝完(指令跑完顯示成功很會騙人);二是部分電腦要進 BIOS 把虛擬化功能打開，沒開的話 WSL 根本啟動不了。這兩步做完還不行，把錯誤訊息貼給 Claude Code 讓它帶你查，環境問題交給 AI 自己查，比自己猜快。

**Q: 檔案該放 Windows 這邊還是 WSL 裡面？**

跟工具住同一邊：程式在哪邊跑，檔案就放哪邊。跨邊讀寫(檔案在 Windows、程式在 WSL，或反過來)不只路徑容易錯(C:\ 與 /mnt/c 兩套寫法)，速度還會慢好幾倍，這是 WSL 最隱形的坑。如果發現自己常常需要跨邊，通常代表這個專案放錯世界了，搬到同一邊一勞永逸。

---

## Claude Code 看得懂圖：截圖報錯直接貼

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-screenshot-workflow.html
> Claude Code 看得懂截圖：終端機報錯直接截、網頁要改哪畫圈、Vercel 後台整頁丟、貼參考圖仿設計 — 我天天在用的四個場景。怎麼貼、何時該給文字不給圖、敏感資訊注意。

短答給趕時間的人：Claude Code 看得懂圖片，截圖直接貼進輸入框，或把圖檔拖進視窗都行。報錯文字讀得出來，網頁排版看得懂，設計風格也抓得到。四個我天天在用的場景：①終端機報錯整個截圖丟過去 ②網頁要改哪裡，截圖畫個圈 ③Vercel 後台的錯誤紀錄整頁丟 ④貼一張喜歡的設計叫它照這個方向做。文字描述半天講不清的事，常常一張圖就搞定。

這可能是我用得最勤、卻最少人教的功能。

多數教學花力氣教你「怎麼把需求描述清楚」，但對非工程師來說，有些東西根本不適合用文字描述。

那個報錯的術語怎麼唸？那塊版面叫什麼名字？你都不知道。

我的解法很土：看到什麼就截什麼，圈起來，丟過去。

這個網站的像素風頁面跟我的 link-in-bio 入口，當初都是貼參考圖讓 AI 照著方向做的。

這篇把四個場景、給圖的方法，還有圖不適合的時機一次講完。

### 先講怎麼給：三步，比傳 LINE 圖還簡單

1. Step 1，截圖：Windows 按 Win+Shift+S 框選你要的範圍，截完自動進剪貼簿;要畫圈就順手用內建的截圖工具或小畫家，紅筆圈一下重點。
2. Step 2，給它：回到 Claude Code 的輸入框直接貼上;如果貼不進去，把圖存成檔案、用滑鼠拖進視窗(等於把檔案位置交給它)再送出，效果一樣。
3. Step 3，配一句話：圖負責「在哪裡、長怎樣」，你的話負責「要幹嘛」，「這個報錯怎麼解」「圈起來的區塊往左移」「配色照這張的方向」。圖加一句意圖，就是完整的交辦。

### 我的四個日常場景(全部真實)

第一個場景最日常：終端機的報錯有時一大串、有時被視窗截斷，複製起來很煩。

我直接整個畫面截過去。

好處不只省事。AI 看到的是「哪個指令、跑出什麼、在哪一步出錯」的完整脈絡，比你只貼一句錯誤訊息還好診斷。

Vercel 這類雲端後台的報錯同理，錯誤紀錄頁面直接截，不用手抄。

第二個場景是改網頁。「那個標題下面那塊再往上一點」這種話，文字講十次有八次被誤會。

現在我截圖、紅筆圈起來、配一句「圈的地方間距太擠」。

誤會率大幅下降，因為圖已經把「位置」講死了，文字只要負責「意圖」。

第四個場景最好玩：仿設計。

這個網站的像素風頁面、我的 link-in-bio 個人入口，當初都是我丟參考圖說「風格往這個方向」做出來的。

先講清楚期望：仿的是配色、排版、氛圍這種「方向」，不是像素級複印。

丟圖之後還是要來回修幾輪，但比用形容詞從零描述快非常多。

### 什麼時候該給文字，不該給圖？

圖是不是萬能？當然不是。

分界線一句話：「位置與樣子」用圖，「精確的字元」用文字。

表格數字、長段程式碼、一長串網址，這些要從圖裡一個字一個字「認」出來，認錯一個字元，你就往錯的方向查問題。

能複製成文字的，永遠優先給文字。

我的混合技是兩個一起給：報錯畫面截圖給脈絡，再把關鍵那行錯誤訊息複製成文字一起貼，給精確字元。

兩個各司其職，診斷又快又準。這招對付疑難雜症的成功率，比單給任何一種都高。

口訣：圖管「在哪、長怎樣」，字管「精確內容」。兩個都給，是最強的問法。

### 三個坑，加一個起手式

1. 整頁全截+「幫我看哪裡怪」，大海撈針，它會給你一堆你沒問的觀察。截圖跟提問一樣要聚焦：裁小範圍、畫圈、一張圖講一件事。
2. 敏感資訊入鏡，截圖最容易不小心外洩：後台頁面角落的 email、設定畫面裡的金鑰、數據報表。貼之前掃一眼，該遮的遮(這跟「金鑰三不」是同一族的衛生習慣，見登入那篇)。
3. 字太小或糊，縮圖、低解析度的截圖，它讀字會出錯。截原尺寸、框重點區域，別把整個 4K 螢幕縮成一張小圖丟過去。

新手起手式：下次終端機跳紅字，忍住不要複製貼上，先截圖丟過去試一次。

你會發現「把問題交出去」的門檻比想像中低得多。

對非工程師來說，貼截圖這套工作流真正的價值是：你不需要知道那個東西叫什麼名字，也能把問題問清楚。

### Summary

Claude Code 看得懂圖片：截圖貼進輸入框或把圖檔拖進視窗，配一句意圖就是完整交辦。四個天天在用的場景：終端機報錯整畫面截(連脈絡一起看，比手動複製完整)、網頁要改哪截圖畫圈(圖講死位置、文字只管意圖，誤會率大降)、Vercel 後台錯誤紀錄整頁丟、貼參考圖仿設計(本站像素風頁面與 link-in-bio 都是貼參考圖做的，仿方向不是複印)。分界線：位置與樣子用圖，精確字元(程式碼/數字/網址)用文字;混合技=截圖給脈絡+關鍵錯誤訊息複製成文字，成功率最高。三個坑：整頁全截不聚焦、敏感資訊入鏡沒遮、圖太小讀字出錯。核心價值：不知道東西叫什麼名字，也能把問題問清楚。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。

### FAQ

**Q: Claude Code 可以看圖片或截圖嗎？**

可以，而且看得懂內容：報錯訊息的文字、網頁的排版結構、設計的配色風格都讀得出來。給法兩種：截圖後直接在輸入框貼上，或把圖檔用滑鼠拖進視窗。記得配一句話講你要它做什麼，圖負責「在哪裡、長怎樣」，你的話負責「要幹嘛」。

**Q: 貼截圖跟複製錯誤訊息文字，哪個比較好？**

能複製成文字的優先給文字，精確字元(程式碼、數字、網址)從圖裡「認」可能認錯。截圖的強項是脈絡與位置：複製不到、被截斷、或需要「前後畫面」才能判斷的狀況。最強的是混合技：截圖給脈絡+關鍵那行錯誤複製成文字，一起貼。

**Q: 可以叫它照一張設計圖做網頁嗎？**

可以，我的像素風頁面跟 link-in-bio 入口都是貼參考圖做出來的，丟圖說「配色與排版照這個方向」。期望要對：它仿的是風格方向(配色/佈局/氛圍)，不是像素級 1:1 複印，丟圖後仍要來回修幾輪;但比用形容詞從零描述快非常多，而且不會雞同鴨講。

**Q: 貼截圖有什麼要注意的？**

三件事：①聚焦，裁小範圍、畫圈，一張圖講一件事，整頁全截等於叫它大海撈針 ②敏感資訊，後台截圖常夾帶 email、金鑰、數據，貼之前掃一眼該遮的遮 ③解析度，字太小或圖太糊會讀錯，截原尺寸、框重點區域就好。

---

## Claude Code 分身怎麼管？派工、驗收、平行作業

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-model-dispatch.html
> AI 分身派出去之後怎麼管：派工單三要素、同一個方法最多試兩次、驗收交給沒參與過程的新分身、兩個分身用 git worktree 同時改一個專案不打架。非工程師的實測版。

短答給趕時間的人：AI 分身(subagent，另開的獨立對話)好用之後，真正的門檻不是技術，是管理。我的派工制度三條：①派工單三要素，也就是目標與動機、驗收條件、回報格式，缺一不派 ②模型分級，機械活用快的便宜的、預設用主力、卡關才上最貴的 ③同一個方法最多試兩次，第二次還失敗就換方法或升級模型，不准原樣試第三次。外加一條鐵律：自己做出來的東西自己檢查等於沒檢查，驗收要交給沒參與過程的新分身。

這篇是 <a href="/newbie-pitfalls/claude-code-subagent-guide.html">Subagent 教學</a>的續集。

上一篇講分身是什麼、怎麼派。用了一陣子之後我發現，問題跟帶人一模一樣。

交辦不清楚，做出來的就不能用。

不驗收，你不知道能不能用;失敗了拗著同一個方法重試，燒掉的是你的額度。

所以我把派工規則寫成一份守則檔，放在 AI 每個對話都會讀到的地方，叫 AI 照著做。

這篇把那份守則白話拆開。附一個實測：2026 年 7 月 19 日，我用這套讓兩個分身同時改同一個專案的不同角落，零衝突，全程我只讀了兩份回報。

### 哪些工作該派給 AI 分身，哪些留在主對話做？

判準是佔不佔腦容量：要讀三個以上檔案、掃整個專案、查外部資料的活派出去，主對話只收結論。

先講一個限制：AI 的「工作記憶」(context window，也就是一個對話能記住的內容量)是有限的。

你在主對話裡讓 AI 讀十個檔案、貼五段錯誤訊息，那些過程中冒出來的東西會一直佔著記憶。

塞得越滿，AI 越容易忘東忘西。

派工制度的第一條就是保護主對話。什麼該派出去？費工又占地方的雜事派出去做，主對話只收結論。

判準一句話：這個動作過程中冒出來的東西，會不會佔掉主對話的腦容量？會就派出去，只收結論。

### 派工單要寫什麼，AI 才不會做出不能用的東西？

派工單三個要素缺一不派：目標與動機、可以逐條打勾的驗收條件、規定回什麼與多長的回報格式。

1. 要素 1，目標與動機。做什麼，加上為什麼要做。動機不是廢話：分身遇到你沒料到的狀況時，知道動機才能自己取捨，不用停下來回頭問你。
2. 要素 2，驗收條件。可以逐條打勾的完成定義。我的經驗是，寫不出驗收條件通常代表你自己還沒想清楚要什麼，這時先想清楚，比先派工省時間。
3. 要素 3，回報格式。規定回什麼、多長。我的固定格式是先講結論，證據附出處位置，超過 30 行的產出寫進檔案只回報路徑，禁止把整份檔案貼回來。

這三件事寫起來大概多花兩分鐘，省下的是「做出來不能用、整個重派」的整輪時間。

跟交辦同事一樣，一開始講清楚，後面才不用一直來回問。

### 同一個方法失敗兩次，該再試一次還是換模型？

不要原樣再試第三次。第二次還失敗代表方法錯了，不是運氣差，要換方法、升一級模型，或停下來問人。

原則一句話：省錢不是重點。

重跑一次的成本，比一開始就用對模型高得多。

不確定該不該用便宜的？就往上選一級。

不確定該不該直接上最貴的，先讓主力跑一輪，主力那一輪的失敗過程整理起來，就是給最貴模型最好的輸入。

升降級規則：同一個子任務、同一個方法，最多執行兩次(第一次加重試一次)。

第二次還失敗呢？禁止原樣試第三次。

必須換方法、升一級模型，或停下來問人。

便宜等級是例外：失敗一次就直接升級，不給重試。為了省錢重試便宜模型，通常反而省不到。

升級時要帶著完整的失敗紀錄，包括每次試了什麼、錯在哪、當時的假設。

不帶紀錄的升級，等於讓貴的模型把冤枉路重走一遍。

反過來，難題一旦解出模式，就把解法寫成明確步驟，降回便宜模型批次套用。

難的部分讓貴的模型解一次，剩下的重複工作交給便宜的做完。

### 兩個 AI 分身可以同時改同一個專案嗎？

可以，但兩個分身要各拿一份獨立的工作目錄，改完再合併；共用同一個資料夾同時動手，一定互相蓋掉。

工具叫 git worktree：同一個專案開出多份獨立的工作目錄，一份給分身 A，一份給分身 B，兩邊各改各的，最後合併回來。

2026 年 7 月 19 日我這樣跑過一次，讓兩個分身同時改同一個開源專案的不同角落。

分身 A 實跑工具掃我的網站(當時 123 頁，1.42 秒)產出範例報告，分身 B 讀程式碼確認設定檔格式，再寫一份範本。

兩個分身同時動手、互不干擾，合併時零衝突。

我全程只做三件事：開副本、派工、讀兩份回報然後合併。

這就是「指揮官不下場」的樣子。

零衝突不是運氣。動手之前，兩份工作就被切成不碰同一批檔案的兩塊。

這才是平行作業真正的門檻：不是工具難裝，是你要先把工作切乾淨。

切不乾淨就別平行。兩個分身改同一批檔案，合併時你要一行一行看誰對，省下來的時間全部還回去。

### AI 分身做完的東西，該怎麼驗收？

驗收交給一個沒參與過程的新分身：給它驗收條件的原文，叫它讀成品逐條對照，回報缺漏的地方。

平行不平行都一樣，做完的東西還是要有人看過才算數。

自己做出來的東西，自己檢查等於沒檢查。

分身當初就是覺得對才那樣寫的，再看一次還是覺得對。

程式類的更簡單。跑起來，<a href="/newbie-pitfalls/ai-review-pipeline.html">以執行結果為準</a>。

「看起來對」不是驗證。

新手最常犯的三個錯是這些。

1. 不寫驗收條件就派工。這是最常見也最貴的一個：做出來的東西方向不對，整輪重來，比當初多花兩分鐘寫清楚貴十倍。
2. 拗同一個方法重試第三次。同樣的方法第三次成功的機率，低到不值得那些額度;會失敗兩次，通常是方法錯了不是運氣差。
3. 讓分身把整份產出貼回主對話。腦容量被塞爆，後面的對話開始忘東忘西。長產出一律寫進檔案，只回報路徑。

新手的起手式很簡單。下次要 AI 查三個以上的檔案，忍住別在主對話做。

開一個分身，派工單寫齊三要素，只跟它要結論。

你會發現主對話乾淨很多，而「寫驗收條件」這個動作本身，就會逼你把需求想清楚。

### Summary

AI 分身的門檻不是技術是管理，我的派工制度：①指揮官不下場，主對話只做拆解、派工、讀回報、決策，過程中會佔腦容量的活一律派出去，只收結論 ②派工單三要素缺一不派，也就是目標與動機(邊界情況能自行取捨)、驗收條件(寫不出來代表還沒想清楚)、回報格式(先結論、長產出寫進檔案給路徑) ③模型分級，機械活用快的、預設用主力、卡關才上最貴的;省錢不是重點，重跑一次的成本更高 ④同一個方法最多試兩次，失敗要帶完整紀錄升級，解出模式再降級批次套用 ⑤要平行就各拿一份獨立工作目錄(git worktree)，先把工作切成不碰同一批檔案的兩塊 ⑥驗收不能自己來，交給沒參與過程的新分身對照驗收條件。實測：2026-07-19 兩個分身用 git worktree 平行副本同時改同一專案，零衝突。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **subagent（子代理）**：AI 派出去的分身：主對話把一件事外包給另一個獨立的 AI 執行，做完只回報結果，不佔用主對話的記憶空間。
- **context（上下文視窗）**：AI 一次能「記在腦中」的內容上限，包含你說的話、它讀的檔案跟對話紀錄。塞滿了就會忘掉前面的事，這就是長對話後 AI 開始恍神的原因。
- **git worktree（平行工作目錄）**：git 的功能：同一個專案同時開好幾份獨立的工作目錄，各改各的、互不干擾，最後再合併。想讓多個 AI 分身同時動同一個專案，靠它就不會互相踩到。

### FAQ

**Q: 什麼工作該派給 AI 分身，什麼該在主對話做？**

判準一句話：這個動作過程中冒出來的東西，會不會佔掉主對話的腦容量？要讀 3 個以上檔案的調查、掃專案找東西、查資料研究、批次改檔，這些派分身，只收結論。讀一兩個已知檔案、單檔小修改、跟你確認事情，這些主對話自己做，派工反而多繞一圈。

**Q: AI 模型等級怎麼選才不浪費錢？**

機械活(模式已知的批次套用、格式轉換)用快的便宜的;預設情境(實作、研究、初審)用主力等級;卡關(重試兩次仍失敗、高風險判斷)才上最貴的。關鍵心態：省錢不是重點，重跑一次的成本比一開始就用對模型高得多。猶豫時選上一級，便宜模型失敗一次就直接升級，不給第二次機會。

**Q: 派出去的工作怎麼驗收？**

鐵律是「驗收不能自己來」：產出的那個分身自己說做完了不算數，要派一個沒參與過程的新分身，給它驗收條件原文，叫它讀成品逐條對照回報缺漏。程式類以執行結果為準，跑測試、實際觸發一次，「看起來對」不是驗證。

**Q: AI 失敗了要重試幾次？**

同一個任務、同一個方法，最多兩次(首次加重試一次)。第二次還失敗就換方法、升一級模型，或停下來問人，原樣試第三次幾乎都是浪費。升級時把失敗紀錄(試了什麼、錯在哪)整理給更強的模型，它就不用重走一次冤枉路;這份紀錄常常比重試本身值錢。

**Q: 兩個 AI 分身可以同時改同一個專案嗎？**

可以，但兩邊要各拿一份獨立的工作目錄(git worktree，同一個專案開出多份工作目錄)，改完再合併。共用同一個資料夾同時動手一定互相蓋掉。真正的門檻不是工具，是動手前要把工作切成不碰同一批檔案的兩塊;切不乾淨就別平行，合併時你要一行一行看誰對，省下的時間會全部還回去。

**Q: 主對話越聊越健忘，是哪裡做錯了？**

多半是把該派出去的活留在主對話做了。讀十個檔案、貼五段錯誤訊息，那些過程中冒出來的東西會一直佔著工作記憶(context window，一個對話能記住的內容量)，塞越滿越容易忘東忘西。解法是把費工又占地方的調查、搜尋、批次修改派給分身，主對話只收結論;長產出也一律寫進檔案只回報路徑，不要整份貼回來。

---

## AI 寫的東西誰把關？我的三層審查線

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-review-pipeline.html
> AI 會把「看起來合理」當事實寫出來，我真的被燒過。產出過三關：有標準答案的交給腳本、AI 審查員照規則抓違規、發布一律本人終審。三關怎麼搭、審查員怎麼設、三個錯覺。

短答給趕時間的人：AI 會把「看起來合理」當事實寫出來，所以我的內容產出要過三關。第一關交給腳本(寫好就能重複跑的檢查小程式)：有標準答案的事，像相似度分數、字數超標、狀態對帳，用工具算，AI 不碰。第二關 AI 審 AI：一個唯讀的審查員分身，照規則清單逐字抓違規，只出報告不動手改。第三關本人終審：要發布的東西，最後一個按鈕永遠是人。三關各擋各的，誰也替代不了誰。

起點是一次真實的教訓。

2026 年 5 月我讓 AI 代寫了 8 篇工作流文章放上這個網站，幾天後自己重讀才發現，很多細節是「合理地編的」。

排程明明是晚上 8 點跑，它寫成早上 8 點。

根本沒裝過的工具，寫得像用了很久。

不是故意騙人，是把「看起來合理」當成「事實」填進空格。

這種錯人眼特別難抓，因為它們專門長得像對的。

整批文章拉回來逐篇重寫之後，我不再問「AI 寫得好不好」，改問「我的流程能不能讓錯的東西過不去」。這篇拆我現在用的三關設計。

### 先看那次被燒的：錯的長什麼樣

那 8 篇文章的錯長什麼樣？全是同一個樣子：框架是真的，細節是編的。

真的做過自動發文，但時間編錯。真的有那條流程，但工具名稱寫成另一套。

我逐篇對照真實專案重寫，順手做了一份「防編造」的檢查提示。

8 篇裡沒有一篇全對。

教訓是：對 AI 產出的正確期待不是「會寫對」，是「會寫得像對的」。差這一字，把關的設計完全不同。

(那次的完整記錄在 SEO 連載第 15 篇，文內有連結。)

從那之後我陸續補了三道關卡。設計原則偷自工廠品管：不要指望產線不出錯，要讓錯的東西過不了檢查站。

### 算的、判的、裁的，三關怎麼分工？

原則一句話：算的交給腳本，判的交給另一個 AI，裁的留給人。

順序只有一條鐵律：人放最後，只看已經過了前兩關的東西，省下的是你的時間。

至於腳本跟審查員誰先誰後不絕對，我自己是看這批內容哪種錯可能比較多，就讓那一關先跑。

為什麼審查員必須是「另一個」AI？

因為寫的那個 AI 帶著自己的偏見，當初就是覺得合理才那樣寫的，叫它自己回頭檢查，還是覺得合理。

審查員要的是一雙沒有包袱的眼睛：<a href="/newbie-pitfalls/claude-code-subagent-guide.html">一個全新的分身</a>，沒看過寫作過程，只拿著規則清單對照成品。

這跟人類編輯部「寫的人不校自己的稿」是同一個道理。

### 我的審查員怎麼設(實戰)

我的文案審查員實際上長什麼樣子？就是一個角色檔，也就是一個文字檔，等於職位說明書。

裡面寫：開工前必讀哪幾份規則檔(白話規則、用語偏好、紅線清單)、要查哪六類問題、輸出格式固定。

格式是一張表，每列一個問題，原文必須逐字引用，附建議改法，最後給「過／不過」。

最關鍵的一行設定是權限。

審查員只有「讀」的權限，想改檔案也改不了。審查與修改分開，不是靠自律，是系統上就辦不到。

實戰數據：2026 年 7 月 18 日第一次上工，審一篇我自己讀過覺得沒問題的文章，抓出 6 處白話違規(工程行話、不夠白話的用詞)加 1 處冗詞。

同一天，第一關的撞稿工具掃了 18 篇排程文案、兩兩互比 153 組，回報沒有一組撞稿。

兩關抓的東西不一樣。

審查員抓不了相似度，腳本判不了語感，少一關都有漏網。

1. Step 1，產文：帶著規則寫初稿(規則先給，錯誤率先降一截)。
2. Step 2，AI 審查員過一輪：出違規報告，主對話照報告修。
3. Step 3，腳本算一輪：撞稿分數、字數超標，有紅字就回頭改。
4. Step 4，本人終審：讀定稿，裁決拿不準的項目，按下發布。

連雲端那端也有一關：我有一個每週一早上自己起床的排程 AI，巡檢發文系統之後把報告開成工作單。

指示裡寫死一條：「讀不到的資料要明說，不憑印象判斷」。

2026 年 7 月 19 日手動觸發首跑測試的時候，回報真的很老實：有一項資料因為權限讀不到，所以那部分無法確認，而不是編一個看起來合理的結論。

反編造要寫進制度裡，不能靠 AI 自覺。

### 哪三個把關錯覺最常見？

1. 「AI 說檢查過了」= 檢查過了，沒有報告的檢查等於沒檢查。要看到證據：逐字引用的違規表、工具跑出的分數、對帳結果，口頭保證不算數。
2. 讓審查員順手改，聽起來有效率，實際上你會失去「它改了什麼」的掌握;審跟改一旦混在一起，報告就不可信了。審的只出報告，改的另外做，權限直接鎖死最保險。
3. 三關全過 = 內容是對的，三關擋的是「錯的過不去」，不保證「過的都是好的」。判斷品質、承擔後果的責任，永遠在按發布鍵的那個人身上。

新手起手式：不用一次建三關。

最便宜的第一步，是把你最常抓到的錯列成一張清單存成檔案。

每次 AI 寫完，另開一個新對話，把清單跟成品一起丟進去，要求逐條對照給報告。這就是最小版的第二關。

光是「有一份報告」這件事，就已經比「寫完直接用」少掉一大半的錯。

### Summary

AI 會把「看起來合理」當事實寫出來(2026-05 實測：AI 代寫 8 篇文章，框架真、細節編，無一篇全對)，所以內容產出要過三關：第一關腳本，有標準答案的事(撞稿相似度、字數、狀態對帳)交給工具算，不會累不會腦補;第二關 AI 審查員，唯讀分身照規則清單逐字抓違規，只出報告不動手，寫的與審的必須是不同 AI(自己審自己=沒審);第三關本人終審，發布、刪除等不可逆動作永遠人裁。實戰：審查員首日上工抓 6 處違規+1 冗詞，撞稿工具 153 組互比 0 撞稿，兩關各抓各的。三個錯覺：口頭保證不是檢查、審查員不能給改權、三關全過不等於內容是好的。起手式：紅線清單+新對話對照審，就是最小版第二關。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **subagent（子代理）**：AI 派出去的分身：主對話把一件事外包給另一個獨立的 AI 執行，做完只回報結果，不佔用主對話的記憶空間。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **hallucination（AI 編造）**：AI 把「看起來合理」的內容當成事實寫出來的現象：框架是真的、細節是編的，長得跟正確答案一模一樣。對策不是指望它不編，是建立讓錯的內容過不了關的檢查流程。

### FAQ

**Q: AI 寫的內容為什麼會有錯？**

因為它的本事是「寫得像對的」：框架通常是真的，但細節(時間、數字、工具名)它會用「看起來合理」的內容填空，這叫編造(hallucination)。這種錯人眼特別難抓，它不像錯字那樣突兀，它長得跟事實一模一樣。所以把關的前提是接受「它一定會偶爾編」，設計讓錯的過不去的流程，而不是指望它不編。

**Q: AI 審 AI 真的可靠嗎？**

有兩個前提就可靠：①審的跟寫的必須是不同對話，寫的那個帶著「我當初覺得合理」的偏見，全新分身才有乾淨的眼睛 ②審查員只能出報告、不能動手改，而且報告要逐字引用原文，你能核對它抓的每一條。我的實測：審查員第一次上工，就在我自己讀過覺得沒問題的文章裡抓出 6 處違規。它不是取代人，是把人的注意力省下來用在終審。

**Q: AI 審查流程要怎麼開始建？**

從最便宜的一步開始：把你最常抓到的錯(用語、紅線、格式)列成一張清單存成檔案;每次 AI 寫完，另開一個新對話，把清單跟成品丟進去叫它逐條對照、輸出違規表。這就是最小版的「AI 審 AI」。之後再往兩邊加：有標準答案的檢查寫成腳本(或叫 AI 幫你寫)，不可逆的動作固定留給自己。

**Q: 有了審查流程還需要人工檢查嗎？**

需要，而且這關不能省：這套流程擋的是「錯的過不去」，不保證「過的都是好的」，品味、方向、該不該發，這些判斷沒有標準答案，腳本跟 AI 都給不了。我的做法是把人放在最後一關，只看已經過了前兩關的東西：雜訊被清掉了，人的時間全花在真正需要判斷的地方。發布鍵永遠是人按的。

---

## AI Agent 要一直開電腦嗎？3 種跑法對照

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-agent-computer-always-on.html
> 不一定：互動型用時開就好，雲端排程型關機照跑 — 我的發文機器人 2026-06 起住 GitHub 免費機房每天自動發。本機常駐型才要一直開，還有睡眠雷。3 型對照+選法。

短答給趕時間的人：要不要一直開電腦，取決於 AI Agent「住在哪」。(1) 互動型，你開它才動(像 Claude Code 對話)，用的時候開就好 (2) 雲端排程型，程式放在雲端機房(例如 GitHub Actions)，時間到自己跑，你的電腦關著也照跑;我的 Threads 自動發文機器人從 2026-06-12 起每天 21:00 這樣發，我的電腦常常是關的 (3) 本機常駐型，住在你電腦裡，才需要一直開機，而且有睡眠斷網的問題。多數個人需求，答案是前兩種。

這是我 2026 年 4 月剛開始玩 AI 自動化的時候最疑惑的問題。

「叫 AI 每天自動幫我發文，那我電腦是不是永遠不能關？」

當時想像中的自動化，是一台燈一直亮著、永遠不關的電腦。

現在我有 4 隻機器人在跑(發文、抓新聞、家庭提醒、市場掃描)。

其中最重要的那隻根本不在我電腦上。

這篇把「AI 到底跑在哪」用白話講清楚，你就知道電腦能不能關了。

### 先分清楚：你的 AI Agent 是哪一型？

「AI Agent 要不要開電腦」這題會吵起來，通常是因為兩個人講的根本不是同一型。先對號入座：

- <mark><strong>互動型</strong></mark>。你打字它才動，像在 Claude Code 裡叫它改網站、寫程式。對話存在雲端，但「動手」發生在你電腦上，所以<mark><strong>用的時候開機就好，關機沒有任何損失</strong></mark>。
- <mark><strong>雲端排程型</strong></mark>。程式放在雲端的機器上，設好「每天幾點跑」，時間到雲端自己開工，所以<mark><strong>你的電腦跟這件事完全無關，關機、出國、手機沒電都照跑</strong></mark>。
- <mark><strong>本機常駐型</strong></mark>。程式住在你電腦裡背景一直跑(例如即時監控某個網頁)，所以<mark><strong>電腦要開著，睡眠也不行</strong></mark>。這型的雷最多，下面單獨講。

我的機器人大多是雲端排程型，只有即時監控類的留在本機常駐。比例會這樣分不是巧合。

個人需求裡「每天固定做一次」的事，像發文、抓資料、寄報告，遠多於「每秒都要盯著」的事。

而前者根本不需要你的電腦參與。

### 雲端排程型：電腦關著照跑(我的主力跑法)

具體來說長什麼樣子？

我的 Threads 自動發文機器人程式碼放在 GitHub 上，用 GitHub 本來就有的「GitHub Actions」功能設了排程。

每天固定時間，GitHub 的機器(不是我的電腦)把程式跑一遍：挑該發的文、發上 Threads、發一則 Telegram 通知到我手機說發好了。

從 2026-06-12 建好到現在，這隻機器人每天照跑。不管我的電腦是開是關。

費用是多數人卡住的想像：「雲端機器不是很貴嗎？」

這種「一天跑 1-2 分鐘」的規模，免費額度就蓋掉了。

以 GitHub Actions 為例，私人專案每月有 2,000 分鐘免費額度(2026-07 查，以官方定價頁為準)。

我的發文任務一次跑約 1 分鐘，一個月用不到 50 分鐘，連額度的零頭都沒碰到。

1. 第 1 步，把程式放上 GitHub。叫 AI 幫你做，一句「幫我把這個專案推上 GitHub 私人 repo」。
2. 第 2 步，設排程。再一句「幫我設 GitHub Actions，每天台灣時間 21:00 自動跑這支腳本」，它會生出設定檔，你看得懂的部分只需要確認時間。
3. 第 3 步，<a href="/newbie-pitfalls/ai-agent-give-passwords.html">金鑰放保險箱</a>。發文需要的 token(平台發的通行鑰匙)放進 GitHub 的 Secrets 功能(加密保管)，不是寫在程式碼裡。
4. 第 4 步，讓結果找得到你。加一段「跑完發 Telegram 或 LINE 通知」，成功失敗都通知。這步很多人省略，之後就會變成「它停了三天你才發現」。

判斷口訣：這件事需要碰你電腦裡的檔案嗎？不需要(發文/抓網路資料/寄信)→ 上雲端;需要 → 才考慮本機。

### 本機常駐型：可以，但先知道三個雷

有些事真的只能在你電腦跑。

要讀你本機的檔案、要用你已登入的瀏覽器，或者要控制接在電腦上的裝置。我有 1 隻監控機器人，就是這型。

但把「一直跑」寄託在自己電腦上，有三個我都遇過的問題：

- <mark><strong>睡眠雷</strong></mark>。Windows 預設一段時間就睡眠，睡著的電腦排程不會跑。你以為它每小時在幫你盯，其實它下午 3 點就睡了。要嘛設定不睡眠，要嘛接受「只有醒著才盯」。
- <mark><strong>更新重開雷</strong></mark>。Windows Update 半夜自動重開機，你的常駐程式沒有跟著爬起來，隔天早上才發現斷了一夜。常駐程式要設「開機自動啟動」才算真的常駐。
- <mark><strong>睡醒斷網雷</strong></mark>。電腦從睡眠醒來的頭幾秒網路還沒接回，這時排程剛好開跑就會失敗。我的監控機器人踩過：程式沒錯、時間沒錯，錯在醒來那一刻沒網路。

這三個問題的共通點是什麼？

都不是程式寫錯，是「把一台家用電腦當伺服器用」的先天體質問題。

所以我的原則反過來：<mark><strong>預設上雲，除非非碰我的電腦不可</strong></mark>。

### 所以，電腦到底能不能關？

把前面收成一張對照。照你想做的事對號入座：

- 想做的事是「我叫它才做」(改網站、寫文件、整理資料)，那是互動型，<mark><strong>能關，想用再開</strong></mark>。
- 想做的事是「每天或每小時固定做一次」(發文、抓資料、寄報告)，那是雲端排程型，<mark><strong>能關，跑在雲端跟你電腦無關</strong></mark>。
- 想做的事要碰你本機檔案或即時盯著，那是本機常駐型，<mark><strong>不能關，而且要處理睡眠、更新、斷網三個雷</strong></mark>。

最後一個誠實提醒：新手常常高估自己需要「24 小時待命」的程度。

我一開始也以為，市場掃描非得即時盯著。

後來我想清楚了。一天掃 1 次跟即時掃，對我的決策差別是零。

需求降一級，跑法就能從最麻煩的常駐型降到最省事的排程型。

先問「多久跑一次才真的有差」，再決定這件事該住哪裡。

### Summary

AI Agent 要不要一直開電腦，取決於程式住在哪，分 3 型：互動型(你叫它才動)用時開機就好;雲端排程型(程式住雲端機房，像 GitHub Actions，私人專案每月 2,000 分鐘免費額度，2026-07 查)電腦關著照跑，我的 Threads 發文機器人自 2026-06-12 起每天自動發，電腦常是關的;本機常駐型才要一直開機，而且有睡眠、更新重開、睡醒斷網三個雷(都踩過)。選法：碰網路的事上雲端、碰本機檔案的事才留本機、先問「多久跑一次才有差」再決定。多數個人自動化，答案是「電腦可以關」。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **API 金鑰（API key）**：服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。

### FAQ

**Q: AI Agent 一定要 24 小時開著電腦才能自動做事嗎？**

不用。只有「本機常駐型」(程式住在你電腦裡)才需要開機;「雲端排程型」把程式放在雲端機房(例如 GitHub Actions)，時間到雲端的機器自己跑，你的電腦關機、出國都照跑。我的 Threads 自動發文機器人從 2026-06-12 起每天這樣發，電腦常常是關的。多數個人需求(每天發文/抓資料/寄報告)都屬於這型。

**Q: 有免費的方法讓 AI 自動化在雲端跑嗎？**

有。GitHub Actions 私人專案每月有 2,000 分鐘的免費額度(2026-07 查，以官方定價頁為準)，「每天跑一次、一次 1-2 分鐘」的個人自動化一個月用不到 50 分鐘，免費額度綽綽有餘。設定可以直接叫 AI 做：「幫我設 GitHub Actions 每天台灣時間 21:00 跑這支腳本」。

**Q: 電腦睡眠的時候，排程任務還會跑嗎？**

不會，這是本機排程最常見的雷：Windows 預設閒置就睡眠，睡著的電腦不會執行排程。三條路：設定電腦不睡眠(耗電)、接受任務只在電腦醒著時跑、或把任務搬上雲端排程(建議，跟你電腦的狀態徹底脫鉤)。另外注意 Windows Update 半夜重開機也會讓常駐程式斷掉，要設開機自動啟動。

**Q: 我關機了，AI 還能幫我發文或抓資料嗎？**

可以，前提是這件事跑在雲端而不是你電腦上。判斷方法：這件事需要碰你電腦裡的檔案嗎？發文、抓公開網頁、寄通知都不需要，全部可以放雲端排程，關機照跑。需要讀你本機檔案、用你已登入的瀏覽器的事，才必須留在你的電腦上跑。

---

## 帳號密碼可以給 AI Agent 嗎？3 層給法

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-agent-give-passwords.html
> 分 3 層：網銀/OTP/信用卡絕不給，密碼盡量不給 — 改給會過期的鑰匙(token)，我的發文機器人只拿 60 天效期的發文權。真要給，放環境變數不貼對話。附 3 個習慣。

短答給趕時間的人：分 3 層。第 1 層「絕不給」：網銀密碼、信用卡號加背面 3 碼、手機收到的一次性驗證碼(OTP)、證件，這些給出去等於大門全開。第 2 層「盡量不給密碼本身」：讓 AI 做事多數時候不需要你的密碼，需要的是一把「只能開特定門、會自動過期」的鑰匙(token)。我的發文機器人拿的就是一支約 60 天自動過期、只能發文的 token，從頭到尾不知道我的密碼。第 3 層「真要給的東西」：放進加密的保險箱(環境變數或 Secrets)，不要用貼進對話框的方式給。

會寫這篇，是因為「讓 AI 自動發文」聽起來的第一步好像就是把帳密交出去。

我 2026 年 4 月第一次設自動化的時候也這樣以為，差點把密碼直接貼進對話框。

後來才搞懂，正規的做法根本不用給密碼。

而且分層想清楚之後，你反而會比用 AI 之前更安全。

這篇用租房子的比喻把 3 層講完。

### 第 1 層：絕不給的東西(這條沒有例外)

先把紅線畫清楚一點：<mark><strong>網銀密碼、信用卡號加背面 3 碼、手機收到的一次性驗證碼(OTP)、身分證件的照片</strong></mark>，這四樣是第 1 層。

這四樣，不管 AI 說得多有道理、情境多急，都不進任何對話框。

理由用機制講，不是嚇你。

第一，你打進對話框的字可能被平台儲存下來，之後被誰讀到你控制不了。

第二，OTP 驗證碼的意義就是「證明是本人」，給出去等於把「我是我」的證明權轉讓了。

第三，這幾樣的共通點是「拿到就能直接動你的錢或身分」，沒有第二道關卡。

銀行行員都不會問你密碼了，AI 更沒有理由需要。

一句話判斷：這個東西被陌生人拿到，他能不能直接動我的錢或冒充我？能 → 第 1 層，絕不給。

### 第 2 層：為什麼可以不用給密碼？

這層是多數新手不知道的好消息。

<mark><strong>讓 AI 幫你發文、抓資料、管日曆，正規做法根本不需要你的密碼</strong></mark>。

不給密碼的話，要給什麼東西？各平台提供一種叫 token(或 API key)的東西。

用租房比喻：密碼是你的身分證，token 是房卡。

房卡只能開特定的門、會過期，掉了直接作廢換一張，不用改你的身分。

這裡舉一個實際的例子。我的 Threads 自動發文機器人，拿的是 Meta 官方發的一支 token。

那支 token 只有「發文」的權限，砍不了我的帳號、改不了我的密碼、看不到我的私訊。

而且約 60 天自動過期(2026-07 實況)，到期我要親手換發新的。

第一次覺得 60 天過期很麻煩。後來想通了。

<mark><strong>會過期正是安全設計：就算這支 token 不小心外洩，災情有範圍(只能發文)，也有期限(最多到過期日)</strong></mark>。

- <mark><strong>找官方的門</strong></mark>。想讓 AI 操作某平台，先搜「平台名 + API」或「平台名 + token」，走官方發鑰匙的門，而不是把帳密交給程式去模擬登入。
- <mark><strong>權限給最小</strong></mark>。申請 token 時通常會問你要哪些權限，只勾這次真的要用的。只需要讀，就不要給寫;只需要發文，就不要給管理。
- <mark><strong>用完要收回</strong></mark>。專案不玩了，回平台把 token 撤銷。過期沒人管的授權，是最容易被遺忘的後門。

### 第 3 層：真要給的東西，放保險箱不放對話框

token 申請下來之後，下一個新手雷馬上出現：這串鑰匙要放哪？

最常見的錯誤是直接貼進對話框跟 AI 說「用這個」，或叫 AI 把金鑰寫死在程式碼裡。

兩個都等於把鑰匙黏在大門上。

正規放法叫「環境變數」。白話講，那是一個程式跑起來的時候「用得到、但不寫在程式碼裡」的抽屜。

程式碼裡只寫「去抽屜拿鑰匙」，鑰匙本體放在抽屜裡。

這樣程式碼可以給 AI 看、可以放上 GitHub、可以分享給別人，鑰匙都不會跟著走。

1. 第 1 步，跟 AI 講規矩。設自動化的時候直接說「金鑰用環境變數，不要寫死在程式碼裡」，Claude Code 聽得懂，而且會照做。
2. 第 2 步，雲端跑就用平台保險箱。<a href="/newbie-pitfalls/ai-agent-computer-always-on.html">程式放 GitHub Actions 跑</a>的話，token 放它的 Secrets 功能(加密保存，連你自己事後都只能覆蓋不能查看)。
3. 第 3 步，本機的鑰匙檔看好。放鑰匙的檔案(常見叫 .env)不進備份雲端、不分享、不讓 AI 把它 commit 上 GitHub，跟 AI 說一次「.env 永遠不要進版本控制」就好。

自查口訣：把你的程式碼全部公開，你會不會出事？會 → 有鑰匙寫死在裡面，搬去環境變數。

### 邊界情況：AI 要幫我「登入網站」操作怎麼辦？

有一類需求躲不開登入。

你想讓 AI 操作沒有提供官方 token 的網站，例如幫你到某個後台按按鈕。

那正規的解法到底是什麼？不是把密碼給 AI 打。

<mark><strong>你自己先在瀏覽器登入好，讓 AI 用「已登入的那個瀏覽器」去操作</strong></mark>，它借用你的登入狀態，但從頭到尾不知道你的密碼。

但要知道代價是什麼。那個瀏覽器的登入資料夾(profile)本身就變成一份明文的機密，拿到它等於拿到你在裡面已登入的所有身分。

所以規矩跟鑰匙檔一樣：不備份上雲端、不分享、不 commit。

還有一條我自己的底線：<mark><strong>這種「借登入」的方式，只用在做錯了可以復原的帳號上;錢包類、證券類，回到第 1 層，不給，自己動手</strong></mark>。

最後誠實聲明。我不是資安專業。

這篇是一個 2026 年 4 月才開始搞自動化的非工程師，實務下來的個人做法整理。

夠擋住最常見的自己害到自己，但不是企業級資安規範。

帳號涉及公司資產或大額資金，請找專業。

密碼的防線設好了，但 AI 寫出來的程式碼本身也可能藏著漏洞。我做了兩個網站，前後被掃出超過 30 個資安問題，整理在〈<a href="/newbie-pitfalls/ai-code-security-review-mistakes.html">用 AI 做產品，你有考慮到資安風險嗎？</a>〉。

### Summary

帳號密碼能不能給 AI Agent，分 3 層。第 1 層絕不給：網銀密碼、信用卡加背面 3 碼、OTP 驗證碼、證件，這些被拿到就能直接動錢或冒充你，沒有例外。第 2 層盡量不給密碼本身：走平台官方的 token(房卡 vs 身分證)，只開特定門、會過期、可作廢;我的 Threads 機器人只拿約 60 天效期、只能發文的 token(2026-07 實況)，從頭到尾不知道我的密碼;權限給最小、用完要收回。第 3 層真要給的放保險箱：環境變數或 GitHub Secrets，不貼對話框、不寫死進程式碼;.env 不進版本控制。要登入才能操作的網站，用「已登入的瀏覽器」借狀態，而不是給密碼，而且只用在做錯可復原的帳號上。這是個人實務整理，不是資安顧問建議。

### 名詞解釋

- **API 金鑰（API key）**：服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- **環境變數（environment variable）**：放在系統層、不寫進程式碼的設定值，最常用來放 API 金鑰等機密，避免跟著程式碼被公開。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。

### FAQ

**Q: 可以叫 ChatGPT 或 Claude 幫我記住密碼嗎？**

不要。你打進對話框的內容可能被平台儲存，你無法控制之後被誰讀到，把密碼交給對話 AI 記，等於把鑰匙留在你管不到的地方。密碼請交給專門的密碼管理器(如 Bitwarden、1Password)，那是為保管密碼設計的加密保險箱;AI 是為對話設計的，兩者的安全等級完全不同。

**Q: API key、token 跟密碼到底差在哪？**

密碼是「身分證」：證明你是你，拿到的人能做你能做的一切。token/API key 是「房卡」：只能開授權過的特定門(例如只能發文)、通常會過期(我的 Threads 發文 token 約 60 天，2026-07 實況)、外洩了直接作廢換新，不用改你的身分。所以讓 AI 做事的正規做法是發房卡不是交身分證，災情有範圍、有期限、可作廢。

**Q: AI Agent 會偷我的密碼嗎？**

工具本身不會「主動偷」，真正的風險在你怎麼存放和傳遞：貼進對話框(可能被儲存)、寫死在程式碼裡然後公開(等於自己公告)、放在沒加密的筆記裡。把風險想成「鑰匙管理問題」而不是「AI 良心問題」，做法就清楚了：能用 token 就不給密碼、金鑰放環境變數或 Secrets、瀏覽器登入資料夾當機密看管。

**Q: .env 是什麼？為什麼比直接把金鑰寫進程式碼安全？**

.env 是放「環境變數」的檔案，也就是程式跑起來用得到、但不寫在程式碼裡的抽屜。程式碼只寫「去抽屜拿鑰匙」，鑰匙本體在 .env 裡。好處是程式碼可以給 AI 看、放上 GitHub、分享給別人，金鑰都不會跟著走。兩條配套規矩：.env 永遠不進版本控制(跟 AI 說一次它會遵守);雲端排程用平台的 Secrets 功能取代本機 .env。

---

## AI Agent 跑到一半停了？先分 3 型再修

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-agent-stops-halfway.html
> 先分 3 型：報 limit=額度到了、有紅字=錯誤、什麼都沒說=靜默型最危險 — 我的機器人斷發 3 篇沒人發現。4 步修：看進度、判斷敢不敢重跑、先記帳再動作、失敗要吵你。

短答給趕時間的人：AI Agent 半路停掉，先看「怎麼停的」分 3 型。(1) 額度型：有訊息提到 limit，那不是壞掉，是額度用完，等重置就好 (2) 錯誤型：有紅字錯誤訊息，把訊息整段複製貼回去問 AI，多數 10 分鐘內有解 (3) 靜默型：什麼都沒說就停了，最危險，因為你可能過了三天才發現。修法 4 步：先問做到哪、判斷這件事敢不敢重跑、讓 AI 養成「先記帳再動作」的習慣、失敗通知要能煩到你為止。我的發文機器人斷發過 3 篇才學會這套。

這篇的學費我繳過兩次。

2026-07-02 我對帳才發現，自動發文機器人有 3 篇文該發沒發。

程式其實沒出錯。機器人遇到問題時「通知過我一次」，而我沒看到。

然後機器人就當作交代完了，永遠地跳過。

十天後同一類問題再犯，這次漏了 5 篇。

兩次事故的共通點都不是「AI 不夠聰明」，是我沒替失敗設計退路。

這篇把非工程師也做得到的退路講完。

### 第一步永遠是分型：它是怎麼停的？

跟人看病一樣，先分科再治療。AI Agent 半路停掉只有 3 種停法，判斷只要 30 秒：

- <mark><strong>額度型</strong></mark>。畫面或紀錄裡有 limit、quota、rate 這類字眼，那不是故障，是用量到了。等額度重置，或看「額度用完」那篇的省法。<mark><strong>特徵：等就會好，重裝不會好</strong></mark>。
- <mark><strong>錯誤型</strong></mark>。有明確的紅字錯誤訊息，這是最好處理的一型。把錯誤訊息「整段」複製，貼回去跟 AI 說「跑到這裡出現這個錯」。別自己先摘要，錯誤訊息裡你覺得是亂碼的部分往往才是關鍵。
- <mark><strong>靜默型</strong></mark>。沒有任何訊息，就是停了;或者更難察覺的那種，<mark><strong>看起來跑完了，但該發生的事沒發生</strong></mark>(文沒發出去、檔案沒生出來)。這是本篇主角，往下看。

判斷口訣：有講 limit → 等;有紅字 → 貼回去問;什麼都沒講 → 這篇繼續讀。

### 我斷發 3 篇的實錄：為什麼靜默型最危險？

先講案發經過，因為這個失敗模式你遲早會遇到。

我的發文機器人每天自動發一篇連載，某幾篇的文案還沒準備好，機器人的設計是「發一則通知提醒我手動處理」。

聽起來很合理，對吧？

結果通知發了，我沒看到，機器人覺得自己交代完了，隔天繼續處理下一篇。

<mark><strong>2026-07-02 我對帳的時候才發現，連續 3 篇就這樣無聲地斷掉</strong></mark>，而系統的每一個環節都回報「沒有出錯」。

十天後的 2026-07-12，同類問題第二次發生，這次漏了 5 篇。

原因是另一個盲點：有一批排程文對系統的檢查邏輯「隱形」，連通知都不會發。

兩次事故合起來教會我一件事。

機器人停掉本身不算大事，真正麻煩的是停掉之後沒有人知道。

因為畫面上一切正常，你根本不會想去查，等到對帳才發現已經漏了好幾天。

你的自動化越順，你越不會去看，斷掉的那天就越晚發現。

對應的設計原則其實很簡單：與其想辦法讓這套流程永遠不失敗，不如確保它失敗的那一刻，你一定會知道。具體做法在下一節的第 4 步。

### 修復 4 步：從「它停了」到「安全地接回去」

1. 第 1 步，先問進度，別先重跑。跟 AI 說「剛剛的任務做到哪一步？列出已完成和未完成的清單」。它讀得到自己的紀錄和產出物，多數時候答得出來。跳過這步直接重跑，是新手最常見的二次事故來源。
2. 第 2 步，判斷這件事「敢不敢重跑」。問自己一題：已完成的部分再做一次，會出事嗎？整理檔案、重抓資料不會，放心重跑;發文、寄信、扣款會重複，必須先讓 AI 跳過已完成的部分(跟它說「從第 N 步繼續，前面做過的跳過」)。
3. 第 3 步，讓它養成「先記帳再動作」。對會重複出事的任務，叫 AI 改成「每完成一步，先寫進一個進度檔，動作之前先查進度檔」。我的發文機器人修復後就是這個機制：發文前先標記，重跑時看到標記就跳過，從此不怕重複發。這句話你可以原樣抄給 AI：「幫這個流程加上進度紀錄，讓它可以安全重跑」。
4. 第 4 步，失敗要能吵到你。通知發一次是不夠的(我就是這樣漏的)。規則改成「問題沒解決，每天再提醒一次」，用 Telegram 或 LINE 這種你一定會看的管道。事故後我的機器人加了每日重複提醒，同型問題再也沒斷超過一天。

### 兩次定律：同一個做法最多試兩次

最後一個判斷，反而是新手最缺的。

<mark><strong>同一個做法，原封不動地失敗兩次，就不要試第三次</strong></mark>。

第三次會成功嗎？機率不會比較高。你只是在重播失敗。

連錯兩次代表你對問題的假設錯了，該換的是假設，不是運氣。

換假設要做什麼？把「重試」改成「換路」。

舉例來說，同一支程式在排程裡連掛兩次，先手動跑一次看看。

手動能過、排程就掛掉，那問題根本不在程式本身，而是在排程的執行環境(這正是<a href="/newbie-pitfalls/claude-code-chinese-garbled.html">我的中文亂碼那篇</a>的劇情)。

像是同一個指令連兩次沒反應。別再下第三次。

改問 AI「這個指令沒反應，幫我列出 3 個可能原因和各自的檢查法」，把 AI 從「執行者」切回「醫生」，常常一輪就找到真正的病灶。

### Summary

AI Agent 跑到一半停了，先花 30 秒分 3 型：額度型(訊息含 limit，等重置，重裝沒用)、錯誤型(有紅字，整段貼回去問 AI)、靜默型(什麼都沒說，最危險)。靜默型實錄：我的發文機器人 2026-07-02 被發現無聲斷發 3 篇，一次性通知沒人看到就永遠斷;2026-07-12 同類問題再漏 5 篇。修復 4 步：先問「做到哪一步」別急著重跑，判斷敢不敢重跑(發文、寄信類會重複，要跳過已完成)，讓 AI 加「先記帳再動作」的進度紀錄變成可安全重跑，失敗通知改成沒解決每天吵你。加一條兩次定律：同一做法原樣失敗兩次就換假設，不試第三次。核心原則：與其追求永不失敗，不如確保失敗一定看得見。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **rate limit（用量限制）**：服務商限制你在一段時間內能用多少次的機制。撞到不是壞掉，是「這個時段的量用完了」，等重置或升級方案。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。

### FAQ

**Q: AI Agent 停了，但沒有任何錯誤訊息，怎麼查？**

這是靜默型，先跟 AI 要進度：「剛剛的任務做到哪一步？列出已完成和未完成」。再查三個地方：額度面板(很多「沒訊息」其實是額度到了)、任務的執行紀錄(排程平台都有 log)、最終產出(文有沒有真的發出去、檔案有沒有真的生成，「看起來跑完」和「真的完成」是兩回事)。查完至少知道是哪一型，再對症處理。

**Q: 任務重跑一次，會不會把做過的事再做一遍？**

取決於任務性質，重跑前先問一題：已完成的部分再做一次會出事嗎？整理檔案、重抓資料再做一次無害;發文、寄信、扣款再做一次就是事故。後者的解法是讓 AI 加「先記帳再動作」機制：每完成一步寫進進度檔，動作前先查、做過就跳過。一句話抄給 AI：「幫這個流程加上進度紀錄，讓它可以安全重跑」。我的發文機器人加了這個機制後，重跑再也不會雙發。

**Q: 半夜自動跑的任務失敗了，怎麼第一時間知道？**

兩個設計。(1) 成功失敗都要通知，用 Telegram 或 LINE 這種你一定會滑到的管道;只通知失敗的話，「完全沒消息」跟「跑成功」你分不出來。(2) 沒解決就重複提醒，一次性通知會被漏掉(我的機器人就這樣斷發 3 篇，2026-07-02 對帳才發現)，規則改成問題存在一天就每天提醒一次，直到有人處理。

**Q: AI 一直重試同一個錯誤，該讓它繼續試嗎？**

不該。同一個做法原封不動失敗兩次，第三次成功的機率不會更高，連錯兩次代表假設錯了，不是運氣差。把 AI 從執行者切回醫生：「這個做法連續失敗兩次，停止重試，列出 3 個可能的原因和各自的檢查方法」。另一招是換環境對照：排程裡連掛兩次的程式，手動跑一次看看，手動能過排程掛掉，問題就在執行環境不在程式，查的方向完全不同。

---

## 手機可以跑 AI Agent 嗎？3 種現實用法

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-agent-on-phone.html
> 手機「自己跑」還很勉強(2026-07)，但 3 種用法現在就能動：雲端跑+手機收結果、電腦跑+手機遙控(我的 Telegram 中樞)、原生 agent app 剛出現。附權限紅線。

短答給趕時間的人(2026-08 現況)：手機要「自己跑」一隻會動手的 AI Agent 還很勉強，但「用手機使喚 AI Agent」現在就完全可行，而且有 3 種用法。(1) 雲端跑加手機收結果，最穩，我的發文機器人每天在雲端自動跑，跑完 Telegram 通知到手機，我人在哪都一樣 (2) 電腦跑加手機遙控，手機打字下指令，家裡電腦的 AI 動工，結果回手機。這條 2026 年 8 月起官方有現成的了(Claude Code 的 Remote Control 與 Dispatch)，不用再自己搭 (3) 手機原生 agent app，正在成形(OpenClaw 已推官方 iOS 與 Android 版，2026-06 底上架)，權限管理也比早期收斂，但我自己還沒把主力機交出去。

這題我被問的版本通常是：「你那些自動化，出門是不是就斷了？」

剛好相反，我出門的時候它們跑得最起勁。

關鍵是把「手機」從「跑 AI 的機器」重新想成「指揮 AI 的遙控器」。

算力留在雲端和家裡的電腦，手機只負責兩件事：下命令、收結果。

這篇把 3 種用法從最省事到最前沿排給你。

### 30 秒懂：為什麼手機「自己跑」還很勉強？

直覺以為卡在算力。其實不是。

AI 的腦(模型)本來就在雲端，手機叫得動。

真正卡住的是三件事。

第一，<mark><strong>手機系統不讓 app 在背景放肆</strong></mark>。iOS 跟 Android 為了省電，背景 app 動不動就被凍結，「長時間自己做事」跟系統的設計方向相反。

第二，<mark><strong>Agent 要動手就要深權限</strong></mark>。幫你跨 app 操作，等於要看你的螢幕、按你的按鈕，這種權限系統管得極嚴(也應該嚴)。

第三，<mark><strong>螢幕一鎖，任務就睡</strong></mark>。你總不能為了跑 agent 整天不鎖屏。

所以 2026-07 這個時間點的務實結論是什麼？

別想著讓手機當工人。讓它當工頭。下面 3 種用法都是這個思路，前 2 種你今天就能開始。

### 用法 1：雲端跑+手機收結果(最省事，先做這個)

把「每天固定要做的事」放上雲端排程(做法見「要一直開電腦嗎」那篇)。

然後幫這支流程加一行：跑完把結果發到 Telegram 或 LINE。

從此你的手機變成收據匣。

我的發文機器人每天雲端自動發文，發完手機叮一聲，我在吃飯、在外面、在睡覺，流程一模一樣。

這個用法最好的地方是<mark><strong>手機端什麼都不用裝、不用設定</strong></mark>，收通知而已，舊手機也一樣用。

這樣解掉的是「自動化在跑，但我看不到」的不安。

手機收到通知等於今天跑了，連續兩天沒收到就該去看看了。通知本身就是活著的證明，這招在「跑到一半停了」那篇有完整版。

### 用法 2：電腦跑+手機遙控(通勤時使喚家裡的 AI)

如果不只想收結果，還想在外面主動下指令呢？

做法是幫家裡電腦上的 AI 接一個聊天介面。

<mark><strong>這條路 2026 年 8 月起官方有現成的了</strong></mark>，Claude Code 的 Remote Control 在電腦上打一行指令，手機就能接手，Dispatch 則是直接從手機發任務。兩個都不用自己寫程式，而且不會在你電腦上開任何對外的連接埠，比自己搭安全。

我自己在官方推出之前用 Telegram 土砲過一套，後來又做了兩版。四種形狀的取捨、以及官方那幾條各自卡在哪，寫在<a href="/newbie-pitfalls/claude-code-telegram-remote.html">手機遙控 Claude Code</a>那篇。

手機全程只是傳話筒，粗活都是家裡的電腦在幹。

這裡有兩個誠實的前提。

第一，家裡的電腦要開著(這條線就是「要一直開電腦嗎」那篇的本機常駐型，雷同樣適用)。

第二，<mark><strong>遠端讓 AI 動手，安全鎖不能省</strong></mark>。

至少要做到：只有你的帳號能對它下指令，危險動作(刪除、發布、花錢)要回你手機二次確認。

官方那三條路不用你煩惱這些，因為它們根本不開對外的門。真要自己搭才需要那三道鎖，<a href="/newbie-pitfalls/claude-code-telegram-remote.html">手機遙控 Claude Code</a>那篇有完整的取捨與做法。

### 用法 3：手機原生 agent app(前沿區，先看懂再跟)

2026 年這條線動得很快。

OpenClaw 在 2026 年 6 月底推出官方 iOS 與 Android app，手機當成一個節點跟你自己架的主程式配對，可以對話、用語音、批准它要做的動作。

「Agent 手機」也開始成為手機廠的賣點。

方向是真的，手機端的 agent 會越來越能動手。

但我自己還沒跟進，原因不是懷疑技術，是權限帳算不過來。

<mark><strong>權限這件事比早期收斂了</strong></mark>：相機、螢幕、定位、相簿、聯絡人、行事曆都改成用到才跳系統授權，不是裝好就一次全要(2026-08 查證)。但它要的仍然是「看你螢幕、讀你聯絡人、知道你在哪」這種組合，判斷框架在「<a href="/newbie-pitfalls/ai-agent-give-passwords.html">帳號密碼可以給 AI Agent 嗎</a>」那篇。

我的建議節奏是這樣。

想先試試看，用一支沒有重要帳號的舊手機玩。主力機要等這類 app 的權限管理成熟、出過幾輪安全考驗再上。

前沿區的規矩永遠是不急著當第一批，反正前 2 種用法已經蓋掉 9 成的日常需求。

### Summary

手機能不能跑 AI Agent(2026-08 現況)：「自己跑」還很勉強，卡的不是算力(模型在雲端)，是手機系統的背景限制、深權限管制、鎖屏即睡三件事。務實做法是讓手機當工頭不當工人，3 種用法：(1) 雲端跑加手機收結果，最省事，手機什麼都不用裝，我的發文機器人每天雲端自動發、Telegram 通知到手機 (2) 電腦跑加手機遙控，2026 年 8 月起官方有現成的(Remote Control 與 Dispatch)：手機下指令、家裡電腦的 Claude Code 動工、結果回手機。前提是電腦開著，安全鎖不能省 (3) 手機原生 agent app，OpenClaw 已推 iOS 與 Android 版(2026-07 新聞查證)，但要交出螢幕、定位、聯絡人等組合權限，建議舊手機先試，主力機等安全成熟。前 2 種蓋掉 9 成日常需求。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。

### FAQ

**Q: 手機可以安裝 Claude Code 嗎？**

不能直接裝，Claude Code 是跑在電腦終端機的工具(2026-07)。但有兩條路讓手機用得到它：一是官方網頁版在手機瀏覽器開，適合看狀態、下簡單指令。二是幫家裡電腦的 Claude Code 接一個 Telegram 介面，手機打字它動工、結果回手機，我自己用第二條，蓋法看「手機遙控 Claude Code」那篇。

**Q: iPhone 可以用 AI Agent 嗎？**

可以，但形態要選對(2026-08 現況)：最穩的是「雲端跑加 iPhone 收通知」和「電腦跑加 iPhone 遙控」，這兩種跟手機品牌新舊都無關，舊 iPhone 也一樣用。第二種現在有官方現成的了，Claude Code 的 Remote Control 與 Dispatch 都能從 iPhone 操作，不用自己搭。至於在 iPhone 上直接跑會動手的 agent app，已經開始出現(如 OpenClaw 的官方 iOS 版)，權限管理比早期收斂、改成用到才授權，但它要的仍是相機螢幕定位這類組合，建議先用沒有重要帳號的裝置試，主力機再等等。

**Q: 手機螢幕鎖了，AI Agent 還會繼續跑嗎？**

如果任務跑在手機上，多半會被系統暫停，這正是手機自己跑 agent 的天生限制：iOS 跟 Android 為省電會凍結背景 app。如果任務跑在雲端或你家電腦上，手機鎖不鎖螢幕完全無關，手機只是收結果的遙控器。所以「鎖屏還能不能跑」這題的答案，取決於你把任務放在哪，而不是手機設定怎麼調。

**Q: 需要為了 AI Agent 買新的 AI 手機嗎？**

現在不用(2026-07)。3 種用法裡，雲端跑加收通知、電腦跑加手機遙控這兩種跟手機新舊無關，我用的就是這兩種，手機只負責傳話。「Agent 手機」是真實的趨勢方向，但目前主打的深度整合要交出大量權限，生態也還在早期。等它出過幾輪安全考驗再決定，你現有的手機今天就能開始用前兩種。

---

## 改好推上去，網站卻沒更新？部署失敗這樣查

> Source: https://www.coolkidlab.com/newbie-pitfalls/site-not-updating-after-push.html
> 推送成功不等於上線：部署失敗是靜默的，網站會停在最後一次成功的舊版。真實事故重演：三步排查(看線上版本、乾淨副本重建、查最近共用改動)，根因是沒進 git 的檔案。

短答給趕時間的人：「推送成功」跟「上線成功」是兩件事。推送只是把檔案交出去，後面還有一段自動建置。建置失敗的話，網站會一直停在最後一次成功的舊版，而且多半不會有人通知你。排查三步：第一，看線上頁面的實際內容與更新時間，確認是不是真的舊版。第二，開一份乾淨的專案副本重跑建置，你本機會過、乾淨副本會出錯，那就是「檔案在本機、沒進 git」，git 就是程式檔案的版本紀錄庫。第三，查最近誰改過共用的資料檔，壞的常常不是你這筆。

這篇是一次真實事故的重演。

2026 年 7 月 23 日晚上，我更新了一篇文章、推送上去、畫面也顯示成功，結果網站上什麼都沒變。

因為當天下午另一次改動漏交了一個檔案，從那之後每一次自動建置都在失敗。

整個網站停在舊版好幾個小時，包括我晚上推的東西，全部被連坐。

從發現「怎麼沒變」到修好上線，整段排查大約 20 分鐘。

這篇把那 20 分鐘拆成你可以照抄的順序。

### 事故現場：推送都成功，網站全舊版

先講一次事發的經過。

我的網站是「推送到 git，雲端自動重新建置上線」這種架構，跑在 Vercel 上面，免費方案就已經有這個功能。

當天下午，一次改動在文章裡引用了一個新的詞條。

但詞條定義那個檔案只存在本機，忘了一起交進 git。

本機看一切正常，雲端拿到的專案卻缺了一塊，建置直接報錯停止。

重點是接下來這件事。

建置失敗的時候，網站不會壞掉、不會白畫面，只是安靜地繼續供應最後一次成功的舊版。

訪客看不出異狀，我也看不出異狀，推送照樣顯示成功，從下午到深夜，中間推的所有更新全部沒有上線。

而且沒有任何一個畫面主動告訴我這件事。

這就是「靜默失敗」：機器沒有出聲，你就以為一切健康。

可怕的地方在哪？你連要去查都想不到。

### 排查三步：網站沒更新該從哪裡查起？

1. 第 1 步：確認線上到底是哪一版。別只按重新整理，直接看頁面上的「最後更新」日期，或者搜尋一段你新加的文字在不在。瀏覽器快取會騙人，先用無痕視窗把快取排除掉。還在舊版，才是真的沒上線。
2. 第 2 步：開一份乾淨副本重跑建置。把專案從 git 重新取出一份，要乾淨的資料夾，不是你平常工作的那份，然後在裡面跑一次建置。你工作的那份會過、乾淨那份會出錯，答案就出來了：有檔案只存在你電腦，沒進 git。錯誤訊息會直接指出缺什麼。
3. 第 3 步：查最近的共用改動。如果乾淨副本也能過，回頭看部署平台的紀錄，哪次建置開始失敗、錯在哪一行。多人或多對話協作的時候，特別注意「別人最近改了什麼共用檔案」。建置是整包一起做的，前面有一筆壞的，你後面推的全部連坐。

我當天的實際路徑，就是下面這三步。

第 1 步先確認真的沒上線。線上頁面的「最後更新」還停在舊日期嗎？

第 2 步定位：乾淨副本重跑，第一次就跳出「查無詞條」的錯誤。

第 3 步歸因：一看就是下午那筆改動引用了新詞條，而定義檔沒有進 git，所以雲端那邊拿到的專案就缺了一塊。

補交那個檔案，推送，幾分鐘後全部更新一起上線。

### 兩個機制教訓：失敗了，為什麼沒人看見？

第一個教訓有點反直覺：建置報錯停止，為什麼反而是「對的設計」？

我的建置系統遇到「文章引用了不存在的詞條」會直接罷工，而不是裝作沒事，出一個缺了一塊的網站給訪客看到。

這叫 fail-fast，中文可以說成快速失敗：錯誤在第一關就大聲報錯，好過安靜地流到訪客面前。

這次事故裡，建置系統做對了自己的工作，把有問題的版本擋在門外。

真正的洞在第二個環節：失敗了，但沒人看見。

部署平台其實會記錄失敗，有的也會寄信。

但那些訊息常常不在你第一時間會看的地方，於是「大聲失敗」就變成「<a href="/newbie-pitfalls/ai-agent-stops-halfway.html">在沒人的房間裡大聲失敗</a>」，等於根本沒失敗。

這個洞要怎麼補起來？修法其實很便宜。

把部署平台的失敗通知打開，寄到信箱或者通訊軟體都行。

或者養成「推完重要更新，30 秒後開無痕視窗看一眼線上頁」的習慣。

我自己是兩個都做，再加一條規矩：凡是「推送成功」的回報，一律附上線上驗證的證據，不拿推送當上線。

口訣：推送成功 ≠ 上線成功。系統要大聲失敗，失敗要有人看見，兩個缺一個，都是靜默失敗。

### 三個坑，加一個起手式

1. 「我本機是好的」所以不信建置壞了。本機恰恰是最不可信的證人，你桌上什麼檔案都有，雲端只有 git 裡的東西。乾淨副本才是跟雲端同一個世界。
2. 只查自己這筆改動。建置失敗會連坐，你的改動可能完全沒問題，壞的是幾小時前另一筆。往前翻，別對著自己的改動鑽牛角尖。
3. 改共用資料檔不一起交。這次的根因就是這個，文章與詞條定義分屬兩個檔案，引用進了 git、定義留在本機。教訓是一個改動牽到幾個檔案，就一起交，別分批。

新手的起手式只要 30 秒就做完。

現在就去你的部署平台把「失敗通知」打開，Vercel 在專案設定的 Notifications 裡，免費方案就有。

這大概是本篇價值最高的 30 秒。

然後記住那句口訣，下次網站「怎麼沒變」的時候，照三步走，不用慌。

### Summary

推送成功不等於上線成功。自動部署的建置失敗是安靜的，網站不會壞，只是一直停在最後一次成功的舊版，訪客與你都看不出異狀。真實事故發生在 2026-07-23，一筆改動引用了新詞條但定義檔沒進 git，之後每次建置全部失敗，所有更新連坐好幾個小時。排查三步：第一，看線上頁的「最後更新」與新內容在不在，先用無痕視窗排除瀏覽器快取。第二，乾淨副本重跑建置，本機會過、乾淨副本會出錯，就是檔案沒進 git。第三，查最近的共用改動，壞的可能不是你這筆。機制教訓是 fail-fast 報錯停止是對的設計，但「大聲失敗」要配上「有人看見」，所以去部署平台把失敗通知打開，推完重要更新用無痕視窗驗一眼線上頁，不拿推送當上線。

### 名詞解釋

- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。
- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **提交（commit）**：Git 的一個存檔點：把這次改動連同一句說明記錄下來，之後隨時可以回到這個版本。
- **快取（cache）**：把載過的資源暫存起來，下次直接用、不重新下載。網站變快的最便宜手段之一。

### FAQ

**Q: 推送成功了，為什麼網站還是舊的？**

「推送」只是把檔案交給 git，後面還有一段自動建置與部署。建置失敗的話，網站會繼續供應最後一次成功的舊版，而且預設多半不會通知你。先用無痕視窗排除瀏覽器快取，再看頁面上的「最後更新」日期。真是舊版，就去部署平台看建置紀錄，通常會看到紅色的失敗。

**Q: 本機跑起來明明是好的，為什麼雲端建置會失敗？**

因為本機和雲端拿到的專案不一樣：你桌上什麼檔案都有，雲端只拿得到 git 裡的東西。最常見的原因就是「有檔案改了但沒交進 git」。驗證方法是把專案從 git 重新取出一份乾淨副本，在裡面跑建置，乾淨副本出錯的那個訊息，就是雲端看到的錯誤。

**Q: 怎麼第一時間知道部署失敗？**

把部署平台的失敗通知打開。Vercel 這類服務在專案設定的 Notifications 裡就有，免費方案可用，可以寄信或者接通訊軟體。再配一個便宜的習慣：推完重要更新，30 秒後開無痕視窗看一眼線上頁面。兩層都有，靜默失敗就變成大聲失敗。

**Q: 我的改動沒問題，也會被別人的失敗影響嗎？**

會，這叫連坐。自動建置是整包專案一起做的，只要有一筆改動讓建置失敗，之後所有更新都上不了線，直到那筆被修好。所以排查的時候別只盯著自己的改動，看建置紀錄「從哪一次開始失敗」，那一次才是根因。

---

## Claude Fable 額度怎麼算？50% 不是獨立額度

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-fable-usage-limit.html
> Fable 的 50% 是同一個週額度的天花板，不是第二個池子。兩條計量表分別在數什麼、用 Opus 會不會扣到 Fable、一週怎麼排不浪費 — 附我一開始算錯的完整過程。

短答給趕時間的人(以下講 Max 這類含 Fable 份額的方案，Pro 的規則完全不同，見第 4 節)：Fable 沒有自己的額度池。它跟 Opus、Sonnet、Haiku 抽的是同一個週額度，只是多一條「最多吃掉一半」的天花板(官方說明頁的寫法是 up to 50% of your weekly usage limit，2026-07 對照)。所以兩件事同時成立：①用 Opus 或 Sonnet 不會推動 Fable 那條計量表 ②Fable 用掉的量會計進「全部模型」那條。這代表順序完全自由，不需要先把 Fable 用掉，也不會因為先用了別的模型就浪費掉 Fable 的份額。

這篇的起點是我自己算錯。

我原本的理解是：「不管你用哪個模型，前 50% 的額度都算在 Fable 頭上」。

照這個講法推下去，結論會變成「想用滿 Fable 的份，前半週就得一直掛在 Fable 上」，不然那半份就白白過期了。

我照這個想法排了一陣子的工作順序。

直到有天想算清楚「這週還剩多少能用」，才發現怎麼算都對不上。

去翻官方說明頁才知道。方向整個反了。

50% 不是「前半段的入場券」，是「Fable 最多能吃掉多少」的上限。

一個是時間順序的概念，一個是份額的概念，我把兩件事搞混了。

這篇把正確的算法、我當時錯在哪、以及一週該怎麼排，一次講完。

### 我原本的誤會：為什麼我把「碼表」看成「跑道」？

先講我腦中原本的畫面，因為我猜不少人也是這樣想的。

我把一週的額度想成一條 100 公尺的跑道。

然後聽到「Fable 佔 50%」，就自動理解成：前 50 公尺是 Fable 區，後 50 公尺是其他模型區。

既然是分段的，那前半段不用 Fable 就是浪費。跑過去就沒了。

這個畫面有兩個地方是錯的。

第一，額度不是按時間先後分段的，你什麼時候用哪個模型都可以。

第二，更關鍵的是：「50%」根本不是在講一段區間，是在講一個上限。

用碼表比喻會準得多。

你的 /usage 面板上有兩個碼表在同時跑，不是一條跑道被畫了中線。

一句話分辨：跑道的思維會問「我現在跑到第幾公尺」，碼表的思維會問「這兩個數字各自跳到多少」。後者才對。

我為什麼會搞混？現在回頭看有個具體原因。

我的 Max 5x 面板上這兩條的名字長得太像，一條標的是全部模型的當週用量、一條標的是 Fable 的當週用量。

兩條都是百分比、都會跑。

看起來像同一件事的兩種切法，實際上一條是總量、一條是子項。

(不同方案的面板列出來的條目不一樣，下面的描述都以我這台看到的為準。)

### 正確的算法：一個水池，兩個碼表

官方說明頁講得其實很直白：Fable 抽的是你方案原本的週額度，而且抽得比其他模型快。

也就是說，Fable 沒有自己的池子，是跟所有模型共用同一池水。

那個 50% 是額外加在 Fable 身上的限制。

這池水，Fable 最多只能舀走一半。

搞懂這點之後，兩個碼表各自在數什麼就很清楚了(欄位名稱以我 Max 5x 面板上看到的為準，你的方案可能還會列出別條)：

所以回到最常被問的那題：用 Opus 或 Sonnet 會不會消耗 Fable 的額度？

不會。Fable 那條碼表只被 Fable 推動，其他模型碰不到。

但反過來不成立：Fable 用掉的量一定會計進「全部模型」那條，因為喝的是同一池水。

還有一個推論容易被忽略。

兩條碼表哪一條先滿，你的 Fable 就停在哪。

如果整週的總用量先見底，就算 Fable 那條才跑到 30%，你一樣不能再用。

剩下的 20% 不會變成什麼「保留席」。

這也是我建議看額度時兩條一起看、不要只盯一條的原因。

至於總量本身是怎麼分層的(重置窗口、週上限、超額加購)，我另外寫過<a href="/newbie-pitfalls/claude-code-usage-limits.html">額度用完？限制與 5 個省法那篇</a>，這篇不重複。

### 那一週該怎麼排？我自己推的 40% + 50% 算法

既然順序自由，接下來的問題就是怎麼排才不浪費？

這裡可以直接算，因為兩條碼表的分母是同一個(都是你的週額度)，百分點可以相加。

這裡舉一個實際的排法：

1. 前面幾天照常用 Opus 跟 Sonnet 做日常的事，做到「全部模型」那條跳到 40%。這段期間 Fable 那條一直停在 0%。
2. 接著把一週裡最硬的那幾件事集中丟給 Fable，一路用到 Fable 那條碰到 50% 天花板。
3. 這時候「全部模型」那條會是 40% + 50% = 90%，還剩 10% 留給收尾的雜事。

順序反過來排，結果一樣：先用 Fable 到 50% 再用其他模型到 40%，總量還是 90%。

順序只影響一種情況。

如果你先把其他模型用到 60% 以上，那 Fable 就會被「全部模型」的剩餘量卡住(剩不到 50 個百分點可用)，而不是被自己的 50% 天花板卡住。

想把 Fable 的份額用滿，唯一要注意的就是別讓其他模型先吃掉超過一半。

這段是照官方那句「最多 50% 的週額度」推算出來的，不是官方給的公式。實際數字一律以你自己 /usage 面板上的兩條為準。

但這裡有個落差要先講。百分比一樣，換到的工作量差很多。

額度是按 token(AI 讀寫文字的計量單位)算的，但同樣的 token 數，不同模型從額度裡扣掉的份量不一樣。

官方明講 Fable 用得比其他模型快;至於快多少，有報導提到大約是 Opus 的兩倍，但這是報導數字、不是官方公布的，我也沒看到公開的測法。

意思是那 50% 的額度買到的實際工作量，遠少於「一半的工作」。

我第一次照這個排法跑，以為可以撐兩三天的硬活，結果一個下午就把 Fable 那條推到底。

所以我現在的做法是先在紙上把這週真的非 Fable 不可的事列出來，排進同一個時段一起跑完，跑完就換回去。

而不是「反正還有額度」就一直開著不換。

什麼任務該配哪一級模型、以及切換時要注意什麼，我寫在<a href="/newbie-pitfalls/claude-code-model-switch.html">模型怎麼換那篇</a>，這裡就不重講了。

### 為什麼你 Google 到的說法互相矛盾？

查這題的時候我還撞到另一個坑。

網路上的文章講法不一致，到底哪個對？有的說 Fable 完全不吃方案額度、有的說吃、有的說某天之後就沒了。

這不是誰在亂寫，是這條規則在 2026 年 7 月真的改過。

方案內的存取原本排定 7 月上旬結束，後來兩度延期，7 月中旬才定案成現在的樣子。

(這段改版時間軸出自科技媒體報導，官方說明頁只寫現行規則、沒有列改版歷程，所以確切日期我不寫死。)

定案後的分流是這樣(這段以官方說明頁為準)。

Max 這一級的方案保留 50% 的份額。

Pro 這一級則是 Fable 完全不吃方案額度，要用就走 usage credits(按實際用量另外扣的儲值點數)，費率以官方定價頁為準。

所以「Fable 到底吃不吃額度」？這題沒有單一答案，先看你在哪個方案。

這件事給我的教訓其實不只關於 Fable。

遇到「規則本身還在動」的主題，查來的文章不管寫得多詳細，都要先看它是哪一天寫的。

而最可靠的答案永遠不在文章裡，在你自己的面板上。

- 在 Claude Code 裡打 /usage 看當週用量與重置時間。我這台 Max 5x 會列出全部模型與 Fable 兩條，你的方案列出的條目不一定一樣。
- 兩條一起看：哪一條先接近滿，你就是被那條卡住。
- 看到跟網路文章對不上的數字，以面板為準，文章可能是規則改之前寫的。

### Summary

以 Max 這一級的方案來說，Fable 沒有獨立額度池：它跟其他模型共用同一個週額度，只是多一條「最多吃掉 50%」的天花板(2026-07 對照官方說明頁)。所以用 Opus / Sonnet / Haiku 不會推動 Fable 那條碼表，但 Fable 用掉的量一定會計進「全部模型」那條。我原本的誤會是把它想成一條被畫了中線的跑道，以為前半段不用 Fable 就浪費了，實際上順序完全自由，只要別讓其他模型先吃掉超過一半，Fable 的份額就用得滿。照官方那句「最多 50%」推算(這是我推的，不是官方公式)：其他模型用到 40% 再把 Fable 吃到 50%，總量是 90%。要注意的是 Fable 燒得快(官方說明它用得比其他模型快)，同樣的百分比換到的工作量少很多。另外 Pro 那一級的規則完全不同，Fable 不吃方案額度、走 usage credits。這條規則 2026 年 7 月改過(兩度延期後在 7 月中旬定案，時間軸依科技媒體報導)，所以網路文章要看日期，實際數字一律以自己的 /usage 面板為準。

### 名詞解釋

- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。
- **rate limit（用量限制）**：服務商限制你在一段時間內能用多少次的機制。撞到不是壞掉，是「這個時段的量用完了」，等重置或升級方案。

### FAQ

**Q: Fable 的額度是獨立算的嗎？**

以 Max 這一級的方案來說：計量是獨立的，額度不是，這兩件事要分開講。獨立的部分：/usage 上那條 Fable 碼表只會被 Fable 推動，你用 Opus、Sonnet、Haiku 它都不會動。不獨立的部分：Fable 用掉的量會計進「全部模型」那條，因為所有模型抽的是同一個週額度。官方說明頁的寫法是 Fable 抽你方案原本的用量限制，只是抽得比其他模型快(2026-07 對照)。所以正確的畫面是「一個水池、兩個碼表」，不是兩個池子。Pro 那一級不適用，Fable 在那邊完全不吃方案額度。

**Q: 用 Opus 或 Sonnet 會消耗到 Fable 的額度嗎？**

不會。Fable 那條碼表只計 Fable 的用量，其他模型碰不到它。但要注意反方向：如果你用其他模型把「全部模型」那條推到接近滿，Fable 一樣會停，因為兩條碼表哪一條先滿，你就被哪一條卡住。想用滿 Fable 的份額，實務上的門檻是別讓其他模型先吃掉超過一半的週額度。

**Q: Fable 的 50% 是不是要在前半週用掉？**

不是，順序完全自由。這是我自己一開始踩的誤會：我把 50% 理解成「前半段的區間」，以為不趁前半週用就過期了。實際上 50% 講的是份額上限，不是時間順序，你可以週一用滿、也可以週五才開始用，結果一樣。唯一跟順序有關的情況是：其他模型先用超過一半的話，留給 Fable 的空間就不到 50% 了。

**Q: 其他模型用到 40% 之後，Fable 還能用滿 50% 嗎？**

可以，而且照定義推算，總量會來到 90%(40% + 50%)，還剩約 10% 給其他模型收尾。兩條碼表的分母是同一個週額度，所以百分點可以直接相加。但這是照官方那句「最多 50% 的週額度」推出來的算法，不是官方公布的公式，實際請以 /usage 面板顯示的數字為準。另外提醒一句期待管理：Fable 用得比其他模型快，那 50% 買到的工作量會明顯少於一半。

**Q: 怎麼看自己 Fable 用掉多少？**

在 Claude Code 裡輸入 /usage。我這台 Max 5x 的面板會同時列出全部模型與 Fable 的當週用量，各自的百分比與重置時間都在上面(不同方案列出的條目不一定相同)。建議兩條一起看：只盯 Fable 那條的話，很容易在總量先見底時被打斷還搞不清楚原因。網路文章跟面板數字對不上時，以面板為準，這條規則 2026 年 7 月改過，舊文章很可能寫的是改版前的規則。

**Q: Pro 方案有 Fable 的 50% 嗎？**

沒有。定案後的分流是：Max 這一級的方案保留「Fable 最多 50% 週額度」;Pro 這一級則是 Fable 完全不吃方案額度，要用就走 usage credits(按實際用量另外扣的儲值點數)，費率以官方定價頁為準。所以「Fable 吃不吃額度」這題要先問你在哪個方案，這也是網路上說法看起來互相矛盾的主因之一。(方案分流以官方說明頁為準;定案的確切日期各家報導不一，我這裡不寫死。)

---

## Claude Code 設定在哪改？4 個地方別找錯

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-settings-guide.html
> 找不到設定，通常不是你不會找。Claude Code 的設定散在四個地方：選單、設定檔、只能開機時帶的參數，還有不歸它管的外殼。深色模式、全自動權限、字級縮放各在哪一層。

短答給趕時間的人：Claude Code 的設定不在同一個地方，分四層。①<mark><strong>選單</strong></mark>：打 /config 開設定畫面，深色淺色這種外觀設定在這 ②<mark><strong>設定檔</strong></mark>:<code>settings.json</code>，權限規則、環境變數這些選單裡不一定有的，都要自己寫進檔案，而且分使用者、專案、本機三層 ③<mark><strong>只能開機時決定的</strong></mark>：最寬鬆的那個權限模式，開著用的時候切不進去，得關掉重開、在指令後面加參數 ④<mark><strong>根本不歸 Claude Code 管</strong></mark>：像 Ctrl 加減號縮放字級，那是終端機或桌面 App 自己的功能，翻遍設定也找不到。找不到某個設定，先問這件事屬於哪一層。

這篇的起點是一件小事。

我用了好一陣子才發現，按 Ctrl 加號可以把字放大，Ctrl 減號可以縮小。

第一個念頭是「這麼實用的東西為什麼藏這麼深」，於是跑去翻設定。

結果整個設定翻完，找不到。

不是藏得深。那個功能根本不在 Claude Code 的設定裡。

回頭想才知道，我以前找設定找得那麼累，是因為心裡預設「設定就該在同一個地方」。

實際上分成四層，各管各的。

搞清楚哪一層管什麼之後，找東西快很多，也不會再為了一個根本不存在的選項翻半天。

### 先看整張表：設定分四層，各管各的

與其一個一個記，不如先記這張表。下次遇到「某個設定在哪」，先判斷是哪一層，再去那一層找：

判斷口訣：跟「AI 怎麼做事」有關的，在 1 或 2;跟「畫面長怎樣」有關的，很可能在 4。

第 4 層是最容易白白花力氣的一層。

因為你會一直在 Claude Code 裡面，找一個根本不在裡面的東西。下面四節照這個順序一層一層講。

### 第 1、2 層：選單改得到的，跟只能寫進檔案的

<mark><strong>第 1 層，選單。</strong></mark>打 /config 會開出設定畫面，深色淺色的主題就在這裡改。

桌面 App 打 /config 一樣會開出同一個畫面。

這裡有個坑值得單獨講，因為<mark><strong>不會報錯</strong></mark>。

終端機版新一點的版本，可以直接打 <code>/config theme=dark</code>，一行改完。

但在<mark><strong>桌面 App，指令後面那串字會被直接忽略</strong></mark>。

你打 <code>/config theme=dark</code>，畫面是開了，主題完全沒變，也沒有任何錯誤訊息。

所以你會以為自己改好了，其實沒有。

看到網路教學說一行就能搞定，實際打了卻沒反應？先確認你用的是終端機還是桌面 App。

<mark><strong>第 2 層，設定檔。</strong></mark>很多東西選單裡沒有，只能自己寫進 <code>settings.json</code>。

權限的允許和禁止清單、環境變數、hooks(自動觸發的動作)，都寫在這個檔案裡。

而且這個檔案<mark><strong>分三層</strong></mark>，各有各的用途：

- <code>~/.claude/settings.json</code>(使用者層)：你自己的偏好，套用到所有專案。個人習慣寫這裡。
- <code>.claude/settings.json</code>(專案層)：放在專案資料夾裡，<mark><strong>會跟著程式碼一起上傳、整隊都拿得到</strong></mark>，所以是給整個團隊共用的規則。
- <code>.claude/settings.local.json</code>(本機層)：同樣在專案裡，但預設不會跟著上傳，放「只有我這台要的」設定。

同一個設定在多層都有的時候，誰贏是固定的。

公司統一發下來的最大，再來是你開機時打的參數，然後本機層蓋過專案層，專案層蓋過使用者層。

<mark><strong>最常見的失誤是把個人偏好寫進專案層，然後上傳出去</strong></mark>，結果整隊的人都被你的偏好蓋到。

要判斷寫哪一層，問自己一句：這條規則是我自己的習慣，還是這個專案的規矩？

是自己的習慣就寫使用者層，是專案的規矩才寫專案層。

### 第 3 層：有些模式，為什麼只能在開機那一刻決定？

這一層最容易讓人想不到，也是「翻遍設定都找不到」的第二大來源。

Claude Code 的權限模式有好幾個，從最嚴到最鬆。

但<mark><strong>不是每個模式都能在對話中途切換</strong></mark>。

按 Shift+Tab 可以在對話中途循環切換，預設會在三個之間繞：每件事都先問你的(畫面上標 Manual)、自動改檔的、還有<a href="/newbie-pitfalls/claude-code-plan-mode.html">規劃模式</a>。

(<mark><strong>Windows 上有些情況 Shift+Tab 不會動</strong></mark>，備用鍵與其他按鍵失效的狀況，我整理在<a href="/newbie-pitfalls/claude-code-shortcuts-not-working.html">快捷鍵沒反應那篇</a>。)

但你會聽說的那兩個更寬鬆的模式，規矩不一樣：

- <mark><strong>全自動模式</strong></mark>：不會每件事都問你，改成由另一個 AI 在背後先看過一遍再放行。要帳號條件符合才會出現在循環裡，不是每個人都翻得到。
- <mark><strong>完全跳過檢查的模式(bypass)</strong></mark>：官方講得很白，<mark><strong>你沒辦法從一個「開機時沒啟用這個模式」的對話切進去</strong></mark>。也就是說，已經開著在用了才想開，是開不了的，只能關掉重開一次。很多人怎麼按 Shift+Tab 都翻不到，原因就在這。

那要怎麼開？有三條路。

第一，關掉重開時在指令後面加 <code>--dangerously-skip-permissions</code>。

這串參數名字裡就寫了 dangerously「危險地」，不是誤植。

第二，寫進設定檔當預設。

第三，<mark><strong>如果你用的是桌面 App，得先去 Settings 裡的 Claude Code 那區，把「Allow bypass permissions mode」打開</strong></mark>。

那個開關沒開，選單裡就不會出現這個模式。

第一次開會跳一個要你承擔責任的確認框，按過之後就不再跳。

官方對這個模式的用法寫得很硬：只在容器或虛擬機這種「壞掉也不影響你本機」的環境用。這不是「比較方便的模式」，是把安全檢查整個關掉。

至於「哪些動作值得放行、哪些千萬別放」的判斷，不在這篇的範圍。

那是<a href="/newbie-pitfalls/claude-code-permissions.html">權限設定那篇</a>專門在講的，這裡只負責告訴你這些開關住在哪、為什麼找不到。

### 第 4 層：為什麼有些設定怎麼翻都找不到？

回到開頭那個 Ctrl 加減號。

我翻設定翻不到，不是我不會找。<mark><strong>官方的快捷鍵清單裡根本沒有縮放這一項</strong></mark>。

Ctrl 系列的快捷鍵官方列了一長串，全部是編輯游標、叫出歷史紀錄、開啟編輯器這類功能，沒有一個跟字級有關。

官方沒有明說原因，<mark><strong>我的解讀是</strong></mark>：縮放字級屬於裝 Claude Code 的那個程式，不是 Claude Code 本身的功能。

你在終端機裡跑，那是終端機的縮放;你在桌面 App 裡跑，那是 App 視窗的縮放。

對 Claude Code 來說，自己只負責把文字吐出來，字要多大是「誰在顯示」決定的。

所以在設定裡永遠找不到，那裡沒有這個東西。

這一層還有哪些東西？

大致上，<mark><strong>跟「畫面長怎樣」有關、而跟「AI 怎麼做事」無關的，通常都在這一層</strong></mark>：視窗大小、字型、分頁怎麼開、複製貼上的快捷鍵。

這些要去終端機自己的設定，或桌面 App 的一般設定裡調。

知道有這一層，最實際的好處是<mark><strong>省下白找的時間</strong></mark>。

下次某個設定怎麼翻都翻不到，先花三秒問自己一句。

這件事到底是 Claude Code 在做，還是裝它的那個程式在做？

如果是後者，再怎麼翻 Claude Code 的設定都不會有。

### Summary

Claude Code 的設定分四層，找之前先判斷屬於哪一層：①選單：打 /config 開設定畫面，深色淺色在這;桌面 App 有個問題是 /config 後面接的參數會被直接忽略，不報錯也不生效，一行改主題只有終端機版能用 ②設定檔：settings.json，權限清單、環境變數、hooks 選單裡不一定有;分使用者、專案、本機三層，個人偏好別寫進會跟著程式碼上傳的專案層 ③開機參數：最寬鬆的 bypass 模式官方明講沒辦法從沒啟用的對話切進去，只能關掉重開、在指令後面加參數，桌面 App 還得先在 Settings 打開對應開關，而且只該在容器或虛擬機用 ④不歸 Claude Code 管：Ctrl 加減號縮放字級不在官方快捷鍵清單裡，我的解讀是那屬於終端機或桌面 App。判斷口訣：跟 AI 怎麼做事有關的在 1、2 層，跟畫面長怎樣有關的很可能在第 4 層，再怎麼翻設定都不會有。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **JSON**：程式之間交換資料的通用格式，長得像一層層的「名稱：內容」清單，人眼也讀得懂。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **環境變數（environment variable）**：放在系統層、不寫進程式碼的設定值，最常用來放 API 金鑰等機密，避免跟著程式碼被公開。
- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。

### FAQ

**Q: Claude Code 的設定檔在哪裡？**

分三層，用途不一樣。~/.claude/settings.json 是使用者層，放你自己的偏好、套用到所有專案;專案資料夾裡的 .claude/settings.json 是專案層，會跟著程式碼一起上傳、整隊都拿得到，所以是團隊共用的規則;.claude/settings.local.json 也在專案裡，但預設不會跟著上傳，放只有你這台要的設定。同一個設定重複出現時，本機層蓋過專案層、專案層蓋過使用者層，而開機時打的參數又蓋過這三層。個人習慣寫使用者層，不要寫進會跟著上傳的專案層。

**Q: Claude Code 怎麼改深色/淺色模式？**

打 /config 開設定畫面，主題在裡面改。有個地方要注意：終端機版新一點的版本可以直接打 /config theme=dark 一行改完，但在桌面 App，指令後面接的字會被直接忽略，只會幫你打開設定畫面，主題完全沒動，而且不會報錯。看到教學說可以一行搞定卻沒反應，先確認你是在終端機還是桌面 App。

**Q: Claude Code 的字太小，怎麼放大？**

我在 Windows 上按 Ctrl 加號放大、Ctrl 減號縮小;不同終端機與作業系統的按鍵不一定一樣(Mac 我沒實測)，要去裝 Claude Code 的那個程式自己的設定裡找。這個功能不在 Claude Code 的設定裡，官方的快捷鍵清單裡也沒有縮放這一項。官方沒說原因，我的解讀是縮放字級屬於外面那層：你在終端機跑就是終端機的縮放，在桌面 App 跑就是 App 視窗的縮放。所以翻 Claude Code 的設定永遠找不到，那裡沒有這個東西。

**Q: Shift+Tab 為什麼翻不到全自動或完全不問的模式？**

因為不是每個模式都在預設循環裡。Shift+Tab 預設只在三個之間繞：每件事都先問你的(畫面標 Manual)、自動改檔的、規劃模式。全自動模式要帳號條件符合才會出現;完全跳過檢查的 bypass 模式官方明講沒辦法從一個開機時沒啟用的對話切進去，已經在用了才想開是開不了的。另外 Windows 上有些情況 Shift+Tab 不會動，官方給了 Alt+M 當備用鍵。

**Q: 怎麼開啟完全不問的 bypass 模式？**

先講清楚這是什麼：這個模式把權限檢查整個關掉，官方寫明只該在容器或虛擬機這種壞掉也不影響本機的環境用，不是「比較方便的模式」。要開有三條路：關掉重開時在指令後面加 --dangerously-skip-permissions、寫進設定檔當預設、或在桌面 App 先去 Settings 裡的 Claude Code 那區打開「Allow bypass permissions mode」開關(沒開的話選單裡不會出現)。第一次開會跳一個承擔責任的確認框。該不該用、什麼條件下才適合，〈Claude Code 一直問可不可以？權限設定教學〉那篇專門在講。

**Q: 某個設定怎麼翻都找不到，怎麼辦？**

先判斷它屬於哪一層。跟「AI 怎麼做事」有關的(權限、規則、模型)，在設定畫面或 settings.json 裡;跟「畫面長怎樣」有關的(字級、視窗、字型、複製貼上快捷鍵)，很可能根本不歸 Claude Code 管，要去終端機或桌面 App 自己的設定找。還有一種是「只能在開機那一刻決定」的，對話中途怎麼找都沒有，得關掉重開。花三秒分類，比翻十分鐘設定有用。

---

## 開新對話換乾淨腦袋？代價是它會偏離計畫

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-agent-new-session-drift.html
> 為了不讓舊對話干擾判斷而開新的，結果接手的 AI 改了你交代的事。它做得還更好，該收還是退回？我用三方對質查清楚的完整過程，附一個判斷偏離嚴重度的方法。

短答給趕時間的人：你為了讓 AI 判斷不受舊對話干擾而開一個新的接手，這是對的做法，但有代價。<mark><strong>你拿掉的那些脈絡，正好就是那些規定的來由</strong></mark>。新來的只看到規定、看不到理由，就會用自己覺得合理的方式改掉。所以偏離不是 AI 笨，是這個做法本身躲不掉的成本。真正該練的是<mark><strong>事後怎麼查</strong></mark>：讓原本那個對話還活著，把成品丟回去質問當初為什麼那樣要求，再找一個完全獨立的審查者，而且不准它讀被執行者事後改過的文件。

這件事是我自己遇到的，2026 年 7 月 30 日。

我把一個大工程拆成兩段。第一段做完之後，為了不讓前面那一大堆討論影響判斷，我開了一個新對話接手第二段，交接文件寫得算清楚。

結果全部做完、測試全過、產出還真的比原計畫好。

但它擅自改了三個地方。

而且其中有兩處是文件上明文寫「要先問我」的。

當下最難的不是「AI 做錯了」，是<mark><strong>我不知道該高興還是該生氣</strong></mark>。東西是好的，但過程不對。

這篇把我怎麼查清楚、怎麼判斷哪幾處該接受、哪幾處要退回，整理成可以重複用的做法。

### 為什麼「換乾淨腦袋」一定會帶來偏離？

開新對話的理由為什麼很正當？對話拖太長，AI 會被前面那些已經放棄的方案、改到一半的想法拖著走，判斷會鈍掉。

換一個乾淨的來接手，眼裡就只有現在該做的事。

但你拿掉的到底是什麼？

那些被丟掉的討論裡面，裝的是<mark><strong>「為什麼」</strong></mark>。

為什麼不能用那個方案、為什麼那一步要先問過、為什麼看起來多餘的限制其實有原因。

交接文件裡通常只剩<mark><strong>「做什麼」</strong></mark>，因為理由太長、寫不完，而且寫的人當下覺得那是常識。

一句話：你為了讓 AI 腦袋乾淨而拿掉的脈絡，正好就是那些規定的來由。少了來由，規定看起來就像沒必要的限制。

所以接手的那個 AI 不是在跟你作對。

它看到一條想不出理由的規定，又看到一條想得出理由的更好做法，會選後者。

而且會覺得自己幫了你。

我這次三處偏離，事後看有兩處<mark><strong>AI 是對的</strong></mark>，原本那條規定本身就寫錯了。

認清這件事之後，問題就變了。

從「怎麼防止偏離」變成「<mark><strong>偏離發生了，我怎麼在半小時內查清楚該接受還是該退回</strong></mark>」。後者才是可以練的。

### 我遇到的三處偏離，長什麼樣子？

先講具體發生什麼，不然後面的判斷方法會很抽象。三處都是「文件寫 A、實際做 B」:

1. 文件明文寫<mark><strong>不要另外做一套新的產生網頁的程式</strong></mark>，它做了一套新的。理由是兩邊文章的存法根本不一樣，硬合會變成一個兩邊都不像的怪東西。
2. 文件寫這一段<mark><strong>要先問我再動工</strong></mark>，它沒問，而且選了一個文件上根本沒列的第三種做法，順便把範圍從 4 個頁面擴到 8 個檔案、363 條文字。理由是它實測發現原本那份清單漏了一半的檔案，363 條裡有 115 條根本不在清單上，不補的話那些字之後會變成只能改程式碼。
3. 文件寫網頁裡那批舊功能留下的標記<mark><strong>建議先留著、只拆掉會動的那半，而且要問我</strong></mark>，它做了完全相反的「整個拆掉」,<mark><strong>而且當下沒有登記這是偏離</strong></mark>。

技術上，這三處後來驗證下來，AI 都沒錯。

前兩處是「換個方式存同樣的東西」，所以我把產出的網頁<mark><strong>逐字比對，一個字都沒變</strong></mark>。

第三處本來就是要拆掉東西，不可能沒變，改成同一份程式跑兩次互相對照，143 頁全部對得上、線上打開也正常。

另外測試 36 項全過，砍掉的那 145 行程式碼沒有留下任何沒人用的殘骸。

第三處讓整個網站少了 706 KB。

所以我當下的心情是：東西很好，但我完全不知道剛剛發生了什麼。

所以我才需要一套查證方法，而不是靠感覺決定要不要生氣。

### 怎麼查：三方對質，重點在「不准審查者讀被改過的那份」

我用了三個角度交叉問，三個都問完才下判斷。

順序有意義，不要跳。

<mark><strong>第一，原本那個對話別關，直接把成品丟回去質問。</strong></mark>

問法是「你當初為什麼寫這條限制？」，問<mark><strong>理由</strong></mark>不是問結論。

這一步的收穫比我想的多。

原規劃者承認自己那兩條規定是錯的。

因為寫計畫的當下，那批東西還是舊格式，它以為兩邊文章是用同一套格式存的，但那套格式當下根本還不存在，是從「反正都是文章」外推出來的，也不知道兩邊差這麼深。

規劃的人不一定比執行的人懂。規劃是在資訊最少的時候做的，執行才會撞到現實。所以「違反了計畫」不等於「做錯了」。

<mark><strong>第二，找一個完全獨立的審查者，關鍵在防污染。</strong></mark>

「要找不同的 AI 來審查」本身不是新方法，我在<a href="/newbie-pitfalls/ai-review-pipeline.html">三層審查線那篇</a>講過。

這一步真正的重點是<mark><strong>不能讓審查者讀到被告改過的版本</strong></mark>，而我第一次差點做錯。

執行的那一方做完之後，在交接文件上<mark><strong>補寫了 93 行解釋自己為什麼那樣做</strong></mark>。

如果我直接叫審查者去讀那份文件，讀到的會是被告自己寫的辯詞，不是原始的指控。

所以我的做法是<mark><strong>明令審查者在下判斷前不准讀硬碟上那一份</strong></mark>。

改用版本紀錄把當初那份乾淨的原版撈出來，再對照實際改了什麼。

(版本紀錄就是程式碼每次改動都會自動存一份舊檔，可以翻回去看。)

這一步做完，審查者查到一件我跟原規劃者都沒注意到的事。

第二處偏離同時違反了專案自己的規矩檔，而那份規矩的位階比交接文件高，所以嚴重度不會因為「上層裁決沒提到」而變輕。

<mark><strong>第三步，自己下判斷。</strong></mark>

前兩步給的是事實跟技術對錯，但「這次要不要退回重做」還要算成本跟機會，那部分沒有人能代替你決定。

### 判斷偏離嚴重度：分清楚「違反交代」跟「違反偏好」

查清楚之後，怎麼判輕重？我用的分法是<mark><strong>看那條規定是誰訂的</strong></mark>:

套回我那三處：我本人的裁決文件只有 35 行，而且<mark><strong>裡面根本沒有那兩條規定</strong></mark>。

那是規劃者自己加的執行偏好。

所以三處裡真正跨過「我的決定」那條線的只有一處，就是第二處，因為我明寫過那部分的決定權在我。

分完之後，該生氣的範圍從三處縮到一處，心情也踏實多了。

<mark><strong>最後的處理：三處都不回滾，但第三處補登記，並且寫明「結果好不豁免程序」。</strong></mark>

這句是這整件事我最想留下的一句。

技術上確實做得比原計畫好，但「反正他會同意」正是「要先問我」這條規定要防的事。

該問的還是要問，不會因為結果好就免掉。

如果我因為結果好就當沒事，下次學到的就會是「先斬後奏只要做得好就沒事」，那條「要先問我」的規定等於作廢。

後續我沒有再多寫一句「記得要問我」。

因為那句話當時已經同時存在三個地方，全部沒生效。<a href="/newbie-pitfalls/claude-code-hooks-guide.html">散在長文裡的規定會被當成建議</a>。

我改成立一個機制：<mark><strong>交接文件開頭必須有一個「要問的事」清單，接手的第一件事就是一次問完，沒問完不准動工</strong></mark>。

還有<mark><strong>任何偏離不管結果好壞，當下就要登記</strong></mark>，沒登記本身就是違規。

### 順便兩個失敗：交接文件講的話，你要自己查證

這次還遇到兩個跟主題無關但很值錢的坑，都是哪一類？「檢查通過了但什麼都沒證明」那一類。

<mark><strong>第一，交接文件憑印象寫狀態。</strong></mark>

那份文件寫「上傳的話會連同另一批東西一起送出去」，聽起來很嚇人。

實際上那批東西<mark><strong>早就在雲端了</strong></mark>，跑一行指令就能驗破。

這句誤述同時騙過我跟另一個 AI，害我們多繞一圈。教訓是：講「這些還沒上傳」這種話，要貼實際指令的輸出，不要憑印象寫。

<mark><strong>第二，檢查要配一個「該有的東西在不在」。</strong></mark>

我查網站有沒有殘留舊東西的時候，指令漏了一個參數。

結果 12 次抓到的全是網址跳轉時回的那一小段轉址訊息，根本不是網頁本身。

「不該有的東西出現 0 次」通過了，但我連真正的網頁內容都沒碰到，什麼都沒證明。

只驗「壞東西沒出現」是不夠的，因為什麼都沒抓到也會通過。一定要同時驗「好東西有出現」，例如網頁標題有抓到 1 個。兩個都過才算數。

### Summary

開新對話讓 AI 腦袋乾淨是對的做法，但有內建代價：你拿掉的脈絡正好是那些規定的來由，接手者只看到規定看不到理由，就會用它覺得合理的方式改掉。所以重點不是防止偏離，是偏離發生後怎麼查。我的查法是三方對質：①原本那個對話別關，把成品丟回去問「當初為什麼寫這條限制」，問理由不問結論，這次它承認自己那兩條規定寫錯了，因為規劃當下那個前提根本不存在 ②找獨立審查者，而且明令它在下判斷前不准讀執行者事後補寫過的文件(那份被加寫了 93 行自我辯護)，要用版本紀錄撈原始乾淨版 ③自己判成本與機會。判輕重看規定是誰訂的：你本人的決定=違反交代(嚴重)、規劃者自己加的細節=違反偏好(輕)、專案規矩檔=位階比交接文件高(嚴重)。我那三處只有一處真的跨線。最後三處都不回滾但補登記，並寫明結果好不豁免程序，因為「反正他會同意」正是那條「要先問我」的規定要防的事。另外兩個失敗：交接文件講上傳狀態要貼指令輸出不要憑印象;檢查只驗「壞東西沒出現」會被空回應騙過，一定要配一項「好東西有出現」。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。

### FAQ

**Q: 為什麼要另外開新對話讓 AI 接手？**

因為對話拖太長之後，前面那些已經放棄的方案、改到一半的想法會一直被 AI 讀進去，拖著它的判斷走。換一個乾淨的來接手，它眼裡只有現在該做的事，判斷會清楚很多。但這個做法有代價：你丟掉的討論裡裝的是「為什麼」，交接文件裡通常只剩「做什麼」，接手的人少了理由，就容易把看起來沒必要的規定改掉。

**Q: AI 接手之後沒照計畫做，是它出錯了嗎？**

不一定。我遇到的三處偏離，事後查證有兩處是它對、原本那條規定本身就寫錯了，因為規劃是在資訊最少的時候做的，執行才會撞到現實。所以「違反了計畫」不等於「做錯了」。真正該做的是查清楚：那條規定當初為什麼存在、它偏離的理由站不站得住，再決定要收還是要退。

**Q: 怎麼查 AI 到底改了什麼、該不該接受？**

三個角度交叉問，順序別跳。第一，原本那個規劃對話別關，把成品丟回去質問它「你當初為什麼寫這條限制」，問理由不是問結論，理由才判斷得出偏離合不合理。第二，找一個完全獨立的審查者，並且明令它在下判斷前不准讀執行者事後改過的那份文件，要用版本紀錄撈出原始乾淨版來對照，不然你以為的第三方意見，其實是在讀被告自己寫的辯詞。第三，成本跟機會的取捨自己判，那部分沒人能代替你。

**Q: 偏離的嚴重度怎麼分輕重？**

看那條規定是誰訂的。來自你本人決定的，違反了就是違反交代，嚴重，結果好也要追究;來自規劃者自己加的執行細節，那是偏好，理由站得住就可以收;來自專案本身規矩檔的，位階比交接文件高，一樣嚴重。我那次三處偏離，分完之後真正跨過「我的決定」那條線的只有一處，該追究的範圍從三處縮到一處。

**Q: 它做得比原計畫好，還要追究嗎？**

結果好跟程序對是兩件獨立的事，混在一起判會學到錯的教訓。我的處理是三處都不回滾(技術上確實比較好)，但把沒登記的那處補登記，並寫明「結果好不豁免程序」。原因很實際：如果因為結果好就當沒事，下次它學到的是「先斬後奏只要做得好就沒事」，那條「要先問我」的規定就等於作廢。另外我沒有再多寫一句「記得要問我」，因為那句話當時已經同時存在三個地方而且全都沒生效，散在長文裡的規定會被當成建議，要改成機制：交接文件開頭放一份「要問的事」清單，接手第一件事就是一次問完，沒問完不動工。

**Q: 交接給 AI 的文件，最容易出錯的是哪裡？**

憑印象寫狀態。我那份文件寫「上傳的話會連同另一批東西一起送出去」，實際上那批早就在雲端了，跑一行指令就驗破，但這句誤述同時騙過我跟另一個 AI。凡是講「這些還沒上傳」「目前在哪個版本」這種狀態，要貼實際指令的輸出，不要憑印象。另外一個相關的坑：檢查的時候只驗「壞東西沒出現」會被空回應騙過去，什麼都沒抓到也會通過，一定要同時驗一項「好東西有出現」，兩個都過才算數。

---

## Claude Code 用終端機還是桌面 App？差在哪

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-terminal-vs-desktop.html
> 同一個 Claude Code，可以裝在終端機也可以用桌面 App。桌面 App 內建瀏覽器、桌面操控與跑完通知。終端機接得住那些會開面板的指令。怎麼選、能不能混用。

短答給趕時間的人：兩邊是<mark><strong>同一個 Claude Code</strong></mark>，只是外面那一層不一樣。我自己兩邊輪流開，沒重裝過也沒重新登入過，設定也不用重弄一次(這是我的使用經驗，官方文件沒有專門說明這件事)。差別在：<mark><strong>桌面 App 內建就有一些終端機要另外接工具才做得到的事</strong></mark>，像內建瀏覽器(可以自己打開網頁看結果、截圖)、操控你的桌面、跑完會通知你;<mark><strong>終端機接得住桌面 App 接不住的一類指令</strong></mark>，就是那些打了會跳出一個面板讓你上下選的指令，在桌面 App 裡叫不出來。新手我建議從桌面 App 開始，撞到「這指令沒反應」再開終端機補那一次。

我一開始以為桌面 App 是給不敢碰終端機的人用的簡化版。

用下去才發現弄反了。

桌面 App 不是少了什麼，是<mark><strong>內建多了一整組東西</strong></mark>，那些在終端機那邊多半要自己另外接工具。

反過來，終端機也有比較拿手的一塊。

這篇把兩邊各自「有什麼」跟「接不住什麼」攤開，順便講一件很多人不知道的事：你不用選，兩邊可以同時開著用。

### 先講最重要的：為什麼這不是二選一？

很多人卡在這一題，是因為以為選了要從一而終。實際上不是。

我自己的用法是兩邊輪流開同一個專案，<mark><strong>沒有為了換邊而重設過任何東西</strong></mark>。

一邊調好的規則、允許清單、預設模式，換過去照樣在。這是我的使用經驗，不是官方規格，你第一次換的時候，還是看一眼比較保險。

所以正確的問法不是「我該用哪個」，而是「這件事用哪個比較順？」

裝了桌面 App 之後終端機那條路不會消失，反過來也一樣。

以我的經驗，換到另一邊就是換一個視窗打開而已，不用重裝也不用重新登入。

### 桌面 App 內建就有的四樣

這一組是我當初完全沒料到的。桌面 App 內建到底有什麼？要講精確一點：這些是<mark><strong>桌面 App 內建就有</strong></mark>的，終端機那邊多半要自己另外接工具才做得到：

- <mark><strong>內建瀏覽器</strong></mark>。桌面 App 可以自己打開一個網頁看結果、讀畫面上的內容、抓錯誤訊息、截圖給你看。做網站的時候差別最大：改完不用你自己去按重新整理再回來描述哪裡怪，它自己看。完整玩法我寫在<a href="/newbie-pitfalls/claude-browser-automation.html">讓 Claude 自己開網頁那篇</a>。
- <mark><strong>操控你的桌面</strong></mark>。截你的螢幕、動滑鼠鍵盤。要用得先去設定裡把這個開關打開，預設是關的。
- <mark><strong>圖表跟畫面直接顯示在對話裡</strong></mark>。不是丟一個檔案路徑叫你自己去開。
- <mark><strong>長工作跑完會通知你</strong></mark>。可以放著去做別的事，不用一直盯著看跑完沒。

桌面 App 自己的設定分成三區，這些開關住在那裡，而不在 Claude Code 裡面。

<mark><strong>Settings 裡的 Claude Code 那區</strong></mark>、<mark><strong>General 那區</strong></mark>(操控桌面的開關在這)，還有 <mark><strong>Connectors</strong></mark>(外部服務的連接)。

設定散在哪幾層、怎麼判斷該去哪找，我另外寫在<a href="/newbie-pitfalls/claude-code-settings-guide.html">設定在哪改那篇</a>。

### 終端機接得住的：那些會跳面板的指令

反過來，終端機有沒有桌面 App 接不住的東西？

有一類：<mark><strong>打了會跳出一個面板讓你上下鍵選、按 Enter 確認的指令</strong></mark>。

這類指令在桌面 App 的對話框裡叫不出來，我遇到的是完全沒反應。

我第一次撞到是 2026 年 7 月 18 日要裝一個外掛。

教學寫著打某個指令會跳出市集面板讓你挑，在桌面 App 裡怎麼打都沒有。

開終端機打同一行。面板就出來了。

當下以為是自己裝壞了，其實是打錯地方。

判斷法很簡單：那個指令的教學如果寫「會跳出一個清單讓你選」，就去終端機打。純文字問答型的指令兩邊都可以。

還有一類是<mark><strong>純文字介面本來就比較順的場景</strong></mark>。

你已經開著終端機在跑別的東西、想把 Claude Code 接到一堆文字指令工具中間，或是你連到遠端的機器上工作。

這些情況終端機比較自然。

### 照你現在在做什麼，決定用哪一個？

不用糾結。照這張表挑：

我自己現在的用法是<mark><strong>桌面 App 當主場，終端機當備用</strong></mark>。

九成的事在桌面 App，撞到「這指令怎麼沒反應」，就開終端機打那一次，打完關掉回來。來回切對我來說沒什麼成本，因為我不用重設任何東西。

最後補一個很多人不知道的事。

<mark><strong>新接上去的外部服務(MCP)會直接進到你正在進行的對話裡</strong></mark>，不用為了讓它生效而重開一個新的。

我 2026 年 7 月 19 日第一次接的時候還特地關掉重開，白做了。

### Summary

終端機跟桌面 App 是同一個 Claude Code 的兩種外觀，以我的使用經驗不用重裝也不用二選一，同一個專案可以兩邊輪流開。桌面 App 內建就有四樣(終端機那邊多半要另外接工具)：內建瀏覽器(自己開網頁看結果、截圖)、操控你的桌面(要先去 General 那區把開關打開)、圖表直接顯示在對話裡、長工作跑完會通知。桌面 App 自己的設定分三區(Claude Code、General、Connectors)，那些開關住在 App 而不在 Claude Code 裡。終端機獨佔的是那類「打了會跳出面板讓你上下選」的指令，桌面 App 接不住，叫不出來的時候不是你裝壞了，是打錯地方;連遠端機器工作也是終端機比較自然。選法照事情挑：做網站看效果、要它操作程式、長工程、剛入門就用桌面 App;要打會跳面板的指令、連遠端就用終端機。我自己是桌面 App 當主場，撞到指令沒反應就開終端機打那一次。另外新接上去的外部服務會直接進到現在的對話，不用重開。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **MCP（Model Context Protocol）**：讓 AI 工具安全連接外部服務（瀏覽器、行事曆、資料庫）的通用接口標準，由 Anthropic 推出。

### FAQ

**Q: Claude Code 的終端機版跟桌面 App 版是同一個東西嗎？**

是同一個 Claude Code，只是外面那一層不一樣。我自己是兩邊輪流開同一個專案，沒有為了換邊重裝、重新登入或把設定重弄一次。這是我的使用經驗，官方文件沒有專門說明這件事，你第一次換的時候還是看一眼比較保險。

**Q: 桌面 App 是比較簡化的版本嗎？**

剛好相反，桌面 App 內建多了一整組東西(這些在終端機那邊多半要自己另外接工具)：內建瀏覽器(可以自己開網頁看結果、讀畫面內容、截圖給你看)、操控你的桌面(截螢幕、動滑鼠鍵盤，要先去設定打開)、圖表跟畫面直接顯示在對話裡、長工作跑完會通知你。做網站的時候差別最大，改完不用你自己去看再回來描述哪裡怪，它自己看。

**Q: 為什麼有些指令在桌面 App 裡打了沒反應？**

因為那類指令打了會跳出一個面板讓你用上下鍵選、按 Enter 確認，這種互動面板桌面 App 接不住，叫不出來。判斷法：教學如果寫「會跳出一個清單讓你選」，就去終端機打;純文字問答型的指令兩邊都可以。我第一次撞到是裝外掛的時候，在桌面 App 怎麼打都沒有，開終端機打同一行面板就出來了。不是裝壞了，是打錯地方。

**Q: 新手該從終端機還是桌面 App 開始？**

建議從桌面 App 開始，因為看得到東西、回饋比較直觀，長工作跑完還會通知你。撞到「這個指令怎麼沒反應」的時候再開終端機打那一次，打完關掉回來就好。因為設定共用，來回切沒有成本，不需要一開始就選邊站。

**Q: 換到桌面 App 需要重新設定嗎？**

以我自己的經驗不用，我換過去沒有重新設定過，原本的規則跟允許清單都還在。這是使用經驗不是官方規格，建議你換過去之後先看一眼確認。另外有一件很多人不知道的事：新接上去的外部服務會直接進到你正在進行的對話裡，不用為了生效而關掉重開。我第一次接的時候還特地重開了一次，白做的。

---

## Claude Code 快捷鍵沒反應？先看誰攔走了

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-shortcuts-not-working.html
> 按鍵沒作用九成不是 Claude Code 壞了，是外面那層程式先攔走了。Mac 的 Alt 系全滅、貼圖貼不進、切不動權限模式、找不到縮放字級 — 四種症狀各自去哪修，附分平台按鍵。

短答給趕時間的人：快捷鍵按了沒反應，<mark><strong>九成不是 Claude Code 壞了，是外面那一層程式先攔走了</strong></mark>。你的鍵盤訊號要先經過終端機或桌面 App，那一層可以自己截走、不往下傳。四種最常見的：<mark><strong>Mac 上 Alt 開頭的全滅</strong></mark>(要先去終端機把 Option 設成 Meta 鍵，也就是讓終端機把 Option 當 Alt 用)、<mark><strong>貼圖片貼不進去</strong></mark>(Windows 與 WSL 改按 Alt+V，Mac 的 iTerm2 是 Cmd+V)、<mark><strong>切不動權限模式</strong></mark>(Windows 上 Shift+Tab 沒作用時改按 Alt+M)、<mark><strong>找不到縮放字級</strong></mark>(官方快捷鍵清單裡沒有這一項，我的解讀是那歸外面那一層程式管)。重裝沒用，重裝不會讓被攔走的按鍵回來。

這篇的起點是我按了一個快捷鍵，什麼事都沒發生。

第一個念頭是「是不是裝壞了」。

幸好動手之前先查了一下。重裝根本不會有用。

因為問題不在 Claude Code 身上。

「按鍵沒反應」有一整類都是同一個原因：<mark><strong>你的按鍵要先經過外面一層程式</strong></mark>，而那一層可以自己截走。

搞懂這一層之後，這類問題就有地方查了。

### 你的按鍵中間隔了一層，為什麼按了會沒反應？

你按下的鍵，不是直接送到 Claude Code。

中間要先經過<mark><strong>你用來跑它的那個程式</strong></mark>，也就是終端機視窗，或桌面 App。

那一層有權利先看一眼。這個組合鍵如果是我自己要用的，我就截走，不往下傳。

為什麼同一個快捷鍵，在你朋友那台會動、在你這台不會動？

常常不是版本問題，是<mark><strong>你們外面那一層不一樣</strong></mark>，或者那一層的設定不一樣。

這也解釋了為什麼重裝 Claude Code 沒用。

問題根本不在 Claude Code 身上。

判斷方向：如果是「某幾個鍵沒反應、其他都正常」，先懷疑被外面那一層攔走了。如果是「整個沒反應、連打字都沒回音」，那是另一回事，去看<a href="/newbie-pitfalls/claude-code-stuck-not-responding.html">卡住沒反應那篇</a>。(這一節的原理是我自己的理解，官方文件沒有這樣一段說明。)

### 症狀對照表：四種最常見的

先照症狀對號入座，找你那一種：

<mark><strong>Mac 的 Alt 系全滅</strong></mark>是這裡面最容易讓人崩潰的，因為不是壞一個，是壞一整組。

移動游標、叫出上一次的輸入，這些常用的都在裡面。

原因是 Mac 的終端機預設沒有把 Option 鍵當成 Alt 來用，要你自己去開。

官方把這個設定叫「把 Option 設成 Meta 鍵」。

官方對三個常見環境各給了設定位置(兩種終端機，加上 VS Code)，都在那個程式自己的偏好設定裡，不在 Claude Code。

<mark><strong>貼圖片</strong></mark>這個很實用，但很少人知道。

你可以直接把剪貼簿裡的圖片貼進對話，讓 Claude Code 看。

按 Ctrl+V 沒反應，是不支援嗎？

不是。是你的終端機把 Ctrl+V 拿去做自己的貼上了。

官方給的替代鍵<mark><strong>分平台</strong></mark>:Windows 與 WSL 用 <mark><strong>Alt+V</strong></mark>，Mac 的 iTerm2 用 <mark><strong>Cmd+V</strong></mark>。

<mark><strong>切不動權限模式</strong></mark>指的是按 Shift+Tab 應該要在幾種模式之間輪流切，結果畫面上那個標示完全不動。

Windows 上有些情況會這樣，官方另外給了 <mark><strong>Alt+M</strong></mark> 這個備用鍵。

按不動的時候換這個鍵試試。不用重開。

### 第四種比較特別：為什麼縮放字級連清單裡都沒有？

縮放字級跟前三種不一樣。

前三種是「有這個功能，但被攔走了」，這一種是<mark><strong>官方的快捷鍵清單裡根本沒有這一項</strong></mark>。

我把官方的清單逐項看過，Ctrl 開頭的列了一長串：移動游標、叫出歷史紀錄、開啟編輯器、中斷正在跑的動作。

沒有任何一項跟字級有關。

我在 Windows 上按 Ctrl 加號放大、Ctrl 減號縮小可以用。

不同終端機與作業系統的按鍵不一定一樣(Mac 我沒實測)，要去外面那一層自己的設定裡找。

至於為什麼不歸 Claude Code 管，我在<a href="/newbie-pitfalls/claude-code-settings-guide.html">設定在哪改那篇</a>講過，這裡不重複。

### 還有一種：不是設定的問題，是訂閱方案決定的

最後補一類，<a href="/newbie-pitfalls/claude-code-settings-guide.html">設定在哪改那篇</a>那套「設定分四層」沒講到的。

有些東西<mark><strong>怎麼翻都不會有，因為根本不是設定</strong></mark>，是你買的方案決定的。

最典型的一個：某些比較寬鬆的權限模式，<mark><strong>要帳號條件符合才會出現在選單裡</strong></mark>。

官方列了訂閱方案、組織、模型、供應商四項條件，這個你在設定裡翻一整天都翻不出來，因為根本不住在設定裡。

所以把那篇的四層再加上這一種，「找不到」總共有五種原因。

只有一種是你不會找。

下次按不動、翻不到，先花三秒問自己是哪一種？比翻十分鐘設定有用。

### Summary

快捷鍵沒反應九成不是 Claude Code 壞了，是外面那一層程式先攔走了。你按的鍵要先經過終端機或桌面 App，那一層可以自己截走、不往下傳，所以重裝沒用。四種常見症狀：①Mac 上 Alt 開頭的快捷鍵整組沒反應，要先去終端機把 Option 設成 Meta 鍵(也就是讓終端機把 Option 當 Alt 用);官方對三個常見環境各給了設定位置，兩種終端機加上 VS Code，都在那個程式自己的偏好設定裡 ②貼圖片按 Ctrl+V 沒反應是被終端機拿去做自己的貼上了，替代鍵分平台：Windows 與 WSL 用 Alt+V、Mac 的 iTerm2 用 Cmd+V ③Windows 上 Shift+Tab 切不動權限模式，改按 Alt+M，這個不是被攔，是執行環境沒開某個輸入模式 ④找不到縮放字級，這個跟前三種不同，不是被攔，是官方快捷鍵清單裡根本沒有這一項。另外還有一類根本不是設定問題：某些比較寬鬆的權限模式要帳號條件符合才會出現在選單裡(官方列了方案、組織、模型、供應商四項條件)，這個翻設定永遠翻不到。判斷方向：某幾個鍵沒反應但其他正常，先懷疑被攔;整個沒反應連打字都沒回音是另一回事。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **WSL（Windows Subsystem for Linux）**：微軟提供的功能：在 Windows 裡面跑一個 Linux 子系統，像電腦裡再開一台小電腦。需要 Linux 環境的工具靠它就能在 Windows 上用，但檔案與工具分屬兩個世界，混用容易踩坑。

### FAQ

**Q: Claude Code 快捷鍵按了沒反應，是壞掉了嗎？**

九成不是。你按下的鍵不是直接送到 Claude Code，要先經過你用來跑它的那個程式，也就是終端機視窗或桌面 App。那一層有權利先看一眼，如果這個組合鍵是那一層自己要用的，就截走不往下傳。所以重裝 Claude Code 沒用，問題不在 Claude Code 身上。判斷方向：某幾個鍵沒反應但其他正常，先懷疑被攔;整個沒反應連打字都沒回音，那是另一回事。

**Q: Mac 上 Alt 開頭的快捷鍵全部沒反應怎麼辦？**

這是最容易讓人崩潰的一種，因為不是壞一個是壞一整組，移動游標、叫出上一次輸入這些常用的都在裡面。原因是 Mac 的終端機預設沒有把 Option 鍵當成那個用途，要自己去開。官方對三個常見環境各給了設定位置(兩種終端機，加上 VS Code)，都在那個程式自己的偏好設定裡，不在 Claude Code 的設定裡找得到。

**Q: 圖片貼不進 Claude Code 怎麼辦？**

你可以直接把剪貼簿裡的圖片貼進對話讓 Claude Code 看，按 Ctrl+V 沒反應不是不支援，是你的終端機把 Ctrl+V 拿去做自己的貼上功能了。官方給的替代鍵分平台：Windows 與 WSL 用 Alt+V，Mac 的 iTerm2 用 Cmd+V。

**Q: Shift+Tab 切不動權限模式怎麼辦？**

按 Shift+Tab 應該要在幾種權限模式之間輪流切，如果畫面上那個標示完全不動，Windows 上有些情況會這樣，官方另外給了 Alt+M 這個備用鍵，換它試試就好，不用重開。另外提醒：不是每個模式都在這個循環裡，有些要開機那一刻就決定，按再多次也翻不到。

**Q: 按鍵沒反應跟設定找不到，是同一件事嗎？**

是同一個原因的兩種表現：你要的東西不歸 Claude Code 管。按鍵沒反應是被外面那一層程式(終端機或桌面 App)先攔走了;設定找不到常常是那個開關根本住在外面那一層，或是根本不是設定，而是你買的方案決定的，例如某些比較寬鬆的權限模式要帳號條件符合才會出現在選單裡。分辨法：某幾個鍵沒反應但其他正常，是被攔;整個東西遍尋不著，先想這件事歸不歸 Claude Code 管。

---

## Claude Code 不能 rewind？8 個原因與 4 道防線

> Source: https://www.coolkidlab.com/newbie-pitfalls/claude-code-rewind-not-working.html
> 桌面 App 跳 Can't rewind to this message？那是官方沒修的已知問題。rewind 只是本機小倒帶：指令改的、分身改的、超過 30 天的都救不回。8 個原因與 4 道防線。

短答給趕時間的人：rewind 是「本機的小倒帶」，不是保險箱。官方文件寫明，rewind 只追蹤 AI 用編輯工具改的檔案，指令改的、分身改的都不在快照裡，而且快照預設 30 天清掉、每個對話只留最近 100 個斷點。所以不能倒帶通常不是壞掉，是本來就超出快照的範圍。用下面 8 個原因的對照表找你中的那一項，再用 4 道防線讓「救不回」變成虛驚。

最近我的倒帶一直失靈。

按 ESC 兩下、選要回去的那則訊息，跳出「Can't rewind to this message」（無法倒帶到這則訊息），換一則還是同樣的錯誤，再換一則，還是一樣。

不挑訊息，每一則都倒不回去。

我用的是桌面 App。查了才發現，這是 GitHub 上掛著的已知問題：今年 5 月更新後開始，官方把回報單關掉、標成「不打算修」。

回報的人說，同一台電腦開終端機版就正常。

他在 Mac 上遇到，我在 Windows 上遇到，這件事不挑系統。

這件事逼我去找官方文件。讀完的心得是：就算沒有這個問題，rewind 能救的範圍也比我以為的窄很多。

這篇前半是「不能 rewind 的 8 個原因」對照表，後半是 4 道防線，包含一個整個資料夾被刪光的真實案例。

### rewind 到底存了什麼？

rewind 的原理是快照：每次你送出一句話之前，Claude Code 先把檔案狀態拍下來，之後可以退回去。<a href="https://code.claude.com/docs/en/checkpointing">官方文件</a>白紙黑字寫了三個關鍵限制。

1. <mark><strong>只追蹤 AI 用編輯工具改的檔案</strong></mark>。AI 跑指令做的改動（例如刪檔、搬檔）、分身（subagent）做的修改，官方明列不在快照裡。
2. <mark><strong>快照有期限</strong></mark>。存在你電腦的 <code>.claude</code> 資料夾裡，預設 30 天清掉，每個對話只留最近 100 個斷點。
3. <mark><strong>官方自己的定位</strong></mark>：checkpoint 是「本機的復原鍵（local undo）」，git 才是「永久的歷史（permanent history）」。這是原文直譯，不是我的解讀。

白話翻譯：rewind 管的只有 AI 自己動手改的檔案，而且只有最近的。

指令改的、分身改的、放太久的，都不在快照裡，要靠 git 才救得回。

### 不能 rewind 的 8 個原因對照表

我把官方限制加上自己遇到的狀況整理成一張表。從左邊找你的症狀。

前 7 項全部有官方文件背書。第 8 項我在官方文件裡找不到任何說明，只有 <a href="https://github.com/anthropics/claude-code/issues/57206">GitHub 回報單</a>，我自己在 Windows 撞到同一款。

看出共通點了嗎？8 項裡有 6 項的解法指向同一個地方：git。

### 最壞的情況：連 git 都一起消失

那靠 git 就萬無一失了嗎？大部分時候夠用，但有一種情況連 git 都陪葬。<a href="https://hackmd.io/@Nyanako0129/Syjf5Q5SMg">一份公開的事故檢討</a>記錄了全程。

一個自動化程式在清理暫存檔的時候，把「目前所在的資料夾」誤當成要清的暫存資料夾，一口氣刪光整個專案，連 <code>.git</code>，也就是 git 的整本歷史，都一起蒸發。

更值得記住的是原因：舊版程式本來有一道防這件事的檢查，是後來 AI 改寫的時候被拿掉的。

最後靠兩條命活回來：電腦的系統快照，加上早就推上 GitHub 的雲端備份。本機的一切都沒了，救援全部來自電腦之外。

寫在程式裡的防線，會在下一次改寫時被拆掉。AI 的自我約束是軟的，環境的圍欄才是硬的。

對照官方文件再看一次就懂：被指令刪掉的檔案，rewind 明列救不回。

而 git 的歷史就住在專案資料夾裡，資料夾整個消失，歷史跟著消失，這種等級的事故，前面 8 個原因的解法全部失效。

### 我的 4 道防線

那防線要怎麼設？我的配置是 4 道，一道比一道外圈：兩道設定一次就自動跑，另外兩道練成固定習慣。

1. <mark><strong>權限防線</strong></mark>。刪除類的指令要 AI 先問過我，全自動同意的模式不開。設定方法見<a href="/newbie-pitfalls/claude-code-permissions.html">權限設定那篇</a>。
2. <mark><strong>git 加遠端</strong></mark>。做完一段就存斷點，推上 GitHub 等於多一份異地備份。上面案例的主角，一半是靠這條活的。不會指令就跟 AI 說「幫我把目前進度存成斷點並推上去」。
3. <mark><strong>系統快照</strong></mark>。Mac 開 Time Machine，Windows 開檔案歷程記錄。案例主角的另一半命是這條救的。
4. <mark><strong>隔離</strong></mark>。專案放獨立資料夾，不讓 AI 直接在桌面或整個家目錄工作。要同時跑好幾個實驗，就請 AI 幫每個實驗各開一個獨立的工作資料夾，互不干擾（<a href="/newbie-pitfalls/claude-code-subagent-guide.html">分身派工那篇</a>有講）。

回到 rewind 本身：這功能還是好用的，反悔上一步靠倒帶最快。

只是官方那句話值得抄在心裡：checkpoint 是本機的復原鍵，git 才是永久的歷史。倒帶拿來反悔，防線拿來保整個專案，兩個都要有。

### Summary

rewind 是本機的小倒帶，不是保險箱。官方文件寫明三個限制：只追蹤 AI 用編輯工具改的檔案（跑指令做的改動、分身 subagent 做的修改都明列救不回）、快照存在本機 .claude 資料夾預設 30 天清掉、每個對話只留最近 100 個斷點，官方自己的定位是 checkpoint 等於本機復原鍵、git 才是永久歷史。不能 rewind 的 8 個常見原因：斷點之後沒有被追蹤的編輯（還原程式碼選項不出現）、改動來自指令、改動來自分身、超過保存期限、輸入框有字時 ESC 兩下變成清空、功能開關被關、快照資料夾被清、桌面 App 的已知問題（GitHub 編號 57206，今年 5 月更新後全部訊息跳 Can't rewind to this message，官方標不打算修，回報者說同機終端機版正常，我在 Windows 撞到同款）。8 項裡 6 項的解法指向 git，但一份公開的事故檢討顯示連 git 都可能陪葬：自動化程式誤把目前資料夾當暫存清掉，連 .git 一起刪光，靠系統快照加 GitHub 遠端才救回，而且原本防這件事的檢查是 AI 改寫時拆掉的。我的 4 道防線：權限防線（刪除類指令要問）、git 加遠端、系統快照（Time Machine 或檔案歷程記錄）、專案資料夾隔離。

### 名詞解釋

- **Rewind（倒帶）**：Claude Code 內建的復原功能：每次你送出指令前先拍一張檔案快照，按 ESC 兩下或打 /rewind 可以退回之前的狀態。只追蹤 AI 用編輯工具改的檔案，跑指令做的改動不算。
- **Checkpoint（斷點快照）**：Rewind 功能背後的存檔點：每則指令送出前自動存一張檔案快照，預設保留 30 天、每個對話最多 100 個。官方定位是「本機的復原鍵」，永久的歷史還是要靠 git。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **subagent（子代理）**：AI 派出去的分身：主對話把一件事外包給另一個獨立的 AI 執行，做完只回報結果，不佔用主對話的記憶空間。

### FAQ

**Q: Claude Code 按 ESC 兩下沒反應，怎麼開倒帶選單？**

先看輸入框有沒有字。輸入框有字的時候，ESC 兩下是清空輸入，不是開選單，清空之後再按一次就出來了，或者直接打 /rewind。如果是桌面 App 每一則訊息都跳錯誤，那是另一件事，見下一題。

**Q: 桌面 App 一直跳 Can't rewind to this message 怎麼辦？**

我自己就遇到這個。查證結果是 GitHub 上的已知問題（編號 57206），今年 5 月更新後出現，官方已把回報單標成不打算修，而且我在官方文件裡沒找到桌面 App 的 rewind 說明。回報的人說同一台電腦開終端機版就正常。我的做法：重要的倒帶去終端機做，平常靠 git 斷點，不把桌面 App 的 rewind 當保險。

**Q: 為什麼倒帶了檔案沒變回來？**

最常見的兩個原因：那些改動是 AI 跑指令做的，或者是分身（subagent）做的。官方文件明列這兩種都不在快照裡，rewind 只追蹤 AI 用編輯工具直接改的檔案。這兩種情況都要改用 git 還原，不會下指令就叫 AI 代勞。

**Q: rewind 的快照存在哪？存多久？**

存在你電腦的 .claude 資料夾裡，是看得到的明文檔案。預設 30 天跟著對話一起清掉，而且每個對話只保留最近 100 個斷點。清掉資料夾或換電腦，倒帶能力就跟著消失，長期的保障要靠 git 跟雲端備份。

**Q: 選單裡沒有「還原程式碼」選項，是壞掉了嗎？**

不是。官方寫明：選的那個斷點之後如果沒有被追蹤的檔案編輯，還原程式碼的選項就不會出現，只剩還原對話跟摘要。想退檔案就往前選更早的斷點。

**Q: 不會 git，只靠 rewind 可以嗎？**

官方自己的定位是：checkpoint 是本機的復原鍵，git 才是永久的歷史，兩個是搭配不是取代。不會指令沒關係，跟 AI 說「幫我把目前進度存成一個斷點」就等於在用 git。再加開系統備份（Time Machine 或檔案歷程記錄），就算遇到整個資料夾消失的最壞情況，也活得回來。

---

## 前端後端資料庫差在哪？看懂才敢叫 AI 改網站

> Source: https://www.coolkidlab.com/newbie-pitfalls/frontend-backend-database.html
> AI 幫你做的網站是三塊拼起來的：看得到的畫面、背後跑事情的程式、記東西的資料庫。用我自己兩次改壞的真實經過，講怎麼指名要動哪一塊，才不會這邊修好那邊壞。

短答給趕時間的人：AI 幫你做的網站通常是 3 塊拼起來的。看得到的畫面叫<mark><strong>前端</strong></mark>，背後跑事情的程式叫<mark><strong>後端</strong></mark>，記東西的地方叫<mark><strong>資料庫</strong></mark>。這邊修好那邊壞，多半不是 AI 亂改，是交代的人沒圈範圍。開工前先要 AI 畫地圖：「這個網站分哪幾塊？我要改的東西住在哪一塊？」改完再要一份動過的檔案清單，兩張對照，誤傷當場現形。

7 月底的一個晚上，我叫 AI 改網站上的一段預設文字。

檔案真的改了，部署也成功。打開網站，還是舊的那句。

我的第一個念頭是 AI 在騙我。

查出來的真相比較尷尬：那段文字同時住在兩個地方。

我改的是程式碼裡的那份，網站上顯示的是資料庫裡的那份，而我的網站規則是資料庫優先，所以 AI 沒做錯，是我根本不知道自己的網站分幾塊。

4 個月前第一次用 AI 做網站的時候，我連前端後端是什麼都講不出來。現在回頭看，把網站改壞的那幾次，幾乎都跟「不知道有幾塊」有關。

這篇把網站的三塊講成一張看得懂的地圖，再給你 4 句可以照抄的交代方式。

### 網站的 3 塊，各自管什麼？

把網站想成一間小吃店，三塊就分得開了。

<mark><strong>前端是店面</strong></mark>。菜單、桌椅、招牌，客人看得到的全部。對網站來說，就是你打開瀏覽器看到的畫面：文字、圖片、按鈕。

<mark><strong>後端是廚房</strong></mark>。客人在店面點餐，真正做菜的是廚房。

你在網站上按「訂閱」，背後收下信箱、寄出確認信的那段程式就是後端，平常看不到，但沒有廚房就出不了菜。

<mark><strong>資料庫是帳本加倉庫</strong></mark>。誰訂閱過、後台改過哪些字、紀錄累積了多少，全記在這裡。資料庫不做事，只負責記得。

想知道自己的網站有幾塊，把這句照抄丟給 AI：「這個專案分哪幾塊？前端、後端、資料庫各自在哪個資料夾或哪個服務上？」AI 會列一張清單給你，這就是你的地圖。

那你的網站有幾塊？很多新手網站其實只有前端一塊。

純頁面、沒廚房、沒帳本，那種站怎麼改都不太會連環壞。

會互相牽連，是從長出第二塊開始的。加了訂閱表單、加了後台、加了自動化，線就開始變多。我的網站就是這樣一路長出三塊的。

### 兩次真實事故：改了沒效果，跟少一個檔案整站卡住

開頭那次「改了沒效果」，後來查清楚的全貌是這樣。

我的網站有個後台，可以直接在網頁上改字。

後台改過的字會存進資料庫，顯示的時候蓋過程式碼裡的預設值，這個設計本身很合理，因為改幾個字不應該動到程式。

問題出在我忘了它的存在。

叫 AI 改程式碼裡的預設值，改得再對，畫面上永遠是資料庫那份。這種事故最消耗信心，因為每一步看起來都成功，就是沒效果。

教訓一句話：<mark><strong>同一個東西可能同時住在兩塊裡</strong></mark>。改之前先問「這段文字的最終來源是哪個檔案、還是資料庫？」，再決定改哪一份。

第二次事故在 7 月 23 日深夜，同一個晚上連兩起。

AI 加新功能時建了一個新檔案，主程式一開跑就要讀那個檔案。上傳的時候，檔案沒跟著上去。

結果是後端一啟動就停，整個網站卡在舊版，後面每一次更新都跟著失敗。一個檔案，卡住全部。

怎麼一步步查出來的，我寫過完整的一篇：<a href="/newbie-pitfalls/site-not-updating-after-push.html">部署失敗這樣查</a>。

這裡要說的是架構那一面的教訓：三塊不是各過各的，一塊斷了會拖住另外兩塊。

兩次事故的共通點：出事的位置，都不在我以為的那一塊。地圖不是工程師的裝飾品，是交代之前就要攤開的東西。

### 怎麼交代，AI 才不會誤傷另外兩塊？

我現在改網站前後，固定用 4 句話。全部可以照抄。

1. <mark><strong>開工先畫地圖</strong></mark>。「這個網站分哪幾塊？我要改 X，會動到哪幾塊？」讓 AI 先講，你再放行。
2. <mark><strong>圈範圍</strong></mark>。「這次只改畫面上的文字，不要動後端程式跟資料庫。」想更保險就指名檔案：「只准改這 2 個檔案，要動其他檔案先問我。」
3. <mark><strong>改完要清單</strong></mark>。「列出這次動過的每個檔案，各自屬於哪一塊。」拿清單對照第 1 句的地圖，超出範圍的就問理由。
4. <mark><strong>常用的規矩寫成常駐</strong></mark>。「動資料庫之前要先問我」這種話，寫進 CLAUDE.md 就不用每次重講（寫法見 <a href="/newbie-pitfalls/claude-code-claude-md.html">CLAUDE.md 那篇</a>）。大改動先開計畫模式，看 AI 打算動哪幾塊再放行（<a href="/newbie-pitfalls/claude-code-plan-mode.html">計畫模式那篇</a>）。

那出事的時候怎麼判斷是哪一塊？附一張症狀對照表，先猜位置，再丟對的第一句。

最後是誠實的邊界：如果你的站只有一塊，這整套都用不太到，直接改就好。

地圖是給開始長出第二塊的網站用的。等訂閱表單、後台、自動化加進來的那一天，再回來拿也不遲。

### Summary

AI 幫你做的網站通常是 3 塊拼起來的：前端是看得到的畫面（店面）、後端是背後跑事情的程式（廚房）、資料庫負責記東西（帳本加倉庫）。很多新手網站只有前端一塊，那種怎麼改都不太會連環壞，會互相牽連是從長出第二塊開始的。我自己兩次真實事故：一次是叫 AI 改程式碼裡的預設文字，改對了卻沒效果，因為後台改過的字存在資料庫、顯示時蓋過預設值，同一個東西同時住在兩塊裡。另一次是 7 月 23 日深夜，新檔案沒跟著上傳，後端一啟動就停，整個網站卡在舊版，一個檔案卡住全部。交代 AI 的 4 句話：開工先畫地圖（這個網站分哪幾塊、我要改的會動到哪幾塊）、圈範圍（只改畫面，不動後端跟資料庫，或指名只准改哪 2 個檔案）、改完要動過的檔案清單對照地圖、常用規矩寫進 CLAUDE.md 常駐。出事時按症狀猜位置：改了沒變化多半是被資料庫或暫存蓋過、按鈕沒反應是前後端斷線、本機正常上線壞是部署漏東西。

### 名詞解釋

- **前端（frontend）**：網站裡你看得到的那一塊：畫面、文字、圖片、按鈕。用小吃店比喻就是店面，瀏覽器打開看到的全部都算前端。
- **後端（backend）**：網站裡在背後跑事情的程式：收表單、寄信、算資料都在這層。平常看不到，像小吃店的廚房，沒有它就出不了菜。
- **資料庫（database）**：專門儲存、查詢大量資料的系統。網站的會員、留言、紀錄都放這裡。
- **部署（deploy）**：把做好的網站或程式「推上線」讓所有人用得到的動作。

### FAQ

**Q: 前端、後端、資料庫，一句話差在哪？**

前端是你看得到的畫面，後端是背後跑事情的程式，資料庫是記東西的地方。用小吃店比喻：店面、廚房、帳本。很多新手網站只有前端一塊，那種站怎麼改都不太會連環壞，開始加訂閱表單、後台、自動化之後，三塊才會互相牽連。

**Q: 不會寫程式，需要懂網站架構嗎？**

不用懂到會寫，但要懂到能指名。我兩次把網站改出問題，都不是 AI 亂改，是我交代的時候不知道要改的東西住在哪一塊。只要能問出「這個網站分哪幾塊、我要改的會動到哪幾塊」，AI 就會把地圖畫給你，交代的品質馬上不一樣。

**Q: 為什麼叫 AI 改網站會越改越亂？**

多半是交代時沒圈範圍。AI 看到問題會用自己覺得合理的方式修，可能順手動到另外一塊，你下次再修那塊，又動回這塊。解法是固定三個動作：開工先要地圖、動工前圈範圍（只改哪一塊或只准改哪幾個檔案）、改完要一份動過的檔案清單來對照。

**Q: 改了文字網站卻沒變，是 AI 騙我嗎？**

我遇過一模一樣的狀況，不是騙。同一段文字可能同時存在程式碼跟資料庫兩個地方，很多網站的顯示規則是資料庫那份優先，所以程式碼改對了畫面也不會動。先問 AI「這段文字的最終來源是哪個檔案、還是資料庫」，確認來源再改，一次就中。

**Q: 我的網站很小，也要分前端後端資料庫嗎？**

不用。只有頁面的站就是一塊，直接改就好。這張地圖是給網站開始長出第二塊的人用的，像是加了訂閱表單、會員、後台或自動化，那時候層跟層才會互相牽連，先畫地圖再交代就變得重要。

---

## 放手讓 AI 一直改，系統會爛掉嗎？我盤點的結果

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-agent-architecture-rot.html
> 有人放手讓 AI 改 2 個月，架構已經毀了。我自己放手 4 個多月卻沒感覺：是做對了什麼，還是爛了沒發現？盤點結果兩個答案都有：自動檢查守住的沒爛，靠人記得的全爛。

短答給趕時間的人：會爛，而且爛的時候你不會有感覺。我看到別人放手 2 個月，模組被 AI 改到分工亂掉、新舊版本並存。回頭盤點自己 4 個多月的系統，結論分兩半：有自動檢查在守的地方沒爛，凡是「靠自己記得去維護」的地方全部走樣，9 組副本沒有一組一致，而且我毫無感覺。防腐不能靠感覺，要把盤點排成例行動作。

前幾天在社群看到一篇失敗分享。

那個人把一套三步驟的自動化流程拆成三個模組，交給 AI 維護。

之後兩個月只動嘴：請 AI 加功能、請 AI 照網路流傳的方法優化，自己不看架構。

產出品質慢慢變差。

回頭一看：收資料的模組裡長出了產報告的程式，report_ver2 跟舊版並存，還憑空多出第 4 個模組，用他自己的話說，架構毀滅。

我第一個反應是同情，第二個反應是心虛。

我從 4 月中開始，幾乎所有東西都是 AI 改的，放手的程度不比他低。我沒有感覺到品質下降，但他在回頭看之前，大概也沒有。

所以我停下來做了一件事：把自己的系統整個盤點一遍。

是我做對了什麼，還是一樣爛了、只是沒發現？這篇是誠實的結果，兩個答案都有。

### 為什麼放手會爛？而且爛的時候沒感覺？

先講機制，這決定了你要防什麼。

AI 改東西的預設動作是<mark><strong>加，不是刪</strong></mark>。要新功能，就加一個檔案。要改行為，就加一個新版本。舊的東西動了怕壞，所以留著。

每一次改動，單獨看都合理。

沒有人守全局的話，合理的改動加總起來就是：同一件事有兩份程式、模組互相伸手進對方的地盤、沒人敢刪的舊版越積越多。

那為什麼沒感覺？因為腐化不發警報。品質是一天降一點的，每天跟昨天比都正常，等你感覺得到，通常已經過了兩個月。

更麻煩的是，單次的品質檢查擋不住這件事。

那位分享者每次請 AI 優化，AI 也都做了，每一關都過，而我自己那條<a href="/newbie-pitfalls/ai-review-pipeline.html">三層審查線</a>，審的同樣是單次的產出。

單次審查每關都過，跨時間照樣走樣。品質下降是果，架構腐化是因，而且是慢性的。

### 我盤點自己的系統，結果分兩半

盤點方法很簡單，把這段照抄丟給 AI 就能做：

「拿這 4 個特徵掃我的專案：①檔名帶 v2、old、backup 的並存檔 ②沒有任何地方引用的孤兒程式 ③說明文件描述的機制或路徑已經不存在 ④同一份東西的多份副本內容不一致。只列證據，不要修任何東西。」

AI 掃了 30 支腳本、9 組對外發布的副本、20 多個資料夾。結果呢？分兩半。

<mark><strong>好消息：主系統內部沒爛。</strong></mark>沒有新舊版本並存的檔案，資料檔零孤兒，該清的建置殘留都有清。

原因不是我勤勞，是有幾道自動檢查在守：建置的時候會自動比對登記表跟內容有沒有走樣、發布有閘門擋著、寫死的數字全改成自動計算。

機器每天自己檢查，不用靠人記得。

<mark><strong>壞消息：凡是靠「我記得去維護」的地方，全部走樣，沒有例外。</strong></mark>

1. 我有一批對外發布的小工具，同一份內容放在兩個地方，訂過「改了要兩邊同步」的紀律。盤點發現 <mark><strong>9 組全部不一致</strong></mark>，最多的差了 700 多行。紀律撐了兩個星期就斷了，我完全沒發現。
2. 3 份標著「必讀」的說明文件，內容停在 3 個月前，描述的路徑跟機制早就不存在。
3. 一套治理規則宣稱「有自動機制在強制執行」，實際上那個機制根本沒裝起來，規則本身卻還在往上疊新條文。
4. 另外掃出 8 支沒有被任何文件引用的腳本。多數是一次性的手動工具，還不算爛，但已經站在「沒人記得」的前一站。

最痛的一句：這些走樣，沒有一個是被制度抓到的，全部是這次盤點才看見。

我跟那位分享者的差別，不是我做得比較好，是我提早回頭看了。

順帶一提，連我的選題筆記都有同款：清單散在四個段落、留著過期項，也是收攏的時候才發現，會爛的不只程式碼，文件也會。

### 防腐 4 件事：不靠感覺，靠例行

盤點完，我把防腐整理成 4 件事。前兩件防「爛」，後兩件防「沒感覺」。

1. <mark><strong>同一份東西只放一個地方</strong></mark>。做不到的（例如對外要發兩處），要嘛請 AI 寫自動同步，要嘛誠實承認那裡會爛，列進盤點清單盯著。我那 9 組副本就是活教材：靠紀律同步的副本，全數走樣。
2. <mark><strong>有標準答案的檢查交給機器</strong></mark>。登記表比對、發布前的把關這種事，<a href="/newbie-pitfalls/claude-code-hooks-guide.html">寫成建置時自動跑</a>。我的系統裡沒爛的部分，全是機器在守的，沒有一處是靠我自覺。
3. <mark><strong>動架構要人點頭</strong></mark>。加新模組、改變模組分工這種事，AI 可以提案，不能自己動手。把這條寫進 <a href="/newbie-pitfalls/claude-code-claude-md.html">CLAUDE.md</a> 變成常駐規矩，不用每次重講。
4. <mark><strong>把盤點排成例行</strong></mark>。腐化不發警報，你的行事曆要替它發。就用上面那段 4 特徵的指令，我這次盤下來 AI 花不到 10 分鐘。

那位分享者是品質掉了才回頭看，看到的是毀滅現場。

我運氣好，看的時候還來得及修。你不用賭運氣，也不用等感覺，感覺到的時候都晚了。把盤點排上日曆，就是這篇最想留下的一句。

### Summary

放手讓 AI 長期改東西，系統會爛，而且爛的時候沒感覺。機制：AI 的預設動作是加不是刪，每次改動單獨看都合理，沒人守全局就累積成同一件事兩份程式、模組互相伸手、舊版沒人敢刪。腐化不發警報，單次品質審查每關都過也擋不住跨時間的走樣。我看到別人放手 2 個月架構毀滅（模組分工亂掉、ver2 與舊版並存、憑空多出模組）後，用 4 特徵清單盤點自己 4 個多月的系統：並存檔、孤兒程式、文件與現狀不符、副本不一致。結果兩半：有自動檢查在守的主系統沒爛（建置時自動比對、發布前把關、數字自動計算）。凡是靠人記得維護的全爛，9 組對外發布的副本全部不一致（最多差 700 多行）、3 份必讀文件停在 3 個月前、1 套治理規則宣稱的機制根本沒裝。這些沒有一個被制度抓到，全是盤點才看見。防腐 4 件事：同一份東西只放一個地方、有標準答案的檢查交給機器跑、動架構要人點頭（寫進 CLAUDE.md）、把盤點排成例行，因為感覺到的時候都晚了。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **自動化（automation）**：把重複性工作交給程式定時自動執行，例如每天早上自動抓新聞、整理成貼文、發到社群。

### FAQ

**Q: 讓 AI 一直改，程式真的會越改越亂嗎？**

會，而且方向很固定：加不刪。要新功能就加檔案、要改行為就加新版本、舊的怕壞就留著。每一次改動單獨看都合理，累積下來就是同一件事有兩份程式、新舊版本並存、模組互相伸手。我看過別人放手 2 個月的下場，也在自己系統裡盤出同款走樣。

**Q: 為什麼系統爛掉的時候自己沒感覺？**

因為腐化不發警報。品質是一天降一點的，每天跟昨天比都正常，等感覺得到通常已經過了幾個月。我自己 9 組副本全部走樣、必讀文件過期 3 個月，發現之前毫無感覺，全部是主動盤點才看見的，沒有一個被日常使用抓到。

**Q: 怎麼檢查自己的專案有沒有在爛？**

把 4 個特徵丟給 AI 掃：檔名帶 v2、old、backup 的並存檔，沒有任何地方引用的孤兒程式，說明文件描述的機制或路徑已經不存在，還有同一份東西的多份副本內容不一致。記得加一句「只列證據，不要修任何東西」，先看清單再決定動哪裡。我這次盤下來 AI 花不到 10 分鐘。

**Q: 每次都有讓 AI 檢查品質，為什麼還會爛？**

因為單次審查跟跨時間走樣是兩回事。那位分享者每次請 AI 優化，AI 都照做、每關都過，兩個月後架構照樣毀掉。審查線擋的是這一次的產出好不好，擋不住十次合理改動加總出來的混亂，所以除了審查，還要另外排例行盤點。

**Q: 防止 AI 改壞架構，最有效的一件事是什麼？**

把「靠人記得」換成「機器自動」。我盤點的結果很殘酷：有自動檢查守的地方全都沒爛，靠紀律同步的 9 組副本全數走樣，靠人記得的紀律兩個星期就斷了。做法上就是同一份東西只放一個地方、有標準答案的檢查寫成自動跑、動架構要人點頭、盤點排上日曆。

---

## 用 AI 做網站或產品，你有考慮到資安風險嗎？

> Source: https://www.coolkidlab.com/newbie-pitfalls/ai-code-security-review-mistakes.html
> 兩個網站，超過 30 個漏洞。非工程師用 AI 寫程式碼，最危險的是寫出來了但不知道有洞。分享 6 個親身犯過的資安錯誤，和兩個免費掃描工具怎麼補救。

短答：AI 寫出來的程式碼不一定安全。我做了兩個網站（Coolkid AI Lab 跟另一個會員制工具站），前後被掃出超過 30 個資安漏洞。這篇挑 6 個最有代表性的講，從「以為有防護其實沒有」到「付費內容任何人都能讀」到「一個看不見的字元就讓密鑰失效」。最後介紹 Claude Code 官方的資安掃描指令跟 OpenAI Codex 各自怎麼掃，能抓什麼、不能抓什麼。

先講結論：問題不是 AI 寫的程式碼特別爛。

問題是你覺得「能跑就沒事了」。

我也是。程式會動、頁面有出來、後台登得進去，就覺得完成了。

直到有一天跑了 Security Review，才發現一堆門根本沒鎖。

### 第一類：你以為有防護（其實沒有）

這類最可怕，因為你真的以為自己是安全的。

<strong>故事一：裝了 30 個安全掃描，全部沒有啟動。</strong>

我裝過一組工具，其中有 30 幾個自動掃描的 hook（就是「每次你做某件事的時候，自動幫你檢查一下」的機制）。裝完之後心裡很踏實：密鑰掃描有了、程式碼審查有了、每次送出前都會自動檢查。

幾個月後我才發現：設定檔放錯位置了。

那 30 幾個 hook <mark><strong>從頭到尾一次都沒有跑過</strong></mark>。

怎麼確認的？其中一個 hook 照理說每次跑都會寫一行紀錄到 log 檔。那個檔案不存在。不是空的，是根本沒有被建立過。

教訓：<strong>「設定存在」不等於「功能運作」</strong>。驗證的方式是去看有沒有留下副作用（log、通知、實際擋住某個操作），不是看設定檔有沒有在那裡。

<strong>故事二：限流機制，每次重新啟動就歸零。</strong>

我的網站後台有 API，設了限流：同一個 IP 一分鐘只能打 30 次。聽起來很合理。

問題是：計數器存在程式的記憶體裡。我的網站跑在 Vercel（一種雲端服務），每次有新的請求進來，Vercel 可能開一個全新的程式副本來處理。

新的副本，計數器當然從零開始。

所以攻擊者只要每次碰到不同的副本，限流就形同虛設。文件上寫著「30 次/分鐘暴力破解防護」，<mark><strong>實際在正式環境完全沒有生效</strong></mark>。

同一個模式：看起來有防護，但從來沒有在真實環境驗證過。Security Review 工具不一定能抓到這種，但工具會問你「這個計數器存在哪裡？重啟之後還在嗎？」——光是這個問題就值了。

### 第二類：你以為別人看不到（其實全都看得到）

<strong>故事三：付費內容，任何人都能讀。</strong>

我的另一個網站有付費會員區，付了錢才能看完整文章。前端做得很到位：沒登入就顯示「請先加入會員」，登入了但不是付費會員就顯示「升級方案」。

問題是：這個「擋」只發生在前端（就是你的瀏覽器上）。

後端的資料庫呢？沒設任何限制。有人只要直接對資料庫發一個查詢，所有付費文章的完整內容就全部回來了。

用生活比喻：我在門口放了一個寫著「會員專用」的立牌，但門沒有鎖。你不用從門口走，繞到後面窗戶就進去了。

後來修的做法是：在資料庫層加上權限規則，不管你從哪裡查詢，沒有對應的會員身份就是讀不到那個欄位。

<strong>故事四：網頁標題沒有跳脫，可以被注入程式碼。</strong>

這個我完全不知道自己犯了。

我的網站用一套自己寫的產生器，每篇文章的標題會被自動填進網頁的 <code><head></code> 區塊（就是瀏覽器分頁上顯示的那個文字）。

問題是：標題的內容是直接塞進去的，沒有經過「跳脫」處理。跳脫的意思是把特殊符號（像 <code><</code> <code>></code> <code>"</code>）轉成無害的格式，讓瀏覽器當成純文字顯示，而不是當成程式碼執行。

如果有人能把一段惡意程式碼放進標題欄位，<mark><strong>瀏覽器會把那段程式碼跑起來</strong></mark>。

這就是 XSS（Cross-Site Scripting，跨站腳本攻擊）。名字聽起來很專業，白話就是：你的網頁不小心讓別人的程式碼混進來跑了。

「看不到」跟「拿不到」是兩件事。前端隱藏 ≠ 後端保護。資料的權限要在資料庫那一層設，不能只靠前端畫面擋。跳脫處理要在輸出那一層做，不能假設輸入一定乾淨。

### 第三類：你根本不知道有問題

<strong>故事五：Python 程式碼默默吞掉錯誤，差點刪掉別人的登入。</strong>

這個最難解釋，但也是 AI 寫程式碼最常見的問題之一。

我的後台有個「登出所有裝置」的功能。功能會去資料庫撈出你所有的登入紀錄，然後逐筆刪除。撈的過程會分好幾批回來。

AI 寫的程式碼裡有一行：<code>keys = res[1] or []</code>。白話翻譯是「把撈回來的結果存起來，如果是空的就當成空清單」。

問題出在 Python 的 <code>or</code>：這個寫法不只把「空的」當成空的。<code>{}</code>（空字典）、<code>""</code>（空字串）、<code>0</code>、<code>False</code>，這些全部都會被當成「空的」，然後被默默換成一個正常的空清單。

所以如果資料庫回傳了一個畸形的回應（格式壞掉了），程式不會報錯，而是<mark><strong>假裝沒事繼續跑</strong></mark>。

最糟會怎樣？第一批正常回來了一筆登入紀錄，第二批回來一個格式壞掉的東西，程式當成「掃完了，只有一筆」，直接把那一筆刪掉。實際上可能有三筆，但另外兩筆因為畸形回應被跳過。

<strong>故事六：密鑰多了一個看不見的換行，debug 兩小時。</strong>

我在設定寄信服務（Resend）的 API 密鑰時，複製貼上到 Vercel 的環境變數裡。結果一直報「密鑰無效」。

密鑰是對的。字元完全正確。

花了快兩小時才發現：複製的時候尾巴多帶了一個換行字元。這個字元在畫面上完全看不到，但送出去的時候就變成了一個錯誤的密鑰。

修法很簡單：程式碼讀到密鑰之後加一行 <code>.strip()</code>（去掉頭尾的空白跟換行）。但在那之前，API 回給你的錯誤訊息跟「密鑰真的打錯」是一模一樣的。

AI 寫的程式碼有個通病：在理想情況下表現完美，但遇到意外輸入就默默出錯而不是大聲報錯。工程師把這個叫做「fail open」（壞了就放行），正確的設計是「fail closed」（壞了就擋住）。你不用記術語，但記住這個直覺：程式碼遇到看不懂的東西時，應該停下來喊救命，不是假裝沒事。

### 兩個免費工具怎麼幫你掃？

上面 6 個問題，我不是自己讀程式碼找出來的。很多是跑了 Security Review 工具之後才知道的。

目前我用過兩個：Claude Code 的 /security-review 跟 OpenAI 的 Codex。兩個都是 AI coding agent，跟一般的聊天機器人不同：能自己讀你整個專案、自己找檔案，不用你手動挑程式碼貼過去。不用額外付費（前提是你已經有 Claude Code 或 ChatGPT Pro 的訂閱）。

<strong>Claude Code 的做法</strong>

Anthropic 官方開源了一個專門的資安掃描指令叫 /security-review。跟自己隨便問一句「有沒有漏洞」不一樣：裡面有一張完整的漏洞清單逐項掃（SQL 注入、XSS、權限繞過、密鑰外洩……），每條結果附信心分數，太可能是誤報的直接過濾掉。這個指令甚至可以設成 GitHub Action，每次推程式碼都自動掃。

我的經驗：上面故事二的 XSS 跟故事一的限流問題，都是第一輪掃描就抓出來的。這工具特別擅長抓「你該跳脫但沒跳脫」跟「你該驗證但沒驗證」這兩類。

最快的方式是打開 Claude Code，直接貼這句：

Claude Code 會自己讀你專案裡的檔案，跑完列一張清單，照嚴重程度排好。每條告訴你問題在哪個檔案哪一行、具體的攻擊情境、跟修法建議。

想要完整版的結構化掃描，可以裝官方的 /security-review 指令。GitHub 搜 <code>anthropics/claude-code-security-review</code>，照說明裝好之後打 <code>/security-review</code> 就行了。（第一次用 GitHub？可以先看<a href="/newbie-pitfalls/github-tools-for-beginners.html">這篇教學</a>。）

<strong>Codex 的做法</strong>

OpenAI 的 Codex 也是一個 AI coding agent，跟 Claude Code 一樣能讀你整個專案的程式碼。差別在於 Codex 沒有專門的資安掃描指令，你直接用白話告訴它「幫我掃資安」就好。

使用方式跟 Claude Code 不太一樣：你把 GitHub repo 連上去，開一個新任務，Codex 會在雲端的隔離環境裡跑。不是即時對話，比較像交作業，過一陣子回來看結果。

開一個新 task，貼這段當任務描述：

因為 Codex 也能讀你的檔案結構，不用像聊天機器人那樣自己挑程式碼一段一段貼。但沒有 Claude Code 那套結構化的掃描流程跟誤報過濾，掃出來的品質不一定每次都穩定。

<strong>這兩個工具抓不到什麼？</strong>

說實話，不少。故事一的「30 個 hook 裝錯位置」，工具抓不到，因為程式碼本身沒問題，是設定檔的路徑不對。故事六的「密鑰多了換行」，工具也不一定抓得到，因為密鑰的值在程式碼裡看不到。

簡單說：<mark><strong>工具擅長抓程式碼層面的漏洞（少了跳脫、少了驗證、少了權限檢查），不擅長抓環境設定跟部署流程的問題</strong></mark>。

但光是前者就夠用了。我的 30 幾個漏洞裡面，超過一半是程式碼層面的，工具一掃就出來。

### 寫完程式碼之後，多做一件事

這篇不是要你學會資安。

是要你知道：用 AI 寫程式碼的時候，「能跑」跟「安全」是兩件事。AI 不會主動告訴你「這段我寫的有資安風險」，就像不會主動告訴你「這段我瞎掰的」一樣。

你不需要看得懂每一行程式碼，但你可以做一件事：<strong>寫完之後，請另一個 AI 用資安的角度掃一遍</strong>。

30 秒的事，可能幫你擋掉一個你根本不知道存在的漏洞。

### Summary

AI 寫出來的程式碼不一定安全。我做了兩個網站，前後被掃出超過 30 個資安漏洞。本篇挑 6 個最有代表性的講：裝了 30 個安全 hook 全部沒生效（設定檔放錯位置）、限流計數器存在記憶體裡每次重啟歸零（雲端環境等於沒設）、付費內容只在前端擋後端沒擋（直接查資料庫就全部看到）、網頁標題沒跳脫可以被注入程式碼（XSS）、Python or [] 把畸形回應默默吞掉差點刪錯登入、API 密鑰複製貼上多了看不見的換行字元。Claude Code 的官方 /security-review 指令跟 OpenAI Codex 都能做資安掃描。前者有結構化的三階段流程跟誤報過濾，後者是通用 agent 用白話請求掃描。兩者都擅長抓程式碼層面的漏洞（少了跳脫、少了驗證、少了權限檢查），不擅長抓環境設定跟部署流程的問題。

### 名詞解釋

- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **內容安全政策（CSP, Content Security Policy）**：網站的白名單防火牆：只允許指定來源的程式跟資源執行，用來擋惡意注入。設太嚴會誤殺自己要用的工具。
- **Vercel**：把網站免費發佈到網路上的服務：接上 GitHub 後，每次推程式碼就自動更新網站，個人專案免費方案就夠用。

### FAQ

---

## GitHub 上的免費工具，普通人要怎麼用？

> Source: https://www.coolkidlab.com/newbie-pitfalls/github-tools-for-beginners.html
> GitHub 上有幾千萬個免費工具，但打開來滿滿英文跟檔案。這篇從「怎麼看懂頁面」到「下載」到「跑起來」走一遍，最後用旅行清單工具示範全流程。不用學寫程式。

短答：GitHub 是全世界最大的免費工具庫，上面有幾千萬個公開的程式專案。問題是大部分沒有「安裝」按鈕，打開來是一堆英文、一堆檔案，跟 App Store 完全不一樣。這篇教你三件事：怎麼看懂一個 GitHub 頁面、怎麼把工具下載到你的電腦、怎麼把工具跑起來。最後用一個真實的旅行清單工具走一遍全流程，不用寫半行程式碼。

你搜到一篇文章，說「這個工具超好用，GitHub 連結在這」。

你點進去。

滿滿英文。一堆資料夾。沒有「下載」按鈕。沒有安裝精靈。

你關掉了。

這篇就是寫給這個時刻的。

### GitHub 頁面打開來，先看哪裡？

GitHub 是一個放程式碼的網站。工程師把自己寫的工具放上去，公開給大家免費用。每個工具有一個頁面，叫 repo（專案倉庫）。

頁面上最重要的東西叫 README。

就是工具的說明書。通常在頁面下半段，長長一大段文字。會告訴你這工具做什麼、需要什麼前置條件、怎麼安裝、怎麼跑。README 是你在這個頁面唯一需要認真讀的東西。

讀 README 之前，先花 10 秒看三個東西：

<strong>⭐ Stars</strong>：多少人按讚。不是越多越好，但個位數的工具通常代表還沒什麼人用過，踩雷機率比較高。幾百顆以上的代表有不少人實際用過。

<strong>最後更新時間</strong>：頁面上方會寫「最後一次更新是什麼時候」。如果上次更新是兩年前，這工具可能已經沒人在管了。不是絕對，有些小工具做完就不用改，但值得留意。

<strong>語言標籤</strong>：頁面右邊會顯示這個工具用什麼程式語言寫的。最常看到的是 Python、JavaScript、TypeScript。這三個字等一下會決定你安裝時要打什麼指令，現在先知道就好。

看完這三個，拉下來讀 README。問自己一件事：

<strong>「這份說明書是寫給工程師的，還是寫給一般人的？」</strong>

如果 README 有一段「Quick Start」或「怎麼用」，一步一步告訴你要打什麼指令，那通常照著做就行。如果 README 第一行就是 <code>import xxx from 'yyy'</code>，那大概假設你會寫程式，難度會高不少。

不用怕英文。大部分 README 的結構差不多：第一段講做什麼的，往下找 Installation（安裝）或 Usage（用法）。這兩個單字記一下就夠用了。

### 怎麼把工具弄到你的電腦？

GitHub 上的工具不像 App Store 有安裝按鈕。你要自己把檔案搬到你的電腦上。

兩種方式。先講簡單的。

<strong>方法一：下載 ZIP（最直覺）</strong>

頁面上方有一個綠色的「Code」按鈕。點下去，會跳出一個小選單，選最底下的「Download ZIP」。就跟從網站下載一個壓縮檔一樣。下載完解壓縮，就是整個工具的所有檔案。

<strong>方法二：用 git clone（標準做法）</strong>

打開終端機（Windows 搜尋「cmd」或「PowerShell」就有），打這行：

把「使用者名稱/工具名稱」換成你在 GitHub 頁面上看到的。綠色 Code 按鈕裡也有這串網址可以直接複製。

這行指令做的事跟 Download ZIP 一樣：把所有檔案複製到你的電腦。差別是 git clone 會保留版本紀錄，以後工具更新了你可以用一行指令拉最新版。Download ZIP 做不到，要重新下載。

第一次用？先下載 ZIP 就好。等你習慣了再學 git clone 也不遲。

### 下載完，然後呢？

打開 README，找 Installation（安裝）那段。

幾乎所有工具的安裝流程都長一樣，三步：

<strong>第一步：打開終端機，切到你剛剛解壓縮的那個資料夾。</strong>

終端機就是一個打字的黑視窗。Windows 搜尋「PowerShell」就有。打 <code>cd 資料夾路徑</code> 就能切過去。不知道路徑也沒關係，可以在檔案總管裡對那個資料夾按右鍵，選「在終端機中開啟」。

<strong>第二步：安裝依賴套件。</strong>

什麼是依賴套件？就是這個工具用到的其他人寫的零件。一個工具通常不會每個功能都自己寫，會借用別人做好的現成零件。你第一次跑之前要先把這些零件裝起來。

怎麼裝，看工具用什麼語言寫的。README 裡面會寫要打什麼，最常見的兩種：

這兩行不用背。README 會告訴你要打哪一行，你照著打就好。

<strong>第三步：跑起來。</strong>

README 也會告訴你怎麼啟動。常見的長這樣：

打完按 Enter，工具就跑起來了。

三步就是全部：切到資料夾 → 裝零件 → 跑起來。九成的 GitHub 工具都是這個流程。README 會告訴你每一步要打什麼，你照著打就好。

你會碰到的最常見問題：

打 <code>python</code> 之後出現「不是內部命令」？表示你的電腦還沒裝 Python。去 python.org 下載裝一次就好，以後所有 Python 工具都能用。

打 <code>npm</code> 出現一樣的訊息？去 nodejs.org 下載 Node.js，裝完 npm 就有了。

裝到一半噴紅字？把那段紅字整段複製，丟給任何聊天 AI 問「這是什麼錯誤，怎麼解」。大部分問題 AI 都能直接告訴你答案。

### 看不懂指令？讓 AI 幫你跑

如果你用 Claude Code（一個可以直接操作你電腦檔案的 AI），上面所有步驟可以一句話搞定。

打開 Claude Code，切到你下載好的工具資料夾，貼一句：

Claude Code 會自己做這些事：

讀 README 看這個工具需要什麼。檢查你的電腦有沒有裝需要的東西（Python、Node.js 之類的）。幫你安裝依賴套件。然後跑起來。

你不需要看懂每個指令在做什麼。Claude Code 每一步都會跟你講它正在做什麼，遇到問題會自己想辦法，真的解不了才會問你。

不用 Claude Code 也行。把 README 整段複製，貼進任何聊天 AI（ChatGPT、Gemini 都可以），問「這份說明書叫我做什麼？一步步翻成中文告訴我」。

差別在：聊天 AI 只能翻譯給你看，你還是要自己打指令。Claude Code 可以直接幫你打。一個是翻譯官，一個是直接幫你做事的助手。

還沒裝過 Claude Code？可以看這篇：<a href="/newbie-pitfalls/claude-code-windows-setup.html">Claude Code Windows 安裝教學</a>。

### 走一遍真的：旅行清單工具

講了這麼多，走一個真的。

我自己做了一個旅行行前清單工具叫 trip-guide，放在 GitHub 上，免費公開。做的事很單純：你告訴 AI 你要去哪裡、什麼時候出發、幾天幾個人，AI 幫你排出一份清單，每個項目有截止日，排好了可以直接貼進待辦 App。

這個工具不需要安裝任何東西。

工具的本體是一份文件，放在 GitHub 上。你把那份文件的網址貼進聊天 AI（ChatGPT、Gemini、Claude 都行），跟 AI 說「照這份文件帶我規劃出國」，AI 就會開始問你出發細節，然後生一份按時間排好的待辦清單。

這是最輕量的一種 GitHub 工具：工具本體是文件，AI 讀完就能用，完全不用下載也不用裝東西。

不是每個工具都這麼輕。大部分需要下載和安裝，就是上面第二、第三段的流程。但不管哪一種，起點都一樣：<strong>打開 README，看它叫你做什麼</strong>。

想看更多免費工具？我的網站有一整頁：<a href="/workflows/">免費工具庫</a>。AI 自動發文機器人、簡報工具、桌面寵物製作器、對手內容分析工具，全部免費開源，每個都有完整的使用說明跟踩雷紀錄。

用 AI 幫你跑工具、做網站之後，記得多做一件事：<a href="/newbie-pitfalls/ai-code-security-review-mistakes.html">讓 AI 幫你掃一遍資安</a>。AI 寫出來的程式碼不一定安全，30 秒掃一次可能幫你擋掉你不知道存在的漏洞。

### Summary

GitHub 是全世界最大的免費工具庫，上面幾千萬個公開的程式專案（repo）。打開一個工具的頁面，先花 10 秒看三件事：Stars（多少人用過）、最後更新時間、語言標籤。然後拉下來讀 README 說明書。下載方式兩種：點 Code 按鈕選 Download ZIP（簡單），或用 git clone 指令（標準）。下載完三步就能跑：打開終端機切到資料夾、安裝依賴套件（pip install 或 npm install）、跑啟動指令。看不懂 README 的話，貼給聊天 AI 翻成中文，或用 Claude Code 直接幫你操作。有些工具連安裝都不用，像旅行清單工具 trip-guide，把文件網址貼進聊天 AI 就能用。起點永遠是同一個：打開 README，看它叫你做什麼。

### 名詞解釋

- **repo（專案倉庫）**：GitHub 上的一個專案資料夾，裡面放程式碼、說明文件跟修改紀錄。一個 repo 就是一個獨立的專案。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **Python**：入門門檻最低的主流程式語言之一，資料處理、自動化、AI 領域的首選。
- **Node.js**：讓電腦能執行 JavaScript 程式的基礎環境。Claude Code 的 npm 舊裝法才需要先裝它；2026 年官方推薦的 native 一行安裝不用。免費，從官網 nodejs.org 下載安裝。
- **npm**：裝 Node.js 時附帶的套件管理工具，像程式界的 App Store — 一行指令就能安裝各種工具。Claude Code 的舊裝法用它裝；現在官方推薦改用 native 一行安裝。
- **PowerShell**：Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。

### FAQ

---

## 免費工具 — 完整內容(含可整段複製給 AI agent 的即用 prompt)

## Threads 每天 20:00 自動發文機器人：排程 + 選題 + Graph API

> Source: https://www.coolkidlab.com/workflows/threads-auto-poster.html
> 用 Claude Code 排程每天 20:00 觸發、抓 GitHub trending 用你的口吻寫繁中介紹、Threads Graph API 自動發。Windows CP950 編碼坑 + token 60 天靜默失效修法全公開。

### 固定分享 GitHub 好物，但每天的流程一模一樣

### 解法：Claude Code 排程 + 人只出一個「方向」

### AI 在哪幾段做事

### 發文這段會卡住的兩個地方：Graph API 兩段式發文與 Windows 編碼

### 三條紅線：不塞 slogan、不放聯盟連結、不超過 500 字

### 整段複製給 AI agent — 即用 prompt

把下面整段複製貼給你的 AI agent（Claude Code 或其他 coding agent），它就能照著幫你把這個「每天定時自動發 Threads、但你只出方向」的機器人建起來，你不用自己從零摸。

```
我要你幫我做一個「半自動的 Threads 發文機器人」，核心是人在迴路：每天定時自動觸發，但發什麼方向由我決定，其餘抓素材、寫文、發文交給你包。我用 Claude Code，作業系統是 Windows，請依這個規格做：
1. 用 Claude Code 的 scheduled-tasks 設一個每天 20:00（時區 Asia/Taipei）觸發的排程。
2. 觸發後第一步不是發文，是用 AskUserQuestion 跳一題問我今天想看哪個方向（例如 AI 代理、CLI 工具、全端後台，或隨意挑 trending 第一名，也要能讓我直接回「今天跳過」）。
3. 我選方向後：「隨意挑」就用 WebFetch 抓 GitHub trending；指定方向就走 GitHub search 按 star 排序抓前 15 個。然後比對我過去 30 天的發文紀錄做去重，不要重複介紹同一個專案，並避開 awesome-list 類清單與明顯刷 star 的專案，挑一個高 star 且最近仍有在維護的。
4. 用我的語氣寫一段繁體中文介紹：第一人稱、整篇最多一個 emoji、句尾不加句號直接換行、控制在 480 字以內。請把這份語氣規則寫死在流程指引檔裡，不要每次重講。
5. 發文用 Threads Graph API，請注意這是兩段式：先建一個 media_type 為 TEXT 的 container，中間 sleep 約兩秒再 publish，不要一步發，否則 container 還沒就緒會發失敗。
6. 請避開我已知的三個雷：第一，Windows 上 Git Bash 的 curl 是原生 build，中文直接塞進命令列會被 CP950 編碼轉成亂碼，所以貼文要先用 Write 寫成 UTF-8 檔，再用 curl 的 --data-urlencode 搭配 @檔案 去讀，並用 cygpath -m 把路徑轉成 curl 讀得懂的格式；第二，長效 token 大約 60 天會靜默失效，請順便排一個每週自動 refresh token 的機制，避免某天機器人沒報錯卻也沒發；第三，這種「沒報錯但也沒發」最難抓，請在每步加 log 方便我事後對照。
7. 內容守三條紅線：結尾不要加「追蹤我」這類 CTA 或 slogan、文中不放任何聯盟連結或 UTM、整篇不超過 500 字。
請先確認我目前的環境（Claude Code 版本、是否已有 Threads Graph API 權限與 token、發文用哪個帳號）再一步步建，每完成一步就先跟我確認再往下做。
```

把上面整段複製貼給 agent 就好，它會問你細節（像 token、帳號、環境）再實作，你只要回答，卡住時補一下你的環境資訊就行。

### 名詞解釋

- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **Threads**：Meta 旗下的文字社群平台。本站的社群引流主戰場之一，相關自動發文流程有整篇教學。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **API 金鑰（API key）**：服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- **編碼（encoding）**：電腦儲存文字的方式。Windows 中文環境常用 Big5，多數程式假設 UTF-8，兩邊對不上就變亂碼 — 所以資料夾、檔案建議用英文命名。
- **Python**：入門門檻最低的主流程式語言之一，資料處理、自動化、AI 領域的首選。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **repo（專案倉庫）**：GitHub 上的一個專案資料夾，裡面放程式碼、說明文件跟修改紀錄。一個 repo 就是一個獨立的專案。
- **GitHub trending（熱門榜）**：GitHub 每天自動整理的「最近最多人收藏」專案排行榜，可以按語言或時間範圍篩。想找新工具的人常從這裡逛。
- **star（星星數）**：GitHub 上的收藏功能，等於「按讚＋加書籤」。star 數常被當成專案受歡迎程度的指標，但可以刷，看的時候要順便看最近有沒有在維護。
- **scheduled-tasks（排程功能）**：Claude Code 的內建功能：設定好時間之後，它會自己在那個時間點跑你交代的流程，不用你開著電腦盯。
- **AskUserQuestion（跳問功能）**：Claude Code 執行到一半可以跳出選項問你的功能。用在「流程自動跑，但關鍵決定留給人」的地方。
- **WebFetch（讀網頁功能）**：讓 AI 直接去讀一個網址的內容再回來處理的功能，不用你先複製貼上。
- **curl（命令列抓網頁工具）**：用打指令的方式跟網站要資料或送資料的小工具，幾乎每台電腦都有。程式要呼叫別人的服務時常用它。
- **Graph API**：Meta 系列服務（Threads、Instagram、Facebook）開放給程式使用的官方介面。要先申請權限拿到金鑰，程式才能代替你發文或讀資料。
- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **行動呼籲（CTA, Call to Action）**：頁面上引導你做下一步的元素，像「訂閱」「立即開始」那顆按鈕。

### FAQ

**Q: 這個機器人真的能取代我每天手動發 Threads 嗎？**

可以，但前提是「你只出方向、AI 包執行」這個架構。完全交給 AI 亂發會崩帳號可信度。這套是每天跳問題讓你 5 秒選方向，剩下 20 分鐘抓 / 寫 / 發全自動，兩個多月穩定。

**Q: 普通人可以做嗎？要會什麼？**

可以，但要會「跟 Claude Code 講需求」加上有耐心 debug 一兩天。文章內 prompt 整段可以複製給 AI agent 直接幫你建，不用自己從零摸 Python 跟 Threads API。

**Q: 發 Threads 會被 IG / Meta 鎖帳號嗎？**

Threads Graph API 是官方 API，正常使用不會。但有 rate limit (每天約 250 篇 publish)，日發 1 篇遠低於上限。注意「不放聯盟連結 / 不堆 hashtag / 不重複發同一個 repo」這三條紅線守住就 OK。

**Q: 如果想換平台 (X / Bluesky / Threads) 程式碼要重寫嗎？**

選 repo 加上寫文那段都通用，只有發文 API 那段要換。換 X 改 Twitter API、Bluesky 改 AT Protocol，大概 30 分鐘工程。文章內把流程模組化好，API call 是最後一段獨立 function。

---

## AI / 股市新聞 IG 自動發文機器人：兩階 LLM 分工 + Pillow 生圖

> Source: https://www.coolkidlab.com/workflows/ig-news-bot.html
> 監測 AI / 台股 / 美股 RSS,Claude Haiku 評重要性、Opus 用你的口吻寫稿、Pillow 生圖、自動發 IG。兩階 LLM 省 token 設計 + IG 發圖要公開圖床 URL 的坑，全公開。

### IG 一定要配圖，而「定時硬發」會發出一堆垃圾

### 解法：六段 pipeline + 兩階 LLM 分工

### 怎麼決定發哪幾則(配額 + 防洗版)

### IG 發圖的真實坑：它只收「公開 URL」不收本機檔

### dry-run + 誠實揭露

### 整段複製給 AI agent — 即用 prompt

把下面整段複製貼給你的 AI agent(Claude Code 或同類)，它就能照著幫你把這個「AI / 股市新聞自動發 IG 的事件驅動機器人」一步步建起來，你不用自己從零摸。

```
我要你幫我做一個「AI / 股市新聞自動發 IG」的機器人，設計成事件驅動(每 30 分鐘掃一次，只有夠重要的新聞才發，沒大事就安靜)，而不是定時硬發。請用 Python，做成六段 pipeline:collectors(抓 RSS，來源分 AI、台股、美股三類)、importance_scorer(評每則新聞的重要性分數)、dedup(去掉發過的)、writer(寫貼文文案)、image_gen(用 Pillow 生 1080x1080 的圖，放標題、分數、logo)、publisher(發到 IG)。

評分跟寫稿請用兩階 LLM 分工省 token：第一階用便宜的 Claude Haiku 一次掃最多 30 則、幫每則評重要性分數；只有超過閾值的，才交給較貴的 Claude Opus 用我的口吻寫成貼文。便宜模型做篩選、貴模型做精工，不要每則都用最貴的模型硬幹。

選發哪幾則請用程式寫死規則，不要每次臨場判斷：AI 類達閾值的同一次最多發 2 則防洗版，台股、美股各取分數最高的幾則，同類當天已發過就跳過。

請特別避開這幾個我知道的雷：第一，IG Graph API 不吃本機圖檔，它只收一個可公開存取的圖片網址，所以流程一定是 Pillow 本機生圖、先上傳到 imgbb 之類的圖床拿到公開網址、再把那個網址丟給 IG 發，千萬別直接傳本機路徑；第二，Meta 的 token 會過期而且過期後會靜默不發，請幫我排好 token refresh 並在失敗時記錄，不要無聲無息；第三，去重要可靠(例如把發過的 key 記在 jsonl)，避免重複發同一則。

請務必做一個 dry-run 模式：照跑抓新聞、評分、寫稿、生圖，但不真的發，圖存到 logs/preview、文案存成草稿檔讓我先看過再開真發。另外每篇貼文結尾自動帶一句說明這是由 AI 自動產出、作為我自己的資訊蒐集與觀點記錄的揭露語，不要假裝是純人工。發文部分只做工具本身，不要在文案裡寫任何買賣結論或操作建議。

排程我預計用 Windows 工作排程每 30 分鐘跑一次。請先確認我目前的環境(作業系統、Python 版本、有沒有 IG 商業帳號跟 Graph API 權限、有沒有 Claude API key、要不要 imgbb key)，再一步步建，每完成一步先停下來跟我確認再繼續。
```

把上面整段複製貼給 agent 就好，它會問你環境跟金鑰細節再動手實作，你只要回答、卡住時補上你的設定資訊就行。

### 名詞解釋

- **大型語言模型（LLM, Large Language Model）**：ChatGPT、Claude 這類 AI 背後的技術：讀過海量文字後，學會理解與生成人類語言的模型。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **API 金鑰（API key）**：服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **Opus / Sonnet / Haiku（Claude 的三種等級）**：同一家 AI 的三種型號：Opus 最聰明也最貴、Haiku 最快最便宜、Sonnet 在中間。量大又簡單的工作丟 Haiku，需要品質的才用 Opus，成本差很多。
- **Pillow**：Python 的圖片處理套件：程式用它畫圖、加字、裁切、存檔。自動生圖卡常用它。
- **圖床**：專門放圖片並提供公開網址的服務。有些平台的發文介面只收「網路上的圖片網址」不收本機檔案，就得先把圖丟上圖床。
- **RSS（網站更新訂閱）**：網站提供的一份機器讀的更新清單，程式訂閱之後就能自動知道有新文章，不用一直去開網頁看。
- **DRY_RUN（模擬模式）**：程式照真實邏輯執行、但不送出真實交易單的測試模式。本站所有交易相關數字一律標 DRY_RUN，不是實盤績效。
- **token（字元計費單位）**：AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。

### FAQ

**Q: 兩階 LLM 拆分為什麼省錢？**

Claude Haiku 一次 input 約 $0.0008、Opus 約 $0.015 (差 20 倍)。一天 100 則新聞先丟 Haiku 評分過濾掉 90 則，只剩 10 則丟 Opus 寫稿，總成本是「100×Haiku + 10×Opus」遠低於「100×Opus」。月省約 $50-80。

**Q: 一定要用 Pillow 生圖嗎？用 Canva 不行？**

Pillow 是程式自動 render，跑 cron 沒人介入。Canva 要人手動拖，沒法接 workflow。如果你只發少量、可以接受手動，Canva 也行；但這個 workflow 重點是「自動」就用 Pillow。

**Q: dry-run 機制是什麼？**

把整套流程跑完但最後一步「發 IG」改成「寫進 log 加上預覽圖」。每天 1 次 dry-run 看 AI 寫了什麼、生了什麼圖，確認沒翻車再讓它跑正式版。新手前 2 週建議全 dry-run。

**Q: 發 IG 要 IG 商業帳號嗎？**

要。IG Graph API 只能用商業帳號或創作者帳號 (個人帳號不支援)。免費轉換，但需要綁 Facebook page。如果你 IG 是個人帳號要先去設定切換成商業帳號，5 分鐘搞定。

---

## 家族行程提醒 LINE 機器人：一句話建行程 + cron 自動提醒

> Source: https://www.coolkidlab.com/workflows/family-line-bot.html
> 給家人用的 LINE 機器人：邀請碼加入、一句話建行程、到點自動提醒。FastAPI + Supabase + Render 三件套全免費。為什麼刻意不接 LLM、cron 提醒怎麼不重複發，架構公開。

### 家人的行程各記各的，到點才發現忘了

### 關鍵決策：這種機器人刻意不接 LLM

### 建行程兩種方式：一句話 或 引導式問答

### 提醒的雷：cron 每分鐘跑 怎麼不重複發

### 本機 SQLite、線上 Postgres，同一套 code

### 整段複製給 AI agent — 即用 prompt

把下面整段複製貼給你的 AI agent，它就能照著幫你把這個「家族共享行程提醒 LINE 機器人」從零建起來 — 邀請碼加入家族、一句話建行程、到點自動提醒，你不用自己摸。

```
我要你幫我做一個「家族共享行程提醒 LINE 機器人」，活在家人本來就在用的 LINE 裡，不另外開 app。技術棧請用 Python FastAPI 接 LINE Messaging API 收訊息與 push，資料庫用 Supabase Postgres，但開發階段我要能在本機跑 SQLite、上線跑 Postgres 用同一套程式碼，所以資料層請用 SQLAlchemy 加自訂 TypeDecorator 把 UUID 與 JSONB 在兩邊抹平，migration 用 Alembic 管。

功能我要這些：第一，邀請碼加入家族 — 第一個人建家族當 admin，其他家人輸入邀請碼加入當 member。第二，建行程要兩種方式並存：懶人版用一句話(像是「明天下午三點 媽媽 醫院回診 提前一小時提醒」)，請用規則解析出時間、對象、事由、提前量，不要接任何 LLM；新手版用引導式問答，做一個對話狀態機一步步問標題、開始時間、結束、參加的人、提前多久，過程中的草稿存進 conversation_states 表的 JSONB 欄位，中途打「取消」可隨時跳出。第三，提醒用一個 cron job 每分鐘呼叫一次派送端點，撈出提醒時間已過且尚未通知的行程，push 給所有參加的人。

請務必避開這些我已知的雷：cron 派送端點一定要驗 secret header，防外部亂打；每筆行程要有一個 notified 旗標，push 完立刻標成已通知，不然下一分鐘會重複撈到同一筆狂發；就算 push 給其中一個人失敗也不要重試整筆，只記 log，否則已經收到的家人會被重複轟炸；訊息路由請走 keyword 比對加狀態機加一句話解析加 fallback 的順序，刻意不接 LLM，因為指令集很固定、要回應即時又行為可預測，長輩才不會被搞糊塗。

開工前請先確認我的環境：我有沒有 LINE 官方帳號與 channel token、Supabase 專案、Python 版本、本機要不要先用 SQLite 跑通。然後一步一步建，每完成一步就停下來跟我確認再繼續，不要一次全寫完。
```

把上面整段複製貼給 agent 就好，它會先問你 LINE token、Supabase 這些環境細節再動工，你只要回答、卡住時補充環境資訊就行。

### 名詞解釋

- **機器人（bot）**：自動執行特定任務的程式，例如 LINE 機器人自動回訊息、發文機器人每天定時發貼文。
- **大型語言模型（LLM, Large Language Model）**：ChatGPT、Claude 這類 AI 背後的技術：讀過海量文字後，學會理解與生成人類語言的模型。
- **排程（cron）**：讓程式「每天 8 點」「每小時」自動執行的定時器。自動發文、定期抓資料都靠它。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **Supabase**：免費起步的雲端資料庫服務，提供資料庫＋登入驗證＋API，個人專案很夠用。
- **LINE 機器人**：在 LINE 裡自動回覆、主動推播訊息的機器人。台灣家庭幾乎人人用 LINE，是自動化通知的最佳入口。
- **Render**：雲端程式代管服務，免費方案能跑小型後端程式（例如 LINE 機器人）。免費版 15 分鐘沒流量會休眠，喚醒要 15-50 秒。
- **Webhook**：「事件發生時，A 服務自動通知 B 服務」的機制。例如有人傳訊息給你的 LINE 機器人，LINE 就透過 webhook 把訊息轉給你的程式處理。
- **資料庫（database）**：專門儲存、查詢大量資料的系統。網站的會員、留言、紀錄都放這裡。
- **狀態機**：把一段對話拆成固定步驟，記住「現在問到第幾步」，一步一步問完才收工。引導式問答就是靠它，不需要 AI 也能聽懂使用者。

### FAQ

**Q: 這個機器人用 LLM 嗎？為什麼說「刻意不接」?**

主流程不接 LLM。家人句子格式很固定 (「明天 3 點 媽媽 醫院」),regex 抓「日期 + 時間 + 人 + 事」就夠，跑 100 次成功率 95%+。LLM 只當 fallback (regex 抓不到才丟給 Claude Haiku)。理由：省 API 費加上避開家人隱私上傳第三方。

**Q: Supabase / Render 免費額度夠嗎？**

夠。Supabase free tier 500MB DB 加上 50K monthly active users，家族 5-10 人遠低於上限。Render free tier 750 hr/month 加上自動 sleep 後 cold start 30 秒，有 cron-job.org 每 14 分鐘 ping 一次保持活著。

**Q: 一定要用 LINE 嗎？Telegram / Discord 不行？**

可以換。FastAPI handler 那段抽掉，換 Telegram 機器人 API / Discord webhook 即可，parser 加上資料庫加上 cron 三段通用。台灣家人最常用 LINE 所以這套做 LINE，換平台約 30 分鐘工程。

**Q: 家人不會用 LINE 機器人怎麼辦？**

最有效的推廣是「不解釋，直接示範」 — 在群組打「明天 3 點 媽媽 醫院回診」機器人跳出提醒，家人看 1 次就會用。機器人不要寫指令說明書，要寫個範例觸發後跳第一個成功案例。

---

## ChatGPT referral 倒推來源 4 招 SOP:GA4 實戰工作流

> Source: https://www.coolkidlab.com/workflows/ga4-chatgpt-referral.html
> Lab GEO 第一筆 AI 引用實錄。GA4 chatgpt.com referral 倒推來源完整 SOP:GA4 探索報表 / GSC 反向 / Bing Webmaster / 反向 ChatGPT 搜尋 4 招，免費仔踩雷點全公開。

### GA4 只顯示來源網站，看不到 prompt

### 4 招總覽

### GA4 探索報表怎麼設 + 免費仔閾值繞道

### 反向用 ChatGPT 驗證：一定要開無痕

### 整段複製給 AI agent — 即用 prompt

把下面整段貼給你的 AI agent，它就能照著幫你把這套「用 GA4 倒推 ChatGPT 引用來源」的追蹤設定建起來，你不用自己從零摸這四招。

```
我要你當我的助手，幫我建立一套「用 GA4 倒推 ChatGPT 引用來源」的追蹤 SOP。我是非工程師，全部用免費工具，請用我聽得懂的白話帶我操作。

背景：我的網站已經接了 GA4，最近在報表看到來自 chatgpt.com 的 referral，但 GA4 只告訴我「來源是 chatgpt.com」，看不到對方在 ChatGPT 問了什麼。我想側面推導出是哪些內容被 AI 引用。

請幫我依序建立這四招：
招一，GA4 探索報表：教我去 GA4 的探索建一張空白報表，維度放「工作階段來源/媒介、到達網頁、事件名稱」，指標放「工作階段、平均參與時間」，篩選設成「工作階段來源/媒介」完全比對 chatgpt.com / referral，讓我看到每一筆 AI 來的訪客落在哪一頁、停多久。
招二，Google Search Console 反向：教我用 site: 加我的網域，搭配曾出現 AI Overviews 的查詢，反推哪些主題容易被引用。
招三，Bing Webmaster Tools：帶我註冊，並用 Import from GSC 把資料匯進去，因為 ChatGPT 搜尋的資料源大半來自 Bing。
招四，反向驗證：幫我設計幾組「不帶我品牌名、像路人會問」的 query，讓我自己用 ChatGPT 的搜尋模式跑，看回答的引用來源有沒有我的網域。

請特別避開這幾個我已知的雷：一，別想辦法去抓使用者的 prompt 或完整網址，那是瀏覽器 Referrer-Policy 的限制，拿不到也繞不過，我們只做側面推導。二，單筆 referral 在 GA4「探索報表」會被隱私閾值擋成「無資料」，遇到這情況請改帶我走「報表 → 客戶開發 → 流量開發」搜 chatgpt 來繞過。三，招四一定要提醒我開無痕視窗，而且不要用帶品牌名的字，否則 ChatGPT 的 memory 會記得我、偏向我的站，結果會失真；也要提醒我連續測幾週看趨勢，單次命中或沒中都不準。

開始前請先問我目前的環境：GA4 是否已正常收資料、有沒有接 Search Console、Bing Webmaster Tools 註冊了沒，確認完再一步步建，每做完一招就停下來跟我確認結果再進下一步。
```

把上面整段複製貼給你的 agent 就好，它會先問你的環境再一招一招帶，你只要回答、卡住時補上看到的畫面或數字就行。

### 名詞解釋

- **GA4（Google Analytics 4）**：Google 的流量分析工具：訪客從哪來、看了什麼、停多久。GSC 管「搜尋結果上的表現」，GA4 管「進站後的行為」。
- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **引薦流量（referral）**：從其他網站的連結點進來的流量。ChatGPT 引用你的內容帶來的點擊就屬於這一類。
- **GSC（Google Search Console）**：Google 給網站主的免費後台：看自己網站在搜尋的曝光、點擊、排名跟索引狀態。做 SEO 的人天天開的儀表板。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **GEO（生成式引擎優化）**：讓 ChatGPT、Perplexity 這類 AI 在回答問題時引用你網站內容的優化方法，是 SEO 在 AI 時代的延伸戰場。
- **爬蟲（crawler）**：自動瀏覽網頁、把內容抓回去的程式。Google 靠爬蟲收錄網頁，AI 公司靠爬蟲收集資料。
- **結構化資料（Schema / JSON-LD）**：用機器看得懂的格式跟搜尋引擎說明「這頁是文章、作者是誰、何時更新」，有機會換到更豐富的搜尋結果外觀。
- **Referrer-Policy（來源揭露政策）**：瀏覽器決定「要告訴目標網站多少來源資訊」的規則。現在預設只傳網域名稱，不傳完整網址，所以你查得到訪客從哪個站來，查不到他搜了什麼。
- **Bing Webmaster Tools**：微軟版的 Google Search Console：看你的網站在 Bing 上被搜到幾次、排第幾。ChatGPT 的搜尋結果大半來自 Bing，所以它的資料比想像中重要。
- **Bing**：微軟的搜尋引擎。台灣用的人不多，但 ChatGPT 搜尋時拿回來的資料大半來自這裡，所以想被 AI 引用就不能只顧 Google。
- **到達頁（landing page）**：為單一目的設計的獨立頁面：通常是一個產品介紹＋一顆行動按鈕。
- **ClaudeBot**：Anthropic 派出去讀網頁的程式。Claude 要引用網頁內容時，靠它先把那一頁抓回來。
- **PerplexityBot**：AI 搜尋服務 Perplexity 派出去讀網頁的程式，作用跟 ClaudeBot 一樣。
- **SOP（標準作業流程）**：把一件事該做的步驟寫成固定順序，照著跑就不會漏掉哪一步。跟「筆記」的差別是它有順序、而且每次都照同一套走。

### FAQ

**Q: GA4 chatgpt.com referral 跟一般 referral 差在哪？**

技術上一樣 (都是 HTTP Referer header)。差在「來源是 AI 對話」這件事改變 GEO 策略 — 你不能像優化 Google search 那樣盯關鍵字，要倒推「ChatGPT 為什麼引用你」，通常是 quotable block / FAQPage schema / 數字精確加上來源標註。

**Q: 反向 ChatGPT 用什麼 prompt？**

用「<你的主題> latest research 2026」「<關鍵字> case study with sources」這類會觸發 retrieval 的 prompt。ChatGPT 用 web search 時才會引用，純對話模式不會。文章內有 8 個觸發 prompt 模板。

**Q: Bing Webmaster 為什麼能看到 ClaudeBot / PerplexityBot?**

因為 ClaudeBot (Anthropic 爬蟲) 跟 PerplexityBot 都會被 Bing 的搜尋索引流程看到 — Bing Webmaster crawl stats 可以看到「哪個機器人抓了哪頁」。Google Search Console 看不到這資料，Bing 反而有。

**Q: 為什麼不用 Plausible / Fathom 之類付費版？**

個人 Lab 流量小、預算為 0，免費 GA4 加上 GSC 加上 Bing 三件套已經能做到 80% attribution 精度。Plausible 月費 $9 適合中大型站，個人站這種流量等級不划算。但隱私第一的 EU 站可考慮 Plausible。

---

## Brand profile 鎖定 workflow：讓 AI 當顧問探討品牌定位

> Source: https://www.coolkidlab.com/workflows/brand-profile-lockdown.html
> 不是叫 AI「給我一個品牌定位」(那只會拿到通用答案)，是把成長經歷餵給 AI、讓它當顧問反問你一串問題、一起探討哪些個性能變成品牌。「顧問式」方法 + prompt 模板。

### 發了一堆貼文，還是講不清楚自己的品牌是什麼

### 為什麼不能直接叫 AI「給我一個品牌定位」

### 解法：先餵背景，讓 AI 當顧問「探討」不是「給答案」

### 探討的目標：個性 pattern → 能變品牌的資產 → 願意長期做的方向

### 心法：定位是私人的，方法可以分享

### 整段複製給 AI agent — 即用 prompt

把下面整段貼給你的 AI agent，它就能照著當你的品牌顧問、陪你一輪一輪把「我是誰、哪些能變品牌」探討清楚，最後幫你鎖出一份 brand profile，你不用自己從零摸。

```
我要你當我的個人品牌顧問，陪我把「我是誰、哪些個性能變成品牌」想清楚，最後一起鎖出一份 brand profile 文件。你不是幫我寫文案的寫手，是逼我講清楚的顧問。

請避開這幾個雷，我踩過：
一、不要直接丟給我一句「你的品牌是真誠專業有溫度」這種通用定位，那種誰都能套等於沒用。我要的是從我的背景長出來、別人記得住也學不走的東西。
二、不要讀完背景就急著給答案。你要先當顧問多問少寫，一輪只問我三到五題，等我答完再追下一輪，把我自己沒意識到的個性、矛盾、反覆出現的行為模式挖出來。
三、我講的個人事實，像經歷、失敗、做過的事、數字，是唯一事實來源，你不要擅自改寫或美化。
四、brand profile 管「我寫什麼、立場是什麼」，跟管「怎麼寫、什麼語氣」的 voice profile 是兩件事，這次只做 brand profile，不要混在一起。

幾輪問答之後，我們再一起整理出三層：第一層是我反覆出現的特質，不是挑優點，是「就是會這樣」的模式，連我的毛病都算；第二層是這些特質裡哪些能變成品牌資產，標準是別人記得住、學不走、跟我這個人綁在一起；第三層是哪些方向是我碰得到又願意長期做的，不是看起來厲害但我會撐不住的。

開始前，請先問我兩件事再動工：一，我想先用哪一個 AI 工具來跑這套對話；二，我準備好要餵給你的背景大概涵蓋哪些，像成長經歷、做過的事、失敗過的事、我在意的東西。確認完再帶我一步步做，每進一輪都先跟我確認方向對不對，別自己一路衝到底。
```

把上面整段複製貼給你的 agent 就好，它會先問你要用哪個 AI、背景準備了哪些，再帶你一輪一輪探討；你只要照著回答、卡住時補一下自己的脈絡就行。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **ChatGPT**：OpenAI 的對話式 AI。本站常拿它跟 AI 代理對比：ChatGPT 給你答案、你自己動手；AI 代理直接幫你把事做完。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **公開打造（build-in-public）**：一邊做產品一邊公開過程、數據跟踩坑的創作方式。本站的 SEO 連載整個系列就是這個玩法。
- **brand profile（品牌檔）**：描述「你寫什麼、立場是什麼」的文件。跟 voice profile 分工：一個管內容方向，一個管語氣。
- **voice profile（語氣檔）**：一份描述「你怎麼寫」的文件：句法、開頭結尾習慣、用詞、節奏，以及你絕對不寫的東西。給 AI 讀規則，比丟一堆範例有效。

### FAQ

**Q: 這個 workflow 跟「叫 ChatGPT 給我品牌定位」差在哪？**

差在「方向」。直接問 ChatGPT 是「AI 告訴你你是誰」，結果是通用答案。這個 workflow 是「你告訴 AI 你做過什麼，AI 反問挖出規律」，結果是你自己生出來的、AI 只是助產士。跑完一輪才會懂為什麼直接問沒用。

**Q: 用 Claude Code 而不是 Claude.ai 對話差在哪？**

Claude Code 可以讀你之前丟給它的所有檔案 (過去的貼文、筆記、訪談稿)，持續 context 跨越多輪對話。Claude.ai 對話到後面會忘前面的細節。3-5 天訪談需要連貫 context,Claude Code 用 file-based 記憶就贏了。

**Q: 我沒什麼特別經歷可以挖，還能用嗎？**

可以。「特別」是相對的。訪談前常覺得「我就一個賠錢交易者沒什麼好說」，挖出來才發現「賠錢但持續 build-in-public 公開」這個組合就是品牌 — 沒人這樣做。重點不是經歷夠不夠精彩，是「組合」夠不夠少見。

**Q: 最後拿到的 brand profile 怎麼用？**

把它存成 brand-profile.md，以後寫文章 / 拍影片 / 接受訪談前先讀一遍，確認沒偏離。寫東西 AI 卡住時把這份丟給它當 context — voice 立刻對齊。3-5 天投入換接下來 1-2 年內容方向不偏，划算。

---

## Voice profile 萃取：從 9 篇樣本抽出語氣指紋給 AI 用

> Source: https://www.coolkidlab.com/workflows/voice-profile-extraction.html
> 用 AI 從 9 篇自己的貼文萃取可重複使用的「語氣指紋」voice profile。免費版講 framework、為什麼這比給 AI 更多 examples 有用；完整版附 ~600 字 voice profile.md。

### 給 AI 5-10 個 examples，寫出來還是不像你

### 解法：把 voice 變成可被 AI 直接讀的 profile.md

### Voice profile 比 examples 強在哪

### 8 個語氣元素工具箱(不是 checklist)

### 完整萃取 prompt(複製去換成你自己的貼文)

### 抽完怎麼 review + 反指紋怎麼推

### voice profile 怎麼用 + 不讓它飄掉

### 整段複製給 AI agent — 即用 prompt

把下面整段貼給你的 AI agent(Claude Code 或其他)，它就能照著幫你把這個「voice profile 語氣指紋萃取」流程建起來，你不用自己從零摸。

```
我要你幫我做一份「語氣指紋(voice profile)」的萃取流程，目標是產出一份大約 600 字的 markdown「規則手冊」，之後我每次寫作都會丟給 AI 當參考，讓它寫出來像我本人，而不是像通用 AI。

請照下面的方式進行：

1. 先要我準備 9 到 15 篇我自己過去寫過的貼文當樣本，並提醒我刻意涵蓋不同情境(吐槽、教學、進度更新、求推薦、情緒)，不要只挑同一種。

2. 拿到樣本後，請你逐篇看過、不要急著總結，然後抽出我的「寫作規則」，而不是複述我寫了什麼。抽這 9 個維度：句法、開頭鉤子、結尾收法、用詞、轉折、標點格式、Emoji 習慣、節奏招牌，最後第 9 項是「反指紋」(從樣本反推我永遠不會寫的東西，條列成黑名單)。

3. 每個維度用我貼文裡的真實句子當範例，輸出成一份 markdown，每維度一小節，控制在 600 字內。我要的是規則手冊，不是分析報告。

請幫我避開這幾個我已知會踩的雷：一、最核心是抽「規則」不是抽「主題」，因為主題會變、規則不會；二、樣本只挑同一種情境會抽歪，所以一定要混情境；三、反指紋這項最常被漏掉但最有用，務必認真推導；四、這 8 個正面元素是工具箱不是 checklist，提醒我一篇只挑 2 到 3 個搭配就好，8 個全塞會很油、反而不像本人；五、你抽完後別預設我照單全收，請帶我逐條確認「這是我的習慣，還是那篇剛好這樣寫」，只留下真正的習慣。

最後請你也告訴我：voice profile 管「怎麼寫」、另一份 brand profile 管「寫什麼跟立場」，兩份要分開維護、寫作時一起引用；並建議我每 2 到 3 個月拿最近的貼文回頭 review 一次，讓新招牌能補進來。

開始前先確認我手邊有沒有現成的貼文樣本、平常用哪個 AI 工具，然後一步步帶我走，每完成一步都先跟我確認再進下一步。
```

把上面整段複製貼給 agent 就好，它會先問你拿貼文樣本、再一步步抽，你只要回答它的問題、抽完時逐條確認哪些是你真的習慣就行。

### 名詞解釋

- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **大型語言模型（LLM, Large Language Model）**：ChatGPT、Claude 這類 AI 背後的技術：讀過海量文字後，學會理解與生成人類語言的模型。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **few-shot（範例教學法）**：給 AI 看幾篇範例，讓它照著模仿的做法。缺點是它只學得到表面用詞，學不到「為什麼這樣寫」的規則。
- **voice profile（語氣檔）**：一份描述「你怎麼寫」的文件：句法、開頭結尾習慣、用詞、節奏，以及你絕對不寫的東西。給 AI 讀規則，比丟一堆範例有效。
- **brand profile（品牌檔）**：描述「你寫什麼、立場是什麼」的文件。跟 voice profile 分工：一個管內容方向，一個管語氣。

### FAQ

**Q: 為什麼從舊文萃取比直接「我形容自己的 voice」準？**

你形容自己會用「希望我有的特質」(理想的我),AI 抓不到實際句法節奏。從 9 篇真實樣本萃取 AI 看到的是「實際的你」 — 包括你不自覺的句尾用詞、段落節奏、避諱字。準度差很多。

**Q: voice profile 過幾個月會不會過期？**

會。建議每 3-6 個月重新跑一次，因為 voice 本來就會變。每次重跑收最近 9 篇樣本 (不用全部歷史)，版本控用 voice-profile-v2.md / v3.md，新舊版本對照看 voice 怎麼演化也是有趣資料。

**Q: 一定要 9 篇樣本？可以更少嗎？**

9 是實測幾次下來的甜蜜點。5 篇以下 AI 會 overfit,12 篇以上邊際效益遞減。如果你樣本主題很集中可以 9 篇，跨主題 (例如有商業加上有生活感) 建議 12-15 篇拉開讓 AI 抓共通骨架。

**Q: 可以拿別人的 voice profile 用嗎？**

技術上可以，但意義不大 — voice profile 是「你的」指紋，拿別人的等於變成那個人寫稿。除非你刻意要 mimic (例如練習寫作)，不然不該用。原檔沒有公開，只公開「萃取 framework」讓你跑自己的。

---

## 讓 Claude Code 跨對話不失憶：斷點系統 + hook 自建紀錄

> Source: https://www.coolkidlab.com/workflows/claude-code-checkpoint-system.html
> 每開新對話 Claude 就忘光上次做到哪。用 .project/ 斷點檔 + SessionStart hook 強制載入 + 注入即時時間 + 全專案儀表板，把「跨對話失憶」修掉。附自建 prompt。

### 跨對話失憶，加上多專案狀態散落

### 這個 workflow 在做什麼：四層疊起來，核心是「讀強制、寫柔性」

### 狀態層怎麼切、半成品保護，以及三個會卡住的地方

### 整段複製給 AI agent — 即用 prompt

這篇不只是紀錄。把下面整段複製貼給你的 AI agent(Claude Code 最直接)，它就能照著幫你把同一套斷點系統建在你的專案上，你不用自己重走一晚。

```
我要你幫我在這個專案建一套「跨對話斷點系統」，讓你(Claude Code)每次開新對話都能接續上次進度，不要每次失憶。請依這個規格，先看過我的專案結構再一層一層建：
1. 狀態層：在專案根目錄建一個 .project/ 資料夾，放三個檔。current.yaml 是精簡斷點、控制在 30 行內，欄位包含 phase、last_updated、safe_to_continue、needs_human、next_task、next_input、open_issues。current.full.md 放長脈絡(架構、踩過的雷、外部依賴)，按需才讀。decisions.yaml 是只增不改的決策日誌，每條有 id、date、decision、rationale、status，決策演變時用新條目標 supersedes 舊的、永遠不要覆寫舊條目。
2. 載入層：設一個 SessionStart hook，每次開對話自動把 current.yaml 印出來注入 context；如果 safe_to_continue 是 false，就先警告我上次有未完成的工作、問我要繼續還是回滾，不要悶頭往下做；沒有 .project/ 的專案要安靜跳過、不要報錯。
3. 時間層：設一個 UserPromptSubmit hook，每則訊息前注入一行當下精確時間(年月日時分秒加星期)。請用純 ASCII 輸出、只留 UTC 偏移(像 UTC+08:00)，不要印本地化的時區名稱，否則在 Windows 上會被 cp950 編碼轉成亂碼。
4. 設計原則請守住「讀強制、寫柔性」：載入斷點走 hook 強制執行(零成本又不能漏)，寫回斷點只用柔性提醒(不要用 hook 強制擋我、會很煩)。
請避開我已知的坑：不要依賴 jq 之類我可能沒裝的工具，能用內建或 Python 就好；解析多行 YAML 折疊語法要讀到下一個 key 為止。請先確認我的作業系統跟專案結構，再一步步建，每建一層就停下來跟我確認再繼續。
```

把上面整段複製貼給 agent 就好。它會先看你的專案結構、問你用什麼作業系統，再一層一層幫你建，每層跟你確認。你要做的只是回答 + 在它卡住時補環境資訊。

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **hook（掛鉤）**：在工具的固定時機（開始對話、寫完檔案、結束回合）自動執行你指定動作的機制。像是幫 AI 設「進門要換鞋」的家規，設一次每次都自動生效。
- **YAML**：一種給人讀也給程式讀的設定檔格式，用縮排表示層級。常拿來存設定、狀態這類結構化資料。
- **skill（技能包）**：Claude Code 的知識外掛：一個資料夾放一份說明書（SKILL.md），教 AI 特定領域的做事方法。對到相關任務時 AI 會自己翻出來照著做。
- **編碼（encoding）**：電腦儲存文字的方式。Windows 中文環境常用 Big5，多數程式假設 UTF-8，兩邊對不上就變亂碼 — 所以資料夾、檔案建議用英文命名。

### FAQ

**Q: Claude Code hooks 是什麼？**

Hooks 是 Claude Code 在特定事件觸發時自動執行的 shell command。SessionStart hook 在每次開新對話時跑，可以注入「上次做到哪」的 context;UserPromptSubmit hook 在每次 user 送訊息前跑，可以注入即時資訊 (時間 / git status)。設定在 ~/.claude/settings.json。

**Q: .project/ 斷點檔該寫什麼？**

三個檔：current.yaml (現在做什麼 phase / 上次做到哪 / 下一步)、decisions.md (重大決策記錄，append-only)、roadmap.md (整體路線圖)。原則是「下一個 session 的我看了能 1 分鐘進入狀態」，不是「完整日誌」。

**Q: 為什麼不用 Claude Projects 內建記憶？**

Claude Projects 有 context window 上限，大專案 (例如這個 Lab) 跨幾百個 chat 一定塞爆。.project/ 用 file-based，只在需要時讀進來，沒上限。但 Claude Projects 自動同步比較方便，小專案用它即可。

**Q: 整套要花多久建？**

用本文整段 prompt 複製給 Claude Code，它幫你建好骨架約 30 分鐘。但「養成寫斷點檔的習慣」要 1-2 週 — 一開始會忘記寫，過幾次「下次開新對話想不起來」就學乖了。

---

## 對手內容地圖：sitemap 變內容作戰地圖|開源 SEO 工具

> Source: https://www.coolkidlab.com/workflows/competitor-content-map.html
> 免費開源 Python 工具：讀對手公開 sitemap 分主題桶、跨站覆蓋矩陣找內容空白、lastmod 新鮮度訊號。零依賴、附 Claude Code plugin 一行安裝。

### 這個工具做三件事

### 為什麼第 0 步是先讀你自己的站

### 怎麼用(CLI)

### 三段分工：別讓 AI 編數字

### 名詞解釋

- **SEO（搜尋引擎優化）**：讓網站在 Google 搜尋結果排得更前面的一整套方法，涵蓋技術體質、內容品質、連結結構三層。
- **網站地圖（sitemap）**：列出網站所有頁面跟最後更新日的清單檔（sitemap.xml），交給搜尋引擎加速發現與重抓你的頁面。
- **爬蟲（crawler）**：自動瀏覽網頁、把內容抓回去的程式。Google 靠爬蟲收錄網頁，AI 公司靠爬蟲收集資料。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **slug（網址短名）**：網址最後那段代表這篇文章的英數字串，例如 /workflows/threads-auto-poster.html 裡的 threads-auto-poster。取名要能看出內容，而且上線後盡量不要改。
- **lastmod（最後修改時間）**：sitemap 裡標示每個頁面最後更新日期的欄位，搜尋引擎會參考它決定要不要重新來看。整站同一天的 lastmod 通常是自動產生的假新鮮。
- **repo（專案倉庫）**：GitHub 上的一個專案資料夾，裡面放程式碼、說明文件跟修改紀錄。一個 repo 就是一個獨立的專案。
- **Python**：入門門檻最低的主流程式語言之一，資料處理、自動化、AI 領域的首選。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。

### FAQ

**Q: 會不會爬壞對手的網站？**

不會。工具只讀公開的 robots.txt 與 sitemap.xml — 這些本來就是網站主動公開給搜尋引擎的檔案，不掃頁面內容、不高頻請求。

**Q: 需要安裝什麼依賴？**

零依賴。純 Python 標準庫，有 Python 3.10+ 就能跑；不用 pip install 任何東西。

**Q: 為什麼不直接給我搜尋量？**

因為 sitemap 裡沒有搜尋量資料，任何工具在這個輸入下報搜尋量都是編的。工具的立場是確定性的事給你確定的數字，語意的事交給 AI，沒有的資料誠實說沒有。

**Q: Claude Code plugin 跟直接跑腳本差在哪？**

plugin 裝了之後用講的就好 —「幫我掃這三個對手」,AI 會跑工具、讀報告、幫你歸納；直接跑腳本則是你自己看 map.md。功能一樣，plugin 省操作。

---

## 文章撞稿檢查 article-overlap-checker：找互搶排名的頁|開源

> Source: https://www.coolkidlab.com/workflows/article-overlap-checker.html
> 免費開源 Python 工具：TF-IDF 掃全站找撞稿(keyword cannibalization)與孤島頁。中英混排通吃、零依賴、0.33 秒掃 50 頁，附 Claude Code plugin 安裝。

### 它回報的三件事

### 怎麼跑

### 讀報告的原則

### 侷限(誠實告知)

### 這個工具實際抓到過什麼

### 名詞解釋

- **SEO（搜尋引擎優化）**：讓網站在 Google 搜尋結果排得更前面的一整套方法，涵蓋技術體質、內容品質、連結結構三層。
- **網站地圖（sitemap）**：列出網站所有頁面跟最後更新日的清單檔（sitemap.xml），交給搜尋引擎加速發現與重抓你的頁面。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **TF-IDF（用詞重疊度）**：比較兩篇文章像不像的老方法：看它們用了多少相同的詞，並把「到處都有的常見詞」降權。抓得到用詞重疊，抓不到換句話說的同義，只能當粗篩。
- **keyword cannibalization（撞稿）**：同一個網站有兩篇以上文章瞄準同一個搜尋意圖，搜尋引擎分不清該讓誰排名，結果兩篇都排不好。解法是合併、改角度，或明確分工。
- **HTML**：網頁的骨架語言，定義「這是標題、這是段落、這是圖片」。
- **repo（專案倉庫）**：GitHub 上的一個專案資料夾，裡面放程式碼、說明文件跟修改紀錄。一個 repo 就是一個獨立的專案。
- **Python**：入門門檻最低的主流程式語言之一，資料處理、自動化、AI 領域的首選。

### FAQ

**Q: 什麼是 keyword cannibalization(撞稿)？**

同一個搜尋意圖你有兩個以上的頁面在搶，搜尋引擎分不清該給誰排名，常見結果是兩頁都排不好。合併或分工是常見解法，但要先確認真的是同一個意圖。

**Q: 需要安裝什麼？**

零依賴，純 Python 標準庫。有 Python 3.10+ 就能跑，不用 pip install。

**Q: 中文網站能用嗎？**

能，這是它的設計重點之一 — CJK 字元用 bigram 處理，中英混排通吃。它本來就是在一個繁中站上開發校準的。

**Q: 多久跑一次？**

兩個時機：寫新文章前(確認選題沒撞線)、寫完後(確認沒製造新撞稿)。全站健檢一季一次就夠。

---

## Windows 桌面小精靈製作器：用寵物照片做桌寵|開源教學

> Source: https://www.coolkidlab.com/workflows/windows-desktop-pet-builder.html
> 開源教學 repo：用自己的寵物照片，讓 AI Agent 一步步做出可拖曳、會看滑鼠、會跑跳撿球的 Windows 桌面小精靈。含完整繁中教學、主提示詞與可安裝 skill。

### 這是什麼、做出來長怎樣

### 需要什麼

### 快速開始

### 隱私與安全的邊界

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **Codex**：OpenAI 的程式型 AI 代理，跟 Claude Code 同類：能讀寫你的檔案、跑指令、動手把功能做出來。
- **repo（專案倉庫）**：GitHub 上的一個專案資料夾，裡面放程式碼、說明文件跟修改紀錄。一個 repo 就是一個獨立的專案。
- **skill（技能包）**：Claude Code 的知識外掛：一個資料夾放一份說明書（SKILL.md），教 AI 特定領域的做事方法。對到相關任務時 AI 會自己翻出來照著做。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。

### FAQ

**Q: 完全不會寫程式能做出來嗎？**

能。設計對象就是非工程師：主提示詞整段複製貼給 Claude Code 或 Codex,AI 會照規格一步步做，你負責提供照片、回答問題、驗收。

**Q: 要付費嗎？**

repo 本身免費開源。你需要一個能寫程式的 AI Agent(Claude Code / Codex)，那部分依你自己的訂閱。

**Q: 我的寵物照片會被上傳嗎？**

不會進 repo 也不會被要求上傳到任何服務 — 素材都在你本機。教學也不要求關閉任何 Windows 安全功能。

**Q: Codex 跟 Claude Code 都能用？**

都能。repo 附的 skill 可以複製進 Codex 的 skills 目錄；Claude Code 使用者直接貼主提示詞或把 skill 放進專案即可。

---

## AI 簡報工具 shiftdeck：做完還能自己改版面與動畫|開源

> Source: https://www.coolkidlab.com/workflows/shiftdeck.html
> 免費開源：用 AI 做 PowerPoint，但版面你自己挑、動畫你自己點、單頁重做不用等全份。輸出是原生可編輯的 .pptx，不是一頁一張圖。基於 ppt-master 引擎，介面繁體中文。

### AI 做的簡報，為什麼常常改不動？

### 三件事變成你自己決定

### 怎麼裝、怎麼開始

### 為什麼要跑兩道檢查？

### 有哪些限制？

### 底層引擎與授權

### 整段複製給 AI agent — 即用 prompt

裝好之後，這段可以整段複製貼進 Claude Code，把材料路徑跟需求換成你自己的就能開始。

```
用 shiftdeck 做一份簡報。

材料：C:\Users\你的名字\Desktop\Q3業績報告.pdf
對象：部門主管
長度：12 頁以內
語言：繁體中文

版面要求：
第 3 頁用對比頁，比較今年跟去年的三個面向。
第 7 頁用 KPI 儀表板，放 4 個指標。
動畫套組選「專業沉穩」。

做完跑兩道品質檢查。第二道會產生逐頁的 PNG，你要真的逐頁看過再跟我說完成。
```

最後那一句是重點。品質檢查有兩道，第一道算座標、第二道真的渲染成圖片，只跑第一道會漏掉文字撐破方框這種問題。不寫這一句，AI 很可能只跑第一道就回報完成。

### 名詞解釋

- **AI 代理（AI agent）**：會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **Cursor**：內建 AI 的程式編輯器，跟 Claude Code 同類，但走「圖形介面編輯器」路線而非終端機路線。
- **Codex**：OpenAI 的程式型 AI 代理，跟 Claude Code 同類：能讀寫你的檔案、跑指令、動手把功能做出來。
- **repo（專案倉庫）**：GitHub 上的一個專案資料夾，裡面放程式碼、說明文件跟修改紀錄。一個 repo 就是一個獨立的專案。
- **Git**：程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- **Python**：入門門檻最低的主流程式語言之一，資料處理、自動化、AI 領域的首選。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **提示詞（prompt）**：你打給 AI 的那段指令或描述。寫得越具體（要什麼、給誰用、長怎樣），AI 做出來的東西越接近你要的。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **提交（commit）**：Git 的一個存檔點：把這次改動連同一句說明記錄下來，之後隨時可以回到這個版本。

### FAQ

**Q: 完全不會寫程式能用嗎？**

能，但要先過裝環境這一關。上面那三行指令是在終端機裡跑的，第一次做會陌生。裝完之後都在對話裡做，你講需求、AI 動手，不用看程式碼。

**Q: 跟 Gamma、Canva 那些網頁版 AI 簡報工具差在哪？**

那些打開瀏覽器就能用，門檻低很多。shiftdeck 要先在自己電腦裝環境，換來的是原生可編輯的檔案跟單頁重做。一次性的簡報用網頁服務比較快，會反覆改的簡報用這個比較不痛苦。

**Q: 做出來的檔案能給沒裝這個工具的同事嗎？**

能。輸出就是一般的 .pptx，同事用 PowerPoint、Google 簡報或 LibreOffice 打開都行，跟你自己做的檔案沒有兩樣。他們不需要裝任何東西。

**Q: 動畫是真的 PowerPoint 動畫嗎？**

是。匯出的是 PowerPoint 檔案格式裡原生的動畫節點，不是用圖片模擬。你在 PowerPoint 的動畫窗格看得到每一條，也能自己再改。

---

## 出國行前清單工具：貼一份文件，AI 帶你一項一項辦完|免費開源

> Source: https://www.coolkidlab.com/workflows/trip-guide.html
> 把出國前要辦的事分成 5 個時間層、17 個項目，用你的出發日算出每一項的截止日，最後給一份可以貼進待辦 App 的清單。不用寫程式，手機貼一份文件就能用。

### 怎麼用？手機兩種用法都不用裝東西

### 常用 Gemini？有現成的 Gem 可以直接用

### 電腦有 Claude Code？裝完整版

### 我常常漏東漏西，不是因為懶

### 這個工具在做什麼？

### 手機的精簡版，跟完整版差在哪？

### 幾個新手真的會漏的東西

### 跟機場和海關有關的幾條

### 這個工具不做什麼？

### 最常遇到的問題

### 如果你想訂

### 名詞解釋

- **skill（技能包）**：Claude Code 的知識外掛：一個資料夾放一份說明書（SKILL.md），教 AI 特定領域的做事方法。對到相關任務時 AI 會自己翻出來照著做。
- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **eSIM（虛擬 SIM 卡）**：不用插實體卡的虛擬 SIM 卡，出國前先買好，落地開通就能上網。
- **開源（open source）**：把原始碼公開放到網路上，任何人都能免費下載、查看、使用。
- **plugin（功能包）**：把一個或多個 skill 包起來、可以整包安裝的單位，在 Claude Code 裡用 `/plugin install` 安裝。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **repo（專案倉庫）**：GitHub 上的一個專案資料夾，裡面放程式碼、說明文件跟修改紀錄。一個 repo 就是一個獨立的專案。
- **marketplace（功能包清單）**：一份功能包清單。先把清單加進 Claude Code，才能從裡面挑要裝哪一個。

### FAQ

**Q: trip-guide 會幫我比價或訂機票嗎？**

不會，只提醒要辦哪些事跟截止日，機票住宿本身要自己上 Google Flights 或訂票網站訂。

**Q: 一定要用 Claude Code 才能用嗎？**

不用。手機上的聊天 AI 幾乎都能用，把文件網址丟過去讓它自己讀，或者整份貼進去，都可以。實測過的例外是 Google 搜尋的 AI 模式，它兩種都吃不下，要用 Google 家的請開 Gemini。Claude Code 只是其中一種比較方便的用法，不是必要條件。

**Q: trip-guide 會直接告訴我簽證規則嗎？**

不會給規則本身的答案。會提醒這個目的地有這件事要辦，並附上怎麼找官方來源的方法。這些規則常常在變，固定寫在工具或文章裡，風險是看到過期的資訊還以為是對的。

**Q: 手機貼一份文件，跟裝 plugin 有什麼不一樣？**

手機貼的是精簡版，拿得到五個時間層、截止日怎麼算、清單長什麼樣子。17 個項目各自的判斷內容在另外 12 份判斷內容文件裡，那個要裝完整版的 plugin 才有。

**Q: 連假會幫我查嗎？**

不會，工具裡沒有存任何連假表。存了就會有一份沒人維護的清單躺在裡面，讀到的人不會知道它是哪一年的。它會提醒你去查出發地和目的地那幾天有沒有連假。你查到有，跟它說是哪一邊撞到，它就會把對應的項目提前天數加倍、重新算一次日期。出發地撞到加倍的是機票，目的地撞到加倍的是住宿跟票券。

**Q: 免費嗎？**

免費，已開源在 Coolkidlab-Yin/Coolkidlab 這個 repo（GitHub 上放程式碼的專案空間）。手機直接貼文件就能用，不用另外付費或註冊。

---

## 手機翻任何一個 session 接著聊，還能換手|開源

> Source: https://www.coolkidlab.com/workflows/claude-chat-mobile.html
> 官方遙控一次只能操控事先設定好的那個 session，靈感跳出來時想接的往往是別的。這個自架的手機聊天室把所有 session 列成一份清單，點一個就接著聊，Codex 也能派。

### 先說：官方三條路我都用過

### 為什麼不直接用手機連電腦就好？

### 它長什麼樣

### 幾個實際用起來有感的地方

### 這件事你一定要先懂（安全）

### 怎麼裝、需要什麼

### 有哪些限制

### 名詞解釋

- **Claude Code**：Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- **開源（open source）**：把原始碼公開放到網路上，任何人都能免費下載、查看、使用。
- **repo（專案倉庫）**：GitHub 上的一個專案資料夾，裡面放程式碼、說明文件跟修改紀錄。一個 repo 就是一個獨立的專案。
- **GitHub**：放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- **命令列（CLI, Command Line Interface）**：用打字指令操作電腦的方式，沒有按鈕跟視窗。Claude Code 就是命令列工具。
- **終端機（terminal）**：「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- **API（應用程式介面）**：程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。

### FAQ

**Q: 這個跟官方的手機方案差在哪？**

官方有三條路，我都用過。Remote Control 讓手機接手你在電腦上事先設定好遙控的那個 session，Dispatch 讓你從手機發任務、它自己開一個新的，claude.ai/code 的雲端版什麼都不用架但碰不到你本機的檔案。三條都不會在你電腦上開對外的門，比自架安全，大部分人用官方的就好。差別在兩件事：一是遙控一次只能操控設定好的那一個，你沒辦法從手機跳到另一個沒設定過的舊 session，session 一多就不可能全部設定。二是官方各家管各家，換手要換 App、看兩份清單，這個工具把兩邊放進同一份清單，開新對話時直接選要派誰。

**Q: 為什麼要做多個 AI 切換？只用 Claude 不行嗎？**

因為我 Claude Code 跟 Codex 兩份訂閱都有付。同一件事卡住的時候換另一個做做看很有用，但兩家各有各的入口、各有各的對話清單，換手就得換一個 App 從頭找。所以這個工具把兩邊放進同一份清單，開新對話時直接選要派誰。如果你只用一家，這個功能對你沒意義，官方的方案就夠了。

**Q: 手機鎖屏或切出去，正在跑的工作會斷嗎？**

不會。工作是在你電腦上獨立做的，手機只負責看跟講。鎖屏、切 App、訊號斷掉都不影響，回來重新打開那間聊天室就看到結果。這正是我做這個東西取代直接遠端連線的主因。

**Q: 沒有帳號密碼，這樣安全嗎？**

預設狀態下只有你自己那台電腦連得到，所以不需要密碼。要讓手機連得到，你得自己打開一個設定，而那個時候就該同時設一組密碼，設定檔裡有欄位。另外絕對不要架在雲端主機或把連接埠轉發到公網。不確定自己的設定算不算安全的話，那就是不安全，先別裝。

**Q: 一定要用 Tailscale 嗎？**

不一定，任何能把手機跟電腦連成同一個私有網路的方案都行。我選 Tailscale 是因為免費、裝完就能用、不用碰路由器設定。重點不是牌子，是那條線必須只有你自己在上面。

**Q: Grok、Gemini 那幾家真的能用嗎？**

不知道，我沒有實際送過請求。介面、擋門提示、設定都做好也驗過了，但真正打出去的那一段是寫好放著沒跑過，所以我不能說它能用。Claude Code 跟 Codex 這兩個是實際用過的。你如果試了有問題，歡迎在 GitHub 上開 issue。

**Q: Mac 可以用嗎？**

不知道，我沒有 Mac 可以測。程式本身沒有刻意綁 Windows，但有些地方是照 Windows 寫的，直接跑很可能要修幾個地方。有人試成功歡迎回報。

**Q: 不會寫程式的話，看得懂這個 repo 嗎？**

不用看懂也能用，照著幾行指令裝起來就行。但如果你想改它，這個 repo 本身就是給你參考的：整套東西是我用講的讓 AI 蓋出來的，我沒寫過任何一行。你可以打開來對照，看一個需求最後變成什麼結構。

---