Vibe Coding 從新手到成品

Vibe Coding 是一種透過 AI 把東西做出來的方式，不需要成為工程師也能上手。這堂課是新手課程，不會趕進度，遇到太難的專有名詞會用白話文解釋或直接跳過。課程裡用到的投影片和資料都會放到 Discord 頻道，不用急著截圖。今天介紹的 Claude Code 每週都在進步，回應越來越好，功能持續增強。如果點數用完了就休息一下，環境設定有問題也可以帶著作品到每週二的默默會現場解決。重點是先理解，不用擔心跟不上。

Claude Code 是今天的學習重點，這個工具操作不難，主要就是打字下指令，但持續有新功能加入。今天我們可以試著當個「AI 巨嬰」，讓 AI 幫忙解決安裝和技術問題。真正的 Vibe Coding 概念是：給 AI 規格，讓它寫，驗收結果，然後一直循環，而不用自己動手改程式碼。

Claude 全家桶產品線包含網頁版、桌機版和 Claude Code。網頁版可直接在瀏覽器中對話，桌機版最近推出 Cowork 功能，能整理電腦檔案、操作瀏覽器，甚至支援遠端手機操控。Claude Code 是終端機介面，本質上就是個對話框，除了寫程式碼，也能協助撰寫文章和修改文案。計費方式分為訂閱制和 API 模式，訂閱有 20、100、200 美元三種方案。建議先從 20 美元開始試用，不夠再升級，不要被網路上的同溫層焦慮影響。

安裝 Claude Code 時要特別小心，搜尋結果中可能出現假網站。正版網址是 `claude.com`，要認明這個網址，不要被贊助商廣告誤導。安裝完成後，打開終端機輸入 claude 指令啟動，第一次會被要求登入。Claude Code 會在背景自動更新，不確定怎麼操作時，可以直接詢問它。

Claude Code 有三種模式可用 Shift+Tab 循環切換：預設模式（每個動作都會詢問）、Accept-Edit 模式（自動修改檔案但執行指令會問）、Plan 模式（只規劃不執行）。我通常會先切到 Plan 模式跟 AI 討論需求，讓它產生規劃檔，確認後再切到 Accept-Edit 模式自動執行。Claude Code 之所以比其他 AI 工具好用，不是因為模型特別強，而是工具本身做得好，內建許多提示詞，加上 Anthropic 工程師自己每天都在用，持續改善開發者體驗（DX），這才是它勝出的關鍵。

Claude Code 有三種模型可選：Opus、Sonnet、Haiku。Opus 最聰明，適合處理複雜任務，但消耗最快；Sonnet 適合大部分任務，性價比高；Haiku 速度最快但能力較弱，適合簡單問答。訂閱 20 美元建議先用 Sonnet，遇到難題再切 Opus；100 或 200 美元可全程開 Opus。每個模型還能調整思考程度，有 Low、Medium、High、Max 等級，Opus 獨有 Max 模式會想更久更細。

Claude Code 的終端機介面其實可以貼圖，用 Ctrl+V 或拖拉方式貼入，貼成功後會顯示中括號 Image 標記。這個功能很實用，例如看到錯誤訊息不知道怎麼描述時，直接截圖丟給 AI 問怎麼解決，比用文字說明更簡單。AI 能夠識別圖片中的文字和內容，告訴你問題在哪、如何處理。

Claude Code 有幾個實用的內建指令。/context 可以查看目前對話視窗的使用量，包括系統提示、工具和訊息各佔多少空間，當接近上限時會自動壓縮。/clear 能清除對話紀錄，適合開始新任務時使用，清除後 AI 會忘記先前的對話內容。/compact 可手動壓縮對話，但通常不太需要，因為系統會自動處理。使用 @ 可以指定檔案讓 AI 讀取並分析。/plugin 能安裝官方認可的外掛工具。還有個有趣的 /btw 指令，讓你在 AI 執行任務時，順便問些簡單問題，不會中斷主要工作。

CLAUDE.md 是 Claude Code 的設定檔，每次啟動時會自動讀取，用來指定回應規則，例如使用繁體中文、Commit 訊息用英文、縮排用 Tab 等。建立方式有兩種：手動新增檔案，或用 /init 指令自動產生。若放在專案目錄下，只對該專案有效；若放在 Home 目錄的 .claude 資料夾則全域適用。

Claude Code 的 Auto Memory 功能可在開發過程中自動記錄重要資訊，但實際上不太會主動觸發。CLAUDE.md 像員工手冊，適合放正式規範；Memory 則像 AI 自己的筆記本。兩者有部分重疊，但 CLAUDE.md 更容易編輯，控制權較高。

Context Window 是讓 AI 記住對話內容的關鍵，沒有它，大型語言模型每次對話都是全新開始。預設大小是 20 萬個 token，快滿時會自動壓縮。壓縮本質是丟棄部分資訊，所以 AI 不是變笨，而是記憶變模糊。Context Window 越大不代表越聰明，研究顯示塞太多內容反而可能讓中間資訊被忽略。壓縮後雖然模糊，但仍保有上下文情境，不必從頭交代。若下個任務與前面有關聯，就讓它壓縮繼續做；若無關，則清掉重開對話即可。

Claude Code 有幾個實用功能。Slash command 類似巨集或快捷鍵，可以把常用的指令存成 markdown 檔案，放在專案或全域環境的 commands 資料夾中，輸入斜線加檔名就能快速執行。Sub-agent 是在同一個對話中開啟多個分身，各自擁有獨立的 context window，做完後再回報主線任務，不會污染原本的上下文。Agent Teams 是進階版，Cloud Code 會自動判斷任務是否可平行處理，一次派出多個 sub-agent 同時執行。此外，執行簡單任務時，系統會自動降級使用 Sonnet 模型來節省成本。

Skill 是一種技能包，本質上是一個資料夾，裡面至少要有一個 SKILL.md 檔案，用來指導 Agent 在特定情境下該如何處理任務。Skill 除了 markdown 描述檔，還能放入 Python 或 JavaScript 程式，讓它執行更複雜的功能。但要注意別人寫的 Skill 可能藏有惡意程式，安裝前務必檢查內容。

Skill Creator 是一個可以幫你建立自訂 Skill 的 Skill，安裝後只要用自然語言描述需求，它就會自動產生對應的 Skill。例如我覺得寫 Git Commit 訊息很煩，就直接跟它說「幫我建一個寫 commit message 的 Skill」，不需要什麼專業提示詞，它就會自動建好整個架構。現在的 AI 已經夠聰明，不用再玩什麼角色扮演或複雜的提示技巧，直接講你要什麼就好，與其羨慕別人的工具，不如自己建一個更符合工作流程的 Skill。

MCP 是 Model Context Protocol 的縮寫，目的是統一大語言模型的工具標準。大語言模型本身只有「腦袋」沒有「手腳」，無法直接抓取網路資料或操作檔案，必須透過外掛工具來擴充功能。過去各家模型如 OpenAI、Gemini、Claude 都有自己的 SDK，同樣功能要寫很多套，MCP 希望寫一次就能跨平台使用。不過 MCP 不是裝越多越好，會佔用 context window。

Skill 會佔用 Context 但相對輕量，只在實際使用時才載入完整內容，MCP 會吃比較多資源，用不到的可以關閉或移除。

Vibe Coding 是 2025 年 2 月由 Andrej Karpathy 提出，但這被過度解讀為「任何人都能寫程式」，實際上並非如此。AI 是駕駛員意志的延伸，本身沒底子的人，AI 能幫的有限。早期的 Vibe Coding 做法是用一發入魂的完美 Prompt，但同樣的提示詞，每個人做出來的結果都不一樣，非常隨機。學程式仍有必要，但不用像以前學到物件導向或設計模式那麼深入，底子越厚能走越遠。

SDD（Spec Driven Development，規格驅動開發）是一種開發流程，重點在於先定義規格再寫程式。這個方法分為三個階段：第一階段是釐清需求，例如「我想做會員登入系統」；第二階段是系統設計，決定要做什麼、不做什麼，這對 AI 開發特別重要，因為 AI 常會過度發揮；第三階段是將需求拆解成待辦事項清單，完成後逐一勾選驗收。SDD 有三個層級：Spec First（先寫規格）、Spec Anchor（規格錨定到程式碼）、Spec as Code（規格即程式碼，目前仍是理想）。常見框架包括 Amazon 的 Kiro、GitHub 的 SpecKit，以及 OpenSpec。

Spectra 是我自己開發的視覺化 SDD 工具，核心概念是先想清楚要做什麼再寫程式，目前支援 Mac 和 Windows。使用時先切換到規劃模式，避免 AI 直接衝去寫程式碼。重點在於一塊一塊把功能做出來，不要一口氣把所有功能都丟給 AI，否則 context 壓縮後容易歪掉。透過 Spectra 的 propose 指令產生正式提案，包含為什麼要做、預計改動哪些檔案，Spectra 會自動拆解任務，並做兩輪分析確保任務與提案一致，最後產出完整的規格文件。

Spectra 的 Park 功能可以暫存規格，讓你先仔細確認需求再動工。在規格討論階段，可以隨時修改元件選擇，例如把 shadcn 換成 Tailwind，AI 會自動更新所有相關檔案。確認規格後開始執行，過程中可以用精簡模式縮小視窗，一邊做其他事一邊監控進度。整個過程不需要手動編輯程式碼，只要在對話區表達需求即可。最後記得讓 AI 更新規格文件，確保程式碼與規格同步，再封存任務並 commit。

規格驅動開發（SDD）的核心概念是先與 AI 討論需求，讓它產出規格文件，包含要做什麼、不做什麼，以及任務清單。資料庫可先選 SQLite 求簡單，之後再遷移。驗收時依據規格逐條檢查，搭配 TDD 自動產生測試，確保修改不會破壞既有功能。若預算有限，可用不同 AI 工具分工，一邊寫規格、一邊寫實作，組合出更好的效果。

SDD（規格驅動開發）的核心概念是先與 AI 討論規格，確認要做什麼、不做什麼，再開始動工。相較於 Vibe Coding 1.0 一個提示詞就讓 AI 直接生成的做法，SDD 能更精確控制開發方向，避免浪費 token 和時間。

Git 是版本控制工具，能像時光機一樣幫專案拍照存檔，讓你隨時回到特定時間點的狀態。Git 和 GitHub 不同，前者是工具，後者是網站。過去學 Git 指令很痛苦，但現在透過 Claude Code 等 AI 工具，只要說「幫我安裝 Git」「幫我 commit」「幫我開分支」，AI 就會處理那些複雜指令。不必背語法，只需理解概念即可。在 Vibe Coding 時代，版本控制特別重要，萬一 AI 改壞程式碼你會知道怎麼回到之前正常的狀態。

Vibe Coding 之後，該補的基礎還是要補。不管是 SDD 還是 Spectra，重點都在規範 AI 該做什麼、不該做什麼。Spec 就是壓縮過的 context，可以交給任何 AI 執行。信任是一個光譜，不是零或一。程式碼重點不在於誰寫的，而在於如何被驗證。把腳步放慢，先定規格，再做驗收。AI 並非取代人類而是放大能力，資深工程師加上 AI 可以一個打十個，工程師的角色會從第一線實作，轉向架構規劃與驗證，成為指揮 AI 軍團的角色。

Spectra 的 config.yml 可以設定專案說明、技術棧和產出規則，功能與 CLAUDE.md 有些重疊。為了避免 AI 在長對話中遺忘設計細節，我設計了每次執行任務前會先讀取相關設計文件刷新記憶的機制，雖然會多花一些 token，但比事後修正更划算。