在 1 小時內用這份 Claude Code 初學者指南，打造你的第一個 AI 代理。包含完整提示詞、逐步工作流程、常見錯誤，以及理解工具、技能與循環的最簡單方式。
沒人告訴我，我的第一個 AI 代理會這麼不起眼，但這正是它成功的原因。
我想很多初學者想像中的第一個代理，應該像個自主的數位員工，可以訂機票、寫程式碼、搜尋網路，然後在午餐前改變人生。哈哈，別想了。
這個幻想正是多數人卡住的地方。
他們花好幾天學習術語、比較框架、看那些早已超越初學者程度的人示範。結果，他們真正需要的只是一個小小的運作循環。
就是這個心態轉變，讓我真正理解了 Claude Code。
你的第一個代理不需要很厲害，它只需要：設定目標、使用一些情境、執行一個動作、檢查結果，然後決定繼續或停止。一旦你完成過一次，所有圍繞著代理的可怕術語就會縮回正常規模。
所以這是我希望自己剛開始時就有的指南。沒有過度複雜的理論，只有一個初學者友善的方式，讓你在 1 小時內用 Claude Code 打造出第一個可用的 AI 代理。
首先，理解代理到底是什麼
「代理」這個詞讓一切聽起來比實際上更複雜。
在初學者層級，代理就是一個能執行比單次回答更多事情的 AI 系統。它可以接受任務、檢查情境、使用工具、逐步推進，並決定下一步做什麼。
就是這樣。
你不需要在開始前先搞懂高階架構圖，你只需要理解「循環」。
循環就是核心概念：
代理獲得目標、查看當前狀況、採取行動、檢查該行動是否有效，然後繼續或停止。
Claude Code 是學習這個概念的好地方，因為它本身就已經以這種方式運作。它不只是吐出程式碼然後消失。它可以檢查檔案、編輯檔案、執行檢查，並持續處理任務。這讓初學者最容易從「思考提示詞」轉變為「思考工作流程」。
你在第一個小時內要建什麼
不要建一個「萬能研究助手」或「完全自主的程式碼員工」。建一個很小的東西。
最好的第一個代理，是一個能清楚執行狹窄任務的代理。例如：
讀取一個資料夾、摘要檔案內容、找出待辦事項，並整齊地格式化結果。
這聽起來可能很無聊，但無聊是好事。無聊代表可理解。而可理解才能讓你在後續改進系統。
第一個小時的目標不是建造神奇的東西，目標是向自己證明：你可以在 Claude Code 中創造一個能實際運作的循環，完成真實的工作，並有真實的結構。
最簡單的第一個代理工作流程
最簡單的版本長這樣：
你給 Claude Code 一個任務，例如：
「檢視這個資料夾中的筆記，摘要主要主題，列出未解決的問題，並建立一個乾淨的摘要檔案。」
這個單一任務已經具備代理的骨架：
- 有目標，
- 有情境，
- 有動作，
- 有可供驗證的輸出。
讓它像代理的原因不只是文字本身，而是 Claude Code 可以逐步處理任務，而不是把它當作一次性回答。
這是我推薦的初學者模式：
從一個資料夾、一個任務、一個輸出檔案、一個檢查步驟開始。
這樣就夠了。
逐步操作：
開啟 Claude Code，建立或選擇一個小資料夾來操作。
這可以是幾則筆記、一些 Markdown 檔案、一個小型專案，甚至是你自己為了練習而建立的幾個文字檔案。
保持資料夾夠小，讓你能理解代理在做什麼。
然後給它一個直接的指令，像這樣：
1Review all files in this folder.2Identify the main themes in the content.3List unanswered questions or loose ends.4Create a clean summary in a new markdown file called SUMMARY.md.5Before finishing, check that every file was included in the review.
這個指令對初學者很有效，因為它默默教會了幾乎所有重要的事情。
代理擁有：
- 範圍：這個資料夾中的所有檔案，
- 目標：摘要主題與未解決的問題，
- 動作：讀取與綜合，
- 交付物：SUMMARY.md，
- 驗證步驟：確保每個檔案都被納入檢查。
這是一個真實的循環，即使很簡單。
為什麼這在 Claude Code 中效果這麼好
Claude Code 對初學者友善，因為它的環境鼓勵以任務為導向的思考。
很多 AI 教學會以抽象的方式教代理。他們在還沒看到有用的結果之前，就開始談論工具、記憶、編排與自主性。
Claude Code 翻轉了這個順序。
它讓你從具體的任務開始，然後幾乎是無意中注意到代理正在遵循一個循環：
檢查、執行、驗證、繼續。
這很重要，因為大多數初學者不需要更多理論。他們需要一次成功的經驗，需要看到代理不是什麼未來生物。
它只是一個使用 AI 來推進工作的結構化工作流程。
Claude Code 也讓技能和工具感覺不那麼嚇人，因為它們存在於實際情境中。你不是問「理論上什麼是工具啟用代理？」，而是開始問更好的問題：
「什麼工具可以幫助這個任務？」
「代理在停止之前應該檢查什麼？」
「如果輸出不完整會發生什麼？」
這些才是初學者該問的問題。
加入工具與技能
一旦基本的代理能運作，下一步不是讓它在所有方面都變得更聰明，而是給它一個有用的延伸。
例如，你的代理或許可以：
- 讀取筆記並產生摘要，
- 然後提取待辦事項，
- 然後將這些待辦事項改寫成檢查清單，
- 然後將它們儲存到另一個檔案。
或者它也許可以：
- 掃描專案資料夾，
- 找出缺少的文件，
- 並建議哪些地方需要簡短的 README 檔案。
這就是工具和技能開始有用的地方。工具幫助代理執行具體的事情。技能則給它一個可重複的模式來處理某類工作。
對初學者來說，最簡單的思考方式就是：
工具是代理可以使用的東西；
技能是代理學習如何善用工具的方式。
不要在第一個專案中塞太多東西。只在第一個循環已經能運作之後，再加入一個有用的延伸。
效果很好的確切提示詞
這是我會給初學者使用 Claude Code 建立第一個代理的提示詞：
1你正在幫助我建立一個小型檔案檢查代理。23任務：41. 讀取這個資料夾中的所有檔案。52. 摘要它們的主要主題。63. 找出未回答的問題、缺少的部份或待辦事項。74. 建立一個名為 SUMMARY.md 的 markdown 檔案，內容包含：8 - 主要主題9 - 未解決的問題10 - 建議的下一步115. 在完成前，確認資料夾中的每個檔案都已被檢查過。1213不要讓輸出過於複雜。14保持摘要實用且易於瀏覽。
我喜歡這個提示詞的原因，是它沒有試圖聽起來很厲害。它清楚、狹窄、且可操作。這正是初學者需要的。
如果你想要一個稍微更「代理感」的版本，可以使用這個：
1以 AI 代理的身分檢查這個資料夾中的檔案。2逐步工作。3首先檢查可用的檔案。4然後提取主要主題和待辦事項。5接著建立 SUMMARY.md。6最後，在停止之前確認沒有檔案被跳過。
這個版本讓循環更加明確。
如何正確測試
大多數初學者「測試」代理的方式，是看它有沒有產生東西。這樣太弱了。
真正的測試是它是否正確完成了實際任務。
對於這個第一個代理，測試很簡單：
- 它是否檢查了所有檔案？
- 摘要是否反映了真實內容？
- 它是否漏掉了任何明顯的東西？
- 它是否建立了正確的輸出檔案？
- 最終結果是否感覺有用，而不只是看起來合理？
最後一點非常重要。AI 輸出常常即使內容淺薄，聽起來卻很漂亮。所以不要只看格式是否好看。要檢查內容是否正確。
這就是 Claude Code 再次幫助你的地方。因為它在任務環境中運作，你可以檢查檔案、比較結果，並在偏離時調整指令。
這才是初學者建立代理的真實樣貌：小循環、測試、調整、再次執行。
初學者常犯的錯誤
最大的錯誤是太早嘗試建造太宏大的東西。
你的第一個代理不需要十個工具、記憶、排程、以及複雜的子代理鏈。
那不是「初學者友善」，那是穿著酷外套的困惑。
第二個錯誤是使用模糊的目標。
如果你說「改善這個資料夾」，代理對成功的定義不夠明確。
如果你說「檢查所有檔案、摘要主題、找出未解決的問題、並建立 SUMMARY.md」，現在它有了方向。
第三個錯誤是跳過驗證。
一個不檢查就行動的系統不是強大的代理，只是快速猜測。
第四個錯誤是執著於術語。你不需要在建造之前精通所有 AI 代理的流行詞。先建造，詞彙可以後來跟上。
接下來建什麼
一旦這個第一個代理能運作，你可以很自然地升級。
接下來有用的初學者專案通常是：
- 一個研究代理，讀取筆記並產生簡報，
- 一個程式碼庫代理，找出缺少的文件或待辦事項，
- 一個內容代理，將粗略筆記轉換成結構化的草稿，
- 一個每日檢查代理，掃描檔案並產生更新記錄。
注意模式：它們都還是循環。
只是情境更豐富，驗證更嚴格。
這就是 Claude Code 真正的初學者路徑。不是提示詞技巧，不是華麗的複雜度。只是學習如何每次更清楚地定義循環。
真正的重點
你的第一個 AI 代理應該感覺幾乎令人失望地小。
這是好現象。代表你正在建造足夠真實的東西，可以理解、測試並改進。Claude Code 是一個非常強大的初學者工具，因為它讓這種學習方式變得實用。它告訴你，代理不是魔法。它是一個結構化的循環：目標、情境、行動、驗證、停止。
建造一個能運作的小代理。
然後讓它稍微好一點。
然後加入一個工具。
然後再次測試。
這就是你從「我完全不知道什麼是 AI 代理」到「我在 1 小時內建了一個」的方式。
希望你喜歡這篇文章。
為像你這樣的創作者打造更好的 AI 工作流程。
❣️我是 Kanika（@KanikaBK）—— 追蹤我以獲得更多實戰測試與設定。
