Claude Code 教學/第 7 篇・共 8 篇

實作——做出你的第一個工具

前面六篇的觀念，這一篇全部用上。我們從一個生活裡的小麻煩出發，帶你用 Claude Code 做出一個真的能裝、能用的小工具，中間會故意撞錯、再教你怎麼靠「把錯誤截圖貼回去」修好。

這是這個系列的最後一篇，也是最好玩的一篇。前面我們一路學了：它是什麼、怎麼裝、怎麼讓它記得你、怎麼設好護欄、怎麼用 Skill 教它做事、怎麼用 MCP 幫它接工具。這一篇不教新招，而是把這些全部串起來，實際做出一個你自己的小工具——並且親眼看它跑起來。

我們要做的東西，取自 PAPAYA 教學裡的一個案例：一個能把螢幕上的文字「框起來、變成可複製文字」的 Chrome 小擴充功能（螢幕上有些圖片裡的字沒辦法反白複製，這個工具就是來解決這個小麻煩的）。你不用懂寫程式，跟著走一遍，你會對「原來我也能叫它做出東西」很有感。

一、先講一件事：把它當成「帶著護欄的合作」

新手最容易犯的錯，是打一句「幫我做一個 OCR 擴充功能」然後就放手讓它衝。這一篇要示範的，是一種更穩的節奏——先想清楚、再動工，每一步都留退路。前面幾篇的東西會在這裡一個個派上用場，我會邊做邊點名。

二、選對腦：/model 與思考力

比較複雜的任務，值得讓它用強一點的模型、想深一點再動手。在對話裡打：

/model

會跳出讓你選模型的選單，做這種從零建東西的任務，選能力最強的那個（例如 Opus 這類）。有些版本還能調「思考程度（thinking / effort）」，開高一點，它會在動手前想得更周全。

為什麼要挑模型？就像交代事情，簡單的小事隨便誰都行，但「從無到有做一個工具」這種要動腦的，你會想找最能幹的那位。模型越強通常越貴／越慢，所以平常小事不用開最強，遇到硬任務再開。

三、先計畫、別急著動工：Plan Mode ＋「資訊不足請先問我」

還記得第四篇說的 plan mode 嗎？這裡正是它的主場。從零做一個東西，一定先進 plan mode，讓它先給計畫、你看過再放行。

而且你下需求時，加一句非常關鍵的話：

「做一個能把螢幕文字辨識成可複製文字的 Chrome 擴充功能。在你資訊不足、不確定我要什麼的時候，請先問我，不要自己假設。」

這句「不足請先問我」會讓它把該問的先問清楚（要支援哪些語言？辨識完是複製到剪貼簿還是顯示出來？），而不是自己腦補一個版本做下去、最後跟你想的差很多。它會回你一份計畫，你讀一讀、覺得對了再核准。

四、載入、測試——然後它會出錯，這很正常

核准後它會開始寫檔案。做完，它會告訴你怎麼把這個擴充功能載進 Chrome 測試（大致是：打開 Chrome 的擴充功能頁、開啟開發者模式、載入那個資料夾）。

第一次跑，十之八九會有地方怪怪的——按鈕沒反應、辨識框位置跑掉、或直接報錯。別慌，也別想自己去讀那堆程式碼。 這就是非工程師最該學會的一招：

把錯誤「截圖」或「複製」貼回去

  • 如果畫面有錯誤訊息，把那段文字整段複製，貼回 Claude Code，說「跑出這個錯，幫我修」。
  • 如果是「看起來怪」（框歪了、顏色不對），直接截圖貼給它，說「實際長這樣，跟預期不一樣，幫我調」。

它會看著你給的錯誤或截圖，找出問題、改好，再叫你重載測試。你就重複「測試 → 貼回錯誤 → 它修 → 再測試」這個循環，直到它能用。整個過程你一行程式都沒寫，你做的是當那個看得懂結果、會回報問題的人。

五、留退路：Git 與 /init

工具能用了，做兩件讓你以後不後悔的事，這也是前幾篇鋪好的：

先存檔（Git）。 第四篇講過的「防誤刪」在這裡就是救命的。趁現在能用，讓它把成果用 Git 存一個版本：

請幫我把目前的成果用 git 存一個版本，commit 訊息用英文簡短描述

這樣萬一你接下來想加功能卻改壞了，隨時能退回這個「能用的版本」，不會一夜回到解放前。

再寫備忘錄（/init）。 第三篇的 CLAUDE.md 記得嗎？打：

/init

它會看過這個專案、自動幫你生一份 CLAUDE.md，把這個工具是什麼、怎麼跑、用了哪些慣例記下來。下次你再開這個專案繼續做，它一讀就想起來，不用你重講一遍。

六、迭代：加一個小功能

真正的爽點是「它能長大」。工具能用之後，你可以繼續加東西，例如：

「幫我加一個功能：辨識出來的文字，按字數長短排序。」

它會在現有的基礎上改，你一樣測試、有問題就貼回去。你會發現：第一次從零做最花力氣，之後每加一個功能都輕鬆很多——因為有了 CLAUDE.md 它記得脈絡、有了 Git 你敢放手試、有了前面建立的溝通默契，你們越合作越順。

七、你已經走完一輪了

停下來看看你手上這個小工具——它是你「說人話、它動手」做出來的。回頭看這個系列，你其實已經把一套完整的能力走過一遍：

  1. 為什麼值得學——它能幫不寫程式的你做出東西。
  2. 裝好、開始對話——跨過終端機那道心理門檻。
  3. CLAUDE.md——讓它記得你是誰、你的習慣。
  4. 模式、權限與安全——先計畫、留退路、別摔死。
  5. Skills——把你重複做的事變成它隨叫隨到的本事。
  6. MCP——幫它接上外部工具。
  7. 實作（就是這篇）——把上面全部串起來，做出真的能用的東西。

接下來還有更進階的世界等你玩：讓多個 Claude 分工合作（subagents）、讓它定時自動幫你跑任務（排程與自動化）。但那些都是錦上添花——你現在已經具備最重要的能力：遇到麻煩，敢開口叫它幫你動手，並且知道怎麼把它導到對的方向。

有做出什麼、或哪裡卡住，都歡迎告訴我，我會把你們的經驗補進這個教學裡。

本文參考素材

回教學列表