精華筆記

· @aihub.tw

Claude 新手指南

綜合實戰:一個案例串起全部,再避開新手最痛的 8 個坑

綜合實戰:一個案例串起全部,再避開新手最痛的 8 個坑

你已經走完七課了。從第一次打開 Claude.ai、學會怎麼問、讓 Claude Code 住進終端機,到寫 CLAUDE.md、打包 Skills、派出 Subagents、接上 MCP——每一課都學了一個新武器。但這裡有個真實的問題:學了七個工具,不代表你會把它們串起來用。

很多人到這一步的狀態是「每個都聽過,遇到事情卻不知道該叫哪一個出場」。這堂畢業課要解決的就是這件事。我不再教新東西,而是做兩件更重要的事:用一個從頭到尾的真實案例,把七課串成一條生產線;再把新手最常踩、而且踩了會很痛的 8 個坑一次攤開,附上你真的會看到的錯誤訊息和解法。看完這課,你腦中會有一張完整的地圖,而不是七塊拼不起來的拼圖。

這堂課適合誰 適合:已經上完前七課(或至少用過 Claude Code)、想把零散概念整合成實戰能力的人。需要基礎:讀得懂前七課的名詞就好。前置課:第 1 到 7 課,這是收尾的第 8 課。

這堂學什麼

  • 把七課的工具接成一條生產線:每個概念在真實專案裡各站哪個位置
  • 跟著走一個端到端案例:從一個點子到官網上線、自動發文,附可複製的指令
  • 用一張圖記住 2026 年 7 月的選模型與選方案心法,不再每次都猶豫
  • 學會脈絡管理:/clear/compact/context 三個指令什麼時候用
  • 逐一避開新手最常踩的 8 個坑,含真實錯誤訊息與解法
  • 三份難度遞增的作業,以及畢業之後往哪走

觀念一:七課不是七個工具,是一條生產線

先把整套指南在腦中重新排好。這七課看起來各講各的,其實是同一條生產線上的七個工站,料件(你的需求)從左邊進去,成品從右邊出來:

Claude 新手指南七課串成一條生產線

  • 第 1 課 開口問(Claude.ai):打開就能聊,養成「答案不夠好就在原對話追問」的習慣。
  • 第 2 課 問得好(Prompt 原理):用給指令、給背景、給範例、指定格式、當草稿追問這五個零件把需求講清楚。
  • 第 3 課 動手(Claude Code):讓 AI 住進終端機,直接讀專案、改檔案、跑指令。
  • 第 4 課 立規矩(CLAUDE.md):把技術棧、慣例、常用指令寫下來,AI 每次開工都記得。
  • 第 5 課 可重用(Skills):把你一講再講的流程打包成 SKILL.md,以後自動照做。
  • 第 6 課 派分身(Subagents):把能平行、彼此獨立的任務丟給子代理,一次做完一堆事。
  • 第 7 課 接工具(MCP):接上 GitHub、資料庫、排程工具,讓 Claude 動得到外部世界。

重點是這句話:每個概念都不是孤立的,它們是一條生產線上的不同工站。 你不需要每次都用滿七個,但你要知道遇到什麼情境該把哪一站叫出來。

觀念二:一個案例,把全部串起來

光看流程圖太抽象。我們用一個具體到你可以照做的案例:幫一個側專案(side project)做官網,並且自動發布宣傳貼文。 看每個概念怎麼各就各位:

一個真實案例:幫側專案做官網並自動發文,七個概念各就各位

發想架構與文案(Claude.ai + Prompt)

先在網頁版跟 Claude 討論:網站要有哪些區塊、給誰看、主打什麼賣點。用第 2 課的心法——給背景 + 給範例——把需求問清楚,例如「我做的是一個記帳 App,受眾是剛出社會的上班族,語氣要親切不說教,參考這個網站的排版風格」。這一步不寫程式,先把想法磨清楚。

動手建站(Claude Code)

進到專案資料夾開 Claude Code,把上一步討論好的架構交給它:「用 Next.js 幫我做這個網站,先做首頁,分成 Hero、功能、定價、聯絡四個區塊。」它會直接建檔案、寫程式、跑起本機預覽,你在瀏覽器看效果、繼續調。

立下專案規矩(CLAUDE.md)

做到一半你會發現有些事一直要重講:用什麼框架、字體、色碼、部署到哪。把這些寫進專案根目錄的 CLAUDE.md,之後每次開工 Claude 自動讀,不用你再交代一次。

打包排版流程(Skill)

網站要配部落格,每篇文章都要照同一套排版規範(標題層級、圖片命名、SEO 描述字數)。把這套規範寫成一個 Skill 放進 .claude/skills/,以後每寫一篇它都自動照做,不用你每次貼一次規範。

平行量產貼文(Subagents)

網站上線要配一波宣傳,你想一次生 10 篇不同平台的貼文。這種「彼此獨立、可以同時做」的任務正是 Subagent 的主場:派多隻分身平行寫,主 agent 最後彙整。

接上外部服務(MCP)

最後把流程接起來:透過 GitHub 讓程式碼一 push 就自動部署上線;接排程工具,讓寫好的貼文按時自動發出。這一步 Claude 動到的是你電腦以外的世界,靠的就是第 7 課的 MCP。

看懂這個案例,你就掌握了整套指南的用法。真實工作不會每次都跑滿六步——有時你只需要第 1、2 課在網頁上問個東西;有時你會從第 3 課直接開工。但當任務變大,你知道下一站在哪。

觀念三:選模型與選方案,一頁記住

第 1、2 課教過選模型,這裡幫你把 2026 年 7 月的現況壓成一張速查表,因為這是新手每天都會遇到、也最容易糾結的決定:

選模型加選方案一頁速查(2026 年 7 月)

模型階梯(從最強到最省):Fable 5 是旗艦,擅長要跑很久的自動化代理任務、有 100 萬 token 超長上下文,最強但最貴(API 每百萬 token 約 10 美元進、50 美元出);Opus 4.8 是最強推理模型,適合複雜工程與重要決策;Sonnet 5 是速度與智慧的平衡款,也是免費版與 Pro 的預設主力,九成日常任務用它最順;Haiku 4.5 最快最省,適合簡單、量大的任務。

一句話心法:預設用 Sonnet 5;遇到難題或很重要的事升 Opus 4.8;任務簡單又量大才降到 Haiku 4.5;要跑超長自動化才動 Fable 5。

方案這邊(2026 年 7 月現況):免費 Free 預設 Sonnet 5,有用量上限,練習夠用;Pro 每月 20 美元(年繳約 17 美元),用量大增並解鎖 Opus 4.8,是新手最划算的一步;Max 5x 每月 100 美元(用量 5 倍,還先開放 Cowork 網頁與手機版);Max 20x 每月 200 美元(用量 20 倍),給整天離不開 Claude 的重度工作者。給新手的建議不變:先用免費版把這門課練完,真的開始每天用、常被限流,再升 Pro。

觀念四:脈絡是有限的,學會管理它

有一個新手幾乎都會踩、但前面沒獨立講過的主題:脈絡管理(context management)。你跟 Claude Code 的每一段對話都佔用「脈絡視窗」,聊越久佔越滿。滿到一定程度,AI 會開始失焦、回答變慢、甚至忘記你早先講過的事。Claude Code 給了三個指令對付這件事:

對話塞爆了?三個脈絡管理指令 /clear /compact /context

  • /clear:把整段對話歷史清空,脈絡歸零。換一個完全不相干的新任務時用它最乾淨(注意:清的是對話,你這段已經改好的檔案會留著)。
  • /compact:把先前對話壓縮成一份摘要,保留「討論到哪」的脈絡,同時騰出空間。想接著同一件事做、又覺得對話太長時用它。
  • /context:查看目前脈絡用掉多少。發現快滿了,就依情況選 /clear/compact

養成習慣:換主題就 /clear,重要背景重講一次(或寫進 CLAUDE.md 讓它自動載入)。這是老手和新手在 Claude Code 上效率差最多的地方之一。

常見坑

前面是「怎麼把事情做對」,這一段是「怎麼不把事情做壞」。這 8 個坑,幾乎每個新手都踩過至少三個:

新手最常踩的 8 個坑

坑 1:指令太模糊,還怪 AI 笨

九成的「這 AI 好爛」其實是 prompt 太糊。你說「幫我寫個介紹」,它當然只能給你一段空話。回第 2 課的五個零件:給指令、給背景、給範例、指定格式、當草稿追問。AI 的產出品質,上限由你的問法決定。

坑 2:問一次就走,不追問

第一版永遠是草稿。新手拿到不滿意的答案,常常是默默關掉、去問別的工具。正確用法是在同一個對話裡追問:「再短一點」「換個更專業的角度」「這段太官腔,講白話」。逼出好版本的能力,才是真正拉開差距的地方。

坑 3:全盤相信,不 review

AI 會出錯,而且會用非常肯定的語氣出錯(業界叫「幻覺」)。獨立測試顯示,即使是很強的模型,在多步驟任務裡也可能有一成多的機率產生「看起來對、其實錯」的內容——特別是具體數字、API 名稱、引用來源。在 Claude Code 裡你可能看到它信誓旦旦地呼叫一個根本不存在的函式,跑起來就爆:

AttributeError: module 'requests' has no attribute 'fetch'

requests 根本沒有 fetch 這個方法,是 AI 掰的。解法:重要的東西一定自己查證,別直接上線;程式碼跑一遍再信;要它引用資料時,叫它「先把原文照抄出來再回答」,能大幅降低幻覺。

坑 4:破壞性操作不設關卡

刪檔、改資料庫、推線上(deploy)、寄信——這些難還原的動作,一定要讓 AI 先問過你再動手。最危險的是為了圖快而長期掛著 --dangerously-skip-permissions(跳過所有權限確認)。這個旗標(flag)在你完全清楚風險、而且是在隔離環境時才用;日常請維持「動手前先問」。真的踩到,你會看到類似:

rm -rf 執行完成:已刪除 42 個檔案

——等你發現時已經回不去了。Claude Code 預設會在危險操作前跟你確認,別把這道防線關掉。

坑 5:無腦用最貴的模型

不是每件事都要 Opus 4.8 或 Fable 5。整理格式、改錯字、分類這種小事,用 Sonnet 5 甚至 Haiku 4.5 又快又省;只有硬任務才升 Opus。全程用最強的模型,結果是又慢又貴,還常常被限流。在 Claude Code 裡用 /model 就能切,/cost 能看這段對話花了多少。

坑 6:一個對話塞到爆

這就是觀念四講的。脈絡太長,AI 會失焦、變慢,甚至跳出提示:

Context left until auto-compact: 3%

看到這行別硬撐。換主題就 /clear,想留脈絡就 /compact,重要背景重講一次。硬塞到底的下場是答案品質雪崩。

坑 7:CLAUDE.md 或 Skill 寫成流水帳

不是越長越好。CLAUDE.md 和 Skill 寫得又臭又長,反而稀釋重點,AI 抓不到真正該遵守的規矩。原則:只寫「AI 猜不到、但每次都要知道」的事(例如你的專屬慣例、踩過的雷),猜得到的通用知識不用寫,過期的規則要刪。精簡、常更新,勝過又長又舊。

坑 8:為小事開一堆分身

Subagent 有成本,也會拖慢速度。只有真正能平行、彼此獨立的任務才值得開(像案例裡的「一次寫 10 篇貼文」)。單一小事、或前後有依賴關係的步驟,直接讓主 agent 做更快。別為了「感覺很威」而濫用分身。

作業

這套指南給你的是地圖,真正的功力來自動手。給你三份練習,難度遞增,對照畢業檢核表逐項打勾:

畢業檢核表:你已經會這些了

  1. 今天(30 分鐘):用 Claude.ai 完成一件你本來要花一小時的文書工作——一封難寫的信、一份會議紀要整理、一段文案。刻意練習「不滿意就追問」,至少追問三輪。
  2. 這週:裝好 Claude Code(第 3 課),挑一個小專案,幫它寫一份精簡的 CLAUDE.md,然後叫它幫你做一個小功能。過程中刻意用一次 /model 切模型、一次 /clear 清脈絡。
  3. 這個月:把你一直重複跟 AI 講的某一套流程,打包成一個 Skill;行有餘力,再試著接一個 MCP(例如 GitHub),讓 Claude 動得到你電腦以外的服務。
記住這句AI 不是拿來取代你,是拿來放大你。會用它的人,一個抵一個團隊。而「會用」的門檻,你已經跨過了。

畢業之後,往哪走

先恭喜你——讀到這裡,你已經超越 90% 只會「拿 AI 聊天」的人了。這是《Claude 新手指南》的最後一課,但不是你 AI 之路的終點,是起點。

接下來你可以往三個方向深入:想真正用 AI 做出能上線的產品,去看**《Vibe Coding 建站實戰》**,把第 3 課的 Claude Code 用到底,做出並部署你自己的網站;想把 Skills、Subagents、MCP 玩得更深、打造專屬的自動化工作流,那條進階路線會等你;而如果你是上班族,別忘了第 1 課提過的 Cowork——2026 年它已經擴展到網頁與手機,能在背景幫你把報表、排程、跨檔案整理這類雜事跑完,是把今天學的「代理」思維搬到日常工作最直接的方式。

但最重要的一句,還是那句老話:去做吧。 地圖已經在你手上,路是走出來的。

#Claude 新手指南#實戰#常見錯誤#綜合複習

← 回所有文章